freeswitch SIP信令的接收

最新推荐文章于 2025-09-28 12:59:50 发布
原创 最新推荐文章于 2025-09-28 12:59:50 发布 · 4.3k 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文深入探讨了Freeswitch中SIP信令的接收与处理流程，从mod_sofia加载开始，解析配置文件创建sofia_profile_t结构体，通过nua_create()设立监听端口，并在接收到SIP消息时调用sofia_event_callback()进行处理。文章详细介绍了session的创建、tech_pvt对象的初始化以及消息队列的使用，揭示了SIP请求和响应消息如何在Freeswitch内部被处理。

freeswitch SIP信令的处理在mod_sofia中
首先在模块的加载(mod_sofia_load)里面会创建一个处理SIP消息的线程:

    /* start one message thread */
    switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_INFO, "Starting initial message thread.\n");
    sofia_msg_thread_start(0);

然后会调用config_sofia函数.

    if (config_sofia(SOFIA_CONFIG_LOAD, NULL) != SWITCH_STATUS_SUCCESS) {
        mod_sofia_globals.running = 0;
        return SWITCH_STATUS_GENERR;
    }

在这个函数里面，会解析conf/sip_profiles里面的profile文件。比如我们熟悉的nternal和external文件就是在这里解析的。解析完后自然就生产了一个对应的C语言里面的sofia_profile_t结构体。
得到sofia_profile_t对象后，会调用launch_sofia_profile_thread()函数

void launch_sofia_profile_thread(sofia_profile_t *profile)
{
    //switch_thread_t *thread;
    switch_threadattr_t *thd_attr = NULL;

    switch_threadattr_create(&thd_attr, profile->pool);
    switch_threadattr_detach_set(thd_attr, 1);
    switch_threadattr_stacksize_set(thd_attr, SWITCH_THREAD_STACKSIZE);
    switch_threadattr_priority_set(thd_attr, SWITCH_PRI_REALTIME);
    switch_thread_create(&profile->thread, thd_attr, sofia_profile_thread_run, profile, profile->pool);
}

在这里会创建一个新的线程，并在新线程里面调用nua_create()创建一个UA(User agent),在nua_create（）里面就会创建对应的socket端口（比如我们熟悉的5060），在这个端口你们监听其他人发来的SIP消息。当收到SIP消息后会回调sofia_event_callback（）进行处理。

