Files
2026-09-17 11:59:41 +08:00

46 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 雷池 SafeLine 自定义错误页
10 个单文件自包含 HTML 错误页:CSS / SVG 插图 / favicon 全部内联,零外部依赖,双击即可在浏览器打开预览。
## 文件对照
| 文件 | 场景 | 背景色 | 插图 |
|---|---|---|---|
| `404.html` | 页面不存在 | 雷池蓝 `#0E69C8` | 指南针 |
| `404-app.html` | 应用不存在 | 青蓝 `#0F8FC9` | 应用网格 + 缺位「?」 |
| `403.html` | 攻击检测与黑名单 | 深红 `#C13B45` | 盾牌 + 禁止符 |
| `429.html` | 频率限制 | 橙 `#D9761F` | 沙漏 + 加速线 |
| `465.html` | 等候室 | 青绿 `#12968A` | 排队小人 |
| `466.html` | 应用维护 | 琥珀 `#C99420` | 施工锥 |
| `467.html` | 身份认证 | 靛蓝 `#4C5FD0` | 钥匙 |
| `468.html` | 人机验证 | 绿 `#2E9E5B` | 机器人 + 对勾 |
| `502.html` | 网关错误 | 紫罗兰 `#8A55C8` | 断开的插头 + 电火花 |
| `504.html` | 网关超时 | 深紫 `#6A3FB8` | 闹钟 |
## 页面结构
- 浏览器窗口拟物卡片:标签页(`Error 4xx/5xx`)+ 红色搜索条(8 颗加载小球动画)+ 专属 SVG 插图
- 文案:中文诗意句加粗 + 英文小一号在下
- 悬停:卡片回正,插图轻微倾斜(404 指南针旋转 -90°)
- 移动端自适应(430px / 350px 两档缩小),支持 `prefers-reduced-motion`
## 拦截信息(事件 ID)
每页底部预留了隐藏的信息块。雷池 WAF 实际拦截时会在 HTML 末尾注入注释:
```html
<!-- event_id: 8f14e45fceea167a5a36dedd4bea2543 TYPE: A -->
```
页面内联 JS 会自动解析并显示「事件ID / 类型 / 拦截时间」三行小字。
无注入时(本地预览)整块保持隐藏,页面外观完全不变。
本地预览带信息块的效果:把上面那行注释追加到任意文件 `</html>` 后面再打开即可。
## 部署到雷池
- **专业版**:控制台「防护配置 → 通用配置 → 拦截页面」→ 自定义拦截页面,按场景逐个替换 HTML。
- **社区版**:控制台仅支持改提示文案;整页替换需走文件方式——在部署目录(默认 `/opt/safeline`)下找到 `resources/nginx/*_pages/`,按现有文件名逐个替换(可参考上表做文件名映射),注意版本升级可能还原自定义文件。
- 465 等候室 / 468 人机验证在官方实现里是带 JS 校验的动态服务,静态页替换上去只有展示作用,部署前请先确认替换入口。
我为我自己带盐!