basePath

도메인의 하위 경로에 Next.js 애플리케이션을 배포하려면 basePath 설정 옵션을 사용할 수 있습니다.

basePath를 사용하면 애플리케이션에 경로 접두사를 설정할 수 있습니다. 예를 들어, ''(빈 문자열, 기본값) 대신 /docs를 사용하려면 next.config.js를 열고 basePath 설정을 추가하세요:

next.config.js

module.exports = {
  basePath: "/docs",
};

알아두면 좋은 점: 이 값은 빌드 시 설정되어야 하며 클라이언트 측 번들에 인라인으로 포함되므로 다시 빌드하지 않고는 변경할 수 없습니다.

링크

next/link와 next/router를 사용하여 다른 페이지로 링크할 때 basePath가 자동으로 적용됩니다.

예를 들어, basePath가 /docs로 설정되어 있을 때 /about을 사용하면 자동으로 /docs/about이 됩니다.

export default function HomePage() {
  return (
    <>
      <Link href="/about">About Page</Link>
    </>
  );
}

출력된 html:

<a href="/docs/about">About Page</a>

이렇게 하면 basePath 값을 변경할 때 애플리케이션의 모든 링크를 변경할 필요가 없습니다.

이미지

next/image 컴포넌트를 사용할 때는 src 앞에 basePath를 추가해야 합니다.

예를 들어, basePath가 /docs로 설정되어 있을 때 /docs/me.png를 사용하면 이미지가 올바르게 제공됩니다.

import Image from "next/image";
 
function Home() {
  return (
    <>
      <h1>My Homepage</h1>
      <Image
        src="/docs/me.png"
        alt="Picture of the author"
        width={500}
        height={500}
      />
      <p>Welcome to my homepage!</p>
    </>
  );
}
 
export default Home;

assetPrefix compress