一键安装

GinWAF 支持 Ubuntu 全系列一键部署，全程一条命令全自动完成，无需手动编译、无需修改配置，新手也可在 5~10 分钟内完成部署。

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

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

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

参数说明

• -k：跳过 SSL 证书校验，避免部分服务器证书链不全导致下载失败
• --http1.1：强制使用 HTTP/1.1，规避部分服务器 HTTP/2 兼容问题
• -o /root/ginwaf-install：将安装器下载到 /root/ 目录
• chmod +x：赋予可执行权限

二、命令说明

安装器提供以下子命令，可按需单独执行：

命令:
  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

看到服务正常启动的输出即表示运行成功。

开机自启

安装器已创建 ginwaf systemd 服务并设置为开机自启，正常情况无需手动启动。手动启动仅用于调试查看输出。

服务管理命令

日常运维可通过 systemd 管理 ginwaf 服务：

操作	命令
启动	sudo systemctl start ginwaf
停止	sudo systemctl stop ginwaf
重启	sudo systemctl restart ginwaf
查看日志	sudo journalctl -u ginwaf -f

说明

journalctl -u ginwaf -f 会持续输出最新日志，按 Ctrl + C 退出；只想查看历史日志时去掉 -f 参数即可。

五、访问管理后台

浏览器访问：

http://服务器IP:8080

默认管理员账号：

项目	值
用户名	admin
密码	123456

务必修改默认密码

首次登录后请立即在「个人信息」中修改管理员密码，避免后台被未授权访问。

六、安装视频教程

如果更习惯跟随视频操作，可观看官方安装视频：

👉 GinWAF 安装教程视频（哔哩哔哩）

下一步

安装完成后，请阅读 初始化与登录 完成首次配置。