# 安装`fail2ban`

AlmaLinux (RHEL系) 的默认仓库中没有 **fail2ban** 包，它需要通过 **EPEL (Extra Packages for Enterprise Linux)** 这个第三方仓库来安装。





## 1. 启用 EPEL 仓库

```bash
sudo dnf install epel-release -y
```

系统会提示确认导入EPEL的GPG密钥，输入 y 即可。

## 2. 安装 Fail2Ban

```bash
sudo dnf install fail2ban -y
```

# 配置与启动`fail2ban`
## 1. 复制并编辑配置文件

> Fail2ban 的配置遵循“覆盖”原则，所以绝对不要修改主配置文件 jail.conf，而应在 jail.local 中进行所有自定义。

```bash
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
sudo vim /etc/fail2ban/jail.local
```

## 2. 按需修改配置

```txt
[DEFAULT]
# --- 全局默认设置 ---
# 这些设置将应用于所有未明确覆盖它们的 "Jail" (监狱)。

# 忽略的 IP 地址，这些 IP 永远不会被封禁。
# 127.0.0.1/8 是本机回环地址，::1 是 IPv6 的本机回环地址。建议将您自己的固定 IP 也加入此列表。
ignoreip = 127.0.0.1/8 ::1 你的可信ip_1 你的可信ip_2

# 默认封禁时长。单位可以是 s(秒), m(分钟), h(小时), d(天), w(周)。这里是 1 天。
bantime = 1d

# 查找时间窗口。Fail2ban 会在此时间段内统计客户端的失败次数。这里是 10 分钟。
findtime = 10m

# 最大重试次数。在 `findtime` 时间窗口内，如果失败次数达到此值，客户端 IP 将被封禁。这里是 5 次。
# 结合上面的 findtime，意味着“10分钟内失败5次”。
maxretry = 5

# 触发封禁时执行的动作。%(action_)s 是一个变量，通常指向默认的封禁动作（如 iptables-multiport）。
action = %(action_)s

# 对于 Debian 或 Ubuntu 并且你希望它和 UFW 集成 请删除  banaction = ufw 的注释
# banaction = ufw

# =================================================================================
# JAILS (监狱) - 职责明确，策略清晰
# 每个 [section] 都是一个独立的 "监狱"，用于监控一种特定的服务或攻击行为。
# =================================================================================

# --- 基础安全 (SSH) ---
[sshd]
# 是否启用此监狱。true 为启用，false 为禁用。
enabled  = true
# SSH 服务的端口号。 【重要】请务必修改为您服务器上实际的 SSH 端口！
port     = 22
# 覆盖默认的 maxretry。SSH 是核心服务，策略更严格，3次失败就封禁。
maxretry = 3
# 覆盖默认的 bantime。对于攻击 SSH 的 IP，封禁更长时间，这里是 1 周。
bantime  = 1w

# --- Nginx 核心防护：恶意扫描器 ---
# 监控并阻止常见的目录扫描、漏洞扫描工具。
[nginx-pro-scanner]
enabled  = true
# 监控的端口，http (80) 和 https (443)。
port     = http,https
# 使用的过滤器规则文件名 (位于 /etc/fail2ban/filter.d/nginx-pro-scanner.conf)。【注意】此为自定义过滤器。
filter   = nginx-pro-scanner
# 监控的 Nginx 日志文件路径。【重要】此路径通常用于宝塔面板，请根据您的实际情况修改。
logpath  = /www/wwwlogs/*.log

# --- Nginx 核心防护：恶意机器人与脚本 ---
# 监控并阻止已知的恶意 User-Agent 或爬虫。
[nginx-badbots]
enabled  = true
port     = http,https
# 使用的过滤器规则文件名 (位于 /etc/fail2ban/filter.d/nginx-badbots.conf)。【注意】此为自定义过滤器。
filter   = nginx-badbots
logpath  = /www/wwwlogs/*.log
# 策略非常严格，只要匹配到 1 次就封禁。
maxretry = 1
# 时间窗口缩短到 1 分钟，反应更迅速。
findtime = 1m
# 封禁 1 周。
bantime  = 1w

# --- Nginx 核心防护：SQL注入 & XSS 攻击尝试 ---
# 监控 URL 或请求体中包含的典型 SQLi 和 XSS 攻击代码。
[nginx-sqli-xss]
enabled  = true
port     = http,https
# 使用的过滤器规则文件名 (位于 /etc/fail2ban/filter.d/nginx-sqli-xss.conf)。【注意】此为自定义过滤器。
filter   = nginx-sqli-xss
logpath  = /www/wwwlogs/*.log
# 策略严格，5 分钟内尝试 2 次就封禁。
maxretry = 2
findtime = 5m
# 封禁 1 周。
bantime  = 1w

# --- Nginx 辅助防护：畸形请求 (4xx 错误) ---
# 监控产生大量 4xx 客户端错误（如 404 Not Found, 403 Forbidden）的 IP。
[nginx-4xx-errors]
enabled  = true
port     = http,https
# 使用的过滤器规则文件名 (位于 /etc/fail2ban/filter.d/nginx-4xx-errors.conf)。【注意】此为自定义过滤器。
filter   = nginx-4xx-errors
logpath  = /www/wwwlogs/*.log
# 策略相对宽松，允许一定程度的错误，防止误封正常用户。5 分钟内 15 次 4xx 错误才封禁。
maxretry = 15
findtime = 5m
# 封禁时间较短，6 小时，因为误封的可能性相对较高。
bantime  = 6h

# --- Nginx 辅助防护：HTTP Basic Auth 爆破 ---
# 监控 Nginx 的 HTTP 基本认证失败日志。
[nginx-http-auth]
enabled  = true
# 【最终修正】为保证服务稳定启动，只监控最核心且确定存在的 nginx_error.log。
# HTTP 认证失败通常记录在错误日志中，而不是访问日志。
logpath  = /www/wwwlogs/nginx_error.log
# 3 次认证失败就封禁。
maxretry = 3
# 封禁 1 周。
bantime  = 1w

# --- 累犯加重处罚规则 (Recidive) ---
# 这是一个特殊的“元监狱”，它不监控服务日志，而是监控 Fail2ban 自己的日志。
# 用来惩罚那些在短时间内被多次封禁的“惯犯” IP。
[recidive]
enabled  = true
# 监控 Fail2ban 自己的日志文件。路径在各系统上可能不同，但 /var/log/fail2ban.log 是最常见的。
logpath  = /var/log/fail2ban.log
# 执行更严厉的封禁动作，通常是封禁所有端口 (allports)，而不仅仅是触发的那个端口。
action   = %(banaction_allports)s
# 时间窗口为 1 天。
findtime = 1d
# 如果一个 IP 在 1 天内被其他任何监狱封禁了 3 次...
maxretry = 3
# ...那么它将被这个监狱处以更长的封禁时间：2 周，并且是所有端口。
bantime  = 2w
```

