1. FreeSWITCH视频通话基础配置

第一次接触FreeSWITCH视频通话功能时，我踩了不少坑。记得当时按照文档配置完参数，测试时却发现视频画面始终出不来，最后发现是漏掉了关键的媒体代理设置。下面我就把实战中验证过的配置方法分享给大家。

vars.xml是FreeSWITCH的全局变量配置文件，我们需要在其中添加媒体代理设置。用文本编辑器打开conf/vars.xml文件，在合适位置添加这行配置：

<X-PRE-PROCESS cmd="set" data="proxy_media=true"/>

这个参数告诉FreeSWITCH要代理媒体流，对于视频通话至关重要。接下来是internal.xml文件的修改，这个文件位于conf/sip_profiles目录下，控制着SIP协议栈的行为。找到以下两个关键参数：

<param name="inbound-proxy-media" value="true"/>
<param name="inbound-late-negotiation" value="true"/>

第一个参数确保入站媒体流经过代理，第二个参数允许延迟编解码协商。这两个参数配合使用，可以解决90%的视频通话初始化问题。记得去掉参数前的注释符号，很多新手容易忽略这点。

2. 编解码器配置优化实战

编解码器配置不当是视频通话失败的常见原因。有一次客户抱怨视频卡顿，排查后发现是默认配置只启用了H.263这种老旧编码。在vars.xml中我们需要扩展编解码支持：

<X-PRE-PROCESS cmd="set" data="global_codec_prefs=OPUS,G711,AAC,G722,PCMU,PCMA,GSM,H263,H264,VP8,H263-1998"/>
<X-PRE-PROCESS cmd="set" data="outbound_codec_prefs=OPUS,G711,AAC,G722,PCMU,PCMA,GSM,H263,H264,VP8,H263-1998"/>

这里有几个经验要点：

• OPUS编码应该放在首位，它在语音质量与带宽间有很好平衡
• H264和VP8是现代视频通话的首选编码
• G711作为后备编码确保兼容性

实际测试中发现，某些硬件设备对编解码顺序敏感。如果遇到设备兼容问题，可以尝试调整编解码顺序，把设备支持的编码往前放。

3. 配置文件深度解析

理解配置文件的工作原理能帮助排查复杂问题。internal.xml中的每个参数都有其特定作用：

<param name="inbound-proxy-media" value="true"/>

这个参数控制媒体流是否经过FreeSWITCH中转。设为true时，FreeSWITCH会成为媒体中间人，这对NAT穿越和QoS控制很有帮助，但会增加服务器负载。

<param name="inbound-late-negotiation" value="true"/> 

延迟协商允许在呼叫建立后再确定编解码，特别适合需要根据呼叫属性动态选择编解码的场景。我曾在客户现场遇到一个案例：开启这个参数后，跨运营商视频通话成功率从70%提升到98%。

4. 常见问题排查指南

配置完成后如果视频通话仍不正常，可以按照以下步骤排查：

1. 检查编解码协商：在FreeSWITCH控制台执行show channels命令，查看实际使用的编解码是否在支持列表中

2. 验证媒体流：用sofia profile internal siptrace on开启SIP跟踪，观察SDP协商过程

3. 网络检查：确保UDP端口（默认5060）和RTP端口范围（16384-32768）没有被防火墙阻挡

4. 日志分析：查看FreeSWITCH日志中的错误信息，常见的有：

   • "No compatible codec"表示编解码不匹配
   • "RTP timeout"通常是网络问题

记得每次修改配置后要完全重启FreeSWITCH服务，部分参数热加载不生效。我习惯用shutdown命令先停止服务，再启动freeswitch，确保所有配置重新加载。

5. 高级优化技巧

对于高并发视频通话场景，还需要考虑以下优化：

带宽控制：在vars.xml中设置

<X-PRE-PROCESS cmd="set" data="media_mix_inbound_outbound_codecs=true"/>

这个参数允许动态调整编解码以适应网络状况。

视频分辨率：在internal.xml中添加

<param name="video-mode" value="mux"/>
<param name="video-fps" value="15"/>

将帧率控制在15-25fps之间，在画质和流畅度间取得平衡。

NAT穿越：确保配置了正确的NAT参数

<param name="ext-rtp-ip" value="auto-nat"/>
<param name="ext-sip-ip" value="auto-nat"/>

这些优化在我负责的一个在线教育项目中效果显著，500人同时视频上课时服务器负载降低了40%。

6. 实际案例分享

去年部署的一个视频客服系统中，我们遇到了一个棘手问题：部分安卓客户端视频花屏。经过两周的排查，最终发现是VP8编码的兼容性问题。解决方案是在vars.xml中调整编解码顺序：

<X-PRE-PROCESS cmd="set" data="global_codec_prefs=H264,VP8,H263,OPUS,G711"/>

把H264放在首位后问题解决。这个案例告诉我们，实际部署时要充分考虑终端设备的多样性。

另一个经验是：每次修改配置前备份原文件。有次误操作导致服务不可用，幸好有备份快速恢复了服务。现在我的工作流程是：

1. cp internal.xml internal.xml.bak
2. 修改配置
3. 测试验证
4. 确认无误后删除备份

7. 性能监控与调优

稳定的视频通话服务需要持续监控。我通常关注这些指标：

• CPU使用率：视频转码很吃CPU，建议控制在70%以下
• 内存占用：每个视频会话约占用5-15MB内存
• 网络延迟：使用network latency命令监控
• 编解码分布：通过show codec查看各编解码使用情况

对于高负载场景，可以在internal.xml中限制最大会话数：

<param name="max-sessions" value="1000"/>

记得根据服务器配置调整这个值，设置过低会影响容量，过高可能导致资源耗尽。

8. 安全配置建议

视频通话服务需要考虑安全性：

1. TLS加密：在internal.xml中启用

<param name="tls" value="true"/>

2. 认证强化：

<param name="auth-calls" value="true"/>
<param name="inbound-reg-force-matching-username" value="true"/>

3. ACL控制：

<param name="apply-inbound-acl" value="domains"/>

这些配置可以有效防止未授权访问和媒体流窃听。在金融行业项目中，这些安全措施是必须的。

9. 测试与验证

配置完成后，我习惯用以下步骤验证：

1. 使用eyeBeam或Zoiper等软电话测试基础功能
2. 通过sofia status检查SIP状态
3. 用conference list监控会议状态
4. 在不同网络环境下测试（WiFi/4G）

特别注意检查视频编解码是否按预期工作。有次上线前测试发现VP8编码异常，及时调整避免了线上事故。

10. 持续维护建议

视频通话服务需要定期维护：

• 每月检查编解码器更新
• 每季度压力测试验证容量
• 关注FreeSWITCH版本更新，及时升级
• 保留详细的配置变更日志

建立完善的监控告警系统也很重要。我在生产环境部署了Prometheus监控FreeSWITCH的关键指标，出现问题能第一时间发现。