profile->nua = nua_create(profile->s_root,  /* Event loop */
                                  sofia_event_callback, /* Callback for processing events */
                                  profile,  /* Additional data to pass to callback */
                                  TAG_IF( ! sofia_test_pflag(profile, PFLAG_TLS) || ! profile->tls_only, NUTAG_URL(profile->bindurl)),
                                  NTATAG_USER_VIA(1),
                                  TPTAG_PONG2PING(1),
                                  NTATAG_TCP_RPORT(0),
                                  NTATAG_TLS_RPORT(0),
                                  NUTAG_RETRY_AFTER_ENABLE(0),
                                  TAG_IF(!strchr(profile->sipip, ':'),
                                         SOATAG_AF(SOA_AF_IP4_ONLY)),
                                  TAG_IF(strchr(profile->sipip, ':'),
                                         SOATAG_AF(SOA_AF_IP6_ONLY)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS),
                                         NUTAG_SIPS_URL(profile->tls_bindurl)),
                                  TAG_IF(profile->ws_bindurl,
                                         NUTAG_WS_URL(profile->ws_bindurl)),
                                  TAG_IF(profile->wss_bindurl,
                                         NUTAG_WSS_URL(profile->wss_bindurl)),
                                  TAG_IF(profile->tls_cert_dir,
                                         NUTAG_CERTIFICATE_DIR(profile->tls_cert_dir)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS) && profile->tls_passphrase,
                                         TPTAG_TLS_PASSPHRASE(profile->tls_passphrase)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS),
                                         TPTAG_TLS_VERIFY_POLICY(profile->tls_verify_policy)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS),
                                         TPTAG_TLS_VERIFY_DEPTH(profile->tls_verify_depth)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS),
                                         TPTAG_TLS_VERIFY_DATE(profile->tls_verify_date)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS) && profile->tls_verify_in_subjects,
                                         TPTAG_TLS_VERIFY_SUBJECTS(profile->tls_verify_in_subjects)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS),
                                         TPTAG_TLS_CIPHERS(profile->tls_ciphers)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS),
                                         TPTAG_TLS_VERSION(profile->tls_version)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TLS) && profile->tls_timeout,
                                         TPTAG_TLS_TIMEOUT(profile->tls_timeout)),
                                  TAG_IF(!strchr(profile->sipip, ':'),
                                         NTATAG_UDP_MTU(65535)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_DISABLE_SRV),
                                         NTATAG_USE_SRV(0)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_DISABLE_NAPTR),
                                         NTATAG_USE_NAPTR(0)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TCP_PINGPONG),
                                         TPTAG_PINGPONG(profile->tcp_pingpong)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TCP_PING2PONG),
                                         TPTAG_PINGPONG(profile->tcp_ping2pong)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_DISABLE_SRV503),
                                         NTATAG_SRV_503(0)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_SOCKET_TCP_KEEPALIVE),
                                         TPTAG_SOCKET_KEEPALIVE(profile->socket_tcp_keepalive)),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_TCP_KEEPALIVE),
                                         TPTAG_KEEPALIVE(profile->tcp_keepalive)),
                                  NTATAG_DEFAULT_PROXY(profile->outbound_proxy),
                                  NTATAG_SERVER_RPORT(profile->server_rport_level),
                                  NTATAG_CLIENT_RPORT(profile->client_rport_level),
                                  TPTAG_LOG(sofia_test_flag(profile, TFLAG_TPORT_LOG)),
                                  TPTAG_CAPT(sofia_test_flag(profile, TFLAG_CAPTURE) ? mod_sofia_globals.capture_server : NULL),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_SIPCOMPACT),
                                         NTATAG_SIPFLAGS(MSG_DO_COMPACT)),
                                  TAG_IF(profile->timer_t1, NTATAG_SIP_T1(profile->timer_t1)),
                                  TAG_IF(profile->timer_t1x64, NTATAG_SIP_T1X64(profile->timer_t1x64)),
                                  TAG_IF(profile->timer_t2, NTATAG_SIP_T2(profile->timer_t2)),
                                  TAG_IF(profile->timer_t4, NTATAG_SIP_T4(profile->timer_t4)),
                                  SIPTAG_ACCEPT_STR("application/sdp, multipart/mixed"),
                                  TAG_IF(sofia_test_pflag(profile, PFLAG_NO_CONNECTION_REUSE),
                                         TPTAG_REUSE(0)),
                                  TAG_END());   /* Last tag should always finish the sequence */

创建UA后还会创建一个Endpoint，并给这个Endpoint绑定state_handler,io_routines等回调函数。state_handler是状态处理函数，当Endpoint里面的session的状态发生变化时会回调这些函数。io_routines是一系列常用的io操作，比如发起外呼，读取音频数据帧等。

    /* connect my internal structure to the blank pointer passed to me */
    *module_interface = switch_loadable_module_create_module_interface(pool, modname);
    sofia_endpoint_interface = switch_loadable_module_create_interface(*module_interface, SWITCH_ENDPOINT_INTERFACE);
    sofia_endpoint_interface->interface_name = "sofia";
    sofia_endpoint_interface->io_routines = &sofia_io_routines;
    sofia_endpoint_interface->state_handler = &sofia_event_handlers;
    sofia_endpoint_interface->recover_callback = sofia_recover_callback;

如上面说的在收到一个SIP消息后会调用sofia_event_callback（）处理对应的消息。在这里我们可以看到各种熟悉的信令了。我们一INVITE为例分析一下。在这个之前先提一下一个重要的函数:

void nua_respond(nua_handle_t *nh,
         int status, char const *phrase,
         tag_type_t tag, tag_value_t value,
         ...)

