samwaf/samwaf Docker 镜像 - 轩辕镜像

SamWaf Docker镜像文档

镜像概述

SamWaf是一款轻量级、开源的Web应用防火墙，旨在为Web应用提供安全防护。项目源码托管于GitHub，支持多种架构部署，适用于需要简单高效安全防护方案的场景。

更新日志

• 2024-11-18：新增arm64架构支持
• 2024-10-15：新增ssl文件夹，使用时需注意挂载该目录

更多更新历史：

• 中文更新日志
• 英文更新日志

核心功能与特性

• 轻量级设计：资源占用低，适合中小规模部署
• 跨平台支持：兼容linux/amd64和linux/arm64架构
• 灵活配置：支持自定义配置文件（通过conf目录挂载）
• 数据持久化：关键数据可通过data目录持久化存储
• 日志记录：完整日志记录功能（通过logs目录挂载）
• SSL支持：需挂载ssl目录以启用HTTPS相关功能

使用场景

• 保护中小型Web应用免受常见***
• 需在不同架构服务器（x86/ARM）上部署的安全防护方案
• 对资源占用敏感，需要轻量级防火墙解决方案的场景

使用方法与配置说明

基本部署命令

Linux amd64架构

bash
docker run -d --name=samwaf-instance \
           -p 26666:26666 \
           --platform linux/amd64 \
           -p 80:80 \
           -p 443:443 \
           -v /path/to/your/conf:/app/conf \
           -v /path/to/your/data:/app/data \
           -v /path/to/your/logs:/app/logs \
           -v /path/to/your/ssl:/app/ssl \
           samwaf/samwaf

Linux arm64架构

将--platform参数替换为linux/arm64即可：

bash
docker run -d --name=samwaf-instance \
           -p 26666:26666 \
           --platform linux/arm64 \
           -p 80:80 \
           -p 443:443 \
           -v /path/to/your/conf:/app/conf \
           -v /path/to/your/data:/app/data \
           -v /path/to/your/logs:/app/logs \
           -v /path/to/your/ssl:/app/ssl \
           samwaf/samwaf

参数说明

• -d：以 detached 模式运行容器（后台运行）
• --name=samwaf-instance：指定容器名称为samwaf-instance
• --platform：指定运行架构，支持linux/amd64或linux/arm64
• -p 26666:26666：将容器26666端口映射到主机26666端口（管理端口）
• -p 80:80：将容器80端口映射到主机80端口（HTTP端口）
• -p 443:443：将容器443端口映射到主机443端口（HTTPS端口）
• -v /path/to/your/conf:/app/conf：挂载主机conf目录到容器内/app/conf（配置文件）
• -v /path/to/your/data:/app/data：挂载主机data目录到容器内/app/data（数据存储）
• -v /path/to/your/logs:/app/logs：挂载主机logs目录到容器内/app/logs（日志文件）
• -v /path/to/your/ssl:/app/ssl：挂载主机ssl目录到容器内/app/ssl（证书文件）
• samwaf/samwaf：指定使用的Docker镜像

注意事项

• 请将命令中的/path/to/your/替换为实际主机目录路径
• ssl目录需包含有效的SSL证书文件，否则HTTPS相关功能可能无法正常工作
• 首次运行前确保挂载的目录已存在，避免权限问题导致启动失败