2024年超详细OpenSIPS动态路由实战指南：从0到1掌握drouting模块部署与优化

2024年超详细OpenSIPS动态路由实战指南：从0到1掌握drouting模块部署与优化

大家好！今天咱们来聊聊SIP服务器里的"智能导航系统"——OpenSIPS的drouting模块。你可以把它想象成电话网络里的"高德地图"，不管是从A地打电话到B地，还是要选最便宜、最快捷的线路，它都能帮你搞定。作为一个带过50+新手的技术老鸟，我发现很多人学drouting都卡在"概念太抽象"、"配置没头绪"这两个坎上。今天咱们就用最接地气的方式，把这个"电话导航系统"彻底讲明白，保证看完就能上手实操！

一、drouting到底是个啥？用生活例子给你讲透

假设你在上海要打电话给北京的朋友，你的手机(相当于FreeswitchA)会先连接到最近的移动基站(相当于OpenSIPS)。基站需要决定：走联通的线路？还是电信的线路？哪个更便宜？哪个信号更好？drouting模块就是干这个决策工作的。它就像基站里的智能调度员，会根据你设置的"导航规则"(比如"所有138开头的号码走联通线路")，把你的电话高效地送到目的地。

专业点说，drouting是Dynamic Routing的缩写，中文叫"动态路由"模块。它最牛的本事是能根据号码前缀、时间段、网关状态这些条件，自动帮你选一条最合适的通话线路。比如你可以设置：工作日8点到18点打长途走A运营商(便宜)，晚上和周末走B运营商(音质好)；如果A运营商线路出问题了，自动切换到C运营商——这些复杂逻辑，drouting都能轻松搞定。

二、核心组件大白话解析：5张表就是你的"导航数据库"

drouting模块的所有"导航规则"都存在5张数据库表里，咱们一个个看：

1. dr_gateways（网关表）：相当于你手机里存的"联系人"，记录着每个目的地的具体信息。比如"张三"这个联系人，你得存他的电话号码(地址)、是移动还是联通用户(类型)、现在能不能打通电话(状态)。这里的每个"联系人"就是一个网关，gwid是联系人ID，address是他的"电话号码"(格式是ip:port)，state字段记录他"是不是在忙线中"(0=可用，1=禁用，2=正在尝试联系)。

举个例子，如果你要添加FreeswitchB作为网关，就像存一个新联系人：

- gwid=2（相当于联系人ID）

- address="192.168.137.32:5080"（对方的"电话号码"）

- probe_mode=2（一直保持联系，就像你总给好朋友发消息确认在不在）

- state=0（当前可用，不是忙线）

2. dr_rules（规则表）：这是你的"通话规则手册"。比如"所有打给北京的电话(前缀010)都先打给张三(gwid=2)，如果他不接再打给李四(gwid=3)"。这里的prefix字段就是"北京区号010"，gwlist字段就是"先打给2号联系人，再打给3号联系人"。priority字段是规则的优先级，就像"紧急电话优先于普通电话"。

3. dr_carriers（运营商表）：可以理解成"联系人分组"。比如把所有移动号码归为"移动好友组"，联通号码归为"联通好友组"。carrierid是组ID，gwlist字段存着这个组里所有联系人的ID。

4. dr_groups（用户组表）：记录"哪些用户属于哪个规则组"。比如"公司所有销售都用A线路，技术部用B线路"。username字段是用户名(比如分机号1001)，groupid对应到dr_rules里的规则组。

5. dr_partitions（分区表）：这个用得少，可以理解成"不同城市的通讯录"。比如上海分公司用一个通讯录，北京分公司用另一个，互相不干扰。

三、手把手教你装模块：3步完成基础配置

3.1 先检查环境：这些工具必须有

在开始前，确保你的CentOS 7.6服务器上已经装好了这些"工具箱"：

- MySQL数据库（用来存咱们刚才说的5张表）

- OpenSIPS 2.4.9源码包（别用太高版本，新手容易踩坑）

- 开发工具包：`yum install -y gcc make mysql-devel openssl-devel`

3.2 编译安装：带drouting模块的OpenSIPS

1. 解压源码包：`tar zxvf opensips-2.4.9.tar.gz`

2. 进入目录：`cd opensips-2.4.9`

3. 运行配置脚本，重点是启用drouting模块：

```bash

make menuconfig

```

在弹出的界面里，找到"Modules" -> "Database" -> 勾选"db_mysql"（数据库支持），再找到"Routing" -> 勾选"drouting"（动态路由模块），按ESC保存退出。

4. 编译安装：`make all && make install`

3.3 创建数据库：自动生成5张"导航表"

OpenSIPS提供了自动建表脚本，不用你手动写SQL：

1. 进入脚本目录：`cd /usr/local/opensips/share/opensips/dbtext`

