第 14 章 SIP 接入信息与国标服务配置

本章包含两个页面，容易混淆，先做区分：

页面	管什么	典型操作
「SIP 接入信息」	对外身份与网络地址：平台 ID、域、密码、端口、IP、扫码接入	首次部署配置、设备接入取参、改密码
「国标服务配置」	业务运行参数：轨迹、云台速度、播放策略、录像保留	日常调优

SIP 端口、注册有效期、心跳间隔、SIP 密码不在「国标服务配置」页，而是在「SIP 接入信息 → 编辑配置」中。

14.1 SIP 接入信息

菜单路径：「SIP 接入信息」（路由 /gb28181/sip/platform）。 所需权限：查看与出码 gb28181:sip:config:view；编辑 gb28181:sip:config:update。

14.1.1 页面结构

区域	内容
顶部工具栏	「GB28181 SIP 服务」+ 运行状态标签、「复制 SIP 接入信息」、「编辑配置」
左栏	「部署方式」卡、「设备接入信息」卡、「设备接入指南」卡
右栏	「服务状态」卡、「扫码接入」卡

界面如图 14-1 所示。

图 14-1 SIP 接入信息完整页面

界面如图 14-2 所示。

图 14-2 SIP 接入信息中的设备接入参数

界面如图 14-3 所示。

图 14-3 SIP 接入信息中的扫码接入区域

14.1.2 展示字段

「设备接入信息」卡（卡头提示「设备端 SIP 配置填以下参数」）：

字段	说明
「SIP 服务器地址」	可能有多条：公网部署时为公网接入 IP；局域网监听 0.0.0.0 时列出全部具体网卡地址
「SIP 端口」	设备注册端口
「平台 ID」	即 SIP 服务器 ID（GBID），20 位
「SIP 域」	10 位
「SIP 密码」	明文展示（便于现场录入），为空显示 -

「服务状态」卡：

字段	说明
「运行状态」	见 14.1.3
「传输协议」	未取到时显示「UDP / TCP」
「监听地址」	listenIp:port
「最近更新」	状态采集时间

「部署方式」卡：显示「局域网部署」（标签「同局域网」）或「公网部署」（标签「跨公网 NAT」）。

「设备接入指南」卡提供三步说明：

1. 「填写服务器信息」——「在设备 “SIP 服务器 / 平台设置” 里填入平台的服务器地址和端口。」
2. 「填写平台身份」——「把平台的 GBID (SIP 服务器 ID) 和 SIP 域填到对应字段。」
3. 「填写接入密码」——「在 “注册密码 / 认证密码” 字段填入本平台设置的 SIP 密码,然后启用注册。」

14.1.3 运行状态

状态	颜色	含义
「未配置」	灰	尚未保存过 SIP 配置
「未启用」	灰	已配置但服务未开启
「启动中」	橙	正在启动
「待重启」	橙	配置已改，需重启 SIP 服务生效
「运行中」	绿	正常，设备可注册
「启动失败」	红	端口占用或监听地址不可达，页面显示原因

未配置时页面显示空态「尚未配置 SIP 服务」与「开始配置」按钮。 启动失败时显示「SIP 服务启动失败,请点击编辑配置修正参数」及后端原因。

14.1.4 常用操作

按钮	位置	作用	提示
「复制 SIP 接入信息」	顶部工具栏	一次性复制地址、端口、平台 ID、域、密码五行	「已复制 SIP 接入信息」／「复制失败,请手动选中」
字段复制图标	每个字段右侧	复制单个字段	「已复制到剪贴板」／「复制失败,请手动选中」
「编辑配置」	顶部工具栏	打开配置向导（编辑态）	无权限时置灰
「开始配置」	空态区	打开配置向导	—

注意 - 「SIP 密码」以明文显示，目的是便于现场在设备端录入。请在受控环境操作，避免录屏与被旁观；离开工位请锁屏。 - 「复制 SIP 接入信息」会把密码一并复制到剪贴板。粘贴到聊天工具、工单后请及时清理剪贴板。

14.1.5 平台接入配置向导

共 4 步：「部署方式」→「网络地址」→「SIP 身份」→「确认」。 标题：首次配置为「平台接入配置」，编辑时为「编辑平台接入配置」。

第 1 步：部署方式

选项	说明
「局域网部署」	「设备与平台位于同一网络」
「公网部署」	「设备通过公网地址注册」

未选择时「下一步」置灰。

第 2 步：网络地址

字段	说明
网卡选择	局域网为「SIP 接入网卡」，公网为「本机内网网卡」；选项含 0.0.0.0（「所有本机网卡」，带「多网卡」标签）与具体网卡（虚拟网卡带「虚拟网卡」标签）
「公网接入 IP」	仅公网部署显示，必填，示例 203.0.113.10
「平台回调地址」	设备上报回调（hook）的地址
「设备推流地址」	设备送流的目标地址
「播放地址」	播放器访问的地址

