Hexo设置百度主动推送

前言

对于使用Hexo搭建的静态博客来说，让百度搜索引擎快速收录文章始终是个值得关注的问题。相比被动等待爬虫抓取，百度站长平台提供的主动推送接口能显著加快收录速度，提升SEO效果。然而Hexo默认并未集成这一功能，许多开发者在部署推送机制时常常会遇到：

常见痛点

链接维护低效：手动整理文章URL耗时易错
接口调用限制：百度API的每日配额管理
路径差异问题：本地调试与生产环境路径不一致

本文将详细介绍如何通过自动化脚本+百度API的方式，实现Hexo博客的「发布即推送」功能。方案采用Node.js编写推送脚本，完美适配Hexo的生成部署流程，同时包含以下特色功能：

方案优势

✅ 智能链接去重：自动过滤已推送记录 🚀 增量更新机制：仅处理最新变更 🌐 多环境适配：自动识别GitHub Pages/VPS等部署环境 🔄 失败重试策略：网络异常自动重试3次

🛠 实现百度主动推送

{% tabs 推送方式,2 %}

graph TD
    A[Hexo生成静态文件] --> B[提取新文章URL]
    B --> C{是否生产环境?}
    C -->|是| D[调用百度API推送]
    C -->|否| E[记录到本地文件]
    D --> F[返回推送结果]

{% note warning modern %}

⚠️ 安全提示

永远不要将token提交到公开仓库
建议将_config.yml添加到.gitignore
使用环境变量存储敏感信息 {% endnote %}

# 手动触发推送
hexo deploy --generate

{% note info modern %} 当需要立即推送时，可使用此命令强制触发推送流程 {% endnote %}

{% endtabs %}

步骤1：安装推送插件

npm install [email protected] --save

{% note success no-icon %} ✔️ 版本锁定：2.0.3稳定版 ✔️ 依赖检查：自动安装node-fetch和chalk {% endnote %}

步骤2：配置推送参数

# 百度主动推送配置
baidu_url_submit:
  count: 500 # 最大推送数量
  host: "blog.yourdomain.com" # 已验证的域名
  token: "your_secure_token" # 站长平台获取
  path: ./baidu_urls.txt # 文本文档的地址， 新链接会保存在此文本文档里，这个默认

配置说明详解：

百度推送Token获取

访问百度站长平台
导航至「普通收录」->「接口调用地址」
在接口地址中找到token=后的字符串
复制该token值到配置文件

步骤3：部署配置优化

deploy:
  - type: 'git'
    repo: [email protected]:xxx
    branch: master
  - type: baidu_url_submitter

步骤4：验证推送结果

hexo clean && hexo deploy --debug

{% note success modern %} ✅ 成功输出示例：

INFO  Deploying: baidu_url_submitter
INFO  Submitting urls
......
{"remain":100,"success":100}
INFO  Deploy done: baidu_url_submitter

后续验证步骤：

登录百度站长平台
进入「普通收录」->「提交记录」
查看「主动推送」标签页
确认最新推送时间和数量匹配 {% endnote %}

{% note danger modern %} ❌ 失败处理建议：

检查网络连接：ping ziyuan.baidu.com
验证token有效性
使用hexo --debug模式排查
检查防火墙设置是否阻止API请求 {% endnote %}

主要参考：

《Hexo博客设置百度主动推送》