Solavel 文档
中文

安装 Device Connect 连接器

最后更新

连接器是读取考勤终端并把打卡发送到 SolaHR 的小型 Windows 程序。本页介绍下载、安装、配对、更新和移除,并列出出现问题时的检查项。如果想先了解思路,请阅读概览。

预览版。连接器已用模拟器和一款真实终端型号构建并检查。它尚未进行代码签名,因此运行时 Windows 会发出警告。请先在一台电脑和一台设备上试用。

#在您开始之前

需要 详细信息
一台 Windows 电脑或服务器 Windows 10 或 11,或 Windows Server 2016 及更高版本,64 位。不支持 Windows 7/8、32 位 Windows 和 ARM。
始终开机 电脑必须保持开机且不休眠,并与终端处于同一网络(和 VLAN)。普通办公电脑或服务器均可。
管理员权限 用于安装,以及之后注册厂商 SDK。
互联网 出站 HTTPS 访问您的 SolaHR 地址(例如 https://solavel.com/hr)。无需入站端口。
有权管理设备的 SolaHR 用户 所有者或 HR 经理。
终端的 IP 地址 如有通信密钥也需要。参见添加设备。

不需要特殊硬件;普通办公电脑即可(我们尚未公布实测的最低配置)。

#选择安装包

在 SolaHR 中打开时间与考勤 → 考勤设备 → 连接器 → 添加连接器。针对 Windows 10 / 11 · 64 位提供两种下载,各自标明版本和大小。

安装包 它是什么 适用场景:
Windows 安装程序 .exe(推荐) 将连接器安装为Windows 服务:开机自动启动,故障后自动重启,升级时保留其数据。 常规用途。
便携 ZIP 无需安装程序。解压后运行 install.cmd,它会注册一个在开机时启动连接器的计划任务。它不是 Windows 服务。 快速测试,或无法运行安装程序的电脑。

两者都标有预览版。如果页面显示“Windows 安装程序即将在此提供。”,说明尚未发布任何安装包。

校验您的下载。在详情下可找到发行说明和一条 PowerShell 命令。运行并比对:Get-FileHash 的结果必须与页面上显示的 SHA-256 值一致。

#逐步安装与配对

  1. 以管理员身份运行安装程序(右键,以管理员身份运行)。使用 ZIP 时:右键 ZIP,选择全部提取,双击 install.cmd,并回答是。
  2. SmartScreen。由于预览版未签名,Windows 可能显示“Windows 已保护你的电脑”。核对 SHA-256 后,点击更多信息,再点击仍要运行。程序签名后此警告会消失;在此之前属于正常现象,并不表示有问题。
  3. 连接器页面会打开,在浏览器中地址为 http://127.0.0.1:8790。此页面仅在该电脑上可用。开始菜单中也有SolaHR Device Connect。
  4. 获取配对码。在 SolaHR 中点击添加连接器并复制配对码。它只能使用一次,并在15 分钟后过期;过期后请重新生成。
  5. 配对。在连接器页面输入您的 SolaHR 地址(例如 https://solavel.com/hr)和配对码,然后按Pair。
  6. 一分钟内,连接器会在 SolaHR 中显示为在线。现在添加设备并分配给此连接器。

面向 IT 团队:安装程序也支持静默运行,可选带上地址和配对码:

SolaHR-Device-Connect-Setup-<version>.exe /S /SERVER=https://solavel.com/hr /CODE=<pairing code>

#安装程序在电脑上放置的内容

项目 位置
程序 C:\Program Files\SolaHR Device Connect
Windows 服务 SolaHRDeviceConnect(自动启动,故障后自行重启)
数据:设置、加密的机密信息、尚未发送的打卡、日志 C:\ProgramData\SolaHR Device Connect(仅 Windows 管理员和系统可读)
本地页面 http://127.0.0.1:8790(仅此电脑)
命令行辅助工具 solahr-dc (pair, status, diagnostics, run, version)

检查是否在运行:在 Windows 命令提示符中,sc query SolaHRDeviceConnect 应显示RUNNING。

#防火墙与网络

方向 内容 注释
连接器电脑到 SolaHR HTTPS (443) 仅出站。如果办公室使用代理或过滤网站,请放行您的 SolaHR 地址。
连接器电脑到 ZKTeco 终端 TCP 和 UDP 4370 终端自己的端口。
连接器电脑到 Anviz 终端 TCP 5010 Anviz 默认端口;请在设备上确认。
连接器电脑到 Hikvision 终端 HTTP/HTTPS(设备的网页端口,默认 80)
连接器电脑到 Suprema BioStar 2 服务器 HTTPS(默认 443) 通过 BioStar 2 服务器读取,而不是通过终端。
其他设备到连接器电脑 无 没有任何设备连接到连接器。

Windows 防火墙通常允许出站连接。如果您的网络将电脑和终端隔开(不同的 VLAN),请允许它们之间使用这些端口。

#连接器页面

打开 http://127.0.0.1:8790(或开始菜单中的快捷方式)。页面显示连接器是否已配对并在线、其设备,以及有多少打卡等待发送。支持英语和阿拉伯语、浅色和深色模式。它还提供:

  • 查找设备:对本地网络中受支持的终端进行只读搜索。结果会显示在 SolaHR 的连接器发现的设备下。
  • 设置所需软件:厂商 SDK 的引导式设置。参见厂商 SDK 设置。
  • 允许更改设备:默认关闭。关闭时,SolaHR 只能读取,不能编辑、启用、停用、删除或推送用户,并显示“此设备的更改已在连接器电脑上关闭。”
  • 取消配对。

#升级

运行较新的安装程序。它会替换程序文件并重启服务。配对、设置和等待中的打卡都会保留,因此无需重新配对。从便携 ZIP 迁移到安装程序的方式相同:旧的计划任务会被移除,因此不会同时运行两个连接器。

#迁移、撤销和卸载

  • 迁移到另一台电脑。安装并配对新的连接器,然后在 SolaHR 中更改设备的连接器。在连接器标签页中撤销旧的连接器。
  • 撤销。在 SolaHR 中,对该连接器点击撤销。其设备将停止同步。该电脑上等待中的打卡会留在原处,除非重新配对,否则不会发送。
  • 卸载。Windows 设置 → 应用。系统会询问“是否同时删除连接器数据?”默认选项是否:数据(包括尚未发送的打卡)会被保留,以便重新安装后继续使用。选择是将删除未发送的打卡。

#安全要点

  • 连接器页面仅监听 127.0.0.1,并拒绝其他地址。
  • 配对令牌和通信密钥以加密方式存储。但该电脑上拥有管理员权限的任何人仍可访问它们:请像对待服务器一样对待这台电脑。
  • 日志中已去除令牌和密钥。solahr-dc diagnostics 会生成不含机密信息的支持包。
  • 指纹和人脸绝不会发送到 SolaHR。

#安装问题排查

现象 检查内容
Windows 阻止或警告该文件 未签名的预览版出现这种情况属于正常。请核对 SHA-256,然后点击更多信息 → 仍要运行。如果公司策略禁止运行未签名的程序,请让 IT 放行,或等待已签名的正式版本。
安装程序提示需要管理员权限 右键点击,选择以管理员身份运行。
配对时提示“代码已过期” 代码有效期为 15 分钟,且只能使用一次。请重新生成。
配对失败 SolaHR 地址是否输入完全正确(包括 https://)?这台电脑能否在浏览器中打开它?是否有代理拦截?
连接器在 SolaHR 中一直显示离线 电脑是否开机并联网?服务是否正在运行(sc query SolaHRDeviceConnect)?如果需要重新配对,连接器页面会提示您。
127.0.0.1:8790 无法打开 可能有其他程序占用了端口 8790。即使没有该页面,服务仍会同步。
“连接器需要重新配对”/“连接器已被撤销” 重新生成配对码并再次配对。等待中的打卡会保留。
服务启动后立即停止 在管理员命令提示符中运行 solahr-dc run,在屏幕上查看错误,并将 solahr-dc diagnostics 的输出发送给支持团队。

更多内容见故障排查与常见问题。