Skip to content

入侵防护与 WAF:封禁扫描器,拦截 Web 攻击 ​

服务器一开放到公网,日志里很快就满是 SSH 密码爆破、/.env、/wp-login.php 探测和各种注入尝试。Gately 用两个模块处理它们:入侵防护识别恶意来源并整台主机封禁它的 IP,WAF 检查每个请求的内容,把攻击请求挡在后端应用之前。本文从零配置两者:先保证不把自己封掉,再逐类开启封禁规则,最后给站点挂上 WAF 并处理误报。

先看一眼

在线演示 demo.gately.cn 点「演示账号一键进入」,侧边栏「安全 → 入侵防护」「安全 → WAF 防火墙」里有现成的规则、封禁记录和 WAF 实例,可以对照本文浏览(演示只读)。

适用场景与前提 ​

  • Gately 运行在有公网入口的机器上:云服务器,或家里映射了端口的 NAS、软路由;
  • 想要类似 fail2ban 的自动封禁,以及挂在网站前面的 Web 应用防火墙;
  • 网站已经由 Gately 的 Web 服务提供(还没有的话先看添加第一个站点);
  • 要在系统防火墙层封禁(推荐),Gately 需要能改防火墙:
    • Linux 直接安装:以 root 运行,或授予 CAP_NET_ADMIN,并装有 nftables(群晖等没有 nf_tables 的系统用 iptables legacy 与 ipset);
    • Docker:network_mode: host 并加上 cap_add: [NET_ADMIN],详见快速开始;
    • 飞牛 fnOS 安装包、OpenWrt 22.03 及以上:直接可用。

没有防火墙权限(Windows、macOS 或权限不足)时封禁照样生效,范围是 Gately 自己提供的服务:端口转发、Web 服务、STUN、WebDAV、FTP、SMB、管理后台。

结果是什么样 ​

text
                    ┌──────────── 入侵防护 ────────────┐
访客 ──▶ 系统防火墙 ─┤ 封禁表里的 IP:内核直接丢弃       │
        (nftables)  │ 诱饵端口 / 端口扫描:完成握手即封禁 │
                    └──────────────┬───────────────────┘
                                   ▼
                       Gately Web 服务(站点)
                    ├─ 路径探测、TLS 握手失败 ─▶ 计数,达到次数即封禁
                    └─ WAF(OWASP CRS)─▶ 拦截攻击请求(403)
                                   │      └─ 多次拦截 ─▶ 封禁
                                   ▼
                               后端应用
系统日志(sshd 等)─▶ 日志规则 ─▶ 封禁
  • 所有自动封禁、手动封禁写入同一张封禁表,开启防火墙同步后对整台主机生效,SSH、Docker 容器、转发给内网设备的流量一并丢弃;
  • WAF 按站点启用,一个 WAF 实例可以被多个站点引用;
  • 两者都可以在通知中心订阅,被封禁或被拦截时推送到手机,见通知与告警。

步骤 ​

1. 打开入侵防护,确认防火墙状态 ​

  1. 打开侧边栏「安全 → 入侵防护」(侧边栏没有这一项时,在「添加更多功能」里把它加上)。
  2. 页面顶部的「系统防火墙」卡片显示同步状态:
    • 「已生效」:封禁已经写进系统防火墙;右上角「查看规则」可以看到 Gately 写入的完整规则(nftables 的 inet gately 表,或 iptables 的 GATELY_* 链与 ipset 集合);
    • 「未生效」「不可用」:卡片下方给出原因和处理办法,例如「没有修改防火墙的权限」「找不到 nft 命令」,按提示补上权限或安装 nftables,再到「设置」页签点一次「保存」。
  3. 卡片里的四个数字:「封禁中」是当前有效的封禁条数,「已丢弃数据包」是防火墙丢掉的被封禁来源的包,「诱饵端口触发」「扫描检测触发」是两类内核检测的命中次数。

入侵防护页面:系统防火墙状态与封禁列表

2. 先加白名单,避免把自己封掉 ​

