多呼叫中心桥接
语音质量监控方案

部署点与端口

每台 FS 的 mod_sofia 把 SIP 以 HEP3 发往 HOMER；本机 HEPipe 通过回环 ESL 8021 读取 RTCP event，再以 HEP UDP 发往 HOMER。仅允许已知 FS 源访问 9060；UI 8080 与 metrics 9090 只对管理/监控网开放。

FS-A mod_sofia --HEP3/SIP--┐
FS-A ESL:8021 -> HEPipe ---┼--UDP:9060--> HOMER 11
FS-B mod_sofia --HEP3/SIP--┤             ├─ UI :8080
FS-B ESL:8021 -> HEPipe ---┘             └─ metrics :9090

安装正式发行包并核验 SHA-256

官方发布资产 AMD64 deb 的 SHA-256 来自 GitHub Release API；ARM64 包与 hash 见发布页。发行包只放置 homer.json.example，必须复制成真实配置后再启动。

curl -fLO https://github.com/sipcapture/homer/releases/download/11.0.336/homer-core_11.0.336_amd64.deb
echo "ae08448285f31f860f4ed48f8339a79bc2c4ae9c1da9f3d9b74cb4dc4d7708b9  homer-core_11.0.336_amd64.deb" | sha256sum -c -
sudo apt install ./homer-core_11.0.336_amd64.deb
sudo install -m 0600 /usr/local/homer-core/etc/homer.json.example /usr/local/homer-core/etc/homer.json
sudo install -d /data/homer/parquet /var/lib/homer
/usr/local/homer-core/bin/homer version

官方 Docker quick start 约需 8 GB 内存且 Compose 引用 HOMER/RustFS latest 与示例 Token。若走 Docker，先锁镜像 digest、换凭据、限端口，不能直接作为生产清单。

加固 HOMER 配置并首次启动

本文参考配置 下列只是需要覆盖/核对的关键字段，不可直接替换官方完整 JSON。node token 与 coordinator node token 相同；JWT 使用另一随机值；对外访问用防火墙或反向代理。

"ingest": {
  "udp": {"enable": true, "host": "0.0.0.0", "port": 9060},
  "sip": {
    "aleg_ids": ["X-CID", "X-Session-ID"],
    "custom_headers": ["X-Trace-ID"],
    "force_aleg_id": false
  }
},
"node": {"flight_server": {
  "host": "127.0.0.1", "port": 50051,
  "auth_token": "REPLACE_WITH_RANDOM_NODE_TOKEN"
}},
"coordinator": {
  "http_server": {"host": "127.0.0.1", "port": 8080},
  "nodes": [{"name":"local", "host":"127.0.0.1", "port":50051,
             "token":"REPLACE_WITH_THE_SAME_NODE_TOKEN", "priority":1}],
  "jwt": {"secret":"REPLACE_WITH_DIFFERENT_RANDOM_JWT_SECRET", "expire_hours":24}
},
"prometheus": {"enable":true, "host":"127.0.0.1", "port":9090, "path":"/metrics"}

sudo systemctl daemon-reload
sudo systemctl enable --now homer-core
sudo systemctl status homer-core --no-pager
sudo journalctl -u homer-core -b --no-pager | grep bootstrap_password
curl -fsS http://127.0.0.1:9090/metrics | head

首次管理员密码是随机值，只在首次日志写入一次；首次登录后立即更换。不要把日志或 Token 放进报告、截图或前端。

接入 FreeSWITCH 原生 HEP 与 HEPipe RTCP

HOMER Wiki 原始参数 FS-A 使用 capture_id=1001，FS-B 使用 1002；桥接前写 X-cid。配置先在 POC profile 重载，现网 profile 重启会影响通话，必须走维护窗口。

<!-- autoload_configs/sofia.conf.xml -->
<param name="capture-server"
       value="udp:HOMER_MANAGEMENT_IP:9060;hep=3;capture_id=1001"/>

<!-- sip_profiles/internal.xml / external.xml -->
<param name="sip-capture" value="yes"/>

<!-- bridge 之前 -->
<action application="set" data="sip_h_X-cid=${sip_call_id}"/>
<action application="set" data="rtcp_audio_interval_msec=5000"/>

fs_cli -x "sofia global capture on"
fs_cli -x "sofia global capture off"
fs_cli -x "sofia profile internal capture on"
fs_cli -x "sofia profile internal capture off"

HEPipe 固定配置 ESL 必须绑定 127.0.0.1:8021 并更换默认 ClueCon；HEP_ID 与该 FS 的 capture_id 一致。

git clone https://github.com/sipcapture/hepipe.js.git
cd hepipe.js
git checkout --detach 5895a6cb304733e07c518f91612db2181957decb

var config = {
  hep_config: {debug:false, HEP_SERVER:'HOMER_MANAGEMENT_IP', HEP_PORT:9060},
  esl_config: {
    debug:false, ESL_SERVER:'127.0.0.1', ESL_PORT:8021,
    ESL_PASS:'REPLACE_WITH_RANDOM_ESL_PASSWORD', HEP_ID:1001,
    report_call_events:false, report_rtcp_events:true, report_qos_events:false
  }
};
module.exports = config;

docker compose up -d --build
docker compose ps
docker compose logs --tail=100 hepipe

当前 HEPipe 会订阅 ESL ALL；即使只上报 RTCP，也会接收全部事件。HEP 输出为 UDP，无 TLS/确认/独立健康检查，先单节点小流量验证，并置于管理网或 VPN。

验证、故障定位与回滚

1. 确认 9060/8080/9090 的监听与来源限制；短时 tcpdump -ni any udp port 9060 证明 HEP 到达。
2. 发起带已知 X-cid 的测试通话；在 HOMER 用 Call-ID/X-cid 找回两条 B2BUA leg。
3. 确认 HEPipe 出现 ESL ready，HOMER 同时收到 SIP 与 HEP type 5 RTCP。
4. 对 10 正常 + 5 事故样本核对方向、SSRC、时间窗、loss/jitter 与最终录音。