FreeSWITCH外呼全攻略：从配置到手机号外呼的完整指南

一、FreeSWITCH外呼系统架构解析

FreeSWITCH作为开源软交换平台，其外呼功能核心由SIP协议栈、拨号计划引擎和媒体处理模块构成。外呼流程可分为三个阶段：号码路由、信令交互和媒体传输。系统通过sofia模块处理SIP信令，dialplan模块执行路由决策，mod_dptools提供呼叫控制功能。

典型外呼场景中，系统首先解析被叫号码格式（如E.164标准），通过拨号计划匹配路由规则，再经由SIP网关发起呼叫。对于手机号外呼，需特别注意号码规范化处理，建议采用正则表达式进行格式校验：

<condition field="${destination_number}" expression="^(\+?86)?1[3-9]\d{9}$">
  <action application="set" data="effective_caller_id_number=1001"/>
</condition>

此规则可匹配中国大陆手机号格式，并设置主叫显示号码。

二、外呼网关配置详解

网关配置是外呼功能的核心环节，需在sip_profiles/external目录下创建网关配置文件。以配置运营商网关为例：

<gateway name="carrier_gateway">
  <param name="proxy" value="sip.carrier.com:5060"/>
  <param name="register" value="true"/>
  <param name="username" value="your_account"/>
  <param name="password" value="your_password"/>
  <param name="realm" value="carrier.com"/>
  <param name="from-user" value="1001"/>
  <variables>
    <variable name="sip_h_X-FS-Source" value="freeswitch"/>
  </variables>
</gateway>

关键参数说明：

• proxy：网关服务器地址
• register：是否需要注册
• from-user：显示的主叫号码
• 自定义头字段可用于传递业务信息

配置完成后需在autoload_configs/sofia.conf.xml中加载网关：

<profiles>
  <profile name="external">
    <gateways>
      <gateway name="carrier_gateway"/>
    </gateways>
  </profile>
</profiles>

三、拨号计划规则编写指南

拨号计划决定号码路由逻辑，典型外呼规则配置如下：

<extension name="mobile_outbound">
  <condition field="destination_number" expression="^1[3-9]\d{9}$">
    <action application="set" data="call_direction=outbound"/>
    <action application="bridge" data="[outbound_route]sofia/gateway/carrier_gateway/${destination_number}"/>
  </condition>
</extension>

进阶配置技巧：

1. 号码预处理：使用execute_extension调用Lua脚本进行号码清洗

   <action application="execute_extension" data="normalize_number XML features"/>

2. 路由优先级：通过continue参数实现多网关备选

   <action application="bridge" data="[outbound_route]sofia/gateway/primary_gw/${destination_number}"/>
   <action application="bridge" data="[outbound_route]sofia/gateway/backup_gw/${destination_number}"/>

3. 呼叫限制：结合limit模块实现并发控制

   <action application="limit" data="outbound_calls !USER ${domain} 5"/>

四、手机号外呼实现方案

4.1 号码规范化处理

建议实现三级校验机制：

1. 正则表达式初步校验
2. Lua脚本进行Luhn算法校验（针对虚拟号段）
3. 数据库黑名单过滤

示例Lua校验脚本：

function is_valid_mobile(number)
  local pattern = "^1[3-9]%d{9}$"
  if not string.match(number, pattern) then
    return false
  end
  -- 添加Luhn算法校验逻辑
  return true
end

4.2 运营商路由策略

根据号段分配路由可显著提升接通率，示例配置：

<extension name="carrier_routing">
  <condition field="${destination_number}" expression="^1(3[0-2]|4[5-9]|5[0-35-9]|6[2567]|7[0-8]|8[0-9]|9[0-35-9])\d{8}$">
    <action application="bridge" data="sofia/gateway/china_mobile/${destination_number}"/>
  </condition>
  <condition field="${destination_number}" expression="^1(3[4-9]|4[0-4]|5[146]|7[15]|8[12467]|9[478])\d{8}$">
    <action application="bridge" data="sofia/gateway/china_unicom/${destination_number}"/>
  </condition>
</extension>

4.3 呼叫质量优化

1. 编解码选择：优先使用PCMA/PCMU保证音质

   <param name="inbound-codec-string" value="PCMA,PCMU,G729"/>
   <param name="outbound-codec-string" value="PCMA,PCMU"/>

2. DTMF处理：启用RFC2833方式

   <param name="dtmf-type" value="rfc2833"/>

3. NAT穿透：配置STUN服务器

   <param name="stun-server" value="stun.example.com:3478"/>

五、故障排查与性能调优

5.1 常见问题诊断

1. 404 Not Found错误：检查拨号计划是否匹配
2. 403 Forbidden错误：验证网关认证信息
3. 503 Service Unavailable：检查网关注册状态

5.2 性能监控指标

建议监控以下关键指标：

• 呼叫建立成功率（ASR）
• 平均呼叫时长（ACD）
• 网关响应时间
• 并发呼叫数

可通过fs_cli命令实时查看：

fs_cli -x "show channels"
fs_cli -x "sofia status profile internal reg"

5.3 容量规划建议

1. 单机建议并发不超过500路
2. 数据库连接池配置建议：

   <param name="odbc-dsn" value="freeswitchfreeswitch"/>
   <param name="odbc-pool-size" value="20"/>

3. 内存优化：调整switch.conf.xml中的内存参数

   <param name="max-sessions" value="10000"/>
   <param name="sessions-per-user" value="50"/>

六、安全防护最佳实践

1. SIP防护：配置mod_sip_security模块

   <param name="block-non-local-ip" value="true"/>
   <param name="auth-calls" value="true"/>

2. 号码隐私保护：启用主叫号码替换

   <action application="set" data="effective_caller_id_number=匿名"/>

3. 日志审计：配置详细的CDR记录

   <param name="cdr-csv-path" value="/var/log/freeswitch/cdr.csv"/>
   <param name="cdr-enable" value="true"/>

七、进阶功能实现

7.1 预测式外呼

结合mod_event_socket实现：

local socket = require("socket")
local conn = socket.tcp()
conn:connect("127.0.0.1", 8021)
conn:send("api originate sofia/gateway/carrier_gateway/13800138000 &bridge(sofia/gateway/carrier_gateway/13900139000)\n")

7.2 呼叫进度分析

通过mod_xml_cdr记录关键事件：

<param name="record-metering" value="true"/>
<param name="track-calls" value="true"/>

7.3 多租户支持

配置虚拟域实现：

<domain name="tenant1.com" parse="true">
  <params>
    <param name="dialplan" value="XML"/>
    <param name="context" value="tenant1"/>
  </params>
</domain>

本指南系统阐述了FreeSWITCH外呼系统的完整实现方案，从基础配置到高级功能均有详细说明。实际部署时建议先在测试环境验证配置，再逐步迁移到生产环境。对于高并发场景，可考虑使用FreeSWITCH集群方案，通过mod_event_socket实现负载均衡。