在 FreePBX 配置 IllyVoIP PJSIP 中继
配置中继、限制呼出测试路由，并将来电发送到正确分机或振铃组。
用于 FreePBX 17 PJSIP。模块版本可能改变标签，请按安装版本。不要将旧 chan_sip peer 或注册字符串填入 PJSIP。这是连接 IllyVoIP 的中继，不是桌面电话分机。
开始前
本例使用密码认证线路。在 SIP Lines 获取 SIP 用户名、密码、服务器、目标端口和传输。不要用门户邮箱或密码。现有线路使用 IP 认证时，先检查依赖设备再考虑切换。
需要管理员权限、私人配置备份及可用内部分机。IllyVoIP SIP 线路连接 PBX 与 IllyVoIP；分机连接员工电话与 PBX，两者不是同一账户。
从一个测试分机和受控目标开始，不要立即迁移全办公室。PBX 已承载通话时，测试结束前保留原路由。
1. 添加 PJSIP 中继
在 Connectivity → Trunks 添加 SIP/PJSIP 中继，命名清楚并填写线路资料。密码注册流程选择呼出认证和发送注册（若有选项），不要选 IP/无注册方案。
| 字段 | 使用值 |
|---|---|
| Username / Auth Username | 线路 SIP 用户和认证身份 |
| Secret | SIP 密码 |
| SIP Server / SIP Server Port | 提供的服务器和目标端口 |
| Transport | 匹配的已配置 PJSIP 传输 |
| Context | 外部呼入处理，通常 from-trunk 而非 from-internal |
| Codecs | 仅双方支持的编解码器，并保持媒体加密一致 |
提交后使用 Apply Config。现有 PBX 请在正常变更时段并保留备份。不要手改生成文件，后续 GUI 变更可能覆盖。
2. 小范围呼出测试路由
打开 Connectivity → Outbound Routes，创建明确测试路由并在中继顺序选 IllyVoIP。先测试号码，再加需要的模式。检查顺序：前面的匹配路由可能用其他中继，看起来像忽略新中继。
检查每次数字转换。仅去掉接入前缀，不要误删国家代码；已是国际号码时不要重复添加国家代码。记录拨号/发送示例并对照 CDR。
3. 限制谁能使用
使用安装提供的分机/路由控制，有些依赖模块。命名 Test 不代表私有。不要让外部呼入进入 from-internal 暴露内部功能和外线。主叫号码匹配不能代替源安全。
4. 添加呼入路由
将活动号码路由到中继线路。在 Connectivity → Inbound Routes 匹配实际收到的被叫标识，选已知分机或组。DID 是被叫号码，CallerID 是主叫，两种筛选不同。
未知格式不要用无限制 catch-all 当永久修复。一个号码成功另一个失败时对照收到标识和门户目标。不要为单个中继测试移动所有号码。
5. 排查失败阶段
- 未注册：检查凭据、认证/注册方向和服务器/传输。
- 已注册但无通话使用：检查呼出模式、转换、权限和顺序。
- 到达但不响：检查 DID 匹配及分机状态。
- 单向音频：检查网络和媒体，不仅是密码。
管理员有 CLI 时，pjsip show registrations 是只读检查。FreePBX 和门户 CDR 可确认路由。不要因一条路由故障，用旧完整备份覆盖无关近期变更。
音频、主叫号码和安全
SIP 传输与媒体加密独立。门户音频模式需匹配 PBX；RTP、SDES-SRTP、DTLS-SRTP 不可互换。不要同时修改传输、编解码器和网络，以免无法判断哪个变更修复或破坏连接。
仅使用账户允许的呼出主叫号码。填入 PBX 不代表已验证。禁止匿名入站访问公开呼出路由，不要关闭防火墙。需要源 IP 限制时向支持取得当前允许地址，不要猜测。
员工使用前验收
- 分别检查中继和测试电话分机注册。
- 从指定分机呼叫并确认所用中继。先查余额和费率，测试可能收费。
- 检查双向音频和对方看到的号码，在获授权菜单测试按键。
- 对呼入，将活动 IllyVoIP 号码路由到 PBX SIP 线路，从外部拨打并确认内部目标。
- 确认无权限分机不能使用测试路由，然后再扩大员工访问。
记录时间、时区、分机、路由及公开通话编号。失败时连同 PBX 型号/版本交支持。SIP 响应码指南有助于描述错误，不要公开密码或未脱敏日志。
本指南依据官方文档和门户流程，不表示所有 PBX 版本都经过真实通话测试。紧急服务和特殊设备需独立配置及验证。