开启任何封禁规则之前做这一步。

  1. 切到「设置」页签。
  2. 「同步到系统防火墙」保持开启。开启后被封禁的地址发来的全部流量在内核层被丢弃;本机主动访问这些地址(DNS、软件源)的回包不受影响。关闭或停止 Gately 时规则会被整张移除。
  3. 「默认封禁时长」默认 1 小时,规则里选「默认」的都用它。
  4. 「递增封禁」默认开启:同一地址 30 天内再次被封禁,时长按次数翻倍,直到「最长封禁时长」(默认 7 天)。
  5. 白名单:
    • 「忽略内网地址」保持开启:回环、私有地址、100.64.0.0/10(运营商 NAT 与 Tailscale)、链路本地地址,以及本机网卡所在的 IPv6 /64 网段都不会被自动封禁;
    • 「白名单地址」每行一个 IP 或网段,填你家里或公司的公网出口,例如 203.0.113.10、2001:db8:1::/48。出口 IP 会变的宽带,可以填运营商分配的网段,或者依靠「管理后台登录成功的地址 24 小时内免于诱饵端口与端口扫描两类封禁」这条内置规则兜底。
  6. 点卡片右上角「保存」,提示「已保存并生效」。

设置页签:防火墙同步、封禁时长与白名单

白名单管不到的情况

白名单只影响自动封禁,「手动封禁」不受它限制。IPv6 的白名单按 /64 生效:填单个 IPv6 地址,它所在的整个 /64 都受保护。

3. 封禁 SSH 暴力破解 ​

  1. 切到「日志规则」页签,点「从模板添加」。下拉菜单列出全部内置模板,每项下方是一句说明。

    从模板添加:内置的日志规则模板

  2. 按系统选一个:

    • Debian / Ubuntu 等写 /var/log/auth.log 的系统:「SSH(日志文件)」,RHEL 系把文件路径改成 /var/log/secure;
    • 只有 systemd 日志的系统:「SSH(systemd 日志)」,读取 ssh.service / sshd.service;
    • OpenWrt:「Dropbear(OpenWrt)」,通过 logread -f 读取。
  3. 编辑框已经填好:「日志来源」「文件路径」「过滤规则」(Go 正则,用 <HOST> 表示来源 IP),「触发条件」为 10 分钟内失败 5 次即封禁,「封禁时长」为「默认」。

  4. Docker 部署读宿主机日志时,先把日志目录挂进容器(例如 - /var/log:/var/log/host:ro),「文件路径」改成 /var/log/host/auth.log。容器里没有 journalctl,systemd 日志来源不可用,改用日志文件。

  5. 用编辑框底部的「测试」确认正则能取出 IP:在「日志样例」里粘贴一行真实的失败记录,例如

    text
    Nov 17 10:00:01 vps sshd[1234]: Failed password for invalid user admin from 203.0.113.50 port 51234 ssh2

    点「测试」,结果显示「1 行中匹配 1 行」,标签是 203.0.113.50。白名单里的地址会显示为「(白名单)」。

  6. 点「保存」。规则卡片显示「运行中」,以及「匹配次数」「封禁:累计 N,当前 N」。

其他模板用法相同:「Vaultwarden」「Home Assistant」读取同名 Docker 容器的日志(需要 Docker 管理模块能连上 Docker),「Proxmox VE」读取 pvedaemon.service,「Nginx 基本认证」「Nginx 恶意扫描」读取 nginx 的日志文件。自己写规则点「添加规则」,「日志来源」可选「日志文件」「systemd 日志」「命令输出」「Docker 容器」。

4. 封禁 Gately 自身事件:后台登录失败、WAF 拦截、文件服务登录失败 ​

「日志来源」选「Gately 事件」的规则直接统计 Gately 内部事件,事件自带来源 IP,不需要过滤规则。从模板添加即可:

模板统计的事件默认条件
Gately 管理后台登录管理后台登录失败(密码、两步验证、通行密钥)10 分钟 5 次
WAF 拦截WAF 拦截请求(第 8 步配置 WAF 后才有)5 分钟 5 次,封禁 1 天
端口敲门失败端口敲门被拒绝10 分钟 5 次,封禁 1 天
文件服务登录失败WebDAV、FTP、SMB 登录失败10 分钟 10 次

把这四个都加上,管理后台和文件服务就有了与 SSH 同样的爆破保护。

5. 封禁 Web 路径扫描 ​

扫描器会成批请求 /.env、/.git/config、/wp-login.php。「Web 路径探测」直接统计 Web 服务处理的请求,不需要读日志。

  1. 打开「Web → Web 服务」,在对外的监听卡片上点「路径探测封禁」。页面跳到入侵防护,打开「添加规则」,「日志来源」已选「Web 路径探测」,「监听」预选为这个监听,「模板」套用「Web 诱饵路径」。也可以在「日志规则」页签点「从模板添加」选同名模板,这时「监听」留空表示全部监听。
  2. 检查「路径规则」:模板列出 */.env、*/.git、*/wp-login.php、*/phpmyadmin* 等扫描器常探测的路径。* 匹配任意字符(含 /),整条路径匹配,不区分大小写;以 ~ 开头写 Go 正则。你的站点本身就是 WordPress 或 phpMyAdmin 时,先删掉对应的行。
  3. 「任意状态码」已开启:诱饵路径正常用户不会访问,单页应用对任意路径都返回 200,开启后任何响应都计数。
  4. 「触发条件」10 分钟内命中 1 次即封禁,「封禁时长」1 天。
  5. 在底部「请求路径」里每行填一个路径,点「测试」核对哪些会命中。
  6. 点「保存」。

