Ubuntu 20.04安装FreeSWITCH 1.10.7完整指南

1. 环境准备与依赖安装

在Ubuntu 20.04 LTS上安装FreeSWITCH前，需要确保系统环境配置正确。以下是完整的依赖安装步骤：

sudo apt update && sudo apt upgrade -y sudo apt install -y build-essential pkg-config uuid-dev zlib1g-dev libjpeg-dev \ libsqlite3-dev libcurl4-openssl-dev libpcre3-dev libspeexdsp-dev \ libldns-dev libedit-dev libtiff5-dev yasm libopus-dev libsndfile1-dev \ unzip libavformat-dev libswscale-dev libavresample-dev liblua5.2-dev \ liblua5.2-0 cmake libpq-dev unixodbc-dev autoconf automake ntpdate \ libxml2-dev libpq-dev libpq5 sngrep libflite1 flite-dev

重要提示：Ubuntu 22.04及以上版本需要特别注意OpenSSL 3.0的兼容性问题。如果必须使用旧版FreeSWITCH，建议在Ubuntu 20.04 LTS上安装。

2. 核心库编译安装

2.1 libks安装（关键步骤）

FreeSWITCH 1.10.x需要特定版本的libks库：

sudo git clone -b v1.8.3 https://github.com/signalwire/libks.git /usr/local/src/libks cd /usr/local/src/libks sudo cmake . sudo make && sudo make install

验证安装：

sudo ldconfig && ldconfig -p | grep libks

2.2 Sofia-SIP库安装

sudo git clone https://github.com/freeswitch/sofia-sip /usr/local/src/sofia-sip cd /usr/local/src/sofia-sip sudo ./bootstrap.sh sudo ./configure sudo make && sudo make install

验证安装：

sudo ldconfig && ldconfig -p | grep sofia

2.3 SpanDSP库安装（特别注意）

必须使用特定commit版本以避免编译错误：

sudo git clone https://github.com/freeswitch/spandsp /usr/local/src/spandsp cd /usr/local/src/spandsp sudo git checkout -b finecode20230705 0d2e6ac65e0e8f53d652665a743015a88bf048d4 sudo ./bootstrap.sh sudo ./configure sudo make && sudo make install

验证安装：

sudo ldconfig && ldconfig -p | grep spandsp

3. FreeSWITCH编译安装

3.1 源码获取与解压

sudo wget -c https://files.freeswitch.org/releases/freeswitch/freeswitch-1.10.7.-release.tar.gz -P /usr/local/src cd /usr/local/src sudo tar -zxvf freeswitch-1.10.7.-release.tar.gz cd freeswitch-1.10.7.-release

3.2 配置与编译

基础配置：

sudo ./configure

如果需要PostgreSQL或ODBC支持：

sudo ./configure --enable-core-odbc-support --enable-core-pgsql-support

开始编译（此过程可能需要较长时间）：

sudo make sudo make install

安装声音文件：

sudo make cd-sounds-install sudo make cd-moh-install

4. 系统集成与配置

4.1 创建符号链接

sudo ln -s /usr/local/freeswitch/conf /etc/freeswitch sudo ln -s /usr/local/freeswitch/bin/fs_cli /usr/bin/fs_cli sudo ln -s /usr/local/freeswitch/bin/freeswitch /usr/sbin/freeswitch

4.2 创建专用用户

sudo groupadd freeswitch sudo adduser --quiet --system --home /usr/local/freeswitch \ --gecos 'FreeSWITCH open source softswitch' \ --ingroup freeswitch freeswitch --disabled-password sudo chown -R freeswitch:freeswitch /usr/local/freeswitch/ sudo chmod -R ug=rwX,o= /usr/local/freeswitch/ sudo chmod -R u=rwx,g=rx /usr/local/freeswitch/bin/*

4.3 Systemd服务配置

创建服务文件/etc/systemd/system/freeswitch.service：

[Unit] Description=FreeSWITCH open source softswitch Wants=network-online.target Requires=network.target local-fs.target After=network.target network-online.target local-fs.target [Service] Type=forking PIDFile=/usr/local/freeswitch/run/freeswitch.pid Environment="DAEMON_OPTS=-nonat" Environment="USER=freeswitch" Environment="GROUP=freeswitch" EnvironmentFile=-/etc/default/freeswitch ExecStartPre=/bin/chown -R ${USER}:${GROUP} /usr/local/freeswitch ExecStart=/usr/local/freeswitch/bin/freeswitch -u ${USER} -g ${GROUP} -ncwait ${DAEMON_OPTS} TimeoutSec=45s Restart=always [Install] WantedBy=multi-user.target

启用并启动服务：

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

检查服务状态：

sudo systemctl status freeswitch

5. 常见问题解决

5.1 mod_spandsp编译错误

如果遇到类似错误：

mod_spandsp_dsp.c:159:10: error: 'V18_MODE_5BIT_4545' undeclared

解决方案：

cd /usr/local/src/spandsp sudo git checkout -b finecode20230705 0d2e6ac65e0e8f53d652665a743015a88bf048d4 sudo make clean sudo make && sudo make install

然后重新编译FreeSWITCH。

5.2 mod_verto找不到ks.h

确保使用正确版本的libks：

cd /usr/local/src/libks sudo git checkout v1.8.3 sudo make clean sudo cmake . sudo make && sudo make install

5.3 Sofia模块加载失败

如果出现错误：

undefined symbol: tptag_socket_keepalive

解决方案：

cd /usr/local/src/sofia-sip sudo make clean sudo ./bootstrap.sh sudo ./configure sudo make && sudo make install

然后重新编译FreeSWITCH。

6. 网络配置建议

对于使用DHCP的系统，建议配置静态IP以避免FreeSWITCH启动时网络未就绪的问题：

sudo nano /etc/netplan/00-installer-config.yaml

添加类似配置：

network: ethernets: ens33: dhcp4: no addresses: [192.168.1.100/24] gateway4: 192.168.1.1 nameservers: addresses: [8.8.8.8, 8.8.4.4]

应用配置：

sudo netplan apply

7. 测试与验证

启动FreeSWITCH控制台：

fs_cli

在控制台中检查核心模块状态：

sofia status

检查注册用户状态：

sofia status profile internal reg