next.config.js: htmlLimitedBots

next.config.js: htmlLimitedBots | Next.js

출처 URL: https://nextjs.org/docs/app/api-reference/config/next-config-js/htmlLimitedBots

htmlLimitedBots

최종 업데이트 2026년 2월 20일

htmlLimitedBots 구성은 스트리밍 메타데이터 대신 차단 메타데이터를 받아야 하는 사용자 에이전트 목록을 지정할 수 있도록 합니다.

next.config.ts

JavaScriptTypeScript

    import type { NextConfig } from 'next'

    const config: NextConfig = {
      htmlLimitedBots: /MySpecialBot|MyAnotherSpecialBot|SimpleCrawler/,
    }

    export default config

기본 목록

Next.js에는 다음을 포함한 기본 HTML 제한 봇 목록이 포함되어 있습니다:

• Google 크롤러(예: Mediapartners-Google, AdsBot-Google, Google-PageRenderer)
• Bingbot
• Twitterbot
• Slackbot

전체 목록은 여기에서 확인하세요.

htmlLimitedBots 구성을 지정하면 Next.js의 기본 목록을 덮어씁니다. 다만 이는 고급 동작이며 대부분의 경우 기본값이면 충분합니다.

next.config.ts

JavaScriptTypeScript

    const config: NextConfig = {
      htmlLimitedBots: /MySpecialBot|MyAnotherSpecialBot|SimpleCrawler/,
    }

    export default config

비활성화

스트리밍 메타데이터를 완전히 비활성화하려면:

next.config.ts

    import type { NextConfig } from 'next'

    const config: NextConfig = {
      htmlLimitedBots: /.*/,
    }

    export default config

버전 기록

버전	변경 사항
15.2.0	htmlLimitedBots 옵션 도입.