ls /usr/local/freeswitch/bin/
freeswitch fs_cli fs_ivrd fsxs switch_eavesdrop
freeswitch-license-validator fs_encode fs_tts gentls_cert tone2wav
以下是 /usr/local/freeswitch/bin/
目录中各个文件的详细解释:
1. freeswitch
- 作用:FreeSWITCH 的核心可执行程序,负责启动和管理 VoIP 服务。
- 用途:
- 启动 FreeSWITCH 服务:
./freeswitch -nc
(非控制台模式)。 - 处理呼叫路由、媒体流、模块加载等核心功能。
- 启动 FreeSWITCH 服务:
2. fs_cli
- 作用:FreeSWITCH 命令行接口工具,用于与运行中的 FreeSWITCH 实例交互。
- 用途:
- 执行实时命令(如查看通话状态、管理会话):
fs_cli -x "show calls"
。 - 调试和监控系统运行状态。
- 执行实时命令(如查看通话状态、管理会话):
3. fs_ivrd
- 作用:IVR(交互式语音应答)守护进程(旧版本或自定义工具)。
- 用途:
- 独立处理 IVR 逻辑(如语音菜单导航)。
- 注:现代 FreeSWITCH 中 IVR 通常由
mod_ivr
模块直接处理,无需单独守护进程。
4. fsxs
- 作用:FreeSWITCH 扩展脚本工具(FreeSWITCH eXtension Script)。
- 用途:
- 运行自定义脚本(如 Lua、JavaScript)以扩展功能。
- 示例:
fsxs myscript.lua
执行 Lua 脚本。
5. switch_eavesdrop
- 作用:通话监听工具,用于实时监听通话的媒体流。
- 用途:
- 监控指定通话的语音内容:
switch_eavesdrop <call_uuid>
。 - 常用于调试或合规性录音。
- 监控指定通话的语音内容:
6. freeswitch-license-validator
- 作用:验证 FreeSWITCH 许可证的工具(通常用于企业版)。
- 用途:
- 检查许可证的有效性和授权功能。
- 示例:
freeswitch-license-validator --check
。
7. fs_encode
- 作用:音频编码转换工具,用于转码音频文件格式。
- 用途:
- 将音频文件转换为不同编码(如 WAV → MP3):
fs_encode input.wav output.mp3
。 - 支持格式:WAV、MP3、OGG 等。
- 将音频文件转换为不同编码(如 WAV → MP3):
8. fs_tts
- 作用:文本转语音(TTS)工具,生成语音文件。
- 用途:
- 将文本转换为语音文件:
fs_tts "Hello World" output.wav
。 - 依赖 TTS 引擎(如 Flite、Google TTS)。
- 将文本转换为语音文件:
9. gentls_cert
- 作用:生成 TLS/SSL 证书的工具。
- 用途:
- 创建自签名证书:
gentls_cert -cn freeswitch.example.com
。 - 用于加密 SIP(SIPS)或 WebSocket(WSS)通信。
- 创建自签名证书:
10. tone2wav
- 作用:生成电话系统音调(如拨号音、忙音)的 WAV 文件。
- 用途:
- 生成自定义信号音:
tone2wav -t dialtone -o dialtone.wav
。 - 支持音调类型:拨号音、忙音、回铃音等。
- 生成自定义信号音:
总结表格
文件 | 功能 | 常用命令示例 |
---|---|---|
freeswitch | 核心服务启动 | ./freeswitch -nc |
fs_cli | 命令行交互工具 | fs_cli -x "status" |
fs_ivrd | IVR 守护进程(旧版) | 已逐渐弃用 |
fsxs | 扩展脚本执行工具 | fsxs script.lua |
switch_eavesdrop | 通话监听工具 | switch_eavesdrop <uuid> |
freeswitch-license-validator | 许可证验证工具 | freeswitch-license-validator --check |
fs_encode | 音频转码工具 | fs_encode input.wav output.mp3 |
fs_tts | 文本转语音工具 | fs_tts "Hello" output.wav |
gentls_cert | 生成 TLS 证书工具 | gentls_cert -cn yourdomain.com |
tone2wav | 生成电话信号音 WAV 文件 | tone2wav -t busy -o busy.wav |
注意事项
- 权限管理:部分工具(如
gentls_cert
)可能需要sudo
权限。 - 依赖项:确保相关模块(如 TTS、编码器)已安装并配置。