PbootCMS IndexNow 主动推送功能使用说明-系统使用-PbootCMS官网-永久开源免费的PHP企业网站开发建设管理系统

PbootCMS IndexNow 主动推送功能使用说明

PbootCMS 从 V3.2.21 版本开始，后台内置了 IndexNow 主动推送功能。站长在后台配置一次推送密钥后，即可把新发布或刚更新的网址主动提交给搜索引擎，帮助搜索引擎更快发现页面变化，无需再依赖第三方插件或手工调用接口。

IndexNow 是一个由多家搜索引擎共同支持的开放推送协议，一次推送即可同时通知必应（Bing）等 IndexNow 参与引擎，不需要为每个引擎分别对接。

本文面向普通站长和新手用户，介绍 IndexNow 推送的配置步骤、密钥文件验证方法、两种推送入口的使用方式，以及后台各类提示信息的含义和处理方法。

一、使用前的准备

使用本功能前，请先确认以下几点：

网站版本为 PbootCMS V3.2.21 及以上，旧版本后台没有该功能入口；
服务器 PHP 已启用 curl 扩展，并且允许对外访问 HTTPS 接口；
网站根目录（或你自定义的密钥文件目录）具备写入权限，否则密钥文件无法自动生成；
网站可以通过公网正常访问，搜索引擎需要能读取到你的密钥文件。

推送接口地址为 https://api.indexnow.org/indexnow，系统会强制校验 HTTPS 证书，连接超时 10 秒、请求总超时 30 秒。

二、第一步：配置推送密钥

登录网站后台，进入：

全局配置 → 配置参数 → IndexNow推送

该配置页只有两项内容：推送密钥 和 密钥文件地址。

1、填写推送密钥

推送密钥用于向搜索引擎证明这个网站确实归你所有，要求为 8-128 位的字母、数字或连字符。

推荐直接点击输入框右侧的 生成密钥 按钮，由系统自动生成一串随机密钥，避免使用过于简单的字符串。

注意：点击“生成密钥”只是把密钥填入输入框，必须再点击页面下方的“立即提交”才会真正保存。

提交成功后，系统会自动在网站根目录生成密钥文件，文件名为“推送密钥 + .txt”，文件内容就是密钥本身。例如密钥为 a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4 时，根目录会生成 a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4.txt。

2、密钥文件地址（可留空）

如果希望把密钥文件放在根目录以外的位置，可以在这里填写。填写规则如下：

可以填相对路径，也可以填本站完整 URL，但必须与网站同域；
文件名必须仍然是“推送密钥.txt”，例如 /static/你的密钥.txt；
不支持跨域远程地址，填写其他站点的地址会被直接拒绝；
留空即表示使用网站根目录下的密钥文件，大多数站点建议留空。

另外还有一个便捷用法：如果你已经手工把密钥文件上传到了站内，可以只填写密钥文件地址、不填推送密钥，系统会自动读取该文件的内容作为密钥。

3、更换密钥时的注意事项

重新生成或修改密钥并提交后，系统会自动清空原来的密钥文件地址，改用网站根目录下的新密钥文件。提交前后会分别看到以下提示：

提交前的确认提示：重新生成密钥后需再次提交；若已填写密钥文件地址，提交后将自动清空并改用根目录密钥文件，确定继续么？
保存成功后的提示：修改成功！推送密钥已变更，已清空密钥文件地址，改用网站根目录密钥文件！

更换密钥后，网站根目录下原来那个旧密钥的 txt 文件不会自动删除，可以自行清理，也可以保留。

三、第二步：验证密钥文件可以被公网访问

密钥文件能否被搜索引擎读取，直接决定推送是否成功，建议配置完成后先做一次验证。

用浏览器直接打开密钥文件地址，例如：

https://你的域名/a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4.txt

如果网站部署在二级目录下，地址中会带上目录名，例如：

https://你的域名/cms/a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4.txt

验证要点：

页面能正常打开，不是 404；
页面内容正好就是密钥本身，没有多余的空行、说明文字或 HTML 代码。

如果打不开，请重点检查网站根目录写入权限、伪静态规则是否拦截了 txt 文件，以及是否有安全软件、CDN 规则屏蔽了该文件。

四、第三步：推送网址

配置完成后，后台提供两个推送入口。推送为手动触发，发布或修改内容后不会自动提交，需要自行点击推送。

提示：推送按钮只有在已配置推送密钥后才会显示，并且需要使用具备内容修改权限的后台账号；如果找不到按钮，请先完成第二步的密钥配置。

1、内容列表批量推送

进入任意内容列表页面，勾选需要推送的内容，然后点击列表下方的 IndexNow推送 按钮，即可一次性提交多条网址。

批量推送时系统会自动做以下处理：

自动去除重复网址；
自动过滤掉不属于本站域名的网址；
单次提交最多 10000 条网址（IndexNow 接口单次上限）。

列表中链接类型的内容无法勾选，其复选框为禁用状态，因为这类内容的地址指向站外，不属于可推送范围。

2、单页推送

进入单页列表页面，在每条单页右侧点击 IndexNow推送 按钮，即可单独推送该单页的网址。链接类型的单页不会显示推送按钮。

3、关于推送出去的网址

系统推送的网址，是按当前访问后台所使用的域名与协议，结合前台 URL 规则自动生成的。因此建议：

平时使用网站正式域名登录后台再执行推送，不要用 IP、临时域名或测试域名推送；
网站已启用 HTTPS 的，使用 HTTPS 地址登录后台，避免推送出 http 网址。

五、推送成功的提示说明

