外观
日志清理
长期运行的 WAF 会产生大量访问日志与攻击日志，日志清理功能可自动清理过期日志，避免磁盘被占满。
版本说明
日志清理功能自 V1.0.1 版本起新增。
配置项
进入「系统管理 → 日志配置」，页面标题为「日志清理配置」，所有参数集中在同一张卡片内：
| 配置项 | 说明 | 取值范围 / 默认值 |
|---|---|---|
| 启用日志清理 | 是否启用自动清理，关闭后定时清理停止执行 | 开启 / 关闭，默认开启 |
| 检测间隔 | 每隔多少秒检查一次日志文件大小与保留期限 | 300~1800 秒，步长 60，默认 300 |
| 系统日志保留天数 | 超过该天数的系统日志在下次清理时整体删除 | 7 / 30 / 90 天，默认 7 天 |
| 上次更新时间 | 最近一次保存配置的时间，有值时才显示 | 只读 |
操作步骤：
- 在控制台左侧菜单点击「系统管理」，展开子菜单后点击「日志配置」。
- 开启「启用日志清理」开关。关闭状态下定时清理不会执行，仅在手动触发时清理。
- 设置「检测间隔」，单位为秒，即每隔多久检查一次各日志文件大小与保留期限。
- 选择「系统日志保留天数」，可选 7 天、30 天、90 天，超过该期限的系统日志会在下次清理时自动删除。
- 点击「保存」写入配置，页面底部显示最近一次更新时间，配置立即生效，无需重启服务。
- 「重置」只把表单恢复为上次加载的内容，不会写入服务器。
上图为早期版本界面，其按钮文案为「保存配置」「重置」「立即执行清理」，当前版本已简化为「保存」「重置」「清理」，功能与位置一致。
三个按钮的分工
「保存」写入清理策略；「重置」丢弃未保存的修改；「清理」立即执行一次实际清理，与是否保存当前表单无关——它按服务器上已保存的策略执行。
立即清理
除定时清理外，页面提供「清理」按钮，可手动触发一次清理，适合磁盘告警时紧急释放空间。
点击后先弹出确认框「确定要立即执行一次日志清理吗？」，确认后执行，并在页面顶部提示本次结果，例如「清理完成：清空文件 0 个，删除过期文件 0 个」。前者对应按大小阈值清空的日志文件数量，后者对应按保留天数删除的系统日志文件数量。
清理范围
清理会覆盖以下日志：
- 站点访问日志
- 站点错误日志
- WAF 攻击日志
- 系统运行日志
页面下方的「清理规则明细」列出了每类日志的文件路径、清理阈值与操作方式：
| 日志类型 | 文件路径 | 清理阈值 | 操作方式 |
|---|---|---|---|
| WAF 攻击日志 | /opt/ginwaf/waf/logs/attack.log | 1 MB | 清空文件内容 |
| Nginx 错误日志 | /usr/local/openresty/nginx/logs/error.log | 1 MB | 清空文件内容 |
| Nginx 访问日志 | /usr/local/openresty/nginx/logs/access.log | 1 MB | 清空文件内容 |
| 站点访问日志目录 | /usr/local/openresty/nginx/logs/access/ | 100 KB | 清空文件内容 |
| 站点错误日志目录 | /usr/local/openresty/nginx/logs/error/ | 100 KB | 清空文件内容 |
| 系统日志 | /opt/ginwaf/logs/ | 按天数删除 | 删除过期文件 |
注意
日志是攻击溯源与故障排查的重要依据。保留天数建议根据实际磁盘容量与合规要求设置，不宜过短。单文件日志采用「清空内容」方式回收空间，站点目录日志按阈值逐个清空，系统日志按保留天数整体删除。