Skill flagged — suspicious patterns detected

ClawHub Security flagged this skill as suspicious. Review the scan results before using.

5GC Automation

v1.0.0

5GC Web仪表自动化技能,支持AMF/UDM/AUSF/SMF/PGW-C/UPF/PGW-U/GNB/UE/PCF/NRF/QoS/TC/PCC/smpolicy的批量添加与编辑及PCF默认规则一键配置

0· 33·0 current·0 all-time

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for liuwei120/5gc-automation.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "5GC Automation" (liuwei120/5gc-automation) from ClawHub.
Skill page: https://clawhub.ai/liuwei120/5gc-automation
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install 5gc-automation

ClawHub CLI

Package manager switcher

npx clawhub@latest install 5gc-automation
Security Scan
VirusTotalVirusTotal
Suspicious
View report →
OpenClawOpenClaw
Benign
medium confidence
Purpose & Capability
Name/description match the included scripts: Playwright-based CLI scripts for adding/editing 5GC web dashboard entities (AMF/UDM/SMF/UPF/PCF/PCC/NRF/QoS/TC/SMPolicy/etc.). The required binaries/env vars are minimal/none and align with a local Node + Playwright automation tool.
Instruction Scope
SKILL.md and scripts instruct the agent to run local Node.js scripts that drive a web UI via Playwright. Scripts read/write a .sessions/ directory (storage state/cookies) and perform UI-level edits on the target dashboard. They include hard-coded default credentials and a default internal URL (https://192.168.3.89). This is expected for an automation skill but is material and should be reviewed before use.
Install Mechanism
No installation spec; the skill is instruction+scripts only. It relies on Playwright/Node being present (the README notes npm i playwright && npx playwright install chromium). There are no external download URLs or archive extraction in the package itself.
Credentials
The skill does not request environment variables or external credentials, but it hard-codes login credentials and a default intranet address in multiple scripts. That is coherent for a demo/setup but is sensitive: you should not assume those defaults are safe in your environment and should replace them with appropriate credentials/URLs before use.
Persistence & Privilege
always:false and no modifications to other skills. The skill stores session state (cookies/storageState) under its .sessions/ directory, giving it persistent access to the target dashboard between runs. Because the platform permits autonomous invocation by default, an agent that calls this skill could perform stateful changes to internal infrastructure — expected for an automation tool, but an operational risk if used with high privileges.
Assessment
This skill appears to do what it claims (browser-driven automation of a 5GC dashboard). Before installing or running it: 1) Review the scripts yourself (they will run locally and control a browser); 2) Replace or remove the hard-coded credentials and default URL — do not run with the embedded dotouch@dotouch.com.cn / dotouch against production; 3) Be aware the skill writes session files (.sessions/) containing authentication state to the skill directory — store them securely or change path/permissions; 4) Install Playwright and test in an isolated environment first (use a lab/test dashboard); 5) Note the browser is launched with --no-sandbox and proxy-bypass flags (helps direct intranet access but reduces sandboxing); if you are concerned about autonomous agents making destructive changes, disable autonomous invocation for this skill or restrict its use to trusted users. If you want a higher assurance level, ask the author for provenance (source repo/homepage) or a minimal version that does not include hardcoded credentials and uses explicit credential inputs.
scripts/5gc.js:179
Shell command execution detected (child_process).
Patterns worth reviewing
These patterns may indicate risky behavior. Check the VirusTotal and OpenClaw results above for context-aware analysis before installing.

Like a lobster shell, security has layers — review code before you run it.

latestvk97ewdd4qtarztwbgx89mcewcx85n5k5
33downloads
0stars
1versions
Updated 21h ago
v1.0.0
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]

支持的网元与操作

