台湾服务器如何配置Fail2ban保护SSH登录,并确认封禁规则生效?
台湾服务器上部署 Fail2ban,核心目标是监控 SSH 认证失败记录,并在同一来源地址持续失败时调用主机防火墙临时封禁该地址。正确配置后,需要同时确认三件事:Fail2ban 能读到 SSH 日志、sshd jail 已经运行、封禁地址确实出现在防火墙规则中。
下面以使用 systemd、Debian 12、Ubuntu 22.04/24.04 一类 Linux 系统的台湾云服务器或独立服务器为主线,采用 nftables 作为封禁动作。台湾机房本身不会改变 Fail2ban 的安装方式,但远程管理时应提前准备服务商控制台或带外管理入口,避免测试地址被封后无法通过 SSH 登录。
围绕台湾服务器上的网站和业务后台运维,A5idc数据提供中国台湾台北地区的物理服务器,具有不同的CPU、存储及优化或国际线路方案,可为业务部署提供计算与网络资源。对于使用Linux的服务器,这些资源也能承载Fail2ban等主机安全工具,让SSH登录防护与日常业务运行在同一环境中开展。
一、准备条件与环境确认
1. 确认操作系统和权限
先登录服务器,确认系统版本、当前用户权限和 SSH 服务状态:
cat /etc/os-release
id
sudo systemctl status ssh --no-pager
sudo systemctl status sshd --no-pager
不同发行版的 SSH 服务名称可能不同:
- Debian、Ubuntu 通常使用
ssh.service。 - Rocky Linux、AlmaLinux、CentOS 通常使用
sshd.service。 - 两条
systemctl status命令中有一条显示服务不存在属于正常情况。
确认当前用户可以使用 sudo:
sudo -v
如果当前登录账号没有 sudo 权限,应先通过服务器控制台切换到具备管理权限的账号。不要在尚未确认控制台可用的情况下直接修改 SSH 或防火墙配置。
2. 确认 SSH 端口和日志来源
Fail2ban 的封禁端口必须与 SSH 实际监听端口一致。先检查 SSH 配置是否能通过语法检查,再读取生效配置:
sudo sshd -t
sudo sshd -T | awk '$1=="port"{print $2}'
sudo ss -lntp | grep -E ':(22|[0-9]+)\s'
常见结果如下:
22
如果服务器使用的是 2222 等自定义端口,后面的配置中应将 port = ssh 改为实际端口,例如:
port = 2222
检查当前系统能否从 systemd journal 读取 SSH 记录:
sudo journalctl _COMM=sshd -n 20 --no-pager
sudo journalctl -u ssh.service -n 20 --no-pager
sudo journalctl -u sshd.service -n 20 --no-pager
只要其中一条能看到 SSH 启动或认证相关记录,就可以使用 systemd 后端。不要根据发行版名称猜测日志路径,优先以实际输出为准。
3. 提前准备管理地址和回滚入口
在配置 ignoreip 前,准备实际管理端的公网地址:
- 固定 IPv4 地址使用
/32,例如198.51.100.10/32。 - 固定 IPv6 地址使用
/128。 - 如果管理端使用动态公网地址,不建议把经常变化的地址长期加入白名单。
- 通过公司出口或 NAT 访问时,白名单应填写出口公网地址,而不是办公电脑的内网地址。
示例中的 198.51.100.10 属于文档保留地址,不能直接当作真实管理地址使用。没有带外控制台时,至少要确认可以通过服务商网页控制台进入服务器。
二、安装 Fail2ban 和防火墙依赖
1. Debian 和 Ubuntu 安装方式
先检查现有防火墙,避免不清楚当前规则的情况下覆盖或清空规则:
sudo systemctl is-active nftables 2>/dev/null || true
sudo systemctl is-active ufw 2>/dev/null || true
sudo systemctl is-active firewalld 2>/dev/null || true
安装 Fail2ban 和 nftables 命令组件:
sudo apt-get update
sudo apt-get install -y fail2ban nftables
这里的安装动作不会主动清空已有防火墙规则。后续 Fail2ban 只会添加自己的封禁链或集合,但仍应先了解服务器当前使用的是 nftables、UFW 还是 firewalld。
2. Rocky Linux、AlmaLinux 等系统的处理方式
如果服务器不是 Debian 或 Ubuntu,不要直接执行 apt-get。先确认软件源是否提供 Fail2ban:
cat /etc/redhat-release
sudo dnf search fail2ban
在已配置对应软件源的前提下,可以安装:
sudo dnf install -y fail2ban
如果系统已经使用 firewalld,并且软件源提供对应动作包,再安装:
sudo dnf install -y fail2ban-firewalld
不要为了安装 Fail2ban,未经确认就执行 systemctl enable --now firewalld。启用新的防火墙管理服务可能改变原有放行规则。后续如果使用 firewalld,应把封禁动作设置为:
banaction = firewallcmd-ipset
如果系统使用 UFW,则应使用:
banaction = ufw
本文以下主流程采用 nftables-multiport,适用于已经确认主机可以使用 nftables 的环境。
三、备份并创建 SSH 封禁规则
1. 备份现有 Fail2ban 配置
Fail2ban 的全局配置通常位于 /etc/fail2ban。先创建一份带时间戳的备份:
BACKUP_DIR="/root/fail2ban-backup-$(date +%F-%H%M%S)"
sudo cp -a /etc/fail2ban "$BACKUP_DIR"
echo "$BACKUP_DIR"
该备份用于回滚当前配置,不要在没有备份的情况下直接覆盖原有的 jail.local。本次使用独立的 jail.d/sshd.local 文件,便于后续只撤销 SSH jail。
2. 创建 SSH jail 配置
创建配置目录:
sudo install -d -m 0755 /etc/fail2ban/jail.d
写入配置:
sudo tee /etc/fail2ban/jail.d/sshd.local >/dev/null <<'EOF'
[DEFAULT]
# 统计失败次数的时间窗口
findtime = 10m
# 达到 maxretry 后的封禁时长
bantime = 1h
# 在 findtime 内允许的失败次数
maxretry = 5
# 使用 systemd journal 读取 sshd 认证记录
backend = systemd
# 使用 nftables 添加封禁规则
banaction = nftables-multiport
# 必须替换为实际管理端公网地址
ignoreip = 127.0.0.1/8 ::1 198.51.100.10/32
[sshd]
enabled = true
filter = sshd
# 标准 SSH 端口使用 ssh;自定义端口请改为具体数字
port = ssh
# 按进程名筛选 sshd 记录,兼容 ssh.service 和 sshd.service
journalmatch = _COMM=sshd
EOF
保存前应修改两处:
- 将
198.51.100.10/32替换为实际管理端公网 IPv4 地址。 - 如果 SSH 不是 22 端口,将
port = ssh改为实际端口,例如port = 2222。
如果管理端同时通过 IPv6 登录,可在 ignoreip 后追加实际 IPv6 地址,例如:
ignoreip = 127.0.0.1/8 ::1 198.51.100.10/32 2001:db8::10/128
不要把 0.0.0.0/0 或 ::/0 加入 ignoreip,否则所有地址都会被排除,Fail2ban 将失去封禁意义。
3. 参数含义和适用边界
| 参数 | 示例值 | 作用 |
|---|---|---|
findtime | 10m | 统计失败登录的时间范围 |
maxretry | 5 | 在统计窗口内达到该次数后封禁 |
bantime | 1h | 单次封禁持续时间 |
ignoreip | 管理端地址 | 排除可信管理来源 |
backend | systemd | 从 systemd journal 读取日志 |
banaction | nftables-multiport | 使用 nftables 执行封禁 |
port | ssh 或 2222 | 指定需要保护的 SSH 端口 |
findtime = 10m 和 maxretry = 5 只是适合首次部署的示例值。对于多人共用出口地址的办公网络,不应把阈值设置得过低,否则一个账号输错密码可能导致整个出口地址暂时无法登录。Fail2ban 主要针对重复认证失败,不能替代 SSH 密钥、最小权限账号和定期更新凭据。
四、检查配置并启动服务
1. 先执行配置语法检查
在重启服务前检查配置:
sudo fail2ban-client -t
预期结果类似:
OK: configuration test is successful
如果出现 ERROR,先修复错误,不要继续重启。常见原因包括:
- 配置文件缩进或参数拼写错误。
nftables-multiport动作文件不存在。journalmatch写在了错误的配置段。- 系统中没有安装 nftables 命令。
jail.d/sshd.local文件扩展名或路径错误。
确认动作文件和命令存在:
command -v nft
sudo test -f /etc/fail2ban/action.d/nftables-multiport.conf && echo "action exists"
2. 启动并设置开机启动
配置检查通过后启动 Fail2ban:
sudo systemctl enable --now fail2ban
sudo systemctl status fail2ban --no-pager
预期状态应为:
Active: active (running)
如果服务没有启动,查看最近日志:
sudo journalctl -u fail2ban -n 50 --no-pager
不要用 systemctl restart ssh 作为验证 Fail2ban 的步骤。本文没有修改 SSH 服务配置,重启 SSH 只会增加远程连接风险。
3. 确认 sshd jail 已加载
查看所有 jail:
sudo fail2ban-client status
正常情况下会看到:
Status
|- Number of jail: 1
`- Jail list: sshd
继续查看 SSH jail:
sudo fail2ban-client status sshd
示例输出如下:
Status for the jail: sshd
|- Filter
| |- Currently failed: 0
| |- Total failed: 0
| `- File list:
`- Actions
|- Currently banned: 0
|- Total banned: 0
`- Banned IP list:
初始状态没有封禁地址是正常的。此时重要的是能看到 Jail list: sshd,并且没有 ERROR 或 Jail 'sshd' does not exist。
五、确认封禁规则真正生效
仅看到 Fail2ban 服务处于运行状态还不够,还要验证日志识别、地址封禁和防火墙规则三个环节。

