OmniSS7 - 用户指南

OmniSS7 由 Omnitouch 网络服务提供，是一个全面的通用 SS7 信令栈，提供灵活的网络元素功能。

路由概述

文档概述

本文档按网络元素角色组织。选择与您的部署匹配的指南：

📚 配置指南

STP 指南 - 信号转移点配置
- 在网络对等体之间路由 SS7 流量
- 点码和全球标题路由
- 负载均衡和拓扑隐藏
- 如果您在网络之间路由 SS7 流量，请使用此指南
MAP 客户端指南 - MAP 客户端配置
- 作为 M3UA 客户端连接以发送 MAP 请求
- HLR 查询、身份验证、路由信息
- 通用 MAP 协议支持
- 如果您向网络元素发送 MAP 请求，请使用此指南
短信中心指南 - 短信中心 (SMSc) 配置
- 短信消息路由和投递
- 基于数据库的消息排队
- 自动刷新和投递报告
- 如果您正在运营短信中心，请使用此指南
HLR 指南 - 家庭位置寄存器配置
- 订阅者数据库管理
- 身份验证向量生成
- 位置更新和路由信息
- 如果您正在运营 HLR/HSS，请使用此指南
CAMEL 网关指南 - CAMEL 网关配置
- 智能网络服务 (CAP/CAMEL)
- 实时呼叫控制和计费
- OCS 集成以进行计费
- 交互式请求构建器和会话监控
- 如果您提供 IN 服务或实时计费，请使用此指南

🔧 常见功能

常见功能指南 - 共享组件
- Web UI 概述和配置
- API 文档
- 监控和指标 (Prometheus)
- 最佳实践和故障排除

📖 参考文档

附录 - 技术参考
- SS7 协议规范
- MAP 操作码
- TCAP 事务流
- 字符编码和格式

快速开始

1. 系统概述

OmniSS7 可以根据您的网络需求以不同模式运行：

3. 配置

OmniSS7 可以在 5 种不同的操作模式下运行。配置文件 config/runtime.exs 包含完整的、可直接使用的示例。

切换模式：

打开 config/runtime.exs
取消注释您所需的配置部分（STP、HLR、SMSc 或 CAMEL GW）
注释掉其他部分
根据需要更新 IP 地址和 API URL
重启应用程序

→ 请参阅下面的特定模式指南以获取完整的配置说明

runtime.exs 中的示例配置：

STP 模式：

config :omniss7,
  map_client_enabled: true,
  hlr_mode_enabled: false,
  smsc_mode_enabled: false,
  camelgw_mode_enabled: false,
  map_client_m3ua: %{...}

HLR 模式：

config :omniss7,
  map_client_enabled: false,
  hlr_mode_enabled: true,
  smsc_mode_enabled: false,
  camelgw_mode_enabled: false,
  hlr_api_base_url: "...",
  map_client_m3ua: %{...}

SMSc 模式：

config :omniss7,
  map_client_enabled: true,
  hlr_mode_enabled: false,
  smsc_mode_enabled: true,
  camelgw_mode_enabled: false,
  smsc_api_base_url: "...",
  auto_flush_enabled: true,
  map_client_m3ua: %{...}

CAMEL 网关模式：

config :omniss7,
  cap_client_enabled: true,
  camelgw_mode_enabled: true,
  ocs_enabled: true,
  ocs_url: "http://your-ocs-server/api/charging",
  cap_version: :v2,  # CAP 版本: :v1, :v2, :v3, 或 :v4
  cap_client_m3ua: %{...}

4. 访问 Web UI

导航到 http://localhost（或您配置的主机名）

系统架构

功能矩阵

功能	STP 模式	MAP 客户端	SMSc 模式	HLR 模式	CAMEL GW
点码路由	✅	❌	❌	❌	❌
全球标题路由	✅	❌	❌	❌	❌
SSN 重写	✅	❌	❌	❌	❌
多对等体支持	✅	✅	✅	✅	✅
MAP 请求（发送）	❌	✅	✅	✅	❌
MAP 响应（接收）	❌	✅	✅	✅	❌
短信队列管理	❌	❌	✅	❌	❌
自动刷新短信	❌	❌	✅	❌	❌
订阅者数据库	❌	❌	❌	✅	❌
身份验证向量	❌	❌	❌	✅	❌
位��更新	❌	❌	❌	✅	❌
CAP/CAMEL 支持	❌	❌	❌	❌	✅
实时计费	❌	❌	❌	❌	✅
呼叫控制（IN 服务）	❌	❌	❌	❌	✅
Web UI	✅	✅	✅	✅	✅
REST API	✅	✅	✅	✅	✅
Prometheus 指标	✅	✅	✅	✅	✅

