注册即得一个独立租户
SaaS 版由我们运营。一套部署服务多个机构，每个机构是一个租户，彼此看不到对方的任何数据。
- 工作台在哪
- 浏览器打开 app.jylock.cn 即可使用，不需要在机构内安装服务端。登录时除了账号密码，还要填写本机构的「机构登录标识」，用来指明你属于哪个租户。
- 怎么开通
- 在注册开通页填写机构名称、机构登录标识、管理员登录名与密码、联系邮箱，提交即开通，不经人工审核。得到的第一个账号是本租户的系统管理员，租户内的其他人由它建立；首次登录可以生成示例数据，也可以保持空白自行配置。
- 租户之间怎么隔离
- 每个租户的人员、部门、区域、房间、设备与授权只属于这个租户，租户之间零共享。所有业务数据都带租户标识，读取时由持久层按当前租户自动过滤、写入时自动填充，而不是靠每条查询各自记得加条件；每个请求只在一个租户内读写。
- 托管位置与备份
- SaaS 的托管位置、备份策略与保留周期，签约前提供具体说明。
- 现场设备
- 微耕门禁控制器通过现场的 Edge Agent 接入，Edge Agent 主动向外连接，现场网络不需要为门禁开放入向端口。见下文「现场节点」；各品牌的支持情况见接入与兼容页。
跑在机构自己的服务器上
私有化部署由机构掌握服务器与数据库。下面是部署文档与部署脚本里已经写定的内容。
- 部署形态
- 单节点。后端是一个 Spring Boot 服务，前端是静态资源，数据库是 MySQL 8 或 MariaDB，前面由 nginx 反向代理；后端只监听本机地址，不直接对外暴露。部署指南面向 Debian 13 与 Ubuntu 24.04 LTS。
- 运行位置
- 机构自己的服务器，或机构专属的云环境。服务器、网络与数据库由机构掌握。
- 数据位置
- 门禁数据、人员授权、通行日志与操作审计都存在这套部署自己的数据库里，不出机构网络。如果对接外部身份平台、邮件服务等外部系统，这些对接涉及哪些数据流出，按具体方案逐项确认。
- 密钥管理
- JWT 密钥、数据库口令、邮件与消息通道凭据全部写在服务器上的环境变量文件里，文件权限收紧到运行账号可读，不进代码仓库。
- 备份与日志
- 部署脚本安装了数据库定时备份（按天保留，保留天数可配置）与日志轮转两个定时任务。通行日志、操作审计与告警的保留天数在系统设置里配置；当前版本只保存这项配置，不会按它自动清理历史记录。
- 更新与回滚
- 服务器从发布制品仓库拉取已构建好的版本更新，部署文档写明了状态检查与回滚步骤。私有部署不展示官网注册与试用入口。
Edge Agent：控制器和系统之间的那一跳
Edge Agent 是装在门禁现场的一个独立程序，负责在门禁控制器与系统后端之间转发上报和指令。SaaS 与私有化部署都通过它接入现场设备。
它装在哪
和门禁控制器同一个网段的机器上：控制器与后端在同一网络时可以和后端装在同一台机器，不在同一网络时装在现场工控机上。现场机器只需要 Java 运行环境，不需要数据库和 nginx。
它做什么
接收控制器的刷卡、扫码与门磁等上报转给后端，再把后端的开门、常开、门控参数与状态查询指令转给控制器。它只做转发，不判权、不存业务数据；用出站 WebSocket 回连后端，所以现场网络不必为门禁开放任何入向端口。
它怎么认证
每个 Edge Agent 在机构后台单独注册，拿到自己的 ID 与密钥；密钥明文只在注册时出现一次。它与人的账号完全分开，拿不到管理接口。
断线时会怎样
刷卡、扫码由系统判权后再下发开门指令，所以 Edge Agent 与后端断开期间，经系统判权的开门无法完成。这段时间的上报暂存在 Edge Agent 内存里，恢复后按原顺序补发、只做留痕不再开门，在门禁监控里记为失败通行，原因标为「Edge Agent 离线」，时间是现场真正发生的时刻。缓存不落盘，Edge Agent 进程重启即丢弃。
按运维条件和数据要求选，而不是按功能选
两种形态的授权、审批、访客与日志能力是同一套。差别在于谁来运维、数据放在哪里。
倾向 SaaS
希望尽快开始、没有专门的服务器运维，或者想先用一栋楼、一个院系把授权关系跑起来。注册开通后即可配置空间、房间与授权，再按需接入现场设备。
倾向私有化
机构要求门禁数据存放在自己的机房或专属云，并且有人负责服务器、数据库与备份。部署与日常运维按部署文档执行，现场设备同样经 Edge Agent 接入。
两种都要先评估的
需要对接机构统一身份平台、需要接入现有门禁控制器、或者门的规模较大时，无论选哪种形态，都建议先预约演示，由技术人员确认身份来源、设备型号与网络条件。
部署上还没有的东西
- 当前按单节点部署设计：多节点部署、负载均衡集群与故障时的自动切换都不在已交付范围内。
- SaaS 与私有化之间没有自助的数据迁移工具；需要转换部署形态时，在技术评估中单独确认做法。
- 私有化部署不提供租户自助注册入口，账号由机构管理员在系统内建立。
关于部署方式
- 今约锁的 SaaS 版和私有化部署是同一套产品吗？
- 是同一套系统。SaaS 版的工作台在 app.jylock.cn，机构注册开通后得到一个独立租户；私有化部署把同一套后端、前端与数据库装在机构自己的服务器或专属云上，并关闭官网的注册与试用入口。
- SaaS 版不同机构之间的数据是怎么隔离的？
- 每个机构是一个租户，人员、部门、区域、房间、设备与授权只属于该租户。所有业务数据都带租户标识，读取由持久层按当前租户自动过滤、写入自动填充，每个请求只在一个租户内读写。SaaS 的托管位置与备份策略在签约前提供具体说明。
- 私有化部署需要什么样的服务器环境？
- 单节点即可：一个 Spring Boot 后端服务、静态前端资源、MySQL 8 或 MariaDB 数据库，前面用 nginx 反向代理。部署指南面向 Debian 13 与 Ubuntu 24.04 LTS，部署脚本包含数据库定时备份与日志轮转。
- 现场的门禁控制器怎么连到系统？需要开放端口吗？
- 通过部署在控制器同一网段的 Edge Agent 接入。Edge Agent 用出站 WebSocket 回连后端，现场网络不需要为门禁开放入向端口；它用自己单独注册的凭证认证，与人的账号分开。
- 支持多节点或高可用部署吗？
- 目前不支持。系统按单节点部署设计，多节点、集群与故障自动切换不在已交付范围内。