## 3.  创建 Nginx 过滤器
### 创建一个新文件`/etc/fail2ban/filter.d/nginx-pro-scanner.conf`，并复制粘贴下列内容：

```txt
[Definition]
# 匹配各种恶意扫描行为，状态码可以是 3xx, 4xx
failregex = ^<HOST> .* "(GET|POST) .*/\.(git|env|svn|htpasswd|sql|bak|conf|ini|rar|zip|tgz|gz|bz2)[^"]*" (30|40)\d .*
            ^<HOST> .* "(GET|POST) .*/(phpmyadmin|pma|admin|db|mysql|websql|backup|dump)[^"]*" (30|40)\d .*
            ^<HOST> .* "(GET|POST) .*/(wp-admin|wp-login|wp-content|wp-includes|wordpress|wp)[^"]*" (30|40)\d .*
            ^<HOST> .* "(GET|POST) /xmlrpc\.php" (30|40)\d .*
            ^<HOST> .* "(GET|POST) /vendor/phpunit/phpunit/src/Util/PHP/eval-stdin\.php" (30|40)\d .*
            ^<HOST> .* "GET .*\?phpinfo=.*" .*
            ^<HOST> .* "GET .*/(console|invokefunction|api/jsonws/invoke)" .*

ignoreregex =
```

