Saltcorn多租户环境配置实践指南

多租户架构概述

Saltcorn作为一个开源的低代码平台，提供了多租户(Multi-Tenant)功能，允许在同一套系统上为不同用户群体创建隔离的工作环境。这种架构在教育场景中尤为实用，比如为90名学生各自提供独立的工作空间。

本地开发环境配置要点

在本地测试多租户功能时，开发者常会遇到租户识别问题。核心原因在于Saltcorn默认从URL中提取租户标识，而localhost环境需要特殊配置才能正常工作。

解决方案一：修改本地域名解析文件

在操作系统的域名解析文件中添加以下条目：

127.0.0.1 example.com sub1.example.com sub2.example.com

这样配置后，可以通过类似http://sub1.example.com:3000的URL访问特定租户。

解决方案二：调整服务启动参数

启动Saltcorn服务时添加子域名偏移参数：

saltcorn serve -p 3000 --subdomain_offset=1

批量创建租户的最佳实践

对于需要批量创建大量租户(如90个学生环境)的场景，Saltcorn提供了命令行工具实现自动化：

1. 创建租户：

saltcorn create-tenant tenant_name

2. 为租户创建管理员用户：

saltcorn create-user -t tenant_name -e "[e-mail]" -p password

技术原理深入解析

Saltcorn的多租户实现基于PostgreSQL的Schema隔离机制。当创建新租户时，系统会：

1. 在数据库中创建对应的Schema（如firsttenant）
2. 在该Schema下创建完整的表结构副本
3. 通过中间件根据URL路由到正确的Schema

这种设计确保了各租户数据的完全隔离，同时共享同一套应用代码和基础设施。

常见问题排查

若发现用户被错误地创建在public schema中，通常表明：

1. URL路由未正确识别租户标识
2. 中间件配置有误
3. 数据库连接未正确设置搜索路径

通过本文介绍的域名解析修改或启动参数调整，可有效解决这类路由问题。