在Debian上安装freeswitch
在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
安装系统依赖:
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 python3-dev
sudo apt install libavformat-dev libswscale-dev
构建和安装依赖库
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
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 --with-python3=/usr/bin/python3
make -j 32
sudo make install
注意:
- 源码打包为tar.gz前已经执行了
bootstrap.sh
了,所以不需要执行bootstrap.sh - 如果使用较老的freeswitch版本和python3.10,可能需要修改configure文件,见: https://github.com/signalwire/freeswitch/issues/1479 和 https://github.com/alpinelinux/aports/commit/6a6cfc5ce576f1dc93b84b81718e9da1ddef626d
安装声音文件:
# 标准
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
安装mod_python3:
cd src/mod/languages/mod_python3/
make -j 32
sudo make install
# 安装完成后在/usr/local/freeswitch/mod 可以看到mod_python3.so和mod_python3.la文件
设置权限:
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"