Vercel 는 앱을 빌드하고 배포하며 확장할 수 있는 클라우드 플랫폼입니다.

NOTE

`Bun.serve` 는 현재 Vercel Functions 에서 지원되지 않습니다. Next.js Express Hono 또는 Nitro 와 같이 Vercel 이 지원하는 프레임워크와 함께 Bun 을 사용하세요.

---

vercel.json 에서 Bun 구성하기

함수에 Bun 런타임을 활성화하려면 vercel.json 파일에 bunVersion 필드를 추가합니다:

{
	"bunVersion": "1.x"
}

Vercel 은 이 구성을 자동으로 감지하고 Bun 에서 애플리케이션을 실행합니다. 값은 "1.x" 여야 하며 Vercel 이 내부적으로 마이너 버전을 처리합니다.

최상의 결과를 얻으려면 로컬 Bun 버전을 Vercel 에서 사용하는 버전과 일치시키세요.

Next.js 구성

Next.js 프로젝트 (ISR 포함) 를 배포하는 경우 package.json 스크립트를 업데이트하여 Bun 런타임을 사용하도록 합니다:

{
	"scripts": {
		"dev": "bun --bun next dev", 
		"build": "bun --bun next build"
	}
}

NOTE

`--bun` 플래그는 Bun 에서 Next.js CLI 를 실행합니다. 번들링 (Turbopack 또는 Webpack 을 통해) 은 변경되지 않지만 모든 명령은 Bun 런타임 내에서 실행됩니다.

이렇게 하면 로컬 개발과 빌드 모두 Bun 을 사용합니다.

앱 배포하기

저장소를 Vercel 에 연결하거나 CLI 에서 배포합니다:

# bunx 사용 (전역 설치 불필요)
bunx vercel login
bunx vercel deploy

또는 Vercel CLI 를 전역으로 설치합니다:

bun i -g vercel
vercel login
vercel deploy

Vercel Deploy CLI 문서에서 자세히 알아보기 →

런타임 확인하기

배포가 Bun 을 사용하는지 확인하려면 Bun 버전을 로그합니다:

console.log("runtime", process.versions.bun);

runtime 1.3.3

Vercel Bun 런타임 문서에서 기능 지원 확인하기 →

---

• Fluid compute: Bun 과 Node.js 런타임 모두 Fluid compute 에서 실행되며 동일한 핵심 Vercel Functions 기능을 지원합니다.
• Middleware: Bun 으로 Routing Middleware 를 실행하려면 런타임을 nodejs 로 설정합니다:

export const config = { runtime: "nodejs" };