宝塔环境 Nginx SEO 配置说明

1. 已生成的配置文件

server/nginx-www.xingfucha.cn.conf：在你这套站点上的完整 server 配置（已含 SEO 爬虫检测与静态模板），可直接对照或替换。

2. 部署前准备：上传 SEO 模板

在服务器上要有 SEO 静态 HTML 目录，路径必须为：

/www/wwwroot/www.xingfucha.cn/seo-templates/

操作步骤：

本地在项目里生成模板（若未生成过）：
```
cd server
npm run generate
```
将本地的 xfc_webview_V2/public/seo-templates/ 整个目录上传到服务器，并放到：
```
/www/wwwroot/www.xingfucha.cn/seo-templates/
```
即该目录下应有：index.html、agent.html、help.html、help-guide.html、example.html、service.html、inquire-*.html 等。

3. 在宝塔里修改 Nginx 配置

登录宝塔面板 → 网站 → 找到 www.xingfucha.cn → 设置 → 配置文件（或 Nginx 配置）。
用下面两种方式之一应用 SEO 修改：
- 方式 A（推荐）：打开 server/nginx-www.xingfucha.cn.conf，复制其中从 # ========== SEO 爬虫检测 到 # ========== SEO 配置结束 的整段，以及 location ~ ^/__seo__/ 和 location / 两个块，按注释位置合并进你当前的 server 配置（保留你原有的 SSL、include、api、日志等）。
- 方式 B：若你当前配置与示例几乎一致，可直接用 nginx-www.xingfucha.cn.conf 的整个 server 块替换当前站点的 server 块（注意先备份原配置）。
保存后，在宝塔里 重载 Nginx（或命令行执行 nginx -t && nginx -s reload）。

4. 配置要点说明

爬虫判断：根据 User-Agent 识别百度、Google、必应、360、搜狗、头条、社交媒体等爬虫；识别为爬虫时走 SEO 逻辑。
路由与模板：$uri 与 $seo_file 的对应关系在配置里已写好（如 /→index.html，/agent→agent.html，/help→help.html 等），与 public/seo-templates 下文件名一致。
内部 location：/__seo__/ 仅用于内部 rewrite，不对外暴露，爬虫看到的仍是正常 URL，只是响应内容来自 seo-templates 下的静态 HTML。

5. 验证

在服务器或本机执行：

# 应返回带完整 title/description 的 HTML，且响应头有 X-SEOMiddleware
curl -sI -A "Baiduspider/2.0" https://www.xingfucha.cn/
curl -s -A "Baiduspider/2.0" https://www.xingfucha.cn/ | grep -o '<title>.*</title>'

若看到正确的标题和 X-SEOMiddleware: nginx-prerendered，说明 SEO 已生效。

若验证时得到 404：说明爬虫未命中 SEO 模板，请按 server/如何检测.md 里的 「六、爬虫请求返回 404 时排查」 在服务器上逐项检查（是否已接入 SEO 配置、seo-templates 目录与文件是否存在、alias 路径与 error 日志）。

更多检测方式见：server/如何检测.md。

3.0 KiB Raw Permalink Blame History Unescape Escape