《EyouCMS网站熊掌号提交推送功能实操配置全流程》

一、前置准备条件

1. 已部署运行正常的EyouCMS网站，版本≥1.5（低于此版本需先升级，升级包下载地址：https://www.eyoucms.com/download/upgrade/）； 2. 已完成百度熊掌号（现百度内容平台账号）的注册与认证，且当前网站已绑定该熊掌号； 3. 拥有EyouCMS后台管理员权限，具备服务器文件操作权限（若使用虚拟主机可省略服务器配置环节）。

二、后台内置推送功能配置

2.1 定位并安装推送插件（若需）

登录EyouCMS后台入口（你的域名+/admin.php），输入安装时创建的账号密码后进入：

• 点击左侧菜单【扩展】→【插件管理】，若列表中存在「百度推送」插件，直接点击【启用】；
• 若无该插件，前往EyouCMS官方插件市场（https://www.eyoucms.com/plugins/）下载「百度推送 for EyouCMS」，解压后上传至网站根目录的/plugins文件夹，再返回后台插件管理页启用。

2.2 填写熊掌号核心配置参数

启用插件后，点击插件列表旁的【设置】按钮进入配置页，填写以下必填项：

• 熊掌号Token：登录百度熊掌号后台（https://ziyuan.baidu.com/），进入【推送管理→API提交】页面，复制Token值（务必复制完整，无多余空格）粘贴到对应输入框；
• 推送接口类型：选择「熊掌号专属推送」（勿选普通百度搜索推送）；
• 推送频率：选择「每小时最高推送500条」，适配熊掌号每日推送限额规则。

2.3 开启自动推送触发

在配置页勾选以下选项，确保内容变动自动推送：

• 内容发布后自动推送；
• 内容修改后自动推送；
• 内容删除后自动推送；

点击【保存设置】完成基础配置。

三、服务器端强化配置（可选，虚拟主机用户跳过）

后台配置仅能推送通过后台发布的内容，若需实现静态页面实时推送，需修改服务器反向代理配置：

3.1 Nginx配置修改

打开Nginx站点配置文件（路径通常为/etc/nginx/conf.d/你的域名.conf），在对应server块中添加以下代码： ``` location /api/push_baidu_xiongzhang { proxy_pass https://data.zz.baidu.com/urls?site=https://你的网站域名&token=你的熊掌号Token; proxy_set_header Content-Type text/plain; } ``` 替换两处占位符：你的网站域名为实际域名（含https://），你的熊掌号Token为2.2步骤复制的Token； 执行配置测试命令nginx -t，显示“test is successful”后执行nginx -s reload生效。

3.2 Apache配置修改

若使用Apache，打开httpd.conf或虚拟主机配置文件，添加以下规则： ``` ProxyPass /api/push_baidu_xiongzhang https://data.zz.baidu.com/urls?site=https://你的网站域名&token=你的熊掌号Token ProxyPassReverse /api/push_baidu_xiongzhang https://data.zz.baidu.com/ ``` 替换占位符后重启Apache服务，生效命令为systemctl restart httpd。

四、推送有效性手动测试

配置完成后需手动验证，避免遗漏设置：

1. 返回EyouCMS后台【内容管理→文章管理】，选择任意已发布的文章，点击页面上方【推送】按钮（若未显示，需前往【内容管理→模型管理→对应模型→字段管理】，新增「百度推送」字段，类型为单选，选项为“是/否”，默认设为“是”，保存后即可显示按钮）；
2. 等待10分钟，登录百度熊掌号后台【推送管理→提交记录】，若该文章URL出现在列表中且状态为“成功”，则配置生效；若显示失败，检查Token是否正确、站点是否绑定、推送接口是否开启。

五、常见问题快速排查

1. 推送失败：确认Token无多余字符、站点已在熊掌号后台完成所有权验证； 2. 内容未触发推送：检查是否勾选自动推送选项、插件是否为最新版本； 3. 推送限额超限：调整推送频率为“每小时300条”，分批次推送内容； 4. 虚拟主机无法配置：仅需使用后台内置功能，无需服务器配置，测试时选择后台已发布的内容推送即可。