真实网卡时三项地址可留空（自动使用网卡地址）；选择 0.0.0.0 或虚拟网卡时必须手填。

第 3 步：SIP 身份

字段	必填	校验	默认
「SIP 端口」	是	1–65535	部署层下发端口，其次构建期默认，兜底 5061
「SIP 平台 ID」	是	20 位数字	—
「SIP 域」	是	10 位数字	自动取平台 ID 前 10 位，可改
「SIP 密码」	是	至少 8 位；大写／小写／数字／特殊字符至少 3 类；非常见弱口令；非连续顺序字符	编辑态可留空保留原密码

密码提示：「至少 8 位,含大小写 / 数字 / 特殊字符 3 类」；弱口令说明：「国标 SIP 注册接口暴露在公网易被暴力破解,本平台强制用户设置强密码。」

第 4 步：确认

核对三项：「部署方式」「设备接入信息」「媒体网络默认地址」（含「自动使用 xxx」说明）。

底部按钮：「稍后再配」（首次配置）／「取消」（编辑）、「上一步」、「下一步」、「保存并启动」（首次）／「保存并应用」（编辑）。

14.1.6 保存与中断确认

编辑态点击「保存并应用」时弹出确认框：

• 标题：「应用 SIP 配置会短暂中断信令」
• 正文：「确认后，系统会在后端进程内关闭并重新启动 SIP 服务。切换期间 SIP 信令会短暂中断，设备注册状态可能短暂变化并需要重新注册；正在进行的点播、回放、对讲等 SIP 操作可能失败。UVP 后端整体与 ZLMediaKit 不会重启。」
• 按钮：「确认保存并应用」、「取消」

结果提示：

情况	提示
成功	「SIP 配置已保存并成功启动」
媒体默认值更新失败	「SIP 服务已启动，但媒体节点默认值更新失败：…」
热启动失败	弹窗内横幅「SIP 服务启动失败」+ 后端原因 + 「配置已保存,请修改后再试.常见原因:端口被占用、监听 IP 不可达。」

注意 - 修改 SIP 配置会导致全部设备重新注册，期间无法点播、回放、对讲。务必安排在业务低峰期（建议夜间）。 - 修改端口前，须先确认防火墙已放行新端口，否则改完后设备集体掉线且无法自行恢复。 - 修改「SIP 平台 ID」等同于更换平台身份，已注册设备需要重新配置。非必要不要修改。

14.1.7 扫码接入

用于手机端「国标模拟器」App 快速接入，也适用于支持扫码的国标设备。

1. 使用设备可达的平台入口访问本页；扫码接入地址由当前访问路径自动推导，无需单独填写「扫码配网地址」。
2. 在「扫码接入」卡点击「生成二维码」。
3. 二维码页内即时生成，下方显示失效倒计时「xx:xx 后失效」。
4. 用手机 App 扫码，自动回填接入信息。
5. 到期后可点击「重新生成」；系统也会自动续码（失败按 5 秒／10 秒／20 秒退避，最多 3 次）。
6. 需要分享链接时点击「复制」，提示「已复制二维码链接」。

按钮	作用
「生成二维码」／「重新生成」	请求一次性 token 并出码
「复制」	复制二维码指向的链接
「移动端国标模拟器下载」	新窗口打开下载页（仅 Android）

异常文案：

文案	原因
「平台未下发设备可达的接入地址」	当前访问路径未能推导出设备可达地址
「接入地址必须以 http:// 或 https:// 开头」	地址格式错误
「二维码已失效」	token 过期
「二维码已失效,自动续码未成功」	续码失败，需手动重新生成
「当前账号无生成接入二维码的权限,如需扫码请联系管理员。」	无权限

注意 - 二维码中包含平台接入凭据，页面已明确提示「二维码含平台接入凭据,请勿截图外传;建议在可信网络内使用。」 - 「点击重新生成后,旧二维码在原到期时间前仍然有效。」因此提前重新生成不会使旧码立即失效，需要作废旧码请等待其自然过期。

14.2 国标服务配置

菜单路径：「国标服务配置」（路由 /gb28181/sip/config）。 所需权限：菜单级 gb28181:sip:config:view；保存需 gb28181:sip:config:update。

14.2.1 页面结构

三个页签：「国标相关」「播放相关」「国标级联」。页签右侧显示「未保存」提示、「重置」、「保存配置」。

三个页签共用一个保存动作：任一处修改后，点一次「保存配置」即提交全部页签的内容。

14.2.2 「国标相关」页签

