FreeSWITCH使用mod_fail2ban模块来提升安全

操作系统：Debian 12.5_x64

FreeSWITCH版本： 1.10.11

fail2ban版本： 1.1.0

nftables版本： 1.0.6

FreeSWITCH系统部署在公网，大概率会碰到恶意注册，今天整理下debian12环境下使用mod_fail2ban + fail2ban + nftables来提升系统安全性的笔记，并提供使用示例及相关资源下载。

相关资源资源可从如下渠道获取：

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

一、原理说明

这里描述下mod_fail2ban如何使用fail2ban软件添加防护规则，实现ip地址封禁。

原理示意图如下：

 

说明：

1）话机发起注册时，防火墙程序默认放行，注册请求会到达mod_sofia模块；

2）mod_sofia模块处理sip注册请求的过程中，会生成注册相关事件；

3）mod_fail2ban模块监听到注册事件后，进行过滤，根据既定规则生成fail2ban.log日志；

4）fail2ban程序解析fail2ban.log日志文件，根据配置规则添加防火墙策略；

5）防火墙程序使用新规则阻挡恶意注册；

 

fail2ban说明可参考GitHub描述，这里就不多说了。

https://github.com/fail2ban/fail2ban

二、模块安装及配置 

1、添加模块编译项

文件：源码根目录的modules.conf文件

添加（或取消注释）如下代码：

event_handlers/mod_fail2ban

 

2、编译及安装

源码目录执行如下命令：

autoreconf -fiv
make clean
./devel-bootstrap.sh && ./configure && make && make install

说明：

1）会编译mod_fail2ban模块；

2）如果配置文件没有找到，可以从源码目录复制过去；

cp src/mod/event_handlers/mod_fail2ban/fail2ban.conf.xml /usr/local/freeswitch/conf/autoload_configs/

 

3、加载mod_fail2ban模块

编辑 conf/autoload_configs/modules.conf.xml 文件，添加如下内容：

<load module="mod_fail2ban"/>

 重启FreeSWITCH或执行重新load操作：

load mod_fail2ban

 如果加载不报错，则添加mod_fail2ban 模块成功。

4、配置模块

配置文件路径：

/usr/local/freeswitch/conf/autoload_configs/fail2ban.conf.xml

配置文件内容如下（默认）：

<configuration name="fail2ban.conf" description="fail2ban log configs"><bindings><config name="settings" desription="configs"><param name="logfile" value="$${log_dir}/fail2ban.log"/></config></bindings>
</configuration>

5、模块运行效果

模块启动后，会自动创建日志文件，并写入相关日志。

默认日志路径：/usr/local/freeswitch/log/

 日志效果如下：

 

三、安装fail2ban软件

GitHub地址：

https://github.com/fail2ban/fail2ban

 

需要注意的是apt 安装的fail2ban软件版本是1.0.2，不能使用nftables，这里使用的是1.1.0版本，可从GitHub下载：

 

https://github.com/fail2ban/fail2ban/releases

 

如果下载过慢，可从如下渠道获取：

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

 

安装命令如下：

dpkg -i fail2ban_1.1.0-1.upstream1_all.deb

 配置文件目录： /etc/fail2ban

四、使用示例

 这里列举下使用示例。

1、配置防火墙

 

这里使用nftables来过滤ip地址，该软件是debian12默认安装的，如果没有安装，可用如下命令进行安装：

 

apt install nftables

这里使用的nftables v1.0.6版本。

2、配置fail2ban软件使用nftable

/etc/fail2ban/action.d目录默认有nttables的动作配置：

 /etc/fail2ban/jail.conf文件默认有freeswitch配置，默认未启用：

 为了方便演示，这里不使用默认的配置文件，修改后的 jail.conf 文件内容可从如下渠道获取：

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

3、添加freeswitch过滤规则

文件： filter.d/freeswitch-fail2ban.conf

文件内容可从如下渠道获取：

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

查看状态：

fail2ban-client status freeswitch-fail2ban

4、开启nftable服务

需要开启nftables服务：

systemctl start nftables

5、使用分机模拟注册失败

分机： 1009

填写错误的注册密码，执行注册操作。

连续10次注册失败，会自动拉黑，运行效果如下：

 到时间后，会自动解除：

 如需提前解除黑名单，可使用如下命令：

/usr/bin/fail2ban-client set freeswitch-fail2ban unbanip 192.168.137.1

运行效果如下：

该部分涉及的配置文件，可从如下渠道获取：

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

五、模块源码说明

源码目录：

src/mod/event_handlers/mod_fail2ban/

源码只有一个文件： mod_fail2ban.c

1、函数说明

该模块有4个函数：

mod_fail2ban_do_config ： 模块配置解析函数
fail2ban_logger ： 生成fail2ban日志
fail2ban_event_handler ： 模块事件处理回调函数
mod_fail2ban_load  ： 模块加载函数
mod_fail2ban_shutdown ： 模块关闭函数 

2、关键函数说明

模块的加载、关闭及配置解析没什么说的，这里描述下该模块的fail2ban_event_handler函数。

关于该函数的描述，可从如下渠道获取：

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

六、资源下载

本文相关资源及示例配置，可从如下渠道获取：

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

 

【文件说明】

fail2ban-1.1.0 : fail2ban-1.1.0源码及deb格式安装包

etc_fail2ban.tar.gz ： /etc/fail2ban目录打包文件

fail2ban模块.drawio ： drawio格式框架图

freeswitch-fail2ban.conf ： mod_fail2ban模块日志的过滤规则

jail.conf ： fail2ban配置

status1.sh ：fail2ban结果查看脚本