私有化版并发说明
Self-hosted 并发计算原理、超限提示、处理方法与增购并发授权说明
本文说明 VeryReport Self-hosted 私有化的并发授权规则：并发如何计算、超过上限时系统如何提示、管理员与普通用户应如何处理，以及如何增购并发数。
适用说明：VeryReport 仅提供私有化交付，按并发授权（订阅或永久授权）。安装包见 下载页；部署与交付说明见 部署与交付方式（原 /docs/product-overview/saas-vs-private 已改向下载页）。
一、什么是并发？
License 中的并发数（concurrency），表示同一时刻允许同时占用业务主界面的浏览器会话（Tab / 独立窗口）数量上限。
- 并发 ≠ 账号数：您可以创建任意多个用户账号，但同一时刻最多只有 License 授权数量的会话在「占槽」。
- 并发 ≠ 按用户去重：同一账号开多个 Tab / 多个浏览器窗口，每个 Tab（或独立窗口）各占 1 个并发。
- 示例：购买 10 并发，可注册 200 个账号；若已有 10 个 Tab 正在使用主界面，第 11 个 Tab 再进入将触发并发超限提示。
- 不限并发：License 中并发为
-1或未限制时，系统不做并发拦截。
二、并发计算原理
2.1 什么情况下占用 1 个并发？
系统在用户进入产品主布局后自动申请并发槽（前端 touch），与当前打开的是报表还是工作台无关：
| 场景 | 是否占并发 | 说明 |
|---|---|---|
| 登录后进入主界面（工作台、Vera、报表/看板/大屏/填报、数据中心、系统管理等） | 占用 | 主布局挂载即申请槽位并定时心跳 |
| 同一浏览器 Tab 内切换菜单 / 多份报表 | 仍算 1 | 同一 Tab 的 sessionId 不重复计数，仅刷新活跃时间 |
| 同一用户新开 Tab，或另开 Chrome 窗口 / 无痕窗口访问 | 各算 1 | 每个 Tab / 独立窗口有独立会话标识 |
| 仅停留在登录页（尚未进入主界面） | 不占 | 未挂载主布局、未发起占槽 |
| 全屏设计器等独立布局页（若未走主布局） | 以实际是否发起 touch 为准 | 多数业务页经主布局进入，按上表「占用」理解即可 |
注意：不要用「多个管理员 Tab」验证并发=1——管理员在满员时仍可进入（见下文），普通用户才会被「访问人数已满」拦住。
2.2 系统如何统计活跃会话？
- 用户进入主界面后，前端约每 5 分钟向服务端发送一次心跳（
touch），刷新该会话的最后活跃时间。 - 服务端维护当前活跃会话列表；若某会话 30 分钟无心跳，视为已离线并自动释放并发槽（如强关浏览器未正常退出）。
- 用户退出登录或关闭 Tab 时，前端会调用
release释放槽位（登出时会携带会话标识，避免清 token 后无法释放）。 - 并发上限读取当前激活 License 中的
concurrency字段；可在「授权管理 → 授权状态」查看已购并发数。
2.3 计数公式（理解用）
在任意时刻，有效并发占用数 = 当前未过期（30 分钟内有过心跳）的独立 sessionId（Tab 级） 数量。当该数量 ≥ License 并发上限 时，新的普通用户会话无法再占槽；管理员见下文例外。
三、并发超过上限时会怎样？
当新会话（新 Tab）尝试占槽，而当前活跃会话已达授权上限时：
- 普通用户：服务端返回业务错误码 40310（
CONCURRENCY_LIMIT_EXCEEDED）。 - 页面弹出「访问人数已满」阻断提示，请等待其他会话退出或超时释放后重试。
- 系统不排队：必须等有人释放槽位后才能进入。
- 提示页提供「立即重试」；同时约每 60 秒自动重试一次占槽。
- 管理员在已满时进入：系统会自动踢出最久未活跃的会话后放行（便于运维介入；管理员多个 Tab 之间也可能互相挤占这 1 个槽）。
四、遇到「访问人数已满」如何处理？
4.1 普通业务用户
- 点击提示中的立即重试，或等待倒计时结束自动重试。
- 联系已占线的同事关闭不再使用的 Tab，或退出登录释放并发。
- 若长期满额，向 IT 管理员或采购同事反馈，评估增购并发。
4.2 系统管理员
超级管理员进入产品内 授权管理（路径：系统管理 → 授权管理）：
- 在授权状态页查看 License 中的并发上限与客户信息。
- 切换到并发会话页，查看当前在线会话列表（会话 ID、用户名、IP、最近活跃时间等），便于排查谁在占槽。
- 当前版本不提供在列表中「手动踢出指定会话」的按钮；释放方式为：对应用户退出/关 Tab，或等待约 30 分钟无心跳超时，或管理员自身进入时自动踢出最旧会话。
- 服务重启（本地内存槽）也会清空会话占用；多实例请配置 Redis 共享并发计数。
4.3 常见释放场景
| 场景 | 并发何时释放 |
|---|---|
| 用户点击退出登录 | 立即释放（登出请求携带会话标识） |
| 关闭浏览器 Tab（正常） | 页面卸载 / pagehide 时尽力释放 |
| 强关浏览器 / 断网 | 最迟约 30 分钟后超时释放 |
| 管理员满员进入 | 自动踢出最旧会话后，被踢会话释放 |
五、如何增加并发？
并发属于商务授权项：订阅可在官网控制台按并发×月下单；永久授权增并发请联系销售/客户成功。
5.1 增购流程
- 订阅增并发：登录门户 增加并发，按剩余周期补差价；或到 购买授权 续订更高并发。
- 永久授权 / 方案报价：通过 联系我们 说明当前并发与目标档位；金额以商务报价为准（参见 官网定价）。
- 获取 Auth Code / License：支付完成后在私有化授权控制台 查看；本机「授权管理」同步或粘贴激活，立即生效，无需重装。
5.2 常见档位与升级说明
| 项目 | 说明 |
|---|---|
| 典型档位 | 按需选择并发数（以订单 / 合同为准） |
| 升级方式 | 订阅周期内补差价；永久授权走方案报价 |
| 账号数量 | 与并发独立，可按组织需要创建更多用户 |
| 模块授权 | 报表、BI、大屏、填报、Vera 等全功能，不按模块裁剪 |
| 技术支持 | 可选年度维保；版本升级通常随支持合同提供 |
5.3 容量规划建议
- 按业务高峰同时打开的 Tab / 窗口数估算，而非注册账号总数；同一人开多 Tab 会叠加占用。
- 报表集中报送、经营分析早会、大屏轮播等场景易形成并发尖峰，建议预留余量。
- 多实例集群部署时，并发计数依赖 Redis 共享存储；若未配置 Redis 则仅单机进程内计数（集群下可能不准，建议保障 Redis）。
六、相关文档
| 文档 | 说明 |
|---|---|
| 下载安装包 | Self-hosted 安装包（免登录） |
| 版本与授权说明 | 订阅、永久授权与试用权益 |
| 常见问题（FAQ） | 试用、授权、发票等补充问答 |
| 官网定价 | 订阅 / 永久授权 / Token |
| 联系我们 | 增购并发、获取报价 |
中创微（上海）软件有限公司 · VeryReport