1. Freeswitch核心命令实战解析第一次接触Freeswitch时面对密密麻麻的命令行界面我完全不知道从何下手。经过几个项目的实战积累我发现掌握几个核心命令就能解决80%的日常需求。下面这些命令都是我踩过无数坑后总结出来的精华特别适合刚入门的小伙伴快速上手。最常用的就是reloadxml命令了。每次修改完XML配置文件后不需要重启服务直接输入这个命令就能立即生效。记得有次半夜紧急修改路由规则全靠这个命令避免了服务中断。它的工作原理是重新加载所有XML配置文件包括拨号计划、用户目录等但不会影响正在进行的通话。呼叫控制离不开originate命令。它的基本语法是originate 呼叫参数 被叫号码 应用(参数)比如要实现A呼叫B的场景originate user/1001 bridge(user/1002)这里有个实用技巧在测试环境可以用loopback通道代替真实用户originate loopback/1234 echo日志调试我常用fsctl loglevel命令。开发阶段建议设置为7DEBUG级别fsctl loglevel 7生产环境记得调回3ERROR级别避免日志爆炸。有次线上问题排查就是通过临时调整日志级别发现了隐藏的并发问题。2. 全局变量操作技巧全局变量是Freeswitch中非常实用的功能可以在不同会话间共享数据。global_setvar和global_getvar这对命令我几乎每天都会用到。设置全局变量的正确姿势global_setvar my_vartest_value获取变量值时要注意使用$${}语法eval $${my_var}实际项目中我常用全局变量存储系统配置参数比如global_setvar max_call100变量作用域需要特别注意。全局变量对所有会话可见而通道变量只在当前呼叫有效。有次我错误地用通道变量存储计费信息导致跨呼叫数据丢失这个教训让我牢牢记住了两者的区别。调试时可以用show variables查看所有全局变量。建议给变量加上前缀方便管理比如cfg_表示配置temp_表示临时变量。3. 正则表达式实战应用Freeswitch的正则引擎非常强大regex命令是我验证规则的首选工具。基本用法regex 测试字符串|正则表达式比如验证手机号格式regex 13800138000|^1[3-9]\d{9}$高级用法可以捕获分组regex 2023-08-01|(\d{4})-(\d{2})-(\d{2})|%0 %1 %2 %3输出会是2023-08-01 2023 08 01在拨号计划中我经常用正则实现智能路由。比如根据号码前缀路由到不同网关condition expression^0(\d)$ action applicationbridge datasofia/gateway/pstn/$1/ /condition4. 拨号计划深度解析拨号计划是Freeswitch最强大的功能之一也是新手最容易困惑的部分。理解condition的执行逻辑至关重要。break属性的四种取值实际项目中这样使用on-false默认条件不满足时跳出on-true条件满足时跳出never继续检查后续条件always强制跳出典型的分时段路由示例condition wday2-6 hour9-18 breaknever action applicationbridge datasofia/gateway/office/$1/ /condition condition action applicationbridge datasofia/gateway/after_hours/$1/ /conditioninline执行是个很有用的特性。在需要立即生效的场景action applicationset datatimeout10 inlinetrue/5. 实用工具与调试技巧sngrep是我最推荐的SIP抓包工具。安装很简单apt-get install sngrep使用时加-c参数可以持续监控sngrep -c日志分析我常用grep组合命令。比如只看ERROR日志grep -i error /var/log/freeswitch/freeswitch.log性能监控可以用内置命令show status show channels count遇到疑难杂症时我通常会按这个步骤排查检查日志级别是否足够用sngrep确认SIP信令通过originate简化重现步骤使用eval验证变量值6. 网关配置实战对接PSTN网关是实际项目中的常见需求。配置网关时要注意这些参数gateway namenewrock param nameusername value1001/ param namepassword value123456/ param nameproxy value192.168.1.100/ param nameregister valuetrue/ /gateway关键点在于register决定是否主动注册proxy指定网关地址expire-seconds设置注册有效期测试网关状态用sofia status gateway newrock7. 常见问题解决方案内存泄漏是我遇到过最棘手的问题。通过show memory命令可以监控show memory发现泄漏时可以尝试fsctl shutdown平滑重启服务。呼叫建立失败时先检查show channels show calls确认通道状态。音频问题可以用echo测试originate loopback/1234 echo配置文件错误时先用reloadxml测试再考虑重启服务。养成修改前备份的好习惯cp freeswitch.xml freeswitch.xml.bak