robots.txt

app 目錄的根目錄中新增或生成符合 Robots 排除標準robots.txt 檔案,用於告知搜尋引擎爬蟲可以存取您網站上的哪些 URL。

靜態 robots.txt

app/robots.txt
User-Agent: *
Allow: /
Disallow: /private/

Sitemap: https://acme.com/sitemap.xml

生成 Robots 檔案

新增一個 robots.jsrobots.ts 檔案,並返回一個 Robots 物件

須知robots.js 是一種特殊的路由處理器 (Route Handlers),預設會被快取,除非它使用了 動態 API動態設定 選項。

import type { MetadataRoute } from 'next'

export default function robots(): MetadataRoute.Robots {
  return {
    rules: {
      userAgent: '*',
      allow: '/',
      disallow: '/private/',
    },
    sitemap: 'https://acme.com/sitemap.xml',
  }
}

輸出:

User-Agent: *
Allow: /
Disallow: /private/

Sitemap: https://acme.com/sitemap.xml

自訂特定使用者代理

您可以透過將使用者代理陣列傳遞給 rules 屬性,來客製化個別搜尋引擎機器人如何爬取您的網站。例如:

import type { MetadataRoute } from 'next'

export default function robots(): MetadataRoute.Robots {
  return {
    rules: [
      {
        userAgent: 'Googlebot',
        allow: ['/'],
        disallow: '/private/',
      },
      {
        userAgent: ['Applebot', 'Bingbot'],
        disallow: ['/'],
      },
    ],
    sitemap: 'https://acme.com/sitemap.xml',
  }
}

輸出:

User-Agent: Googlebot
Allow: /
Disallow: /private/

User-Agent: Applebot
Disallow: /

User-Agent: Bingbot
Disallow: /

Sitemap: https://acme.com/sitemap.xml

Robots 物件

type Robots = {
  rules:
    | {
        userAgent?: string | string[]
        allow?: string | string[]
        disallow?: string | string[]
        crawlDelay?: number
      }
    | Array<{
        userAgent: string | string[]
        allow?: string | string[]
        disallow?: string | string[]
        crawlDelay?: number
      }>
  sitemap?: string | string[]
  host?: string
}

版本歷史

版本變更內容
v13.3.0新增 robots 功能。

On this page