多租户管理
多租户管理模块允许你在单一系统中创建和管理多个租户，每个租户拥有独立的数据空间，实现 SaaS 化数据隔离。
功能入口
登录后点左侧 平台管理 → 租户管理（路由 /system/tenant）。
2026-08-26 演示站实拍。搜索：租户名称、负责人、联系电话。主按钮是 新增租户 / 批量删除。列表列：租户、联系电话、人员上限、过期时间、状态、业务数据源、描述、操作。行操作是 用户 / 编辑 / 更多。租户列同时显示名称和负责人。
租户列表
| 列 | 说明 |
|---|---|
| 租户 | 名称 + 负责人 |
| 联系电话 | 租户联系电话 |
| 人员上限 | 该租户允许的最大用户数；演示里可见「无限制」或具体数字 |
| 过期时间 | 到期后租户不可登录 |
| 状态 | 正常 / 禁用 |
| 业务数据源 | 该租户走哪套库。演示可见「应用数据源」「主库回退」或具体编码 |
| 描述 | 备注 |
行操作 用户 打开该租户下的用户名单。
新增租户
点 新增租户，不是「新增」。
2026-08-26 演示站实拍。表单分组：基础信息、业务数据源、品牌设置、外观方案、顶栏外观、侧边导航。
| 分组 | 字段 | 必填 | 说明 |
|---|---|---|---|
| 基础信息 | 租户名称 | 是 | |
| 基础信息 | 租户状态 | 否 | 正常 / 停用 |
| 基础信息 | 负责人 | 是 | 界面叫负责人，不是「联系人」 |
| 基础信息 | 联系电话 | 是 | |
| 基础信息 | 人员上限 | 否 | 0 表示无限制 |
| 基础信息 | 过期时间 | 否 | |
| 基础信息 | 租户描述 | 否 | |
| 业务数据源 | 默认业务库 | 否 | 未选则 forge-business 按主库回退 |
| 品牌设置 | 系统名称 / 浏览器标签 / Logo / 图标 / 介绍 / 版权 | 否 | 控制左上角、登录页、标签页 |
| 外观方案 | 默认布局、主题色 | 否 | 简约 / 通用 / 顶部菜单 / 混合 / 全屏 / 沉浸式等 |
| 顶栏 / 侧边导航 | 背景色、文字色、选中色 | 否 | 深度定制时再改 |
演示没有「租户套餐」菜单。sys_tenant 也没有套餐字段。行 更多 里目前是 删除。不要去找「套餐管理」。
租户状态管理
- 停用租户：点击操作列 停用 链接，该租户下所有用户将无法登录
- 启用租户：点击 启用 链接恢复租户登录权限
- 租户到期：到期后租户自动被禁用，管理员可延长到期时间
编辑租户
在租户列表操作列点击 编辑，可改名称、联系人、人员上限、到期时间、状态、品牌和默认业务数据源。没有套餐下拉。
用户加入 / 移出租户
- 加入租户：在用户管理中可将用户分配到某个租户；同一用户可属于多个租户。
- 移出租户：在租户详情里查看该租户下用户列表，将用户移出（
POST /system/tenant/{tenantId}/users/{userId}/remove）。
切换租户
属于多个租户的用户登录后可在右上角切换当前租户（POST /system/tenant/switch），切换后数据范围与菜单随租户变化。
数据隔离机制
Forge Admin 通过 TenantLineInnerInterceptor 拦截器实现租户数据隔离：
- 每个数据表都包含
tenant_id字段 - 用户登录后，系统识别其所属租户
- 所有 SQL 查询自动追加
WHERE tenant_id = 当前租户ID条件 - 不同租户之间数据完全隔离，互不可见
重要：业务数据的
tenant_id必须设为1（默认租户），禁止设为0。0的数据对所有租户不可见。
相关文档
- 用户管理 — 管理租户下的用户
- RBAC 权限配置指南 — 配置租户内权限