.env을 JSON으로 변환하는 도구

.env 파일이란?

// Parse a .env file to a JSON object in Node.js using dotenv
import { parse } from 'dotenv';

const envText = `# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DEBUG=true`;

// dotenv.parse returns a plain object of string values
const parsed = parse(envText);

// Every value is a string, just like process.env
const json = JSON.stringify(parsed, null, 2);

console.log(json);
// {
//   "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
//   "DEBUG": "true"
// }

주요 기능

예제

# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DATABASE_POOL_SIZE=10

# Auth
JWT_SECRET="super secret value"
SESSION_TIMEOUT=3600

# Feature flags
ENABLE_SIGNUP=true
VITE_API_BASE=https://api.example.com

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "DATABASE_POOL_SIZE": "10",
  "JWT_SECRET": "super secret value",
  "SESSION_TIMEOUT": "3600",
  "ENABLE_SIGNUP": "true",
  "VITE_API_BASE": "https://api.example.com"
}

POSTGRES_DB=mydb
POSTGRES_USER=admin
POSTGRES_PASSWORD=s3cr3t!
PGDATA=/var/lib/postgresql/data
TZ=UTC
NGINX_HOST=example.com
NGINX_PORT=80

{
  "POSTGRES_DB": "mydb",
  "POSTGRES_USER": "admin",
  "POSTGRES_PASSWORD": "s3cr3t!",
  "PGDATA": "/var/lib/postgresql/data",
  "TZ": "UTC",
  "NGINX_HOST": "example.com",
  "NGINX_PORT": "80"
}

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_REGION=us-east-1
export DEPLOY_ENV=production

{
  "AWS_ACCESS_KEY_ID": "AKIAIOSFODNN7EXAMPLE",
  "AWS_SECRET_ACCESS_KEY": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "AWS_REGION": "us-east-1",
  "DEPLOY_ENV": "production"
}

APP_NAME=My App                 # unquoted value, inline comment stripped
GREETING="Hello,\nWorld"        # double quotes: \n becomes a real newline
LITERAL='no \n escapes here'    # single quotes: kept literally
PRIVATE_KEY="-----BEGIN KEY-----
line two
line three
-----END KEY-----"
EMPTY=

{
  "APP_NAME": "My App",
  "GREETING": "Hello,\nWorld",
  "LITERAL": "no \\n escapes here",
  "PRIVATE_KEY": "-----BEGIN KEY-----\nline two\nline three\n-----END KEY-----",
  "EMPTY": ""
}

사용 방법

1. 1

   .env 파일 붙여넣기

   위의 입력란에 .env 내용을 입력하거나 붙여넣으세요. '예제 불러오기'를 클릭해 Node/Vite .env, Docker Compose env 파일 또는 CI 시크릿 템플릿을 시험해 볼 수도 있습니다.

2. 2

   실시간 JSON 출력 확인

   JSON이 출력 패널에 즉시 나타납니다. 문자열 대신 숫자와 불리언을 원하면 '타입 추론'을 켜고, 2칸 또는 4칸 들여쓰기를 선택하세요.

3. 3

   복사 또는 다운로드

   복사를 눌러 JSON을 클립보드에 가져오거나, 다운로드를 눌러 .json 파일로 저장하세요 — 설정 로더, 시크릿 관리자 또는 JSON을 읽는 모든 도구에 바로 쓸 수 있습니다.

흔한 .env 함정

DATABASE_URL
DEBUG true

DATABASE_URL=
DEBUG=true

API_KEY = abc123

API_KEY=abc123

COLOR=#ff0000

COLOR="#ff0000"

GREETING='Hello\nWorld'

GREETING="Hello\nWorld"

KEY="-----BEGIN-----
line two

KEY="-----BEGIN-----
line two
-----END-----"

PORT=3000
PORT=8080

PORT=8080

일반적인 사용 사례

JSON 기반 도구에 설정 넣기

.env 파일을 JSON으로 변환해 환경 변수가 아닌 JSON을 읽는 도구, 스크립트, SDK에 환경 설정을 불러오세요 — 설정 검증기, 스키마 검사기, 코드 생성기 등.

관리자에 시크릿 가져오기

많은 시크릿 관리자(AWS Secrets Manager, Vault, Doppler)는 일괄 가져오기에 JSON을 받습니다. 먼저 .env 파일을 JSON 객체로 변환한 뒤, 변수를 하나씩이 아니라 전체 세트를 한 번에 푸시하세요.

긴 .env를 한눈에 살펴보기

방대한 .env 파일을 구조화되고 들여쓰기된 JSON으로 바꿔, 변경 사항을 커밋하기 전에 키를 훑어보고 경고로 중복을 발견하며 설정을 읽기 좋은 형식으로 검토하세요.

