5gc-web-dotouch

# 5GC Web 仪表自动化技能 > 统一管理 AMF、UDM/AUSF、SMF/PGW-C、UPF/PGW-U、GNB、UE、PCF、NRF 八类网元的添加与编辑操作，以及 PCC 规则、QoS 模板、Traffic Control、SMPolicy 和 PCF 默认规则一键配置。 --- ## 目录 - [快速开始](#快速开始) - [统一 CLI 入口](#统一-cli-入口) - [技能详细文档](#技能详细文档) - [AMF](#amf) - [UDM/AUSF](#udmausf) - [SMF/PGW-C](#smfpgw-c) - [UPF/PGW-U](#upfpgw-u) - [GNB](#gnb) - [UE](#ue) - [PCF/PCRF](#pcfpcrf) - [PCC 规则](#pcc-规则) - [QoS 模板](#qos-模板) - [Traffic Control](#traffic-control) - [SMPolicy](#smpolicy) - [UE Smpolicy](#smpolicy-ue-add-skilljs) - [DNN Smpolicy](#smpolicy-dnn) - [DNN Smpolicy](#smpolicy-dnn) - [TAC Smpolicy](#smpolicy-tac) - [Cell Smpolicy](#smpolicy-cell) - [Cell Forbidden Smpolicy](#smpolicy-cell-forbidden) - [NRF](#nrf) - [全局参数参考](#全局参数参考) - [字段参考](#字段参考) --- ## 快速开始 ### 安装方法 技能目录位于 `skills/5gc/`，由统一入口 `5gc.js` 统一调度，无需额外安装： ```bash # 克隆或复制到本机 git clone <repo> ~/.openclaw/workspace/skills/5gc # 直接使用统一入口（推荐） node skills/5gc/scripts/5gc.js <entity> <action> [options] # 或直接调用各脚本 node skills/5gc/scripts/amf-add-skill.js <参数> ``` ### 前置要求 - Node.js ≥ 14 - Playwright（`npm i playwright && npx playwright install chromium`） - 5GC 仪表地址：`https://192.168.3.89`（默认） - 登录凭证：`dotouch@dotouch.com.cn` / `dotouch` - 仪表上已创建对应工程（如 `XW_S5GC_1`） ### 会话缓存 所有脚本自动复用 Playwright 会话缓存（`.sessions/` 目录），首次登录后再次运行无需重复登录。 --- ## 统一 CLI 入口 ### 路径 ``` node skills/5gc/scripts/5gc.js <entity> <action> [options] ``` ### 支持的网元与操作 | entity | add | edit | 特殊操作 | |--------|-----|------|---------| | `amf` | ✅ | ✅ | | | `udm` | ✅ | ✅ | | | `smf` | ✅ | ✅ | | | `upf` | ✅ | ✅ | | | `gnb` | ✅ | ✅ | | | `ue` | ✅ | ✅ | | | `pcf` | ✅ | ✅ | `default-rule-add` | | `pcc` | ✅ | ✅ | | | `qos` | ✅ | | | | `tc` | ✅ | | | | `smpolicy` | | | `add-pcc`, `ue-add`, `ue-edit`, `dnn-add`, `dnn-edit` | | `nrf` | ✅ | ✅ | | ### 全局选项 | 选项 | 说明 | |------|------| | `--url <地址>` | 5GC 仪表地址，默认 `https://192.168.3.89` | | `--headed` | 打开可见浏览器窗口（调试用） | ### 三种使用模式 ```bash # 1. 添加网元 node 5gc.js amf add <名称> [参数...] # 2. 批量编辑（当前工程下所有该类网元） node 5gc.js amf edit --project <工程> --set-<字段> <值> # 3. 单个编辑（按名称精确匹配） node 5gc.js amf edit --name <名称> --project <工程> --set-<字段> <值> ``` --- ## 技能详细文档 --- ### AMF #### amf-add-skill.js **功能**：在指定工程下添加一个 AMF 实例。 **使用方式**： ```bash node 5gc.js amf add <名称> [选项...] # 或直接调用 node skills/5gc/scripts/amf-add-skill.js <名称> [选项...] ``` **参数**： | 参数 | 说明 | 默认值 | |------|------|--------| | `<名称>` | AMF 实例名称（位置参数） | **必填** | | `--project <工程>` / `-p <工程>` | 目标工程名称 | `5G_basic_process` | | `--url <地址>` | 5GC 仪表地址 | `https://192.168.3.89` | | `--mcc <值>` | MCC（移动国家码） | `460` | | `--mnc <值>` | MNC（移动网络码） | `01` | | `--ngap_sip <IP>` | NGAP 信令面 IP | `200.20.20.1` | | `--ngap_port <端口>` | NGAP 端口 | `38412` | | `--http2_sip <IP>` | HTTP2 服务 IP | `200.20.20.5` | | `--http2_port <端口>` | HTTP2 端口 | `8080` | | `--stac <值>` | 起始 TAC | `101` | | `--etac <值>` | 结束 TAC | `102` | | `--region_id <值>` | 区域 ID | `1` | | `--set_id <值>` | Set ID | `1` | | `--pointer <值>` | 指针 | `1` | | `--headed` | 打开可见浏览器 | false | **示例**： ```bash # 基本添加 node 5gc.js amf add AMF_TEST --project XW_S5GC_1 # 指定 NGAP IP 和端口 node 5gc.js amf add AMF_PROD --project XW_S5GC_1 --ngap_sip 10.200.1.50 --ngap_port 38412 # 使用不同 MCC/MNC node 5gc.js amf add AMF_CMCC --project XW_S5GC_1 --mcc 460 --mnc 00 ``` --- #### amf-edit-skill.js **功能**：修改 AMF 配置参数。支持单个修改或批量修改工程下所有 AMF。 **使用方式**： ```bash node 5gc.js amf edit [选项...] ``` **参数**： | 参数 | 说明 | |------|------| | `--project <工程>` / `-p <工程>` | 目标工程，不带 `--name` 时批量修改该工程下所有 AMF | | `--name <名称>` | 精确匹配要修改的 AMF 名称 | | `--id <ID>` | 按 AMF ID 修改 | | `--set-<字段> <值>` | 修改指定字段的值，支持多组 | | `--url <地址>` | 5GC 仪表地址 | | `--headed` | 打开可见浏览器 | **可编辑字段**：`name`, `mcc`, `mnc`, `ngap_sip`, `ngap_port`, `http2_sip`, `http2_port`, `stac`, `etac`, `region_id`, `set_id`, `pointer`, `ea[NEA0]`, `ea[128-NEA1]`, `ea[128-NEA2]`, `ea[128-NEA3]`, `ia[NIA0]`, `ia[128-NIA1]`, `ia[128-NIA2]`, `ia[128-NIA3]` > ⚠️ `ea[NEA0]` 等算法字段：实际向表单填入字段名 `ea[NEA0]`（input[name="ea[NEA0]"]），layui checkbox 点击基于索引而非字段名，详情见 SKILL.md 算法配置章节。 **示例**： ```bash # 批量修改工程下所有 AMF 的 NGAP IP node 5gc.js amf edit --project XW_S5GC_1 --set-ngap_sip 10.200.1.99 # 修改指定 AMF node 5gc.js amf edit --name AMF_TEST --project XW_S5GC_1 --set-ngap_sip 10.200.1.50 --set-http2_sip 10.200.1.51 # 按 ID 修改 node 5gc.js amf edit --id 6633 --set-ngap_port 38413 ``` --- ### UDM/AUSF #### ausf-udm-add-skill.js **功能**：在指定工程下添加一个 UDM/AUSF 实例。 **使用方式**： ```bash node 5gc.js udm add <名称> [选项...] ``` **参数**： | 参数 | 说明 | 默认值 | |------|------|--------| | `<名称>` | UDM 实例名称（位置参数） | **必填** | | `--project <工程>` / `-p <工程>` | 目标工程名称 | `5G_basic_process` | | `--url <地址>` | 5GC 仪表地址 | `https://192.168.3.89` | | `--count <数量>` | 实例数量 | `1` | | `--sip <IP>` | SIP 服务 IP | `192.168.20.30` | | `--port <端口>` | SIP 端口 | `80` | | `--auth_method <方法>` | 认证方法 | `5G_AKA` | | `--scheme <协议>` | 协议类型 | `HTTP` | | `--priority <优先级>` | 优先级 | `8` | | `--headed` | 打开可见浏览器 | false | **示例**： ```bash # 基本添加 node 5gc.js udm add UDM_TEST --project XW_S5GC_1 # 指定 SIP IP 和端口 node 5gc.js udm add UDM_PROD --project XW_S5GC_1 --sip 10.0.0.100 --port 8080 # 批量添加 3 个实例 node 5gc.js udm add UDM_CLUSTER --project XW_S5GC_1 --count 3 --sip 10.0.0.50 ``` --- #### ausf-udm-edit-skill.js **功能**：修改 UDM/AUSF 配置参数。支持批量和单个修改。 **使用方式**： ```bash node 5gc.js udm edit [选项...] ``` **参数**： | 参数 | 说明 | |------|------| | `--project <工程>` | 目标工程，不带 `--name` 时批量修改 | | `--name <名称>` | 精确匹配要修改的 UDM 名称 | | `--set-sip <IP>` | 修改 SIP IP | | `--set-port <端口>` | 修改端口 | | `--set-auth_method <方法>` | 修改认证方法 | | `--set-scheme <协议>` | 修改协议 | | `--set-count <数量>` | 修改实例数量 | | `--url <地址>` | 5GC 仪表地址 | | `--headed` | 打开可见浏览器 | **示例**： ```bash # 批量修改工程下所有 UDM 的 SIP IP node 5gc.js udm edit --project XW_S5GC_1 --set-sip 10.0.0.99 # 修改指定 UDM node 5gc.js udm edit --name UDM_TEST --project XW_S5GC_1 --set-sip 10.0.0.88 --set-port 8080 ``` --- ### SMF/PGW-C #### smf-pgwc-add-skill.js **功能**：在指定工程下添加一个 SMF/PGW-C 实例。 **使用方式**： ```bash node 5gc.js smf add --name <名称> [选项...] ``` > ⚠️ 通过 5gc.js 统一调度时必须使用 `--name <名称>` 形式（不是位置参数）。 **参数**： | 参数 | 说明 | 默认值 | |------|------|--------| | `--name <名称>` | SMF 实例名称 | **必填** | | `--project <工程>` / `-p <工程>` | 目标工程名称 | `XW_S5GC_1` |