module-http-whitelist

基于 Linux Netfilter 过滤 HTTP 协议中的 Host 字段，也就是域名白名单

使用场景

需要一个简单的域名防火墙，只有指定的域名或者网络才能访问本机服务端口(默认 80端口)。本机*直接提供服务* 或 作为转发网关 此模块均可用。

代替方案

使用 iptables 的 string 模块，可以实现相同的功能。白名单数量少或 HTTP 流量小时，强烈建议使用此方案。

Note	白名单数量增多或 HTTP 流量非常大时，由于 string 模块匹配是在整个包中查找字符串，匹配速度会明显下降。

string 模块使用方法

#1. 创建自定义链

# IP 白名单
iptables -N whitelist_network

# HTTP 头
iptables -N http_header

# 域名白名单
iptables -N whitelist_host

#2. 匹配 IP 白名单匹配

# 访问 TCP 协议 80 端口的包进入 whitelist_network 链
iptables -A INPUT -p tcp --dport 80 -j whitelist_network

# 放行指定网络的包，不做任何过滤
iptables -I whitelist_network -p tcp -s 8.8.8.8/24 -j ACCEPT

# 包进入 http_header 链
iptables -A whitelist_network -p tcp -j http_header

#3. 匹配 HTTP 包

# 匹配包内容里面的 "Host:" 字符串，并进入 whitelist_host 链
iptables -I http_header -p tcp -m string --string "Host:" --algo bm -j whitelist_host

# 不是 HTTP 包，直接放行
iptables -A http_header -p tcp -j ACCEPT

#4. 匹配域名白名单匹配

# 匹配 HTTP 头中 "Host: " 之后的字符串，比如 "Host: abc.com"
iptables -I whitelist_host -p tcp -m string --string "abc.com" --algo bm -j ACCEPT
iptables -I whitelist_host -p tcp -m string --string "www.abc.com" --algo bm -j ACCEPT
iptables -I whitelist_host -p tcp -m string --string "123.456.798.test.abc.com" --algo bm -j ACCEPT
iptables -I whitelist_host -p tcp -m string --string "123.com" --algo bm -j ACCEPT
iptables -I whitelist_host -p tcp -m string --string ".123.com" --algo bm -j ACCEPT

# 不在域名白名单中的域名，无法访问 80 端口
iptables -A whitelist_host -p tcp -j DROP

端口

默认过滤 80 端口

Note	如果 Web 服务端口为 8080，修改源代码中的 `#define HTTP_PORT 80` 为 `#define HTTP_PORT 8080` 即可。

Note	端口变化不频繁，所以没考虑写到配置文件。

支持内核版本

2.6.18 及以上版本

开发以及测试平台

CentOS 5, 内核版本 2.6.18
CentOS 6, 内核版本 2.6.32
CentOS 7, 内核版本 3.10.0
Arch Linux, 内核版本 3.19.2

配置文件

主机信息将会保存到 /etc/http_whitelist 目录下。

初始化配置文件

$ sudo mkdir /etc/http_whitelist
$ sudo touch /etc/http_whitelist/host  /etc/http_whitelist/network

域名白名单 /etc/http_whitelist/host

此名单中的域名可以被任意位置的用户访问。

支持普通域名、无限子域名以及泛域名，每行一个，以回车符分割。

格式示例

abc.com
www.abc.com
123.456.798.test.abc.com
123.com
*.123.com

IP 白名单 /etc/http_whitelist/network

白名单模块会忽略在此文件中的单个 IP 地址或属于指定网络的 IP 地址，不会过滤任何 HTTP 包。相当于透明直通(不处理数据)。支持单 IP 以及 CIDR 风格的网络地址格式，每行一个，以回车符分割。

CIDR 说明: 无类别域间路由（Classless Inter-Domain Routing、CIDR）

格式示例

0.0.0.0/0
1.1.1.1/1
2.2.2.0/24
8.8.8.8
8.8.4.4

0.0.0.0/0: 相当于未使用白名单模块，不会过滤来自任何网络的 HTTP 包

Note	如果本机作为转发网关，必须添加内网网段，内网网络才能访问公网。比如本机 IP 地址为 1.1.1.1，内网网段为 192.168.1.0/24。将 192.168.1.0/24 写入 `/etc/http_whitelist/network` 文件，内网网络才能访问公网。

编译安装

依赖包

CentOS 5/6/7: sudo yum install kernel-devel
Arch Linux: sudo pacman -S linux-headers

编译

$ git clone https://github.com/fifilyu/module-http-whitelist.git
$ cd module-http-whitelist
$ make

安装及卸载

加载模块

$ sudo insmod http_whitelist.ko

加载模块后，会有如下日志：

3月 27 00:44:00 archlinux kernel: Loading module "http_whitelist"

卸载模块

$ sudo rmmod http_whitelist.ko

卸载模块后，会有如下日志：

3月 27 01:16:15 archlinux kernel: Unloading module "http_whitelist"

测试结果说明

IP 白名单

在此名单中的远程 IP 地址，访问 www.abc.com (在域名白名单中)，将会看到 Web 服务的响应 HTTP 内容
在此名单中的远程 IP 地址，访问 www.xxx.com (不在域名白名单中)，将会看到 Web 服务的响应 HTTP 内容
不在此名单中的远程 IP 地址，访问任何域名，请求都将会被转交给域名白名单审核

域名白名单

在 IP 白名单中的用户（远程 IP 地址）发起的 HTTP 请求，不会出现在此名单中
任意网络位置的用户，访问 www.abc.com (在域名白名单中)，将会看到 Web 服务的响应 HTTP 内容
任意网络位置的用户，访问 www.xxx.com (不在域名白名单中)，不会看到 Web 服务的响应 HTTP 内容，只会看到浏览器提示的 “连接被重置” 字样

dingl/module-http-whitelist