FreeSWITCH
时间: 2025-07-10 17:48:56 浏览: 13
### FreeSWITCH 下载、安装教程及使用文档
#### 一、下载 FreeSWITCH
FreeSWITCH 是一款开源的电信级软交换平台,支持多种协议和功能扩展。其官方 GitHub 仓库提供了最新的源码版本供开发者下载。
可以通过以下命令克隆 FreeSWITCH 的最新源代码:
```bash
git clone https://github.com/freeswitch/freeswitch.git
cd freeswitch
```
此操作会将 FreeSWITCH 的完整源代码拉取到本地环境[^1]。
---
#### 二、安装依赖项
在安装 FreeSWITCH 前,需先完成必要的依赖库安装。由于较新的 FreeSWITCH 版本已经将 Sofia-SIP 和 SpanDSP 移至独立仓库中,因此需要分别编译并安装这些组件:
##### 安装 Sofia-SIP
Sofia-SIP 是一个 SIP 协议栈实现,用于处理信令通信。
```bash
git clone https://github.com/freeswitch/sofia-sip.git
cd sofia-sip
./bootstrap.sh && ./configure && make install
cd ..
```
##### 安装 SpanDSP
SpanDSP 提供了音频信号处理的功能模块。
```bash
git clone https://github.com/freeswitch/spandsp.git
cd spandsp
./bootstrap.sh && ./configure && make install
cd ..
```
以上步骤完成后即可继续安装 FreeSWITCH 主体程序[^1]。
---
#### 三、编译与安装 FreeSWITCH
进入 FreeSWITCH 源代码目录后执行如下命令进行编译和安装:
```bash
./bootstrap.sh
./configure
make
make install
make sounds-install
make moh-install
```
- `make`:编译核心程序及其模块;
- `make install`:将可执行文件复制到系统指定位置;
- `make sounds-install`:安装默认的声音文件;
- `make moh-install`:安装音乐等待(Music On Hold)文件[^2]。
---
#### 四、启动 FreeSWITCH
FreeSWITCH 的启动脚本通常位于 `src/` 目录下,名为 `freeswitch.sh` 或者直接通过 `freeswitch` 可执行文件运行。以下是两种常见的启动方式:
##### 使用 Shell 脚本启动
```bash
./src/freeswitch.sh
```
##### 使用可执行文件启动
```bash
/usr/local/freeswitch/bin/freeswitch
```
如果一切正常,终端将会显示日志信息表明服务已成功启动[^2]。
---
#### 五、配置 FreeSWITCH
FreeSWITCH 配置文件主要存储于 `/usr/local/freeswitch/conf/` 文件夹内,其中重要的几个子目录包括但不限于:
- **autoload_configs/**:自动加载的全局参数设置;
- **dialplan/default.xml**:拨号计划定义,默认呼叫流程逻辑;
- **sip_profiles/internal.xml**:内部 SIP 用户账户管理;
修改配置前建议备份原始文件以防误改影响正常使用[^2]。
---
#### 六、获取更多学习资料
对于初学者而言,除了阅读官方文档外还可以参考社区贡献的技术博客或书籍来加深理解。推荐访问官方网站以及查阅《FreeSWITCH Cookbook》这类权威指南获得更深入的知识体系构建帮助。
官网地址链接为 [https://freeswitch.org](https://freeswitch.org),这里不仅有详细的 API 描述还有活跃的支持论坛可以交流经验心得[^1]。
---
阅读全文
相关推荐

















