本页带您从“墙上装了一台终端”走到“SolaHR 能读取它”:找到设备,在型号目录中选择它,从设备自带菜单中获取 IP 地址、端口和通信密钥(Comm Key),测试连接并理解返回的状态。逐步点击的界面说明在考勤设备中;本页补充您所需的相关知识。
开始之前,连接器应已安装并显示在线,除非您打算使用推送或文件导入。
#简要步骤
- 考勤 → 考勤设备 → 添加设备。
- 为其命名,选择它的考勤位置和设备时钟时区(例如
Asia/Amman)。 - 选择连接类型和连接器,并输入设备 IP 地址、端口和通信密钥(Comm Key)(留空表示 0)。
- 点击测试连接。成功时会显示设备的型号、固件、用户数和记录数及其时钟。
- 映射用户,然后点击保存并开始同步。
您可以中途退出:未完成的设备会显示设置未完成,并提供继续设置。
#发现:让连接器找到设备
在连接器电脑上打开连接器页面(http://127.0.0.1:8790),点击查找设备。它会对本地网络进行只读搜索,不会更改任何内容。在 SolaHR 中,结果显示在连接器发现的设备下,并附有地址和端口;一键即可填入地址。需要通信密钥的设备会标注“需要登录(通信密钥,通常为 0)”。
发现功能只能看到与电脑处于同一网段的设备,并且只支持连接器已知的协议。如果找不到您的终端,它可能位于另一个 VLAN,或者属于不能直接读取的类型。请自行输入地址。
#型号目录
在您的设备下,您可以按品牌或型号搜索目录。当前版本包含来自 ZKTeco、Hikvision、Suprema、Anviz 和 EBKN 的 147 款型号。选择其中一款后会显示:
| 已显示 | 含义 |
|---|---|
| 已在真实设备上测试 | 已实际连接成功,并注明了固件。目前仅有 ZKTeco iFace702。 |
| 预计可用 · 同一协议系列 | 资料显示与某款可用型号使用相同协议;我们未实际试过。 |
| 未知:未测试 | 已收录在目录中,但没有任何证据表明可用或不可用。 |
| 推荐设置 | 点击应用推荐设置按钮,即可填入端口、传输方式和编码。 |
| 在该设备上哪里查找设置 | 菜单路径(下文有概述)。 |
| 已知问题和后续步骤 | 例如,ZKTeco 固件 Ver 6.60 即使通信密钥为 0 也要求登录;连接器 0.1.5 及更高版本可处理这种情况。 |
型号为可选项。如果该型号的最佳连接类型与您所选的不同,SolaHR 会提供切换为 ...。完整列表以及官方手册和支持链接见支持的设备。不在目录中的设备如果使用相同的协议,仍可能正常工作;请尝试测试连接。
#在设备上查找 IP 地址、端口和通信密钥
各厂商对菜单的措辞略有不同,菜单也会因型号和固件而异。请将这些路径作为参考,并以设备自带手册为准(链接见支持的设备)。
#ZKTeco(直连,端口 4370)
在大多数 ZKTeco 终端上,按菜单,然后:
| 您需要 | 设备上的位置 |
|---|---|
| IP 地址、子网掩码、网关、DHCP | 菜单 → 通讯 → 以太网 |
| 端口 | 同一屏幕中的TCP 通讯端口。出厂值为4370;除非您改过,否则保持不变。 |
| 通信密钥(Comm Key) | 菜单 → 通讯 → 连接电脑 → 通信密钥。1 至 6 位数字;0 表示无密钥(出厂值)。 |
| 设备 ID/机器号 | 同在连接电脑屏幕。除非您的设备使用其他编号,否则将 SolaHR 中的机器号保持为 1。 |
| ADMS 服务器(用于推送,替代连接器) | 菜单 → 通讯 → 云服务器设置:服务器地址(如果启用了域名选项,则为域名)和服务器端口。 |
全新出厂的 ZKTeco 终端据文档默认 IP 为 192.168.1.201,掩码为 255.255.255.0,因此电脑和终端必须处于同一网段,或者先修改设备的地址。上述菜单名称来自 ZKTeco 自己的最新手册(例如SpeedFace-V3L 用户手册);iClock 系列等较旧的终端菜单类似。传输方式:保持自动(先用 TCP,仅在 TCP 失败时用 UDP)。阿拉伯语名称显示乱码:保持 UTF-8,然后尝试 Windows-1256(cp1256),再尝试 GBK。
#Hikvision(ISAPI,网页端口 80)
Hikvision 终端主要通过其内置网页进行配置。
| 您需要 | 位置 |
|---|---|
| 在网络中找到设备 | Hikvision 的SADP工具(位于HiTools中)可列出本地网络中的 Hikvision 设备、激活新设备并更改其 IP。Hikvision 表示 SADP 自 2026 年 4 月起不再更新,并推荐其较新的HiTools Delivery。 |
| IP 地址 | 设备网页 → 配置 → 网络 → 基本设置 → TCP/IP |
| 供 SolaHR 使用的登录账号 | 网页 → 配置 → 系统 → 用户管理。为 SolaHR 创建一个单独的用户;不要使用 admin。 |
| 端口 | 80(HTTP),除非在设备的网络设置中修改过 |
新的 Hikvision 设备必须先激活(设置管理员密码)才能使用。Hikvision 在其手册中给出了出厂地址;请以手册为准,不要猜测。
#Suprema(通过 BioStar 2 服务器)
SolaHR 不会直接与 Suprema 终端通信,而是从您的 BioStar 2 服务器读取事件。
| 您需要 | 位置 |
|---|---|
| 服务器地址 | BioStar 2 网页的地址,通常为 https://<server>:443 |
| 登录账号 | 在 BioStar 2 中创建一个只读操作员;不要使用主管理员 |
| 事件类型 | BioStar 2 用代码标记每个事件;如果导入的内容过多,请在 SolaHR 的设备设置中设置允许的事件代码 |
终端 IP 地址和服务器设置须在 BioStar 2 中配置;参见BioStar 2 管理员指南。
#Anviz(直连,TCP 5010,或 CrossChex Cloud)
| 您需要 | 位置 |
|---|---|
| IP 地址和端口 | 设备菜单 → 通信/网络(部分型号:设备的网页)。默认端口为5010。 |
| TCP 模式 | 设置为服务器,以便连接器电脑连接到设备。(客户端模式让设备主动连接到某台电脑,适用于位于其他网络的设备。) |
| 设备 ID | 如果使用,在同一通信菜单中设置 |
| 端口和 ID 必须一致 | SolaHR 中的端口必须与设备上设置的端口相同 |
使用CrossChex Cloud时,您需要一个具有开发者权限(API 密钥和密钥密文)的 Anviz 云账号;连接器电脑上无需任何设置。SolaHR 还会询问应如何解读云端的checktime(UTC 还是本地时间),因为 Anviz 没有明确说明:请根据您在 CrossChex Cloud 中看到的情况选择。
#EBKN/Secureeye(仅推送)
没有直接连接。请在设备的服务器/云设置中输入 SolaHR 设备页面上显示的推送地址。
#其他任何终端
使用文件导入(从设备导出),或者,如果终端或其软件可以将打卡发送到网址,则使用通用推送方式(SolaHR 会显示一次性地址和令牌)。
#测试连接
点击测试连接。SolaHR 会请求连接器联系设备,通常需要几秒钟。成功时会显示型号、固件、设备上的用户、设备上的记录和设备时钟。如果时钟相差超过两分钟,会出现警告,因为打卡时间以设备时钟为准。您也可以暂时跳过。
#状态含义
| 您看到 | 含义 | 操作建议 |
|---|---|---|
| 可连接(绿色),并显示型号和数量 | 设备已响应,密钥已被接受。 | 继续进行映射。 |
| 可连接 · 通信密钥被拒绝 | 设备在线,但密钥不正确。 | 请输入菜单 → 通讯 → 连接电脑中的通信密钥。没有设密钥的设备,其密钥为 0。 |
| 可连接 · 设备忙碌 | 设备正被占用(通常是有人正在登记或设备正在同步)。 | 等待一分钟后再次测试。 |
| 无法连接设备/“未在规定时间内响应” | 该地址和端口没有任何响应。 | 检查电源、网线、地址、端口、是否在同一网络以及防火墙。参见故障排查。 |
| “连接器未接收到该请求” | 连接器电脑已关机、处于睡眠状态或已离线。 | 将其开机。等待中的打卡之后会发送。 |
| 需要设置 | 此连接类型需要电脑上安装厂商软件,而该软件尚未就绪。这是一种状态,并非终端故障。 | 请按照厂商 SDK 设置操作,或切换为内置的直接连接。 |
| “序列号不匹配” | 该地址上的设备不是已登记的那一台。 | 请检查 IP 地址;可能有两台设备互换了地址。 |
| “连接器已被撤销”/“需要重新配对” | 连接器已失去配对。 | 请在连接器标签页中重新配对。 |
| 设置未完成 | 您在引导步骤结束前离开了。 | 继续设置。 |
| 离线/“连接器 ... 已离线”(显示在卡片上) | 连接器电脑已关机或没有网络。 | 将其开机;等待中的打卡稍后会发送。 |
| “设备推送到 SolaHR - 最后联系时间 ...”(推送设备) | SolaHR 最后一次收到该设备消息的时间。 | 如果时间已很久,请检查设备的服务器设置和网络。 |
#推送设备(ADMS 及类似)
终端也可以不通过连接器,而直接向 SolaHR 推送打卡。您需要先在 SolaHR 中登记该设备(SolaHR 需要其序列号),然后在终端的云/ADMS 设置中输入 SolaHR 的地址(ZKTeco 上为菜单 → 通讯 → 云服务器设置)。推送方式简单,但依赖于设备序列号的可信度,因此请尽量缩小允许的网络范围并审核打卡记录。许多 ADMS 终端只支持普通 HTTP;您的管理员可能需要在网络服务器上允许这一点,设备页面上的安装就绪检查面板会检查此项。