外观
环境要求
在安装 GinWAF 之前，请确认服务器满足以下条件。
1. 操作系统
- 支持：Ubuntu 18.04 / 20.04 / 22.04 / 24.04（64 位）
- 推荐：Ubuntu 24.04 LTS（内核新、性能强、依赖更完整）
说明
GinWAF 在 Ubuntu 18 至 24 全版本均可稳定运行，推荐 Ubuntu 24.04，性能与兼容性最佳。
2. 服务器配置
根据业务流量选择配置：
| 场景 | 推荐配置 |
|---|---|
| 测试 / 轻量业务 | 4H4G |
| 常规业务 | 4H8G / 8H8G / 8H16G / 16H8G |
| 高并发大流量 | 16H16G / 16H32G |
云服务器推荐
如尚未购买服务器，推荐使用 贝海云：www.beihaiyun.com
3. 网络与权限
- 必须使用 root 权限 执行安装命令
- 服务器可访问公网（安装过程需下载软件包与安装包，并完成授权校验）
- 建议使用干净的服务器，避免与本机已有的 Nginx / MySQL / Redis 冲突
4. 端口要求
安装完成后将占用以下端口，请确保未被占用且安全组已放行：
| 端口 | 用途 | 对外开放 |
|---|---|---|
| 80 | HTTP 站点防护、回源 | 是 |
| 443 | HTTPS 站点防护、回源 | 是 |
| 8080 | 管理后台（Web 控制台与 API） | 是（建议限制来源 IP） |
| 9999 | WAF 引擎内部数据接口（统计、状态码、系统资源） | 否（仅本机 127.0.0.1） |
| 3306 | MySQL | 否（仅本机） |
| 6379 | Redis | 否（仅本机） |
安全建议
8080 管理端口建议通过安全组限制为可信 IP 访问，或在前端再加一层访问控制。
5. 磁盘空间
安装包（含 IP 归属地库与前端产物）解压后约占用 250 MB 以上，加上日志与数据库，建议系统盘预留 10 GB 以上可用空间。
下一步
确认环境满足要求后，请阅读 一键安装。