SkeyeVSS开发常见问题FAQ 设备国标注册失败排查
Skeyevss FAQ：设备国标注册失败排查
试用安装包下载 | SMS | 在线演示
开源项目地址：https://github.com/openskeye/go-vss
1. 问题现象
管理后台或设备列表中，设备长期显示离线、REGISTER无成功记录，或 SIP 日志中出现循环401/403/408。
2. 配置一致性检查
设备 Web/国标配置必须与平台.env/.env.prod中 SIP 参数逐字段一致：
| 设备侧常见项 | 平台侧对应项（示例名） |
|---|---|
| SIP 服务器 ID | SKEYEVSS_VSS_SIP_ID |
| SIP 域 | SKEYEVSS_VSS_SIP_DOMAIN |
| 端口 | SKEYEVSS_VSS_PORT |
| 注册密码 | SKEYEVSS_VSS_SIP_PASSWORD |
任意一项拼写错误、多空格、域大小写不一致，都会导致 digest 校验失败或路由不到本实例。
3. 网络路径检查
- 监听地址：确认 VSS SIP 端口在目标网卡上监听（内网/公网场景与
SKEYEVSS_INTERNAL_IP、SKEYEVSS_EXTERNAL_IP一致）； - NAT 与端口映射：设备在公网时，映射的外网端口必须与设备填写的端口一致；
- 防火墙 / 安全组：UDP/TCP（取决于设备注册方式）需放行 SIP 端口。
可用tcpdump/ngrep在服务器侧抓包，确认是否有来自设备 IP 的 SIP 报文到达本机。
4. 按响应码分流
- 401 Unauthorized：多为 digest 用户名/密码/ realm 不匹配；核对设备认证 ID 与平台为设备分配的国标 ID 是否一致。
- 403 Forbidden：可能被平台策略或白名单拒绝；检查是否多实例注册冲突、设备 ID 已被占用。
- 408 Request Timeout：网络丢包、设备未收到响应、或 NAT 映射失效；结合抓包看是否有来无回。
- 无响应：设备 SIP 服务器地址填错、端口错、或路由不可达。
5. 与 SIP 日志的配合
打开实时 SIP 日志，过滤该设备的Via或Contact中的 IP，观察：
- 是否周期性
REGISTER； CSeq是否递增异常（重传风暴）；- 平台返回的
WWW-Authenticate与设备第二次REGISTER是否成对出现。
6. 仍失败时建议携带的信息
联系支持或内部分析时，请准备：设备型号与固件版本、设备国标配置截图、问题时间段、对应 SIP 原始报文片段（脱敏后）、服务器.env中与 SIP 相关的非密钥项（可打码密码）。
按「配置 → 网络 → 响应码 → 日志时间线」顺序排查，可覆盖绝大多数注册失败根因。