别再纠结了！手把手教你用FreeSWITCH 1.10 + Verto模块搭建WebRTC智能外呼系统（含完整配置文件）

WebRTC智能外呼实战基于FreeSWITCH与Verto的高效解决方案在数字化转型浪潮中企业通信系统正经历从传统电话向互联网融合的深刻变革。我曾为多家金融机构和电商平台设计过智能外呼系统发现一个共性痛点如何在不依赖客户端安装的情况下实现高可靠性的浏览器端语音交互这正是WebRTC技术结合FreeSWITCH Verto模块的用武之地。与常见的SIP over WebSocket方案不同Verto作为FreeSWITCH专为Web场景设计的轻量级协议提供了更简洁的JSON信令接口和内置的屏幕共享支持。本文将分享一套经过生产验证的架构方案包含从环境搭建、模块配置到与AI引擎集成的完整链路特别适合需要快速落地智能外呼、客服机器人等场景的技术团队。1. 环境准备与模块编译1.1 系统基础环境配置推荐使用Ubuntu 20.04 LTS作为基础系统其长期支持特性和稳定的软件源能避免许多依赖问题。以下是必备组件的安装命令# 安装编译工具和基础依赖 sudo apt update sudo apt install -y \ git build-essential autoconf automake libtool \ pkg-config libssl-dev libpcre3-dev zlib1g-dev \ libedit-dev libsqlite3-dev libcurl4-openssl-dev \ libspeex-dev libspeexdsp-dev libopus-dev对于生产环境建议单独创建运行用户并设置权限隔离sudo adduser --disabled-password --quiet --system --group freeswitch sudo mkdir -p /usr/local/freeswitch/{logs,storage,recordings} sudo chown -R freeswitch:freeswitch /usr/local/freeswitch1.2 获取FreeSWITCH源码与Verto模块使用官方源码仓库确保获得最新稳定版本当前1.10.7git clone https://github.com/signalwire/freeswitch.git cd freeswitch git checkout v1.10.7Verto模块需要单独启用编译选项。修改modules.conf文件# 取消以下行的注释 applications/mod_verto编译时关键配置参数参数作用推荐值--enable-verto启用Verto支持必选--with-opusOpus编解码支持必选--enable-system-opus使用系统Opus库可选--enable-portable-binary生成可移植二进制生产环境建议完整编译命令示例./bootstrap.sh ./configure \ --enable-verto \ --with-opus \ --enable-portable-binary \ --prefix/usr/local/freeswitch make -j$(nproc) sudo make install2. Verto核心配置详解2.1 基础服务配置在conf/autoload_configs/verto.conf.xml中设置核心参数configuration nameverto.conf descriptionVerto Client settings !-- 监听端口与接口 -- param namelisten-ip value0.0.0.0/ param namelisten-port value8081/ !-- TLS加密配置 -- param nametls valuetrue/ param nametls-bind-params valuetransporttls/ param nametls-cert-dir value/usr/local/freeswitch/certs/ !-- 心跳检测与超时 -- param nameheartbeat value30/ param namedisable-dtls valuefalse/ !-- 媒体参数 -- param namevideo-mode valuemux/ param namesuppress-cng valuetrue/ /settings /configuration证书配置建议使用Lets Encrypt的泛域名证书便于后续扩展sudo certbot certonly --standalone -d yourdomain.com \ --preferred-challenges http --agree-tos \ --email adminyourdomain.com2.2 外呼场景专用配置针对AI外呼场景需要优化以下参数!-- conf/autoload_configs/verto.conf.xml 补充 -- profiles profile nameai-callout param namejsonrpc-allowed-methods valueverto.invite,verto.answer/ param nameenable-presence valuefalse/ param namemax-sessions value5000/ param namemin-rate value8000/ param namemax-rate value48000/ param namedtmf-type valuerfc2833/ /profile /profiles关键参数说明jsonrpc-allowed-methods限制只允许外呼相关方法提升安全性max-sessions单个节点支持的最大并发会话数dtmf-typeDTMF传输方式推荐rfc2833兼容性更好3. 与AI引擎的深度集成3.1 ASR/TTS对接方案通过FreeSWITCH的mod_unimrcp模块可以实现与主流语音引擎的无缝对接。以下是配置示例!-- conf/autoload_configs/unimrcp.conf.xml -- profile nameai-asr-profile param nameserver-ip value127.0.0.1/ param nameserver-port value8060/ param nameresource-location value/ param namespeech-synth valuespeechsynthesizer/ param namespeech-recog valuespeechrecognizer/ param namertp-ext-ip valueauto/ param namesession-timeout value3000/ /profile典型的外呼流程Dialplan配置extension nameai_outbound condition fielddestination_number expression^ai_out_(\d)$ action applicationanswer/ action applicationplay_and_detect_speech datasay:您好这里是XX客服 ${tts_engine} 请说出您的需求 datadetect:unimrcp {start-input-timersfalse}builtin:grammar/boolean?languagezh-CN/ action applicationverto_bridge data${verto_contact}/ /condition /extension3.2 性能优化技巧在高并发场景下需要调整Linux系统参数# 增加本地端口范围 echo net.ipv4.ip_local_port_range 10000 65000 /etc/sysctl.conf # 提高文件描述符限制 echo fs.file-max 100000 /etc/sysctl.conf echo freeswitch soft nofile 100000 /etc/security/limits.conf echo freeswitch hard nofile 100000 /etc/security/limits.conf # 优化网络缓冲区 echo net.core.rmem_max 33554432 /etc/sysctl.conf echo net.core.wmem_max 33554432 /etc/sysctl.confFreeSWITCH内部参数调整!-- conf/autoload_configs/switch.conf.xml -- settings param namemax-sessions value10000/ param namesessions-per-second value100/ param namertp-timer-name valuesoft/ param namertp-rewrite-timestamps valuetrue/ /settings4. 实战构建完整外呼流程4.1 Verto客户端示例代码基于JavaScript的简易外呼界面实现!DOCTYPE html html head script srcverto-min.js/script /head body script const verto new $.verto({ login: 1001yourdomain.com, passwd: password, socketUrl: wss://yourdomain.com:8081, tag: my-verto-phone, ringFile: /sounds/ring.wav }); function startCall() { verto.dialog({ destination_number: 1002yourdomain.com, caller_id_name: AI外呼系统, caller_id_number: 1001, useVideo: false, useStereo: true, screenShare: false }); } /script button onclickstartCall()启动外呼/button /body /html4.2 外呼状态管理通过FreeSWITCH的Event Socket接口实现外呼状态监控import ESL conn ESL.ESLconnection(localhost, 8021, ClueCon) def event_handler(event): if event.getHeader(Event-Name) CHANNEL_CREATE: print(f呼叫开始: {event.getHeader(Caller-Destination-Number)}) elif event.getHeader(Event-Name) CHANNEL_ANSWER: print(f呼叫应答: {event.getHeader(Caller-Destination-Number)}) elif event.getHeader(Event-Name) CHANNEL_HANGUP: print(f呼叫结束: {event.getHeader(Hangup-Cause)}) conn.events(plain, all) while conn.connected(): event conn.recvEvent() if event: event_handler(event)4.3 常见问题排查指南问题1媒体流单向通话检查NAT穿越配置确保ext-rtp-ip设置正确验证防火墙规则开放UDP端口16384-32768测试STUN服务stun.l.google.com:19302问题2高并发下呼叫失败检查系统资源top -H查看线程使用情况调整会话限制修改switch.conf.xml中的max-sessions优化数据库连接如使用PostgreSQL调整连接池大小问题3语音识别延迟高检查MRCP服务响应时间调整编解码优先级优先使用Opus优化网络路径确保AI引擎与FreeSWITCH间低延迟5. 生产环境部署建议5.1 高可用架构设计推荐的多节点部署方案[负载均衡] → [FreeSWITCH节点1] → [Redis共享状态] ↘ [FreeSWITCH节点2] → [PostgreSQL集群]关键组件说明HAProxy用于WebSocket连接的负载均衡配置长连接保持Redis存储实时会话状态支持故障转移PostgreSQL记录CDR呼叫详单和系统日志5.2 监控与告警配置必备的监控指标指标类别具体指标告警阈值系统资源CPU使用率80%持续5分钟网络质量丢包率3%服务状态在线会话数最大容量90%业务指标外呼应答率行业基准20%使用PrometheusGrafana的示例配置# prometheus.yml scrape_configs: - job_name: freeswitch static_configs: - targets: [fs1:8021, fs2:8021] metrics_path: /metrics params: format: [prometheus]5.3 安全加固措施必须实施的安全策略通信加密强制TLS 1.2 for Verto WebSocketSRTP加密媒体流访问控制IP白名单限制管理接口访问双因素认证控制台登录数据安全录音文件加密存储敏感信息(如密码)使用Vault管理具体实施命令# 生成SRTP加密密钥 openssl rand -hex 32 /usr/local/freeswitch/conf/ssl/srtp_key # 配置TLS协议限制 sed -i s/ssl-protocols.*/ssl-protocols TLSv1.2 TLSv1.3;/ \ /etc/nginx/nginx.conf