###  创建一个新文件`/etc/fail2ban/filter.d/nginx-badbots.conf`，并复制粘贴下列内容：

```text
[Definition]
# User-Agent 黑名单，不区分大小写 (?i)
# 包含常见扫描工具、脚本语言、某些过于激进的爬虫
failregex = (?i)^<HOST> .* ".*(Go-http-client|AhrefsBot|SemrushBot|MegaIndex|BLEXBot|DotBot|Nmap|masscan|zgrab|sqlmap|nikto|python-requests|curl|wget|scan|spider|bot|crawler).*"$
            ^<HOST> .* "-" "-"$

# 忽略主流搜索引擎爬虫，防止误伤
ignoreregex = (?i).*(googlebot|bingbot|baidu|slurp|duckduckbot|applebot|yandex|facebookexternalhit)
```

### 创建一个新文件`/etc/fail2ban/filter.d/nginx-sqli-xss.conf`，并复制粘贴下列内容：

```txt
[Definition]
# 解码后的URL中包含SQL注入或XSS攻击的典型关键字
# (?i) 不区分大小写，\s 代表空格
failregex = (?i)^<HOST> .* ".*(union\s*select|select.*from|insert\s*into|<\s*script>|%%3Cscript%%3E|<\s*img|onmouseover|javascript:).*" .*

ignoreregex =
```

### 创建一个新文件`/etc/fail2ban/filter.d/nginx-4xx-errors.conf`，并复制粘贴下列内容：

```txt
[Definition]
# 捕获返回 4xx 客户端错误的请求，例如 400, 403, 404, 405 等
failregex = ^<HOST> -.*- .* 4\d\d .*

# 忽略对 favicon.ico 和 robots.txt 的 404 请求，这些很常见
ignoreregex = .*(GET|HEAD) /(favicon.ico|robots.txt) .*
```

## 4. 启动与验证
> 配置完成后，必须重启服务才能让新配置生效。

```bash
# 启动并设置开机自启
sudo systemctl enable --now fail2ban
# 重启服务以加载 jail.local 中的新配置
sudo systemctl restart fail2ban
# 查看 Fail2ban 整体状态，验证规则是否加载成功
sudo fail2ban-client status

# 停止服务
sudo systemctl stop fail2ban
```
> **成功标志**：在输出的 Jail list 中，能看到您在 jail.local 里启用了 enabled = true 的所有规则名称，例如 sshd, nginx-bad-requests 等。
> 
> **常见问题**：如果发现某个自定义的 Jail (如 nginx-bad-requests) 没有出现在列表中，通常是因为缺少 filter 定义。请返回 jail.local 文件，在该 Jail 段落中添加一行 filter = nginx-botsearch。

# 管理和维护
## 查看封禁状态
### 查看特定规则的封禁IP（最常用）

```bash
# 查看 SSH 服务的封禁列表
sudo fail2ban-client status sshd

# 查看核心漏洞扫描（最常用）
sudo fail2ban-client status nginx-pro-scanner

# 查看恶意机器人封禁列表
sudo fail2ban-client status nginx-badbots

# 查看 SQL 注入 / XSS 攻击尝试
sudo fail2ban-client status nginx-sqli-xss

# 查看“骚扰型”扫描
sudo fail2ban-client status nginx-4xx-errors
```
> **注**：在输出结果中查找 Banned IP list，后面就是被封禁的IP地址。

### 查看所有规则的封禁IP（概览）

```bash
# 使用一行命令遍历并显示所有已启用规则的状态
sudo fail2ban-client status | grep "Jail list:" | sed -e 's/.*Jail list:[ \t]*//' -e 's/,//g' | xargs -n1 sudo fail2ban-client status
```

