Ubuntu 20.04 LTS下FreeSWITCH 1.10.x源码编译与配置指南

1. Ubuntu 20.04 LTS安装FreeSWITCH完整指南FreeSWITCH作为开源的软交换平台在VoIP领域有着广泛的应用。本文将详细介绍在Ubuntu 20.04 LTS系统上从源码编译安装FreeSWITCH 1.10.x的全过程包含依赖解决、编译优化和常见问题处理。1.1 环境准备与依赖安装首先确保系统为最新状态sudo apt update sudo apt upgrade -y安装编译工具链和基础依赖sudo apt install -y build-essential pkg-config cmake automake autoconf libtool安装FreeSWITCH核心依赖库sudo apt install -y 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 libpq-dev unixodbc-dev ntpdate libxml2-dev libpq5 sngrep \ libflite1 flite-dev注意Ubuntu 20.04默认的FFmpeg版本与FreeSWITCH 1.10.x兼容如果遇到avformat相关错误可能需要降级FFmpeg。1.2 安装必要的前置库1.2.1 安装libkssudo 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 sudo ldconfig -p | grep libks1.2.2 安装signalwire-csudo git clone https://github.com/signalwire/signalwire-c.git /usr/local/src/signalwire-c cd /usr/local/src/signalwire-c sudo cmake . sudo make sudo make install验证安装sudo ldconfig sudo ldconfig -p | grep signalwire1.3 安装Sofia-SIP和SpanDSP1.3.1 Sofia-SIP安装sudo git clone https://github.com/freeswitch/sofia-sip.git /usr/local/src/sofia-sip cd /usr/local/src/sofia-sip sudo ./bootstrap.sh sudo ./configure sudo make sudo make install验证安装sudo ldconfig sudo ldconfig -p | grep sofia1.3.2 SpanDSP安装使用特定commit版本避免兼容问题sudo git clone https://github.com/freeswitch/spandsp.git /usr/local/src/spandsp cd /usr/local/src/spandsp sudo git checkout -b stable 0d2e6ac65e0e8f53d652665a743015a88bf048d4 sudo ./bootstrap.sh sudo ./configure sudo make sudo make install验证安装sudo ldconfig sudo ldconfig -p | grep spandsp1.4 编译安装FreeSWITCH1.4.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.-release1.4.2 配置编译选项基础配置sudo ./configure如果需要PostgreSQL和ODBC支持sudo ./configure --enable-core-odbc-support --enable-core-pgsql-support1.4.3 编译和安装sudo make sudo make install sudo make cd-sounds-install sudo make cd-moh-install1.5 系统集成与配置1.5.1 创建系统用户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 ugrwX,o /usr/local/freeswitch/ sudo chmod -R urwx,grx /usr/local/freeswitch/bin/*1.5.2 创建符号链接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/freeswitch1.5.3 配置systemd服务创建服务文件/etc/systemd/system/freeswitch.service[Unit] DescriptionFreeSWITCH open source softswitch Wantsnetwork-online.target Requiresnetwork.target local-fs.target Afternetwork.target network-online.target local-fs.target [Service] Typeforking PIDFile/usr/local/freeswitch/run/freeswitch.pid EnvironmentDAEMON_OPTS-nonat EnvironmentUSERfreeswitch EnvironmentGROUPfreeswitch 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} TimeoutSec45s Restartalways [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable freeswitch sudo systemctl start freeswitch检查服务状态sudo systemctl status freeswitch1.6 常见问题解决1.6.1 mod_spandsp编译错误如果遇到类似错误mod_spandsp_dsp.c:159:10: error: V18_MODE_5BIT_4545 undeclared解决方案cd /usr/local/src/spandsp git reset --hard 0d2e6ac65e0e8f53d652665a743015a88bf048d4 make clean ./configure make sudo make install然后重新编译FreeSWITCH。1.6.2 mod_verto找不到ks.h错误信息mod_verto.c:46:10: fatal error: ks.h: No such file or directory确保安装了正确版本的libkscd /usr/local/src/libks git checkout -b v1.8.3 v1.8.3 make clean cmake . make sudo make install1.6.3 Sofia模块加载失败错误信息undefined symbol: tptag_socket_keepalive重新编译sofia-sip并确认版本兼容性cd /usr/local/src/sofia-sip make clean ./configure make sudo make install1.7 基础配置与测试1.7.1 启动控制台fs_cli1.7.2 测试SIP功能在FreeSWITCH控制台执行sofia status sofia status profile internal1.7.3 创建测试分机编辑/usr/local/freeswitch/conf/directory/default/1000.xmlinclude user id1000 params param namepassword value$${default_password}/ /params /user /include重载配置reloadxml1.8 性能优化建议1.8.1 编译优化在configure时添加优化参数./configure CFLAGS-O3 -fomit-frame-pointer CXXFLAGS-O3 -fomit-frame-pointer1.8.2 系统参数调整修改文件描述符限制echo freeswitch soft nofile 999999 | sudo tee -a /etc/security/limits.conf echo freeswitch hard nofile 999999 | sudo tee -a /etc/security/limits.conf1.8.3 内核参数优化编辑/etc/sysctl.conf添加net.core.rmem_max 16777216 net.core.wmem_max 16777216 net.ipv4.tcp_rmem 4096 87380 16777216 net.ipv4.tcp_wmem 4096 65536 16777216应用修改sudo sysctl -p1.9 安全加固措施1.9.1 修改默认密码编辑/usr/local/freeswitch/conf/vars.xmlX-PRE-PROCESS cmdset datadefault_passwordYourStrongPassword/1.9.2 限制SIP访问编辑/usr/local/freeswitch/conf/sip_profiles/internal.xmlparam nameapply-inbound-acl valuelocalnet.auto/配置ACL规则/usr/local/freeswitch/conf/autoload_configs/acl.conf.xmllist namelocalnet.auto defaultdeny node typeallow cidr192.168.1.0/24/ /list1.9.3 启用TLS加密生成证书cd /usr/local/freeswitch/bin ./freeswitch -certgen配置TLS参数param nametls-bind-params valuetransporttls/ param nametls-sip-port value5061/1.10 日志与监控1.10.1 日志配置编辑/usr/local/freeswitch/conf/autoload_configs/console.conf.xmlparam nameloglevel valueinfo/1.10.2 使用sngrep监控安装后可直接使用sngrep1.10.3 性能监控FreeSWITCH内置命令show status show calls count show channels count