Web 路径探测规则:诱饵路径模板与测试结果

再按需要添加两个同类模板:

  • 「未知域名扫描」:只统计域名没有匹配任何站点的请求(直接用 IP 访问,或用未配置的域名访问),1 分钟 5 次封禁 1 天。默认站点类型设为「断开连接」时搭配最好:扫描器几次 444 后被封,之后的连接在防火墙层直接被丢弃;
  • 「Web 404 探测」:1 分钟内 10 次 404 或 444 即封禁,已排除 favicon、robots.txt 等浏览器常请求的路径。反代后端自己返回的 404 同样计数,图库缩略图缺失、应用轮询不存在的接口都可能触发;启用前先在站点的访问日志里看看平时有多少 404,必要时调高次数或补充「排除路径」。

自己人被误封

站点开启了 Gately 的登录认证时,在站点编辑的「安全」页签勾选「信任已登录用户」(已登录访客跳过 WAF 与路径探测封禁)。已登录用户的请求不再计入路径探测,也不经过 WAF;未登录的访客照常统计。

6. 封禁异常 TLS 握手 ​

有一类扫描只连上 HTTPS 端口发几个字节就断开,不产生 HTTP 请求,路径探测统计不到。「TLS 握手失败」规则统计 Web 服务 HTTPS 监听上的握手失败,按失败类型计数。

  1. 「日志规则」页签点「从模板添加」,选「TLS 异常握手」:统计「非 TLS 或协议错误」「无法协商参数」两类,1 分钟 5 次封禁 1 天。正常浏览器不会产生这两类失败,可以放心开启。
  2. 可选再加「TLS 握手中断」:统计「握手中途断开(EOF)」「连接被重置」「握手超时」,1 分钟 20 次。浏览器预连接、手机切换网络也会产生这类失败,次数不要调低。
  3. 「握手失败类型」里还有「未知域名(无证书)」「客户端中止(TLS 警报)」「其他」,可以自建规则勾选。「客户端中止」多半是客户端不信任证书,不建议用来封禁。
  4. 在「失败原因」里粘贴运行日志中「TLS 握手失败」后面的英文原因(例如 tls: first record does not look like a TLS handshake),点「测试」可以看到它归入哪个类型。

来源地址落在 Web 服务「可信代理」里(CDN 回源节点)的握手失败不计数,避免回源节点被封。

7. 诱饵端口与端口扫描检测 ​

这两项在内核里工作,需要第 1 步的防火墙状态为「已生效」。

  1. 切到「诱饵端口与扫描检测」页签。
  2. 「诱饵端口」卡片:
    • 打开「启用」;
    • 「端口」留空使用默认(23、135、1433、1521、3389、5900、6379、11211),也可以自己填,逗号分隔,支持 5900-5910 这样的范围;
    • 本机正在监听的端口自动排除,「状态」一行显示实际生效的端口,以及因为正在被监听而排除的端口;
    • 选「封禁时长」后点卡片右上角「保存」。
  3. 「端口扫描检测」卡片:
    • 打开「启用」;
    • 「阈值」默认每分钟 12 次:同一来源每分钟连接本机未开放端口超过该次数即封禁。正常客户端重试一个关闭的端口每分钟约 5 次,建议不低于 10;
    • 「额外开放端口」:本机正在监听的端口自动视为开放,其他程序通过防火墙规则使用的端口(例如 Docker 以外的 DNAT 转发)补在这里;
    • 「IPv6 严格模式」:IPv6 来源第一次连接未开放端口即封禁(按 /64),IPv4 仍按阈值。开启前确认额外开放端口已经填全,FTP 服务要设置被动端口范围;
    • 点「保存」。

诱饵端口与端口扫描检测

两项都要求连接完成 TCP 握手才计入:伪造源地址的 SYN 无法借此封禁别人;只发 SYN 的扫描(如 masscan)会看到这些端口开放,但不会被封禁。内核低于 Linux 5.2 时页面会提示,诱饵端口改由 Gately 直接监听,端口扫描检测不可用。

