FreeSWITCH 的安装与配置

FreeSWITCH 的安装与配置

一、FreeSWITCH 安装前的准备

（一）系统要求

1. 操作系统：FreeSWITCH 可以在多种操作系统上安装，包括 Linux（如 CentOS、Ubuntu 等）、Windows 和 macOS。不同操作系统的安装方法略有不同。
2. 硬件要求：根据实际应用场景的需求，确定硬件配置。一般来说，需要足够的内存、处理器性能和存储空间。

（二）安装依赖

1. 在 Linux 系统上，可能需要安装一些依赖库，如 GCC、Make、Git 等。具体的依赖库根据不同的发行版和安装方式而有所不同。
2. 在 Windows 系统上，可能需要安装 Visual Studio 等开发工具，以确保编译和安装过程的顺利进行。

二、在 Linux 系统上安装 FreeSWITCH

（一）更新 yum

1. 打开终端，以 root 用户身份登录系统。
2. 执行以下命令更新 yum 源：

yum update

（二）安装依赖库

1. 安装 GCC 和 Make：

yum install gcc make

2. 安装 Git：

yum install git

3. 安装其他可能需要的依赖库，如 libjansson、libcurl 等。具体的依赖库可以根据 FreeSWITCH 的安装文档进行安装。

（三）下载和编译 FreeSWITCH

1. 使用 Git 克隆 FreeSWITCH 源代码仓库：

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

2. 进入 FreeSWITCH 源代码目录：

cd freeswitch

3. 执行编译命令：

./bootstrap.sh ./configure make make install

（四）配置 FreeSWITCH

1. 编辑 FreeSWITCH 的配置文件：