타입이 지정된 설정 객체 생성

타입 추론을 켜서 JSON에 숫자, 불리언, null을 얻은 다음, 타입이 지정된 설정 레이어나 JSON-to-TypeScript 단계에 넣어 환경 변수의 인터페이스를 도출하세요.

JSON 스키마로 검증

.env를 JSON으로 변환하고 JSON 스키마 검증기에 통과시켜 CI에서 필수 키, 값 형식, 허용 enum을 강제하세요 — 배포 전에 잘못 설정된 환경을 잡아냅니다.

Docker Compose env_file 설정 이전

Compose 스택이 읽는 env_file을 JSON으로 바꿔 다른 오케스트레이션 도구, 설정 서버 또는 문서에 사용하세요 — 실제 자격 증명을 외부 서비스에 노출하지 않고요.

기술 세부 정보

줄 단위 dotenv 호환 파싱

입력은 줄 단위로 파싱됩니다. 빈 줄과 주석 줄(공백이 아닌 첫 문자가 #)은 건너뛰고, 선택적 export 접두사는 제거되며, 나머지 각 줄은 첫 =에서 키와 값으로 분리됩니다. 키는 둘러싼 공백이 제거됩니다. 값은 dotenv 규칙을 따릅니다: 큰따옴표는 \n \t \r \\ \" 이스케이프를 처리하고 여러 줄 범위를 허용하며, 작은따옴표는 리터럴이고, 따옴표 없는 값은 뒤의 공백과 인라인 주석을 제거합니다.

선택적 타입 추론

기본적으로 모든 값은 JSON 문자열로 출력되며, process.env 값이 항상 문자열인 dotenv의 런타임 동작과 일치합니다. 타입 추론을 켜면 따옴표 없는 값이 승격됩니다: 숫자 문자열은 JSON 숫자가 되고, true/false는 불리언이 되며, 비어 있거나 null인 값은 JSON null이 됩니다. 따옴표가 붙은 값은 절대 추론되지 않습니다 — 따옴표가 명시적 문자열로 표시하기 때문입니다. 중복 키는 경고와 함께 마지막 값이 이기는 방식으로 해결됩니다.

브라우저 기반 — 업로드 없음, 서버 없음

모든 처리가 브라우저의 자바스크립트 엔진 안에서만 일어나며, .env 데이터가 어느 시점에도 네트워크로 전송되지 않습니다. 파서가 자체 제작되어 외부 의존성이 없습니다 — Node dotenv 라이브러리는 파일 시스템에 의존하므로 브라우저에서 안전하지 않습니다. 200KB를 초과하는 입력은 브라우저 응답성을 유지하기 위해 실시간 모드에서 수동 모드(명시적 변환 클릭)로 전환됩니다.

모범 사례

dotenv와 맞추려면 기본 문자열 출력을 유지하세요

dotenv는 모든 값을 문자열로 불러오므로, 기본 문자열 출력은 애플리케이션이 런타임에 보는 것을 정확히 반영합니다. 다운스트림 소비자가 진정으로 타입이 지정된 JSON을 기대할 때만 타입 추론을 켜세요 — 그렇지 않으면 '0'이나 'false'가 JSON에서 실행 중인 앱과 다르게 동작하는 불일치 위험이 있습니다.

# 또는 공백을 포함하는 값은 따옴표로 감싸세요

따옴표 없는 값에서는 공백 뒤에 #이 오면 인라인 주석이 시작되고 뒤의 공백이 제거됩니다. 값이 정당하게 #(16진수 색상, 프래그먼트 URL)이나 의미 있는 공백을 포함한다면 JSON에 그대로 보존되도록 큰따옴표로 감싸세요.

중복 키는 원본에서 해결하세요

도구는 마지막 값을 유지하고 키가 중복되면 경고하지만, .env 파일의 중복은 거의 항상 실수입니다. 어떤 시크릿이 활성인지 모호하지 않도록 불필요한 줄을 제거하세요.

프로덕션 시크릿을 서버 측 변환기에 절대 붙여넣지 마세요

.env 파일은 사실상 자격 증명 목록이므로, 전적으로 브라우저에서 실행되는 도구에서만 변환하세요. 이 변환기는 그렇게 합니다 — DevTools에서 네트워크 요청이 0건임을 확인하세요 — 따라서 서버 측이나 API 기반 변환기와 달리 실제 시크릿에도 안전합니다.

다운스트림에서 사용하기 전에 JSON을 검증하세요

변환한 후, JSON을 JSON 포맷터에 통과시켜 스키마 검증기, 시크릿 관리자 가져오기 또는 설정 로더에 넣기 전에 구조를 확인하세요. 그래야 구조적 문제가 일찍 드러납니다.

자주 묻는 질문