2. 执行建表命令（记得替换数据库密码）：

```bash

opensipsdbctl create drouting

```

系统会自动在MySQL里创建opensips数据库，并生成dr_gateways、dr_rules等5张表。

四、实战配置：把FreeswitchA的电话转到FreeswitchB

现在咱们来实现一个实际需求：当FreeswitchA(192.168.137.31:5080)上的分机1001打电话时，OpenSIPS要把这个电话转到FreeswitchB(192.168.137.32:5080)。

4.1 配置数据库：添加"导航规则"

第一步：添加网关（往dr_gateways表插数据）

就像存一个新联系人，执行SQL：

```sql

INSERT INTO dr_gateways (gwid, address, type, strip, pri_prefix, probe_mode, state, socket, description)

VALUES (2, '192.168.137.32:5080', 'freeswitch', 0, '', 2, 0, 'udp:192.168.137.33:5060', 'FreeswitchB网关');

```

这里的socket字段要填OpenSIPS自己的IP和端口，就像你给别人打电话时用自己的号码拨号。

第二步：添加路由规则（往dr_rules表插数据）

设置"所有1001分机打来的电话都走2号网关"：

```sql

INSERT INTO dr_rules (ruleid, groupid, prefix, priority, gwlist, description)

VALUES (1, 200010, '1001', 10, '2', '1001分机路由规则');

```

groupid设为200010，后面会用到。

第三步：关联用户和规则组（往dr_groups表插数据）

告诉系统"分机1001属于200010这个规则组"：

```sql

INSERT INTO dr_groups (username, domain, groupid, description)

VALUES ('1001', '', 200010, '1001分机所属组');

```

4.2 修改opensips.cfg：让"导航系统"工作起来

打开配置文件：`vi /usr/local/opensips/etc/opensips/opensips.cfg`

第一步：加载drouting模块

在modules部分添加：

```

loadmodule "drouting.so"

modparam("drouting", "db_url", "mysql://opensips:opensipsrw@localhost/opensips")

```

这里的db_url就是你的数据库连接信息，格式是"数据库类型://用户名:密码@地址/数据库名"。

第二步：设置探测参数（可选但重要）

就像定期检查联系人是否能打通电话，添加：

```

modparam("drouting", "probing_interval", 60) 每60秒检查一次网关状态

modparam("drouting", "probing_method", "OPTIONS") 用OPTIONS消息"敲门"检查

modparam("drouting", "from_uri", "sip:probe@192.168.137.33") 检查时用的"来电显示"

```

第三步：在路由逻辑里调用do_routing函数

在route{}块里添加：

```

if (is_method("INVITE")) { 如果是通话请求

调用drouting进行路由，"0"表示使用默认分区

if (!do_routing("0")) {

send_reply("503", "No Route Available"); 如果没找到路由，返回"无法接通"

exit;

}

route(relay); 找到路由后转发呼叫

exit;

}

```

注意这个坑：如果不检查do_routing的返回值，当没有可用路由时，脚本会继续往下执行，导致逻辑混乱。

4.3 配置FreeswitchB：准备好接电话

在FreeswitchB的public.xml拨号方案里添加：

```xml

```

这样当电话打过来时，FreeswitchB会自动接听并播放欢迎语。

4.4 启动测试：一步步验证

1. 重启OpenSIPS：`opensipsctl restart`

2. 在FreeswitchA上注册分机1001

3. 用1001拨打号码（比如1234），正常情况下FreeswitchB会接听

4. 抓包验证：用tcpdump在OpenSIPS服务器上抓包：`tcpdump -i eth0 port 5060`，能看到OpenSIPS把呼叫转发到192.168.137.32:5080

五、新手必看：避坑清单和故障排除

5.1 新手常踩的8个坑（附解决方案）

1. 数据库连接失败：检查db_url参数是否正确，MySQL用户是否有权限。可以用`mysql -uopensips -popensipsrw -hlocalhost opensips`测试连接是否正常。

2. do_routing返回false：先检查dr_rules表有没有匹配的规则，再看dr_gateways表的state是不是0(可用)。可以用`opensipsctl dr show gateways`命令查看网关状态。

3. 网关探测失败：确保probe_mode不是0(不探测)，socket字段填的是OpenSIPS已经监听的地址（用`opensipsctl ps`能看到监听的socket）。

4. 号码前缀不匹配：比如规则里prefix是"100"，但实际呼叫的号码是"1001"，这时候需要设置strip字段（比如strip=3，就会把"1001"变成"1"再匹配）。

5. 忘记加载数据库模块：必须同时加载db_mysql和drouting模块，否则drouting找不到数据库。

6. 规则优先级问题：当多个规则都匹配时，priority值小的规则先执行（比如priority=5比priority=10优先）。

