[출력결과]firebase 배포가이드

Fri, 02 Jan 2026 21:31:39 GMT

이 가이드는 firebase 명령어를 찾을 수 없거나, Firebase 배포를 처음 시도하는 분들을 위해 작성되었습니다.

1. 사전 준비 (필수)
1. 먼저 컴퓨터에 Node.js가 설치되어 있어야 합니다. 터미널에서 다음 명령어로 확인할 수 있습니다.

node -v

npm -v

버전 정보가 나오지 않는다면 Node.js 공식 홈페이지에서 LTS 버전을 설치해주세요.

1. Firebase CLI 설치
1. zsh: command not found: firebase 오류가 발생했다면, Firebase 명령 도구가 설치되지 않은 것입니다. 다음 명령어로 전역(Global) 설치를 진행하세요.

`npm install -g firebase-tools`

설치 중 권한 오류(EACCES)가 발생하면 sudo npm install -g firebase-tools를 입력하고 비밀번호를 입력하세요.

3. Firebase 로그인

설치가 완료되면, 다음 명령어로 로그인합니다.

`firebase login`

브라우저가 열리면 Google 계정으로 로그인하고 권한을 허용해주세요.

4. 프로젝트 빌드

배포하기 전에 현재 작성한 코드를 배포 가능한 형태(HTML/CSS/JS)로 변환해야 합니다.

`npm run build`

명령어가 성공하면 프로젝트 폴더 내에 dist 폴더가 생성됩니다. 이 폴더가 실제로 배포될 내용입니다.

5. 배포하기

이제 준비가 끝났습니다! 다음 명령어로 배포를 시작하세요.

`firebase deploy`` `

성공적으로 완료되면 터미널에 Hosting URL: https://... 주소가 표시됩니다. 해당 주소로 접속하면 배포된 웹사이트를 볼 수 있습니다.

팁: 자주 사용하는 명령어

firebase deploy --only hosting: 호스팅 부분만 빠르게 배포하고 싶을 때 사용합니다.

firebase feature:enable webframeworks: 만약 Vite나 Next.js 설정을 자동으로 감지하게 하려면 이 기능이 필요할 수 있습니다. (현재 프로젝트는 이미 수동 설정이 완료되어 있어 필수는 아닙니다)