多租户管理
多租户管理模块允许你在单一系统中创建和管理多个租户,每个租户拥有独立的数据空间,实现 SaaS 化数据隔离。
功能入口
登录管理后台后,点击左侧菜单 平台管理 > 租户管理,进入租户列表页面。页面以表格形式展示所有租户,包含租户名称、联系人、联系电话、到期时间、状态等字段。
租户列表
租户列表支持按租户名称搜索,并提供新增、编辑、删除和状态管理的快捷入口。列表中的状态列以 DictTag 组件渲染,清晰展示正常/禁用状态。
新增租户
- 在租户列表页右上角,点击 新增 按钮
- 弹出新增租户表单,填写以下信息:
- 租户名称(必填):企业或组织的名称
- 联系人:租户联系人姓名
- 联系电话:租户联系人手机号
- 联系邮箱:租户联系邮箱
- 租户套餐:选择预设的套餐方案
- 到期时间:租户账号有效期
- 账号数量:该租户下允许的最大用户数
- 状态:正常 / 禁用
- 点击 确定 完成创建
租户套餐
租户套餐定义了租户的功能权限和资源配额,通过套餐统一管理:
- 进入
系统管理 > 套餐管理 - 可新建套餐,配置套餐名称、菜单权限和资源配额
- 创建租户时选择对应套餐,租户即可继承套餐的功能范围
租户状态管理
- 停用租户:点击操作列 停用 链接,该租户下所有用户将无法登录
- 启用租户:点击 启用 链接恢复租户登录权限
- 租户到期:到期后租户自动被禁用,管理员可延长到期时间
编辑租户
在租户列表操作列点击 编辑,可修改租户名称、联系人、套餐、到期时间、账号数量、状态等配置,保存后即时生效。
用户加入 / 移出租户
- 加入租户:在用户管理中可将用户分配到某个租户;同一用户可属于多个租户。
- 移出租户:在租户详情里查看该租户下用户列表,将用户移出(
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 权限配置指南 — 配置租户内权限