7. gwlist格式错误：多个网关ID要用逗号分隔，不能有空格，比如"2,3"而不是"2, 3"。

8. SELinux干扰：CentOS默认开启SELinux，可能会阻止OpenSIPS连接数据库。可以临时关闭测试：`setenforce 0`，确认问题后再配置SELinux规则。

5.2 5个常见故障解决案例

故障1：网关显示状态为2（临时禁用）

原因：OpenSIPS正在探测网关，但一直没收到回应

解决：检查网关地址是否可达（`telnet 192.168.137.32 5080`），确保网关配置了正确的SIP监听

故障2：呼叫时返回"503 No Route Available"

排查步骤：

1. 执行`opensipsctl dr show rules`看有没有匹配的规则

2. 执行`opensipsctl dr show gateways`看gwlist里的网关是否可用

3. 检查opensips日志（/var/log/opensips.log），搜索"drouting"关键词

故障3：探测间隔不生效

解决：probing_interval默认是300秒(5分钟)，如果设为0会关闭探测。确保配置了`modparam("drouting", "probing_interval", 60)`且值大于0。

故障4：号码前缀匹配异常

案例：规则prefix是"138"，但呼叫"13800138000"时没匹配

解决：检查dr_rules表的prefix字段是否有多余空格，MySQL里varchar类型可能会自动加空格

故障5：数据库表不存在

解决：重新运行建表命令`opensipsdbctl create drouting`，或者手动执行/usr/local/opensips/share/opensips/dbtext/drouting-create.sql脚本

六、10个实用小技巧：让你的动态路由更智能

1. 按时间段切换路由：在dr_rules表的timerec字段设置时间规则，比如"工作日9点到18点用网关1，其他时间用网关2"。格式是"起始时间|持续时间|频率"，例如"20240101T090000|09H00M|daily"表示每天9点开始，持续9小时。

2. 实现故障转移：在gwlist里设置多个网关ID，用逗号分隔，比如"2,3,4"，drouting会自动按顺序尝试，第一个不可用就试第二个。

3. 按权重分配流量：在dr_gateways表的weight字段设置权重，比如网关2权重10，网关3权重20，那么大概会有1/3的呼叫走网关2，2/3走网关3。

4. 快速临时禁用网关：直接修改dr_gateways表的state字段为1，不用改配置文件，即时生效。

5. 用attrs字段做标签过滤：给网关打标签，比如attrs="lowcost"或"highquality"，然后在do_routing时指定只选某种标签的网关：`do_routing("0", "L", "", "highquality")`。

6. 日志调试技巧：在opensips.cfg里添加`xlog("drouting: gwid=$avp(gwid), address=$avp(address)");`，能在日志里看到选中的网关信息。

7. 定期备份路由规则：用`mysqldump -uopensips -p opensips dr_gateways dr_rules > dr_backup.sql`备份关键表，防止误操作丢失配置。

8. 使用组播地址做网关：如果多个Freeswitch组成集群，可以把网关address设为组播地址，实现负载均衡（需要网络支持组播）。

9. 结合dispatcher模块做负载均衡：drouting选路，dispatcher做同组网关的负载均衡，强强联合。

10. 监控网关状态：写个简单的Python脚本查询dr_gateways表的state字段，当发现状态异常时发邮件告警。

七、长期使用经验分享：从踩坑中总结的6条干货

1. 数据库性能很重要：当规则和网关数量超过1000条时，建议给dr_rules表的prefix和groupid字段建索引，查询速度能提升10倍以上。

2. 分区功能适合多租户场景：如果你的OpenSIPS要给多个公司用，每个公司用独立的路由规则，可以用dr_partitions表设置不同分区，互相不干扰。

3. 探测模式要根据网络情况调整：在不稳定的网络环境，建议用probe_mode=1（禁用时探测），减少不必要的网络流量；稳定环境可用probe_mode=2（始终探测）。

4. 规则优先级设计原则：越具体的规则优先级应该越高，比如"1001"这个具体号码的规则优先级要高于"100"前缀的规则。

5. 定期清理过期规则：就像整理通讯录一样，每季度检查一次dr_rules和dr_gateways，删除不再使用的条目，保持数据库精简。

6. 用版本控制管理配置：把opensips.cfg和SQL备份文件放到Git仓库，每次修改都记录，出问题时能快速回滚。

话说回来，drouting模块虽然功能强大，但新手不用追求一次配置完美。建议先搭个简单环境，实现基本路由功能，再逐步添加探测、故障转移这些高级特性。记住，电话网络的"导航系统"也需要不断"学习"和调整才能达到最佳状态。如果你在实操中遇到问题，欢迎在评论区留言，咱们一起探讨解决方案！

版权声明：本站所有文章皆为原创，欢迎转载或转发，请保留网站地址和作者信息。