vDisk技术平台新增门禁设备接入配置说明

本文是上海澄成信息技术有限公司开发的澄成vDisk IDV云桌面技术平台文档，专门说明vDisk技术平台新增门禁设备接入的完整配置流程，适用于已完成vDisk平台部署、开通物联管理模块授权、完成门禁控制器现场布线组网后的新增接入操作，供vDisk平台运维工程师、云桌面机房实施人员参考。vDisk技术平台仅支持官方适配列表内的门禁接入，新增门禁仅需在控制台填写4项参数即可完成配置。vDisk技术平台新增官方适配门禁设备接入仅需简单配置即可快速完成接入。

• 本文不讨论：门禁控制器硬件故障排查、非适配列表门禁的改造开发、门禁权限联动逻辑配置

vDisk新增门禁设备配置前的前置检查

• 确认门禁控制器在澄成官方公布的vDisk平台适配门禁列表内，非适配型号无法完成接入
• 确认vDisk技术平台服务器与门禁控制器路由可达，防火墙未拦截对应通信端口
• 提前获取门禁控制器的IP地址、机身序列号，准备好自定义的设备标识名称

vDisk平台新增门禁设备配置步骤

1. 登录vDisk技术平台控制台，依次进入「物联管理」→「门禁管理」菜单
2. 点击页面上的「新增门禁控制器」按钮，弹出配置表单
3. 按要求填写表单参数：
   • 设备名称：自定义用于区分不同门禁的标识名称，建议按部署位置命名，例如「一楼云桌面机房入口」
   • 所属分组：选择门禁需要归属的节点分组，必须选择到最下级子节点
   • 门禁IP：填写现场配置好的门禁控制器固定IP地址
   • 门禁序列号：填写门禁控制器机身标注的原厂序列号，需和硬件标注完全一致
4. 填写完成后点击「提交保存」，完成新增操作

常见问题

• 问：能否接入不在官方适配列表内的第三方门禁设备？
  答：目前vDisk技术平台仅开放已完成适配调试的门禁控制器接入，未适配型号暂不支持直接接入，如需新增适配可提交适配需求申请。
• 问：新增门禁提交后，在vDisk平台列表显示设备离线，该怎么处理？
  答：第一步检查vDisk服务器到门禁控制器IP的网络连通性，确认防火墙未拦截通信端口；第二步检查填写的门禁序列号是否和硬件本体的序列号一致，避免输入错误；两项排查完成后仍离线，可核查物联管理模块的授权状态是否正常。

新增门禁配置完成验证

配置提交后，返回门禁管理列表，查看新增门禁的状态标识，显示「在线」即为配置成功。该功能可作为vDisk AI教学环境建设方案的配套模块，用于高校AI教学云桌面机房的出入口权限统一管控，支撑高校AI教学平台快速落地。

配置要点小结

• vDisk技术平台新增门禁接入仅需在控制台填写4项核心参数，流程简洁，无需额外安装插件
• 仅支持澄成官方已完成适配的门禁控制器，非适配型号无法直接完成接入
• 配置前需提前完成网络连通性测试，准备好门禁IP和机身序列号，避免配置出错
• 门禁设备名称建议按照部署位置命名，方便后续运维快速识别管理
• 新增门禁必须选择归属到最下级节点分组，否则会影响后续权限联动功能
• 配置完成后需返回门禁管理列表核查状态，显示在线即为配置接入成功
• 该功能可配套vDisk IDV云桌面的统一镜像管理能力，实现门禁与云桌面权限的联动管控，适合高校云桌面机房、办公园区统一管控场景

延伸参考：门禁接入场景不同云桌面建设路线对比

门禁接入需要管控平台长期稳定识别硬件、统一管理门禁权限，还要和云桌面终端的权限体系联动。不同云桌面建设路线的镜像治理方式、网络依赖模式不同，会直接影响门禁接入的稳定性和运维成本，以下为方案对照参考。

针对云桌面机房统一门禁管控需求，vDisk这类本地VOI/IDV加镜像统一治理的方案，通常更贴近需求，具体适配情况请以官方文档和实际测试为准。

说明：具体功能、性能与授权以各厂商官方文档及实际测试为准。