8. 创建 WAF 实例 ​

  1. 打开侧边栏「安全 → WAF 防火墙」,点「添加实例」。
  2. 填写:
    • 「名称」:公网站点;
    • 「模式」:选「仅检测(只记录日志)」。新站点先观察一段时间,确认没有误报再切到「拦截」;
    • 「偏执等级」:保持 1。等级越高越严格,误报也越多;
    • 「正则预过滤」:保持开启,检测 CPU 约降低 16%;
    • 「入站阈值」5、「出站阈值」4:CRS 按异常分数判定,单个请求累计分数达到阈值即判为攻击,保持默认;
    • 「请求体检查」:默认只检查不超过 12.5 MB 的请求体,超过时「拒绝请求」(413)。网盘、WebDAV 这类要上传大文件的站点单独建一个实例,打开「兼容 WebDAV 与上传」,「超过上限时」选「只检查前面部分」,上传接口可以填进「跳过请求体的路径」;
    • 「规则组」:默认已有一组「OWASP CRS」,下拉框留空表示启用全部规则文件。
  3. 点「保存」。实例卡片显示「检测中」(拦截模式显示「防护中」),以及「已拦截」「规则命中」计数。

添加 WAF 实例:仅检测模式与 OWASP CRS 规则组

9. 把 WAF 挂到站点 ​

  1. 回到「Web → Web 服务」,在要保护的站点上点「编辑」。
  2. 切到「安全」页签,在「WAF 实例」选刚建的「公网站点」。
  3. 点「保存」。站点行出现红色的「WAF」标签。

站点编辑的安全页签:选择 WAF 实例

修改 WAF 实例后立即生效,站点不需要重新保存。站点很多时,在 Web 服务页点「排序与批量」,勾选多个站点后用「批量选项」一次设置 WAF 实例。

管理后台经挂了 WAF 的站点反向代理访问时,带本实例有效管理员登录态的请求不经过 WAF:保存配置时请求体里的文件路径、HTML、脚本不会被误拦。只读账号和访客照常检查。

10. 观察误报,再切换到拦截 ​

  1. 在「WAF 防火墙」页底部的「拦截与命中日志」里查看命中记录。每条带来源 IP、域名、路径和规则 ID,点日志里的字段标签可以按它筛选,「更多筛选」可按 IP、域名、路径、规则缩小范围。

  2. 正常使用一段时间(几天到一周),把站点的日常操作都走一遍:登录、保存、上传、搜索。

  3. 找出正常请求触发的规则。分数判定规则 949110(入站异常分数超限)只是汇总,要看同一请求前面那几条具体规则的 ID,例如 942100(SQL 注入)、941100(XSS)、930120(敏感文件访问)。

  4. 针对误报添加例外:编辑实例,点「添加规则组」,类型选「自定义 SecLang」,按指令类型放对位置(规则组可用上移、下移按钮排序):

    • 只对某个路径、某个参数关闭某条规则(推荐,影响面最小):放在 OWASP CRS 规则组之前。

      text
      SecRule REQUEST_URI "@beginsWith /api/notes" "id:10001,phase:1,pass,nolog,ctl:ruleRemoveTargetById=942100;ARGS:content"

      含义:请求 /api/notes 时,规则 942100 不再检查参数 content。

    • 对某个路径关闭某条规则:同样放在 CRS 之前。

      text
      SecRule REQUEST_URI "@beginsWith /api/editor" "id:10002,phase:1,pass,nolog,ctl:ruleRemoveById=941100"
    • 整个实例关闭某条规则:放在 OWASP CRS 规则组之后。

      text
      SecRuleRemoveById 920350

    自定义规则的 id 每条不重复,从 10001 这类小编号起用,避开 CRS 使用的 9xxxxx 段与 Gately 内部生成的 881xxxx 段。保存时规则有语法错误,实例卡片显示「编译失败」和错误内容,这期间引用它的站点直接放行。

  5. 确认日志里只剩真实攻击后,编辑实例把「模式」改为「拦截」,保存。

  6. 回到入侵防护添加「WAF 拦截」模板(第 4 步),多次发起攻击的来源会被整机封禁。

也可以先看再改

同一份实例可以「复制」一份,副本设为「仅检测」并提高偏执等级挂到一个站点上观察,其余站点继续用拦截模式的实例。

