如何在CentOS7上编译安装FreeSWITCH并避坑？

在开源通信领域，FreeSWITCH 以其强大的功能、灵活的架构和卓越的稳定性，成为构建语音、视频和即时消息应用的理想选择，而 CentOS 7 作为一款广受赞誉的企业级 Linux 发行版，以其长期支持和稳定性，为运行 FreeSWITCH 提供了坚实的基础，本文将详细介绍如何在 CentOS 7 系统上从源码编译安装 FreeSWITCH，并进行初步的配置与启动,帮助您快速搭建一个功能完备的通信平台。

准备工作

在开始安装之前，确保您的系统满足以下基本条件,并完成必要的初始化设置。

您需要一个拥有 sudo 权限的非 root 用户，或者直接使用 root 用户进行操作，为了保证系统的最新状态和安全,建议执行系统更新：

sudo yum update -y

安装编译过程中必需的开发工具和一些基础软件包：

sudo yum groupinstall -y "Development Tools"
sudo yum install -y git wget ncurses-devel libtiff-devel libxml2-devel lib-devel sqlite-devel libuuid-devel

这些工具和库是 FreeSWITCH 编译和运行所依赖的基础环境,确保它们都已正确安装是成功编译的第一步。

安装 FreeSWITCH

从源码编译安装 FreeSWITCH 能够提供最大的灵活性，允许您根据需求定制模块和功能，整个过程主要包括安装依赖、获取源码、编译和安装几个步骤。

安装编译依赖

FreeSWITCH 的功能模块众多，其依赖也相对复杂，除了基础工具外，还需要安装一些特定的开发库,下表列出了部分关键依赖及其用途：

依赖包名称	主要用途
spandsp-devel	提供传真、DTMF 检测等功能
libpng-devel	用于处理 PNG 图像格式的提示音
opus-devel	提供高质量的 Opus 音频编解码器
libyuv-devel	用于视频处理，特别是 YUV 格式转换
lame-devel	提供 MP3 编码支持

执行以下命令安装这些关键依赖：

sudo yum install -y spandsp-devel libpng-devel opus-devel libyuv-devel lame-devel

获取源码

使用 git 命令从 FreeSWITCH 的官方 GitHub 仓库克隆最新的稳定版源码：

git clone https://github.com/signalwire/freeswitch.git
cd freeswitch

进入源码目录后，建议切换到一个稳定的发布版本标签，而不是直接使用开发分支，以确保系统的稳定性，您可以通过 git tag -l 查看所有可用版本，然后使用 git checkout v1.10.7 （切换到指定版本。

编译与安装

编译过程分为四个核心步骤：

• ：此脚本用于生成 configure 文件，准备编译环境。

  ./bootstrap.sh

• ：此脚本会检查系统环境、依赖库，并根据您的选项生成 Makefile，您可以使用 --help 查看所有可用选项，启用 PostgreSQL 支持可以添加 --enable-core-pgsql-support。

  ./configure --prefix=/usr/local/freeswitch --enable-core-pgsql-support

• 执行 make：这是最耗时的步骤，它会根据 Makefile 编译所有源代码文件。

  make

• ：将编译好的文件、库和配置文件安装到 --prefix 指定的目录中。

  sudo make install

• 安装声音文件：为了让 FreeSWITCH 能够播放默认的提示音和等待音乐，需要安装这些声音资源。

  sudo make sounds-install moh-install

配置与启动

安装完成后，需要进行一些必要的配置才能让 FreeSWITCH 安全、稳定地运行。

创建专用用户

出于安全考虑，不建议以 root 用户身份运行 FreeSWITCH,创建一个专用的系统用户和组：

sudo groupadd freeswitch
sudo useradd -g freeswitch -s /sbin/nologin -d /usr/local/freeswitch -M freeswitch

将 FreeSWITCH 的安装目录所有权赋予新创建的用户：

sudo chown -R freeswitch:freeswitch /usr/local/freeswitch

创建 Systemd 服务

