多租户

tenant

功能概述

多租户(SaaS)指一套系统同时服务多个客户(租户):每个租户一个独立数据库,数据物理隔离,互不影响。系统按请求域名识别当前租户,租户之间可以分配不同的功能菜单。

隔离范围

  • 数据库:每个租户一个库,租户数据只在自己的库里
  • 菜单权限:每个租户单独分配能访问的菜单
  • 文件存储:上传文件按租户 code 分目录存放
  • 缓存与锁:内存缓存、Redis 键、分布式锁统一带 tenant:{code}: 前缀

使用方法

启用多租户

在 Program.cs 中添加 AddEasyAdminBlazorMultiTenant() 扩展方法,自动启用多租户功能:

builder.AddEasyAdminBlazor(new EasyAdminBlazorOptions { ... })
    .AddEasyAdminBlazorMultiTenant();

租户识别

系统使用请求的 Host(域名)自动识别当前租户。每个租户绑定一个唯一的域名,如:

  • https://tenant1.yourdomain.com → 识别为 tentant1
  • https://localhost:7230 → 开发环境通过端口区分

租户的 Host 字段支持三种格式:localhost:7230、https://localhost:7230、http://localhost:7230。

添加租户(管理员视角)

  1. 登录后台,在导航里找到 "多租户" 点进去。
  2. 点 "添加",在弹窗里填:
    • 基本设置:租户编码(唯一标识,比如 vip)、域名、数据库类型、连接串、名称、描述
    • 功能菜单:给这个租户分配能访问哪些菜单
  3. 点 "保存",系统会:
    • 在主库创建租户记录
    • 在租户的数据库里建管理员角色和初始管理员账号
    • 把选中的菜单同步过去
    • 自动建表(靠 UseAutoSyncStructure)

编辑租户

  1. 找到目标租户,点 "编辑"。
  2. 改基本信息或调菜单权限。
  3. 菜单变了会自动同步到租户的数据库。
  4. 改了数据库类型或连接串时,保存后会立即丢弃该租户已缓存的数据库连接,新配置从下一次访问起生效,不需要重启应用。旧连接不会立刻释放(正在使用它的请求不会被打断),空闲后由连接池自动回收。

多实例部署提示:连接缓存是进程内的,改配置只会让当前进程立即切换;其它进程会在各自租户连接被回收重建(空闲约 3 分钟)时自动读取最新配置,若要求立刻一致,请重启其它实例。

删除租户

  1. 勾选要删的租户(可以多选),点 "删除"。

租户登录

租户拿自己的域名访问系统,用创建时自动生成的管理员账号登录。默认密码规则:{租户编码}123(比如 vip123)。

文件隔离

开了多租户之后,上传的文件会自动按租户 code 分目录存:wwwroot/uploads/{tenantCode}/yyyy/MM/dd/。

界面说明

租户列表

  • 租户编码:唯一标识
  • 租户域名:绑定的 Host
  • 数据类型:使用的数据库类型(每个租户使用独立数据库;main 租户使用主库)
  • 租户名称:显示名称
  • 是否启用:启用/禁用
  • 创建人/创建时间:操作审计信息

编辑弹窗

包含两个选项卡:

  • 基本设置:编码、域名、数据库类型、连接字符串、名称、描述、启用状态
  • 功能菜单:菜单树勾选分配权限(子菜单选中时自动补全父菜单)
  • 宿主级菜单(租户管理、错误日志、任务计划)不会出现在这棵树里,不能分配给租户;已有租户如果之前分配过,编辑保存一次即可从租户库移除

缓存与锁隔离

内存缓存、Redis 键与分布式锁统一带 tenant:{code}: 前缀,避免不同租户之间缓存与锁互相干扰。

相关实体/服务

  • SysTenant — 租户实体
  • ITenantService / MultiTenantService — 租户服务
  • FreeSqlCloud — 多租户数据库调度
  • MainOrmHandle — 主库 ORM 句柄