FreeSWITCH实战：从零部署到高效网关配置全解析
1. FreeSWITCH入门：从零搭建通信系统
第一次接触FreeSWITCH时，我也被这个强大的开源通信平台震撼到了。它就像是一个万能工具箱，能处理语音通话、视频会议、即时消息等各种通信需求。不过对于新手来说，最头疼的往往是第一步——如何正确部署。
先说说我的踩坑经历。去年给客户部署系统时，因为没注意数据库字符集，结果通话记录全变成乱码，不得不重新来过。所以现在每次安装，我都会特别关注MariaDB的配置细节。
基础环境准备其实很简单，用CentOS举例：
yum install -y git gcc-c++ autoconf automake libtool wget python这些是编译必备工具，就像盖房子要先准备砖瓦水泥一样。记得加上epel-release源，不然有些依赖包找不到。
数据库配置有个小技巧：在/etc/my.cnf的[mysqld]段加上这几行，能彻底避免中文乱码问题：
character-set-server=utf8 collation-server=utf8_unicode_ci skip-character-set-client-handshake源码编译时有个关键参数容易忽略：
./configure --enable-core-odbc-support这个选项关系到后面能否正常使用数据库功能。我有次漏了，结果CDR通话记录死活存不进数据库，排查了半天才发现问题。
2. 核心功能配置实战技巧
2.1 SIP网关配置的坑与解决方案
配置SIP网关时，最常遇到的就是注册失败。有次客户现场，网关状态一直显示"REGED"，但就是打不通电话。后来发现是防火墙把SIP的5060端口拦了，改成非标端口才解决。
这是最简网关配置模板：
<gateway name="gw1"> <param name="realm" value="sip.provider.com"/> <param name="username" value="your_account"/> <param name="password" value="your_password"/> <param name="register" value="true"/> </gateway>常见问题排查三步法：
- 先用
sofia status看网关状态 - 测试
originate sofia/gateway/gw1/123456 &echo() - 检查日志
/usr/local/freeswitch/log/freeswitch.log
2.2 NAT穿透的实战经验
在阿里云上部署时，NAT问题让我栽过跟头。客户端能注册但就是没声音，原来是RTP端口没穿透成功。后来找到完美解决方案：
修改sip_profiles/internal.xml：
<param name="ext-rtp-ip" value="$${external_rtp_ip}"/> <param name="ext-sip-ip" value="$${external_sip_ip}"/>然后在vars.xml定义这两个变量：
<X-PRE-PROCESS cmd="set" data="external_rtp_ip=你的公网IP"/> <X-PRE-PROCESS cmd="set" data="external_sip_ip=你的公网IP"/>企业级部署建议：
- 双线配置：复制internal.xml为internal2.xml，改name和IP
- 防掉线：设置
<param name="nat-options-ping" value="true"/> - 安全加固：修改默认密码和端口
3. 企业级应用场景实战
3.1 高可用双线部署
给银行客户做双活部署时，我们这样配置：
- 主备线路独立配置文件
- 智能路由规则：
<condition field="${network_addr}" expression="^192\.168\.1\."> <action application="bridge" data="sofia/gateway/telecom/$1"/> </condition> <condition field="${network_addr}" expression="^192\.168\.2\."> <action application="bridge" data="sofia/gateway/unicom/$1"/> </condition>3.2 防掉线策略优化
有个教育客户反映视频会议老断线，我们通过三招解决：
- 开启心跳检测：
<param name="sip-options-interval" value="30"/>- 调整超时设置：
<param name="sip-invite-timeout" value="180"/>- 增加重试机制：
<param name="retry-secs" value="10"/> <param name="max-retries" value="3"/>4. 典型问题解决方案
4.1 数据库字符集问题
遇到CDR记录乱码时，按这个流程处理：
- 备份现有数据
- 修改表结构：
ALTER TABLE channels CONVERT TO CHARACTER SET utf8;- 检查ODBC配置：
[freeswitch] Driver=MySQL SERVER=localhost DATABASE=fsdb CHARSET=UTF84.2 RTP穿越优化
视频卡顿的老大难问题，可以通过这些参数调整：
<param name="rtp-timer-name" value="soft"/> <param name="rtp-ip" value="$${local_ip_v4}"/> <param name="rtp-timeout-sec" value="300"/> <param name="enable-3way" value="true"/>有个诀窍：用tcpdump抓包分析：
tcpdump -i eth0 -n udp portrange 16384-32768 -w rtp.pcap5. 网关配置全流程详解
最近配置鼎信网关时，总结出这个checklist：
网络基础配置
- 修改默认IP段（避免冲突）
- 设置VLAN（企业网络需要）
SIP服务器参数
SIP服务器地址：你的FreeSWITCH IP SIP端口：5060 注册有效期：3600 DTMF模式：RFC2833路由策略
- 端口组绑定分机号
- 设置主备路由
- 配置号码变换规则
安全加固
- 修改默认admin密码
- 设置ACL访问控制
- 开启异常登录告警
最后提醒：每次修改配置后，一定要先做测试呼叫，再批量上线。有次我改完路由没测试，结果整个办公室电话瘫痪了半小时。现在我的习惯是改任何参数都先跑个测试脚本：
#!/bin/bash fs_cli -x "originate user/1000 &echo()" fs_cli -x "originate sofia/gateway/gw1/18612345678 &echo()"