这个函数就是发送SIP信令。
然后继续讨论一下sofia_event_callback（）函数,如果事件的类型为：nua_i_invite，会先调用switch_core_session_request_uuid（）创建一个session，如果session创建成功，还会创建一个对应的tech_pvt对象。

        if (sofia_test_pflag(profile, PFLAG_CALLID_AS_UUID)) {
            session = switch_core_session_request_uuid(sofia_endpoint_interface, SWITCH_CALL_DIRECTION_INBOUND, SOF_NONE, NULL, sip->sip_call_id->i_id);
        } else {
            session = switch_core_session_request(sofia_endpoint_interface, SWITCH_CALL_DIRECTION_INBOUND, SOF_NONE, NULL);
        }

        if (session) {
            const char *channel_name = NULL;
            tech_pvt = sofia_glue_new_pvt(session);

初始化并设置tech_pvt结构体。然后调用sofia_glue_attach_private把这个对象绑定到对应的session上面。

            sofia_glue_attach_private(session, profile, tech_pvt, channel_name);

            set_call_id(tech_pvt, sip);

最后调用sofia_queue_message(de);将事件放到一个队里里面去，以处理一些耗时的操作。

//static int foo = 0;
void sofia_queue_message(sofia_dispatch_event_t *de)
{
    int launch = 0;

    if (mod_sofia_globals.running == 0 || !mod_sofia_globals.msg_queue) {
        sofia_process_dispatch_event(&de);
        return;
    }


    if (de->profile && sofia_test_pflag(de->profile, PFLAG_THREAD_PER_REG) &&
        de->data->e_event == nua_i_register && DE_THREAD_CNT < mod_sofia_globals.max_reg_threads) {
        sofia_process_dispatch_event_in_thread(&de);
        return;
    }


    if ((switch_queue_size(mod_sofia_globals.msg_queue) > (SOFIA_MSG_QUEUE_SIZE * (unsigned int)msg_queue_threads))) {
        launch++;
    }


    if (launch) {
        if (mod_sofia_globals.msg_queue_len < mod_sofia_globals.max_msg_queues) {
            sofia_msg_thread_start(mod_sofia_globals.msg_queue_len + 1);
        }
    }

    switch_queue_push(mod_sofia_globals.msg_queue, de);
}

在这里面先判断一下是否需要增加消费线程，要的话就增加，然后调用switch_queue_push()将消息推送到真正的消息队里里面。
刚刚启动的那些消费线程，真正的执行函数是：sofia_msg_thread_run（）

//static int count = 0;

void *SWITCH_THREAD_FUNC sofia_msg_thread_run(switch_thread_t *thread, void *obj)
{
    void *pop;
    switch_queue_t *q = (switch_queue_t *) obj;
    int my_id;


    for (my_id = 0; my_id < mod_sofia_globals.msg_queue_len; my_id++) {
        if (mod_sofia_globals.msg_queue_thread[my_id] == thread) {
            break;
        }
    }

    switch_mutex_lock(mod_sofia_globals.mutex);
    msg_queue_threads++;
    switch_mutex_unlock(mod_sofia_globals.mutex);

    switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_WARNING, "MSG Thread %d Started\n", my_id);


    for(;;) {

        if (switch_queue_pop(q, &pop) != SWITCH_STATUS_SUCCESS) {
            switch_cond_next();
            continue;
        }

        if (pop) {
            sofia_dispatch_event_t *de = (sofia_dispatch_event_t *) pop;
            sofia_process_dispatch_event(&de);
        } else {
            break;
        }
    }

    switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_WARNING, "MSG Thread Ended\n");

    switch_mutex_lock(mod_sofia_globals.mutex);
    msg_queue_threads--;
    switch_mutex_unlock(mod_sofia_globals.mutex);

    return NULL;
}

所以实际调用的是sofia_process_dispatch_event（），而sofia_process_dispatch_event()实际调用的是：our_sofia_event_callback()来处理接收到的消息。在这里我们终于看到各种事件的处理了。在switch的各个分支中，我们可以看到许多以nua_r和nua_i开头的SIP event。其中，前者标识收到一条响应（Response）消息，后者表示收到一条请求消息。当收到一条请求消息时：

    case nua_i_invite:
        if (session && sofia_private) {
            if (sofia_private->is_call > 1) {
                sofia_handle_sip_i_reinvite(session, nua, profile, nh, sofia_private, sip, de, tags);
            } else {
                sofia_private->is_call++;
                sofia_handle_sip_i_invite(session, nua, profile, nh, sofia_private, sip, de, tags);
            }
        }
        break;

也就是会调用sofia_handle_sip_i_invite来处理。

