外观

常规服务器部署（手动） ​

本文是手动安装步骤。更省事请用 快速开始 里的一键安装命令。若你用宝塔，也可直接看 宝塔部署（手动）。

环境要求 ​

项要求
系统Ubuntu / Debian / CentOS 等常见 Linux；或 macOS + Docker Desktop
Docker已安装，可用 docker compose
内存建议 ≥ 2 GB
端口80、443（网站），9000（面板，可改）

先确认服务器上没有别的软件长期占着 80/443；若有，要么停掉，要么改端口（宝塔场景见对应文档）。

1. 安装 Docker（没有的话） ​

按 Docker 官方安装说明 装好后检查：

bash
docker --version
docker compose version

macOS 请安装并启动 Docker Desktop。

2. 下载代码 ​

bash
git clone https://github.com/Qinver-china/flow-shield-waf.git
cd flow-shield-waf

3. 改环境变量 ​

bash
cp .env.example .env
vi .env

必须改：

变量说明
REDIS_PASSWORD内部服务密码
JWT_SECRET登录相关密钥（≥ 16 位随机串）
WAF_CHALLENGE_SECRET验证相关密钥（≥ 16 位随机串）
WAF_ADMIN_USER / WAF_ADMIN_PASSWORD面板账号密码

可选：

变量默认说明
PANEL_PORT9000面板端口
WAF_HTTP_PORT / WAF_HTTPS_PORT80 / 443网站对外端口
WAF_ORIGIN_HOST_GATEWAYLinux 172.17.0.1；macOS 建议 host.docker.internal回源到本机源站时的网关

TIP

密钥还是示例值时，服务可能起不来。务必改成自己的。一键安装脚本会自动随机生成这些值。

4. 检查端口 ​

bash
ss -tlnp | grep -E ':80 |:443 '

若被本机 Nginx 占用，把各站点 listen 80/443 改到高位端口（如 8080 / 4343）后重载 Nginx。

5. 放行防火墙 / 安全组 ​

  • 80、443：给访客访问网站
  • 9000（或你改过的面板端口）：尽量只给自己用（内网 / VPN / 反代）

6. 启动 ​

bash
docker compose up -d --build
docker compose ps

第一次构建可能要几分钟，服务都起来后再登录。

7. 登录并接入站点 ​

  1. 打开 http://<服务器公网IP>:9000
  2. 用 .env 里的账号登录
  3. 按 接入第一个站点 配证书、站点和 DNS

升级、备份、停止 ​

  • 升级与备份：升级与备份
  • 停止服务（保留数据）：docker compose down
  • 删除服务并清空数据（不可恢复）：docker compose down -v —— 生产慎用

端口冲突、起不来等问题，见 部署与运维 FAQ。