HowTo文档
XSwitch 如何对接 RustPBX?
顾名思义,RustPBX 是一个用 Rust 写的 PBX 软件。RustPBX 支持 SIP 和 WebRTC,可以与 XSwitch 对接。
静态配置
RustPBX 支持很多配置方式,默认支持通过 .toml 配置文件静态配置以及通过 Web 控制台配置到数据库中。
添加分机
与 XSwitch 类似,RustPBX 中的 SIP 账号也叫分机。添加一个分机即可用 SIP 终端注册。
添加中继路由
如果要将呼叫转接到 XSwitch,则需要在 RustPBX 中添加一个中继和路由(需要重载),添加完成后,就可以呼叫 XSwitch 了,具体可以参见 RustPBX 的文档。
XSwitch 呼叫 RustPBX
在 XSwitch 中添加一条路由,目的地是 ”IP地址” 或 “网关”,指向 RustPBX 的 SIP 地址即可。如果上面的步骤中在 RustPBX 中添加的中继是“双向”的,则 RustPBX 可以自动认出呼叫来源,并将电话送入路由。
动态配置
RustPBX 有自己的 Web 控制台,不过,很多配置都需要理解正则表达式,对于一般的管理员可能有些困难。但 RustPBX 支持强大的基于 API 的动态配置能力,可以通过 HTTP 方式获取配置信息(类似于 XSwitch 中的 mod_xml_curl)。
为了能支持动态配置,我们在配置文件中增加如下配置:
[proxy.http_router] # 动态路由 url = "http://localhost:8081/api/rustpbx/route" headers = { Authorization = "Bearer 01a1ef48-a45b-7d88-a9e5-0dde4cd28098" } fallback_to_static = true timeout_ms = 500 [[proxy.user_backends]] # 用户注册 type = "http" url = "http://localhost:8081/api/rustpbx/verify" method = "POST" # GET 则为 ?username=1001&realm=example.com headers = { Authorization = "Bearer 01a1ef48-a45b-7d88-a9e5-0dde4cd28098" }
是的,添加上述配置并重启后,在有SIP分机向 RustPBX 发起注册请求,或者发起呼叫时,RustPBX 都会请求上述 url。上述 URL 是在 XSwitch 中实现的(使用时注意修改主机名或IP)。你只需要在 XSwitch 中按正常的方式添加“分机”或“路由”,就可以影响上述 RustPBX 的请求。这样,XSwitch 的 Web UI(XUI)就成了 RustPBX 的控制台。当然,刚开始,XSwitch 支持的路由目的地类型还有限(目前仅支持 "IP 地址“)类型,后面,如果有需求,可以扩充。
其他
RustPBX 默认的配置文件将近 1000 行,对于初学者而言有点困难。不过,话说回来,FreeSWITCH 默认的配置文件也不下上百个 XML,配置项也很多。当然,区别是,我们已经很熟悉 FreeSWITCH 的配置了。而且,我们的 XSwitch Web UI 也已经能配置绝大部分参数了。
实验下来,RustPBX 中大部分功能在 XSwitch 中都能实现,我们暂时不知道在什么场景下会用到 RustPBX,但现在,是一个用 Rust 重写一切的时代,RustPBX 值得一试。XSwitch 是一个连接一切的平台,自然可以连接 RustPBX,何况 XSwitch 还能配置 RustPBX 呢 :D。XSwitch 使用 LPM(Longest Prefix Match,最大前缀匹配)方法配置路由,比 RustPBX 的正则表达式方式更易用易学。