GinWAF防火墙系统 V1.0.1 安装教程（Ubuntu 18~24 通用，推荐 Ubuntu 24.04｜4H4G~16H32G）

前言

GinWAF 是一款基于 OpenResty + Lua + Redis + Go 构建的企业级Web应用防火墙，采用主控+防护节点架构。它集成了15+攻击检测引擎（覆盖SQL注入、XSS、CSRF、SSRF等OWASP Top 10威胁）和6种验证机制的CC防护引擎，具备智能评分封禁、毫秒级响应（单节点万级QPS）、实时监控大屏与一键解封等企业级功能。
本文基于 GinWAF V1.0.1 版本，提供 Ubuntu 全系列（18.04/20.04/22.04/24.04）防护节点安装教程，推荐优先使用 Ubuntu 24.04 LTS，性能与兼容性最佳。
全程一条命令全自动部署，无需手动编译、无需改配置，新手也能 5-10 分钟部署完成。

一、环境要求

1. 操作系统

支持：Ubuntu 18.04 / 20.04 / 22.04 / 24.04（64位）
推荐：Ubuntu 24.04 LTS（内核新、性能强、依赖更完整）

2. 服务器配置（根据业务流量选择）

测试/轻量业务：4H4G
常规业务：4H8G / 8H8G / 8H16G / 16H8G
高并发大流量：16H16G / 16H32G

3. 网络与权限

必须使用 root 权限 执行
服务器可访问公网

二、一键部署命令（核心）

直接复制以下完整命令粘贴执行，自动下载、授权、运行一条龙：

curl -k --http1.1 -o /root/gincdn-install https://www.ginwaf.cn/download/ubuntu/ginwaf-install && chmod +x ginwaf-install && sudo ./ginwaf-install

命令说明

命令:
  install        完整安装所有组件
  mysql          仅安装MySQL
  redis          仅安装Redis
  openresty      仅安装OpenResty
  ssl            仅生成SSL证书
  sql            仅导入SQL数据
  status         查看服务状态
  help           显示帮助

三、执行自动化安装

sudo ./ginwaf-install install

如果还没授权的，请前往官网：

www.ginwaf.cn

获取正版授权

等待5~10分钟后自动安装部署成功

到这里只是安装成功，接下来开始运行

运行

cd /opt/ginwaf && sudo ./ginwaf

运行成功

服务器IP:8080

管理员用户名:admin 密码:123456

四、常见问题排查

1. 脚本下载失败 curl:(92) HTTP/2 stream error

原因： 服务器对 HTTPS/HTTP2 兼容差
解决：
本文命令已加 --http1.1，重新复制执行即可。

2. 报错 unzip: command not found

apt update && apt install unzip -y

3. 运行失败

可能原因：

主控地址写错
8080 端口未通
安全组/防火墙未放行

排查：

ping 服务器IP
telnet 服务器IP 8080

五、总结

GinWAF防火墙系统V1.0.1在 Ubuntu 18~24 全版本 均可稳定运行，推荐 Ubuntu 24.04 性能最佳。
部署仅需一条命令，全自动配置、自动注册、自动开机自启，适合大量安全防护节点批量部署。
配置从 4H4G 到 16H32G 全覆盖，可满足个人测试、企业高并发Web安全防护场景。其智能评分封禁与双引擎防护（攻击检测+CC防护）协同工作，可为网站提供高性价比的商业级WAF防护能力。

GinWAF WAF部署 Ubuntu24 Web防火墙 应用防火墙 OpenResty 国产防火墙