All on The SIP Lab

OpenSIPS vs Kamailio，你应该选择哪个？

Wed, 11 Mar 2026 21:05:30 +0800

维度	opensips	kamalio	说明
性能	4.5	5	性能接近
脚本能力	4	5	kmailio脚本更友好，支持预处理，宏
稳定性	4	5	opensips开发更激进，所以稳定性没有kamailio高
特殊能力	5	3	opensips在拓扑隐藏，注册信息同步，动态新增SIP端口方面能力更强

无论从哪些方面，OpenSIPS和Kamailio似乎都可以相互替代。

但是，有几个特别的能力，你可能要提前考虑。

1. 拓扑隐藏能力

1.1. 什么是拓扑隐藏

假设某 VoIP 运营商没有启用拓扑隐藏，对方运营商收到的 INVITE 可能是这样的：

INVITE sip:441234567890@carrierB.net SIP/2.0
Via: SIP/2.0/UDP gw3.carrierA.net:5060;branch=z9hG4bK-342343
Via: SIP/2.0/UDP core-switch1.internal.local:5060;branch=z9hG4bK-983423
Via: SIP/2.0/UDP edge1.carrierA.net:5060;branch=z9hG4bK-238472
From: <sip:+12065550123@carrierA.net>;tag=98324
To: <sip:+441234567890@carrierB.net>
Call-ID: a98sdasdh23@10.12.0.15
Contact: <sip:fs1.internal.local:5060>
Record-Route: <sip:edge1.carrierA.net;lr>
Record-Route: <sip:core-switch1.internal.local;lr>
User-Agent: FreeSWITCH-mod_sofia/1.10

看起来只是普通 SIP 报文，但实际上信息量非常巨大。

Via头会暴露所有经过的节点，只靠一个包就能画出你的 SIP 网络图
Call-ID暴露内网地址：Call-ID: a98sdasdh23@10.12.0.15
User-Agent暴露了服务器类型和版本，黑客会直接去查询对应版本的CVE和漏洞
Record-Route暴露dialog经过哪些节点

黑客利用上面的信息，针对弱点攻击：

SIP flood
REGISTER attack
RTP injection
SIP scanning

启用拓扑隐藏后，对方只能看到一个对外的SIP Server，内部网络信息被完全隐藏。

图解VoIP#1: 你什么时候需要OpenSIPS或kamailio - 软交换架构演进之路

Mon, 09 Mar 2026 18:26:07 +0800

最简单的架构 - 1架构

1架构: 1台FS节点

在一个最简单的VoIP架构里，你只需要部署一台具有公网IP的FreeSWITCH, 就可以开始呼叫业务。

分机直接注册到FS上，然后FS直接对接线路。

但是要不了多久，你就会发现下面的问题：

安全问题：
- FS直接公网暴露，必然面临被攻击的事实。因为对接线路虽然可以设置网络策略，但是分机的IP往往是动态变化的。小型的攻击例如恶意的注册扫描，大型的攻击就是DDOS, 直接打满带宽，导致业务必然中断。
- 一些简单的安全防范，比如默认端口改成非5060的端口，但是使用现代化的端口扫描工具，6W个端口基本上几秒就能扫描完。
高可用问题:
- 单台FS挂掉，业务就中断了
- 停机维护，业务也会中断
扩展问题:
- 当业务上量，一台FS就无法满足，必然要增加新的FS节点。
- 这时候问题就来了
  - 分机信息保存在FS节点中，多FS节点分机注册信息如何同步？
  - 在呼入的时候，是否要通知SIP-线路去增加新的FS节点信息？网络策略是不是又要开一遍？

支持FS动态扩展架构 2+N架构

2+N架构: 2台SIP Proxy，N台FS节点

这种架构特点

SIP Proxy层具有公网IP，无论分机注册，还是对接线路，SIP信令都需要经过SIP Proxy层
分机注册信息也保存在SIP Proxy层，FS不再关心分机的注册地址
SIP Proxy层可以用keep-alive保活，一主一备部署
FS可以无感扩容，由Proxy层来做负载均衡。

在这个架构图里，我没有引入rtpproxy或者rtpengine的，这时候媒体流的走向就比较尴尬。

每台FS还必须要要有公网地址，只有这样分机才能直接对接FS。而原因也很简单，因为opensips或者kamailio没有媒体处理能力。

这种架构还是无法节约EIP, FS还是可能遭受到公网攻击。

2+N+N架构

2+N+N架构: 2台SIP Proxy，N台MediaPrxyo节点, N台FS节点

为了彻底让FS不再供网暴露，我们引入媒体代理层。

这次基于架构2，引入媒体代理集群，例如使用多台rtpengine机群，用来转发UAC <> FS <> 线路之间的媒体流

三明治架构

可以参考 SIPSwse C5架构 https://wdd.js.org/posts/2025/sipwise-c5-arch/

这种架构在媒体层和SIP Proxy层之间又增加一层，我称之为SIP Router层。

ACK消息的URI来自哪里？

Thu, 29 Jan 2026 13:12:36 +0800

简介

这里我们把ACK的场景限定到INVITE收到200响应之后，UAC构造ACK消息的URI来自哪里？

这里的时序图为

sequenceDiagram
    uac ->> uas: INVITE
    uas ->> uac: 200
    uac ->> uas: ACK

我们要把这个问题讲清楚，不要臆造，并且必须提供RFC3261的原文作为参考。

RFC3261解读

📌 13.2.2.4

The UAC core MUST generate an ACK request for each 2xx received from the transaction layer

✏️ 这里说明，在UAC收到INVITE 200 OK后，必须回复ACK消息。

📌 12.2.1.1 Generating the Request

The UAC uses the remote target and route set to build the Request-URI and Route header field of the request. If the route set is empty, the UAC MUST place the remote target URI into the Request-URI. The UAC MUST NOT add a Route header field to the request. If the route set is not empty, and the first URI in the route set contains the lr parameter (see Section 19.1.1), the UAC MUST place the remote target URI into the Request-URI and MUST include a Route header field containing the route set values in order, including all parameters.

天下苦 VOS 久矣

Tue, 06 Jan 2026 19:00:15 +0800

天下苦 VOS 久矣。此言非怒而发，乃久用之后，积怨成理也。

VOS3x、VOS5x，曾有其功。当年软交换荒芜，SIP 规范未成体系，工程师多凭经验行事。VOS 以一套封装良好的系统，解“能跑”之急，立一时之功，不可不认。

然功成之后，不思进化；市占既稳，便少革新。

天下之患，莫大于此。

一、垄断既久，问题反成常态

今之 VOS，已非“可选方案”，而成“默认答案”。

选型之时，不问架构，只问“是不是 VOS”；排障之时，不查协议，只等“厂商回复”。

于是，奇景频出：

SIP 行为异于 RFC，而曰“产品设计如此”
性能瓶颈不可测，而曰“经验上差不多”
复杂需求难以实现，而曰“VOS 不支持”
简单需求可实现，而曰“得加钱”
故障定位止于日志，而曰“已提交工单”

久而久之，问题不再被解决，只是被习惯。

二、用 VOS，工程师何其卑微

用 VOS 者，常有此感：

系统在跑，却不知为何如此跑；问题已现，却不知从何而断。

工程师所做者，不过：

点配置
调参数
猜行为
等回复

软交换本该是工程，却活成了玄学。

三、OpenSIPS / Kamailio：让系统“讲人话”

或问：

“不用 VOS，又当用谁？”

曰：OpenSIPS，Kamailio。

二者之道，不在“省钱”，而在透明：

SIP 即 SIP，不自创私货
路由即代码，行为白纸黑字
性能可压测，瓶颈可定位
出问题先看脚本，而非先写邮件

在此体系之中，系统不再“猜你想要什么”，而是“严格执行你所写之逻辑”。

这是工程，不是占卜。

四、开源之苦，在前；开源之利，在后

诚然，OpenSIPS / Kamailio 不好上手。学习曲线陡峭，踩坑在所难免。

SipWise C5 架构分析 WIP

Thu, 16 Oct 2025 17:39:50 +0800

SIPWISE C5 架构分析

Sipwise C5（又称NGCP——下一代通信平台）是一款基于SIP的开源Class 5 VoIP软交换平台

整体架构上，sipwise C5 是一个三明治架构，除了sipwise, 我也看到过类似的VoIP架构，可见英雄所见略同。

接入层

接入层是整个平台的信令出入口，主要的职责是安全检测和负载均衡。并不具有业务上的功能，另外也不会使用数据库。

职责

外部SIP信令的入口和内部信令的出口
SIP信令完整性检查
拒绝环回SIP信令
DOS攻击检测
暴力攻击检测
TLS转UDP转换
NAT穿透映射

端口

5060, SIP/TCP+UDP, 对外接收SIP消息
5061, SIP/TLS，对外接收TLS消息
5060, XMLRPC/TCP, 对内处理RPC调用，来控制kamailio

这里有个风险，5060/TCP端口同时用来对外处理SIP消息和对接处理RPC调用，难道

实现

参考

使用m4给opensips脚本增加预处理能力

Sat, 02 Aug 2025 11:17:08 +0800

demo 代码仓库： https://cnb.cool/eddie2072/opensips-forum/-/tree/main/how-to-use-m4

使用m4给opensips脚本增加预处理能力

为什么要预处理？

运维便利。有预处理，脚本里的IP地址，端口，密码，用户名等信息，可以由运维人员统一配置，脚本只需要引用配置文件，就可以完成脚本的运行。否则，运维人员只能手工去修改每个配置写死的地方。容易出错，且非常麻烦。

所以，我们在写脚本的时候，需要从脚本中抽离配置性质的数据。例如监听的IP地址，端口，数据库的用户名和密码等信息。

这样脚本就变层两个部份，配置文件 + 脚本本身。

运维人员只需要修改配置文件就可以。以本demo为例子，运维在线上部署脚本，只需要修改env.prd.m4文件就可以。

预处理可以增加脚本的复用性。不同环境，往往需要的功能不同。A环境需要X功能，B环境不需要X功能，那么怎么维护呢。不用怕，有了m4条件分支，可以根据不同不配置，渲染出不同的结果。
m4基本在所有linux都已经安装好了，不用额外在安装依赖。很多有经验的程序员，往往也不知道什么是m4, 其实大名顶顶的autoconf, 底层就依赖了m4。

m4难不难学？

m4语法简单，语法强大，但是我们能用到的，基本不超过5个语法。

定义宏

下面是定义宏的语法，这样写之后，所有字符串ENV_LISTEN_IP都会被替换为127.0.0.1

define(ENV_LISTEN_IP, 127.0.0.1)

引用其他文件

有了引用，我们就不需要把所有功能放到一个大文件中。

include(<<src/loadmodule.m4>>)
include(<<src/request.m4>>)
include(<<src/relay.m4>>)
include(<<src/per_branch_ops.m4>>)
include(<<src/handle_nat.m4>>)
include(<<src/missed_call.m4>>)

ifelse(cond1,cond2, yes, no)

如果cond1和cond2相同，则展开第三个参数yes, 否则展开第四个参数no

ifelse(ENV_ENABLE_NAT,yes,use nat, not use nat)

引号

引号，就是用来告诉m4, 引号里的内容应该看作是一个整体。

m4默认的引号是``’’, 看起来很怪异，很难从视觉上做配对。所有有强迫症，或者视觉洁癖的人，会非常讨厌m4。

