maltyxx/fail2ban

maltyxx/docker-fail2ban

关于

🐳 基于Alpine Linux的Fail2ban Docker镜像。
如果您感兴趣，https://hub.docker.com/r/maltyxx/%E6%88%91%E7%9A%84%E5%85%B6%E4%BB%96%F0%9F%90%B3 Docker镜像！

Docker

环境变量

• TZ：容器的时区设置（默认值 UTC）
• F2B_LOG_LEVEL：日志输出级别（默认值 INFO）
• F2B_DB_PURGE_AGE：封禁记录从数据库中清除的时间（默认值 1d）
• F2B_IGNORE_SELF：忽略本地IP地址（默认值 true）
• F2B_IGNORE_IP：需忽略的IP地址、CIDR掩码或DNS主机列表（默认值 127.0.0.1/8 ::1）
• F2B_BAN_TIME：主机被封禁的秒数（默认值 10m）
• F2B_FIND_TIME：搜索异常行为的时间范围（默认值 10m）
• F2B_MAX_RETRY：主机被封禁前的失败次数（默认值 5）
• F2B_DEST_EMAIL：配置文件中用于插值的目标***地址（默认值 root@localhost）
• F2B_SENDER：部分操作使用的发件***地址（默认值 root@$(hostname -f)）
• F2B_ACTION：封禁时的默认操作（默认值 %(action_)s）
• F2B_IPTABLES_CHAIN：Fail2Ban规则添加到的iptables链（默认值 INPUT）
• SSMTP_HOST：SMTP服务器主机
• SSMTP_PORT：SMTP服务器端口（默认值 25）
• SSMTP_HOSTNAME：完整主机名（默认值 $(hostname -f)）
• SSMTP_USER：SMTP用户名
• SSMTP_PASSWORD：SMTP密码
• SSMTP_TLS：是否启用SSL/TLS（默认值 NO）

:warning: 如果您希望在封禁后发送邮件，需配置SSMTP环境变量并将F2B_ACTION设置为%(action_mw)s或%(action_mwl)s

卷

• config：包含自定义jail、操作和过滤器
• data：包含Fail2ban持久化数据库

使用该镜像

命令行

您可以使用以下最小化命令：

bash
docker run -d --name fail2ban --restart always \
  --network host \
  --cap-add NET_ADMIN \
  --cap-add NET_RAW \
  -v config:/etc/fail2ban \
  -v data:/var/lib/fail2ban \
  -v /var/log:/var/log:ro \
  maltyxx/fail2ban:latest

命令行（启用IPv6）

通过内核模块加载：

bash
docker run -d --name fail2ban --restart always \
  --network host \
  --cap-add NET_ADMIN \
  --cap-add NET_RAW \
  --cap-add SYS_MODULE \
  -v config:/etc/fail2ban \
  -v data:/var/lib/fail2ban \
  -v /lib/modules:/lib/modules:ro \
  -v /var/log:/var/log:ro \
  maltyxx/fail2ban:latest

注意事项

DOCKER-USER链

在Docker 17.06及更高版本中（通过https://github.com/docker/libnetwork/pull/1675%EF%BC%89%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%90%91%E5%90%8D%E4%B8%BA%60DOCKER-USER%60%E7%9A%84%E6%96%B0%E8%A1%A8%E6%B7%BB%E5%8A%A0%E8%A7%84%E5%88%99%EF%BC%8C%E8%BF%99%E4%BA%9B%E8%A7%84%E5%88%99%E5%B0%86%E5%9C%A8Docker%E8%87%AA%E5%8A%A8%E5%88%9B%E5%BB%BA%E7%9A%84%E4%BB%BB%E4%BD%95%E8%A7%84%E5%88%99%E4%B9%8B%E5%89%8D%E5%8A%A0%E8%BD%BD%E3%80%82%E8%BF%99%E5%AF%B9%E4%BA%8E%E4%BD%BFFail2Ban%E5%88%9B%E5%BB%BA%E7%9A%84iptables%E8%A7%84%E5%88%99%E6%8C%81%E4%B9%85%E5%8C%96%E9%9D%9E%E5%B8%B8%E6%9C%89%E7%94%A8%E3%80%82

如果您使用的是旧版本的Docker，可以将F2B_IPTABLES_CHAIN改为FORWARD。这样，所有Fail2Ban规则都会在Docker规则之前，但这些规则将应用于所有转发流量。

更多信息：[***]

DOCKER-USER和INPUT链

如果您的Fail2Ban容器附加到DOCKER-USER链而不是INPUT链，规则将仅适用于容器。这意味着进入INPUT链的任何数据包都将绕过这些位于FORWARD链下的规则。

这意味着例如https://github.com/fail2ban/fail2ban/blob/0.10/config/jail.conf jail将无法按预期工作。您可以创建另一个Fail2Ban容器。

使用fail2ban-client

Fail2ban命令可以通过容器使用。例如，如果您想手动封禁一个IP：

bash
docker exec -t <容器名称> fail2ban-client set <JAIL名称> banip <IP地址>

自定义操作、过滤器和jails

自定义操作、过滤器和jails可以添加到/etc/fail2ban/action.d、/etc/fail2ban/filter.d和/etc/fail2ban/jail.d目录中。

:warning: 容器需要重启才能使更改生效