跳到主要内容

Omnitouch IMS 应用服务器

IMS 应用服务器提供全面的电话应用服务,包括呼叫路由、附加服务、在线计费和用户管理。

快速链接​

操作与监控​

配置​

  • 配置指南 - Event Socket、控制面板、API、SIP 中继和 Diameter 的完整配置参考
  • Sh 接口 - 从 HSS/存储库检索用户数据
  • 存储库数据块 - 以拨号计划变量形式暴露的每个文档 RepositoryData (MMTel, ODB, 自定义)
  • 在线计费 (Ro) - OCS 集成和信用控制
  • SS7 MAP - 用于漫游和呼叫转移的 HLR 查询

呼叫路由与服务​

  • 拨号计划配置 - XML 拨号计划基础、变量和呼叫路由逻辑
  • 号码翻译 - E.164 标准化和特定国家的翻译
  • 附加服务 - 呼叫转移、CLI 阻止和紧急呼叫
  • SRVCC - 单一无线语音呼叫连续性:STN-SR 前缀方案和 PS 到 CS 会话转移
  • 语音邮件 - 语音邮件(存储/检索)带 SMS 通知、个人问候、消息转发、保留/过期和多 TAS 联合邮箱
  • TTS 提示 - 提示音频在部署时由 Omnicore Ansible 剧本生成;OmniTAS 仅播放它

合规性​

呼叫处理概述​

功能概述​

核心功能​

  • 符合 IMS 的呼叫处理 - 完整的 3GPP IMS 应用服务器功能
  • Diameter 集成 - Sh (用户数据) 和 Ro (在线计费) 接口
  • SIP 中继管理 - 支持多个网关,带监控和故障转移
  • 呼叫路由 - 灵活的基于 XML 的拨号计划,支持全面的变量
  • 号码翻译 - 针对多个国家的 E.164 标准化 (AU, US, PF,可扩展)

附加服务​

  • 呼叫转移 - 所有变体 (CFA, CFB, CFNRy, CFNRc) 支持 MMTel-配置
  • CLI 阻止 - 基于前缀和 SIP 头的来电号码隐藏
  • 紧���呼叫 - 专用路由紧急服务,绕过 OCS
  • 语音邮件 - 完整的语音邮件服务:存储、检索、SMS 通知、个人问候、转发、过期和多 TAS 联合邮箱
  • IMS 会议 - 符合 3GPP 标准的多方会议 (RFC 4579, RFC 4575)

监控与操作​

  • 控制面板 Web UI - 综合监控界面 (HTTPS 端口 443)
    • 实时用户注册
    • 带高级搜索和过滤的呼叫详细记录
    • 活跃呼叫监控
    • 网关和 Diameter 对等状态
    • 系统日志和指标
    • 测试工具 (Sh, OCS, HLR, 号码翻译, 呼叫模拟器)
  • REST API - 开放的 API,带 OpenAPI/Swagger 文档 (端口 8444)
  • Prometheus 指标 - 在 3 个端点上提供广泛的指标 (9094, 9090, 9093)

集成点​

  • HSS/存储库 (Sh) - 用户配置文件和 MMTel-配置检索
  • OCS (Ro) - 实时信用控制,带定期重新授权
  • HLR (SS7 MAP) - 漫游用户的 MSRN 检索
  • 短信中心 - 语音邮件和未接来电通知
  • OpenAI TTS - 动态提示生成
  • SBCs/网关 - 支持多个 SIP 中继

快速开始​

配置结构​

配置文件​

所有配置位于 config/runtime.exs:

# 事件套接字 - 呼叫控制接口
config :tas,
fs_event_socket: %{
host: "127.0.0.1",
port: 8021,
secret: "YourSecretPassword"
}

# 呼叫路由的允许源 IP
config :tas,
allowed_sbc_source_ips: ["10.5.198.200"],
allowed_cscf_ips: ["10.8.3.34"]

# 号码翻译
config :tas,
number_translate: %{
country_code: :AU, # :AU, :US, :PF
localAreaCode: "617"
}

# 在线���费
config :tas,
online_charging: %{
enabled: true,
periodic_ccr_time_seconds: 10,
schedule_hangup_auth: false,
skipped_regex: ["^2222", "^911"] # 对于这些目的地绕过 OCS
}

# 紧急呼叫
config :tas,
emergency_call_codes: ["911", "112", "000", "sos"]

# 语音邮件 (ESL 驱动的存储 + 检索)
config :tas,
voicemail: %{
timezone: "UTC",
say_language: "fr",
storage_dir: "/usr/local/freeswitch/storage/voicemail",
# 此处省略提示 (语音提示通过 :prompts 生成 TTS);出站套接字,
# 记录和菜单默认在代码中 - 请参见语音邮件文档
# prompts: %{...},
smsc: %{
smsc_url: "https://10.80.14.219:8443",
source_msisdn: "2222"
}
}

请参阅 语音邮件 指南以获取完整的配置和流程,以及 配置指南 以获取完整的参数参考。

监控与访问架构​

访问点​

  • 控制面板: https://your-server-ip/ (在 config/runtime.exs 中配置)
  • REST API: https://your-server-ip:8444/api/swaggerui
  • Prometheus 指标:
    • http://your-server-ip:9094/metrics (TAS 引擎, Diameter, OCS, HLR)
    • http://your-server-ip:9090/metrics (系统, 网关, 电话核心)
    • http://your-server-ip:9093/esl?module=default (RTP/RTCP 媒体质量)

拨号计划模板​

拨号计划 XML 模板位于 priv/templates/:

  • mo_dialplan.xml - 移动发起呼叫
  • mt_dialplan.xml - 移动终止呼叫
  • mo_emergency_dialplan.xml - 紧急呼叫

请参阅 拨号计划配置 以获取详细的拨号计划文档。

文档结构​

本 README 提供了高层次的概述。详细文档按主题组织:

按角色​

操作员与管理员:

  1. 从 操作指南 开始,了解监控和日常任务
  2. 查看 指标参考 以设置监控和警报
  3. 在 https://your-server-ip/ 使用控制面板进行操作任务

系统集成商与工程师:

  1. 从 配置指南 开始,进行系统设置
  2. 查看 拨号计划配置 以了解呼叫路由逻辑
  3. 配置接口: Sh 接口、在线计费、SS7 MAP
  4. 实施服务: 附加服务、语音邮件

开发者:

  1. 查看 REST API 文档 (OpenAPI/Swagger)
  2. 查看 指标参考 以了解 Prometheus 集成
  3. 查看 配置指南 以获取 API 配置

按主题​

呼叫处理:

用户数据:

系统配置:

增值服务:

系统要求​

要求​

  • Elixir/OTP 运行时
  • PostgreSQL 或 SQLite 用于 CDR 存储
  • 访问 IMS 核心 (S-CSCF)
  • 网络连接到:
    • DRA/HSS (Diameter: Sh 和可选的 Ro)
    • SIP 网关/SBC
    • 可选:SS7 MAP 网关、短信中心、OpenAI TTS API

支持与文档​

  • 问题与功能请求:联系您的集成工程师
  • 指标与监控:请参见 docs/metrics.md
  • API 文档:访问 Swagger UI 在 https://your-server-ip:8444/api/swaggerui
  • 控制面板:访问在 https://your-server-ip/

许可证​

专有 - Omnitouch 系统