Algolia 是一个托管型搜索平台，关于它的一些配置，使用与开发中注意事项的详细说明

约 703 字大约 2 分钟

Algolia

2025-07-06

让特定文章不进入搜索范围

在 VitePress 中，可以通过 Frontmatter 元数据标记结合 Algolia 爬虫规则，实现让特定文章不进入搜索范围。

方法 1：通过 Frontmatter 标记 + 爬虫过滤（推荐）

1. 在文章的 Markdown 头部添加 `noindex` 标记

markdown

---
title: 我的生活随笔
noindex: true  # 禁止被 Algolia 收录
---

因为VitePress不会自动加上 <meta property="noSearch" content="true">

// config.js
export default defineConfig({
  // ...existing code...
  vite: {
    // ...existing code...
  },
  // 自动为 noSearch: true 的页面添加 head
  transformPageData(pageData) {
    if (pageData.frontmatter.noSearch) {
      pageData.frontmatter.head = pageData.frontmatter.head || [];
      pageData.frontmatter.head.push([
        'meta',
        { property: 'noSearch', content: 'true' }
      ]);
    }
  }
});

2. 修改 Algolia 爬虫配置

在 Algolia 控制台的 Crawler 配置中，添加 selectors_exclude 规则：

actions: [
  {
    indexName: "yumeng",
    recordExtractor: ({ $, helpers }) => {
      // 如果 Frontmatter 包含 noindex: true，跳过该页面
      if ($('meta[property="noSearch"]').length > 0) {
        return [];
      }
      return helpers.docsearch({
        // 原有配置...
      });
    }
  }
]

方法 2：通过 HTML 元标签（无需修改爬虫）

在 VitePress 的 Frontmatter 中直接生成 <meta> 标签：

---
head:
  - [meta, { name: "robots", content: "noindex, nofollow" }]
---

Algolia 爬虫会自动忽略带有 noindex 的页面（这是搜索引擎通用规范）。

方法 3：通过文件路径排除

1. 将不想被搜索的文章放在特定目录

例如：

docs/
  tech/       # 技术文章
  life/       # 生活随笔（不搜索）

2. 修改爬虫配置的 `discoveryPatterns`

discoveryPatterns: [
  "https://yumeng.icu/tech/**",  // 只爬取技术目录
  "!https://yumeng.icu/life/**"  // 排除生活目录
]

验证是否生效

在 Algolia 控制台的 Indices 中检查记录数量。
尝试搜索被标记的文章标题，确认是否无结果。

各方案对比

方案	优点	缺点
Frontmatter 标记	精准控制单篇文章	需调整爬虫配置
HTML 元标签	无需改爬虫，通用性强	依赖爬虫遵守 robots 规则
路径排除	批量管理方便	不够灵活

推荐 方法1+方法2 组合使用，双重保障。

我的Algolia配置

new Crawler({
  appId: "*************",
  apiKey: "*****************************************",
  maxUrls: 5000,
  indexPrefix: "",
  rateLimit: 8,
  renderJavaScript: false,
  startUrls: ["https://yumeng.icu"],
  discoveryPatterns: ["https://yumeng.icu/**"],
  schedule: "at 14:33 on Monday",
  maxDepth: 10,
  actions: [
    {
      indexName: "yumeng",
      pathsToMatch: ["https://yumeng.icu/**"],
      recordExtractor: ({ $, helpers }) => {
        return helpers.docsearch({
          recordProps: {
            lvl1: ".content h1",
            content: ".content p, .content li",
            lvl0: {
              selectors: "",
              defaultValue: "Documentation",
            },
            lvl2: ".content h2",
            lvl3: ".content h3",
            lvl4: ".content h4",
            lvl5: ".content h5",
          },
          aggregateContent: true,
          recordVersion: "v3",
        });
      },
    },
  ],
  sitemaps: ["https://yumeng.icu/sitemap.xml"],
  initialIndexSettings: {
    yumeng: {
      advancedSyntax: true,
      allowTyposOnNumericTokens: false,
      attributeCriteriaComputedByMinProximity: true,
      attributeForDistinct: "url",
      attributesForFaceting: ["type", "lang"],
      attributesToHighlight: ["hierarchy", "hierarchy_camel", "content"],
      attributesToRetrieve: [
        "hierarchy",
        "content",
        "anchor",
        "url",
        "url_without_anchor",
        "type",
      ],
      attributesToSnippet: ["content:10"],
      camelCaseAttributes: ["hierarchy", "hierarchy_radio", "content"],
      customRanking: [
        "desc(weight.pageRank)",
        "desc(weight.level)",
        "asc(weight.position)",
      ],
      distinct: 1,
      highlightPostTag: "</span>",
      highlightPreTag: '<span class="algolia-docsearch-suggestion--highlight">',
      ignorePlurals: true,
      minProximity: 1,
      minWordSizefor1Typo: 3,
      minWordSizefor2Typos: 7,
      ranking: [
        "words",
        "filters",
        "typo",
        "attribute",
        "proximity",
        "exact",
        "custom",
      ],
      removeWordsIfNoResults: "allOptional",
      searchableAttributes: [
        "unordered(hierarchy_radio_camel.lvl0)",
        "unordered(hierarchy_radio.lvl0)",
        "unordered(hierarchy_radio_camel.lvl1)",
        "unordered(hierarchy_radio.lvl1)",
        "unordered(hierarchy_radio_camel.lvl2)",
        "unordered(hierarchy_radio.lvl2)",
        "unordered(hierarchy_radio_camel.lvl3)",
        "unordered(hierarchy_radio.lvl3)",
        "unordered(hierarchy_radio_camel.lvl4)",
        "unordered(hierarchy_radio.lvl4)",
        "unordered(hierarchy_radio_camel.lvl5)",
        "unordered(hierarchy_radio.lvl5)",
        "unordered(hierarchy_radio_camel.lvl6)",
        "unordered(hierarchy_radio.lvl6)",
        "unordered(hierarchy_camel.lvl0)",
        "unordered(hierarchy.lvl0)",
        "unordered(hierarchy_camel.lvl1)",
        "unordered(hierarchy.lvl1)",
        "unordered(hierarchy_camel.lvl2)",
        "unordered(hierarchy.lvl2)",
        "unordered(hierarchy_camel.lvl3)",
        "unordered(hierarchy.lvl3)",
        "unordered(hierarchy_camel.lvl4)",
        "unordered(hierarchy.lvl4)",
        "unordered(hierarchy_camel.lvl5)",
        "unordered(hierarchy.lvl5)",
        "unordered(hierarchy_camel.lvl6)",
        "unordered(hierarchy.lvl6)",
        "content",
      ],
    },
  },
  ignoreCanonicalTo: true,
  safetyChecks: { beforeIndexPublishing: { maxLostRecordsPercentage: 10 } },
});