外观
错误页模板
GinWAF 支持自定义各类错误页与拦截页的 HTML 模板，使拦截提示与站点风格保持一致。
版本说明
自定义状态码错误页模板自 V1.0.0 版本起支持。
可自定义的页面
| 页面 | 说明 |
|---|---|
| 400 | 请求错误 |
| 403 | 拒绝访问（含 WAF 拦截页） |
| 404 | 页面不存在 |
| 500 | 服务器内部错误 |
| 502 | 网关错误（源站连接失败） |
| 503 | 服务不可用 |
| 504 | 网关超时 |
| 域名未绑定 | 请求的域名未在系统中接入 |
| IP 直连 | 直接通过 IP 访问时的提示页 |
配置方式
进入「错误页管理」，选择对应的错误码标签，编辑 HTML 模板内容后保存即可。
保存后，模板会被部署到网关的错误页目录，并在对应场景下生效。
操作步骤：
- 在控制台左侧菜单点击「错误页管理」，进入「自定义错误页模板管理」页面。
- 页面按错误码纵向排列各模板编辑区，每个编辑区上方标注对应的页面名称（如 400 Bad Request 页面、404 Not Found 页面）。
- 在目标编辑区中直接修改 HTML 内容，可调整样式、文案与交互。
- 点击页面底部的保存按钮，模板立即部署到
/usr/local/openresty/nginx/html/目录下对应的模板文件，无需重启服务。
模板注意事项
- 403 拦截页会展示给被拦截的访问者，建议文案友好并说明可能的原因
- 自定义模板时请保留必要的页面结构，避免出现空白或错乱的展示
403 拦截页效果
当请求被 WAF 拦截，或访问 IP 已被拉黑时，系统返回 403 页面。页面会列出判定为拦截的常见原因，并给出 Request ID 与发生时间，便于管理员据此溯源。
排查时可将页面上的 Request ID 提供给管理员，与「拦截日志」中的记录对应，详见 日志管理。