推送完成后会弹出结果提示，出现下面两种提示都表示接口已经正常接收（X 处会显示为实际推送条数）：

提示信息	说明
成功推送X条地址到IndexNow！	接口已确认接收，推送完成，无需其他操作。
已接收X条地址，密钥待校验；首次推送出现属正常现象，请确认密钥文件可公网访问！	接口已接收网址，但密钥还在校验中。首次推送出现这个提示属于正常现象，只要密钥文件可以公网访问即可，不必反复重推。

六、常见提示与处理方法

下表列出后台可能出现的提示信息及处理方法。其中密钥处会显示为你实际配置的推送密钥，X 处会显示为实际数值。

1、保存配置时的提示

提示信息	原因与处理方法
请填写有效的IndexNow推送密钥（8-128位字母、数字或连字符）！也可仅填写站点内可读取的密钥文件地址（相对路径或本站完整URL），系统将自动读取文件内容作为密钥。	密钥为空或格式不符合要求。点击“生成密钥”重新生成后再提交，或改为只填写站内已存在的密钥文件地址。
IndexNow密钥格式不正确，须为8-128位的字母、数字或连字符，密钥未保存！	密钥中含有空格、中文或其他特殊符号。请只使用字母、数字和连字符。
密钥文件地址不允许使用跨域远程地址（IndexNow要求与推送页面同域）！请填写相对路径或本站完整URL，或留空使用网站根目录密钥文件。	密钥文件地址填写了其他站点的网址。改为相对路径或本站完整 URL，或直接留空。
配置已保存，但密钥文件名必须为密钥.txt（例如 /static/密钥.txt），未写入自定义地址对应文件！	自定义地址的文件名与密钥不一致。把地址中的文件名改成“推送密钥.txt”后重新提交。
配置已保存，但无法写入密钥文件地址对应的本地文件，请检查路径及写入权限，或手工将文件内容更新为密钥！	自定义目录不存在或没有写入权限。检查目录权限，或手工创建该文件并把内容写为密钥。
配置已保存，密钥文件地址已同步，但根目录密钥文件创建失败，请检查网站根目录写入权限！	自定义位置已写入成功，但根目录写入失败。放开网站根目录写入权限后重新提交。
配置已保存，但密钥文件创建失败，请检查网站根目录写入权限，或手工上传内容为密钥的文件密钥.txt到网站根目录！	根目录不可写。放开权限后重新提交，或按提示手工上传密钥文件。

2、执行推送时的提示

提示信息	原因与处理方法
请选择要推送的内容！	批量推送前没有勾选任何内容。先勾选内容再点击推送。
请先到系统配置中填写IndexNow推送密钥！	还没有配置密钥。先到全局配置 → 配置参数 → IndexNow推送完成配置。
所选内容中没有可推送的地址，链接类型内容不允许推送！	勾选的内容全部是链接类型。改选普通内容后再推送。
链接类型不允许推送！要推送的单页内容不存在！没有可推送的本站地址！	单页推送时的对应提示：该单页是外链、单页已被删除，或生成的地址不属于本站域名。请刷新列表确认内容状态，并确认是用正式域名登录后台。
密钥文件不存在或内容与推送密钥不一致，请先到系统配置保存IndexNow密钥，并检查网站根目录（或自定义密钥文件地址）写入权限！	推送前的密钥文件自检未通过。重新保存一次配置，并按第三节的方法确认密钥文件内容正好是密钥本身。
IndexNow推送失败：密钥无效，或与密钥文件中的内容不一致！	接口校验密钥未通过。核对密钥文件内容与后台密钥是否完全一致，注意是否有多余空行。
IndexNow推送失败：推送地址不属于本站点，或与密钥文件所在目录不匹配！	推送网址与密钥文件所在目录不匹配。建议把密钥文件放在网站根目录，即把“密钥文件地址”留空。
IndexNow推送失败：请求格式错误，请检查密钥及推送地址！	接口判定请求格式有误。检查密钥是否被改动，以及推送的网址是否正常可访问。
IndexNow推送失败：推送过于频繁，请稍后再试！	短时间内推送次数过多被接口限流。间隔一段时间后再推送，不要对同一批网址反复提交。
IndexNow推送请求失败：具体错误信息，请检查服务器网络及HTTPS证书配置！ IndexNow推送失败：未获取到接口响应，请稍后再试！	服务器网络异常或无法完成 HTTPS 请求。确认服务器可以对外访问 `https://api.indexnow.org`，并检查 curl 扩展与服务器时间是否正常。
IndexNow推送失败：接口返回状态码X！	接口返回了其他状态码。可稍后重试，如持续出现请记录状态码后反馈。

七、查看推送记录

每次推送都会写入系统日志，可在后台的 系统管理 → 系统日志 中按关键字 IndexNow推送 查询，日志中会记录本次推送的网址与推送结果，便于回溯排查。

八、使用建议

密钥配置完成后，先验证密钥文件能否公网访问，再执行推送；
“密钥文件地址”一般留空即可，使用根目录密钥文件兼容性最好；
推送以新发布和有实质更新的页面为主，不必把全站网址反复提交；
发布内容后再推送，确保被推送的网址在前台可以正常打开；
始终使用正式域名登录后台执行推送，避免推送出测试域名或 IP 地址；
推送只是帮助搜索引擎更快发现页面变化，是否收录、何时收录仍由搜索引擎决定。

如在使用过程中遇到问题，欢迎前往官方社区或提交 Issue 反馈，反馈时请附上后台提示的完整提示信息，便于快速定位原因。