## 手动解封 IP

```bash
# 命令格式: sudo fail2ban-client set <规则名> unbanip <要解封的IP>

# 示例：解封被 sshd 规则封禁的IP 123.123.123.123
sudo fail2ban-client set sshd unbanip 123.123.123.123
```

## 紧急情况处理：自己被锁

1. **通过服务商后台登录**：使用云服务商提供的 VNC 控制台 或 网页版紧急终端 登录服务器。这是您的“救命稻草”，可以绕过网络防火墙。
2. **执行解封命令**：在VNC控制台中，执行 4.2 中的解封命令。
3. **终极手段**：如果解封命令不奏效，可以临时停止Fail2ban服务。服务停止时，它会自动移除所有防火墙封禁规则。

```bash
# 临时停止服务，所有封禁会立即解除
sudo systemctl stop fail2ban

# 启动服务
sudo systemctl start fail2ban
```

AlmaLinux安装配置fail2ban

# 已安装插件列表导出
## 使用命令行导出

```bash
# 列出所有已安装的扩展插件
code --list-extensions

# 将上列命令输出的信息重定向到文本文件中保存
code --list-extensions > list-extensions.txt
```
> 这将再当前的工作目录下创建名为list-extensions.txt的文本文件，里面包含所有已安装的扩展插件的ID列表







# 配置信息文件导出
# 导出
1. 打开用户配置目录：
- Windows：按 Win+R 输入 %APPDATA%\Code\User
- macOS/Linux：终端输入 open ~/.config/Code/User/
2. 备份整个 User 文件夹（或至少备份以下文件）：
- settings.json（设置）
- keybindings.json（快捷键）
- snippets/（代码片段目录）
- state.vscdb（UI 状态，可选）
- profiles.json（多配置文件，可选）

# 导入
1. 将备份的配置文件复制到新机器的用户目录（路径同上）
2. 覆盖现有文件（建议先备份原始文件）
3. 重启 VS Code 生效

VS Code 已安装插件列表及配置信息文件导出指南

# 使用 Java + Maven 构建方式创建父模块

> 创建方式：File -> New -> Project -> Java -> 构建工具选择 Maven

该方式允许创建更“干净”的 Maven 项目，可选是否使用 Archetype 模板，创建完成后删除 `src` 目录。





## 特点

- 可跳过模板选择（自由构建项目）
- 默认生成 src 目录，但不生成类文件
- 可手动定制 POM 配置

## 优点

- 更贴合实际开发习惯
- 项目结构更灵活、轻量
- 避免模板带来的冗余内容

## 缺点

- 创建父模块仍需手动删除 src


# 开始

1. 创建父模块

![image.png](/static/img/5917dc7fea5ce1cd9ab48e6c05c9942e.image.webp)

2. 删掉无需的文件（项目的`pom`文件只是作为依赖管理使用）

![image.png](/static/img/0f64152c7fbbb9afb92b5a513698271c.image.webp)

3. `pom` 添加一些标签


![image.png](/static/img/22df2ac36b156c8907b8a2ac7c32e0d9.image.webp)

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>cn.reminis</groupId>
    <artifactId>AtlasAdmin</artifactId>
    <version>1.0.0</version>

    <packaging>pom</packaging>

    
    <name>AtlasAdmin</name>
    <url>https://reminis.cn</url>
    <description>Springboot多模块系统</description>

    <properties>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencyManagement>

    </dependencyManagement>

</project>
```

**标签解释：**

**packaging:** 默认情况下，Maven 项目会打包成 .jar 或 .war 文件，
`packaging = pom` 的作用是：
> 告诉 Maven：这是一个 聚合/父项目（Parent/Aggregator），本身不打包可执行代码，而是 用于管理子模块 和 统一依赖配置

**dependencyManagement**: 
> 在父 pom 中 统一指定依赖版本号，子模块使用时只需写 groupId + artifactId，不需要再写版本。

示例：
```xml
父模块
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>3.2.0</version>
        </dependency>
    </dependencies>
