将 Yeastar P-Series Software Edition 连接到 IllyVoIP
在 Yeastar P-Series 中创建注册中继、授权分机并配置来电，正确区分中继类型。
本指南适用于 Yeastar P-Series Software Edition。Appliance 和 Cloud 版本的菜单及功能可能不同，请查阅对应手册。从一个分机和一个中继开始，不要用整套配置模板替换办公室现有的正常配置。
开始前
本例使用密码认证线路。在 SIP Lines 获取 SIP 用户名、密码、服务器、目标端口和传输。不要用门户邮箱或密码。现有线路使用 IP 认证时，先检查依赖设备再考虑切换。
需要管理员权限、私人配置备份及可用内部分机。IllyVoIP SIP 线路连接 PBX 与 IllyVoIP；分机连接员工电话与 PBX，两者不是同一账户。
从一个测试分机和受控目标开始，不要立即迁移全办公室。PBX 已承载通话时，测试结束前保留原路由。
1. 选择 Register Trunk，而不是 Account Trunk
打开 Extension and Trunk → Trunk → Add，为连接命名并启用。如果没有经过验证的 IllyVoIP 专用模板，请选择 General ITSP。此密码认证连接应选择 Register Trunk。Account Trunk 的方向相反：由其他设备向 Yeastar 注册。选择它不会让 Yeastar 向 IllyVoIP 注册。
| 字段 | 使用值 |
|---|---|
| Hostname/IP / Port | IllyVoIP SIP 服务器和目标端口 |
| Username | 线路的 SIP 用户名 |
| Authentication Name | 线路的 SIP 认证标识 |
| Password | SIP 密码 |
| Domain | 提供的 SIP 域名；如未单独指定域名，请按中继指南操作 |
| Transport | 此连接支持的传输协议 |
保存并应用中继配置，然后检查注册状态。仅在连接需要时添加出站代理，不要使用厂商手册中的示例凭据。IP 认证属于另一套对等中继配置，不能通过删除本配置中的密码来实现。
2. 建立受控的出站路由
打开 Call Control → Outbound Route 并添加路由。选择 IllyVoIP 中继和所需号码模式，初始只授权测试分机。检查默认路由及此前匹配的规则；范围过大的规则可能优先匹配，或允许超出预期的目的地。
Pattern 决定匹配哪些号码，Strip 删除开头的数字，Prepend 在前面添加数字。保存前写出一个实例。如果用户已拨国家代码，不要重复添加；如果使用外线接入码，只删除该接入码。测试后再添加确实获授权的分机和目的地模式。
3. 确定来电去向
在 IllyVoIP 中将已激活号码路由到此 SIP 线路，然后打开 Call Control → Inbound Route，选择中继，匹配所需 DID 标识并指定已知的内部目的地。先用一个分机测试，简单路径正常后再加营业时间或 IVR。
DID 模式匹配被叫号码，Caller ID 模式匹配来电者。要选择入站 DID 时，不要把公司号码填进主叫过滤器。如果默认 IVR 接听而非分机，请先检查路由匹配和时间条件，不要先改凭据。
4. 逐项检查主叫号码覆盖设置
中继、路由或分机都可能影响建议使用的出站主叫号码。先使用 IllyVoIP 线路允许的号码，避免多个互相冲突的覆盖设置。Yeastar 的设置无法授予 IllyVoIP 账户或套餐未允许的权限。号码不对时，应对比分机、路由和中继选项，而不是用电话号码替换认证用户名。
5. 有条理地处理部分成功的情况
如果中继已注册但分机无法拨号，检查该分机的路由权限、匹配模式和中继顺序。如果来电到达 Yeastar 却去了错误目的地，检查入站匹配和营业时间规则。如果 IllyVoIP 拒绝呼叫，记下时间和响应，并与 Portal 历史记录对照。
保留原有中继及路由设置记录，一次只测试一项修改。营业时间内，不要在未确认所有使用者的情况下删除正常的默认路由。使用测试路由和单个测试分机，可以建立新连接而不改变其他办公电话的行为。
音频、主叫号码和安全
SIP 传输与媒体加密独立。门户音频模式需匹配 PBX；RTP、SDES-SRTP、DTLS-SRTP 不可互换。不要同时修改传输、编解码器和网络，以免无法判断哪个变更修复或破坏连接。
仅使用账户允许的呼出主叫号码。填入 PBX 不代表已验证。禁止匿名入站访问公开呼出路由，不要关闭防火墙。需要源 IP 限制时向支持取得当前允许地址，不要猜测。
员工使用前验收
- 分别检查中继和测试电话分机注册。
- 从指定分机呼叫并确认所用中继。先查余额和费率，测试可能收费。
- 检查双向音频和对方看到的号码，在获授权菜单测试按键。
- 对呼入，将活动 IllyVoIP 号码路由到 PBX SIP 线路，从外部拨打并确认内部目标。
- 确认无权限分机不能使用测试路由，然后再扩大员工访问。
记录时间、时区、分机、路由及公开通话编号。失败时连同 PBX 型号/版本交支持。SIP 响应码指南有助于描述错误，不要公开密码或未脱敏日志。
本指南依据官方文档和门户流程，不表示所有 PBX 版本都经过真实通话测试。紧急服务和特殊设备需独立配置及验证。