API 文档
服务说明
CRS 规则镜像服务，提供 OWASP CRS 规则包的缓存代理下载。部署在可访问境外的节点，代替 infra-gate 直接访问 GitHub，减少 GitHub API rate limit 消耗和带宽占用。
缓存策略
- 接口数据缓存：1 分钟内存缓存（GitHub Release API 响应）
- 文件数据缓存：5 分钟本地文件缓存（tarball 二进制）
- 缓存清理：每小时清理超过 24 小时的过期文件
- 降级回退：下载失败时返回旧文件
API 端点
| 方法 | 路径 | 说明 | 响应格式 |
|---|---|---|---|
| GET | /api/crs/releases/latest |
获取最新 CRS 版本 | {"code":200,"data":{"version","sha256","tarball_url","size"}} |
| GET | /api/crs/releases/tags/:version |
获取指定版本 | 同上 |
| GET | /api/crs/:version/tarball |
下载 tarball | application/gzip 二进制流 |
| GET | /api/cache/status |
查看本地缓存状态 | {"code":200,"data":{"items[]","latest_version"}} |
infra-gate 接入说明
在 infra-gate 配置中设置 mirror_url 即可使用镜像服务：
## infra-gate configs/server.yml
waf:
crs:
enabled: true
version: "v4.0.0"
download:
mirror_url: "http://crsmirror.litelake.cn"设置 mirror_url 后，infra-gate 将从镜像服务下载 CRS 规则，不再直连 GitHub。
部署说明
镜像服务需部署在可访问 GitHub 的节点。如需使用代理访问 GitHub，在配置中设置 crs_mirror.proxy 相关参数。