为了方便管理 FreeSWITCH 服务的启动、停止和开机自启，创建一个 systemd 服务单元文件：

sudo vim /etc/systemd/system/freeswitch.service

在文件中填入以下内容：

[Unit]
Description=FreeSWITCH
After=network.target
[Service]
Type=forking
User=freeswitch
Group=freeswitch
WorkingDirectory=/usr/local/freeswitch
PIDFile=/usr/local/freeswitch/run/freeswitch.pid
ExecStart=/usr/local/freeswitch/bin/freeswitch -ncwait -nonat
ExecReload=/bin/kill -HUP $MAINPID
TimeoutSec=60s
Restart=always
[Install]
WantedBy=multi-user.target

保存并退出后，重新加载 systemd 配置，并启动 FreeSWITCH 服务：

sudo systemctl daemon-reload
sudo systemctl start freeswitch
sudo systemctl enable freeswitch

您可以使用 sudo systemctl status freeswitch 来检查服务的运行状态。

验证与防火墙设置

验证安装

连接到 FreeSWITCH 的命令行接口（CLI）是验证其是否正常工作的最佳方式：

/usr/local/freeswitch/bin/fs_cli

成功进入 CLI 后，您会看到 freeswitch@internal> 提示符，输入 status 或 version 命令，如果能看到系统状态和版本信息,则说明安装和启动均已成功。

配置防火墙

FreeSWITCH 默认使用 SIP 端口（5060/UDP）和一系列 RTP 端口进行媒体传输，如果您的系统启用了防火墙（默认启用）,需要开放这些端口。

开放 SIP 端口：

sudo firewall-cmd --permanent --add-port=5060/udp

RTP 端口范围可以在 /usr/local/freeswitch/conf/autoload_configs/switch.conf.xml 文件中查看和修改，默认通常是 16384-32768,开放此范围：

sudo firewall-cmd --permanent --add-port=16384-32768/udp

重新加载防火墙规则使配置生效：

sudo firewall-cmd --reload

至此，您已经在 CentOS 7 上成功部署了一个基础的 FreeSWITCH 实例，您可以根据业务需求，深入探索其丰富的配置文件，添加用户、设置拨号计划,构建强大的通信应用。

---

相关问答FAQs

问题1：如何修改 FreeSWITCH 默认监听的 SIP 端口？

解答： 修改 SIP 端口需要编辑 SIP 配置文件，对于内部网络通信，主要配置文件是 /usr/local/freeswitch/conf/sip_profiles/internal.xml，使用文本编辑器打开此文件，找到类似 <param name="sip-port" value="5060"/> 的行，将 value 的值修改为您想要的端口号，5080，保存文件后，需要在 FreeSWITCH CLI 中执行 reloadxml 命令使配置生效，或者重启 FreeSWITCH 服务，修改端口后,也需要相应地更新防火墙规则。

问题2：FreeSWITCH 启动失败，应该如何排查问题？

解答： FreeSWITCH 启动失败的原因可能有很多,可以按照以下步骤进行系统排查：

1. 查看 Systemd 状态：首先执行 sudo systemctl status freeswitch,这通常会给出最直接的错误信息或失败原因的线索。
2. 查看系统日志：使用 journalctl -u freeswitch -xe 命令，可以查看更详细的 systemd 日志,其中包含了服务启动过程中的标准输出和错误输出。
3. 查看 FreeSWITCH 自身日志：检查 FreeSWITCH 的日志文件 /usr/local/freeswitch/log/freeswitch.log，这是最权威的错误信息来源，日志中通常会明确指出配置文件语法错误、端口被占用、权限不足等问题。
4. 前台模式运行：如果日志信息不够明确，可以尝试以前台模式运行 FreeSWITCH 来实时观察输出，先停止服务 sudo systemctl stop freeswitch，然后以 freeswitch 用户身份执行 /usr/local/freeswitch/bin/freeswitch -nonat -c，这样，所有的启动信息和错误都会直接打印在当前终端上,便于定位问题。