Freeswitch服务+语音网关设备发送短信功能
giscong的博客
04-13 3424
本文档主要介绍的是发送短信的场景。语音通讯后续补充。 业务场景：由于产品部署在视频网、或者公安网这种内部网络，无法使用互联网，发送短信提醒的实现方案有两种 一种是是使用短信猫设备，插入手机卡，调用短信猫服务发送短信 一种就是使用本文介绍这种方式使用FreeSwitch服务+语音网关设备（插入手机卡） FreeSwitch是什么 FreeSwitch 是一个软交换，是一个SIP Server，是一个IP-PBX SIP: 是一种源于互联网的IP，语音会话控制协议。 SIP Server: 可以提供一个S.
FreeSwitch Sip
RTC hacker
11-27 5177
在继续学习 FreeSWITCH 之前我们有必要来学习一下 SIP 协议，因为它是 FreeSWITCH 的核心。但即使如此，讲清楚 SIP 必然需要很大篇幅，本书是关于 FreeSWITCH 的，而重点不是 SIP。因此，我将仅就理解 FreeSWITCH 必需的一些概念加以通俗的解释，更严肃一些的请参阅其它资料或 RFC（Request For Comments）。SIP 的概念和相关元素会话初始协议（Session Initiation Protocol）是一个控制发起、修改和终结交互式多媒体会话的信
FreeSWITCH给指定地址发送SIP Message
fs交流的博客
02-18 1735
发送sip message到指定的ip
FreeSWITCH 发送 SIP Message 怎样指定 Proxy
fs交流的博客
12-18 300
我之前写过一篇文章， 终端注册请求发到 OpenSIPS, 后者加 path 头之后 relay 到 Fs。Fs 呼叫终端是没问题的，但 Fs 通过 chat 给终端发 SIP Mesage 可要了命了,直接出错。留意 contact-uri, to-uri, and from-uri。查到一篇文档，按我现在的理解，要 fire 这样一个 event。可查下官方 mod_event_socket 的相关资料。chat 肯定不行，不支持 sip proxy。那这问题到底要怎样解决呢？
SIP协议深度解析与实战应用：从信令机制到SDP会话描述
最新发布
weixin_35826166的博客
09-28 1597
起始行是每个SIP消息的第一行，用于标识该消息的基本性质。根据消息类型的不同，起始行分为“请求行”和“状态行”。请求行出现在请求消息中，格式如下：示例：text参数说明：Method：表示请求的操作类型，如INVITE、REGISTER等；：指示目标用户的地址，通常为SIP URI格式（sip:user@domain）；：当前固定为SIP/2.0，代表使用的协议版本。此结构借鉴了HTTP的设计思想，但语义更侧重于会话生命周期管理而非资源获取。
Freeswitch学习笔记（一）：Sip协议
weixin_42211693的博客
06-07 2705
SIP定义了6种基本方法除此之外，SIP还定义了一些扩展方法，如SUBSCRIBE、NOTIFY、MESSAGE、REFER、INFO等， 无论是基本方法还是扩展方法，所有 SIP 消息都必须包含以下6个头域。
FreeSwitch与Java通信ESL
精益求精
08-12 2705
主要通过Java ESL链接FreeSWITCH的简单例子，通过异步发送呼叫相关指令和监听FS的相关事件，为今后搭建呼叫中心或智能外呼做准备。
freeSwitch SIP 模块分析
05-01
freeSwitch中的SIP模块是其核心功能之一，它负责处理SIP消息的接收、解析、路由和响应。在这个模块中，我们可以学习到如何处理SIP请求和响应，以及如何与其他通信系统进行交互。SIP模块的工作流程通常包括注册、邀请...
【Freeswitch从入门到精通】三、SIP和SDP理解
feifeiyechuan的博客
04-14 3821
【Freeswitch从入门到精通】二、SIP和SDP理解1、SIP和SDP理解 1、SIP和SDP理解 1）默认编译安装目录：/usr/local/freeswitch 2）生成默认的配置文件： make samples 3）启动 前台启动：/user/local/freeswitch/bin/freeswitch -nonat 后台启动：/user/local/freeswitch/bin/freeswitch -nonat -nc 4）列出freeswitch状态：status 5）sofia s
sipp模拟uas发送update
求真得真的博客
08-30 1006
freeswitch是一款简单好用的VOIP开源软交换平台。但是fs在处理update消息时候有BUG，为了复现问题，使用sipp模拟uas，发送update并发送DTMF码。本文档记录sipp的配置方案。sipp很灵活，可以帮助我们在测试中构建各种模拟场景。修复方案有多种，后续安排上。空空如常求真得真。
freeswitch如何解决sip信令的NAT问题
求真得真的博客
12-08 1593
freeswitch是一款简单好用的VOIP开源软交换平台。公网环境复杂多变，客户环境更是各种稀奇古怪的问题。fs在针对sip信令的NAT问题有针对性的参数设置。本文讨论的范围限于fs的公网地址正常没有在NAT后面的两种常见场景。其他更多更复杂的NAT场景暂不讨论。本文仅仅讨论了两种比较简单常见的NAT问题，公网环境中的NAT问题更加的复杂多变。对于NAT问题的通用思路是想办法找到对方或自己的公网地址，在消息传递过程中使用各种手段透传过NAT网关。空空如常求真得真。
freeswitch 用ESL 查询sip用户注册状态
xly_971223的专栏
02-04 3698
直接上代码 核心代码 [code="java"]EslMessage response = client.sendSyncApiCommand("sofia xmlstatus", "profile internal reg 1002"); [/code] [code="java"] public void sofia_contact() { Cli...
【FreeSWITCH】通过ESL控制FreeSWITCH向另外一个FreeSWITCH的user发起呼叫
qq88548886的博客
03-07 1095
​ 假如我们需要控制191.168.191.113这个FreeSWITCH向191.168.191.63上的FreeSWITCH的user发起呼叫，我们需要在191.168.191.63定义domain，user以及acl规则，然后通过ESL控制191.168.191.113发起originate指定即可。
freeswitch中文本消息处理流程
极乐净土
05-05 5662
如下图所示： 1. 系统聊天信息添加到对应队列，在“chat_thread_run”函数中pop消息，并进行处理，调用“nua_message”把消息发送出去（nua_message只是给系统发一个信号，告诉系统有消息要发送，具体在哪发送没找到，sofia-sip这套代码读起来对我来说有点难，但又是系统的核心） 下来首先要做的应该理清freeswitch和sofia-sip的消息机制是
Freeswitch配置：一台Freeswitch向另外一台Freeswitch转发视频会议命令
柳鲲鹏
09-18 1772
　　场景是： 终端登录在Freeswitch A服务器。 终端呼叫视频会议房间３５００。 Freeswitch A服务器把视频指令转发到Freeswitch B服务器。 　　修改Freeswitch A服务器配置，文件是freeswitch/dialplan/default.xml。在<context name="default">下增加转发指令： <extension name="meeting"> <condition field="des
FreeSwitch系列之接收消息处理流程
cww_zju_amdocs的专栏
11-11 721
接收消息处理流程 tport_wakeup_pri在profile clone线程中被触发。 1、接收消息 2、解析消息成结构体msg 3、找到leg去处理请求 4、创建irq 5、执行leg的回调函数，转到nua_handle层去处理。 6、找到method。 7、执行三部曲：init-->preprocess-->report tport_wakeup_pri =>tport_recv_event =>tport_recv_data(self);
Freeswitch 结合AIO100语音网关 发送短信
Vincent_PC的博客
04-23 1290
Freeswitch 结合AIO100语音网关发送短信 网关支持插入sim卡创建sip服务，在freeswitch中连上sip freeswitch@ZPGATE> sofia status Name Type Data State ====================================================================.
freeswitch公开教程-ESL
老银的博客
01-22 4079
freeswitch-esl
智能客服搭建(3) - MRCP Server 与 FreeSWITCH 对接
小爱玄策
07-31 6941
文章目录1. 写在前面2. MRCP Server 配置与测试2.1 MRCP Server 配置2.2 MRCP Server 测试3. FreeSwitch 配置3.1. 配置 mrcp profile3.2. 配置 mrcp conf3.3. 配置拨号任务4. 效果测试 1. 写在前面   上一篇文章中，对MRCP Server的开发进行了介绍，下面讲解如何通过配置让FreeSWITCH能够与MRCP Server进行对接，获得电话呼叫的语音识别结果。 2. MRCP Server 配置与测试 2.1
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值