Solavel 文档
中文

添加设备

最后更新

本页带您从“墙上装了一台终端”走到“SolaHR 能读取它”:找到设备,在型号目录中选择它,从设备自带菜单中获取 IP 地址、端口和通信密钥(Comm Key),测试连接并理解返回的状态。逐步点击的界面说明在考勤设备中;本页补充您所需的相关知识。

开始之前,连接器应已安装并显示在线,除非您打算使用推送或文件导入。

#简要步骤

  1. 考勤 → 考勤设备 → 添加设备。
  2. 为其命名,选择它的考勤位置和设备时钟时区(例如 Asia/Amman)。
  3. 选择连接类型和连接器,并输入设备 IP 地址、端口和通信密钥(Comm Key)(留空表示 0)。
  4. 点击测试连接。成功时会显示设备的型号、固件、用户数和记录数及其时钟。
  5. 映射用户,然后点击保存并开始同步。

您可以中途退出:未完成的设备会显示设置未完成,并提供继续设置。

#发现:让连接器找到设备

在连接器电脑上打开连接器页面(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;您的管理员可能需要在网络服务器上允许这一点,设备页面上的安装就绪检查面板会检查此项。

#下一步