1. 홈
  2. 개발자
  3. .env 변환기

.env 변환기

.env, JSON, YAML, docker 환경 변수를 서로 변환합니다.

다른 형식·기능까지 한 번에 하려면 서버 설정 파일 생성기 →

내 브라우저에서 처리 · 업로드 없음
변환 결과
{ "NODE_ENV": "production", "PORT": "3000", "DATABASE_HOST": "db", "DATABASE_PORT": "5432", "LOG_LEVEL": "info", "GREETING": "hello world" }
운영 비밀값(비밀번호, 토큰, 키)은 이 화면에 붙여넣지 않는 것을 권장합니다. 공유할 파일은 값 비우기로 .env.example 을 만드세요.
변환 결과는 사용 전에 검토하세요. 형식마다 따옴표·이스케이프 규칙이 달라 의도와 다를 수 있습니다.

입력한 내용은 브라우저 안에서만 변환되며 서버로 전송되지 않습니다.

사용 방법

  1. 입력 형식(.env, JSON, YAML, docker run -e 옵션)을 고르고 내용을 붙여넣습니다. 처음에는 예시가 채워져 있어 바로 결과를 볼 수 있습니다.
  2. 출력 형식을 고릅니다. .env, JSON, YAML, docker run -e 옵션, docker --env-file 파일, compose environment(맵·목록), 셸 export 문이 있습니다.
  3. 필요하면 값 비우기, 정렬, 중첩 만들기, 자료형 변환 옵션을 켭니다.
  4. 결과를 복사하거나 형식에 맞는 파일 이름(.env, env.json, docker-run.sh 등)으로 내려받습니다. 같은 결과를 다시 입력으로 붙여넣으면 왕복 변환도 됩니다.

변환 예시

NODE_ENV=production, PORT=3000, GREETING="hello world" 를 형식별로 바꾸면 다음과 같습니다.

출력 형식 결과
JSON {"NODE_ENV": "production", "PORT": "3000", "GREETING": "hello world"} (값은 모두 문자열)
YAML PORT: "3000" 처럼 숫자처럼 보이는 값은 따옴표로 문자열을 유지
docker run -e NODE_ENV=production -e PORT=3000 -e GREETING='hello world' 를 줄마다 이어 붙인 명령
compose 맵 environment: 아래에 KEY: value
compose 목록 environment: 아래에 - KEY=value
export export GREETING='hello world'

형식별 규칙

  • .env 읽기: # 주석, export 접두사, 빈 값, 작은따옴표(글자 그대로), 큰따옴표(\n, \" 이스케이프), 여러 줄 큰따옴표 값을 지원합니다. 따옴표가 없는 값에서는 공백 뒤의 # 부터 주석으로 보고, a#b 는 그대로 둡니다. 같은 키가 여러 번 나오면 마지막 값만 남기고 알려 줍니다.
  • JSON·YAML 읽기: 중첩 객체와 배열은 DATABASE_HOST, TAGS_0 처럼 한 단계 키로 펼칩니다. 키에 쓸 수 없는 글자는 _ 로 바꾸고, 숫자·불리언·null 은 문자열(3000, true, 빈 값)로 바꿉니다. compose 의 environment: 블록이나 - KEY=VALUE 목록을 그대로 붙여 넣어도 읽습니다.
  • JSON·YAML 쓰기: 기본은 모든 값을 문자열로 씁니다. 자료형 변환 을 켜면 true, false, 3000 같은 값만 불리언·숫자로 바꾸고 007 처럼 앞에 0이 있는 값은 문자열로 둡니다. 중첩 만들기 를 켜면 DB__HOST=h 가 {"DB": {"HOST": "h"}} 가 됩니다. .NET 구성에서 쓰는 이중 밑줄 규칙과 같습니다.
  • docker –env-file: 이 형식은 따옴표를 풀지 않고 여러 줄 값도 지원하지 않습니다. 그래서 KEY=값 을 그대로 쓰고, 여러 줄 값은 건너뛰며 알려 줍니다. .env 형식과 구분해서 고르세요.
  • compose: compose 파일에서는 $ 가 변수 치환이므로, 값에 $ 가 있으면 $$ 로 바꿔 씁니다. 예를 들어 cost $5 는 cost $$5 가 됩니다.
  • 셸 인용: docker run 과 export 출력은 작은따옴표로 감싸고 값 안의 ' 는 '\'' 로 처리해서, 값에 공백·$·세미콜론이 있어도 명령으로 실행되지 않습니다. 셸 변수 이름 규칙(영문, 숫자, _)에 맞지 않는 키는 건너뜁니다.

값 비우기와 비밀값

  • 값 비우기를 켜면 모든 값이 빈 값이 되어 .env.example 로 쓸 수 있습니다. 저장소에 올리는 파일에는 실제 값을 넣지 말고 이 형태로 공유하세요.
  • 운영 비밀값(비밀번호, API 키, 토큰)은 변환 화면에도 붙여넣지 않는 것을 권장합니다. 이 도구는 브라우저 안에서만 동작하지만, 화면 캡처나 공유 과정에서 노출될 수 있습니다. 변환 결과는 사용 전에 검토하세요.
  • 변환한 .env 를 컨테이너에 쓸 때는 docker-compose 생성기로 .env.example 까지 포함한 compose 파일을, 이미지는 Dockerfile 생성기로 만들 수 있습니다. 호스트에서 서비스로 돌린다면 systemd 서비스 생성기의 EnvironmentFile 을 쓰고, YAML 구조를 확인하려면 JSON YAML 변환기, 두 .env 의 차이는 텍스트 비교로 볼 수 있습니다. JSON 정리는 JSON 포맷터를 쓰세요.

자주 묻는 질문

.env 의 따옴표는 언제 필요한가요?

공백, #, $ 가 든 값에는 따옴표를 쓰는 것이 안전합니다. 작은따옴표는 내용을 그대로 두고, 큰따옴표는 \n 같은 이스케이프를 해석합니다. 이 도구는 쓸 때 필요한 경우에만 작은따옴표를 붙입니다.

docker run 의 –env-file 과 compose 의 env_file 이 다른가요?

다릅니다. docker run --env-file 은 따옴표를 풀지 않고 값에 그대로 포함하지만, compose 의 .env 와 env_file 은 따옴표와 변수 치환을 해석합니다. 용도에 맞는 출력 형식을 고르세요.

JSON 으로 바꾸면 숫자가 문자열이 되나요?

환경 변수는 원래 문자열이므로 기본은 "3000" 입니다. 앱이 숫자 자료형을 기대하면 자료형 변환을 켜세요.

중첩된 JSON 을 환경 변수로 쓰려면요?

읽을 때 DATABASE_HOST 처럼 펼쳐 줍니다. 키를 대문자로 쓰려면 “키를 대문자로” 를 켜세요. 반대로 DB__HOST 를 중첩 JSON 으로 되돌리려면 “중첩 만들기” 를 쓰세요.

입력한 내용이 서버로 전송되나요?

아니요. 변환은 브라우저 안에서만 일어납니다.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.