RustPBX 概览
RustPBX 是为语音 AI、呼叫中心与企业通信场景打造的云原生 PBX。它以 Rust 编写，强调稳定、低延迟与可观察性，并通过模块化设计支持快速按需扩展。本篇概览帮助你在动手部署前掌握整体能力与子模块定位。
平台定位
- 一体化语音平面：集成 SIP 信令、媒体代理、通话记录、计费与权限控制。
- 可编排架构：配置和业务逻辑通过 TOML/数据库抽象，便于在 DevOps、GitOps 场景中管理。
- AI 友好：内置
llm/、addons/等目录，可叠加语音机器人、批量外呼等能力。
（此处可放“系统概览”示意图）
核心模块映射
| 目录/模块 | 主要能力 |
|---|---|
src/call/ | 呼叫控制、IVR、策略与用户态会话管理 |
src/proxy/ | SIP 代理、ACL、活跃通话注册表 |
src/models/ | 计费、路由、队列、分机等数据库实体定义 |
src/console/ | Web 控制台 API、鉴权与中间件 |
config/ | 运行时配置（Trunk、Routes、Queue、ACL 等） |
addons/ | 批发线路、ACME 证书等可选插件 |
典型工作流
- 准备环境：部署 RustPBX（容器或裸机），完成基础配置（见《基础配置》）。
- 搭建线路：创建 SIP Trunk、路由和计费模板（详见《路由、Trunk 与计费》）。
- 分发话务：配置分机、队列、策略，联动企业账号体系（见《分机管理》）。
- 监控与诊断：通过 Diagnostics、日志、外部监控确认健康状况（见《诊断工具》与《运维手册》）。
- 持续运维：按需编辑
config.toml启用高级功能，结合故障排查指南（见《运维手册》《故障排查》）。
文档导览
- 《基础配置》：部署、初始化、首个 Trunk。
- 《路由、Trunk 与计费》：线路策略的核心实践。
- 《分机管理》：坐席、设备与限额配置。
- 《诊断工具》：Reload、健康检查、日志排查。
- 《运维手册》：日常操作、发布、备份、合规。
- 《技术规格》：兼容性、性能指标、平台边界。
- 《故障排查》：常见异常与处理步骤。
阅读顺序可按业务成熟度逐步深入，亦可按需跳转到具体章节。