define(`ENV_LISTEN_IP', `127.0.0.1')

但是这个引号是可以修改的，我们用changequote去修改默认的引号, 将引号改为<<>>

changequote(<<,>>)
define(<<ENV_LISTEN_IP>>, <<127.0.0.1>>)

如何调试宏, 使用-dV 参数

m4 -dV opensips.m4

解决宏冲突问题

如果脚本里有个变量和m4的宏名字冲突，那么往往会出现一些怪异的问题。

m4早就想到了解决方案，在执行m4时候，可以加上-P参数，m4所有内置的宏就会必须写成以m4_开头。例如

m4_define(<<ENV_LISTEN_IP>>, <<127.0.0.1>>)

m4 -P opensips.m4

m4的劣势

m4没有类似foreach的循环，但是可以通过m4的递归实现。
m4做简单的字符串替换，但是对于复杂字符串处理，m4的效率会比较低，而且语法比较复杂。但是对于处理opensips的配置文件，m4则是刚刚好的完美工具。

有意思的几个扩展

检查宏是否未定义，或者是否为空字符串，空则报错退出

m4_divert(-1)
m4_define(<<ASSERT_NOT_EMPTY>>,<<
    m4_ifelse($1,,<<
        m4_errprint(<<$1 is empty >>)
        m4_m4exit(1)
    >>,)
>>)
m4_divert(0)m4_dnl

ASSERT_NOT_EMPTY(this_is_empty)

foreach 循环

  m4_changequote(<<,>>)m4_dnl
  m4_divert(-1)
  m4_define(<<X_FOREACH>>, <<m4_pushdef(<<$1>>)_foreach($@)m4_popdef(<<$1>>)>>)
  m4_define(<<_arg1>>, <<$1>>)
  m4_define(<<_foreach>>, <<m4_ifelse(<<$2>>, <<()>>, <<>>,
    <<m4_define(<<$1>>, _arg1$2)$3<<>>$0(<<$1>>, (m4_shift$2), <<$3>>)>>)>>)
  m4_divert(0)m4_dnl


  X_FOREACH(x,(a.com,b.com,c.com),
  alias=udp:x
  )

上面会输出

【案例分享】JSSIP 电话无法挂断问题

Tue, 15 Jul 2025 20:00:08 +0800

当听到分机无法挂断电话时，通常有以下几种可能的原因：

在做Record-Route时，使用了错误的内外网IP地址。导致BYE请求按照route头发送时，无法正确找到对应的服务器。
Contact头部的URI不正确，导致BYE请求无法找到对应的服务器。

时序图如下；

sequenceDiagram
autonumber
participant u1 as user1
participant o as opensips
participant u2 as user2

u1->>o: INVITE
o->>u2: INVITE
u2-->>o: 200 OK
o-->>u1: 200 OK
u1->>o: ACK
o->>u2: ACK
u2->>o: BYE
o-->>u2: 477 Send failed (477/TM)

477错误一般是按照route头或者contact转发时，找不到对应的socket。在使用tcp作为传输协议时，例如tcp/tls/wss注册的分机比较常见。

有以下可能

分机到opensips的tcp连接断开
contact使用错误的transport参数

从过观察第2个信令的Conact头，发现transport=ws, User-Agent=JSSip。正常情况下，jssip应该使用wss作为transport。

所以解决办法是，在jssip的配置中，将transport改为wss。

还有一个解决方案，就是让jssip通过nginx转发wss请求，让nginx转发到opensips的ws端口, 也能解决问题。

sequenceDiagram
autonumber

jssip ->> nginx: wss
nginx ->> opensips: ws

【案例分享】外线呼入，SIP分机为何无响应？

Tue, 15 Jul 2025 19:39:57 +0800

案例分享

最近有客户反馈，自己的话机最近一两周都没有收到来电了，感觉很奇怪，他自己呼叫400号码，然后转分机，也接不通。

组网结构

flowchart LR
ua1(分机)
fw1(防火墙)
uas1(SIP服务器)

ua1 --> fw1
fw1 --> uas1

排查思路

首先排查服务端，从日志来看，分机的注册是正常的，每隔30多秒就注册一次。
然后排查呼叫信令图，发现发送给分机的INVITE，分机那边没有任何反应
接着请求客户远程协助，在分机上抓包，发现只能抓到注册包，没有INVITE的回应。
询问客户，他们公司有没有使用防火墙，客户说有。
然后让客户检查他们防火墙的设置，关闭SIP ALG功能，但是也无效
然后让客户找网络负责人，在防火墙上抓包，发现防火墙收到了INVITE，但是没有转发给内部分机, 原因未知
最后找防火墙厂商，发现是防火墙的UDP组包没有开启，开启UDP分片重组后，呼入电话能正常进线

总结

此刻，我回想起曾经写的 UDP分片导致SIP消息丢失

没想到，在防火墙上也遇到了同样的问题。

SIP安全 - DTLS client Hello 攻击白皮书

Mon, 14 Jul 2025 23:13:23 +0800

TL;DR

攻击者伪造DTLS ClientHello消息，在SIP服务器和客户端之间建立一个非预期的连接。导致正常链接被阻断。

影响软件

FreeSWITCH
RTPengine
asterisk
FreePBX

漏洞白皮书

webrtc-hello-race-conditions-paper

表现

应答后呼叫无声

参考

OpenSIPS Summit 2025 速看

Mon, 14 Jul 2025 21:52:23 +0800

2025 年 5 月 27 - 5 月 30 日, OpenSIPS Summit 2025 在荷兰阿姆斯特丹举行。

最近我才有时间，看完所有的会议资料，包括 PDF 和 PPT。

下面是我整理的，认为比较有价值的一些内容。以飨读者。

1. 加强 SDP 处理

对 SDP 的处理，如果用 OpenSIPS 脚本来做，将会非常蹩脚。生产环境一般都是使用 rtpengine 或者 rtpproxy 来处理。

但是，最近的 OpenSIPS 版本，已经可以支持 SDP 处理了。可以直接在 OpenSIPS 脚本里处理 SDP。

说实话，我看了新的方案，我觉得，还不如用 rtpengine 或者 rtpproxy。

但是聊胜于无吧，感兴趣的可以看看原文。

OpenSIPS Summit 2025 - Liviu Chircu - Enhanced Media Operations with Structured SDP

除此以外，PDF 也提到一些有趣的事情，比如 SDP 随着时间推移，增强和很多功能，包也变得越来越大

时期	内容	包大小
1998	基本媒体行	200-400 bytes
2002	编码协商，rtpmap	500-1000 bytes
2010	ICE/DTLS	1-2 kb
2015	WebRTC, Simulcast, Bound, MID	2-3kb
	在线会议，SFU	3-5 kb

可以想象，随着媒体能力的增强，UDP包的SIP信令中的分片几乎成为必然，所以，是否可以考虑有限使用TCP/TLS来传输信令呢？

DTLS协商失败导致无声问题

Tue, 24 Jun 2025 21:06:11 +0800

1. 简介

DTLS（Datagram Transport Layer Security，数据报传输层安全协议）是一种为基于数据报的应用（如UDP）提供安全通信的协议。它是TLS（传输层安全协议）的扩展，专门设计用于不可靠的传输协议（如UDP），以实现数据加密、身份认证和消息完整性保护。DTLS常用于VoIP、视频会议、WebRTC等实时通信场景。

DTLS在WebRTC音视频中是强制必须使用的，否则媒体协商阶段就会失败。

使用DTLS后，就算中间人从网络中抓包，抓到了RTP流，在播放RTP流时，里面也全是噪声，无法播放的。

今天要讲的是就是DTLS协商失败导致电话即使接通，也无声的问题。

2. 网络结构说明

UAS: sip server, OpenSIPS + RTPEngine组成
UAC: WebRTC 分机

F1. UAS ----> UAC: INVITE (SDP)
F2. UAS <---- UAC: 180
F3. UAS <---- UAC: 200 Ok (SDP)
F4. UAS ----> UAC: ACK

从SIP信令上看，被叫应答后，UAS和UAC之间的双向媒体流应该建立起来，但是实际上却无声。

3. ICE/STUN/DTLS

ICE: WebRTC中的ICE（Interactive Connectivity Establishment，交互式连接建立）是一种网络协议，用于帮助WebRTC客户端在不同网络环境下建立点对点（P2P）连接。ICE的主要作用是解决NAT穿透和防火墙问题，使两个终端能够找到最佳的通信路径。
STUN: WebRTC中的STUN（Session Traversal Utilities for NAT，NAT会话穿越实用工具）是一种网络协议，主要用于帮助客户端发现自己的公网IP地址和端口。由于很多设备处于NAT（网络地址转换）或防火墙之后，直接通信会遇到障碍，STUN可以让客户端知道外部网络如何访问自己

在分机应答后，并在WebRTC发送本地媒体流前，还需要两个步骤协商完成UAC才会发送语音流

3.1 STUN协商

UAC收到来自UAS的SDP, 里面一般有如下内容

m=audio 54322 UDP/TLS/RTP/SAVPF 111 0 8
a=ice-ufrag:abcd
a=ice-pwd:1234567890abcdef
a=ice-options:trickle
a=fingerprint:sha-256 12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF
a=setup:actpass
a=candidate:1 1 udp 2130706431 1.2.3.4 54322 typ host

STUN是一个请求响应模型的协议。UAC将会向a=candidate里的1.2.3.4:54322 发送UDP消息

RTPEngine mr13版本, 特殊的fmtp参数会导致某些语音编码被移除

Wed, 18 Jun 2025 20:04:52 +0800

场景说明

如下图所示

Offer阶段，F1, F2 步骤里PCMU编码有个fmtp参数abc=no, 这个参数可能只对呼叫发起方有意义，对被叫方来说，只会被忽略。
Answer阶段, 例如被叫是个FreeSWITCH, 它不认识abc=no, 就直接忽略，然后应答编码是PCMU。但是rtpengine认为不带abc=no的参数，就认为这个PCMU的编码是不可能被选中的，然后就直接删掉了PCMU编码，只保留了一个101编码
由于主叫收到101的编码，而没有语音的编码，所以主叫收到200 Ok后立马就发送了BYE

// F1: send offer to rtpegnine
m=audio 2000 RTP/AVP 0 8 101
a=rtpmap:0 PCMU/8000
a=fmtp:0 abc=no
a=rtpmap:8 PCMA/8000
a=fmtp:8 abc=no
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-15

// F2: receive offer from rtpengine
m=audio PORT RTP/AVP 0 8 101
c=IN IP4 203.0.113.1
a=rtpmap:0 PCMU/8000
a=fmtp:0 abc=no
a=rtpmap:8 PCMA/8000
a=fmtp:8 abc=no
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-15


// F3: send answer to rtepngine
m=audio 2002 RTP/AVP 0 101
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-15

// F4: expect receive answer from rtpengine
m=audio PORT RTP/AVP 0 101
c=IN IP4 203.0.113.1
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-15

问题原因

刚开始我以为是， https://github.com/sipwise/rtpengine/commit/9c00f30 这次commit引起的问题，我尝试注释代码，然后进行测试，发现可以解决问题。

VoIP Server 高可用架构设计

Tue, 27 May 2025 20:10:22 +0800

简介

VoIP高可用包含很多方面，主要包括：

接入层高可用：怎么保证某个接入点出现问题，不会影响到整个平台不可用？
核心层高可用：怎么保证路由选择的高可用，某个网关不可用，继续尝试其他网关？
存储层高可用：怎么保证不会丢失录音文件，怎么保证录音文件的完整性？
数据库层高可用：怎么保证注册信息能够在集群中同步？

接入层高可用

最简单的场景，只有一个fs, 无论是ua还是gw都接入到fs1上

ua1 ----> fs1
ua2 ----> fs1
gw1 ----> fs1
gw2 ----> fs1

如果要实现高可用，最简单的做法就是再加一个fs2。但是加了fs2之后，ua和gw的接入策略就需要改变了。

为了保持客户端的接入策略不变，最简单的做法加上一个负载均衡器，然后由负载均衡器来做信令转发。

ua1 ----> op1 ----> fs1
ua2 ----> |   ----> fs2
gw1 ----> |
gw2 ----> |

op1是单节点的，也会存在单点故障问题，因此引入op2。

ua1 ----> op1 ----> fs1
ua2 ----> op2 ----> fs2
gw1 ----> |
gw2 ----> |

引入op2之后，有两个方案来保证高可用：

方案1, 主备: op1和op2用VIP来对外提供服务，op1和op2的VIP是一样的。实际只有一个在工作，另外一个处于备份状态。一旦op1出现问题，op2接管VIP对外提供服务。 - 优点: 简单 - 缺点: - 兼容性：不是所有云平台都支持VIP - 成本：需要额外的硬件成本，而且还是闲置状态 - 负载：op1和op2都需要对外提供服务，但是实际上只有一个在工作，一个节点的处理能力有限，总会达到瓶颈

离谱的通话无声问题排查记录

Wed, 07 May 2025 22:45:26 +0800

简化网络模型

A 硬件话机
S SIP 服务器/媒体服务器
B 客户手机

A <-SIP/RTP> S <-SIP/RTP> B

问题说明

通话接通后，双方听不到对方的声音。

呼叫流程

S 发起呼叫，A 接听后，bridge B

排查思路

检查S在INVITE A时，SDP里携带的c=行，是否是S的公网IP。检查后无问题
在A上抓包，发现有 S->A的RTP包，也有 A->S 的 RTP 包。
将第二步的抓包文件拿到wireshark中分析。发现S->A方向的包是正常的，能播放出声音；A->S方向虽然有RTP包，但是看波形是一条直线，非常奇怪。
S->A方向的RTP包，在wireshark中能播放出声音，理论上A应该能听到B的声音的。但是用户反馈听不到。
咨询用户，用户是如何接听电话的。用户反馈是通过话机手柄接听的电话
让后让客户使用免提的方式拨打接听电话，发现可以听到声音。
让客户拍照话机手柄插入话机的接口，发现手柄插入的接头插入了耳麦的接口。
让客户将手柄插入正确的手柄接口，问题解决。

延伸思考

这次问题排查，让我想起了之前看过的思科的排除语音质量问题

这篇文章把语音质量问题分为三类：

网络相关(包括网关(GW)和PSTN问题)
电话型号/固件相关
设备(例如头戴式耳机)相关

在步骤上：

步骤1.隔离语音质量问题的第一步是找出确切的用户体验并与他们交谈（无论是面对面还是通过电话），以获得对语音质量问题的准确描述。如果有大量用户报告问题，请与他们的样本（可能是5-10个）交谈，以获得对症状的准确描述。

但是实际情况下，我们有时候迫于形势，往往只从一两个客户那里获得只言片语的信息，然后就开始排查了。客户的只言片语如果带有误导性，那么排查的方向就错了。

步骤2.记录物理位置(例如站点A，2楼)、用户名（用户的电话）、目录号码(DN)、电话型号（例如8865）、电话固件(例如11.5.1)和遇到语音质量问题的电话的IP地址。创建一个按物理位置排序的电子表格。在开始排除故障时创建此电子表格需要30分钟（或更短时间），可节省数小时甚至数天的故障排除时间。

记录信息很重要，但是实际操作中，往往因为时间紧迫，而没有记录这些信息。或者这些信息记录在头脑中，但是排查到最后才发现，自己忘记了某些信息。

步骤3.创建电子表格后，查看电话列表，了解电话有哪些共同之处，以及它们与没有语音质量问题的其他电话有何不同。之后，您可以意识到所有有问题的电话都位于同一栋大楼和同一楼层，您可以意识到有问题的电话连接到最近升级的交换机，或者您可以看到所有有问题的电话都位于特定固件上。

总结

搞VoIP这么久，碰到过很多疑难杂症。排查思路往往都是从软件或者网络策略层面去排查。很少考虑到终端的固件和硬件设备上。

但是这次排查通话无声的问题，让我印象深刻的是，排查到最后才发现是硬件问题。

从声音的输出输出上，有不同的设备，例如有线耳机、蓝牙耳机、话机手柄、免提等。

排查这类问题，需要多方面考量。需要挖掘客户的实际使用场景，才能定位到真正的问题。

反思

客户的硬件话机，有两个接口。手柄的接口和耳麦的接口是共用一套接口的。虽然接口上标注的很清楚，但是客户在接线的时候，没有注意到这点。

这要怎么避免呢？骂客户是傻逼吗？

是不是在设计接口的时候，就应该使用不同形状的接口。比如手柄接口是圆形，耳麦接口是方形。这样就能避免这种问题了。

或者说，接口是通用的。无论是手柄还是耳麦，插上都能用呢。

还有一种方案，就是只保留一个接口，手柄和耳麦共用一套接口。两者是互斥关系。

DNS域名解析对MicroSIP注册的影响分析

Wed, 30 Apr 2025 17:36:58 +0800

microSIP DNS域名解析影响分析

MicroSIP是一款流行的windows VoIP客户端，它允许用户通过互联网进行语音和视频通话。在使用MicroSIP时，DNS域名解析是确保正确连接到服务器的重要步骤之一。

DNS域名解析是将人类可读的域名（如www.example.com）转换为机器可读的IP地址的过程。这个过程通常由用户的网络服务提供商(ISP)或本地计算机上的DNS缓存完成。

域名解析可以将一个域名解析为多个IP地址，例如：[ip1, ip2, ip3], 但是每次解析返回的顺序往往是不确定的，这取决于DNS服务器的配置和负载均衡策略。

例如第一次解析的结果可能是[ip1, ip2, ip3]，而第二次解析的结果可能是[ip2, ip3, ip1]。

MicroSIP客户端在注册时，会尝试连接到这些IP地址中的第一个。

当分机使用TCP方式注册时，如果其第一个IP地址无法连接，它会继续尝试下一个IP地址，直到成功或所有IP地址都失败为止
如果分机使用UDP方式注册，它只会用第一个IP地址尝试注册，如果失败，还是继续尝试第一个IP。这种行为似乎有点傻，为什么一直要尝试第一个IP地址，而不是尝试下一个呢？ MicroSIP底层用了pjsip库，而pjsip只有在用tcp/tls注册时，才会自动尝试下一个IP。pjsip官网也给出了具体的解决方案，就是应用层主动调用 pjsua_acc_modify() 函数，手动修改账号配置，然后重新注册。但是microSIP并没有这么做，而是直接用一个固定的IP地址去尝试注册。

Our DNS SRV failover support is only limited to TCP (or TLS) connect failure, which in this case pjsip will automatically retries the next server. https://docs.pjsip.org/en/latest/specific-guides/sip/dns_failover.html

所以，总体上说。在使用域名注册的情况下，当前的注册和上一次的注册可能发往不同的SIP服务器。

考虑如下场景：

# t1 dns解析结果 ip1, ip2, ip3
REGISTER sip:ip1:5060 SIP/2.0
200 Ok

# t2 dns解析结果 ip3, ip1, ip2
REGISTER sip:ip3:5060 SIP/2.0
200 ok

一般分机都在内网环境，出口的公网IP是不变的，但是t1和t2的注册由于目标IP不同，所以出口的NAT映射的端口也是不同的。

读到无法解析的TCP包后, kamailio如何处理？

Fri, 18 Apr 2025 23:05:15 +0800

 1int receive_msg(char *buf, unsigned int len, receive_info_t *rcv_info) {
 2	if(parse_msg(buf, len, msg) != 0) {
 3		errsipmsg = 1;
 4		evp.data = (void *)msg;
 5
 6        // note: 这里尝试查找并执行nosip模块的 event_route[nosip:msg]事件路由
 7        // 一般情况下，如果没有找到，那么ret的值是-1
 8        // 那么这里的if内部不会执行
 9		if((ret = sr_event_exec(SREV_RCV_NOSIP, &evp)) < NONSIP_MSG_DROP) {
10			LM_DBG("attempt of nonsip message processing failed\n");
11		} else if(ret == NONSIP_MSG_DROP) {
12            // 这里也不会执行
13			LM_DBG("nonsip message processing completed\n");
14			goto end;
15		}
16	}
17
18    // 由于在上面的判断里errsipmsg被设置成1，所以这里的if条件成立
19    if(errsipmsg == 1) {
20        // 打印报错信息，并执行核心错误处理
21		LOG(cfg_get(core, core_cfg, sip_parser_log),
22				"core parsing of SIP message failed (%s:%d/%d)\n",
23				ip_addr2a(&msg->rcv.src_ip), (int)msg->rcv.src_port,
24				(int)msg->rcv.proto);
25		sr_core_ert_run(msg, SR_CORE_ERT_RECEIVE_PARSE_ERROR);
26
27        // 跳转到error02标签，执行后续的清理工作
28		goto error02;
29	}
30
31// 跳转到error02标签，执行后续的清理工作
32error02:
33	free_sip_msg(msg);
34	pkg_free(msg);
35error00:
36	ksr_msg_env_reset();
37	/* reset log prefix */
38	log_prefix_set(NULL);
39
40    // 返回-1，表示出错
41	return -1;
42}

如果调用receive_msg返回负数，那么从调用栈向上查找receive_tcp_msg函数也会返回负数
- int receive_tcp_msg(char *tcpbuf, unsigned int len,struct receive_info *rcv_info, struct tcp_connection *con)
receive_tcp_msg函数返回负数，那么向上查找，tcp_read_req也会返回负数
- int tcp_read_req(struct tcp_connection *con, int *bytes_read,rd_conn_flags_t *read_flags)
tcp_read_req返回负数
- inline static int handle_io(struct fd_map *fm, short events, int idx)在这个函数内部

		if(unlikely(bytes < 0)) {
			LOG(cfg_get(core, core_cfg, corelog),
					"ERROR: tcp_read_req: error reading - c: %p r: %p (%d)\n",
					con, req, bytes);
			resp = CONN_ERROR;
			goto end_req;
		}

        resp = tcp_read_req(con, &n, &read_flags);
			if(unlikely(resp < 0)) {
				/* some error occurred, but on the new fd, not on the tcp
				 * main fd, so keep the ret value */
				if(unlikely(resp != CONN_EOF))
					con->state = S_CONN_BAD;
				release_tcpconn(con, resp, tcpmain_sock);
				break;
        }

整个调用链条是这样的： handle_io -> tcp_read_req -> receive_tcp_msg -> receive_msg

Hot Reload OpenSIPS vs Kamailio

Sat, 29 Mar 2025 13:49:38 +0800

用过nginx的都知道，改了nginx的配置文件，只需要执行nginx -s reload就可以让改动生效，而不用重启整个服务。

在kamailio和opensips中，也有类似的热重载功能。

在kamailio中，如果要热重载配置文件，只需要执行kamcmd app_jsdt.reload即可。在opensips中，如果要热重载配置文件，只需要执行opensips-cli -x mi reload_routes即可。

理想很丰满，现实很骨感。

如果要只是修改路由模块，两者都可以做热重载。如果要动态的新增一些模块，那就必须要重启。

Kamailio的实现方案

必须要用KEMI框架： cfg + [lua|js|python|ruby]

用这个框架，你写的路由脚本将包括两个部分

核心模块，全局配置，模块加载，模块配置，事件路由这部分内容还是写在cfg文件中。
请求路由、响应路由、分支路由、失败路由等这部分内容可以用lua、js、 python等来写。

在热重载的时候，实际上只有外部脚本会被重新加载，而核心模块是不会被重新加载的。

因为部分路由用其他脚本编写，必然涉及到性能比较。官方给出的结论是，在同等条件下，lua的性能是最好的。

https://www.kamailio.org/wikidocs/devel/config-engines/#interpreters-performances

但是实际生产环境如何，还不好说。

另外一点，就是并不是所有模块都实现了KEMI框架的接口，可能存在风险。

OpenSIPS的实现方案

OpenSIPS在3.0版本首次引入了热重载路由脚本的能力，脚本还是cfg，没有引入其他语言。

https://www.opensips.org/Documentation/Interface-CoreMI-3-0#toc8

结论

总体而言，目的是相同的，都是为了热重载路由。

kamailio的方案看似灵活，实则复杂。如果cfg本身就能做热重载，那么就没必要引入其他语言。

我更倾向使用OpenSIPS的方案

参考

https://blog.opensips.org/2019/04/04/no-downtime-for-opensips-3-0-restarts/

开发学习笔记

Fri, 21 Feb 2025 22:17:35 +0800

架构图

kamailio 1.x版本

kamailio 3.x版本。相比于1.x版本，两个核心模块移动到外部模块。

核心模块 The core includes:

memory manager
SIP message parser
locking system
DNS and transport layer management (UDP, TCP, TLS, SCTP)
configuration file parser and interpreter
stateless forwarding
pseudo-variables and transformations engines
RPC control interface API
timer API

The internal libraries include:

some components from old Kamailio v1.5.x core
database abstraction layers (DB API v1 and v2)
management interface (MI) API
statistics engine

SIP消息处理

请求处理

响应处理。这里可以看到，是先执行响应路由，再执行失败路由。

HEP 协议学习笔记

Sun, 02 Feb 2025 15:12:40 +0800

HEP简介

HEP协议目前叫做EEP(Extensible Encapsulation Protocol), 那之前的缩写HEP的H，我只能推测为homer。

这个协议的主要功能是对VoIP连路上的数据包，例如SIP进行封装，方便后续分析SIP信令图。

目前这个协议已经升级到V3版本，在这个pdfHEP3_Network_Protocol_Specification_REV_36中有详细的介绍。

今天我们主要看这个协议的V3版本的协议是如何实现的。

包头

packet-beta
title HEP Packet
0-3: "版本号"
4-5: "总长度"
6-15: "数据段(变长)"

HEPv3的包头是6个字节，主要分为三个部分

版本号：固定4个字节长度，是HEP3
总长度：固定2个字节长度，是包的总长度，这个总长度包括了包头的六个字节。所以HEP包的大小范围一般是6-65535之间。
数据段：数据段的长度不固定

注意事项：假如从传输层读到1000个字节的数据，在解析前6个字节是，发现总长度(total length)的子段是1200，那就说明本次读到的数据还不是一个完整的

数据段解析

数据段由固定6字节长度的头部和变长的payload部分。

packet-beta
title HEP Packet
0-1: "vendor ID"
2-3: "type ID"
4-5: "length"
6-15: "payload"

vendor ID: 固定2字节长度, 其实意义不大，
type ID: 固定2字节长度，这个子段很重要，决定了payload的类型。可以理解为是一个对象的key, 然后把payload理解为value
length: 固定2字节长度，范围是0-65535，这个字段是也是整个数据段的长度，也就是包括了6个字节的段头
payload: 长度是length的长度-6，表示数据长度

hep协议有个type ID的映射表

chunk type ID	类型	描述
0x0001	uint8	IP类型，0x02=IPv4, 0x0a=IPv6
0x0002	uint8	协议类型 0x06=TCP, 0x11=UDP，可以参考IP协议号列表

其他的字段还有很多，可以参考HEP3_Network_Protocol_Specification_REV_36

RFC768 UDP包学习笔记

Wed, 01 Jan 2025 20:23:41 +0800

包格式

UDP包头工占用8个字节, 其中源端口和目标端口各占2个字节，长度占2个字节，校验和占2个字节。

    0      7 8     15 16    23 24    31
   +--------+--------+--------+--------+
   |     Source      |   Destination   |
   |      Port       |      Port       |
   +--------+--------+--------+--------+
   |                 |                 |
   |     Length      |    Checksum     |
   +--------+--------+--------+--------+
   |
   |          data octets ...
   +---------------- ...

        User Datagram Header Format

字段

源端口，可选字段，默认为0，如果是有意义的其他端口，表示后续响应可以送回到该端口
目标端口，必须字段，用来关联目标主机上进程监听的端口
长度，长度是整个UDP包的长度，也就是包头 + 包的数据，包头固定8字节，那么length的最小长度就是8
校验和，用来验证传输过程中是否发生了错误。校验和的计算结果与源IP、目标IP、UDP的包长有关。如果校验和失败，那么消息会被丢弃。有些校验和计算的工作会被放置在网卡上，从而减少CPU的负载。当然如果在网卡上因为校验和的问题被网卡丢弃，上层应用是收不到不到UDP包的。但是用tcpdump可以抓到这种校验和有问题的包。

思考1：为什么源端口可以设置为0？

答：有些UDP包，是不需要响应的，只需要发送出消息。

参考

源码笔记 - 自定义事件路由(中)

Sat, 28 Dec 2024 09:43:00 +0800

[[TOC]]

route_list

route.h定义了几个函数分别用来获取、查找、新增route

// src/core/route.h
int route_get(struct route_list *rt, char *name);
int route_lookup(struct route_list *rt, char *name);
void push(struct action *a, struct action **head);

struct route_list
{
	struct action **rlist;
	int idx;					 /* first empty entry */
	int entries;				 /* total number of entries */
	struct str_hash_table names; /* name to route index mappings */
};

rlist

我们对route_list数据模型进行简化:

rlist是一个固定长度的一维数组，通过索引来访问对应的值。如果数组的空间不足，那么就创建一个两倍大的空数据，然后先把原始数据复制过去。这种复制方式保持的原始数据的索引位置。有点像golang的切片扩容机制。

这里最为重要的就是保持数组元素的索引位置在扩容后不变。

static inline int route_new_list(struct route_list *rt)
{
	int ret;
	struct action **tmp;

	ret = -1;
	if(rt->idx >= rt->entries) {
    // 两倍扩容
		tmp = pkg_realloc(rt->rlist, 2 * rt->entries * sizeof(struct action *));
		if(tmp == 0) {
			LM_CRIT("out of memory\n");
			goto end;
		}
		/* init the newly allocated memory chunk */
		memset(&tmp[rt->entries], 0, rt->entries * sizeof(struct action *));
		rt->rlist = tmp;
		rt->entries *= 2;
	}
	if(rt->idx < rt->entries) {
		ret = rt->idx;
		rt->idx++;
	}
end:
	return ret;
}

str_hash_table

我们对hash_table的数据模型进行简化，它其实就是一hash表，key是路由的名，值是一个正数，正数代表了路由执行单元的索引位置。

源码笔记 - 自定义事件路由(上)

Fri, 27 Dec 2024 20:45:03 +0800

[[TOC]]

事件路由简介

在某些模块中，我们看到有一些模块自定义的事件路由。

例如dispatcher模块，或者rtpengine模块。

event_route[dispatcher:dst-down] {
    xlog("L_ERR", "Destination down: $rm $ru ($du)\n");
}

event_route[rtpengine:dtmf-event] {
    xlog("L_INFO", "callid: $avp(dtmf_event_callid)\n");
		xlog("L_INFO", "source_tag: $avp(dtmf_event_source_tag)\n");
		xlog("L_INFO", "timestamp: $avp(dtmf_event_timestamp)\n");
		xlog("L_INFO", "dtmf: $avp(dtmf_event)\n");
}

disapcher模块

在dispatch.c文件中，我们看到如下代码

if(!ds_skip_dst(old_state) && ds_skip_dst(idx->dlist[i].flags)) {
		ds_run_route(msg, address, "dispatcher:dst-down", rctx);
} else {
		if(ds_skip_dst(old_state) && !ds_skip_dst(idx->dlist[i].flags))
			ds_run_route(msg, address, "dispatcher:dst-up", rctx);
}

ds_run_route还是定义在dispatch.c文件中，

static void ds_run_route(sip_msg_t *msg, str *uri, char *route, ds_rctx_t *rctx)

接着又一个重要调用。这里似乎在查找路由。

route这个参数其实就是dispatcher:dst-down，或者 dispatcher:dst-up，

那么event_rt又是什么鬼呢？

rt = route_lookup(&event_rt, route);

event_rt是一个route_list的结构体

// route.c
struct route_list event_rt;

route_list的结构如下，重点是这个str_hash_table这个字段，它似乎是一个hash

struct route_list
{
	struct action **rlist;
	int idx;					 /* first empty entry */
	int entries;				 /* total number of entries */
	struct str_hash_table names; /* name to route index mappings */
};

str_hash_table的结构如下：

DMQ模块源码学习笔记

Sun, 22 Dec 2024 18:07:08 +0800

背景

多个SIP注册服务器之间，如何同步分机的注册信息呢？

简单的方案就是使用共享数据库的方式同步注册信息，这个方案实现起来简单，但是分机的注册信息本身就是个需要频繁增删改查的，数据库很可能在大量注册分机的压力下，成为性能的瓶颈。

除了数据库之外，OpenSIPS和kamailio分别提供了不同的方案。

OpenSIPS提供的方案是使用cluster模块，cluster模块在多个实例之间同步分机的注册信息，注册信息的格式是OpenSIPS自定义的格式。 Kamailio的方案是DMQ模块， DMQ听起来高大上，放佛是依赖外部的一个服务。但它其实就是扩展SIP消息，通过SIP消息来广播分机的注册信息。

KDMQ sip:notification_peer@192.168.40.15:5090 SIP/2.0
Via: SIP/2.0/UDP 192.168.40.15;branch=z9hG4bK55e5.423d95110000
To: <sip:notification_peer@192.168.40.15:5090>
From: <sip:notification_peer@192.168.40.15:5060>;tag=2cdb7a33a7f21abb98fd3a44968e3ffd-5b01
CSeq: 10 KDMQ
Call-ID: 1fe138e07b5d0a7a-50419@192.168.40.15
Content-Length: 116
User-Agent: kamailio (4.3.0 (x86_64/linneaus))
Max-Forwards: 1
Content-Type: text/plain

sip:192.168.40.16:5060;status=active
sip:192.168.40.15:5060;status=disabled
sip:192.168.40.17:5060;status=active

源码分析

该模块一共暴露了8个参数，其中7个参数都是简单类型，INT和STR，就直接取对应变量的地址就可以了。

其中notification_address参数是用来配置集群中其他节点的通信地址的，因为要配置多次，所以需要用一个函数来解析。

// dmq.c
static param_export_t params[] = {
	{"num_workers", PARAM_INT, &dmq_num_workers},
	{"ping_interval", PARAM_INT, &dmq_ping_interval},
	{"server_address", PARAM_STR, &dmq_server_address},
	{"server_socket", PARAM_STR, &dmq_server_socket},
	{"notification_address", PARAM_STR|PARAM_USE_FUNC, dmq_add_notification_address},
	{"notification_channel", PARAM_STR, &dmq_notification_channel},
	{"multi_notify", PARAM_INT, &dmq_multi_notify},
	{"worker_usleep", PARAM_INT, &dmq_worker_usleep},
	{0, 0, 0}
};

这些参数都没有加上static关键词，主要目的为了在dmq模块的其他c文件能使用。

路由执行的顺序

Sun, 22 Dec 2024 16:20:42 +0800

1. 请求消息处理过程

请求可以

直接丢弃，不返回任何响应。对于恶意请求，SIP Flood攻击，最好不要返回任何响应。
直接返回状态码，不做转发，例如直接返回301重定向
无状态转发
有状态转发
- 执行分支路由，分支路由也可以将消息丢弃
无论有无状态，请求发出去前都会执行onsend_route路由，在onsend_route内部，已经不能对SIP消息再做拦截

2. 响应消息处理过程

首先执行reply_route{}, 在这个路由里可以将消息丢弃
然后判断消息是否有状态的
- 有状态，这执行onreply_route[ID]路由
  - 如果响应是失败的，还可以执行failure_route[ID], 当前前提是在请求路由里是否设置了钩子
  - 在失败路由可以，可以再次设置新的目标地址，进行转发；设置了新的目标地址后，还可以设置分支路由

Tip

这里要注意的是，响应路由在失败路由之前执行。

3. 重传处理

kamailio 启动参数控制

Sun, 22 Dec 2024 15:46:13 +0800

    -a mode      Auto aliases mode: enable with yes or on,
                  disable with no or off
                  一般都是关闭

    --alias=val  Add an alias, the value has to be '[proto:]hostname[:port]'
                  (like for 'alias' global parameter)
                  设置对外别名, 在多个对外别名时，相比于在脚本中写死, 更好的方式
                  是在启动时传入, alias一般都是服务的对外域名或者IP
                  如果km有多个对外域名，并且不同的环境都不同，这块配置就合适在脚本里写死

    --atexit=val Control atexit callbacks execution from external libraries
                  which may access destroyed shm memory causing crash on shutdown.
                  Can be y[es] or 1 to enable atexit callbacks, n[o] or 0 to disable,
                  default is no.
                  没用过

    -A define    Add config pre-processor define (e.g., -A WITH_AUTH,
                  -A 'FLT_ACC=1', -A 'DEFVAL="str-val"')
                  预处理的变量定义

    -b nr        Maximum OS UDP receive buffer size which will not be exceeded by
                  auto-probing-and-increase procedure even if OS allows

    -B nr        Maximum OS UDP send buffer size which will not be exceeded by
                  auto-probing-and-increase procedure even if OS allows
                  这和上面的有啥区别呢？

    -c           Check configuration file for syntax errors
                可以检查配置文件的语法错误。如果这个选项开启，就只能做检查语法，而不能启动kama

    --cfg-print  Print configuration file evaluating includes and ifdefs
                 在脚本里有很多预处理指令时，可以用这个参数打印出预处理之后的脚本 

    -d           Debugging level control (multiple -d to increase the level from 0)
                调试界别
    --debug=val  Debugging level value

    -D           Control how daemonize is done:
                  -D..do not fork (almost) anyway;
                  -DD..do not daemonize creator;
                  -DDD..daemonize (default)
                控制是否开启守护进程

    -e           Log messages printed in terminal colors (requires -E)
    -E           Log to stderr

    -f file      Configuration file (default: /usr/local/etc/kamailio/kamailio.cfg)
                设置配置文件的位置, 可以覆盖默认的位置

    -g gid       Change gid (group id)

    -G file      Create a pgid file

    -h           This help message

    --help       Long option for `-h`

    -I           Print more internal compile flags and options

    -K           Turn on "via:" host checking when forwarding replies

    -l address   Listen on the specified address/interface (multiple -l
                  mean listening on more addresses). The address format is
                  [proto:]addr_lst[:port][/advaddr][/socket_name], 
                  where proto=udp|tcp|tls|sctp, 
                  addr_lst= addr|(addr, addr_lst), 
                  addr=host|ip_address|interface_name, 
                  advaddr=addr[:port] (advertised address) and 
                  socket_name=identifying name.
                  E.g: -l localhost, -l udp:127.0.0.1:5080, -l eth0:5062,
                  -l udp:127.0.0.1:5080/1.2.3.4:5060,
                  -l udp:127.0.0.1:5080//local,
                  -l udp:127.0.0.1:5080/1.2.3.4:5060/local,
                  -l "sctp:(eth0)", -l "(eth0, eth1, 127.0.0.1):5065".
                  The default behaviour is to listen on all the interfaces.
                控制listen的地址
    --loadmodule=name load the module specified by name

    --log-engine=log engine name and data

    -L path      Modules search path (default: /usr/local/lib64/kamailio/modules)

    -m nr        Size of shared memory allocated in Megabytes
                共享内存的大小设置

    --modparam=modname:paramname:type:value set the module parameter
                  type has to be 's' for string value and 'i' for int value, 
                  example: --modparam=corex:alias_subdomains:s:kamailio.org
                  设置模块的启动参数
                  对于不方便在脚本里写死的模块参数，这个方式也挺好用

    --all-errors Print details about all config errors that can be detected
                调试模式比较好用，打印详细的日志报错 

    -M nr        Size of private memory allocated, in Megabytes
                控制私有内存的大小

    -n processes Number of child processes to fork per interface
                  (default: 8)

    -N           Number of tcp child processes (default: equal to `-n')

    -O nr        Script optimization level (debugging option)

    -P file      Create a pid file

    -Q           Number of sctp child processes (default: equal to `-n')

    -r           Use dns to check if is necessary to add a "received="
                  field to a via

    -R           Same as `-r` but use reverse dns;
                  (to use both use `-rR`)

    --server-id=num set the value for server_id

    --subst=exp set a subst preprocessor directive
    --substdef=exp set a substdef preprocessor directive
    --substdefs=exp set a substdefs preprocessor directive

    -S           disable sctp

    -t dir       Chroot to "dir"

    -T           Disable tcp

    -u uid       Change uid (user id)

    -v           Version number

    --version    Long option for `-v`

    -V           Alternative for `-v`

    -x name      Specify internal manager for shared memory (shm)
                  - can be: fm, qm or tlsf

    -X name      Specify internal manager for private memory (pkg)
                  - if omitted, the one for shm is used

    -Y dir       Runtime dir path

    -w dir       Change the working directory to "dir" (default: "/")

    -W type      poll method (depending on support in OS, it can be: poll,
                  epoll_lt, epoll_et, sigio_rt, select, kqueue, /dev/poll)

DDOS学习笔记

Tue, 17 Dec 2024 21:10:40 +0800

攻击分类

网络层
- ICMP Flood攻击: ICMP（Internet Control Message Protocol，因特网控制报文协议）是TCP/IP协议族的一个子协议，用于在IP主机、路由器之间传递控制消息。ICMP协议本身特点决定了它非常容易被用于攻击网络上的路由器和主机。当攻击者向目标网络发送大量的ICMP数据包时，目标主机会耗费大量的CPU资源去处理和响应，直至耗尽设备资源，无法为合法用户提供正常服务。
- ARP Flood攻击: ARP（Address Resolution Protocol，地址解析协议）是用来将IP地址解析为MAC地址的协议。ARP协议主要以广播的方式发送ARP请求。同网段内的主机都可以收到广播请求，这为攻击者提供了可乘之机。攻击者通过发送大量的ARP请求，使有限的网络资源被无用的广播信息所占用，造成网络拥堵。其次，因为ARP协议没有安全认证机制，所以只要主机接收到ARP应答包，都会缓存在ARP表中，这为ARP欺骗提供了可能。
- IP分片攻击: IP协议在传输数据包时，会将数据报文分为若干分片进行传输，并在目标系统中进行重组。IP分片是网络环境中经常发生的事件，但是，如果数据被人为恶意分片就会产生DDoS攻击。攻击者将经过恶意分段的数据包发送至目标网络，导致目标网络耗费大量资源进行重组，直至资源枯竭。
传输层攻击
- SYN Flood攻击: SYN Flood是互联网最原始、最经典的DDoS攻击之一，主要利用了TCP协议的三次握手机制。攻击者通常利用工具或控制僵尸主机向服务器发送海量的变源IP地址或变源端口的SYN报文，服务器响应报文后产生大量的半连接，直至系统资源被耗尽，服务器无法提供正常的服务。
- ACK Flood攻击: 攻击者通过僵尸网络向目标服务器发送大量的ACK报文，报文带有超大载荷，会引起链路拥塞。或向目标服务器发送极高速率的变源变端口请求，导致转发设备异常，从而引起网络瘫痪。
- UDP Flood攻击: UDP Flood攻击常用于大带宽DDoS攻击。攻击者使用包含无状态UDP协议的IP数据包充塞目标主机的端口，受害主机会寻找与UDP数据包相关的应用程序。如果没有找到，就向发送者回发一条“目标不可达”消息。一旦目标主机被攻击流量淹没，系统就会失去响应，从而造成合法用户无法正常访问的现象。
应用层攻击
- DNS Flood攻击: 攻击者通过操纵大量傀儡机器，对目标网络发起海量域名查询请求，以中断该域的DNS解析。这种攻击将会破坏网站、API或Web应用程序响应合法流量的能力，让合法用户无法查找到用于调用特定资源的地址，导致业务暂时中断或停止。
- HTTP Flood攻击: HTTP GET 攻击：攻击者操控多台设备向目标服务器发送对图像、文件或其他资产请求，当目标服务器被传入请求和响应所淹没时，来自正常流量源的业务请求也将被拒绝。 HTTP POST 攻击：与发送 POST 请求所需的处理能力和带宽相比，处理表单数据和运行必要数据库命令的过程相对密集。这种攻击利用相对资源消耗的差异，直接向目标服务器发送大量POST请求，直至目标服务器容量饱和并拒绝服务为止。
- CC攻击: CC攻击常用于攻击提供网页访问服务的服务器。攻击者通过代理服务器向目标服务器发送大量貌似合法的请求，使CPU长时间处于高负荷运行状态，永远都有处理不完的连接。攻击会导致正常访问被中止，最终宕机崩溃。
- SIP注册 Flood攻击: 攻击者发送大量的SIP注册请求到SIP服务端，SIP服务器需要查询数据库，拖慢正常的数据库查询，也回占用大量的资源来维护注册的事务。

FAQ

防火墙能否拦截DDOS攻击？
- 拦截不了，防火墙就好比饭店的保安，保安再多，但是饭店门口道路交通堵塞了，饭店的营业额下降，再多的保安也无能为力
在遭受DDOS攻击后，用什么手段防御？
1. 购买硬件设备：除了比较贵之外，对于使用云服务器的服务也无能为力
2. 更换公网IP：对于使用云服务器来说，更换云服务器的公网IP看起来比较简单方便。但是也有麻烦的地方，比如自己的服务可能要涉及到配置改变和服务重启，和自己相关的第三方，也可能要修改IP的访问地址
3. 使用云服务厂商提供的DDOS服务
如何感知到自己的服务正在遭受DDOS攻击？
1. 异常大的流量波动
2. 正常用户大量离线

参考

你不怕暴露自己的无知吗？

Sat, 07 Dec 2024 14:17:28 +0800

公开自己的错误

我在写博客时，有时候脑海里总会蹦出一个小人，面露鄙夷的脸色对我说：你写这么多没啥技术含量的垃圾，公开在网上，难道不怕暴露自己的无知吗？

说实话，我是有这样的担忧。

因为我是有自知之明的，我知道自己估计也是黄老师那种"样样通，样样松"的人。写的东西也都是一些表面的东西，甚至有错误的可能。这并不是自谦。

我一直无法找到反击脑海里小人的理由。

今天，我在读一本书的时候，学到了一个概念，这个概念叫做坎宁安定律。

在互联网上获得正确答案的最好方法并不是提出问题，而是发布错误的答案

也许我的答案是错误的，但是它并没有被隐藏我脑海的某个角落，二是被公开在了网上。

即使我的小破站再小，必然也会有几个阅读量吧，或许能有读者对错误的答案提出自己的异议。

学习金字塔理论

如果仅仅是通过阅读学习，学习内容的平均存留率只有5%。

如果把学习内容公开，这其中就暗示了你可能需要把自己学到的内容教授给他人这一心理。

那么在记录笔记的时候，就会想办法把问题讲解的让别人更清楚，从而加深了自己的学习知识吸收。

参考

https://baike.baidu.com/item/%E5%AD%A6%E4%B9%A0%E9%87%91%E5%AD%97%E5%A1%94/9515094

第一节如何熟悉Kamailio文档的文档结构

Mon, 02 Dec 2024 22:43:24 +0800

我始终认为，快速学习一门知识，最为重要的就是熟悉它的文档结构。

对于熟悉OpenSIPS的文档结构来说的人，看了Kamailio的文档，往往觉得无从下手。

当我们打开Km的官网(kamailio.org)后，会重定向到https://www.kamailio.org/w/, 在页面的右侧，

接着，我们会导航到 https://www.kamailio.org/w/documentation/

这个页面的结构需要烂熟于心

1. 模块文档

如果你知道km的版本号和对应的模块，可以点击这里进入对应版本，然后再选择对应模块

2. wiki部分

2.1 必学部分

wiki部分主要是一些教程，非常值得看。

其中有三个重点部分

core cookbook：主要讲解km的脚本的结构、全局参数、模块参数、路由类型、预处理、脚本操作等等，是编写km脚本的必学之处，各种参数都可以看看
Pseudo-Variables CookBook：主要讲解各种伪变量，用来读写SIP消息
Transformations CookBook：主要讲解各种操作变换，例如把字符串型转为int型数据

全部函数索引

在km的wiki官网，即https://www.kamailio.org/wikidocs/，其中Alphabetic Indexes就是所有的参数或者函数的索引。

在你学些km的脚本时，有时候想知道某个函数在哪个模块中，就可以用这个全部函数索引中查找。

源码安装

这部分讲解如何通过GIT进行源码安装。

FAQ

https://www.kamailio.org/wikidocs/tutorials/faq/main/

外部资源

这里涉及了如何用km和常见的媒体服务器如何集成

其他

官方的Web版本的wiki, 对于刚入门的人来说，还是有点绕的。

另外一个问题就是mkdocs的页面渲染效果的确不太行，目录滚动一点都不灵敏。

如果你想看的不是某个模块的说明文档，我更建议你直接把https://github.com/kamailio/kamailio-wiki 这个git仓库下载到本地查看。

总结

总体来说，km的文档算是非常完整了，但是和OpenSIPS相比，还有待加强。

AXB的玩法说明

Mon, 18 Nov 2024 19:58:38 +0800

第二份工作的辞职总结

Tue, 10 Sep 2024 21:08:51 +0800

总结

第二份工作快到一年了，我最近申请离职了。

同事问我离职原因，我说被领导骂了，感觉自尊受辱，索性不干了。

实际上被领导骂只是压死骆驼的最后一根稻草，我也不是那种会心血来潮说干就不干的。

这份工作，我做了不到一年，大部分的时间我是做的不开心的。

所以离职是一直在心里酝酿。

为什么会工作不开心？

主要原因有以下四点：

行业前景暗淡：S公司处在行业的中游，上游受到运营商管控，下游在客户层面话语权也不大。这是一个资源限制型的行业，行业的命脉就在运营商，可能运营商有个风吹草动，整个行业就要翻江倒海。
自研能力薄弱：S公司大部分业务都是购买的第三方的软件，各种变更都受到制约，添加一个小功能都要付费升级。自研能力弱的一个原因可能就是前些年赚钱太容易了，投资研发哪有赚快钱来的舒服呢。同时也是这个原因，多个第三方软件之间也造成了数据割裂，运行维护困难。
家族企业制约：S公司大部分人员都是老板的亲朋好友，家族式企业的优点是内聚力强，但是包容性弱。之前也有一些大厂进来的员工，没多久就辞职了。我曾经也跟老板沟通过，似乎老板也有心做些变革。但是变革哪有那么容易，要变革不早都变了，还要等到现在？
短期主义：似乎S公司没有什么具体的愿景，唯一感觉到的愿景就是赚快钱。一旦发现投入的回报太少，就立即切换目标。
企业关怀差：说实在，我没有感觉到多少员工关怀。在S公司的工作和在地主家做短工也没啥区别，老板想什么都要管，但是即管不了那么多，又管的不好。所以给人的感觉就是东一棒槌，西一榔头，看起来很卖力，实际上并没有什么产出。几乎每个月都有人离职，对员工都吝啬，不考虑员工的自尊，员工怎么可能对公司有归属感。
工作压力大：受限于资源收紧、产品优势小，老板想提高营业额的方法是提高员工的服务水平。说实在，这真是杯水车薪。不想着从底层系统的解决问题，只想着通过给员工压力、通过加班来解决问题，只会造成工作压力大、人员流失大。

所以，我的离职，实际上也是考虑再三的一个选择。

当然，我在S公司也不是什么收获都没有。

收获总结

深入了解了行业的运行原理、客户、资源、政策等信息
对于数据分析方面有了较大的进步，毕竟我做了40+个数据报表来分析运行数据
深入学习了python, 主要用来做数据分析。数据分析方面的协议栈主要有pandas、duckdb、doris(MySQL)、grafana来组成
深入学习了python的GUI开发，主要用到的框架是wxPython，开发的两个工具分别给到运维人员和客服去使用，来提高运行效率

Windows安装Tesserocr

Wed, 24 Apr 2024 08:34:07 +0800

安装tesserocr-windows_build

到tesserocr-windows_build release页面下载对应的whl文件

如下载 tesserocr-2.6.2-cp312-cp312-win_amd64.whl，下载之后用pip安装

pip install tesserocr-2.6.2-cp312-cp312-win_amd64.whl

安装ocr windows exe程序

在这个页面，有对应的exe程序，https://digi.bib.uni-mannheim.de/tesseract/

例如下载这个exe文件 https://digi.bib.uni-mannheim.de/tesseract/tesseract-ocr-w64-setup-v5.3.0.20221214.exe

下载完成之后点击安装，一般我们不需要修改他的安装位置，默认的安装位置是C:\Program Files\Tesseract-OCR

我们将C:\Program Files\Tesseract-OCR\tessdata下的所有文件，复制到C:\Program Files\Tesseract-OCR\目录下

参考

使用Excel理解prometheus的变化率相关函数

Sat, 16 Mar 2024 08:38:46 +0800

counter类型的变化率 rate, irate, increase

counter类型一般是只增不减的累积值，例如系统累计的http请求数量, 累计的话单数量。

counter类型的指标变化率一般使用三个函数来计算，rate, irate, increase

指标每隔15s采样一次数据, A列是采集的指标值，B列是对应的采集时间。

demo_api_request_duration_seconds_count{instance="demo-service-0:10000",path="/api/bar",status="200",method="GET"}[1m]

序号	A	B
1	294401976	1710549816.105
2	294402185	1710549831.105
3	294402393	1710549846.105
4	294402599	1710549861.105

rate是计算每秒的变化率,

rate 计算方案 (A4-A1) / (B4-B1)，这里选择了首尾两个值的差值，除以时长秒
irate 计算方案 (A4-A3) / (B4-B3) , 这里只选择里最后两个点的差值，除以时长秒
increase 计算方式 (A4-A1) / (B4-B1) * 60, 这里的60是1m, 其实increase就是rate() * windows_seconds的语法糖

guage

296164749 @1710648381.105
296165055 @1710648396.105
296165364 @1710648411.105
296165668 @1710648426.105
296165978 @1710648441.105
296166186 @1710648456.105
296166505 @1710648471.105
296166826 @1710648486.105
296167151 @1710648501.105
296167478 @1710648516.105
296167810 @1710648531.105
296168139 @1710648546.105
296168472 @1710648561.105
296168764 @1710648576.105
296169026 @1710648591.105
296169363 @1710648606.105
296169709 @1710648621.105
296170059 @1710648636.105
296170410 @1710648651.105
296170759 @1710648666.107

解决 VsCode pwsh终端环境变量不生效问题

Thu, 16 Nov 2023 08:08:39 +0800

我在系统的环境变量设置里，用户和系统中，都加入了ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/这个环境变量。

单独打开windows Terminal应用，使用 env | grep ELE 是能搜到我设置的环境变量的。但是在vscode中，这个环境变量不存在。

我尝试了以下几个方法

重启电脑，无效
配置"terminal.integrated.persistentSessionReviveProcess": "never", 然后重启电脑，无效
在终端直接执行code ., 在终端打开vscode, 依然无效

因此，我想起了之前配置的pwsh的配置文件。可以使用code $PROFILE, 打开pwsh的配置文件。

然后再配置文件中设置环境变量，之后重启vscode, 环境变量就正常能读取到了。

# 文件名 Microsoft.PowerShell_profile.ps1
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"

参考

https://www.zhihu.com/question/266858097

如何选择，汉王Clear7与文石Leaf3

Mon, 06 Nov 2023 09:30:34 +0800

购买选择

我的kindle pw4已经用了快三年了，机器性能有些不足，电池也有些不够用了。正逢双十一之际，我觉得可以买一个开放系统的电纸书来用用。

买开放系统的另一个原因是自从亚马逊退出中国后，我用微信读书比较多，也买了微信读书的会员。

开放系统基本上都是基于安卓系统定制的，可以选择的厂商比较多。

最终筛选下来，我选择了汉王clear7和文石leaf3，我下单了两个，觉得先体验一下，然后在退一个。

然而用了不到两天之后，我还是决定把两个机器都给退了，继续用我的kindle pw4。

选择因素

就我个人而言，电子书最为重要的选择因素有以下三点。

显示效果: 说实在的，现在的电子书基本上都是carta1200、300ppi、冷暖光。基本上从显示效果上来说，各大厂家都是半斤八两。就我自己体验而言，我并没有发现汉王的显示效果和文石leaf3有何不同。
握持手感: 外观影响握持手感，外观一般分为两类，一类是就是平板设计，像kindle paperwhite系列。另一类就是书脊式设计，握持更舒适，像kindle os3, 汉王clear7之类的。
简洁系统: 电子书并不是手机，不需要太多的功能，功能太多反而成为累赘
稳定性: 点子产品难免被摔、或者淋水，对于这些意外情况，如果产品非常脆弱，那么很大可能会损失大笔的金额。
续航

文石的缺点

文石和汉王的两款产品，拿到手开机不到一小时，我就决定先退了文石。

原因有以下几点

显示效果文石和汉王差不多，没啥突出亮点
握持手感文石肯定比不过汉王的书脊式设计, 并且汉王更轻
文石的系统太复杂，设置太多，甚至还有个iphone类似的小白点设计，小白点点击之后展开很多图标，每个图标我都不知道做什么的
掉电速度，文石的电量肉眼可见的在不断减少

汉王的缺点

微信读书功能阉割, 这不是汉王的问题，而是微信读书自身的问题。例如书架页面，书籍只有一个排序的顺序，就是按照最近阅读的排序。而无法像ios或者安卓app一样能够按照阅读进度排序，另外也没有阅读时长分析的功能。另外我也注意到，微信读书电纸书版，扫码登录的有效期是24小时，我不知道这是不是意味着24小时之后我又要重新扫码。
触感光滑，汉王的背板的触感让人感觉非常光滑，感觉稍不注意就会滑下去的样子。完全没有kindle pw4那种拿在手机，就粘在手上的感觉。所以我觉得，买汉王，就必须要买一个保护套，但是官方卖的保护套也太贵了吧，居然要110多块，这点有点像割韭菜。什么保护套能卖那么贵，都快赶上十分之一的电纸书的价格了。
词典缺陷，汉王的词典也是我要吐槽的功能之一，只能把单词的原型加入到单词本，单词来个复数或者过去分词，就不能加入单词本了。kindle的生词本，所有单词，无论什么形式都能加入单词本。
掉电速度, 从昨晚五点多开机，到今天早上，基本上没到一天，电池已经掉电接近40%了
自动关机, 为了省电，汉王在2小时不使用后，会自动关机。然而这个开机时间就有点久，你可设想一下，每天早上，你想看书的时候，你都要等几十秒的开机时间，那你能受得了吗？
按钮反馈，松松垮垮, 触感没有一致性体验

结论

目前而言，国产的电纸书系统，除了开放的系统之外，其他各个方面还是存在与kindle有较大的差距。

当然，如果你从未使用过kindle系列的产品，国产的电纸书还是值得买的。

MacBook icloud 同步卡死，请尝试重启电脑

Sun, 20 Aug 2023 13:07:40 +0800

环境说明

MacBook Pro M2
系统版本 13.4.1
网络环境为wifi

操作步骤

我往icloud的文件夹下，粘贴几个文件夹，文件的内容挺多的，然后finder上显示icloud的状态就一直是处于同步中了。

等了好久，同步的过程似乎卡住了。

网上看了一些解决方案，似乎都没啥作用。

我想起来以前的同样的一次卡顿同步的解决方案：重启电脑

于是，我重启了一次电脑，再次开机，打开finder, icloud文件状态非常快同步完了。

安装NodeJS, N命令似乎卡住了

Sun, 09 Jul 2023 14:20:45 +0800

我一般会紧跟着NodeJS官网的最新版，来更新本地的NodeJS版本。

我的系统是ubuntu 20.4, 我用tj/n这个工具来更新Node。

但是这一次，这个命令似乎卡住了。

我排查后发现，是n这个命令在访问https://nodejs.org/dist/index.tab这个地址时，卡住了。

请求超时，因为默认没有设置超时时长，所以等待了很久才显示超时的报错，表现象上看起来就是卡住了。

首先我用dig命令查了nodejs.org的dns解析，我发现是正常解析的。

然后我又用curl对nodejs官网做了一个测试，发现也是请求超时。

curl -i -m 5 https://nodejs.org
curl: (28) Failed to connect to nodejs.org port 443 after 3854 ms: 连接超时

这样问题就清楚了，然后我就想起来npmirrror上应该有nodejs的镜像。在查看n这个工具的文档时，我也发现，它是支持设置mirror的。

其中给的例子用的就是淘宝NPM

就是设置了一个环境变量。然后执行source ~/.zshrc

export N_NODE_MIRROR=https://npmmirror.com/mirrors/node

但是，我发现在命令行里用echo可以打印N_NODE_MIRROR这个变量的值，但是在安装脚本里，还是无法获取设置的这个mirror。

我想或许和我在执行sudo n lts时的sudo有关，这个.zshrc在sudo这种管理员模式下是不生效的。普通用户的环境变量也不会继承到sudo执行的环境变量里

最后，我用sudo -E n lts, 成功的从npmmirror上更新了nodejs的版本。

关于curl超时的这个问题，我也给n仓库提出了pull request, https://github.com/tj/n/pull/771

VScode激活Tab更容易区分

Tue, 18 Apr 2023 13:43:07 +0800

默认情况下VScode的tab栏，当前的颜色会更深一点。如下图所示，第三个就是激活的。

但是实际上并没有太高的区分度，特别是当显示屏有点反光的时候。

我想应该不止一个人有这个问题吧

看了github上，有个人反馈了这个问题，https://github.com/Microsoft/vscode/issues/24586

后面有人回复了

"workbench.colorCustomizations": {
    "tab.activeBorder": "#ff0000",
    "tab.unfocusedActiveBorder": "#000000"
}

上面就是用来配置Tab边界的颜色的。

看下效果，当前激活的Tab下有明显的红线，是不是更容易区分了呢

行位结束符引起的问题

Mon, 16 Jan 2023 15:03:03 +0800

CRLF

二进制	十进制	十六进制	八进制	字符/缩写	解释
00001010	10	0A	012	LF/NL(Line Feed/New Line)	换行键
00001101	13	0D	085	CR (Carriage Return)	回车键

CR代表回车符，LF代表换行符。

这两个符号本身都是不可见的。

如果打印出来

CR 会显示 \r
LF 会显示 \n

不同系统的行结束符

Linux系统和Mac换行符是 \n
Windows系统的换行符是 \r\n

如何区分文件的换行符？

可以使用od命令

od -bc index.md

假如文件的原始内容如下

- 1
- 2

注意012是八进制的数，十进制对应的数字是10，也就是换行符。

0000000 055 040 061 012 055 040 062
          -       1  \n   -       2
0000007

如果用vscode打开文件，也能看到对应的文件格式，如LF。

换行符的的差异会导致哪些问题？

shell脚本问题

如果bash脚本里包含CRLF, 可能导致脚本无法解析等各种异常问题。

例如下面的报错，docker启动shell脚本可能是在windows下编写的。所以脚本无法

standard_init_linux.go:211: exec user process caused "no such file or directory"

如何把windows文件类型转为unix?

# 可以把windows文件类型转为unix

dos2unix file

如果是vscode，也可以点击对应的文件格式按钮。

为什么我不再使用语雀

Tue, 06 Dec 2022 21:10:38 +0800

我在2019年的六月份时候，开始使用语雀。

一路走来，我见证了语雀的功能越来越多，但是于此同时，我也越来越讨厌语雀。

2022年12月初，我基本上把语雀上的所有内容都迁移到我的hugo博客上。

我的博客很乱，也很多。我写了一个脚本，一个一个知识库的搬迁，总体速度还算快，唯一不便的就是图片需要一个一个复制粘贴。

有些图片是用语雀的绘图语言例如plantuml编写的，就只能截图保存了。

总之，我也是蛮累的。

简单列一下我不喜欢语雀的几个原因:

性能差，首页渲染慢，常常要等很久，首页才能打开
产品定位混乱，随意更改用户数据
1. 我记得有时候我把知识库升级成了空间，过了一段时间，不知道为什么空间由变成了知识库。
2. 数字花园这个概念真的很烂。我好好的个人主页，某一天打开，大变样，换了个名字，叫做数字花园。甚至没有给用户一个选择保留老版本的个人主页的权利。太不尊重用户了！！就好像你下班回家，看见房门被人撬开，你打开房门，看见有人在你的客厅种满大蒜，然后还兴高采烈的告诉你，看，这是您的数字菜园！多好，以后不用买蒜了。
3. 会员的流量计费规则，或许现在的计费规则已经变了，我也没有再充会员，但是再以前。即使是会员，也是按流量计费的。什么叫按流量计费，假如你的一篇博客里上传了一张1mb的图片，即使你后来把这个图片删了，这1mb的流量还是会存在。而且流量是一直往上涨的，还不像运营商，每月一号给你清零一次的机会。

模块传参的重构

Sat, 03 Dec 2022 21:01:02 +0800

写过opensips脚本的同学，往往对函数的传参感到困惑。

例如：

ds_select_dst()可以接受整数或者值为正数的变量作为第一个参数，但是nat_uac_test()的第一个参数就只能是整数，而不能是变量
为什么rl_check()可以接受格式化的字符串，而save()只能接受字符串。
为什么ds_select_dst("1", "4") 作为整数也要加上双引号？
为什么变量要加上双引号？ ds_select_dst("$var(aa)", "4")
为什么t_on_branch("1")路由的钩子要加上双引号？
为什么route(go_to_something);这里又不需要加上引号？

ds_select_dst("1", "0");
$var(aa)=1;
ds_select_dst("$var(aa)", "0");
rl_check("gw_$ru", "$var(limit)"); #格式化的gw_$ru
save("location"); #单纯的字符串作为参数

从3.0开始，传参可以更加自然。

整数可以直接传参，不用加双引号

do_something(1, 1);

输入或者输出的$var(), 不用加双引号，加了反而会报错

do_something($var(a), $var(b));

格式化字符串，需要加双引号

do_something(1, "$var(bb)_$var(b)");

参考

Pdf学习资料

Sat, 03 Dec 2022 16:02:18 +0800

1.1 脚本结构 - 全局参数、模块配置、路由

Mon, 01 Jan 0001 00:00:00 +0000

1. Structure

The structure of the kamailio.cfg can be seen as three parts:

global parameters
modules settings
routing blocks

For clarity and making it easy to maintain, it is recommended to keep them in this order, although some of them can be mixed.

✅ 这三个部分可以混合，但为了清晰和维护的方便，建议按照这个顺序排列。

2. Global Parameters Section

This is the first part of the configuration file, containing the parameters for the core of kamailio and custom global parameters.

1.10 SCTP参数

Mon, 01 Jan 0001 00:00:00 +0000

1. disable_sctp

Global parameter to disable SCTP support in the SIP server. see enable_sctp

Default value is ‘auto’.

Example of usage:

  disable_sctp=yes

2. enable_sctp

enable_sctp = 0/1/2  - SCTP disabled (0)/ SCTP enabled (1)/auto (2),
                       default auto (2)

3. sctp_children

sctp children no (similar to udp children)

sctp_children = number

4. sctp_socket_rcvbuf

Size for the sctp socket receive buffer

Alias name: sctp_socket_receive_buffer

sctp_socket_rcvbuf = number

5. sctp_socket_sndbuf

Size for the sctp socket send buffer

1.11 UDP参数

Mon, 01 Jan 0001 00:00:00 +0000

1. udp4_raw

Enables raw socket support for sending UDP IPv4 datagrams (40-50% performance increase on linux multi-cpu).

Possible values: 0 - disabled (default), 1 - enabled, -1 auto.

In “auto” mode it will be enabled if possible (sr started as root or with CAP_NET_RAW). udp4_raw can be used on Linux and FreeBSD. For other BSDs and Darwin one must compile with -DUSE_RAW_SOCKS. On Linux one should also set udp4_raw_mtu if the MTU on any network interface that could be used for sending is smaller than 1500.

1.12 黑名单参数

Mon, 01 Jan 0001 00:00:00 +0000

1. dst_blocklist_expire

Alias name: dst_blocklist_ttl

How much time a blocklisted destination will be kept in the blocklist (w/o any update).

dst_blocklist_expire = time in s (default 60 s)

2. dst_blocklist_gc_interval

How often the garbage collection will run (eliminating old, expired entries).

dst_blocklist_gc_interval = time in s (default 60 s)

3. dst_blocklist_init

If off, the blocklist is not initialized at startup and cannot be enabled at runtime, this saves some memory.

1.13 实时参数

Mon, 01 Jan 0001 00:00:00 +0000

1. real_time

Sets real time priority for all the Kamailio processes, or the timers (bitmask).

   Possible values:   0  - off
                      1  - the "fast" timer
                      2  - the "slow" timer
                      4  - all processes, except the timers
   Example: real_time= 7 => everything switched to real time priority.

real_time = <int> (flags) (default off)

2. rt_policy

Real time scheduling policy, 0 = SCHED_OTHER, 1= SCHED_RR and 2=SCHED_FIFO

rt_policy= <0..3> (default 0)

3. rt_prio

Real time priority used for everything except the timers, if real_time is enabled.

1.14 核心函数

Mon, 01 Jan 0001 00:00:00 +0000

Functions exported by core that can be used in route blocks.

1. add_local_rport ⭐️

Add rport parameter to local generated Via header – see RFC3581. In effect for forwarded SIP requests.

Example of usage:

add_local_rport();

2. avpflags

3. break

‘break’ statement can be used to end a ‘case’ block in a ‘switch’ statement or exit from a ‘while’ statement.

4. drop ⭐️

Stop the execution of the configuration script and alter the implicit action which is done afterwards.

1.15 自定义全局参数

Mon, 01 Jan 0001 00:00:00 +0000

These are parameters that can be defined by the writer of kamailio.cfg in order to be used inside routing blocks. One of the important properties for custom global parameters is that their value can be changed at runtime via RPC commands, without restarting Kamailio.

The definition of a custom global parameter must follow the pattern:

group.variable = value desc "description"

The value can be a quoted string or integer number.

1.16 路由块 - 请求路由、响应路由、分支路由、失败路由等

Mon, 01 Jan 0001 00:00:00 +0000

1. Routing Blocks

The routing blocks are the parts of the configuration file executed by kamailio at runtime. They can be seen as blocks of actions similar to functions (or procedures) from common programming languages.

A routing block is identified by a specific token, followed by a name in between square brackets and actions in between curly braces.

route_block_id[NAME] {
  ACTIONS
}

The name can be any alphanumeric string, with specific routing blocks enforcing a particular format.

1.17 脚本语法 - if、else、switch、while、赋值、比较、算数等

Mon, 01 Jan 0001 00:00:00 +0000

1. if

IF-ELSE statement

Prototype:

    if(expr) {
       actions;
    } else {
       actions;
    }

The expr should be a valid logical expression.

The logical operators that can be used in expr:

==: equal
!=: not equal
=~: case-insensitive regular expression matching: Note: Posix regular expressions will be used, e.g. use [[:digit:]]{3} instead of \d\d\d
!~: regular expression not-matching (NOT PORTED from Kamailio 1.x, use !(x =~ y))
>: greater
>=: greater or equal
<: less
<=: less or equal
&&: logical AND
||: logical OR
!: logical NOT

Example of usage:

1.18 命令行参数

Mon, 01 Jan 0001 00:00:00 +0000

Command Line Parameters

Kamailio can be started with a set of command line parameters, providing more flexibility to control what is doing at runtime. Some of them can be quite useful when running on containerised environments.

To see the the available command line parameters, run kamailio -h:

# kamailio -h

version: kamailio 5.4.0-dev4 (x86_64/darwin) 8c1864
Usage: kamailio [options]
Options:
    -a mode      Auto aliases mode: enable with yes or on,
                  disable with no or off
    --alias=val  Add an alias, the value has to be '[proto:]hostname[:port]'
                  (like for 'alias' global parameter)
    -A define    Add config pre-processor define (e.g., -A WITH_AUTH,
                  -A 'FLT_ACC=1', -A 'DEFVAL="str-val"')
    -b nr        Maximum receive buffer size which will not be exceeded by
                  auto-probing procedure even if  OS allows
    -c           Check configuration file for syntax errors
    -d           Debugging mode (multiple -d increase the level)
    -D           Control how daemonize is done:
                  -D..do not fork (almost) anyway;
                  -DD..do not daemonize creator;
                  -DDD..daemonize (default)
    -e           Log messages printed in terminal colors (requires -E)
    -E           Log to stderr
    -f file      Configuration file (default: /usr/local/etc/kamailio/kamailio.cfg)
    -g gid       Change gid (group id)
    -G file      Create a pgid file
    -h           This help message
    --help       Long option for `-h`
    -I           Print more internal compile flags and options
    -K           Turn on "via:" host checking when forwarding replies
    -l address   Listen on the specified address/interface (multiple -l
                  mean listening on more addresses). The address format is
                  [proto:]addr_lst[:port][/advaddr],
                  where proto=udp|tcp|tls|sctp,
                  addr_lst= addr|(addr, addr_lst),
                  addr=host|ip_address|interface_name and
                  advaddr=addr[:port] (advertised address).
                  E.g: -l localhost, -l udp:127.0.0.1:5080, -l eth0:5062,
                  -l udp:127.0.0.1:5080/1.2.3.4:5060,
                  -l "sctp:(eth0)", -l "(eth0, eth1, 127.0.0.1):5065".
                  The default behaviour is to listen on all the interfaces.
    --loadmodule=name load the module specified by name
    --log-engine=log engine name and data
    -L path      Modules search path (default: /usr/local/lib64/kamailio/modules)
    -m nr        Size of shared memory allocated in Megabytes
    --modparam=modname:paramname:type:value set the module parameter
                  type has to be 's' for string value and 'i' for int value,
                  example: --modparam=corex:alias_subdomains:s:kamailio.org
    -M nr        Size of private memory allocated, in Megabytes
    -n processes Number of child processes to fork per interface
                  (default: 8)
    -N           Number of tcp child processes (default: equal to `-n')
    -O nr        Script optimization level (debugging option)
    -P file      Create a pid file
    -Q           Number of sctp child processes (default: equal to `-n')
    -r           Use dns to check if is necessary to add a "received="
                  field to a via
    -R           Same as `-r` but use reverse dns;
                  (to use both use `-rR`)
    --server-id=num set the value for server_id
    --subst=exp set a subst preprocessor directive
    --substdef=exp set a substdef preprocessor directive
    --substdefs=exp set a substdefs preprocessor directive
    -S           disable sctp
    -t dir       Chroot to "dir"
    -T           Disable tcp
    -u uid       Change uid (user id)
    -v           Version number
    --version    Long option for `-v`
    -V           Alternative for `-v`
    -x name      Specify internal manager for shared memory (shm)
                  - can be: fm, qm or tlsf
    -X name      Specify internal manager for private memory (pkg)
                  - if omitted, the one for shm is used
    -Y dir       Runtime dir path
    -w dir       Change the working directory to "dir" (default: "/")
    -W type      poll method (depending on support in OS, it can be: poll,
                  epoll_lt, epoll_et, sigio_rt, select, kqueue, /dev/poll)

1.19 日志引擎

Mon, 01 Jan 0001 00:00:00 +0000

Log Engine CLI Parameter

The –log-engine parameter allows to specify what logging engine to be used, which is practically about the format of the log messages. If not set at all, then Kamailio does the classic style of line-based plain text log messages.

The value of this parameter can be –log-engine=name or –log-engine=name:data.

The name of the log engine can be:

json - write logs in structured JSON format
- the data for json log engine can be a set of character flags:
  - a - add log prefix as a special field
  - A - do not add log prefix
  - c - add Call-ID (when available) as a dedicated JSON attribute
  - j - the log prefix and message fields are printed in JSON structure format, detecting if they are enclosed in between { } or adding them as a text field
  - M - strip EOL (’\n’) from the value of the log message field
  - N - do not add EOL at the end of JSON document
  - p - the log prefix is printed as it is in the root json document, it has to start with comma (,) and be a valid set of json fields
  - U - CEE (Common Event Expression) schema format - https://cee.mitre.org/language/1.0-beta1/core-profile.html

Example of JSON logs when running Kamailio with “–log-engine=json:M” :

1.2 通用元素 - 注释、标识符、变量、值、表达式

Mon, 01 Jan 0001 00:00:00 +0000

1. Comments

Line comments start with # (hash/pound character - like in shell) or / / (double forward slash - like in C++/Java).

Block comments start with /* (forward slash and asterisk) and are ended by */ (sterisk and forward slash) (like in C, C++, Java).

Example:

  # this is a line comment

  // this is another line comment

  /* this
     is
     a
     block
     comment */

Important: be aware of preprocessor directives that start with #! (hash/pound and exclamation) - those are no longer line comments.

1.3 预处理指令 - 文件导入、宏定义、环境变量读取

Mon, 01 Jan 0001 00:00:00 +0000

预处理指令主要的目的是方便脚本维护，方便脚本在不同环境下运行。预处理之后，脚本才会开始解析。

1. include_file

   include_file "path_to_file"

Include the content of the file in config before parsing. path_to_file must be a static string. Including file operation is done at startup. If you change the content of included file, you have to restart the SIP server to become effective.

路径必须是静态，修改脚本要重启

The path_to_file can be relative or absolute. If it is not absolute path, first attempt is to locate it relative to current directory, and if fails, relative to directory of the file that includes it. There is no restriction where include can be used or what can contain - any part of config file is ok. There is a limit of maximum 10 includes in depth, otherwise you can use as many includes as you want. Reporting of the cfg file syntax errors prints now the file name for easier troubleshooting.

1.4 关键词

Mon, 01 Jan 0001 00:00:00 +0000

Keywords specific to SIP messages which can be used mainly in if expressions.

核心关键词主要用在if语句里，如果用在xlog里打印，那么就打印的是字符串了呀

1. af

The address family of the received SIP message. It is INET if the message was received over IPv4 or INET6 if the message was received over IPv6.

Exampe of usage:

    if (af==INET6) {
        log("Message received over IPv6 link\n");
    }

2. dst_ip

The IP of the local interface where the SIP message was received. When the proxy listens on many network interfaces, makes possible to detect which was the one that received the packet.

1.5 核心值

Mon, 01 Jan 0001 00:00:00 +0000

Values that can be used in 'if’ expressions to check against Core Keywords

主要还是用在if语句里做比较

1. INET

This keyword can be used to test whether the SIP packet was received over an IPv4 connection.

Example of usage:

    if (af==INET) {
        log("the SIP message was received over IPv4\n");
    }

2. INET6

This keyword can be used to test whether the SIP packet was received over an IPv6 connection.

Example of usage:

1.6 核心参数

Mon, 01 Jan 0001 00:00:00 +0000

kamailio和核心参数有106个，控制了kamailio的运行方式。

1. advertised_address

用处不大，将会废弃

1.7 DNS 参数

Mon, 01 Jan 0001 00:00:00 +0000

Note: See also file doc/tutorials/dns.txt for details about Kamailio’s DNS client.

Kamailio has an internal DNS resolver with caching capabilities. If this caching resolver is activated (default setting) then the system’s stub resolver won’t be used. Thus, also local name resolution configuration like /etc/hosts entries will not be used. If the DNS cache is deactivated (use_dns_cache=no), then system’s resolver will be used. The DNS failover functionality in the tm module references directly records in the DNS cache (which saves a lot of memory) and hence DNS based failover only works if the internal DNS cache is enabled.

1.8 TCP参数

Mon, 01 Jan 0001 00:00:00 +0000

The following parameters allows to tweak the TCP behaviour.

1. disable_tcp

Global parameter to disable TCP support in the SIP server. Default value is ’no'.

Example of usage:

  disable_tcp=yes

2. tcp_accept_aliases

If a message received over a tcp connection has “alias” in its via a new tcp alias port will be created for the connection the message came from (the alias port will be set to the via one).

1.9 TLS参数

Mon, 01 Jan 0001 00:00:00 +0000

Most of TLS layer attributes can be configured via TLS module parameters.

1. tls_port_no

The port the SIP server listens to for TLS connections.

Default value is 5061.

Example of usage:

  tls_port_no=6061

2. tls_max_connections

Maximum number of TLS connections (if the number is exceeded no new TLS connections will be accepted). It cannot exceed tcp_max_connections.

Default value is 2048.

Example of usage:

  tls_max_connections=4096

All on The SIP Lab

OpenSIPS vs Kamailio， 你应该选择哪个？

1. 拓扑隐藏能力

1.1. 什么是拓扑隐藏

图解VoIP#1: 你什么时候需要OpenSIPS或kamailio - 软交换架构演进之路

最简单的架构 - 1架构

支持FS动态扩展架构 2+N架构

2+N+N架构

三明治架构

ACK消息的URI来自哪里？

简介

RFC3261解读

天下苦 VOS 久矣

一、垄断既久，问题反成常态

二、用 VOS，工程师何其卑微

三、OpenSIPS / Kamailio：让系统“讲人话”

四、开源之苦，在前；开源之利，在后

SipWise C5 架构分析 WIP

SIPWISE C5 架构分析

接入层

参考

使用m4给opensips脚本增加预处理能力

使用m4给opensips脚本增加预处理能力

为什么要预处理？

m4难不难学？

定义宏

引用其他文件

ifelse(cond1,cond2, yes, no)

引号

如何调试宏, 使用-dV 参数

解决宏冲突问题

m4的劣势

有意思的几个扩展

检查宏是否未定义，或者是否为空字符串，空则报错退出

foreach 循环

【案例分享】JSSIP 电话无法挂断问题

【案例分享】外线呼入，SIP分机为何无响应？

案例分享

组网结构

排查思路

总结

SIP安全 - DTLS client Hello 攻击白皮书

TL;DR

影响软件

漏洞白皮书

表现

参考

OpenSIPS Summit 2025 速看

1. 加强 SDP 处理

DTLS协商失败导致无声问题

1. 简介

2. 网络结构说明

3. ICE/STUN/DTLS

3.1 STUN协商

RTPEngine mr13版本, 特殊的fmtp参数会导致某些语音编码被移除

场景说明

问题原因

VoIP Server 高可用架构设计

简介

接入层高可用

离谱的通话无声问题排查记录

简化网络模型

问题说明

呼叫流程

排查思路

延伸思考

总结

反思

DNS域名解析对MicroSIP注册的影响分析

microSIP DNS域名解析影响分析

读到无法解析的TCP包后, kamailio如何处理？

Hot Reload OpenSIPS vs Kamailio

Kamailio的实现方案

OpenSIPS的实现方案

结论

参考

开发学习笔记

架构图

SIP消息处理

HEP 协议学习笔记

OpenSIPS vs Kamailio，你应该选择哪个？

第一节如何熟悉Kamailio文档的文档结构

MacBook icloud 同步卡死，请尝试重启电脑