使用kamailio进行分机注册及互拨

操作系统版本：Debian 12.5_x64

kamailio版本：5.8.2

kamailio作为专业的SIP服务器，可承担注册服务器的角色。今天记录下kamailio作为注册服务器，承接分机注册，并实现相互拨打的过程。

我将从以下几个方面展开：

• 模块配置
• 分机账号添加
• 无rtp代理的分机互拨
• 带rtp代理的分机互拨

• 配套资源下载

一、模块加载

模块文档地址：

https://kamailio.org/docs/modules/5.8.x/modules/registrar.html

模块加载及配置（使用kamailio的默认配置即可）：

loadmodule "registrar.so" 

# ----- registrar params -----
modparam("registrar", "method_filtering", 1)
/* uncomment the next line to disable parallel forking via location */
# modparam("registrar", "append_branches", 0)
/* uncomment the next line not to allow more than 10 contacts per AOR */
# modparam("registrar", "max_contacts", 10)
/* max value for expires of registrations */
modparam("registrar", "max_expires", 3600)
/* set it to 1 to enable GRUU */
modparam("registrar", "gruu_enabled", 0)

kamailio的安装可参考这篇文章：

kamailio5.8安装及配置

二、添加分机

命令格式如下：

kamctl add  <username> <password>

示例：

kamctl add 2001 123456

如果提示如下错误：

ERROR: domain unknown: use usernames with domain or set default domain in SIP_DOMAIN

则需要编辑kamctlrc文件，配置SIP_DOMAIN变量。

账号信息存储在subscriber表中，效果如下：

可使用软电话注册验证，效果如下：

可添加多个用户：

kamctl add 2001 123456
kamctl add 2002 123456

数据表效果如下：

三、分机互拨

这里以内网的场景进行模拟。

分机2001和分机2002注册地址：192.168.137.1

kamailio地址：192.168.137.71

呼叫模型如下：

1、存储注册信息

配置相关模块，示例如下：

loadmodule "db_mysql.so"
loadmodule "usrloc.so"

modparam("usrloc", "db_url", "mysql://root:test_123@192.168.137.1/kamailio71")
modparam("usrloc", "db_mode", 1)
modparam("usrloc", "use_domain", MULTIDOMAIN)

这里db_mode用1，直接写数据库，也可以用2，定时刷新到数据库。

2、添加分机路由

可以使用默认的LOCATION路由，也可以自定义路由，这里以自定义路由为例进行演示。

配置相关模块，示例如下：

loadmodule "sqlops.so"

modparam("sqlops","sqlcon","db=>mysql://root:test_123@192.168.137.1/kamailio71")

sqlops是用于查询数据库的"db=>"是定义的标识，后续查询时用db标签。

添加路由，使用 sql_xquery 函数查询数据库；

route(EXTEN);

路由内容如下：

route[EXTEN] {
    if(!is_method("INVITE"))
        return;
    xlog("L_INFO","rU is $rU \n");

    if (!registered("location")) {
        xlog("L_INFO","$rU not registered\n");
        exit;
    }
    sql_xquery("db","SELECT contact FROM location WHERE username='$rU';","rb");
    if ( $xavp(rb=>contact) == $null) {
        xlog("L_INFO","contact is  null  \n");
    } else {
        xlog("L_INFO","contact is   $xavp(rb=>contact)  \n");
        $du =  $xavp(rb=>contact);
    }
    xlog("L_INFO","rU is $rU , du is $du\n");

    route(RELAY);
    exit;
}

配置截图如下：

3、呼叫测试

这里使用分机2002拨打分机2001，路由成功，效果如下：

配套配置文件可从如下渠道获取：

关注微信公众号（聊聊博文，文末可扫码）后回复 20240902 获取。

这里没有进行rtp代理，sdp里面写的是话机的ip地址：

配套的抓包文件可从如下渠道获取：

关注微信公众号（聊聊博文，文末可扫码）后回复 20240902 获取。

四、添加rtp代理

上述步骤中，实现了sip信令代理，如果要代理rtp数据，可以使用rtpproxy或rtpengine实现，这里以rtpengine为例进行示例。

呼叫模型如下：

1、安装rtpengine

可通过apt安装：

apt install rtpengine

也可通过源码安装，具体参考：

debian10环境安装rtpengine

默认配置文件：

/etc/rtpengine/rtpengine.conf

启动rtpengine：

systemctl start rtpengine

效果如下：

2、配置kamailio

文件：kamailio.cfg

加载模块，并配置参数：

loadmodule "rtpengine.so"

modparam("rtpengine", "rtpengine_sock", "udp:127.0.0.1:2223")

如果使用默认配置文件的规则（kamailio.cfg），需要先定义变量：

#!define WITH_NAT
#!define WITH_RTPENGINE

配置效果如下：

配置路由（在NATMANAGE中，默认配置）：

 if(nat_uac_test("8")) {
        rtpengine_manage("SIP-source-address replace-origin replace-session-connection");
    } else {
        rtpengine_manage("replace-origin replace-session-connection");
    }

也可使用自定义路由（在NATMANAGE中）：

if (has_body("application/sdp")) {
    rtpengine_manage("trust-address replace-origin replace-session-connection");
}

这里以默认配置为例进行演示，配置如下：

重启kamailio服务生效：

systemctl restart kamailio

配套配置文件可从如下渠道获取：

关注微信公众号（聊聊博文，文末可扫码）后回复 20240902 获取。

3、使用rtpengine进行代理

使用2002呼叫2001，并在kamailio上进行抓包。

呼叫效果如下：

使用rtpengine进行rtp代理后，sdp里面写的是kamailio的ip地址：

可使用wireshark播放rtp音频流：

配套抓包文件可从文末提供的渠道获取。

五、资源下载

本文涉及源码及相关文件，可从如下途径获取：

关注微信公众号（聊聊博文，文末可扫码）后回复 20240902 获取。

好，就这么多了，别忘了点赞哈！