Astro 博客配置 IndexNow

769 字

4 分钟

Astro 博客配置 IndexNow

2026-08-28

2026-09-11

博客

Bing

/

Astro

前言#

Bing 有个功能，叫 IndexNow，我们可以使用这个功能让 Bing 更快知道我们的网站更新，并更新索引。那么，如何在 Astro 博客配置 IndexNow？

本文参考

为Astro添加IndexNow - Arcwolf Blog

为 Astro 添加 IndexNow，提高搜索引擎收录速度

编写。原作者为 Arcwolf，原文章采用 CC BY-NC-SA 4.0 协议。

配置方法#

1. 安装插件#

非常简单，没什么好说的。

1
npm install astro-indexnow --save

1
pnpm add astro-indexnow

1
yarn add astro-indexnow

2. 获取 IndexNow API 密钥#

打开 Bing IndexNow 页面，滑到底部，点击 Get Started，继续滑到底部，找到 Generate API Key，下面的一串很长的字符就是 API 密钥。

获取 API 密钥

记住他，复制下来。

3. 托管 API 密钥#

在项目的 public 目录下新建一个与你的密钥同名的 txt 文件，并写入你的密钥到文件中。如：

假设你的密钥为 123456

那么文件则为：

1
123456

如果项目需要上传至 GitHub 且使用 GitHub Pages 部署，可先暂时跳过此步骤，参考第 5 步，以实现不泄漏密钥。

4. 设置插件#

在 astro.config.mjs 添加下列代码：

1
import { defineConfig } from "astro/config";
2
import indexnow from "astro-indexnow";
3

4
export default defineConfig({
5
  site: "https://example.com",
6
  integrations: [
7
    indexnow({
8
      key: process.env.INDEXNOW_KEY,
9
    }),
10
  ],
11
});

如果想要根据是否存在环境变量判断是否启用插件，可以像我一样使用条件展开。

1
import { defineConfig } from "astro/config";
2
import indexnow from "astro-indexnow";
3

4
export default defineConfig({
5
  site: "https://example.com",
6
  integrations: [
7
    ...(process.env.INDEXNOW_KEY ? [indexnow({ key: process.env.INDEXNOW_KEY })] : []),
8
  ],
9
});

该方法不一定稳定，但能用。

配置完成后，配置 .env 环境变量以进行本地调试。

1
INDEXNOW_KEY=你的API密钥
2
INDEXNOW_ENDPOINT=https://api.indexnow.org/indexnow

如果不想公开密钥，那么千万不要把这个 .env 文件上传。

TIP
如果你使用的是Git部署，记得提交 .astro-indexnow-cache.json 文件。

5. 配置环境变量#

一般云平台#

直接在云平台的环境变量配置页面添加下面的变量即可。

1
INDEXNOW_KEY=你的API密钥
2
INDEXNOW_ENDPOINT=https://api.indexnow.org/indexnow

GitHub Pages#

对于使用 GitHub Actions 部署的 GitHub Pages，需要在 Actions 的配置文件添加一些内容。

假设你的配置文件名为 deploy.yml，那么你需要在 deploy.yml 添加以下内容：

在 pnpm build 操作前添加：

1
- name: Create IndexNow key file
2
        run: echo "${{ secrets.INDEXNOW_KEY }}" > public/${{ secrets.INDEXNOW_KEY }}.txt

以生成第 3 步中的文件。

同时，你需要在 pnpm build 操作添加：

1
- name: Build site
2
        env:
3
          INDEXNOW_KEY: ${{ secrets.INDEXNOW_KEY }}
4
          INDEXNOW_ENDPOINT: ${{ secrets.INDEXNOW_ENDPOINT }}
5
        run: pnpm build

并打开 GitHub 项目，选择 Settings > Secrets and variables > Actions > Secrets，添加上面的变量：

1
INDEXNOW_KEY=你的API密钥
2
INDEXNOW_ENDPOINT=https://api.indexnow.org/indexnow

最后执行部署操作。

检查#

不出意外的话，你应该能在构建日志中看到类似这些：

1
07:55:43 [astro-indexnow] submitting 15 URL(s) in 1 batch(es) [mode=changed, batchSize=10000]
2
07:55:43 [astro-indexnow] summary: scanned=15, changed=15, batched=1, submitted=15
3
07:55:43 [astro-indexnow] IndexNow submission complete

接着再前往 Bing Webmaster Tools 检查有没有刚刚提交的 url。

恭喜你，成功了！