vi /etc/freeswitch/autoload_configs/*.xml

/usr/local/freeswitch/bin/freeswitch -nc

三、在 Windows 系统上安装 FreeSWITCH

（一）安装依赖

1. 安装 Visual Studio：下载并安装 Visual Studio，确保选择安装 C++ 开发工具。
2. 安装 Git：从 Git 官方网站下载并安装 Git for Windows。

（二）下载和编译 FreeSWITCH

1. 使用 Git 克隆 FreeSWITCH 源代码仓库：

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

2. 进入 FreeSWITCH 源代码目录：

cd freeswitch

3. 打开 Visual Studio 的 Developer Command Prompt，进入 FreeSWITCH 源代码目录。
4. 执行编译命令：

nmake nmake install

（三）配置 FreeSWITCH

1. 编辑 FreeSWITCH 的配置文件：

notepad %ProgramFiles%\FreeSWITCH\conf\*.xml

%ProgramFiles%\FreeSWITCH\bin\freeswitch.exe

四、常见配置要点

（一）SIP 配置

1. SIP 端口：默认情况下，FreeSWITCH 使用 5060 端口作为 SIP 端口。可以根据实际需求修改这个端口号。
2. SIP 注册：配置 SIP 用户的注册信息，包括用户名、密码、注册服务器地址等。
3. SIP 路由：配置 SIP 呼叫的路由规则，以便将呼叫转发到正确的目的地。

（二）RTP 配置

1. RTP 端口范围：FreeSWITCH 使用 RTP 协议传输音频数据。可以配置 RTP 端口范围，以确保音频传输的顺利进行。
2. 音频编解码：选择合适的音频编解码方式，以满足不同的应用需求。FreeSWITCH 支持多种音频编解码，如 G.711、G.729、Opus 等。

（三）录音配置

1. 录音目录：配置录音文件的存储目录。可以选择将录音文件存储在本地磁盘或网络存储设备上。
2. 录音格式：选择合适的录音格式，如 WAV、MP3 等。

（四）安全配置

1. 访问控制：配置 FreeSWITCH 的访问控制规则，以确保只有授权用户可以访问系统。
2. 加密传输：使用加密协议（如 TLS）保护 SIP 和 RTP 通信的安全。

五、实际案例演示

（一）安装步骤

1. 更新 yum：

yum update

2. 安装依赖库：

yum install gcc make git libjansson-devel libcurl-devel

3. 下载和编译 FreeSWITCH：

git clone https://github.com/freeswitch/freeswitch.git cd freeswitch ./bootstrap.sh ./configure make make install

4. 配置 FreeSWITCH：

vi /etc/freeswitch/autoload_configs/*.xml

（二）测试安装

1. 启动 FreeSWITCH：

/usr/local/freeswitch/bin/freeswitch -nc

2. 使用 SIP 软电话注册到 FreeSWITCH：在 SIP 软电话中配置注册服务器地址为服务器的 IP 地址，端口为 5080，用户名和密码为在 FreeSWITCH 配置文件中设置的用户信息。
3. 进行呼叫测试：使用 SIP 软电话拨打另一个 SIP 用户的号码，检查音频传输是否正常。

FreeSWITCH 的高级应用

1. 自动化安装的优势
   自动安装可以大大节省时间和精力，特别是对于需要大规模部署 FreeSWITCH 的场景。它可以确保安装过程的一致性和可重复性，减少人为错误的发生。同时，自动安装还可以方便地进行版本升级和维护。
2. 实现方法
   （1）使用脚本进行自动安装
   可以使用 Shell 脚本或 Ansible、Puppet 等自动化工具来实现 FreeSWITCH 的自动安装。这些工具可以根据预先定义的步骤，自动执行安装过程中的各个任务，如更新系统、安装依赖、下载和编译 FreeSWITCH 等。

#!/bin/bash# 更新系统sudoyum update-y# 安装依赖sudoyuminstall-ygitautoconf automake libtool gcc-c++ pkgconfig libjansson-devel libcurl-devel libedit-devel ncurses-devel sqlite-devel opus-devel speex-devel ldns-devel libsndfile-devel libxml2-devel libyuv-devel libvpx-devel lame-devel libogg-devel libvorbis-devel libtheora-devel ffmpeg-devel libpq-devel libmemcached-devel libldns-devel libevent-devel# 下载 FreeSWITCHgitclone https://github.com/signalwire/freeswitch.git# 进入 FreeSWITCH 目录cdfreeswitch# 编译和安装./bootstrap.sh-j./configuremakesudomakeinstall

sudoyuminstall-ydockersudosystemctl startdockersudosystemctlenabledocker

dockerpull freeswitch/freeswitch:latest

dockerrun-d-p5060:5060/udp-p8021:8021-p7443:7443 freeswitch/freeswitch:latest

3. 注意事项
   （1）在使用脚本进行自动安装时，需要确保脚本中的路径和命令适用于目标系统。不同的操作系统和版本可能需要进行适当的调整。
   （2）在使用容器化技术进行自动安装时，需要注意容器的安全性和资源限制。确保容器不会对宿主系统造成安全风险，并且合理分配资源以避免性能问题。

1. 高可用部署的重要性
   在通信系统中，高可用性是至关重要的。如果主服务器出现故障，需要能够快速切换到备用服务器，以确保通信的连续性。使用 keepalived 可以实现 FreeSWITCH 的主备切换高可用部署。
2. 实现方法
   （1）安装 keepalived
   在主服务器和备用服务器上分别安装 keepalived。可以使用以下命令在 CentOS 系统上安装 keepalived：

sudoyuminstall-ykeepalived

! Configuration File for keepalived global_defs { router_id LVS_DEVEL } vrrp_instance VI_1 { state MASTER interface eth0 virtual_router_id 51 priority 100 advert_int 1 authentication { auth_type PASS auth_pass 1111 } virtual_ipaddress { 192.168.1.100 } }

! Configuration File for keepalived global_defs { router_id LVS_DEVEL } vrrp_instance VI_1 { state BACKUP interface eth0 virtual_router_id 51 priority 90 advert_int 1 authentication { auth_type PASS auth_pass 1111 } virtual_ipaddress { 192.168.1.100 } }

<configurationname="event_socket.conf"description="Socket Client"><settings><paramname="listen-ip"value="192.168.1.100"/><paramname="listen-port"value="8021"/>settings>configuration>

sudosystemctl start keepalivedsudosystemctl start freeswitch

3. 注意事项
   （1）在配置 keepalived 时，需要确保主服务器和备用服务器的网络连接正常。虚拟 IP 地址应该在同一个子网内，并且可以被客户端访问。
   （2）在配置 FreeSWITCH 时，需要确保监听的 IP 地址和端口正确。如果使用了防火墙，需要开放相应的端口。
   （3）定期测试高可用部署的有效性，确保在主服务器出现故障时，备用服务器能够及时接管。

1. 为什么要将录音文件记录写入数据库
   将录音文件记录写入 MySQL 数据库可以方便地管理和查询录音文件。可以根据通话时间、通话双方、通话时长等信息进行查询和统计，为业务分析和质量监控提供数据支持。
2. 实现方法
   （1）安装 MySQL 数据库
   在服务器上安装 MySQL 数据库。可以使用以下命令在 CentOS 系统上安装 MySQL：

sudoyuminstall-ymysql-serversudosystemctl start mysqldsudosystemctlenablemysqld

CREATEDATABASEfreeswitch_records;USEfreeswitch_records;CREATETABLErecordings(idINTAUTO_INCREMENTPRIMARYKEY,call_idVARCHAR(255),start_timeDATETIME,end_timeDATETIME,durationINT,file_pathVARCHAR(255));

<configurationname="modules.conf"description="Modules"><modules><loadmodule="mod_db_mysql"/>modules>configuration>

<extensionname="recordings"><conditionfield="destination_number"expression="^(.*)$"><actionapplication="set"data="RECORD_STEREO=true"/><actionapplication="set"data="RECORD_FILENAME=${strftime(%Y-%m-%d-%H-%M-%S)}_${caller_id_number}_${destination_number}.wav"/><actionapplication="record_session"data="${record_filename}"/><actionapplication="mysql"data="ｉｎｓｅｒｔ into freeswitch_records.recordings (call_id, start_time, end_time, duration, file_path) values ('${uuid}', '${strftime(%Y-%m-%d %H:%M:%S)}', '${strftime(%Y-%m-%d %H:%M:%S)}', '${record_duration}', '${record_filename}')"/>condition>extension>

3. 注意事项
   （1）在配置 FreeSWITCH 时，需要确保mod_db_mysql模块已经正确安装。如果没有安装，可以使用以下命令进行安装：

sudoyuminstall-yfreeswitch-mod-db-mysql

<configurationname="modules.conf"description="Modules"><modules><loadmodule="mod_db_mysql"/><paramname="dbhost"value="localhost"/><paramname="dbport"value="3306"/><paramname="dbname"value="freeswitch_records"/><paramname="dbuser"value="root"/><paramname="dbpass"value="password"/>modules>configuration>