常见操作

Web UI 访问

URL: http://localhost（或配置的主机名）
Swagger API: http://localhost/swagger
指标: http://localhost/metrics

监控

# 检查 M3UA 对等体状态
curl http://localhost/api/m3ua-status

# 查看 Prometheus 指标
curl http://localhost/metrics

# 检查应用程序健康
curl http://localhost/api/health

日志

# 在 config/runtime.exs 中配置日志级别
config :logger,
  level: :debug  # 选项: :debug, :info, :warning, :error

关键能力

完整的 MAP 协议支持 - MAP 第 2/3 阶段操作
CAP/CAMEL 协议支持 - CAP v1/v2/v3/v4 用于智能网络服务
M3UA/SCTP 信令 - 基于 IP 的 SS7 传输
实时计费 - OCS 集成以进行预付费/后付费计费
实时消息队列 - 基于数据库的 SMS 投递
交互式请求构建器 - 用于 CAMEL/CAP 测试的 Web UI
会话监控 - 实时 CAMEL 呼叫会话跟踪
交互式 API 文档 - 用于测试的 Swagger UI
Prometheus 指标 - 完整的可观察性
多角色配置 - STP、MAP 客户端、SMSc、HLR、CAMEL 网关

协议栈概述

用例示例

网络网关 (STP)

在不同移动网络之间路由 SS7 流量

连接运营商网络
国际 SS7 网关
HLR 之间的负载均衡
全球标题转换
SCCP NAT（智能全球标题重用）
→ STP 指南

短信中心 (SMSc)

��短信消息投递给移动用户

MT-SMS 投递
MO-SMS 发起
短信家庭路由
IMSI 隐藏
短信防火墙
消息队列管理
投递报告
集成到 OmniMessage 中以处理所有 MAP 短信
→ 短信中心指南

MAP 客户端

通过简单的 RESTful API 与任何网络元素交互

PRN / SRI / ATI / 等
使用 RESTful API 构建自己的 SS7/MAP 应用程序
USSD 网关
身份验证向量请求
IMSI/MSISDN 查询
路由信息查询
→ MAP 客户端指南

订阅者数据库 (HLR)

管理订阅者数据和身份验证

位置更新
身份验证生成
路由信息提供
完全集成到 OmniHSS 中
→ HLR 指南

智能网络平台 (CAMEL 网关)

为电信运营商提供实时呼叫控制和计费

预付费/后付费呼叫计费
呼叫控制（连接、释放、路由）
会话管理和 CDR 生成
测试的交互式请求构建器
→ CAMEL 网关指南

支持和资源

文档

核心配置指南：

STP 配置指南 - 信号转移点路由
MAP 客户端配置指南 - MAP 协议客户端
短信中心配置指南 - 短信��由和投递
HLR 配置指南 - 订阅者数据库
CAMEL 网关配置指南 - 智能网络与计费

集成与参考：

CAMEL 请求构建器指南 - 交互式测试工具
常见功能指南 - 共享组件与 Web UI
技术参考 - 协议规范

联系信息

产品： OmniSS7
制造商： Omnitouch 网络服务
文档版本： 2.0
最后更新： 2025

如需技术支持、实施协助或销售咨询，请联系 Omnitouch 网络服务。

本文件涵盖 OmniSS7 运行时操作和最终用户功能。如需安装、开发或高级配置，请参阅技术文档。

文档概述​

📚 配置指南​

🔧 常见功能​

📖 参考文档​

快速开始​

1. 系统概述​

3. 配置​

4. 访问 Web UI​

系统架构​

功能矩阵​

常见操作​

Web UI 访问​

监控​

日志​

关键能力​

协议栈概述​

用例示例​

网络网关 (STP)​

短信中心 (SMSc)​

MAP 客户端​

订阅者数据库 (HLR)​

智能网络平台 (CAMEL 网关)​

支持和资源​

文档​

联系信息​