本指南介绍如何从 X-Lite 迁移到 Bria Solo。Bria 通过自己的账户和网页门户将语音配置下发到应用，而不是像旧版 X-Lite 那样直接在账户窗口中填写全部参数。
以下步骤适用于使用密码认证的 IllyVoIP SIP 线路。Bria 许可证与 IllyVoIP 通话服务相互独立。请确认当前 Bria 套餐和支持的平台，不要假定原有 X-Lite 使用权会自动转移。
1. 保存现有可用配置
记录 SIP 用户名、服务器、传输协议以及有意设置的代理和音频参数。确认哪个呼入号码指向该线路，以及是否有其他设备共用账户。密码应安全保存，不要放在未受保护的截图中。从 IllyVoIP 获取当前参数，并在新客户端通过测试前保留旧配置。
测试时关闭 X-Lite，避免它争抢注册或接听本应到达 Bria 的电话。如果使用公司管理的 PBX，请向管理员索取分机配置。PBX 分机账户不同于运营商中继账户，未经管理员指示不要在个人客户端中使用中继密码。
2. 获取 SIP 线路资料
- 打开 Services → SIP Lines 并选择目标线路。
- 确认密码认证方式，获取 SIP 用户名和 SIP 密码。
- 展开 Technical endpoints，记录区域服务器主机名、目标端口及传输协议。
- 检查音频加密模式、允许使用的主叫号码、账户验证要求，以及余额或通话套餐。
- 如果需要接听电话，确认哪个有效号码路由到该 SIP 线路。
不要改变现有 IP 认证中继的预定工作模式。本指南应使用合适的密码认证身份。创建或修改线路的门户流程和相关条件见 管理 SIP 线路。
3. 区分账户登录与 SIP 注册
| 登录位置 | 应使用的凭据 |
|---|---|
| IllyVoIP 门户 | 用于管理服务的 IllyVoIP 账户。 |
| Bria Portal 和 Bria 应用 | Bria 账户的邮箱和密码，以及要求的验证或 MFA。 |
| Bria 内的 IllyVoIP 语音账户 | 所选线路的 SIP 用户名和 SIP 密码。 |
成功登录 Bria 并不代表语音账户已完成注册。应用可以正常打开，但尚不能拨打电话。
4. 创建 Bria 账户并配置语音服务
按照 Bria Solo 官方入门指南 操作并使用 Bria Solo 门户。验证邮箱，打开控制面板，然后依提示设置语音账户。完成要求的 MFA，并安全保存恢复方式。
如果没有合适的预设，请选择自定义 SIP 配置。可用选项取决于当前套餐和界面：
- Service label：使用易识别的名称，例如 IllyVoIP。
- Domain / SIP server：填写 Technical endpoints 中当前的区域主机名，不带 https:// 或网页路径。
- Port：填写与传输协议匹配的目标端口；明确要求端口时不要依赖 Auto。
- SIP username / extension：填写 SIP 用户名，不是门户邮箱或呼入号码。
- Password：填写线路的 SIP 密码。
- Authorization username：填写该线路提供的认证身份，通常是 SIP 用户名。
- Transport：选择匹配且受支持的 UDP、TCP 或 TLS。
- Registration：为此密码认证配置启用注册。
保存配置。不要仅因为示例中存在就添加出站代理、STUN 服务器或语音信箱号码；只使用实际服务提供的参数。Bria 参考文档也涉及 Teams，但团队邀请和账户分配不是 Solo 的额外要求。
5. 在首次通话前匹配音频安全设置
SIP 传输与音频加密是独立选项。让 Bria 的 SRTP 设置匹配 IllyVoIP 线路的音频模式。对于 SDES-SRTP，确认客户端和所选配置支持该方法；仅选择 TLS 并不代表音频配置已完成。
Bria 语音服务设置参考 介绍了与 TLS 关联的 SRTP 选项。如果您的套餐或界面中没有所需选项，请先与支持团队确定受支持的配置，再修改正在使用的线路。保持证书验证开启。显示名称字段不能绕过 IllyVoIP 主叫号码验证。
使用双方支持的音频编码和 DTMF 方式。出现问题时每次只改一个设置并记录结果。不要照搬其他运营商示例中的编码列表或防火墙端口。
6. 安装并登录 Bria 客户端
- 通过 Bria 控制面板或设备应用商店的官方链接下载客户端。
- 在受支持的系统上安装，并允许麦克风访问。
- 使用 Bria 邮箱和密码登录，不使用 IllyVoIP SIP 凭据。
- 等待保存的语音配置加载。如果更改没有出现，按 Bria 提示重启或退出后重新登录。
- 存在多个账户时，明确选择 IllyVoIP 进行通话。
官方指南描述 Windows/Mac 上显示绿色连接图标，Android/iOS 上显示 Phone Ready。如果能登录但语音账户未注册，请检查 SIP 错误及 Bria Portal 中的语音配置。修改 Bria 登录密码无法纠正错误的 IllyVoIP SIP 密码。
7. 完成迁移测试
- 关闭旧客户端，用要求的国际号码格式拨打一个您控制的号码。可能产生正常通话费用。
- 确认双向音频及获授权的呼出主叫号码。
- 从另一部电话拨打您的 IllyVoIP 呼入号码，确认它指向正确线路且 Bria 响铃。
- 接听并检查两个方向的声音。
- 使用 IVR 时，通过无敏感后果的菜单选项测试按键输入。
- 重启 Bria，确认配置重新加载并再次注册。
在移动设备上，依据 Bria 支持的来电设置，分别测试后台和锁屏状态。在笔记本上测试常用耳机及睡眠/唤醒行为。桌面前台测试不能证明手机后台接听可靠。
仅在测试通过后按组织要求删除或停用旧账户，不要提前丢失唯一可用参考。如果暂时恢复旧客户端，请关闭新客户端并确认来电实际到达哪里。
8. 排查常见问题
- Bria 登录失败：检查账户、邮箱验证、MFA 和许可。
- SIP 注册失败：检查 IllyVoIP 凭据、主机名、目标端口和传输协议。
- 注册成功但呼叫被拒：检查拨号数字、余额/套餐、所选账户及主叫号码规则。
- 只能呼出、无法呼入：检查号码路由、竞争注册、免打扰和转接。
- 接通后无声：检查麦克风权限、音频设备、加密和网络路径。
- 旧参数重新出现：在 Bria Portal 的配置源中修改，然后按要求重新加载客户端。
联系支持时提供 Bria 版本、系统、准确错误、账户、时间及时区和失败的测试。截图中不要包含 SIP/Bria 密码或 MFA 验证码。通过安全支持渠道提供要求的日志。
常见问题解答
可以按旧 X-Lite 截图配置 Bria Solo 吗？
不能用于完整配置。Bria Solo 通过门户和账户登录下发设置，请遵循上面的当前流程。
安装 Bria 会转移我的号码吗？
不会。号码仍保留在原服务中。检查其 IllyVoIP 路由目标，并在 Bria 配置相应的 SIP 线路。
X-Lite 和 Bria 可以同时保持注册吗？
共用一个身份不保证同时响铃。先测试一个客户端，并在同时启用两者之前确定预期的多设备使用方式。