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 并重建呼叫的信令梯形图；它与会话追踪的不同之处。
- 呼叫追踪 (SIP 追踪) - 搜索录制的呼叫，打开具有每条腿语音质量（MOS）和抖动的完整呼叫详情，跟踪 IMS 中的多跳 SIP 梯形图，查看 QoS 图，收听录制的音频，下载 PCAP，并观看实时呼叫和捕获代理的健康状态。由 IMS 元素上的捆绑数据包捕获代理提供支持。
- 网络拓扑 — 单一视窗的拓扑视图和基础设施主机列表。
- 配置归档 - 设备配置备份：路由器通过 FTP 将自己的导出推送到 OmniWeb，归档保持每个版本可搜索、可排序和可比较。
平台
- API 参考 (OpenAPI / Swagger) — 浏览并尝试控制器 REST API，位于
/api/docs；OpenAPI 规范位于/api/openapi.json。 - 软件管理 — 版本控制、APT 仓库和软件生命周期。
- 测试设备 — 远程控制连接到 ADB 的手机；拨打电话、发送短信，并运行导出到 Prometheus 的计划 VoLTE / 信号 / 连接测试。
- RAN 模拟器 — 启动虚拟 eNodeB 和 UE，以在没有硬件的情况下测试实时核心：附着、数据会话、带有小区位置的 IMS 注册、SMS/呼叫、故障场景和负载测试 — 可通过测试设备驱动。
- 网络测试 (负载测试) — 使用 RAN 模拟器在实时核心上驱动合成信令负载：附着、数据会话和 IMS 注册，按需或按计划运行，结果导出到 Prometheus。
- 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 文件系统浏览器（浏览/编辑/解码 EF）、APDU 终端（发送原始 APDU，单次或状态会话）、APDU 日志（实时调制解调器↔SIM 跟踪）和 eSIM（eUICC）配置管理。
- SIM 工具包 (STK) — 交互式 STK 小程序客户端。导航运营商菜单，触发 SIM 上的服务，并在连接的读卡器中的任何卡上驱动主动命令。
- 远程 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 Core & 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 |
| 检查呼叫的语音质量（MOS）或收听它 | 会话追踪 → 呼叫追踪 → 打开呼叫 | 呼叫追踪 |
| 检查 5GC 网络功能 | 5G Core → NF 仪表板 | 5G 核心 |
| 对核心进行负载测试（Diameter / SIP） | 网络测试 | 网络测试 |
| 浏览或编辑卡的文件系统/发送原始 APDU | SIMs → SIM 文件系统 / APDU 终端 | SIM 卡工具 |
| 在 SIM 小程序上导航 STK 菜单 | SIMs → SIM 工具包 | SIM 工具包 |
| 管理 eSIM 配置 | SIMs → eSIM (LPA) | SIM 卡工具 |
| 读取站点的原始配置 | 站点编辑器 | 站点编辑器 |
| 查看仪表板与统计信息 | 元素 → 仪表板，或 Grafana 侧边栏 | Grafana |
| 管理软件版本 | 软件 | 软件管理 |
| 在远程站点测试真实手机 | 测试设备 → 舰队 / 控制台 | 测试设备 |
| 运行 GSMA 漫游测试手册 | 漫游测试 → 测试手册 | OmniRoam |
| 通过空中读取或编辑 SIM 的文件 | SIMs → OTA | OTA SIM 管理 |
| 管理用户与权限 | 设置 → 权限 | 身份验证 |
实时轮询（适用于所有地方）
所有操作页面在可配置的间隔内自动刷新。每个页面标题中的 轮询指示器 显示：
- 轮询是否处于活动状态（绿色点）或已暂停。
- 轮询间隔（通常为 5 秒；可通过
pollIntervalMs针对每个元素进行配置）。 - 当前是否正在进行数据获取（旋转器）。
- 上次成功更新的时间戳。
可以在每个页面上切换轮询的开启或关闭。有些页面 — 交互式控制台和诊断工具 — 不会自动轮询，需要手动刷新。轮询行为在 常见操作 中记录一次。