快速上手

注意

强烈建议您在测试环境测试充分在上生产，如遇到问题请及时反馈

1.选择并下载版本

发布渠道	当前版本	适用场景	下载
正式版	v1.3.24	希望使用正式发布版本的用户	GitHub 下载 · Gitee 下载
测试版（Beta）	v1.3.25-beta.8	希望提前体验最新功能与修正，并参与验证的用户	GitHub 下载 · Gitee 下载

请按需要自行选择正式版或测试版，并下载对应操作系统与架构的安装包。测试版的更新内容与升级注意事项见版本发布。已有部署升级前请备份配置与数据，并先在测试环境验证。

全部版本：Gitee · GitHub。

安装指定测试版

如需使用上表中的测试版，请从对应版本的下载页获取安装包，解压后按下方平台说明启动。下方 Linux 一键安装脚本会自行选择版本，不能用于指定安装上表中的测试标签。

2.快速启动

Linux

• Linux 一键自动下载并安装脚本

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

• Linux 一键卸载脚本

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

Windows

• 直接启动

SamWaf64.exe

• 服务形式(安装服务需以管理员身份运行cmd)

//安装并启动
SamWaf64.exe install && SamWaf64.exe start

//停止并卸载
SamWaf64.exe stop && SamWaf64.exe uninstall

PS: 注意从v1.3.7-beta.1 开始如果是windows server 2008r2 的系统请下载 SamWaf64ForWin7Win8Win2008.exe 使用。

Linux Arm64

Linux Arm64架构请下载对应的文件 SamWaf_Linux_arm64.v*.tar.gz

./SamWafLinuxArm64 install && ./SamWafLinuxArm64 start

Docker

镜像见 Docker Hub。下方命令使用正式版通道 samwaf/samwaf（即 :latest）；如需指定上表中的测试版，将镜像名替换为 samwaf/samwaf:v1.3.25-beta.8。后续升级时，docker pull 与 docker run（或 Compose 配置）应使用同一个标签。

常规启动（端口映射模式）

docker run -d --name=samwaf-instance \
           --restart always \
           -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

四个挂载目录请换成宿主机上的真实路径，作用如下：

目录	说明
/app/conf	配置文件 config.yml 所在目录。
/app/data	数据库与数据文件（含首次安装生成的 initial_password.txt）。
/app/logs	运行日志。
/app/ssl	SSL 证书文件。

需要使用「防火墙IP封禁」时

防火墙IP封禁 会调用宿主机的 iptables，容器需要额外的权限和网络配置，否则页面上该功能会被禁用并提示环境不支持：

docker run -d --name=samwaf-instance \
           --restart always \
           --cap-add=NET_ADMIN \
           --network host \
           -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

• --cap-add=NET_ADMIN：授予容器操作 iptables 的权限（官方镜像已内置 iptables，无需自行安装）。
• --network host：与宿主机共享网络。不加这个参数，封禁规则只写入容器自身的网络命名空间，对真实流量不生效。

注意

使用 --network host 后不能再写 -p 端口映射，容器直接使用宿主机的 26666 / 80 / 443 端口。

如果不需要防火墙IP封禁，用上面的常规启动即可，其余功能（含应用层 IP黑名单）都不受影响。

升级方式

容器环境请更新镜像，不要用管理界面上的"应用内升级"（界面里已禁用并给出指引）：容器内的程序文件在镜像可写层，界面升级只对当前容器有效，容器一旦重建就会回退成镜像自带的旧版本，而数据库已被新版本迁移且无法回退。

# docker compose 部署
docker compose pull && docker compose up -d

# docker run 部署
docker pull samwaf/samwaf
docker rm -f samwaf-instance && <重新执行上面的 docker run 命令>

挂载出来的 conf / data / logs / ssl 不受影响。详见常见问题 - 容器（Docker）环境如何升级。

:::

3.启动访问

http://127.0.0.1:26666

默认帐号：admin 默认密码：admin868 (注意首次进入请把默认密码改掉)

关于初始密码

自v1.3.21-beta.8版本在全新安装时不再使用固定默认密码，而是生成随机初始密码并写入程序目录下的 data/initial_password.txt（启动日志也会提示）。若用 admin868 无法登录，请打开该文件获取初始密码。无论哪种方式，首次登录后请立即修改密码。

SamWaf主画面