Skip to content

多租户管理

多租户管理模块允许你在单一系统中创建和管理多个租户,每个租户拥有独立的数据空间,实现 SaaS 化数据隔离。

功能入口

登录管理后台后,点击左侧菜单 平台管理 > 租户管理,进入租户列表页面。页面以表格形式展示所有租户,包含租户名称、联系人、联系电话、到期时间、状态等字段。

租户列表

租户列表支持按租户名称搜索,并提供新增、编辑、删除和状态管理的快捷入口。列表中的状态列以 DictTag 组件渲染,清晰展示正常/禁用状态。

新增租户

  1. 在租户列表页右上角,点击 新增 按钮
  2. 弹出新增租户表单,填写以下信息:
    • 租户名称(必填):企业或组织的名称
    • 联系人:租户联系人姓名
    • 联系电话:租户联系人手机号
    • 联系邮箱:租户联系邮箱
    • 租户套餐:选择预设的套餐方案
    • 到期时间:租户账号有效期
    • 账号数量:该租户下允许的最大用户数
    • 状态:正常 / 禁用
  3. 点击 确定 完成创建

租户套餐

租户套餐定义了租户的功能权限和资源配额,通过套餐统一管理:

  1. 进入 系统管理 > 套餐管理
  2. 可新建套餐,配置套餐名称、菜单权限和资源配额
  3. 创建租户时选择对应套餐,租户即可继承套餐的功能范围

租户状态管理

  • 停用租户:点击操作列 停用 链接,该租户下所有用户将无法登录
  • 启用租户:点击 启用 链接恢复租户登录权限
  • 租户到期:到期后租户自动被禁用,管理员可延长到期时间

编辑租户

在租户列表操作列点击 编辑,可修改租户名称、联系人、套餐、到期时间、账号数量、状态等配置,保存后即时生效。

用户加入 / 移出租户

  • 加入租户:在用户管理中可将用户分配到某个租户;同一用户可属于多个租户。
  • 移出租户:在租户详情里查看该租户下用户列表,将用户移出(POST /system/tenant/{tenantId}/users/{userId}/remove)。

切换租户

属于多个租户的用户登录后可在右上角切换当前租户(POST /system/tenant/switch),切换后数据范围与菜单随租户变化。

数据隔离机制

Forge Admin 通过 TenantLineInnerInterceptor 拦截器实现租户数据隔离:

  1. 每个数据表都包含 tenant_id 字段
  2. 用户登录后,系统识别其所属租户
  3. 所有 SQL 查询自动追加 WHERE tenant_id = 当前租户ID 条件
  4. 不同租户之间数据完全隔离,互不可见

重要:业务数据的 tenant_id 必须设为 1(默认租户),禁止设为 00 的数据对所有租户不可见。

相关文档

Forge Admin — 基于 Vue3 + Spring Boot 的企业级后台管理框架