</dependencyManagement>
```

```xml
子模块
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    
</dependency>

```

# 创建子模块
1. 在父模块上右键新建模块

![image.png](/static/img/1af1fc51b21dd3be66cfc0720dcd1ff2.image.webp)

2. 创建 `common` 模块

![image.png](/static/img/437316e4a2799cf4f552a5c48bbee597.image.webp)

> common 为公共模块，存放通用的工具类、常量、基础实体、异常处理等，供其他模块依赖使用。

![image.png](/static/img/4c857242a45c08d340cf5d925839c92c.image.webp)

IntelliJ IDEA 构建 Spring Boot 多模块 Maven 项目

# 一、下载并安装Maven
## 1.下载
> 下载地址：https://maven.apache.org/download.cgi ，浏览器打开链接下载最新的3.9.11版本



![image.png](/static/img/dda32bb0e88b2d0a0fce4b3e2a7450af.image.webp)

## 2.安装
解压 `apache-maven-3.9.11-bin.zip` 到**没有中文和特殊字符**的路径下既为安装完成
解压缩后的目录结构如下：

![image.png](/static/img/c4b28a5ce5c0f232f156cfd691ae2b3a.image.webp)

- **bin目录：** 存放的是可执行命令， mvn 命令重点关注。
- **conf目录：** 存放Maven的配置文件， settings.xml 配置文件后期需要修改。
- **lib目录：** 存放Maven依赖的jar包， Maven也是使用java开发的，所以它也依赖其他的jar包。

# 配置Maven
## 配置环境变量
1. 此电脑 右键 -> 属性 -> 高级系统设置 -> 高级 -> 环境变量

![image.png](/static/img/dabe13d88379e328b191d98d544d730b.image.webp)

![image.png](/static/img/147ac040cb1750f6e040b10950d61d25.image.webp)

2. 在系统变量新建一个变量名为 `MAVEN_HOME` ，变量值为Maven安装目录的系统变量

![image.png](/static/img/8337d311af989d3263e5e8eb34f15cbc.image.webp)

3. 在 `Path` 中点击新建，添加 `%MAVEN_HOME%\bin` 后点击三次确定按钮

![image.png](/static/img/f0210bc4595e9ee13df66a6bc90729ad.image.webp)

4. 打开命令提示符,输入 `mvn -version` ，进行验证，出现如图所示表示安装成功

![image.png](/static/img/2c560cdeb1a680252fc7fb814e0ced2f.image.webp)

## 配置本地仓库
1. 打开 `conf/settings.xml` 文件，修改文件中的 `localRepository` 标签，指定一个目录为本地仓库，用来存储拉取的jar包

![image.png](/static/img/27effc6f716c4ca0f684a80a80636f9d.image.webp)

2. 配置国内镜像
国内下载jar包可能下载不下来或者速度比较慢，可以配置阿里镜像。

    打开 `conf/settings.xml` 文件，在 `mirrors` 标签中添加如下子标签：
    ```xml
     <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    ```
    
# 二、IDEA配置Maven环境
IDEA中打开 File -> Settings -> Maven
> `Maven home path` 设置为本地安装的Maven，并修改 `User setting file` 配置文件路径为本地安装的Maven的 `conf/settings.xml` 文件

> 在 `User setting file` 后的 `Override` 处打勾， `Local repository` 会自动配置为 `conf/settings.xml` 中指定的本地仓库路径，如果不是可以手动配置为本地仓库路径并在之后的 `Override` 处打勾

![image.png](/static/img/a6703dac9acd0dc4eb5ce3793223e7ca.image.webp)

在windows11下安装配置Maven以及IDEA配置Maven环境

```bash
flutter pub cache clean
```

安装fail2ban

已安装插件列表导出

使用命令行导出

使用 Java + Maven 构建方式创建父模块

一、下载并安装Maven

1.下载

安装`fail2ban`