在Debian上安装freeswitch
说明：
- 首次发表日期：2024-08-12
- 参考文档：
- https://medium.com/@jogikrunal9477/ultimate-guide-to-installing-freeswitch-on-ubuntu-22-04-lts-3745ef6a6bd6
- https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/Linux/Deprecated-Installation-Instructions/Debian-Post-Install-Tasks_13172868/
- https://blog.csdn.net/qq_36369267/article/details/131564019
安装系统依赖
查看系统版本：
cat /etc/issue
Debian GNU/Linux 12 \n \l
安装系统依赖：
参考 https://medium.com/@jogikrunal9477/ultimate-guide-to-installing-freeswitch-on-ubuntu-22-04-lts-3745ef6a6bd6
sudo apt update
sudo apt-get install build-essential automake autoconf git-core wget libtool cmake pkg-config uuid-dev
sudo apt-get install libncurses5-dev libtiff-dev libjpeg-dev zlib1g-dev libssl-dev libsqlite3-dev
sudo apt-get install libpcre3-dev libspeexdsp-dev libspeex-dev libcurl4-openssl-dev libopus-dev libpq5 libpq-dev unixodbc-dev libldns-dev libedit-dev yasm liblua5.2-dev liblua5.2-0 libxml2-dev lua5.2 lua5.2-doc libtiff5-dev libsndfile1-dev unzip sngrep libreadline-dev ntpdate
sudo apt install python3 python3-venv python3-pip python3-distutils
sudo apt install libavformat-dev libswscale-dev
构建和安装依赖库
libks
- https://github.com/signalwire/libks
git clone -b v2.0.6 https://github.com/signalwire/libks.git
cd libks
cmake . -DCMAKE_BUILD_TYPE=Release
make -j 32
sudo make install
注意：可能需要注释掉CMakeList.txt中Generate a Debian compliant changelog的部分
singalwire-c
- https://github.com/signalwire/signalwire-c
git clone -b v2.0.0 https://github.com/signalwire/signalwire-c.git
cd signalwire-c
cmake . -DCMAKE_BUILD_TYPE=Release
make -j 32
sudo make install
spansdp
参考： https://blog.csdn.net/qq_36369267/article/details/131564019
git clone https://github.com/freeswitch/spandsp.git
cd spandsp/
git checkout -b finecode20230705 0d2e6ac65e0e8f53d652665a743015a88bf048d4
./bootstrap.sh -j
./configure
make -j 32
sudo make install
sofia-sip
git clone -b v1.13.17 https://github.com/freeswitch/sofia-sip.git
cd sofia-sip
./bootstrap.sh -j
./configure
make -j 32
sudo make install
安装 freeswitch
wget https://files.freeswitch.org/freeswitch-releases/freeswitch-1.10.12.-release.tar.gz
tar -xvf freeswitch-1.10.12.-release.tar.gz
cd freeswitch-1.10.12.-release
./configure --enable-core-odbc-support --enable-core-pgsql-support
make -j 32
sudo make install
注意：源码打包为tar.gz前已经执行了bootstrap.sh了，所以不需要执行bootstrap.sh
安装声音文件：
# 标准
sudo make sounds-install
sudo make moh-install
# 高清
sudo make cd-sounds-install
sudo make cd-moh-install
配置软链接：
sudo ln -sf /usr/local/freeswitch/bin/freeswitch /usr/bin/
sudo ln -sf /usr/local/freeswitch/bin/fs_cli /usr/bin
sudo ln -s /usr/local/freeswitch/conf /etc/freeswitch
设置权限：
参考： https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/Linux/Deprecated-Installation-Instructions/Debian-Post-Install-Tasks_13172868#set-owner-and-permissions
sudo groupadd freeswitch
sudo usermod -a -G freeswitch $USER # 需要登出再登录使得权限生效
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 770 /usr/local/freeswitch/
sudo chmod -R 750 /usr/local/freeswitch/bin/
运行
freeswitch
其中
/etc/freeswitch/文件夹下存放配置文件/usr/local/freeswitch/db存放可能用到的sqlite数据库文件，如core.db
检查进程查看freeswitch是否在运行：
ps aux | grep freeswitch
查看freeswitch监听的IP地址：
netstat -an | grep 5060
停止freeswitch：
# freeswitch 控制台
shutdown
# 终端
freeswitch -stop
后台启动（Deamon服务）：
freeswitch -nc
客户端连接：
fs_cli
查看帮助：
freeswitch -help
配置为系统服务（开机启动）
创建service文件：
sudo vi /etc/systemd/system/freeswitch.service
粘贴如下内容：
[Unit]
Description=FreeSWITCH
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
Reload systemd daemon:
sudo systemctl daemon-reload
开启和启动服务：
sudo systemctl enable freeswitch.service
sudo systemctl start freeswitch.service
查看服务状态：
sudo systemctl status freeswitch.service
WSL端口转发
参考：
- https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2003/cc776297(v=ws.10)
- https://blog.csdn.net/u013600225/article/details/52088196
本次测试的debian是在WSL下安装的，故需要配置端口转发
首先，获取debian的ip地址（powershell）
wsl ifconfig eth0
powershell管理员模式下添加端口映射：
# 添加配置: 本机监听5060端口,当有socket连接到5060端口时,本机就连接到172.26.90.29的connectport=5060端口,本机的5060端口可以接受的连接地址为"*",使用的协议为tcp,当前仅支持传输控制协议 (TCP)。
netsh interface portproxy add v4tov4 listenport=5060 connectaddress=172.26.90.29 connectport=5060 listenaddress=* protocol=tcp
查看所有映射
netsh interface portproxy show all
删除映射
netsh interface portproxy delete v4tov4 listenaddress=* listenport=5060
注意：使用软电话（eyebeam和Linphone）时，需要将协议改为tcp
可能需要打开防火墙，允许5060端口（不确定是否需要）：
# add inbound rule（添加入站规则）
netsh advfirewall firewall add rule name= "WSL freeswitch" dir=in action=allow protocol=TCP localport=5060
# add outbound rule（添加出站规则）
netsh advfirewall firewall add rule name= "WSL freeswitch" dir=out action=allow protocol=TCP localport=5060
# reset（删除规则）
netsh advfirewall firewall delete rule name="WSL freeswitch"