如何在 XSwitch 中添加分机？

XSwitch创建分机主要有3种核心方式，可根据需要创建分机数量（单个/批量）、操作习惯进行灵活选择，以下是详细操作步骤：

1. 访问XSwitch Web管理界面，默认地址：https://demo.xswitch.cn/

2. 使用管理员账号（默认admin）登录，确保拥有“用户”和“分机”模块的操作权限

3. 确认分机所属用户已创建（若未创建，可先新建用户）

适用于少量单个分机配置，或需要连续号段的批量分机创建，操作便捷，无需额外准备。

1. 进入分机管理入口：登录后，点击左侧菜单【用户→分机】，进入分机列表页面。

2. 选择创建模式：

   • 单个创建：点击页面右上角【新建】→ 选择【创建】，进入单个分机配置页。

   • 批量创建：点击页面右上角【新建】→ 选择【批量创建】，进入批量配置页。

3. 填写配置信息（必填项标红，建议补充可选项提升可用性）：

   • 单个创建必填项：名称（分机备注，如“前台-座机”）、号码（分机号，仅数字/字母，如1001）、密码（分机注册密码，建议设置强密码）、呼叫源（默认选择分机context-1）、所属用户（选择已创建的用户，如admin）。

   • 批量创建必填项：起始号码、结束号码（生成连续号段，如1001-1050）、密码、呼叫源（默认选择分机context-1）、所属用户（选择已创建的用户，如admin）。

4. 提交完成：填写完成后，点击【提交】，分机自动创建成功，可在分机列表查看。

适用于大批量分机创建（如几十、上百部），效率高，可提前整理分机信息，避免重复操作。

1. 进入导入入口：在分机列表页面，点击右上角【导入】按钮，弹出导入弹窗。

2. 获取模板：点击弹窗中的【导出模板】，下载系统默认的分机导入表格（Excel格式），模板已包含必填字段（分机号、密码、所属用户等）。

3. 填写模板：按照模板规范填写分机信息，确保字段格式正确（如分机号仅数字/字母，密码长度符合要求），避免填写错误导致导入失败。

4. 上传导入：将填写完成的表格保存，点击【选择文件】，上传表格，确认信息无误后，点击【导入】，系统自动批量创建分机，导入完成后会提示成功数量。

适用于“一个用户对应多个分机”的场景（如员工一人多设备，需要多个分机关联同一用户），直接绑定所属用户，无需后续调整归属。

1. 进入用户详情页：点击左侧菜单【用户】，找到目标用户，点击用户名称进入详情界面。

2. 新建分机：在用户详情页，找到【分机】模块，点击【添加分机】，进入分机配置页。

3. 填写配置：与“单个创建”一致，填写分机名称、号码、密码等必填项，所属用户默认绑定当前用户，无需修改。

4. 提交完成：点击【提交】，分机创建成功，自动归属当前用户，可在用户详情页或分机列表查看。

分机创建后，可通过软电话/硬件话机注册，验证是否可用：

1. 注册信息配置（以SIP话机为例）：

   • 服务器地址：XSwitch服务器IP或域名

   • 端口：默认5060（UDP/TCP协议，需确保防火墙放行该端口）

   • 用户名：创建的分机号（如1001）

   • 密码：创建分机时设置的密码

2. 测试通话：注册成功后，拨打XSwitch默认回声测试号码9196，若能听到自己的回声，说明分机注册正常，可正常通话。

1. 分机无法注册：检查分机密码是否正确、服务器IP/端口是否填写无误、防火墙是否放行5060端口、所属用户状态是否正常。

2. 批量导入失败：检查表格格式是否与模板一致、必填字段是否填写完整、分机号是否重复（系统不允许重复分机号）。

• 分机号建议设置为简洁易记的数字（如1001-1999），避免使用特殊字符，便于后续管理和拨号。

• 分机密码建议设置强密码（字母+数字+特殊字符），防止非法注册和盗用。

• 大批量分机创建后，建议批量导出分机列表，备份分机信息，便于后续维护