为保障系统稳定性与安全性，强烈建议您先在测试环境中充分验证后再部署至生产环境。
如在使用过程中遇到问题，欢迎及时反馈，我们将持续优化与改进。

一、下载最新版本

请从以下官方镜像地址下载最新发布版本：

• Gitee（国内访问更稳定）
  https://gitee.com/samwaf/SamWaf/releases

• GitHub（国际社区）
  https://github.com/samwafgo/SamWaf/releases

• AtomGit
  https://atomgit.com/SamSafe/SamWaf/releases​

二、快速启动

1. Windows

直接启动（推荐体验）

SamWaf64.exe

以服务形式运行（需以管理员身份运行 CMD）

安装并启动服务

SamWaf64.exe install &&SamWaf64.exe start

停止并卸载服务

SamWaf64.exe stop &&SamWaf64.exe uninstall

2. Linux

一键自动下载并安装

curl -sSO http://update.samwaf.com/latest/install_samwaf.sh && bash install_samwaf.sh install

一键卸载

curl -sSO http://update.samwaf.com/latest/install_samwaf.sh && bash install_samwaf.sh uninstall

3. Docker

docker run -d --name samwaf-instance \
-p 26666:26666 \
-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

更多 Docker 启动参数与说明请参考：
https://hub.docker.com/r/samwaf/samwaf

镜像标签说明

• latest
  ：最新稳定正式版本（推荐生产环境使用）
• beta
  ：最新测试版本（用于体验新特性或验证 Bug 修复）

三、访问与默认账号

启动成功后，请访问：

http://127.0.0.1:26666

默认账号信息：

• 用户名：admin
• 密码：admin868

⚠️ 安全提示：首次登录后请立即修改默认密码。

四、升级指南

注意：升级过程中会短暂中断服务，请选择业务低峰期执行。

1. 自动升级（推荐）

当检测到新版本时，管理页面将自动弹出升级提示框，确认后即可开始升级。
升级完成后页面会自动刷新，无需人工干预。

2. 手动升级

直接启动方式

1. 关闭 SamWaf 应用
2. 下载最新版本程序并替换原文件
3. 手动重新启动

服务方式运行

1. 停止服务

Windows：SamWaf64.exe stop
Linux：./SamWafLinux64 stop

1. 替换最新程序文件

2. 启动服务

Windows：SamWaf64.exe start
Linux：./SamWafLinux64 start

五、说明

SamWaf 是一款持续演进的 Web 安全防护系统，我们非常欢迎：

• Issue / Bug 反馈
• 功能建议与优化意见
• PR 提交与安全规则贡献

共同打造更稳定、更可靠的开源 WAF 项目。

阅读原文：原文链接