分机管理

分机（Extension）是 RustPBX 中连接坐席、终端或机器人实例的核心对象。本节介绍如何创建、批量维护与保护分机。

1. 分机模型

• 基础字段：号码、显示名称、所属部门、SIP 密码/证书。
• 策略字段：并发限制、呼出权限、媒体参数（DTMF、RTP 端口、编解码）。
• 关联对象：可绑定队列、计费模板、频率限制（models/frequency_limit.rs）。

（此处可插入「分机列表」截图）

2. 新建分机

1. 打开控制台「Extensions → 创建」。
2. 填写基本信息，并选择认证方式：
   • 密码认证：系统生成或手动输入强密码。
   • 证书认证：与 WebRTC 客户端配合使用。
3. 配置呼叫权限：可启用黑白名单、国际/国内拨号策略。
4. 保存后，下载或复制配置给坐席设备。

文件/脚本方式

若需批量导入，可使用 API 或在数据库层按 models/extension.rs 结构写入，并触发缓存刷新。

3. 注册与设备

• SIP 软终端：输入服务器地址、分机号、密码，启用 TLS/SRTP 时需导入证书。
• 硬件话机：通过 Auto Provision 模板或手工配置，建议限制 IP 范围。
• WebRTC 客户端：使用 static/phone_jssip.html 或 phone_sipjs.html 示例，依靠浏览器与 PBX 建立安全通道。

（此处可插入「WebRTC 电话」截图）

4. 安全与限额

• 频率限制：在 models/frequency_limit.rs 中定义规则，通过控制台关联到分机，防止暴力呼叫。
• ACL：结合 config/acl/，控制分机可访问的 IP/网段。
• 登录告警：在 Diagnostics 中开启登录失败告警，异常增多时自动封锁源 IP。

5. 运维动作

任务	建议做法
密码轮换	每季度批量重置一次，可使用 API 脚本自动化
状态检查	Diagnostics → SIP 注册面板，筛选长期离线的分机
批量升级	借助设备厂商的 Provision 服务器，修改模板后让终端自动重启获取配置
停用/离职	在分机详情中一键禁用，必要时撤销队列/技能组绑定

6. 常见问题

• 注册不上：检查密码、SIP 代理端口、设备时间与 TLS 证书；或是否被 ACL 拦截。
• 呼叫失败：确认路由动作中已允许该分机呼出；检查频率限制是否触发。
• 音质差：调低编解码复杂度，或在分机侧开启 QoS；必要时切换媒体服务器区域。

通过以上实践可以确保分机安全可控，并与路由/队列协同工作。