5gc
v0.0.05GC Web仪表自动化技能，支持AMF/UDM/AUSF/SMF/PGW-C/UPF/PGW-U/GNB/UE/PCF/NRF/QoS/TC/PCC/smpolicy的批量添加与编辑及PCF默认规则一键配置
0· 105· 1 versions· 0 current· 0 all-time· Updated 1w ago· MIT-0
5GC Web 仪表自动化技能
统一管理 AMF、UDM/AUSF、SMF/PGW-C、UPF/PGW-U、GNB、UE、PCF、NRF 八类网元的添加与编辑操作，以及 PCC 规则、QoS 模板、Traffic Control、SMPolicy 和 PCF 默认规则一键配置。
目录
快速开始
安装方法
技能目录位于 skills/5gc/，由统一入口 5gc.js 统一调度，无需额外安装：
# 克隆或复制到本机
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 | 打开可见浏览器窗口（调试用） |
三种使用模式
# 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 实例。
使用方式：
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 |
示例：
# 基本添加
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。
使用方式：
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 算法配置章节。
示例：
# 批量修改工程下所有 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 实例。
使用方式：
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 |
示例：
# 基本添加
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 配置参数。支持批量和单个修改。
使用方式：
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 | 打开可见浏览器 |
示例：
# 批量修改工程下所有 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 实例。
使用方式：
node 5gc.js smf add --name <名称> [选项...]
⚠️ 通过 5gc.js 统一调度时必须使用
--name <名称>形式（不是位置参数）。
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--name <名称> | SMF 实例名称 | 必填 |
--project <工程> / -p <工程> | 目标工程名称 | XW_S5GC_1 |
--url <地址> | 5GC 仪表地址 | https://192.168.3.89 |
--pfcp_sip <IP> | PFCP 信令面 IP | 200.20.20.25 |
--http2_sip <IP> | HTTP2 服务 IP | 200.20.20.25 |
--mcc <值> | MCC | 460 |
--mnc <值> | MNC | 01 |
--pdu_capacity <数量> | PDU 会话容量 | 200000 |
--ue_min <IP> | UE IP 池起始 | 30.30.30.20 |
--ue_max <IP> | UE IP 池结束 | 30.31.30.20 |
--interest_tac <TAC列表> | 关注 TAC 列表（逗号分隔） | 101,102 |
--headed | 打开可见浏览器 | false |
✅ NSSAI 自动配置：脚本在 SMF 创建后会自动打开 NSSAI 配置弹窗，添加一条默认 NSSAI（SST=1, SD=000001, DNN Group=cscn2net）。如需自定义 NSSAI 参数，请直接修改脚本中的硬编码值。
⚠️ ue_sip6 / ue_eip6 为硬编码值，不支持 CLI 参数覆盖。
示例：
# 基本添加
node 5gc.js smf add --name SMF_TEST --project XW_S5GC_1
# 指定工程和 IP/MCC
node 5gc.js smf add --name SMF_PROD --project XW_S5GC_1 --pfcp_sip 10.10.10.50 --http2_sip 10.10.10.51 --mcc 460 --mnc 01
smf-pgwc-edit-skill.js
功能：修改 SMF/PGW-C 配置参数。支持批量和单个修改。
使用方式：
node 5gc.js smf edit [选项...]
参数：
| 参数 | 说明 |
|---|---|
--project <工程> | 目标工程，不带 --name 时批量修改 |
--name <名称> | 精确匹配要修改的 SMF 名称 |
--set-pfcp_sip <IP> | 修改 PFCP 信令面 IP |
--set-http2_sip <IP> | 修改 HTTP2 服务 IP |
--set-mcc <值> | 修改 MCC |
--set-mnc <值> | 修改 MNC |
--set-pdu_capacity <数量> | 修改 PDU 会话容量 |
--set-ue_min <IP> | 修改 UE IP 池起始 |
--set-ue_max <IP> | 修改 UE IP 池结束 |
--set-interest_tac <TAC列表> | 修改关注 TAC 列表（逗号分隔） |
⚠️ 以下字段不支持
--set-修改：dnn、n3_ip、n6_ip、snssai_sst、snssai_sd。如需修改，请通过仪表 UI 手动完成。NSSAI 配置请在添加时自动完成（见上文）。
示例：
# 批量修改工程下所有 SMF 的 HTTP2 IP
node 5gc.js smf edit --project XW_S5GC_1 --set-http2_sip 10.10.10.99
# 修改指定 SMF 的 pfcp_sip 和 MCC/MNC
node 5gc.js smf edit --name SMF_TEST --project XW_S5GC_1 --set-pfcp_sip 10.10.10.88 --set-mcc 460 --set-mnc 01
UPF/PGW-U
upf-add-skill.js
功能：在指定工程下添加一个 UPF/PGW-U 实例。
使用方式：
node 5gc.js upf add <名称> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
<名称> | UPF 实例名称（位置参数） | 必填 |
--project <工程> / -p <工程> | 目标工程名称 | XW_S5GC_1 |
--url <地址> | 5GC 仪表地址 | https://192.168.3.89 |
--n4_ip <IP> | N4 接口 IP | 192.168.20.30 |
--n3_ip <IP> | N3 接口 IP | 192.168.20.30 |
--n6_ip <IP> | N6 接口 IP | 192.168.20.31 |
--n4_port <端口> | N4 端口 | 8805 |
--MCC <值> | MCC（注意大写） | 460 |
--MNC <值> | MNC（注意大写） | 01 |
--pdu_capacity <数量> | PDU 会话容量 | 20000 |
--ue_min <IP> | UE IP 池起始 | 20.20.20.20 |
--ue_max <IP> | UE IP 池结束 | 20.20.60.20 |
--headed | 打开可见浏览器 | false |
⚠️ DNN、TAC、NSSAI 在添加脚本中为硬编码默认值，不支持命令行覆盖。如需修改，请使用
upf edit脚本。
示例：
# 基本添加
node 5gc.js upf add UPF_TEST --project XW_S5GC_1
# 指定 N4/N3/N6 IP 和 MCC/MNC
node 5gc.js upf add UPF_PROD --project XW_S5GC_1 --n4_ip 10.0.0.50 --n6_ip 10.0.0.51 --MCC 460 --MNC 01
upf-edit-skill.js
功能：修改 UPF/PGW-U 配置参数。支持批量和单个修改。
使用方式：
node 5gc.js upf edit [选项...]
参数：
| 参数 | 说明 |
|---|---|
--project <工程> | 目标工程，不带 --name 时批量修改 |
--name <名称> | 精确匹配要修改的 UPF 名称 |
--set-n3_ip <IP> | 修改 N3 接口 IP |
--set-n4_ip <IP> | 修改 N4 接口 IP |
--set-n4_port <端口> | 修改 N4 端口 |
--set-n6_ip <IP> | 修改 N6 接口 IP |
--set-MCC <值> | 修改 MCC（注意大写） |
--set-MNC <值> | 修改 MNC（注意大写） |
--set-pdu_capacity <数量> | 修改 PDU 会话容量 |
--set-ue_min <IP> | 修改 UE IP 池起始 |
--set-ue_max <IP> | 修改 UE IP 池结束 |
--url <地址> | 5GC 仪表地址 |
--headed | 打开可见浏览器 |
⚠️
dnn（DNN）和 TAC/NSSAI 在 UPF 表单中存储在 jsgrid 配置行内，不支持简单的--set-修改。
示例：
# 批量修改工程下所有 UPF 的 N4 IP
node 5gc.js upf edit --project XW_S5GC_1 --set-n4_ip 99.99.99.99
# 修改指定 UPF 的 N4/N6 IP 和 MCC/MNC
node 5gc.js upf edit --name UPF_TEST --project XW_S5GC_1 --set-n4_ip 88.88.88.88 --set-n6_ip 88.88.88.89 --set-MCC 460 --set-MNC 01
GNB
gnb-add-skill.js
功能：在指定工程下添加一个 GNB 实例。
使用方式：
node 5gc.js gnb add <名称> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
<名称> | GNB 实例名称（位置参数） | 必填 |
--project <工程> / -p <工程> | 目标工程名称 | XW_S5GC_1 |
--url <地址> | 5GC 仪表地址 | https://192.168.3.89 |
--ngap_sip <IP> | NGAP 信令面 IP | 200.20.20.50 |
--user_sip_ip_v4 <IP> | 用户面 IPv4 | 2.2.2.2 |
--mcc <值> | MCC | 460 |
--mnc <值> | MNC | 60 |
--stac <值> | 起始 TAC | 0 |
--etac <值> | 结束 TAC | 0 |
--node_id <ID> | 节点 ID | 70 |
--cell_count <数量> | 小区数量 | 1 |
--headed | 打开可见浏览器 | false |
⚠️
stac/etac/node_id非默认值时可能触发表单验证失败，建议先使用默认值添加后再用gnb edit修改。
示例：
# 基本添加
node 5gc.js gnb add GNB_TEST --project XW_S5GC_1
# 指定 NGAP IP、用户面 IP 和 TAC
node 5gc.js gnb add GNB_PROD --project XW_S5GC_1 --ngap_sip 200.20.20.100 --user_sip_ip_v4 3.3.3.3 --mcc 460 --mnc 60 --stac 1 --etac 10
gnb-edit-skill.js
功能：修改 GNB 配置参数。支持批量和单个修改。
使用方式：
node 5gc.js gnb edit [选项...]
参数：
| 参数 | 说明 |
|---|---|
--project <工程> | 目标工程，不带 --name 时批量修改 |
--name <名称> | 精确匹配要修改的 GNB 名称 |
--set-ngap_sip <IP> | 修改 NGAP 信令面 IP |
--set-user_sip_ip_v4 <IP> | 修改用户面 IPv4 |
--set-user_sip_ip_v6 <IP> | 修改用户面 IPv6 |
--set-mcc <值> | 修改 MCC |
--set-mnc <值> | 修改 MNC |
--set-stac <值> | 修改起始 TAC |
--set-etac <值> | 修改结束 TAC |
--set-node_id <ID> | 修改节点 ID |
--set-cell_count <数量> | 修改小区数量 |
--set-replay_ip <IP> | 修改回放 IP |
--set-replay_port <端口> | 修改回放端口 |
--url <地址> | 5GC 仪表地址 |
--headed | 打开可见浏览器 |
示例：
# 批量修改工程下所有 GNB 的用户面 IP
node 5gc.js gnb edit --project XW_S5GC_1 --set-user_sip_ip_v4 99.99.99.99
# 修改指定 GNB 的 NGAP IP 和 MCC/MNC
node 5gc.js gnb edit --name GNB_TEST --project XW_S5GC_1 --set-ngap_sip 200.20.20.88 --set-mcc 461 --set-mnc 22
UE
ue-add-skill.js
功能：在指定工程下添加一个或多个 UE 实例。
使用方式：
node 5gc.js ue add --name <名称> [选项...]
参数：
| 参数 | 短名 | 说明 | 默认值 |
|---|---|---|---|
--name <名称> | -n <名称> | UE 名称（只支持字母/数字/下划线） | 必填 |
--project <工程> | -p <工程> | 目标工程名称 | XW_S5GC_1 |
--url <地址> | -u <地址> | 5GC 仪表地址 | https://192.168.3.89 |
--imsi <值> | 起始 IMSI（15位） | 460001234567890 | |
--msisdn <值> | MSISDN（13-15位，以 86 开头） | 8611111111111 | |
--mcc <值> | MCC | 460 | |
--mnc <值> | MNC | 01 | |
--key <值> | KI 密钥（32位 hex） | 1111...（32个1） | |
--opc <值> | OPc 密钥（32位 hex） | 1111...（32个1） | |
--imeisv <值> | IMEISV（偶数位） | 8611111111111111 | |
--sst <值> | NSSAI SST | 1 | |
--sd <值> | NSSAI SD | 111111 | |
--count <数量> | -c <数量> | 连续添加数量 | 1 |
--headed | 打开可见浏览器 | false |
命名约束：UE 名称只能包含字母、数字、下划线（
_），不能使用连字符（-）或其他特殊字符。
示例：
# 基本添加
node 5gc.js ue add --name UE_001 --project XW_S5GC_1
# 指定 IMSI 和 MSISDN
node 5gc.js ue add --name UE_TEST --imsi 460000000000001 --msisdn 8613888888888 --project XW_S5GC_1
# 批量添加 10 个连续 UE
node 5gc.js ue add --name UE_BATCH --count 10 --project XW_S5GC_1 --msisdn 8613900000000
# 指定认证密钥
node 5gc.js ue add --name UE_AUTH --project XW_S5GC_1 --key 00112233445566778899aabbccddeeff --opc 11223344556677889900aabbccddeeff
ue-edit-skill.js
功能：修改 UE 配置参数。支持批量和单个修改。
使用方式：
node 5gc.js ue edit [选项...]
参数：
| 参数 | 说明 |
|---|---|
--project <工程> | 目标工程，不带 --name 时批量修改该工程下所有 UE |
--name <名称> | 精确匹配要修改的 UE 名称（不支持批量时按名称过滤） |
--id <ID> | 按 UE ID 修改 |
--set-msisdn <值> | 修改 MSISDN |
--set-s_imsi <值> | 修改 IMSI |
--set-mcc <值> | 修改 MCC |
--set-mnc <值> | 修改 MNC |
--set-key <值> | 修改 KI 密钥 |
--set-opc <值> | 修改 OPc 密钥 |
--set-imeisv <值> | 修改 IMEISV |
--set-sst <值> | 修改 NSSAI SST |
--set-sd <值> | 修改 NSSAI SD |
--set-replay_ip <IP> | 修改回放 IP |
--set-replay_port <端口> | 修改回放端口 |
--set-count <数量> | 修改数量 |
--url <地址> | 5GC 仪表地址 |
--headed | 打开可见浏览器 |
⚠️
user_sip_ip_v4、user_sip_ip_v6在 UE 编辑表单中不存在此字段名，无需修改。
示例：
# 批量修改工程下所有 UE 的 MSISDN
node 5gc.js ue edit --project XW_S5GC_1 --set-msisdn 8613911111111
# 修改指定 UE
node 5gc.js ue edit --name UE_001 --project XW_S5GC_1 --set-msisdn 8613988888888 --set-sst 1 --set-sd 222222
# 按 ID 修改
node 5gc.js ue edit --id 10337 --set-opc aabbccddeeff00112233445566778899 --set-imeisv 8611111111111112
PCF/PCRF
pcf-add-skill.js
功能：在指定工程下添加一个 PCF/PCRF 实例。
使用方式：
node 5gc.js pcf add <名称> [选项...]
node skills/5gc/scripts/pcf-add-skill.js <名称> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
<名称> | PCF 实例名称（位置参数） | 必填 |
--project <工程> / -p <工程> | 目标工程名称 | XW_S5GC_1 |
--url <地址> | 5GC 仪表地址 | https://192.168.3.89 |
--http2_sip <IP> | HTTP2 服务 IP | 192.168.20.90 |
--http2_port <端口> | HTTP2 端口 | 80 |
--MCC <值> | MCC（注意大写） | 460 |
--MNC <值> | MNC（注意大写） | 01 |
--headed | 打开可见浏览器 | false |
示例：
node 5gc.js pcf add PCF-TEST --project XW_S5GC_1
node 5gc.js pcf add PCF-PROD --project XW_S5GC_1 --http2_sip 10.0.0.50 --MCC 460 --MNC 01
pcf-edit-skill.js
功能：编辑指定工程下的 PCF/PCRF 实例（支持单条和批量）。
使用方式：
# 批量编辑：修改工程下所有 PCF 的字段
node 5gc.js pcf edit --project <工程> --set-<字段> <值>
# 单条编辑：修改指定名称的 PCF
node 5gc.js pcf edit --name <名称> --project <工程> --set-<字段> <值>
可编辑字段：
| 参数 | 说明 |
|---|---|
--set-http2_sip <IP> | 修改 HTTP2 服务 IP |
--set-http2_port <端口> | 修改 HTTP2 端口 |
--set-MCC <值> | 修改 MCC（注意大写） |
--set-MNC <值> | 修改 MNC（注意大写） |
示例：
# 批量修改工程下所有 PCF 的 HTTP2 IP
node 5gc.js pcf edit --project XW_S5GC_1 --set-http2_sip 10.10.10.99
# 修改指定 PCF 的 HTTP2 IP 和 MNC
node 5gc.js pcf edit --name pcc --project XW_S5GC_1 --set-http2_sip 10.10.10.88 --set-MNC 01
default-rule-add-skill.js（PCF 默认规则一键配置）
功能：为指定工程一键配置完整的 PCF 默认规则链路，包含 QoS 模板 → Traffic Control → PCC 规则 → sm_policy_default → PCF default_smpolicy 全五步。
使用方式：
node 5gc.js pcf default-rule-add --project <工程> [选项...]
node skills/5gc/scripts/default-rule-add-skill.js --project <工程> [选项...]
参数（全部可选，有默认值）：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--qos-id | QoS 模板 ID | qos_default_{时间戳} |
--5qi | 5QI 值（不指定则自动选择未使用的值） | 自动（优先 8/9/6/5...） |
--maxbr-ul | 上行最大比特率 | 10000000 |
--maxbr-dl | 下行最大比特率 | 20000000 |
--gbr-ul | 上行保证比特率 | 5000000 |
--gbr-dl | 下行保证比特率 | 5000000 |
--tc-id | TC 规则 ID | tc_default_{时间戳} |
--flow-status | TC 流状态 | ENABLED |
--pcc-id | PCC 规则 ID | pcc_default |
--precedence | PCC 优先级 | 63 |
--headed | 显示浏览器窗口（调试用） | off |
示例：
# 最简用法（自动生成所有 ID）
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4
# 指定 QoS 参数（高速率）
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 \
--qos-id qos_high_rate --5qi 8 \
--maxbr-ul 50000000 --maxbr-dl 100000000 \
--gbr-ul 20000000 --gbr-dl 40000000
# 指定 PCC 优先级
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 --pcc-id pcc_new --precedence 50
# 调试模式
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 --headed
注意：同一工程多次运行会自动删除旧的同名资源并重建，不会污染配置。
PCC 规则
pcc-add-skill.js
功能：在指定工程下添加一条 PCC 规则（PCC 规则用于绑定 QoS 模板和 Traffic Control）。
使用方式：
node 5gc.js pcc add --project <工程> --pcc-id <ID> --qos <QoS名称> --tc <TC名称> [选项...]
node skills/5gc/scripts/pcc-add-skill.js --project <工程> --pcc-id <ID> --qos <QoS名称> --tc <TC名称> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--pcc-id | PCC 规则 ID（字母/数字/下划线） | 必填 |
--qos | 引用的 QoS 模板名称 | 必填 |
--tc | 引用的 Traffic Control 名称 | 必填 |
--precedence | 优先级（0-255） | 63 |
--flow-desc | 流描述（可选） | |
--headed | 显示浏览器窗口 | off |
示例：
# 基本添加
node 5gc.js pcc add --project XW_SUPF_5_1_2_4 --pcc-id pcc_new --qos qos1 --tc tc1
# 指定优先级
node 5gc.js pcc add --project XW_SUPF_5_1_2_4 --pcc-id pcc_high --qos qos2 --tc tc1 --precedence 50
pcc-edit-skill.js
功能：编辑已有 PCC 规则的 QoS/TC 绑定（切换 PCC 引用的 QoS 模板或 Traffic Control）。
使用方式：
node 5gc.js pcc edit --project <工程> --name <PCC名称> --set-qos <新QoS> [--set-tc <新TC>]
参数：
| 参数 | 说明 |
|---|---|
--project | 工程名 |
--name | 要修改的 PCC 规则名称（精确匹配） |
--set-qos <名称> | 切换到新的 QoS 模板 |
--set-tc <名称> | 切换到新的 Traffic Control |
--headed | 显示浏览器窗口 |
示例：
# 修改 PCC 引用的 QoS（用于修改上下行速率）
node 5gc.js pcc edit --project XW_SUPF_5_1_2_4 --name pcc_default --set-qos qos_high_rate
# 同时修改 QoS 和 TC
node 5gc.js pcc edit --project XW_SUPF_5_1_2_4 --name pcc_default --set-qos qos1 --set-tc tc2
⚠️ 重要：PCC 的
refQosData和refTcData存储在 xm-select 多选组件中。编辑时会自动切换选择，无需手动取消旧选项。
NRF（网络存储功能）
nrf-add-skill.js
功能：在指定工程下添加一个 NRF 实例。
使用方式：
node 5gc.js nrf add <名称> [选项...]
node skills/5gc/scripts/nrf-add-skill.js <名称> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
<名称> | NRF 实例名称（位置参数） | 必填 |
--project <工程> / -p <工程> | 目标工程名称 | XW_S5GC_1 |
--url <地址> | 5GC 仪表地址 | https://192.168.3.89 |
--http2_sip <IP> | HTTP2 服务 IP | 192.168.20.100 |
--http2_port <端口> | HTTP2 端口 | 80 |
--MCC <值> | MCC（注意大写） | 460 |
--MNC <值> | MNC（注意大写） | 01 |
--headed | 打开可见浏览器 | false |
示例：
node 5gc.js nrf add NRF-TEST --project XW_S5GC_1
node 5gc.js nrf add NRF-PROD --project XW_S5GC_1 --http2_sip 10.0.0.50 --MCC 460 --MNC 01
nrf-edit-skill.js
功能：编辑指定工程下的 NRF 实例（支持单条和批量）。
使用方式：
# 批量编辑：修改工程下所有 NRF 的字段
node 5gc.js nrf edit --project <工程> --set-<字段> <值>
# 单条编辑：修改指定名称的 NRF
node 5gc.js nrf edit --name <名称> --project <工程> --set-<字段> <值>
可编辑字段：
| 参数 | 说明 |
|---|---|
--set-http2_sip <IP> | 修改 HTTP2 服务 IP |
--set-http2_port <端口> | 修改 HTTP2 端口 |
--set-MCC <值> | 修改 MCC（注意大写） |
--set-MNC <值> | 修改 MNC（注意大写） |
示例：
# 批量修改工程下所有 NRF 的 HTTP2 IP
node 5gc.js nrf edit --project XW_S5GC_1 --set-http2_sip 10.10.10.99
# 修改指定 NRF 的 HTTP2 IP 和 MNC
node 5gc.js nrf edit --name nrf1 --project XW_S5GC_1 --set-http2_sip 10.10.10.88 --set-MNC 01
QoS 模板
qos-add-skill.js
功能：在指定工程下添加一个 QoS（服务质量）模板，定义 5QI、上下行最大比特率、保证比特率等参数。
使用方式：
node 5gc.js qos add --project <工程> --qos-id <ID> [选项...]
node skills/5gc/scripts/qos-add-skill.js --project <工程> --qos-id <ID> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--qos-id | QoS 模板 ID（字母/数字/下划线） | 必填 |
--5qi | 5QI 值（不指定则自动选择） | 自动选择未使用的值（优先 8/9/6/5...） |
--maxbr-ul | 上行最大比特率（bps） | 10000000 |
--maxbr-dl | 下行最大比特率（bps） | 20000000 |
--gbr-ul | 上行保证比特率（bps） | 5000000 |
--gbr-dl | 下行保证比特率（bps） | 5000000 |
--priority | 优先级 | 空 |
--headed | 显示浏览器窗口 | off |
示例：
# 基本添加
node 5gc.js qos add --project XW_SUPF_5_1_2_4 --qos-id qos1
# 高速率 QoS
node 5gc.js qos add --project XW_SUPF_5_1_2_4 --qos-id qos_high \
--5qi 8 --maxbr-ul 50000000 --maxbr-dl 100000000 \
--gbr-ul 20000000 --gbr-dl 40000000
# 批量创建不同 5qi 的 QoS 模板
node 5gc.js qos add --project XW_SUPF_5_1_2_4 --qos-id qos_6 --5qi 6
node 5gc.js qos add --project XW_SUPF_5_1_2_4 --qos-id qos_9 --5qi 9
Traffic Control
tc-add-skill.js
功能：在指定工程下添加一条 Traffic Control 流量控制规则，控制 UE 流量的启用/禁用状态。
使用方式：
node 5gc.js tc add --project <工程> --tc-id <ID> [选项...]
node skills/5gc/scripts/tc-add-skill.js --project <工程> --tc-id <ID> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--tc-id | TC 规则 ID（字母/数字/下划线） | 必填 |
--flow-status | 流状态 | ENABLED |
--flow-desc | 流描述（可选） | |
--headed | 显示浏览器窗口 | off |
flow-status 选项：
ENABLED（启用）、DISABLED（禁用）、ENABLED-UPLINK（仅上行）等。
示例：
# 基本添加
node 5gc.js tc add --project XW_SUPF_5_1_2_4 --tc-id tc1
# 指定流状态
node 5gc.js tc add --project XW_SUPF_5_1_2_4 --tc-id tc_uplink --flow-status ENABLED-UPLINK
SMPolicy
smpolicy_add_pcc.js {#smpolicy-default}
功能：将已有 PCC 规则添加到工程默认的 sm_policy_default 会话策略中（追加到 pccRules 列表）。
使用方式：
node 5gc.js smpolicy add-pcc --project <工程> --pcc-id <PCC名称>
node skills/5gc/scripts/smpolicy_add_pcc.js --project <工程> --pcc-id <PCC名称>
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_SUPF_5_1_2_4 |
--pcc-id | 已存在的 PCC 规则 ID | 必填 |
--headed | 显示浏览器窗口 | off |
链路：
smpolicy/default/index→ 编辑sm_policy_default弹窗 → pccRules xm-select 中追加指定 PCC。
示例：
# 将 PCC 添加到 sm_policy_default
node 5gc.js smpolicy add-pcc --project XW_SUPF_5_1_2_4 --pcc-id pcc_high_rate
# 添加多个 PCC 规则
node 5gc.js smpolicy add-pcc --project XW_SUPF_5_1_2_4 --pcc-id pcc_default
node 5gc.js smpolicy add-pcc --project XW_SUPF_5_1_2_4 --pcc-id pcc_video
smpolicy-ue-add-skill.js {#smpolicy-ue-add-skilljs}
功能：在指定工程下添加一条 UE Smpolicy 规则，按 IMSI/DNN/sNssai 匹配 UE 并关联 PCC 规则。
使用方式：
node 5gc.js smpolicy ue-add --project <工程> --name <名称> --dnn <DNN> [选项...]
node skills/5gc/scripts/smpolicy-ue-add-skill.js --project <工程> --name <名称> --dnn <DNN> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--name | UE策略名称（字母/数字/下划线） | 必填 |
--dnn | DNN | 必填 |
--imsi | IMSI 起始值（不填则自动生成） | 自动 |
--imsi-num | IMSI 数量 | 1 |
--sst | sNssai SST | 1 |
--sd | sNssai SD | 111111 |
--sess-rules | 会话规则（xm-select，多个逗号分隔） | |
--pcc-rules | PCC规则（xm-select，多个逗号分隔） | |
--pra-rules | PRA规则（xm-select，可选） | |
--ref-qos-timer | reflectiveQoSTimer 值（秒） | |
--headed | 显示浏览器窗口 | off |
示例：
# 基本添加
node 5gc.js smpolicy ue-add --project XW_SUPF_5_1_2_4 --name ue_policy1 --dnn internet
# 指定 IMSI 和 sNssai
node 5gc.js smpolicy ue-add --project XW_SUPF_5_1_2_4 --name ue_policy1 --dnn internet \
--imsi 460001234567890 --sst 1 --sd 111111
# 绑定 PCC 规则（多个逗号分隔）
node 5gc.js smpolicy ue-add --project XW_SUPF_5_1_2_4 --name ue_policy2 --dnn internet \
--pcc-rules "pcc2,pcc_default"
# 指定反射 QoS 定时器
node 5gc.js smpolicy ue-add --project XW_SUPF_5_1_2_4 --name ue_policy3 --dnn internet \
--pcc-rules pcc2 --ref-qos-timer 60
smpolicy-ue-edit-skill.js
功能：编辑已有 UE Smpolicy 规则的字段（DNN、sNssai、PCC 绑定等）。
使用方式：
node 5gc.js smpolicy ue-edit --project <工程> --name <名称> [--dnn <新DNN>] [--pcc-rules <规则>] [选项...]
参数：
| 参数 | 说明 |
|---|---|
--project | 工程名 |
--name | 要编辑的 UE 策略名称（精确匹配） |
--dnn | 新 DNN |
--imsi | 新 IMSI 起始值 |
--sst | 新 sNssai SST |
--sd | 新 sNssai SD |
--sess-rules | 会话规则（xm-select，多个逗号分隔） |
--pcc-rules | PCC规则（xm-select，多个逗号分隔） |
--pra-rules | PRA规则（xm-select） |
--ref-qos-timer | reflectiveQoSTimer |
--headed | 显示浏览器窗口 |
⚠️ xm-select 为多选模式。指定
--pcc-rules时会叠加选中已有规则；编辑时需注意 toggle 行为。
示例：
# 修改 DNN
node 5gc.js smpolicy ue-edit --project XW_SUPF_5_1_2_4 --name ue_policy1 --dnn internet_new
# 修改 PCC 绑定
node 5gc.js smpolicy ue-edit --project XW_SUPF_5_1_2_4 --name ue_policy1 --pcc-rules pcc2,pcc_reg_test
# 修改 sNssai
node 5gc.js smpolicy ue-edit --project XW_SUPF_5_1_2_4 --name ue_policy1 --sst 1 --sd 222222
smpolicy-dnn-add-skill.js {#smpolicy-dnn}
功能：在指定工程下添加一条 DNN Smpolicy 规则，按 DNN/sNssai 匹配会话并关联 PCC 规则。
使用方式：
node 5gc.js smpolicy dnn-add --project <工程> --name <名称> --dnn <DNN> [选项...]
参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--name | DNN策略名称（必填） | 必填 |
--dnn | DNN值（必填） | 必填 |
--sst | sNssai SST | 1 |
--sd | sNssai SD | 111111 |
--sess-rules | 会话规则（xm-select，多个逗号分隔） | |
--pcc-rules | PCC规则（xm-select，多个逗号分隔） | |
--pra-rules | PRA规则（xm-select，可选） | |
--ref-qos-timer | reflectiveQoSTimer（秒） | |
--headed | 显示浏览器窗口 | off |
示例：
# 基本添加
node 5gc.js smpolicy dnn-add --project XW_SUPF_5_1_2_4 --name dnn_policy1 --dnn internet
# 绑定 PCC 规则
node 5gc.js smpolicy dnn-add --project XW_SUPF_5_1_2_4 --name dnn_policy1 --dnn internet --pcc-rules pcc2
# 多个 PCC 规则
node 5gc.js smpolicy dnn-add --project XW_SUPF_5_1_2_4 --name dnn_policy2 --dnn internet --pcc-rules "pcc2,pcc_default"
smpolicy-dnn-edit-skill.js
功能：编辑已有 DNN Smpolicy 规则的字段（DNN、sNssai、PCC 绑定等）。
使用方式：
node 5gc.js smpolicy dnn-edit --project <工程> --name <名称> [--dnn <新DNN>] [--pcc-rules <规则>] [选项...]
参数：
| 参数 | 说明 |
|---|---|
--project | 工程名 |
--name | 要编辑的 DNN 策略名称（精确匹配） |
--dnn | 新 DNN 值 |
--sst | 新 sNssai SST |
--sd | 新 sNssai SD |
--sess-rules | 会话规则（xm-select，多个逗号分隔） |
--pcc-rules | PCC规则（xm-select，多个逗号分隔） |
--pra-rules | PRA规则（xm-select） |
--ref-qos-timer | reflectiveQoSTimer |
--headed | 显示浏览器窗口 |
⚠️ xm-select 为多选模式。指定
--pcc-rules时会叠加选中已有规则；编辑时需注意 toggle 行为。
示例：
# 修改 DNN
node 5gc.js smpolicy dnn-edit --project XW_SUPF_5_1_2_4 --name dnn_policy1 --dnn internet_new
# 修改 PCC 绑定
node 5gc.js smpolicy dnn-edit --project XW_SUPF_5_1_2_4 --name dnn_policy1 --pcc-rules pcc2,pcc_default
全局参数参考
以下参数所有脚本均支持：
| 参数 | 说明 | 适用范围 |
|---|---|---|
--url <地址> | 5GC 仪表 URL | 所有脚本 |
--project <工程> / -p <工程> | 目标工程名称 | 所有脚本 |
--headed | 打开可见 Chromium 窗口（调试用） | 所有脚本 |
--set-<字段> <值> | 修改指定字段值 | 所有 edit 脚本 |
--name <名称> | 按名称精确匹配 | 所有 edit 脚本 |
--id <ID> | 按 ID 直接定位 | 所有 edit 脚本 |
字段参考
AMF 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
mcc | 移动国家码 | 460 |
mnc | 移动网络码 | 01 |
ngap_sip | NGAP 信令面 IP | 10.200.1.50 |
ngap_port | NGAP 端口 | 38412 |
http2_sip | HTTP2 服务 IP | 10.200.1.51 |
http2_port | HTTP2 端口 | 8080 |
stac | 起始 TAC | 101 |
etac | 结束 TAC | 102 |
region_id | 区域 ID | 1 |
set_id | Set ID | 1 |
pointer | 指针 | 1 |
ea[NEA0] ~ ea[128-NEA3] | 加密算法（默认全选） | 1 |
ia[NIA0] ~ ia[128-NIA3] | 完整性保护算法（默认全选） | 1 |
UDM/AUSF 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
count | 实例数量 | 3 |
sip | SIP 服务 IP | 10.0.0.100 |
port | 端口 | 80 |
auth_method | 认证方法 | 5G_AKA |
scheme | 协议类型 | HTTP |
priority | 优先级 | 8 |
SMF/PGW-C 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
pfcp_sip | PFCP 信令面 IP | 10.10.10.50 |
n3_ip | N3 接口 IP | 10.10.10.50 |
n6_ip | N6 接口 IP | 10.10.10.51 |
http2_sip | HTTP2 服务 IP | 10.10.10.50 |
dnn | DNN（数据网络名） | internet |
snssai_sst | NSSAI SST | 1 |
snssai_sd | NSSAI SD | ffffff |
mcc | MCC | 460 |
mnc | MNC | 01 |
pdu_capacity | PDU 会话容量 | 200000 |
UPF/PGW-U 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
n3_ip | N3 接口 IP | 192.168.20.30 |
n4_ip | N4 接口 IP（PFCP） | 192.168.20.30 |
n6_ip | N6 接口 IP | 192.168.20.31 |
n6_gw | N6 网关 IP | 192.168.20.1 |
dnn | DNN | internet |
static_arp | 静态 ARP | 192.168.20.254 |
sst | NSSAI SST | 1 |
sd | NSSAI SD | ffffff |
stac | 起始 TAC | 101 |
etac | 结束 TAC | 102 |
GNB 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
ngap_sip | NGAP 信令面 IP | 200.20.20.50 |
user_sip_ip_v4 | 用户面 IPv4 | 2.2.2.2 |
user_sip_ip_v6 | 用户面 IPv6 | ::1 |
mcc | MCC | 460 |
mnc | MNC | 60 |
stac | 起始 TAC | 0 |
etac | 结束 TAC | 0 |
node_id | 节点 ID | 70 |
cell_count | 小区数量 | 1 |
replay_ip | 回放 IP | 0.0.0.0 |
replay_port | 回放端口 | 0 |
UE 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
s_imsi | 起始 IMSI（15位） | 460001234567890 |
msisdn | MSISDN（13-15位，86开头） | 8613888888888 |
mcc | MCC | 460 |
mnc | MNC | 01 |
key | KI 密钥（32位 hex） | 001122... |
op_opc | OPc 密钥（32位 hex） | aabbcc... |
imeisv | IMEISV（15位，偶数） | 8611111111111111 |
nssai_sst | NSSAI SST | 1 |
nssai_sd | NSSAI SD | 111111 |
user_sip_ip_v4 | 用户面 IPv4 | 自动分配 |
user_sip_ip_v6 | 用户面 IPv6 | 自动分配 |
replay_ip | 回放 IP | 0.0.0.0 |
replay_port | 回放端口 | 0 |
default-rule-add-skill.js（PCF 默认规则一键配置）
功能：为指定工程一键配置完整的 PCF 默认规则链路，包含 QoS 模板 → Traffic Control → PCC 规则 → sm_policy_default → PCF default_smpolicy 全五步。
使用方式：
node 5gc.js pcf default-rule-add --project <工程> [选项...]
node skills/5gc/scripts/default-rule-add-skill.js --project <工程> [选项...]
参数（全部可选，有默认值）：
| 参数 | 说明 | 默认值 |
|---|---|---|
--project | 工程名 | XW_S5GC_1 |
--pcf-name | PCF 实例名称（必填，指定要为哪个 PCF 配置默认规则） | 无 |
--qos-id | QoS 模板 ID | qos_default_{时间戳} |
--5qi | 5QI 值（不指定则自动选择未使用的值） | 自动（优先 8/9/6/5...） |
--maxbr-ul | 上行最大比特率 | 10000000 |
--maxbr-dl | 下行最大比特率 | 20000000 |
--gbr-ul | 上行保证比特率 | 5000000 |
--gbr-dl | 下行保证比特率 | 5000000 |
--tc-id | TC 规则 ID | tc_default_{时间戳} |
--flow-status | TC 流状态 | ENABLED |
--pcc-id | PCC 规则 ID | pcc_default |
--precedence | PCC 优先级 | 63 |
--headed | 显示浏览器窗口（调试用） | off |
示例：
# 最简用法（自动生成所有 ID）
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 --pcf-name pcc
# 指定 QoS 参数（高速率）
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 --pcf-name pcc \
--qos-id qos_high_rate --5qi 8 \
--maxbr-ul 50000000 --maxbr-dl 100000000 \
--gbr-ul 20000000 --gbr-dl 40000000
# 指定 PCC 优先级
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 --pcf-name pcc --pcc-id pcc_new --precedence 50
# 调试模式
node 5gc.js pcf default-rule-add --project XW_SUPF_5_1_2_4 --pcf-name pcc --headed
完整链路：
- ✅ QoS 模板创建：自动选择未使用的 5QI，创建 QoS 模板
- ✅ Traffic Control 创建：创建 ENABLED 状态的 TC 规则
- ✅ PCC 规则创建：创建 PCC 规则，绑定 QoS 和 TC
- ✅ sm_policy_default 创建/更新：创建或更新默认会话策略，绑定 PCC 规则
- ✅ PCF default_smpolicy 设置：为指定 PCF 实例设置 default_smpolicy 为 sm_policy_default
注意事项：
- 同一工程多次运行会自动删除旧的同名资源并重建，不会污染配置
- 必须指定
--pcf-name参数，明确要为哪个 PCF 实例配置默认规则 - 脚本会自动处理弹窗（iframe）和 CSRF token，无需手动操作
- 所有步骤都有验证检查，确保配置成功
已测试工程：
- ✅ XW_SUPF_5_1_11_2（PCF "qqq"）
- ✅ XW_SUPF_5_1_8_1（PCF "pcc"）
- ✅ XW_SUPF_5_1_4_1（PCF "pcc"）
PCF/PCRF 字段
| 字段名 | 说明 | 示例值 |
|---|---|---|
http2_sip | HTTP2 服务 IP | 192.168.20.90 |
http2_port | HTTP2 端口 | 80 |
MCC | MCC（大写） | 460 |
MNC | MNC（大写） | 01 |
count | 实例数量 | 1 |
Version tags
latest