WindowsFirewallRuleset 项目启动与配置教程

1. 项目目录结构及介绍

WindowsFirewallRuleset 项目目录结构如下：

WindowsFirewallRuleset/
├── .github/                # GitHub 仓库相关文件
├── .gitignore              # Git 忽略文件列表
├── Build-Documentation/    # 文档构建脚本和文件
├── Documentation/          # 项目文档
├── PowerShell/             # PowerShell 脚本和相关文件
├── Rules/                  # 防火墙规则文件
├── Tests/                  # 测试脚本和文件
├── Utils/                  # 实用工具脚本和文件
├── firewalld/              # Linux 防火墙规则集
├── license.txt             # 项目许可证
└── README.md               # 项目说明文件

目录说明：

• .github/: 存放 GitHub 仓库的配置文件，如 Issue 模板、Pull Request 模板等。
• .gitignore: 定义了 Git 忽略的文件和目录列表，防止敏感或不需要的文件被提交到仓库。
• Build-Documentation/: 包含构建项目文档的脚本和文件。
• Documentation/: 存放项目的文档，如安装指南、用户手册等。
• PowerShell/: 包含管理 Windows 防火墙规则的 PowerShell 脚本。
• Rules/: 防火墙规则的定义文件，用于配置和更新 Windows 防火墙规则。
• Tests/: 存放项目的测试脚本和文件，用于验证规则集的有效性。
• Utils/: 实用工具脚本和文件，可能包括用于辅助项目开发和维护的工具。
• firewalld/: 针对Linux系统的防火墙规则集。
• license.txt: 项目使用的许可证文件，明确了项目的使用和分发条款。
• README.md: 项目的主要说明文件，介绍了项目的目的、功能和使用方法。

2. 项目的启动文件介绍

项目的启动主要通过 PowerShell 脚本进行。以下是一些主要的启动文件：

• Install.ps1: 用于安装项目所需的依赖和配置环境。
• Update-Rules.ps1: 用于更新防火墙规则，是项目运行的核心脚本。

运行 Install.ps1 脚本前，请确保您的 PowerShell 执行策略允许运行脚本。可以通过运行 Set-ExecutionPolicy 命令来设置。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后，在 PowerShell 中运行以下命令来安装项目：

.\Install.ps1

安装完成后，可以使用 Update-Rules.ps1 脚本来更新防火墙规则：

.\Update-Rules.ps1

3. 项目的配置文件介绍

项目的配置主要通过 Rules/ 目录下的 .rules 文件进行。以下是几个重要的配置文件：

• Base.rules: 包含基本的防火墙规则，是所有规则的基础。
• Optional.rules: 包含可选的防火墙规则，可以根据用户需求启用或禁用。
• Additional.rules: 包含额外的防火墙规则，通常用于特定场景。

这些 .rules 文件由 Update-Rules.ps1 脚本读取，并应用到 Windows 防火墙中。您可以根据自己的需要修改这些文件中的规则，然后重新运行 Update-Rules.ps1 脚本来应用更改。

请确保在修改规则文件时遵循正确的格式，否则可能会导致规则无法正确应用。