站点地图与搜索引擎提交
校对日期:2026-11-16。适用于社区版及全部商业版。
本手册面向站点管理员和运维人员,说明 UJCMS 自动生成的站点地图包含什么、各搜索引擎应如何提交、如何开启百度主动推送与 IndexNow 推送,以及静态化部署时需要注意的代理规则。
一、地址与内容
站点地图由后台动态生成,不需要模板参与,也不会写入磁盘。每个站点的地址如下(子目录站点在前面加子目录,如 /en/sitemap.xml):
| 地址 | 内容 |
|---|---|
/sitemap.xml | 索引文件:列出下面的每个子文件及其 lastmod(Google、Bing 据此只抓取有变化的子文件) |
/sitemap-channel. | 站点首页(第一条)+ 全部栏目页 |
/sitemap-article. | 文章第 1 页(每页 10000 条,按文章 ID 升序,旧页内容稳定) |
/sitemap-article-2.、-3.xml … | 文章后续分页;超出范围返回 404 |
收录条件:
- 文章:状态为“已发布”或“已归档”,且不是链接文章(设置了跳转地址的文章不收录)。草稿、待审、回收站、已下线文章不出现; 匿名用户组无浏览权限的栏目里的文章也不出现。
- 栏目:不是链接栏目;匿名用户组无浏览权限的栏目(需登录浏览)不出现,因为爬虫访问会得到 401。
- 只输出
<loc>与<lastmod>。Google 与 Bing 明确忽略<changefreq>与<priority>,百度仅作参考,因此不再输出。 <lastmod>取内容的真实修改时间:文章为最后修改时间;栏目为栏目子树内最新文章与栏目自身修改时间中较晚者;首页与索引条目为全站最新。没有依据时省略,不伪造。- 多语言站点(语言组)附带
<xhtml:,含自引用与link rel= "alternate" hreflang> x-default(取语言组内排序第一的站点,与默认主题页面<head>的规则一致)。 - 文章缩略图以 Google 图片扩展
<image:输出(仅地址;上传目录的相对路径自动补站点域名)。image><image: loc>
二、缓存与响应头
- 每站点、每个文件在应用内缓存 1 小时。新发布的文章最迟 1 小时后出现在站点地图中;无需手动刷新。
- 响应带弱 ETag(
W/"…")与Last-Modified,支持If-None-Match/If-Modified-Since回 304,并已启用 gzip(server.)。compression /sitemap*.xml、/rss、/robots.txt、/llms.txt对匿名访问带Cache-Control: public, max-age=,子目录站点的同名路径同样适用。3600 robots.txt已自动追加Sitemap: <站点地址>/一行,Google、Bing 可自动发现;根站点的 robots.txt 还会为同一主机下的每个子目录站点各追加一行(搜索引擎只读主机根路径的 robots.txt)。sitemap. xml
检查命令:
curl -sD - -o /dev/null -H 'Accept-Encoding: gzip' https://example.com/sitemap-article.xml
# 期望:HTTP 200、Content-Type: application/xml、ETag: W/"..."、Last-Modified、Content-Encoding: gzip
curl -s https://example.com/sitemap-article.xml | grep -o '<lastmod>[^<]*' | sort | uniq -c
# 期望:多种日期;若全部是同一天,说明修改时间未正确映射三、向搜索引擎提交
Google / Bing
在 Google Search Console、Bing Webmaster Tools 提交索引文件 https: 一次即可,子文件由索引文件带出。Bing 另支持 IndexNow 实时推送,见“搜索引擎推送”一节。
百度
百度搜索资源平台自 2023 年起不处理索引型 sitemap(提交 /sitemap.xml 会显示“索引型不予处理”,且存在索引型文件时不允许再提交其他文件)。请逐个提交子文件:
- 进入 普通收录 → sitemap(旧版路径为 链接提交 → 自动提交 → sitemap)。
- 依次填写
https:、/ / example. com/ sitemap-channel. xml https:、/ / example. com/ sitemap-article. xml https:…。/ / example. com/ sitemap-article-2. xml - 配额:每天最多提交 10 个文件、每站最多 200 个文件。按每页 10000 条计算,单站可覆盖 200 万篇文章。
从索引文件直接生成待提交列表:
curl -s https://example.com/sitemap.xml | grep -o '<loc>[^<]*' | sed 's/<loc>//'文章数量增长后索引文件会多出新的分页地址,需要把新地址补提交一次;已提交的旧页地址不变。
百度“普通收录 → API 提交”(主动推送)比 sitemap 更快,见“搜索引擎推送”一节。
四、静态化站点与反向代理
开启“生成静态页”后,页面由静态文件目录直接提供,但 /sitemap*.xml、/robots.txt、/llms.txt 仍由应用动态生成。若 Nginx 直接指向静态目录,需要把这些路径转发到应用:
location ~ ^/(sitemap[\w-]*\.xml|robots\.txt|llms\.txt|indexnow-[\w-]+\.txt)$ {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
}子目录站点同理,例如 ^/en/。
站点地图中的地址始终按桌面端(PC)规则组装,不受抓取方 User-Agent 影响;启用手机主题的静态化站点,其手机页面地址不单独出现在站点地图中。
五、搜索引擎推送(百度主动推送、IndexNow)
站点地图是“等引擎来抓”,推送是“告诉引擎去抓”。在 站点设置 → GEO设置 → 搜索引擎推送 中按站点开启:
| 引擎 | 触发时机 | 需要填写 | 限制 |
|---|---|---|---|
| 百度普通收录(API 提交 / 主动推送) | 文章发布后 | 搜索资源平台“普通收录 → API提交”页面给出的完整接口地址(含 site 与 token) | 同一地址 24 小时内只提交一次;每次最多 2000 条;占用站点每日配额 |
| IndexNow(Bing、Yandex、Naver、Seznam 等共享) | 文章发布、更新、彻底删除后 | 密钥(8~128 位字母、数字、连字符,可点“生成”) | 每次最多 10000 条;密钥文件由本站自动提供 |
工作方式:
- 保存文章的事务提交后入队,后台每 5 秒按站点合并成一次请求;批量发布、批量新增译文不会打出一串请求。推送失败不影响保存:结果显示在 GEO 设置页每个引擎下方的“推送状态”(应用重启后清空),同时写应用日志(
Baidu push:/IndexNow push:开头)。 - 连不上引擎、超时一类网络故障会自动重试,最多 3 次;引擎明确拒绝(401 token 无效、403 密钥无效、422 主机不符、429 限流)不重试,需先修正配置。
- “推送测试”按已保存的设置即时提交站点首页并显示结果,用来确认 token / 密钥填写正确;百度的测试同样占用一条当日配额,未保存的修改不参与测试。
- 提交的地址与站点地图一致(桌面端规则、静态化站点为静态页地址)。静态页托管在其它域名时,IndexNow 会因主机不符返回 422,此时请关闭 IndexNow 推送。
- IndexNow 密钥文件地址为
<站点动态地址>/(子目录站点为indexnow-<密钥>. txt /<子目录>/),保存设置后可用indexnow-<密钥>. txt curl访问确认输出的是密钥本身。静态化部署需要把indexnow-*.txt与“静态化站点与反向代理”一节的路径一起转发到应用。 - 下线、放入回收站的文章目前不推送;彻底删除会通知 IndexNow,引擎重抓得到 404 后移除。
- 百度接口地址只接受
data.域名;token 与其它 GEO 设置一样对拥有 GEO 设置权限的管理员可见。zz. baidu. com
六、常见问题
| 现象 | 原因与处理 |
|---|---|
/sitemap-article-2. 返回 404 | 该页超出范围(文章不足 10001 篇)。以索引文件列出的地址为准;/sitemap-article-1.、-0 同样 404,第 1 页地址是 /sitemap-article.。 |
| 浏览器打开站点地图显示为一行连续文本 | Chrome / Edge 遇到多语言备选的 xhtml:link 元素时不启用 XML 树状视图,而是直接渲染文档;文件本身正确。输出已按元素换行缩进,用“查看网页源代码”或 curl 查看即可。 |
| 百度提示“索引型不予处理” | 提交了 /sitemap.xml。删除该条,改为逐个提交子文件(“向搜索引擎提交”一节)。 |
| 新文章 1 小时后仍未出现 | 检查文章状态是否为已发布 / 已归档、是否设置了跳转地址;确认访问的是同一站点(多站点按域名或子目录区分)。 |
| Google 报告 hreflang 错误 | 语言组内站点须设置语言标签;只有“同别名栏目”“已关联译文”的条目才输出备选,见 多语言站点。 |
| 响应未压缩 | 反向代理已压缩时应用不会二次压缩;直连应用时确认 server. 未被 profile 覆盖为 false。 |
日志出现 Baidu push failed … "error": | token 或 site 参数不对:重新从搜索资源平台复制完整接口地址;site 须与平台验证的站点一致(含协议)。 |
日志出现 IndexNow push failed … status= | 403:密钥文件访问不到或内容不符,用 curl 检查密钥文件地址;422:提交的地址与站点主机不一致(常见于静态页在其它域名)。 |
| “推送状态”显示失败(HTTP 0) | 应用连不上引擎(出网、DNS、代理),会自动重试 3 次;仍失败请检查服务器出网。 |
| 点“推送测试”提示未开启或未配置 | 该引擎开关未打开或地址/密钥为空,或修改后尚未保存。 |
| Search Console 提示 hreflang 缺少 x-default | 站点地图与页面均已输出 x-default;确认语言组内各站点都设置了语言标签,并等待重新抓取。 |