SEONexus/docs/前端站群nginx配置目录说明.md

前端站群 nginx 配置目录说明

这份文档用于把服务器目录里的 nginx 模板整理规则同步回 SEONexus/docs，避免后续出现：

1. 代码仓里说一套
2. 服务器目录里放一套
3. 接手时又不知道到底该复制哪份

当前正式发布入口

前端站群服务器目录中，当前长期正式发布入口是：

• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-最终发布版.txt

如果目标是：

1. 真正复制到站群站点里
2. 替换线上站点伪静态
3. 作为后续默认模板继续迭代

那么优先从这份开始，不要再从旧模板复制。

当前长期规则

1. 搜索页

真实搜索入口至少存在两种：

1. /get-index
2. /get/index

因此正式模板里必须同时兼容这两种路径。

搜索页规则：

1. cache key 必须带 $args
2. 否则不同关键词会串缓存
3. 线上排障时应看到：
   • X-Cache-Mode: with-args

2. 详情页 / 播放页 / 分类页 / 榜单页

这类动态页规则：

1. cache key 不带 $args
2. 保持缓存稳定
3. 避免无意义 query 参数打碎缓存

线上排障时常见：

1. X-Cache-Mode: path-only
2. X-Cache-Status: HIT / MISS / STALE

3. 所有动态页

都支持人工排障参数：

• ?__nocache=1

用途：

1. 只用于人工排障
2. 强制跳过前端缓存
3. 便于确认“代码未生效”到底是不是缓存误判

正常响应头表现：

1. X-Cache-Status: BYPASS
2. X-Cache-Mode: bypass
3. X-Cache-Bypass: 1

推荐排障顺序

以后再遇到“前端像没更新”“搜索页像串页”“蜘蛛看起来异常”时，先按这个顺序走：

1. 先看 X-Cache-Status
2. 再看 X-Cache-Mode
3. 再看 X-Managed-Spider
4. 若仍怀疑前端缓存顶旧 HTML，用 ?__nocache=1
5. 如果 ?__nocache=1 正常，而普通访问异常，优先清前端缓存

目录内文件角色

当前正式版

• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-最终发布版.txt

当前可用组合版

• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-受管蜘蛛放行版-动态页安全缓存.txt

说明：

1. 这是当前可用的组合版模板
2. 与最终发布版功能接近
3. 保留作过程版本参考

受管蜘蛛映射方案

• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/受管蜘蛛映射-最优方案.txt

说明：

1. 这是推荐写法和方案样例
2. 不是线上实时状态快照
3. 不要因为样例里“默认只写百度”，就直接推断线上当前一定没纳入 sogou

当前更可靠的判断优先级应当是：

1. 先看真实响应头 X-Managed-Spider
2. 再看线上真实 managed_spiders.map.conf
3. 最后才参考样例文件

历史版本

• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态.txt
• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-百度放行版.txt
• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-受管蜘蛛放行版.txt
• /www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-动态页安全缓存版.txt

这些文件都保留了顶部版本说明。

如果不是为了：

1. 对比历史演进
2. 回看当时为什么这么改
3. 查某个阶段的专项版本

就不要直接从这些旧文件复制上线。

接手时只记一条

如果目标是正式发线上：

1. 从 站点伪静态-最终发布版.txt 开始
2. 搜索页一定兼容 /get-index 和 /get/index
3. 先看响应头，再怀疑代码