Guide

환경변수 관리

사이트 동작에 필요한 숨겨진 보안 설정과 옵션을 제어하는 Vercel 환경변수에 대해 알아봅니다.

Vercel 환경변수(Environment Variables) 수정 가이드

// i18n-ignore

환경변수는 노출되면 안 되는 API 통신용 키값이나, 사이트 전역의 시스템 옵션을 관리하는 "비밀 금고"와 같습니다. ZeroPack은 배포를 용이하게 하기 위해 최초 론칭 시 기본 환경을 자동으로 매핑해 드립니다.

// i18n-ignore

# 자동 설정된 변수들 확인하기

// i18n-ignore

1. vercel.com 프로젝트 설정창에서 Settings > Environment Variables 로 이동합니다.

// i18n-ignore

2. 아래의 4가지 주요 환경 변수를 보실 수 있습니다.

// i18n-ignore

- DEPLOY_LANGUAGE: 앱의 뼈대 언어를 세팅합니다 (ko 또는 en)

// i18n-ignore

- NEXT_PUBLIC_SITE_URL: 도메인 주소 (공유 및 SEO 로직에 사용됨)

// i18n-ignore

- NEXT_PUBLIC_WEB3FORMS_KEY: 메뉴의 'Contact' 폼 작동에 연결된 키

// i18n-ignore

- NEXT_PUBLIC_RECAPTCHA_SITE_KEY: 스팸 로봇 방어를 위한 구글 리캡챠 키

// i18n-ignore

# 시스템 언어나 키를 임의로 갱신해야 할 때

// i18n-ignore

1. 해당 변수 블록의 우측 점 세개 아이콘을 누르고 Edit 을 클릭합니다.

// i18n-ignore

2. Value 입력창의 텍스트를 원하는 값으로 수정한 뒤 Save를 누릅니다.

// i18n-ignore

3. 📛 중요: 환경변수는 배포 과정에서 앱 속으로 "구워"집니다. 즉 값을 번경하셨다면 Vercel 상단 Deployments 메뉴로 이동한 뒤 최상단 배포 행의 우측 끝에 있는 Redeploy 명령을 내려 서버를 재가동 시키셔야 실제 사용자들에게 변경 로그가 전파됩니다.

// i18n-ignore

© 2026 ZeroPack. All rights reserved.
Updated just now