SamWaf 安装与配置指南

一、项目基础介绍

SamWaf 是一款轻量级、开源的 Web 应用防火墙（WAF），专为小型企业、工作室和个人网站设计。它支持完全私有化部署，能够加密本地存储的数据，易于启动，并支持 Linux、Windows 64位和 Arm64 系统。

主要编程语言：Go

二、项目使用的关键技术和框架

• Go 语言：SamWaf 使用 Go 语言进行开发，Go 语言以其高性能、简洁的语法和并发处理能力而闻名。
• 独立引擎：SamWaf 的保护功能不依赖于 IIS、Nginx 等第三方服务，拥有完全独立的引擎。
• 自定义规则：支持通过脚本和 GUI 编辑自定义保护规则。
• 加密日志存储：日志存储采用加密方式，保障数据安全。
• OWASP CRS：支持 OWASP CRS（Cross-Site Request Forgery）防护。

三、项目安装和配置的准备工作和详细步骤

准备工作

1. 操作系统：确保你的操作系统是 Linux、Windows 64位或 Arm64 版本。
2. Go 环境：安装 Go 语言环境，可以从 Go 官方网站 下载安装包。
3. Git：安装 Git，用于克隆和更新项目代码。
4. 编译工具：确保安装了必要的编译工具，例如在 Linux 上可能需要安装 gcc 和 make。

安装步骤

1. 克隆项目

打开终端或命令提示符，运行以下命令克隆 SamWaf 项目：

git clone https://github.com/samwafgo/SamWaf.git

2. 编译项目

进入项目目录，编译 SamWaf：

cd SamWaf
go build -o SamWaf main.go

编译完成后，会在当前目录生成一个名为 SamWaf 的可执行文件。

3. 运行 SamWaf

• 在 Windows 上，可以直接运行生成的 SamWaf.exe 文件。

.\SamWaf.exe

• 在 Linux 上，运行生成的 SamWaf 文件：

./SamWaf

4. 配置 SamWaf

SamWaf 的配置文件通常位于项目根目录下的 conf 文件夹中。根据实际需求，编辑配置文件，如 config.json，以调整防火墙的设置。

5. 作为服务安装（可选）

在 Windows 上，可以使用以下命令将 SamWaf 安装为服务：

.\SamWaf.exe inst

安装完成后，可以使用服务管理器或命令行来管理 SamWaf 服务。

注意事项

• 在生产环境中部署前，请在测试环境中进行彻底测试。
• 如遇到问题，及时查阅项目文档或向项目维护者反馈。

以上就是 SamWaf 的安装与配置指南，希望能帮助您顺利部署和使用 SamWaf。