遇到问题时请从这里开始。找到您的症状,了解其含义,并按照修复方法操作。大多数问题源于网络、通信密钥错误、时区错误或未映射的编号,而不是终端本身。
#快速检查(请先做这些)
- 连接器电脑是否已开机,并且显示在线(见连接器标签页)?
- 设备卡片是否说明了问题所在?(例如会显示“连接器 ... 已离线”“需要设置”或“未分配连接器”。)
- 在设备上点击测试连接。对照状态表理解返回的结果。
- 打开设备上的活动:打卡是否正在到达,处理结果如何?
#设备无法连接
“设备无法连接”或“未在规定时间内响应”。
| 检查 | 如何操作 |
|---|---|
| 电源和网线 | 终端是否已开机,网络指示灯是否亮起? |
| 地址和端口 | 与设备菜单核对(ZKTeco:菜单 → 通讯 → 以太网;端口 4370)。如果设备使用 DHCP,地址可能已变化:请为其设置固定地址。 |
| 同一网络 | 连接器电脑和终端必须处于同一网段,或者彼此之间可路由。访客 Wi-Fi 或其他 VLAN 会阻断连接。 |
| 防火墙 | 允许电脑访问设备的端口:ZKTeco 为 4370 TCP/UDP,Anviz 为 5010 TCP,Hikvision 为网页端口(80)。 |
| 一次只有一个连接 | 有些终端只允许一台电脑连接。请关闭连接到同一设备的其他考勤软件。 |
| 从电脑上 Ping | 在命令提示符中运行:ping <device address>。如果失败,说明是网络问题,而不是 SolaHR。 |
#连接器
| 现象 | 解决方法 |
|---|---|
| 连接器离线 | 将电脑开机;使用 sc query SolaHRDeviceConnect 检查服务(必须显示 RUNNING);检查其网络连接。恢复后,等待中的打卡会被发送。 |
| “连接器未接收到该请求” | 同样:电脑已关机、处于睡眠状态或已离线。请关闭该电脑的睡眠功能。 |
| “连接器需要重新配对”/“连接器已被撤销” | 重新生成配对码并再次配对(安装)。 |
| “代码已过期,请重新生成” | 配对码有效期为 15 分钟,且只能使用一次。 |
| Windows 对安装程序发出警告 | 属于正常现象:预览版未进行代码签名。请核对 SHA-256 值,然后点击更多信息 → 仍要运行。 |
127.0.0.1:8790 无法打开 |
可能有其他程序占用了该端口。即使没有该页面,服务仍可正常工作。 |
#身份验证与密钥
| 现象 | 解决方法 |
|---|---|
| 可连接 · 通信密钥被拒绝 | 请输入设备上的通信密钥(菜单 → 通讯 → 连接电脑)。没有密钥即为 0。密钥为 1 至 6 位数字。在 ZKTeco 固件 Ver 6.60 上,即使密钥为 0,设备也要求登录;连接器 0.1.5 及更高版本可处理这种情况,因此如果仍然看到该问题,请更新连接器。 |
| 可连接 · 设备忙碌 | 等待一分钟后再次测试。 |
| Hikvision:登录被拒绝 | 请使用专为 SolaHR 创建的独立设备用户(不要使用 admin),并检查设备是否已激活。 |
| Suprema:登录被拒绝 | 请使用只读的 BioStar 2 操作员和准确的服务器地址(包括 https://)。 |
| “序列号不匹配” | 该地址上的设备不是已登记的那一台。请检查 IP。 |
#需要设置
需要设置是一种状态,并非终端故障。该连接类型需要连接器电脑上有厂商软件,而该软件尚未就绪。请按照厂商 SDK 设置操作,或点击改用内置连接。对于大多数 ZKTeco 终端,ZKTeco(直连)无需额外软件。
#打卡已到达但没有生成考勤
| 原因 | 解决方法 |
|---|---|
| 编号未映射 | 设备用户 → 关联该编号。关联后,等待中的打卡会立即写入。参见映射与考勤。 |
| 缺少该日期的工资设置 | 添加设置,然后重新处理待定项。 |
| 早于导入历史起始日期或早于员工入职日期 | 编辑设备的日期,或更正入职日期。 |
| 当天已由人事或门户录入 | 设备打卡不会覆盖它。参见被拒绝的打卡,位于审核标签页。 |
| 员工处于无薪停职状态 | 不会生成考勤。 |
| 只有下班打卡而没有上班打卡 | 在考勤中补录缺失的打卡记录。 |
#时间错误
| 现象 | 解决方法 |
|---|---|
| 相差整数小时 | 编辑设备,设置正确的设备时钟时区(例如 Asia/Amman、Asia/Dubai)。 |
| 相差几分钟 | 立即同步时间(所有者)。同时检查设备自身的时钟和夏令时设置。 |
| 夜班被拆分 | 在工作班表中检查该班表的跨夜设置。 |
#姓名与文本
| 现象 | 解决方法 |
|---|---|
阿拉伯语姓名显示为 ??? 或奇怪的符号 |
在设备记录中设置文本编码:首选UTF-8,然后是Windows-1256(阿拉伯语),再是 GBK。然后重新读取用户。 |
| 姓名被截断 | 许多终端只允许较短的姓名(通常不超过 24 个字符)。 |
#更改无效
| 现象 | 解决方法 |
|---|---|
| “此设备的更改已在连接器电脑上关闭” | 在连接器页面上开启允许更改设备。 |
| 编辑、启用、删除或推送显示为灰色/“此处不支持” | 该连接类型或型号不支持此操作。ZKTeco 直连无法启用/停用用户或复制人脸;ZKTeco SDK 类型可以(已通过软件测试)。 |
| 缺少复制、重启或同步时间 | 仅限所有者。 |
| “设备没有足够的剩余空间” | 终端的用户、人脸或指纹已满。请删除不用的用户。 |
| “设备拒绝了该更改” | 请检查通信密钥,并确认设备允许远程更改。 |
#推送设备
| 现象 | 解决方法 |
|---|---|
| “最后联系”时间很久以前或为空 | 检查终端的服务器设置(ZKTeco:菜单 → 通讯 → 云服务器设置):地址、端口,以及终端是否能访问网络。 |
| 打卡被拒绝 | 设备序列号必须与 SolaHR 中登记的一致。参见隔离区。 |
| 普通 HTTP 被拒绝 | 许多推送设备只支持 HTTP。请让管理员查看安装就绪检查面板;它会检查网络服务器规则。 |
#常见问题
SolaHR 会存储指纹或人脸吗?不会,绝对不会。它只知道某人在设备上是否有人脸或指纹。参见存储的内容。
我需要在路由器上开放端口吗?不需要。连接器只会向 SolaHR 发起出站连接。只有推送设备需要能从设备访问 SolaHR,而这本来就可以。
没有互联网能用吗?连接器在办公室内部仍可继续工作,但无法连接 SolaHR;打卡会等待并在稍后发送。
可以使用多个连接器吗?可以,通常每个站点一个。每台设备分配给一个连接器。
我的终端受支持吗?参见支持的设备。到目前为止,只有 ZKTeco iFace702 被真实连接过;其他型号为预计可用或未测试。请先测试一台。
可以同时使用连接器和文件导入吗?可以。重复的打卡会被识别,不会重复计算。
多久读取一次打卡?由您选择:每 1、2、5、10、15 或 30 分钟。参见映射与考勤。
运行连接器安全吗?它只在电脑本机上监听,并对机密信息加密保存,但它是未签名的预览版,其 Windows 服务也未在所有 Windows 环境中测试过。请像对待服务器一样对待这台电脑。
在哪里获得帮助?在连接器电脑上使用 solahr-dc diagnostics 生成不含机密信息的支持包,并连同设备名称和您看到的状态一起发送。