jambonz/sbc-call-router

sbc-call-router

镜像概述和主要用途

sbc-call-router 是一个基于 express.js 框架开发的 Web 回调服务，主要用途是将 SIP INVITE 请求路由至 sbc-inbound 或 sbc-outbound 应用。其核心功能是根据呼叫源地址的网络归属（是否属于配置的内部网络），自动区分入站和出站呼叫，并将请求转发至对应的处理服务。

核心功能和特性

核心功能

• INVITE 请求路由：根据呼叫源地址判断请求类型（入站/出站），将内部网络发起的呼叫路由至 sbc-outbound 应用，外部网络发起的呼叫路由至 sbc-inbound 应用。
• 基于 CIDR 的网络判断：通过配置内部网络 CIDR（无类别域间路由）规则，精确识别源地址是否属于内部网络，作为路由决策的核心依据。

特性

• 轻量级架构：基于 express.js 框架开发，具备高效、轻量的特点，适合处理高频 SIP 呼叫请求。
• 环境变量配置：支持通过环境变量灵活配置服务参数（如监听端口、路由目标 URL 等），无需修改代码即可调整服务行为。
• 云原生适配：支持 Kubernetes 环境部署（通过 K8S 环境变量标识），适应容器化和云原生架构需求。

使用场景和适用范围

使用场景

• SBC 系统呼叫分类：在会话边界控制器（SBC）系统中，对 SIP INVITE 呼叫请求进行入站/出站分类，确保内部呼叫和外部呼叫被路由至对应的处理模块（sbc-inbound/sbc-outbound）。
• VoIP 服务流量管理：在 VoIP 服务架构中，通过区分呼叫来源（内部/外部网络）优化流量分配，提升呼叫处理效率。

适用范围

• 企业通信系统、VoIP 服务提供商、IP-PBX 系统等使用 SBC 组件的通信架构。
• 需要对 SIP 呼叫请求进行网络来源区分和定向路由的场景。

使用方法和配置说明

部署示例

Docker 命令部署

通过 docker run 快速启动服务，需指定必填环境变量（如 JAMBONES_NETWORK_CIDR）：

bash
docker run -d \
  --name sbc-call-router \
  -p 3000:3000 \  # 映射容器端口（默认使用 express 端口，如未指定 HTTP_PORT 则为 3000）
  -e HTTP_PORT=3000 \  # 可选，服务监听端口
  -e JAMBONES_NETWORK_CIDR="192.168.1.0/24,10.0.0.0/8" \  # 必填，内部网络 CIDR（支持多 CIDR，逗号分隔）
  -e JAMBONES_LOGLEVEL="info" \  # 可选，日志级别（debug/info/warn/error）
  -e JAMBONES_INBOUND_ROUTE="http://sbc-inbound:3001" \  # 可选，入站呼叫路由 URL
  -e JAMBONES_OUTBOUND_ROUTE="http://sbc-outbound:3002" \  # 可选，出站呼叫路由 URL
  -e K8S=false \  # 可选，是否在 Kubernetes 中运行（默认 false）
  sbc-call-router:latest

Docker Compose 部署

创建 docker-compose.yml 配置文件，定义服务及环境变量：

yaml
version: '3'
services:
  sbc-call-router:
    image: sbc-call-router:latest
    container_name: sbc-call-router
    ports:
      - "3000:3000"  # 端口映射（主机端口:容器端口）
    environment:
      - HTTP_PORT=3000  # 服务监听端口（可选）
      - JAMBONES_NETWORK_CIDR=192.168.1.0/24,10.0.0.0/8  # 必填，内部网络 CIDR
      - JAMBONES_LOGLEVEL=info  # 日志级别（可选）
      - JAMBONZ_TAGGED_INBOUND=  # 标记入站请求（可选，需结合业务逻辑使用）
      - JAMBONES_INBOUND_ROUTE=http://sbc-inbound:3001  # 入站路由 URL（可选）
      - JAMBONES_OUTBOUND_ROUTE=http://sbc-outbound:3002  # 出站路由 URL（可选）
      - K8S=false  # 是否在 Kubernetes 中运行（可选，默认 false）
    restart: unless-stopped  # 自动重启策略

环境变量配置说明

服务所有配置通过环境变量实现，具体参数说明如下：

补充说明：

• JAMBONES_NETWORK_CIDR 为必填项，支持配置多个 CIDR（用逗号分隔），例如 "192.168.1.0/24,10.0.0.0/8"。
• 如未指定 HTTP_PORT，服务默认使用 express.js 框架的默认端口（通常为 3000）。
• K8S 变量用于标识服务是否运行在 Kubernetes 环境，可能影响服务发现或网络配置（具体逻辑需结合服务内部实现）。