多租户模式指南

多租户是指单套应用、单套服务集群，通过逻辑或物理隔离的方式，为多个独立租户提供服务。

核心特征

• 数据隔离：租户之间数据互不可见、互不干扰
• 独立配置：支持各租户独立配置流程、表单、权限与业务规则
• 资源共享：所有租户共用底层引擎、代码及服务器资源

应用场景

工作流引擎的多租户模式，主要用于一套引擎服务多个独立组织、部门或外部客户。在实现数据与流程逻辑隔离、统一运维、降低部署成本的同时，支持全局统一管控与租户个性化流程定制。

典型适用场景

1. 同一套系统服务多个独立机构 / 客户
   • 面向外部客户（SaaS 类流程平台）：多家企业或商户共用一套工作流引擎，数据、流程模板、权限相互隔离。例如：通用审批 SaaS、企业费控/报销流程、第三方工单流程系统
   • 集团内部多子公司 / 分支机构：总部统一运维一套流程引擎，各分子公司流程、数据独立，无需单独部署。例如：集团财务审批、人事流程、纪检/党建流程、区域分公司工单
2. 多套业务体系共用引擎底座（需逻辑隔离）
   • 同一组织内，不同业务线或部门的流程体系完全独立，模板、表单、历史数据互不干扰，但无需重复部署引擎。例如：单位内行政审批、项目流程、法务流程、督查督办分属不同租户，共用一套工作流服务
3. 统一运维、降本提效
   • 服务器、数据库、版本更新、Bug 修复、功能迭代只需维护一套，无需为每个组织单独部署引擎。适合租户数量多、单租户流量不大、运维人力有限的场景
4. 统一管控 + 个性化定制并存
   • 平台方统一管控引擎规则、全局配置、安全策略；各租户可独立自定义流程模板、表单、节点权限、审批规则。常见于政务、园区、高校、大型国企的统一流程中台
5. 逐步迁移 / 试点上线
   • 先搭建统一工作流引擎，按租户分批接入不同单位/部门。新旧流程、不同试点团队数据隔离，实现平滑过渡

不建议使用的场景

说明

单机构独立使用：无多组织隔离需求时，直接单实例部署即可，多租户会增加架构复杂度。

模式配置

授权文件支持

申请授权时，需在租户数量字段填写多个。

重新上传授权地址：

工程名/workflow/init/config/index.html?loadFlag=3

切换为多租户模式

提供以下两种修改方式：

方式一：通过页面修改（保存后直接生效）

在系统配置页面中直接切换模式。

方式二：通过配置文件修改（修改后需重启生效）

修改 horizon.properties 中的 initFlag 参数为多租户模式：

# 产品默认初始化方式：1-多租户模式，3-单实例模式
initFlag=1

配置文件路径

• JAR 包工程：默认路径为 操作系统当前用户根目录/workflow（例如 Win7 系统：C:\Users\Administrator\workflow，若路径有修改请按实际路径查找）
• WAR 包工程：路径为 WEB-INF/workflow-conf/properties/horizon.properties

租户数据库准备

在新增租户前，需提前创建一个空的数据库，以备租户初始化时使用。

新增租户

1. 在浏览器地址栏输入系统管理地址：

   http://IP地址:端口/应用名/index_system.html

2. 使用默认账号登录：

   • 用户名：system
   • 密码：1234

异常提示

如果登录时出现以下提示，说明 horizon.properties 中的 initFlag 未正确配置为多租户模式，请检查配置并重启服务。

3. 登录成功后，进入租户管理页面：

   

4. 点击新建按钮，填写并保存租户信息：

   

注册租户

新增租户 vs 注册租户

注册租户仅用于录入已完成初始化的数据库配置信息，系统不会再对其执行业务数据初始化操作，适用于已有现成数据库的接入场景。

访问租户

1. 在浏览器中输入应用访问地址：

   http://IP地址:端口/应用名

   页面将展示租户选择界面：

   

2. 从下拉框中选择已添加的租户名称，使用默认账号登录：

   • 用户名：admin
   • 密码：1234

3. 登录成功后，即可正常使用该工作流系统下的各项租户功能。