OmniWeb 操作指南
OmniWeb 是 Omnitouch 的统一网络管理门户，适用于整个移动核心网络。它是一个单一的界面，提供实时监控、配置、协议追踪、日志分析、仪表板和每个网络功能 (NF) 的软件生命周期管理，包括 EPC、IMS、CS Core、5G Core、SS7、消息传递、计费以及支持它们的基础设施。
操作员不需要分别登录十几个元素 CLI、Grafana、Loki 和 Homer，而是打开 OmniWeb，可以：
- 通过交互式拓扑图和每个元素的健康状况一目了然地查看整个网络。
- 通过一个一致的用户界面查看、编辑和更改 NF 设置 — 在 SMSC 中添加路由、在 HSS 中配置用户、在 UPF 中清除会话。
- 观看任何元素的实时结构化日志并**��踪整个网络中的单个用户**（Diameter、GTP-C、PFCP、SIP、MAP）。
- 打开嵌入式 Grafana 仪表板和统计信息，无需离开门户。
- 管理整个网络中的软件版本和生命周期。
每个网络功能都通过相同的模式进行操作。本指南记录了这些通用模式 — 它们适用于每个 NF。
OmniWeb 的拓扑视图 — 跨 EPC、IMS、CS Core 和 5G Core 的单一视图。活动元素可点击，直接进入其管理页面。
由于 OmniWeb 消耗网络自身的信令遥测，它可以实时重建单个用户的呼叫流程 — 无需上传数据包捕获 — 并将其绘制为跨越每个接触到它的元素的时间顺序梯形图：
会话追踪实时流 — 一个用户的 LTE 附着直接从网络的信令遥测重建，相关 S1AP、Diameter S6a 和 GTP-C 在 eNodeB、MME、HSS、SGW-C 和 PGW-C 上的一个梯形图。点击任何消息以查看其解码和十六进制。请参见 日志与用户追踪���
文档地图
从这里开始
- 架构 — OmniWeb 的工作原理：SPA、后端代理、配置模型，以及它如何与每个 NF、Loki 和 Grafana 通信。
- 常见操作 — 每个元素共享的模式：如何查看、编辑和更改 NF 设置；如何读取日志；轮询、配置查看和 RBAC 的行为。阅读一次，适用于所有地方。
可观察性与故障排除
- Grafana 仪表板与统计信息 — 嵌入式仪表板、元素统计和警报。
- 日志与用户追踪 — 实时 Loki 结构化日志、跨网络会话追踪（跟踪单个用户的端到端）和 Homer SIP 捕获。
- Homer — SIP 捕获 — 嵌入式、自动认证的 Homer SIP 捕获 UI：搜索捕获的 SIP 并重建呼叫的信令梯形图；它与会话追踪的区别。
- 网络拓扑 — 单一视图的拓扑视图和基础设施主机列表。
平台
- API 参考 (OpenAPI / Swagger) — 浏览并尝试控制器 REST API，位于
/api/docs；OpenAPI 规范位于/api/openapi.json。 - 软件管理 — 版本控制、APT 存储库和软件生命周期。
- 测试设备 — 远程控制连接 ADB 的手机；拨打电话、发送短信，并运行导出到 Prometheus 的计划 VoLTE / 信号 / 连接性测试。
- RAN 模拟器 — 启动虚拟 eNodeB 和 UE，以在没有硬件的情况下测试实时核心：附着、数据会话、IMS 注册与小区位置、短信/电话、故障场景和负载测试 — 可通过测试设备驱动。
- 网络测试 (负载测试) — 从自注册生成器在核心驱动 Diameter (Seagull) 和 SIP/IMS (SIPp) 负载：设置速率、逐步增加、暂停/排空/停止每个生成器或整个池，带有实时对等 CPU 指标。
- 5G 核心 — 5GC 控制平面的每个 NF 仪表板 (NRF、AMF、SMF、UDM/UDR、AUSF、PCF、CHF、NSSF、BSF、SCP)：健康状况、注册、UE 上下文、PDU 会话、SMF IP 池和状态清除操作。
- 站点编辑器 — 在语法高亮的查看器中读取每个站点的原始配置文件（元素、主机、
fivegc、监控）；OmniWeb 从中派生每个站点的真实来源。 - OmniRoam — 漫游测试自动化 — 自动对实时网络运行 GSMA 漫游测试书（IR.38、IR.48、VoLTE），捕获通过/失败及证据，安排例行运��，并导出完成的 GSMA 工作簿。链接到 测试书、运行测试、测试书浏览器 和 完成的文档。
- OmniRoam — 漫游协议与电子邮件自动化 — OmniRoam 的商业/供应侧：转发合作伙伴电子邮件，OmniRoam 提取事实，创建或更新协议，生成并电子签名 AA.12/AA.13/CLL/TCC/TNS 文档，归档并通过 webhook + 电子邮件通知分配人提出工作订单。
- SIM 银行 — 分布式库存，包含所有代理中每个读卡器的每个 SIM — 以读卡器为中心，具有卡片存在、身份和每个插槽的文件系统/APDU 工具。
- SIM 卡工具 — 低级别的每卡工具，可以通过任何代理上的任何读卡器访问：SIM 文件系统浏览器（浏览/编辑/解码 EFs）、APDU 终端（发送原始 APDU，单次或状态会话）、APDU 日志（实时调制解调器↔SIM 跟踪）和 eSIM（eUICC）配置管理。
- 远程 SIM 和虚拟 SIM — 通过卡片仿真器在网络上将任何 SIM 提供给任何调制解调器，并仿真一个虚拟 SIM（保存的映像 + HSS 密钥），使调制解调器作为您没有物理卡的用户附着。
- OTA SIM 管理 — 通过安全的 (03.48 / SCP80) RFM/RAM 数据包空中读取和编辑远程 SIM 的文件 — 在主机上的读卡器、远程代理或 SMPP 到现场 SIM — 以及可重用的安全配置文件和分发活动。
- 身份验证与访问控制 — 访问控制模型概述，链接到：
- 登录与 JWT 会话 — 登录流程、令牌生命周期、单次登录跨栈。
- 基于角色的访问控制 — 每个元素、每个方法的权限和执行。
- SSH 密钥登录 — 中央主机 SSH 访问，密钥从 OmniWeb 实时提供。
- 审计日志 — 门户、SSH 登录和命令审计。
一览架构
每个来自浏览器的请求都携带一个 JWT。后端验证它，检查目标元素和 HTTP 方法的基于角色的权限，然后将调用转发（代理）到元素自己的管理 API。Grafana、Loki 和 Homer 通过相同的认证网关访问，因此单个 OmniWeb 登录管理整个堆栈。有关完整细节，请参见 架构。
支持的网络功能
OmniWeb 管理 Omnitouch 核心中的每个功能。它们都通过 常见操作 中描述的相同通用模式进行管理 — 这是可以管理的功能清单，而不是每个元素的手册。
| 域 | 网络功能 |
|---|---|
| EPC | HSS、MME、SGW-C、PGW-C / SMF、UPF |
| 5G 核心 | AMF、SMF、UDM、UDR、AUSF、PCF、NSSF、BSF、SCP、CHF、NRF |
| IMS | P-CSCF、I-CSCF、S-CSCF、TAS、ePDG、授权 (OmniSEP) |
| CS 核心与 SS7 | MSC、STP、HLR、CAMEL 网关 |
| 消息传递 | SMSC、SMPP 网关、IP-SM-GW、DRA |
| 位置 | LCS (OmniLCS) |
| 计费与访问 | OCS、TWAG、RAN 监控、许可证服务器 |
| 暴露与物联网 | SCEF (OmniSCEF) |
添加这些中的任何一个实例仅是配置更改 — 请参见 配置模型。OmniWeb 的部署和配置通过 Ansible 管理；请勿直接在主机上编辑配置文件。当存在多个相同类型的实例时，OmniWeb 提供每个实例的下拉菜单和聚合状态的整体视图 — 请参见 多实例与整体视图。
您可以使用 OmniWeb 做什么
以下每个任务都使用相同的通用机制，记录在 常见操作。
| 目标 | OmniWeb 中的位置 | 工作原理 |
|---|---|---|
| 获取网络范围的概述 | 拓扑视图 (EPC / IMS / CS Core / 5GC) | 拓扑 |
| 配置或编辑用户 | 元素 → 数据选项卡 → 添加/编辑表单 | 编辑与更改 NF 设置 |
| 添加或更改路由 | 元素 → 路由 → 添加/编辑表单 | 编辑与更改 NF 设置 |
| 清除/释放会话或呼叫 | 元素 → 会话/呼叫 → 操作 | 运行操作 |
| 阅读配置（隐藏机密） | 元素 → 配置 | 查看配置 |
| 观看元素的实时日志 | 元素 → 日志 | 日志与追踪 |
| 在网络中跟踪一个用户 | 会话追踪 → 搜索 IMSI/MSISDN | 日志与追踪 |
| 详细分析 SIP/VoIP 呼叫流程 | Homer / SIP 捕获（侧边栏，自动检测） | Homer |
| 检查 5GC 网络功能 | 5G 核心 → NF 仪表板 | 5G 核心 |
| 对核心进行负载测试 (Diameter / SIP) | 网络测试 | 网络测试 |
| 浏览或编辑卡的文件系统 / 发��原始 APDU | SIMs → SIM 文件系统 / APDU 终端 | SIM 卡工具 |
| 管理 eSIM 配置在 eUICC 上 | SIMs → eSIM (LPA) | SIM 卡工具 |
| 阅读站点的原始配置 | 站点编辑器 | 站点编辑器 |
| 查看仪表板与统计信息 | 元素 → 仪表板，或 Grafana 侧边栏 | Grafana |
| 管理软件版本 | 软件 | 软件管理 |
| 在远程站点测试真实手机 | 测试设备 → 车队 / 控制台 | 测试设备 |
| 运行 GSMA 漫游测试书 | 漫游测试 → 测试书 | OmniRoam |
| 通过空中读取或编辑 SIM 的文件 | SIMs → OTA | OTA SIM 管理 |
| 管理用户与权限 | 设置 → 权限 | 身份验证 |
实时轮询（适用于所有地方）
所有操作页面都在可配置的间隔内自动刷新。每个页面标题中的轮询指示器显示：
- 轮询是否处于活动状态（绿色点）或已暂停。
- 轮询间隔（通常为 5 秒；可通过
pollIntervalMs针对每个元素进行配置）。 - 当前是否正在进行抓取（旋转图标）。
- 上次成功更新的时间戳。
可以在每个页面上切��轮询的开启或关闭。一些页面 — 交互式控制台和诊断工具 — 不会自动轮询，需要手动刷新。轮询行为在 常见操作 中记录一次。