ENV

환경변수 .env 정리/검사기

중복 키, 빈 값, 위험한 공개 변수명을 브라우저 안에서만 검사합니다.

.env 입력

서버 전송 없음

팀 공유용 템플릿은 모든 값을 비우고 키 이름만 저장합니다. 다운로드되는 env.example 파일을 프로젝트에서 .env.example로 이름을 바꿔 사용하세요.

정리된 .env

키 이름 기준 정렬

.env 파일을 배포 전에 한 번 더 확인하세요

환경변수 파일은 데이터베이스 주소, API 키, JWT 시크릿, OAuth 클라이언트 정보처럼 중요한 설정을 담습니다. 작은 오타 하나로 배포가 실패하거나, 공개 접두사에 민감한 키를 넣어 브라우저에 노출되는 문제가 생길 수 있습니다. 이 도구는 .env 파일을 서버로 보내지 않고 브라우저 안에서만 검사해 실수를 빠르게 줄여줍니다.

주요 검사 항목

안전한 사용 방식

실제 비밀값이 포함된 .env 파일은 외부 서비스에 붙여넣기 부담스럽습니다. Env Inspector는 입력한 내용을 네트워크로 전송하지 않고 현재 브라우저 탭에서만 파싱합니다. 그래도 운영 비밀값은 필요하면 일부 마스킹한 뒤 검사하는 습관을 추천합니다.

환경변수를 배포 전에 비교하는 방법

필수 키가 빠진 배포 찾기

예를 들어 앱이 DATABASE_URL, PORT, NODE_ENV를 요구한다면 위 필수 키 목록에 입력하세요. 변수명이 없는 경우와 선언은 있지만 값이 빈 경우를 구분해서 보여 줍니다. 실제 서비스 접속 정보 대신 샘플·치환 값으로 검사하는 것이 좋습니다.

값을 뺀 템플릿으로 팀에 공유하기

검사 후 .env.example 다운로드를 누르면 DATABASE_URL=처럼 모든 값이 제거됩니다. 키 이름은 유지되므로 팀원이 필요한 설정을 알 수 있지만 내부 프로젝트명 등이 키에 있다면 공유 전에 확인하세요. 원본 .env와 비밀값은 저장소에 커밋하지 마세요.

따옴표와 주석 예제

PORT=3000 # 개발 포트
LABEL="dev #1"
EMPTY=
export NODE_ENV=development

따옴표 밖의 # 뒤는 주석으로 취급하고, 따옴표 안의 #는 값으로 유지합니다. 정리본은 키를 정렬하고 주석과 export 접두사를 제거합니다. 닫히지 않은 따옴표·잘못된 키·중복 키가 있으면 복사를 중단합니다. 여러 줄 문자열, 변수 확장(${NAME}), 셸 명령 치환은 해석하지 않으며 로더별 문법이 다를 수 있습니다.

공개 접두사 경고 읽기

NEXT_PUBLIC_, VITE_, REACT_APP_, PUBLIC_는 프레임워크 설정에 따라 브라우저에 공개될 수 있습니다. SECRET/TOKEN/PASSWORD 같은 단어를 포함하면 경고하지만 모든 비밀값을 탐지하는 검사는 아닙니다. 공개 API 주소처럼 의도적으로 공개해도 되는 값인지 개발자가 판단해야 합니다.

검사 코드가 입력값을 검사 API나 로컬 저장소에 전송·저장하지 않습니다. 페이지에는 외부 광고 스크립트가 있으므로 운영 비밀은 마스킹한 사본을 권장합니다. Node.js .env 규격 · 오류 제보