<h1>Fail2ban管理工具 – 宝塔面板专用超级管理脚本</h1>
<p>版本：5.0 | 更新时间：2025-03-30</p>
<h2>一、开发背景与解决的问题</h2>
<p>Fail2ban 是一款强大的入侵防御系统，能够自动监控系统日志并封禁恶意 IP。然而，原生 Fail2ban 在使用过程中存在以下痛点：</p>
<ul>
<li><strong>配置复杂</strong>：需要手动编辑配置文件，对新手不友好</li>
<li> <strong>操作繁琐</strong>：每次封禁/解封都需要输入命令，效率低下</li>
<li> <strong>无法可视化</strong>：没有直观的界面查看封禁状态和统计信息</li>
<li> <strong>功能分散</strong>：封禁、解封、查询等功能需要记忆多个命令</li>
<li> <strong>缺乏日志管理</strong>：日志查看和分析需要手动 grep</li>
</ul>
<p>本工具的开发正是为了解决这些问题，让宝塔面板用户能够更轻松地管理 Fail2ban，无需记忆复杂的命令，通过简单的交互式菜单即可完成所有操作。</p>
<h2>二、与原生 Fail2ban 的核心差异</h2>
<h3>1. 可视化界面</h3>
<p>原生 Fail2ban：纯命令行操作，需要记忆各种命令参数</p>
<p>本工具：提供美观的可视化界面，采用 Unicode 图标和边框装饰，操作直观明了</p>
<h3>2. 交互式菜单</h3>
<p>原生 Fail2ban：</p>
<pre><code>fail2ban-client set sshd banip 192.168.1.100</code></pre>
<p>本工具：</p>
<ul>
<li>进入菜单 → 选择”封禁IP” → 输入 IP → 选择 Jail → 设置封禁时间 → 确认</li>
<li>全程图形化引导，无需记忆命令</li>
</ul>
<h3>3. 统计信息展示</h3>
<p>原生 Fail2ban：需要手动执行多个命令统计封禁数量</p>
<p>本工具：主界面直接显示：</p>
<ul>
<li>服务运行状态</li>
<li>当前封禁 IP 总数</li>
<li>今日封禁次数</li>
<li>今日封禁 IP 数</li>
<li>活跃 Jail 数量</li>
<li>防火墙状态</li>
</ul>
<h3>4. 批量操作功能</h3>
<p>原生 Fail2ban：需要编写脚本才能实现批量操作</p>
<p>本工具内置批量功能：</p>
<ul>
<li>批量查看所有封禁 IP（按 Jail 分类）</li>
<li>批量解封所有 IP</li>
<li>导出 IP 列表</li>
<li>IP 段统计分析</li>
</ul>
<h3>5. 灵活的封禁时间</h3>
<p>原生 Fail2ban：需要修改配置文件或使用默认时间</p>
<p>本工具提供便捷的时间选择：</p>
<ul>
<li>短期封禁（48小时）</li>
<li>中期封禁（144小时）</li>
<li>长期封禁（30天）</li>
<li>永久封禁（需手动解封）</li>
</ul>
<h2>三、核心功能特色</h2>
<h3>1. 系统状态监控面板</h3>
<p>主界面实时显示：</p>
<ul>
<li><i class=”fas fa-shield-alt”></i> 服务状态监控</li>
<li><i class=”fas fa-ban”></i> 封禁 IP 统计</li>
<li><i class=”fas fa-fire”></i> 今日封禁趋势</li>
<li><i class=”fas fa-clock”></i> 实时时间显示</li>
</ul>
<h3>2. 服务管理</h3>
<ul>
<li>启动/停止/重启 Fail2ban 服务</li>
<li>配置重载</li>
<li>服务状态实时查看</li>
</ul>
<h3>3. IP 封禁管理</h3>
<ul>
<li>手动封禁单个 IP</li>
<li>支持选择 Jail（sshd、nginx-http、nginx-ssl 等）</li>
<li>灵活设置封禁时间</li>
<li>查看所有封禁 IP（按 Jail 分类）</li>
<li>IP 段统计分析</li>
</ul>
<h3>4. IP 解封管理</h3>
<ul>
<li>解封单个 IP</li>
<li>从所有 Jail 解封</li>
<li>清空所有封禁</li>
<li>操作日志记录</li>
</ul>
<h3>5. IP 状态查询</h3>
<ul>
<li>查询单个 IP 是否被封禁</li>
<li>显示封禁的 Jail 名称</li>
<li>查看 IP 的日志活动记录</li>
<li>统计封禁/解封次数</li>
</ul>
<h3>6. 日志查看功能</h3>
<ul>
<li>查看最近 100 行日志</li>
<li>查看今日日志</li>
<li>搜索特定 IP 的日志记录</li>
<li>统计封禁/解封次数</li>
</ul>
<h2>四、使用场景</h2>
<h3>场景 1：应对突发攻击</h3>
<p>当服务器遭受攻击时，管理员可以：</p>
<ol>
<li>进入工具主菜单</li>
<li>选择”封禁 IP”功能</li>
<li>输入攻击者的 IP 地址</li>
<li>选择相应的 Jail（如 nginx-http）</li>
<li>设置封禁时间（建议长期或永久）</li>
<li>确认封禁</li>
</ol>
<p>整个过程只需 1-2 分钟，无需查看文档或记忆命令。</p>
<h3>场景 2：日常安全维护</h3>
<p>管理员可以定期：</p>
<ol>
<li>查看主界面的统计信息</li>
<li>检查今日封禁次数和 IP 数</li>
<li>查看日志了解攻击趋势</li>
<li>批量解封已过期的封禁 IP</li>
</ol>
<h3>场景 3：多站点管理</h3>
<p>对于运行多个网站的服务器：</p>
<ol>
<li>工具自动识别所有 Jail</li>
<li>按 Jail 分类查看封禁 IP</li>
<li>分析不同服务的攻击模式</li>
<li>针对性地调整封禁策略</li>
</ol>
<h2>五、技术优势</h2>
<h3>1. 宝塔深度集成</h3>
<p>脚本自动识别宝塔路径：</p>
<ul>
<li>客户端路径：/www/server/panel/pyenv/bin/fail2ban-client</li>
<li>配置目录：/www/server/panel/plugin/fail2ban</li>
</ul>
<h3>2. 智能检测</h3>
<ul>
<li>自动检测服务状态</li>
<li>自动获取 Jail 列表</li>
<li>自动统计封禁数量</li>
<li>自动分析 IP 段分布</li>
</ul>
<h3>3. 操作日志</h3>
<p>所有手动操作都会记录到日志文件：</p>
<ul>
<li>/tmp/fail2ban_manual_ban.log（封禁日志）</li>
<li>/tmp/fail2ban_manual_unban.log（解封日志）</li>
<li>/tmp/fail2ban_clear_all.log（清空日志）</li>
</ul>
<h3>4. 安全保护</h3>
<ul>
<li>危险操作需要二次确认</li>
<li>IP 格式自动验证</li>
<li>服务状态检查</li>
<li>错误提示友好</li>
</ul>
<h2>六、总结</h2>
<p>本工具不是对原生 Fail2ban 的替代，而是增强。它保留了 Fail2ban 的所有核心功能，同时通过以下方式提升了用户体验：</p>
<ul>
<li><strong>简化操作</strong>：从复杂的命令行操作变为简单的菜单选择</li>
<li><strong>可视化</strong>：提供直观的界面和统计信息</li>
<li><strong>高效</strong>：批量操作功能大幅提升管理效率</li>
<li><strong>友好</strong>：新手也能快速上手，无需学习复杂命令</li>
</ul>
<p>对于宝塔面板用户来说，本工具是管理 Fail2ban 的最佳选择，让服务器安全防护变得更加简单和高效。</p>
