通过 SIP 网关将 FusionPBX 连接到 IllyVoIP
添加网关、选择域和 SIP profile，再配置受控呼出路由及呼入目标。
FusionPBX 将 SIP 服务连接称为 gateway；分机是内部电话的独立对象。本指南依据官方 Gateways/Dialplan，菜单可能因版本不同。假定已有可用系统，不涉及新服务器安装或替换安全配置。
开始前
本例使用密码认证线路。在 SIP Lines 获取 SIP 用户名、密码、服务器、目标端口和传输。不要用门户邮箱或密码。现有线路使用 IP 认证时，先检查依赖设备再考虑切换。
需要管理员权限、私人配置备份及可用内部分机。IllyVoIP SIP 线路连接 PBX 与 IllyVoIP；分机连接员工电话与 PBX，两者不是同一账户。
从一个测试分机和受控目标开始，不要立即迁移全办公室。PBX 已承载通话时，测试结束前保留原路由。
1. 先选择正确域
多租户 PBX 先确认管理域。网关能工作但域错也不正确。确定归属、允许分机及已匹配测试号码的路由，不要为避开域选择而设成全局。
打开 Accounts → Gateways，添加清晰名称，填写 SIP 资料并启用本密码连接的注册。
| 字段 | 使用值 |
|---|---|
| Gateway | 唯一名称，如 illyvoip-office |
| Username / Password | SIP 用户名及密码 |
| Proxy | IllyVoIP SIP 服务器及所需端口 |
| Register / Enabled | 本注册配置为 true |
| Register Transport | 所需传输 |
| Domain / Profile | 目标租户及已启用 profile，非随意默认值 |
2. 理解 profile 和 context
网关运行于 SIP profile。使用正确已启用 profile，将外部呼入保持在 public/incoming context，而非内部呼出。高级 Hostname 可固定到一个 PBX 节点，不是 Proxy 字段；除非集群明确使用，否则留空。
保存并查看注册状态，不要为刷新网关重启承载通话的整个 profile。使用支持的网关管理流程，确认后再配置路由。
3. 创建呼出路由
打开 Dialplan → Outbound Routes，选网关及号码表达式，从窄测试范围开始。检查顺序和捕获号码的转换。网关注册成功也可能被 dialplan 绕过。
记录分机拨号和应发送号码。部分捕获时 bridge 必须使用正确值。不要将北美示例直接用于全球路由。
4. 添加呼入目标
使用 Dialplan → Destinations 添加号码/标识、域和目标动作，可生成呼入路由。先用已知分机或组。确认实际标识，不假设加号格式与门户相同。
保留租户归属和源控制。目标匹配只决定去向，不证明源获授权。不要为一个租户的问题扩大 ACL 或用全局目标。
5. 跟踪通话
呼出失败检查域、表达式和网关；呼入检查是否到达、context 和目标。一个分机成功另一个失败时先比权限/域，别先改共用网关。
使用意外网关时与管理员对照 bridge/gateway 和预期路由。不要新增重复网关来修顺序。保留首次成功基线，每次只扩展一个变更。
音频、主叫号码和安全
SIP 传输与媒体加密独立。门户音频模式需匹配 PBX；RTP、SDES-SRTP、DTLS-SRTP 不可互换。不要同时修改传输、编解码器和网络，以免无法判断哪个变更修复或破坏连接。
仅使用账户允许的呼出主叫号码。填入 PBX 不代表已验证。禁止匿名入站访问公开呼出路由，不要关闭防火墙。需要源 IP 限制时向支持取得当前允许地址，不要猜测。
员工使用前验收
- 分别检查中继和测试电话分机注册。
- 从指定分机呼叫并确认所用中继。先查余额和费率，测试可能收费。
- 检查双向音频和对方看到的号码，在获授权菜单测试按键。
- 对呼入，将活动 IllyVoIP 号码路由到 PBX SIP 线路，从外部拨打并确认内部目标。
- 确认无权限分机不能使用测试路由，然后再扩大员工访问。
记录时间、时区、分机、路由及公开通话编号。失败时连同 PBX 型号/版本交支持。SIP 响应码指南有助于描述错误，不要公开密码或未脱敏日志。
本指南依据官方文档和门户流程，不表示所有 PBX 版本都经过真实通话测试。紧急服务和特殊设备需独立配置及验证。