11. 手动封禁与解封 ​

  • 页头点「手动封禁」,「IP / 网段」填 203.0.113.7 或 198.51.100.0/24,「封禁时长」选「默认」「自定义」或「永久」,「原因」可选填,点「封禁」。网段不能包含回环地址;
  • 「封禁列表」页签可以按地址、来源或原因搜索;「来源」列显示是哪条规则、诱饵端口、端口扫描、Web 认证失败还是手动;「剩余」列显示到期时间,永久封禁显示为「永久」;
  • 误封时点该行的「解封」,立即从防火墙移除。

Web 服务站点的登录认证连续失败 10 次也会封禁来源 IP(来源显示为「Web 认证失败」),时长在「Web 服务 → 全局设置」的「认证失败封禁」设置,单位为分钟,0 表示只限流 15 分钟不封禁。

验证 ​

从白名单以外的网络测试(例如手机流量),测完记得到「封禁列表」解封自己。

bash
# WAF:仅检测模式返回正常页面,命中日志出现 942 开头的 SQL 注入规则;拦截模式返回 403
curl -i "https://blog.example.com/?id=1%27%20OR%20%271%27=%271"

# 路径探测:请求诱饵路径一次,之后这个 IP 的所有连接都会超时
curl -i https://blog.example.com/.env
curl -m 5 -I https://blog.example.com/    # 被封禁后超时

# TLS 异常握手:向 HTTPS 端口发明文 HTTP,1 分钟内 5 次触发封禁
for i in 1 2 3 4 5; do curl -s -m 3 http://blog.example.com:443/ >/dev/null; done

在界面上确认:

  1. 入侵防护「封禁列表」出现测试用的 IP,「来源」是对应的规则名,「原因」写明命中的路径或次数;
  2. 「系统防火墙」卡片「封禁中」加 1,「已丢弃数据包」随后续请求增长;
  3. 页面底部「运行日志」有一行「已封禁」记录;
  4. WAF 实例卡片「规则命中」「已拦截」计数增长,「拦截与命中日志」里有对应记录;
  5. 在站点的「访问日志」里,被 WAF 拦截的请求带「拦截原因」字段,值为 WAF;被封禁后被拒绝的请求为「已封禁」。日志面板的「隐藏被封禁来源」可以把这些请求隐藏,只看正常访问。

常见问题 ​

把自己封了,管理后台打不开。 换一个网络(例如手机热点)登录后台,在「封禁列表」解封自己的 IP,再把出口地址加进「设置」里的「白名单地址」。临时封禁到期后也会自动解除。

防火墙状态显示「没有修改防火墙的权限」。 Docker 部署缺少 cap_add: [NET_ADMIN] 或没有使用 host 网络;systemd 服务在 [Service] 中加入 AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE。改好后重建容器或重启服务。

SSH 规则「匹配次数」一直是 0。 日志路径不对或 Gately 读不到文件:Docker 里看看日志目录有没有挂载;部分系统(Debian 12 最小安装等)没有 /var/log/auth.log,改用「SSH(systemd 日志)」。规则卡片显示「异常」时,下方会有具体错误。

SSH 经协议分流走 443,sshd 日志里全是 127.0.0.1。 sshd 看到的连接来自 Gately,日志规则取到的是回环地址,会被白名单忽略。这种情况在协议分流规则上设置 IP 访问控制,或用端口敲门保护 SSH,见一个 443 端口跑所有服务。

站点经 CDN 回源,封禁的是 CDN 节点。 在「Web 服务 → 全局设置」的「可信代理」填 CDN 的回源地址段并选择「真实 IP 请求头」,访问日志、路径探测、WAF 与认证失败封禁才会使用访客的真实 IP。没有配置时,这类站点不要启用路径探测和「WAF 拦截」规则。

网盘、WebDAV 上传大文件失败(413)。 WAF 的请求体检查上限默认 12.5 MB。给这类站点单独建实例,打开「兼容 WebDAV 与上传」,「超过上限时」选「只检查前面部分」。

正常用户被「Web 404 探测」封了。 后端应用自己返回大量 404(缺图、轮询旧接口)。在规则的「排除路径」里加上这些路径,或把次数调高;站点有登录时开启「信任已登录用户」。

诱饵端口卡片提示「防火墙未生效,由 Gately 监听」。 系统防火墙不可用,诱饵端口改由 Gately 在这些端口上直接监听,只能发现完成握手的连接,端口扫描检测不可用。先解决第 1 步的防火墙状态。

封禁表满了怎么办。 封禁表最多 32768 条,满了以后新的自动封禁先淘汰已到期、再淘汰最早的临时自动封禁,永久封禁与手动封禁保留,运行日志会记录被淘汰的条目。

下一步 ​

以 Apache-2.0 许可证开源发布。