1. 使用独立测试地址触发失败登录
测试必须从未加入 ignoreip 的第二个公网地址发起。不要使用当前正在管理服务器的 SSH 地址,也不要在生产业务高峰期进行。
在第二台测试设备上执行一次 SSH 连接,并故意输入错误密码:
ssh -o PreferredAuthentications=password \
-o PubkeyAuthentication=no \
-o NumberOfPasswordPrompts=1 \
-p 22 invalid-test@SERVER_IP
其中:
SERVER_IP替换为服务器公网地址。-p 22替换为实际 SSH 端口。invalid-test可以使用不存在的测试账号。- 只需按照
maxretry设置进行有限次数测试,不要进行无控制的循环尝试。
如果服务器关闭了密码认证,可以从测试地址使用一个不匹配的密钥发起有限次数的认证失败。测试前应确认测试源地址不是管理白名单,否则 Fail2ban 会按配置忽略它。
2. 查看 Fail2ban 是否识别失败记录
在服务器上执行:
sudo fail2ban-client status sshd
测试地址达到阈值后,预期会看到:
Currently banned: 1
Banned IP list: TEST_CLIENT_IP
也可以查看 Fail2ban 自身日志:
sudo journalctl -u fail2ban -n 50 --no-pager
示例记录可能类似:
NOTICE [sshd] Ban 203.0.113.55
上面的地址和日志只是示例,实际输出会使用测试客户端的公网地址。
3. 查看 nftables 中的封禁链或地址
执行:
sudo nft list ruleset | grep -E -A8 -B2 'f2b|TEST_CLIENT_IP'
把 TEST_CLIENT_IP 替换为实际测试地址。不同 Fail2ban 版本生成的表名、链名和集合名称可能不同,但通常可以看到包含 f2b 的对象,或者直接看到被封禁的地址。
也可以使用 Fail2ban 接口查询:
sudo fail2ban-client get sshd banip
如果该命令在较旧版本中不可用,以 fail2ban-client status sshd 和 nft list ruleset 的结果为准。
4. 解除测试地址封禁
验证完成后立即解除测试地址:
sudo fail2ban-client set sshd unbanip TEST_CLIENT_IP
将 TEST_CLIENT_IP 替换为实际地址。再次检查:
sudo fail2ban-client status sshd
sudo nft list ruleset | grep -E 'f2b|TEST_CLIENT_IP'
测试地址不再出现在当前封禁列表中,说明解封动作也能正常执行。不要直接执行 nft flush ruleset,这会清空整台服务器的 nftables 规则,可能导致业务端口和管理端口同时失去保护。
六、常见异常及处理顺序
1. 显示 Jail 'sshd' does not exist
先检查配置文件是否存在:
sudo ls -l /etc/fail2ban/jail.d/sshd.local
sudo grep -nE '^\[sshd\]|^enabled|^banaction|^backend' /etc/fail2ban/jail.d/sshd.local
然后重新执行:
sudo fail2ban-client -t
sudo systemctl restart fail2ban
sudo fail2ban-client status
如果配置测试通过但 jail 仍未出现,重点检查:
[sshd]是否拼写正确。enabled = true是否位于[sshd]段内。- 是否存在其他配置将
enabled覆盖为false。 - 是否把文件保存到了
/etc/fail2ban/jail.local之外的错误目录。
2. Fail2ban 启动,但没有统计失败次数
先确认 SSH 认证失败是否出现在 journal:
sudo journalctl _COMM=sshd -n 50 --no-pager
sudo journalctl -u ssh.service -n 50 --no-pager
sudo journalctl -u sshd.service -n 50 --no-pager
如果能看到失败记录,但 Fail2ban 的 Total failed 仍为零,检查过滤器:
sudo test -f /etc/fail2ban/filter.d/sshd.conf && echo "sshd filter exists"
sudo fail2ban-regex /var/log/auth.log /etc/fail2ban/filter.d/sshd.conf
/var/log/auth.log 不存在时,不要强行使用该路径。RHEL 系统常见日志文件是 /var/log/secure,而使用 systemd 后端时可以直接从 journal 读取。
如果系统没有正常保留 journal,且确认存在认证日志文件,可以在 jail 配置中改为文件后端。例如 Debian 或 Ubuntu:
[sshd]
enabled = true
filter = sshd
backend = auto
logpath = /var/log/auth.log
port = ssh
修改后重新执行配置检查和服务重启。不要同时写入一个不存在的 logpath,否则 Fail2ban 可能因为找不到日志文件而无法启动 jail。
3. 出现 nftables 动作错误
检查 nftables 命令和动作文件:
command -v nft
sudo nft list ruleset
sudo ls -l /etc/fail2ban/action.d/nftables-multiport.conf
sudo journalctl -u fail2ban -n 80 --no-pager
如果服务器实际使用 UFW,将配置中的动作改为:
banaction = ufw
如果服务器实际使用 firewalld,改为:
banaction = firewallcmd-ipset
改动后执行:
sudo fail2ban-client -t
sudo systemctl restart fail2ban
sudo fail2ban-client status sshd
不要在同一个 jail 中混用多个封禁动作,也不要为了绕过报错而清空现有防火墙规则。
4. 测试地址没有被封禁
按以下顺序检查:
- 测试地址是否被写入了
ignoreip。 - 测试失败次数是否达到
maxretry。 - 测试是否在
findtime时间窗口内完成。 - 测试连接的端口是否与
port配置一致。 - SSH 是否实际使用了 IPv6,而测试只观察了 IPv4。
- Fail2ban 是否读取到了正确的 SSH 日志。
- nftables、UFW 或 firewalld 是否与
banaction匹配。
查看生效配置时,可以使用:
sudo fail2ban-client -d | grep -E 'sshd|banaction|ignoreip|findtime|maxretry|bantime'
如果服务器位于 NAT 后面,Fail2ban 看到的是公网出口地址。同一出口下的多个管理人员可能共同受到封禁影响,应据此调整白名单和阈值。
5. 管理员被误封,无法通过 SSH 登录
先不要反复重试。反复失败会延长封禁或触发其他安全策略。
通过服务商网页控制台、串口控制台或带外管理进入服务器,查看封禁状态:
sudo fail2ban-client status sshd
解除指定地址:
sudo fail2ban-client set sshd unbanip ADMIN_PUBLIC_IP
确认管理地址已经写入 ignoreip 后,再检查配置:
sudo grep '^ignoreip' /etc/fail2ban/jail.d/sshd.local
sudo fail2ban-client -t
sudo systemctl restart fail2ban
如果完全没有控制台入口,只能等待 bantime 到期,或联系服务器服务商处理。因此首次部署和首次测试都不应使用唯一的生产管理地址。
七、验收与回滚检查项
1. 部署验收
以下项目全部满足时,可以认为 SSH 封禁规则已经完成首次部署:
sudo fail2ban-client -t返回配置测试成功。fail2ban服务状态为active (running)。sudo fail2ban-client status能看到sshdjail。sudo fail2ban-client status sshd能显示过滤器和动作状态。- 从未加入白名单的测试地址发起有限次失败登录后,该地址出现在
Banned IP list。 nft list ruleset能看到 Fail2ban 创建的封禁对象或测试地址。- 使用
unbanip后,测试地址能够从当前封禁列表中移除。 - 实际管理端 IPv4 或 IPv6 地址已正确加入
ignoreip。 - SSH 实际端口与 jail 的
port参数一致。
2. 只撤销本次配置
如果需要回滚本次新增的 SSH jail,先删除本次创建的单个文件,再测试并重启服务:
sudo rm -f /etc/fail2ban/jail.d/sshd.local
sudo fail2ban-client -t
sudo systemctl restart fail2ban
rm 只针对本次创建的 sshd.local,不要删除整个 /etc/fail2ban 目录。回滚后检查:
sudo fail2ban-client status
sudo systemctl status fail2ban --no-pager
sudo nft list ruleset | grep -E 'f2b|sshd'
如果只是临时停用 Fail2ban,而不是删除配置,可以执行:
sudo systemctl disable --now fail2ban
停止前应确认业务防火墙仍有 SSH 放行和基础访问控制。不要使用 nft flush ruleset 作为清理手段,以免把服务器上与 Fail2ban 无关的防火墙规则一并删除。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7950.html


