同一条外呼线路可能同时遇到两种压力。有时是前几通电话还挂着,线路已经占满。有时每通都很短,几秒钟里却进来一大批新呼叫。这两种情况要看不同的数字。先在一台内网 FreeSWITCH 上用 7101、7102 拨两个测试短号,一个验证有人占线时第二通会被拒绝,另一个验证电话已经挂掉,下一通仍可能因为拨得太快被拒绝。全程只用本机拨号计划,没有运营商中继,也不会产生外呼费用。
下面按 FreeSWITCH v1.11.3 的 vanilla 配置写。两部话机已注册,可以进入 default context。准备两个能拨出的账号,其中一部能看 SIP 信令或客户端日志。测试短号使用 7198 和 7199,先确认它们没有被现有分机、短号或兜底路由占用。用了自定义 context,就把文件放到它实际包含的位置,并换掉示例里两处转移目标的 default。
把两种限制放进不同的号码
用 fs_cli -x 'global_getvar conf_dir' 找到配置根目录。打开 dialplan/default.xml,确认它包含 default/*.xml。在 dialplan/default/ 下新建 19_fs19_limit.xml,内容如下。两条规则一条只管并发,一条只管速率,方便用电话测清楚是哪一条在拒绝。
<include>
<!-- 7198:测试同一资源同时只允许一个呼叫。 -->
<extension name="fs19-concurrency">
<condition field="destination_number" expression="^7198$">
<!-- 先占位,再接听;超限送往内部拒绝分支。 -->
<action application="limit" data="hash fs19 concurrency 1 fs19-reject XML default"/>
<action application="answer"/>
<!-- 保持 30 秒,给第二部话机留出测试时间。 -->
<action application="sleep" data="30000"/>
<action application="hangup" data="NORMAL_CLEARING"/>
</condition>
</extension>
<!-- 7199:测试同一窗口最多放行两次。 -->
<extension name="fs19-rate">
<condition field="destination_number" expression="^7199$">
<action application="limit" data="hash fs19 rate 2/15 fs19-reject XML default"/>
<!-- 接通即正常挂断,方便连续拨测。 -->
<action application="answer"/>
<action application="hangup" data="NORMAL_CLEARING"/>
</condition>
</extension>
<!-- 两条路径共用拒绝响应,日志通过 UUID 关联。 -->
<extension name="fs19-reject">
<condition field="destination_number" expression="^fs19-reject$">
<action application="log" data="WARNING fs19 limit branch uuid=${uuid}"/>
<action application="respond" data="503 Service Unavailable"/>
</condition>
</extension>
</include>
并发那行的 hash 指计数后端,由 mod_hash 提供。 fs19 是计数分组,也叫 realm,concurrency 是组内的资源名。两部分一起决定两通呼叫是否共用额度。7101 和 7102 用的是同一对值,所以两部话机争用同一个并发名额。阈值 1 表示最多同时有一个通道占着这份额度。这里把 limit 放在接听之前,被拒绝的来电不会先接通。测试通过后有意保持 30 秒,是为了有时间拿起第二部话机拨号。
rate 是另一个资源。 2/15 要写在同一个参数里,表示该资源每个 15 秒计数窗口最多放行两次。按 v1.11.3 的实现,窗口从一次新窗口内的首个尝试起算,满 15 秒后的下一次尝试开启新窗口。它不逐通回看过去 15 秒,被拒绝的尝试也会增加该窗口的速率读数。两部话机挂断以后,占用数可以回到零,速率额度仍然要等窗口结束。
后面的 fs19-reject XML default 指目标号码、拨号计划类型和 context。失败会转到本地拒绝分支,先记一行带通道 UUID 的日志,再给还没接通的 SIP 呼叫返回 503。省略目标时,实现默认使用 limit_exceeded,需要有相应路由;这个例子写明目标,便于找到是哪一段处理了拒绝。如果后端调用返回失败,limit 也走这里,单凭 503 无法区分达到阈值和后端异常。
加载配置,用两部话机复验
运行以下命令。 module_exists 应返回 true,reloadxml 应成功。若模块未加载,查看 autoload_configs/modules.conf.xml 中是否有对应的 load 项。测试节点已安装模块而当前进程尚未加载时,可在确认变更范围后用 load mod_hash 或 load mod_dptools 加载缺失的模块。模板默认包含两者。
# 查看节点和拨号计划需要的模块。
fs_cli -x 'status'
fs_cli -x 'module_exists mod_dptools'
fs_cli -x 'module_exists mod_hash'
# 文件保存后重新加载 XML。
fs_cli -x 'reloadxml'
# 按相同的 realm 和资源名查询。
fs_cli -x 'limit_usage hash fs19 concurrency'
fs_cli -x 'limit_usage hash fs19 rate rate'
- 7101 拨 7198,接通后保持在线。查
concurrency应见到 1。用 7102 在 30 秒内拨 7198,预期看到 503,7101 仍在线。挂断 7101,等占用读数回到 0,再从 7102 重拨,应能接通。若两次都接通,先确认第二通发起时第一通是否还在,再核对拨号计划日志中是不是命中了同一个资源。 - 速率测试开始前,停拨 7199 至少 15 秒。从 7101 和 7102 在同一个 15 秒窗口内合计发起三次,每次等上一通正常结束再拨。前两次预期接通后立即挂断,第三次预期收到 503。再间隔至少 15 秒拨一次,应重新放行。查询命令末尾的第二个
rate是选项,输出为当前占用/速率读数。围绕窗口记录每一通时间、接通结果和拒绝日志,比等到窗口过后再查一次更容易看清原因。
话机只显示忙音或者呼叫失败时,以客户端日志里的 SIP 响应和 FreeSWITCH 的拒绝日志为准。如果拨 7198 连第一通都失败,先看拨号计划有没有命中。 default/*.xml 在模板已有规则之后被包含,原有匹配可能先接走短号。换一对空闲号码后,配置和拨测号码要一起改。两台节点轮流接受呼叫时,本地 hash 会各自计算。这个实验固定在同一节点;线上要跨节点共享额度,需要按计数后端的一致性和异常处理单独验收。
区分单条线路和整台交换机
线路额度一般放在实际的 bridge 前,资源名对应要限制的那条线路。几个出口共用一份合同额度,就需要让这些路由共用资源名。每个租户单独算,则可用已经认证并映射到内部租户的标识来分组。业务里同时需要并发和速率限制时,仍给两个计数键。先放速率规则时,通过速率检查、随后被并发拒绝的尝试也已计入速率。顺序要和业务对「一次尝试」的定义对上。若把拒绝分支改成备用线路,备用线路也要有独立额度,转移方向不能绕回原分支。RFC 3261 允许 503 带 Retry-After,还建议收到 503 的 SIP 客户端尝试备用服务器。本例未发送这个头字段;对接运营商前用实际链路验证上游如何切换或重试。
整台 FreeSWITCH 还有核心配置。在 autoload_configs/switch.conf.xml 的 settings 中,这两项分别限制同时存在的会话数和每秒创建的新会话数。桥接一通电话通常会创建入腿和出腿,转接、并振也会影响通道数。排查时把 status 的会话读数与具体线路的 limit_usage 对上,别直接拿会话数去换算中继能卖多少路。
<!-- 修改 switch.conf.xml 的 settings 中现有同名项。 -->
<!-- 这里是 v1.11.3 vanilla 模板示例值。 -->
<param name="max-sessions" value="1000"/>
<param name="sessions-per-second" value="30"/>
这两个数字来自版本模板。实验只改短号,不需要改核心上限。若要单独调整核心设置,先保存原文件和 status 输出。 fsctl max_sessions <值> 与 fsctl sps <值> 可在线设置,在维护窗口用 status 确认,配置文件也应同步保存,避免重启恢复原值。按节点逐台调整并保留原配置与运行值,尤其留意调低阈值后正常新呼叫是否开始被拒绝。
还有一种情况是运营商只统计已经接通的呼叫,但这段规则在接听前就开始占用,振铃和等待期间也会算进去。把这两份数据放在一起看时,先问清楚运营商从哪个信令节点开始计数。反馈「线路已满」时,可以在同一次拨测里对照呼入侧有没有走到 bridge、运营商侧有没有收到新的 INVITE,并记下接听前后的占用差异。这样能分清请求是被本机规则拦住,还是已经交给运营商处理。若用 CDR 回查,确认有没有保留未接通记录。只查已接通话单会漏掉被本地拒绝的那部分。
实验结束后,把 19_fs19_limit.xml 移出匹配目录,再执行 reloadxml。确认 7198、7199 已按原拨号计划处理,再用 7101 和 7102 常规互拨,检查原来的呼叫路径。本期示例做了源码和配置核验,以上均为预期观察结果,未接入实际节点拨测。