Choorai
KO EN

환경변수 기초

환경별 값을 코드 밖에서 관리하는 방법을 익히면 배포/보안 실수를 크게 줄일 수 있습니다.

핵심 구분

  • Build-time: 빌드 시점에 값이 코드에 주입
  • Runtime: 실행 중 서버 환경에서 값 조회
  • Secret: 키/토큰 같은 민감 정보 (절대 Git 커밋 금지)

OS별 환경변수 설정

터미널 세션에서 임시 설정 후, zsh 설정 파일에 영구 등록합니다.

# 임시
export VITE_API_URL="https://api.example.com"

# 영구 (zsh)
echo 'export VITE_API_URL="https://api.example.com"' >> ~/.zshrc
source ~/.zshrc
  • Vite는 VITE_ 접두사 변수만 클라이언트에서 읽습니다.

프로젝트 파일 구성 예시

.env 파일
# frontend (.env)
VITE_API_URL=https://api.example.com

# backend (.env)
DATABASE_URL=postgres://...
JWT_SECRET=change-me

Git에 올리면 안 되는 이유

.gitignore
# secrets
.env
.env.*
!.env.example

60분 챌린지 연결 지점

초심자 실수 TOP 3

  • .env를 Git에 커밋
  • 클라이언트 변수 접두사 규칙(VITE_) 누락
  • 로컬 변수와 배포 변수 값을 서로 다르게 유지

검증 체크리스트

  • 변수 변경 후 개발 서버 재시작
  • 배포 환경 대시보드의 변수명 오타 확인
  • 민감 값은 로그/에러메시지에 출력되지 않게 점검
  • 에러 발생 시 환경변수 트러블슈팅 확인

마지막 업데이트: 2026년 2월 22일 · 버전: v0.0.1

피드백 보내기

입력한 내용으로 새 이슈 페이지를 엽니다.

GitHub 이슈로 보내기