entityaddedit特殊操作
amf
udm
smf
upf
gnb
ue
pcfdefault-rule-add
pcc
qos
tc
smpolicyadd-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 信令面 IP200.20.20.1
--ngap_port <端口>NGAP 端口38412
--http2_sip <IP>HTTP2 服务 IP200.20.20.5
--http2_port <端口>HTTP2 端口8080
--stac <值>起始 TAC101
--etac <值>结束 TAC102
--region_id <值>区域 ID1
--set_id <值>Set ID1
--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 服务 IP192.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 信令面 IP200.20.20.25
--http2_sip <IP>HTTP2 服务 IP200.20.20.25
--mcc <值>MCC460
--mnc <值>MNC01
--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 接口 IP192.168.20.30
--n3_ip <IP>N3 接口 IP192.168.20.30
--n6_ip <IP>N6 接口 IP192.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 信令面 IP200.20.20.50
--user_sip_ip_v4 <IP>用户面 IPv42.2.2.2
--mcc <值>MCC460
--mnc <值>MNC60
--stac <值>起始 TAC0
--etac <值>结束 TAC0
--node_id <ID>节点 ID70
--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 <值>MCC460
--mnc <值>MNC01
--key <值>KI 密钥(32位 hex)1111...(32个1)
--opc <值>OPc 密钥(32位 hex)1111...(32个1)
--imeisv <值>IMEISV(偶数位)8611111111111111
--sst <值>NSSAI SST1
--sd <值>NSSAI SD111111
--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_v4user_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 服务 IP192.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-idQoS 模板 IDqos_default_{时间戳}
--5qi5QI 值(不指定则自动选择未使用的值)自动(优先 8/9/6/5...)
--maxbr-ul上行最大比特率10000000
--maxbr-dl下行最大比特率20000000
--gbr-ul上行保证比特率5000000
--gbr-dl下行保证比特率5000000
--tc-idTC 规则 IDtc_default_{时间戳}
--flow-statusTC 流状态ENABLED
--pcc-idPCC 规则 IDpcc_default
--precedencePCC 优先级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-idPCC 规则 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 的 refQosDatarefTcData 存储在 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 服务 IP192.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-idQoS 模板 ID(字母/数字/下划线)必填
--5qi5QI 值(不指定则自动选择)自动选择未使用的值(优先 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-idTC 规则 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
--nameUE策略名称(字母/数字/下划线)必填
--dnnDNN必填
--imsiIMSI 起始值(不填则自动生成)自动
--imsi-numIMSI 数量1
--sstsNssai SST1
--sdsNssai SD111111
--sess-rules会话规则(xm-select,多个逗号分隔)
--pcc-rulesPCC规则(xm-select,多个逗号分隔)
--pra-rulesPRA规则(xm-select,可选)
--ref-qos-timerreflectiveQoSTimer 值(秒)
--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-rulesPCC规则(xm-select,多个逗号分隔)
--pra-rulesPRA规则(xm-select)
--ref-qos-timerreflectiveQoSTimer
--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
--nameDNN策略名称(必填)必填
--dnnDNN值(必填)必填
--sstsNssai SST1
--sdsNssai SD111111
--sess-rules会话规则(xm-select,多个逗号分隔)
--pcc-rulesPCC规则(xm-select,多个逗号分隔)
--pra-rulesPRA规则(xm-select,可选)
--ref-qos-timerreflectiveQoSTimer(秒)
--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-rulesPCC规则(xm-select,多个逗号分隔)
--pra-rulesPRA规则(xm-select)
--ref-qos-timerreflectiveQoSTimer
--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_sipNGAP 信令面 IP10.200.1.50
ngap_portNGAP 端口38412
http2_sipHTTP2 服务 IP10.200.1.51
http2_portHTTP2 端口8080
stac起始 TAC101
etac结束 TAC102
region_id区域 ID1
set_idSet ID1
pointer指针1
ea[NEA0] ~ ea[128-NEA3]加密算法(默认全选)1
ia[NIA0] ~ ia[128-NIA3]完整性保护算法(默认全选)1

UDM/AUSF 字段

字段名说明示例值
count实例数量3
sipSIP 服务 IP10.0.0.100
port端口80
auth_method认证方法5G_AKA
scheme协议类型HTTP
priority优先级8

SMF/PGW-C 字段

字段名说明示例值
pfcp_sipPFCP 信令面 IP10.10.10.50
n3_ipN3 接口 IP10.10.10.50
n6_ipN6 接口 IP10.10.10.51
http2_sipHTTP2 服务 IP10.10.10.50
dnnDNN(数据网络名)internet
snssai_sstNSSAI SST1
snssai_sdNSSAI SDffffff
mccMCC460
mncMNC01
pdu_capacityPDU 会话容量200000

UPF/PGW-U 字段

字段名说明示例值
n3_ipN3 接口 IP192.168.20.30
n4_ipN4 接口 IP(PFCP)192.168.20.30
n6_ipN6 接口 IP192.168.20.31
n6_gwN6 网关 IP192.168.20.1
dnnDNNinternet
static_arp静态 ARP192.168.20.254
sstNSSAI SST1
sdNSSAI SDffffff
stac起始 TAC101
etac结束 TAC102

GNB 字段

字段名说明示例值
ngap_sipNGAP 信令面 IP200.20.20.50
user_sip_ip_v4用户面 IPv42.2.2.2
user_sip_ip_v6用户面 IPv6::1
mccMCC460
mncMNC60
stac起始 TAC0
etac结束 TAC0
node_id节点 ID70
cell_count小区数量1
replay_ip回放 IP0.0.0.0
replay_port回放端口0

UE 字段

字段名说明示例值
s_imsi起始 IMSI(15位)460001234567890
msisdnMSISDN(13-15位,86开头)8613888888888
mccMCC460
mncMNC01
keyKI 密钥(32位 hex)001122...
op_opcOPc 密钥(32位 hex)aabbcc...
imeisvIMEISV(15位,偶数)8611111111111111
nssai_sstNSSAI SST1
nssai_sdNSSAI SD111111
user_sip_ip_v4用户面 IPv4自动分配
user_sip_ip_v6用户面 IPv6自动分配
replay_ip回放 IP0.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-namePCF 实例名称(必填,指定要为哪个 PCF 配置默认规则)
--qos-idQoS 模板 IDqos_default_{时间戳}
--5qi5QI 值(不指定则自动选择未使用的值)自动(优先 8/9/6/5...)
--maxbr-ul上行最大比特率10000000
--maxbr-dl下行最大比特率20000000
--gbr-ul上行保证比特率5000000
--gbr-dl下行保证比特率5000000
--tc-idTC 规则 IDtc_default_{时间戳}
--flow-statusTC 流状态ENABLED
--pcc-idPCC 规则 IDpcc_default
--precedencePCC 优先级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

完整链路

  1. QoS 模板创建:自动选择未使用的 5QI,创建 QoS 模板
  2. Traffic Control 创建:创建 ENABLED 状态的 TC 规则
  3. PCC 规则创建:创建 PCC 规则,绑定 QoS 和 TC
  4. sm_policy_default 创建/更新:创建或更新默认会话策略,绑定 PCC 规则
  5. 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_sipHTTP2 服务 IP192.168.20.90
http2_portHTTP2 端口80
MCCMCC(大写)460
MNCMNC(大写)01
count实例数量1

Comments

Loading comments...