租户列表
一句话:启凌智搭是多租户 SaaS 架构——一个平台同时服务多家互不可见的「租户」。本页是租户的总台账:建租户、改额度、停用/启用、看过期时间,都在这里。
谁能看到本页
租户管理属于「平台运营」能力。演示环境里 admin(超管)与 docadmin(租户管理员)的侧边栏都有「系统管理 → 租户管理」;套餐受限租户(如 aoteman@test)能否看到,取决于它的套餐勾没勾这两个菜单——见租户套餐的视角对照。
功能在哪
- 菜单路径:系统管理 → 租户管理 → 租户列表
- 地址栏路由:
/system/tenant/list

界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 查询区 | 按 租户名 / 联系人 / 联系手机 / 租户状态 / 创建时间 过滤 | 输入后点「搜索」;点「重置」清空 |
| 工具条 | 整页级动作 | 「新增」建租户;「导出」下载 Excel;勾选行后「批量删除」 |
| 列表 | 一户一行 | 看 套餐 / 账号额度 / 过期时间 / 绑定域名 / 状态;行内「编辑」「删除」 |
| 分页 | 右下角 | 改每页条数、翻页 |
列表各列含义:
| 列 | 含义 |
|---|---|
| 租户编号 | 租户唯一 ID。1 是系统租户(平台自身),不可改不可删 |
| 租户名 | 登录页「租户名称」要填的就是它 |
| 租户套餐 | 决定该租户登录后能看到哪些菜单;0 表示系统租户不受套餐限制 |
| 账号额度 | 该租户最多能建多少个用户,超了会报配额错误 |
| 过期时间 | 到期后该租户所有人登录报「租户已过期」 |
| 绑定域名 | 允许用哪些域名访问该租户(回车逐个添加) |
| 租户状态 | 开启 / 关闭。关闭后登录报「租户已被禁用」 |
常用操作
新建一个租户
- 点工具条「新增」,弹出租户表单;
- 填「租户名」(登录页要填的名字,全平台唯一);
- 选「租户套餐」——先想清楚这家租户需要哪些菜单,套餐里没勾的菜单登录后看不见(见租户套餐);
- 填「联系人」「联系手机」;
- 填「用户名称」「用户密码」——这两个字段只在新增时出现,平台会用它俩自动创建该租户的第一个管理员账号;
- 填「账号额度」「过期时间」,确认「租户状态」为开启,点「确定」。

结果:列表多出一行;新租户的管理员可以用「租户名 + 用户名称 + 用户密码」在登录页登录,登录后看到的就是这家租户自己的数据。
账号额度是硬上限
租户内用户数达到额度后再建用户,会报:创建用户失败,原因:超过租户最大租户配额({})!。要加人就回本页「编辑」把额度调大。
编辑租户
- 行内点「编辑」;
- 改 套餐 / 额度 / 过期时间 / 域名 / 状态 等;
- 点「确定」。
结果:改套餐后,该租户用户下次登录即按新套餐显示菜单;把状态改成「关闭」,该租户所有人立刻登录不了,报 名字为【{}】的租户已被禁用。
系统租户(编号 1)不能改
对编号 1 的行点编辑/删除会被后端拒绝:系统租户不能进行修改、删除等操作!。它是平台自身的租户,删了平台就没了。
删除 / 批量删除
- 单删:行内点「删除」,确认;
- 批量:勾选多行 → 工具条「批量删除」→ 确认。
结果:租户及其数据被标记删除,该租户所有人立即无法登录(报 租户不存在)。
删除不可恢复
删除租户会连带其下用户、组织、业务数据一起失效。演示环境请只删自己建的测试租户。
导出台账
点工具条「导出」,按当前查询条件生成 Excel 下载(无弹窗,直接下文件,见通用操作约定)。
字段说明
| 字段 | 必填 | 取值 / 校验 | 说明 |
|---|---|---|---|
| 租户名 | 是 | 全平台唯一 | 重名报 名字为【{}】的租户已存在 |
| 租户套餐 | 是 | 下拉选租户套餐 | 决定可见菜单范围 |
| 联系人 | 是 | 文本 | 运营联系用 |
| 联系手机 | 是 | 手机号 | 运营联系用 |
| 用户名称 | 是(仅新增) | 该租户内唯一 | 自动创建的首个管理员账号 |
| 用户密码 | 是(仅新增) | 文本 | 首个管理员的初始密码 |
| 账号额度 | 是 | 整数 | 用户数上限 |
| 过期时间 | 是 | 日期时间 | 到期报 名字为【{}】的租户已过期 |
| 绑定域名 | 否 | 回车逐个添加 | 域名重复报 域名为【{}】的租户已存在 |
| 租户状态 | 是 | 开启 / 关闭 | 关闭即停用整家租户 |
视角对照
| 视角 | 看到什么 |
|---|---|
超管 admin | 全部租户:系统租户「启凌智搭」+ 演示租户「test」 |
租户管理员 docadmin | 同页同数据(租户管理菜单对其开放),可代运营操作 |
套餐受限租户 aoteman@test | 套餐勾了「租户管理」才看得到;没勾则侧边栏无入口、直达路由 403 |
租户间数据天然隔离
aoteman@test 登录后,用户列表里只有 test 租户自己的 1 条用户——哪怕它看得到「租户列表」菜单,也看不到别家租户的数据行。隔离由后端按租户 ID 强制过滤,不靠界面隐藏。
进阶
常见问题
Q:登录时报「租户不存在」? A:登录页「租户名称」填错。要填本页「租户名」列的原文(区分全半角与空格),例如 启凌智搭、test。
Q:报「名字为【test】的租户已被禁用」? A:该租户的「租户状态」被改成关闭。回本页行内「编辑」把状态改回「开启」。
Q:报「名字为【test】的租户已过期」? A:「过期时间」早于当前时间。编辑租户把过期时间往后调。
Q:新建租户时为什么没有「用户名称/用户密码」? A:这两个字段只在新增时出现,编辑时不显示——管理员账号只在创建租户那一刻生成。
Q:改了套餐,租户用户界面没变? A:菜单在登录时加载。让该租户用户退出重新登录即生效。