字段	类型/范围	默认	说明
「保存移动位置历史轨迹」	开关	按后端	关闭后仍更新当前位置，但不再新增轨迹点
「位置历史保留天数（天）」	1–365	7	仅上一项开启时可编辑
「扩展 SDP 兼容模式」	开关	关	兼容部分厂商的非标准 SDP
「设备校时」	开关	关	开启后在注册、心跳成功应答中携带 Date 头，设备据此校准时钟；可能影响现场录像与报警时间
「云台默认速度」	1–10	6	滑杆，两端标注「慢」「快」，显示「N 档」
「新通道默认流传输模式」	「UDP」「TCP 主动」「TCP 被动」	TCP 被动	新接入通道的初始值
「全局通道开启音频」	开关	开	影响新建通道
「设备上线时同步通道」	开关	开	设备注册后自动拉取目录
「是否开启 SIP 日志」	开关	关	开启后采集原始信令（用于排障）
「云端录像默认保留天数（天）」	1–365	7	超范围提示「请输入 1-365 之间的整数」
「录像缓存尾部容差（秒）」	0–30	2	补偿设备录像段尾部的时长误差
「忽略通道离线/异常通知」	开关	关	屏蔽设备上报的通道离线通知
「心跳恢复设备在线状态」	开关	开	收到心跳即将设备置为在线
「是否存储报警消息」	开关	关	开启后才将设备报警通知写入报警管理；关闭时仍接收和解析报警通知
「SIP 命令超时时间（秒）」	1–300	10	信令等待应答的上限
「预分配模式」	开关	关	开启后未知国标 ID 将被拒绝注册
「全局订阅项目」	复选：「目录」「报警」「位置」「PTZ 精准位置变化（2022）」	全不选	新设备默认订阅项

设备接入地址由平台根据访问路径自动推导，不再提供手填配置：

地址用途	说明
扫码接入	由当前访问入口推导二维码接入地址；设备必须能够访问该入口
抓拍回传	由访问路径自动推导设备上传抓拍图片的目标地址；排障时核对网络可达性及反向代理部署

14.2.3 「播放相关」页签

字段	类型/范围	默认	说明
「默认播放协议」	字典驱动	ws-flv	打开控制台时默认使用
「固定播放地址」	开关	开	为流分配固定地址，便于外部系统复用
「自动点播」	开关	关	仅「固定播放地址」开启时可用
「播放鉴权」	开关	关	开启后播放地址带时效凭证；OpenAPI 强制鉴权时禁用并提示
「绑定客户端 IP」	开关	关	仅鉴权开启时可用；凭证与来源 IP 绑定
「凭证有效期（秒）」	60–3600	120	超范围提示「请输入 60-3600 之间的整数」
「点播超时时间（毫秒）」	1000–300000	—	等待首帧的上限
「按需直播」	开关	开	全局默认值
「云端录像」	开关	关	全局默认值

14.2.4 「国标级联」页签

配置本平台对外呈现的身份信息（全局共用，被所有上级平台看到）。

字段	必填	校验	默认
「User-Agent」	是	≤ 128 字符，禁控制字符	UVP-GB28181
「平台名称」	是	同上	UVP GB28181
「厂商」	是	同上	UVP
「型号」	是	同上	UVP-GB28181
「行政区划」	否	2／4／6／8 位数字	空
「安装地址」	否	≤ 256 字符	空

14.2.5 保存

按钮	条件	行为	提示
「重置」	存在未保存改动	丢弃改动，恢复已保存值	无改动时置灰
「保存配置」	校验通过	一次性提交三个页签	成功「国标服务配置已更新」；失败「保存国标服务配置失败」或后端原因

注意 - 本页保存不会重启 SIP 服务。仅「是否开启 SIP 日志」会触发热重载 SIP 服务。 - 需要重启 SIP 服务的场景只有一处：在「SIP 接入信息 → 编辑配置」中保存身份或端口。 - 数字项非法时「保存配置」会置灰，需先修正。 - 关闭「是否存储报警消息」后，设备仍在报警，但平台不再入库，告警管理页将看不到新告警。关闭前请确认无需追查。

界面如图 14-6 所示。

图 14-6 国标服务配置完整页面

14.3 常见问题

现象	原因	处理
设备注册返回 401	SIP 密码不一致	在「SIP 接入信息」核对密码后改设备端
设备注册返回 403	预分配模式开启且设备 ID 未预置	关闭预分配模式，或先在设备列表中创建该设备
平台「运行中」但设备全部离线	端口被防火墙拦截	检查防火墙与 NAT 映射
修改配置后设备全掉线	端口或 IP 变更	恢复原配置，或让设备重新配置
扫码不出码	当前访问路径未能推导出设备可达地址	核对当前平台入口、反向代理及设备可达性；地址由访问路径自动推导
抓拍后图像库无图	设备无法访问自动推导的回传地址或上传失败	检查平台入口、反向代理及设备到平台的网络，不再手填「抓拍回传地址」

---