第 13 章 国标级联
13.1 功能说明
国标级联让本平台作为下级平台，向上级平台（如上级公安网、集团总平台）注册并共享通道资源。上级可通过级联目录直接点播本平台接入的摄像机。
菜单路径：「国标级联」（路由 /gb28181/cascade）。 所需权限：查看 gb28181:cascade:view；维护上级平台 gb28181:cascade:manage；启停 gb28181:cascade:enable；共享资源 gb28181:cascade:share。
13.2 页面结构
| 区域 | 内容 |
|---|---|
| 摘要卡 | 「平台总数」「已启用」「在线」「需关注」四张 |
| 搜索区 | 关键词、状态、「刷新 Ns」、「新增上级」 |
| 平台表格 | 上级平台清单 |
无查看权限时显示「无权查看国标级联，请联系管理员分配查看权限。」
界面如图 13-1 所示。
图 13-1 国标级联页
13.3 检索
| 条件 | 说明 |
|---|---|
| 关键词 | 平台名称／编码／地址 |
| 状态 | 「全部状态」「在线」「离线」「已停用」，默认「全部状态」 |
| 自动刷新 | 默认 10 秒一轮，按钮上显示剩余秒数（如「刷新 9s」）；点它立即刷新并重新计时 |
13.4 表格列
「上级平台」一列集中显示名称、平台 ID、上级地址和传输协议；其后为本平台身份、共享通道、运行状态等。表格较宽，窄屏下可横向滚动，「操作」列固定在右侧。
| 列 | 说明 |
|---|---|
| 「上级平台」 | 平台名称 + 上级平台 ID + host:port 与传输协议；若凭据不可读，附标记「需重新填写认证密码」 |
| 「本平台身份」 | 本平台设备 ID + 本地 SIP 地址与端口 |
| 「共享通道」 | 「N 个通道」／「未共享」／「查看共享与目录」 |
| 「运行状态」 | 见 13.5 |
| 「上级订阅」 | 「已订阅（N）」等，见 13.7 |
| 「启用」 | 开关 |
| 「注册 / 心跳周期（秒）」 | 如「3600 / 60」 |
| 「协议」 | 「GB/T 2016／2022」+「自动协商」或「固定 20xx」 |
| 「最近注册」「最近心跳」 | 时间 |
| 「创建时间」「修改时间」 | — |
| 「操作」 | 见 13.6 |
界面如图 13-2 所示。
图 13-2 上级平台列表
13.5 运行状态
| 状态 | 颜色 | 含义 |
|---|---|---|
| 「已停用」 | 灰 | 平台未启用，不向上级注册 |
| 「等待注册」 | 蓝 | 已发出注册，尚未收到上级确认 |
| 「等待心跳」 | 蓝 | 已注册成功，等待首个心跳 |
| 「在线」 | 绿 | 注册与心跳均正常 |
| 「心跳超时」 | 橙 | 心跳中断，链路可能异常 |
| 「注册已过期」 | 红 | 注册有效期耗尽，已掉线 |
鼠标停在状态标签上会浮出一句说明（如「注册和心跳正常」「最近心跳超过容忍窗口」）。
注意：本版本没有「运行状态详情」弹窗，页面上不保留注册／心跳的历史记录与失败原因，状态标签是唯一入口。排障请按 13.10 逐项核对，必要时查服务端日志。
13.6 操作
| 按钮 | 位置 | 前置条件 | 行为 | 二次确认 | 提示 |
|---|---|---|---|---|---|
| 「新增上级」 | 搜索区右侧 | cascade:manage | 打开 5 步向导 | 无 | — |
| 「共享与目录」 | 行操作 | cascade:share | 跳转资源页 | 无 | — |
| 「编辑」 | 行操作 | cascade:manage | 打开向导并回填 | 无 | — |
| 「推送」 | 行操作 | cascade:share 且已启用 | 主动报送当前共享目录 | 无 | 「目录已推送：N 个通道，分 M 批发送」；失败「目录推送失败，请确认上级链路后重试」 |
| 「删除」 | 行操作 | cascade:manage | 删除上级平台 | 标题「删除上级平台」，正文「确定删除”{名称}“吗？存在活动媒体会话时服务端会拒绝删除。」 | 「上级平台已删除」；未完成「上级平台删除尚未完成，请刷新后重试」 |
| 「启用」开关 | 启用列 | cascade:enable | 启用=向上级注册；关闭=注销 | 无 | 「上级平台已启用，正在向上级注册」／「上级平台已停用，已向上级注销」 |
注意 - 启用级联会立即向上级发起 REGISTER。若上级未预先配置本平台 ID、域与密码，会注册失败并停留在「等待注册」。 - 删除上级平台时有活动媒体会话会被服务端拒绝，需先停止相关点播。 - 「推送」只影响上级看到的目录内容，不改变本平台共享配置。
13.7 上级订阅
「上级订阅」列展示上级平台向本平台订购了哪些通知。
| 状态 | 颜色 | 含义 |
|---|---|---|
| 「已订阅（N）」 | 绿 | 上级已订阅，N 条会话 |
| 「未订阅」 | 灰 | 上级未订阅 |
| 「尚未接通」 | 灰 | 链路未建立 |
| 「运行时不可用」 | 橙 | 运行时异常 |
| 「状态未知」 | 橙 | 无法获取 |
展开「订阅明细（N）」，固定四类：「目录」「位置」「PTZ 精准」「告警」。
明细字段：「类型 / 目标」「事件」「建立时间」「最近续订」「到期时间」「最近通知」（「成功（code）」／「失败（code）」／「等待通知」）。
说明：「仅显示当前有效会话；已订阅不代表每条通知均送达。」
「上级订阅」列排在「运行状态」与「启用」之间，需要横向滚动才看得到；四种订阅类型固定按「目录」「位置」「PTZ 精准」「告警」两行两列排布。上级尚未发起订阅时四类都显示灰色，如图 13-3 所示。
图 13-3 国标级联完整列表中的上级订阅状态
13.8 新增／编辑上级平台
向导共 5 步：「上级平台」→「本平台身份」→「注册与协议」→「目录与发布」→「完成确认」。
13.8.1 第 1 步：上级平台
| 字段 | 必填 | 校验 | 说明 |
|---|---|---|---|
| 「平台名称」 | 是 | ≤ 128 字符 | 本平台内显示名 |
| 「上级平台 ID」 | 是 | 20 位数字 | 上级的国标 ID |
| 「上级域」 | 是 | 10 位数字 | 随上级平台 ID 自动取前 10 位，可改 |
| 「上级地址」 | 是 | IPv4 或 IPv6 | 占位「请输入 IPv4 或 IPv6 地址」 |
| 「上级端口」 | 是 | 1–65535 | 默认 5060 |
| 「传输协议」 | 是 | 「UDP」／「TCP」 | 默认 UDP |
| 「认证用户名」 | 否 | 20 位数字或留空 | 默认取本平台设备 ID |
| 「认证密码」 | 条件 | — | 占位「留空则保持原密码」；凭据不可读时提示「原认证密码无法读取，请重新填写上级平台提供的密码后保存。」 |
13.8.2 第 2 步：本平台身份
| 字段 | 必填 | 校验 | 默认 |
|---|---|---|---|
| 「本平台设备 ID」 | 是 | 20 位数字 | 取「SIP 平台 ID」 |
| 「本平台域」 | 是 | 10 位数字 | 取「SIP 域」 |
| 「本地 SIP 地址」 | 是 | 网卡选择或手输 | 推荐网卡带「推荐」标签，虚拟网卡带「虚拟网卡」标签 |
| 「本地 SIP 端口」 | 是 | 1–65535 | 取 SIP 端口 |
| 「媒体宣告地址」 | 否 | — | 跨 NAT 场景填写上级可访问的地址 |
13.8.3 第 3 步：注册与协议
| 字段 | 选项 | 默认 |
|---|---|---|
| 「协议版本」 | 「自动协商」「固定 2016」「固定 2022」 | 自动协商 |
| 「字符集」 | 「跟随协议版本（默认）」「GB2312」「GB18030」「UTF-8（兼容扩展）」 | 跟随协议版本 |
| 「注册有效期（秒）」 | 3600–86400 | 3600 |
| 「心跳间隔（秒）」 | 5–3600 | 60 |
13.8.4 第 4 步：目录与发布
| 字段 | 说明 |
|---|---|
| 「每批目录条数」 | 「1／2／4／8／16／32／64 条」，默认 1；编辑老配置显示「N 条（原配置）」 |
| 「最大并发流」 | 0–10000，默认 0；帮助「0 表示不限制并发流。」 |
| 「发布平台目录」 | 开关 |
| 「发布行政区划」 | 开关 |
| 「共享方式」 | 只读标签，显示「按照目录共享」或「按照通道共享」；需在「共享与目录」页切换 |
| 「允许云台控制」 | 开关，上级是否可控制本平台设备 |
| 「自动推送目录」 | 开关 |
| 「允许录像查询与回放」 | 开关 |
| 「RTCP 保活」 | 开关 |
| 「启用级联」 | 开关，默认关闭 |
提示：「共享方式请在”共享与目录”页面切换并保存；目录共享需先建立业务根和虚拟组织，未归类通道仍保留共享。」
13.8.5 第 5 步：确认
四张核对卡：「上级平台」「本平台身份」「注册与协议」「目录与发布」，每卡右上「修改」可直接回到对应步骤。
末尾提示： - 启用级联时「保存后启用级联，并向上级发起注册。」 - 不启用时「保存后级联保持停用，不会向上级注册。」 - 「保存后可到平台列表的”共享与目录”配置通道。」
点击「确认保存」。
13.8.6 保存结果提示
| 情况 | 提示 |
|---|---|
| 新建并启用 | 「上级平台已创建并启用，正在向上级注册」 |
| 新建不启用 | 「上级平台已创建，当前未启用」 |
| 编辑并启用 | 「上级平台已保存并启用，正在向上级注册；通道请到”共享与目录”配置」 |
| 编辑不启用 | 「上级平台已保存，当前未启用；通道请到”共享与目录”配置」 |
| 运行时未同步 | 「配置已保存，但运行时尚未同步；请稍后重试」 |
注意 - 平台没有「主动注册／被动注册」选项。注册方向固定为「本平台主动向上级注册」，由「启用级联」开关控制。 - 「认证密码」在保存后不可回读。若上级更换密码，必须在本页重新填写，否则注册会持续失败。 - 「媒体宣告地址」在跨 NAT 场景必须填写为上级可达地址，否则上级点播时收不到流。
界面如图 13-4 所示。
图 13-4 新增上级平台弹窗
13.9 共享与目录
点击「共享与目录」进入资源页（路由 /gb28181/cascade/:id/resources）。
13.9.1 两种共享方式
| 方式 | 说明 | 前置条件 |
|---|---|---|
| 「按通道共享」 | 直接勾选通道，上级看到的是扁平通道列表 | 无 |
| 「按目录共享」 | 通道挂在业务分组树下，上级看到的是组织目录 | 必须先建业务根（类型码 215）与虚拟组织（216） |
切到「按目录共享」后，左侧出现业务分组树，右侧是该节点（或「全部共享」）下的通道表；树节点名后面的数字是含下级的通道数。界面如图 13-5 所示。
图 13-5 共享与目录—业务分组树
13.9.2 工具栏
| 按钮 | 行为 | 提示 |
|---|---|---|
| 「返回」 | 返回平台列表；有未保存改动时先确认 | — |
| 「推送目录」 | 先保存再推送 | 成功「目录推送请求已完成：N 项，M 批。此结果不代表上级已展示。」；未启用「上级平台已停用，启用后才能推送目录。」 |
| 「保存修改」 | 保存节点、绑定与共享关系 | 「共享与目录配置已保存；可按需推送平台目录。」 |
13.9.3 目录模式操作
新建业务分组：
- 左侧树为空时点击「新建业务分组」；已有节点时点击节点行内的新建下级按钮或右键菜单。
- 填写：
| 字段 | 校验 |
|---|---|
| 「分组名称」 | ≤ 128 字符，占位「例如：东区前端点位」 |
| 「国标 ID」 | 20 位数字；第 11–13 位：业务根必须为 215，虚拟组织必须为 216；编辑态只读，提示「已用于对外发布，不可修改」 |
| 「上级组织」 | 仅虚拟组织需要，树选择 |
- 点击「创建」或「保存」。
校验提示： 「分组名称不能为空。」「分组名称最多 128 个字符。」「国标 ID 必须是 20 位数字。」「国标 ID 第 11–13 位必须是 215（业务根类型码）。」／「…216（虚拟组织类型码）。」「该编号已被其它节点占用。」「该编号与本平台、上级平台或已共享通道编号冲突。」「请选择上级组织。」
移动通道到组织：
- 在右侧通道表勾选通道。
- 点击「移动到组织」。
- 选择「目标组织」。
- 点击「确认移动」。
说明：「将选中的 N 路通道移入目标组织，替换原有归属并保持共享。」
添加共享通道：
- 点击「添加共享」／「添加通道」。
- 在「选择共享通道」弹窗中筛选：「本地通道」／「已共享通道」、在线状态、关键词。
- 勾选通道（列显示「通道」「所属设备」「在线」「当前归属」，当前归属为「全部／部分／未授权」+「原组织：…」）。
- 点击「加入共享」／「加入组织」／「确认移动并加入」。
弹窗里上方是筛选（通道范围、在线状态、关键词）与「查询」，中间是通道表（通道名 + 源国标编号、所属设备、在线、当前归属），底部固定「已选择 N 路 / 新增共享 N 路」，主按钮文案随场景变化：「加入共享」（按通道共享）、「加入组织」（按目录共享、不涉及移动）、「检查并继续（移动 N 路）」→ 再点一次「确认移动并加入」（选中的通道原本属于别的组织）。界面如图 13-6 所示。
图 13-6 国标级联中的选择共享通道完整弹窗
删除组织：
- 点击节点行内删除按钮。
- 确认「确认删除空组织”{路径}“？」。
- 不可删除原因：「请先切换为通道共享并保存。」／「请先移动下级组织或直属通道。」
13.9.4 通道表列
| 列 | 说明 |
|---|---|
| 勾选 | 批量操作 |
| 「通道」 | 名称 + 状态标签「待共享」「待取消共享」「共享已失效」「已共享」 |
| 「源编号 / 发布编号」 | 本平台编码 / 上级看到的编码 |
| 「业务归属」 | 所属组织路径 |
| 「在线状态」 | 「在线」「离线」「未知」 |
| 「操作」 | 「移出组织」、「移除」／「取消共享」 |
13.9.5 提示与限制
| 场景 | 文案 |
|---|---|
| 只读账号 | 「当前账号只有查看权限，共享与目录为只读。」 |
| 无切换权限 | 「当前账号没有切换共享方式的管理权限。」 |
| 目录模式未选组织 | 「按照目录共享时，请先选择虚拟组织作为通道归属。」 |
| 目录模式未建根 | 「按照目录共享前，请先新建业务根和虚拟组织。」 |
| 通道加载失败 | 「通道加载失败：…」 |
注意 - 切换共享方式会重建上级看到的目录结构，切换前需确认不影响上级已配置的订阅与收藏。 - 业务根与虚拟组织的国标 ID 一旦发布不可修改，规划时请按编码规则预留。 - 「已共享」不代表上级已展示，需要执行「推送目录」后由上级刷新目录才可见。
13.10 常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 「等待注册」一直不变 | 上级未配置本平台、密码错误、端口不通 | 核对上级平台 ID／域／密码；用 SIP 日志确认是否有 401／403 |
| 「心跳超时」 | 网络抖动、上级重启 | 观察是否自愈；持续超时检查链路 |
| 上级看不到通道 | 未共享、未推送、未发布平台目录 | 检查共享配置并「推送目录」 |
| 上级点播黑屏 | 「媒体宣告地址」不可达 | 改为上级可达的公网地址 |
| 「共享已失效」 | 通道被删除或不再有权限 | 重新添加共享 |
| 删除上级被拒 | 存在活动媒体会话 | 停止相关点播后重试 |