Конвертер .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 в поле ввода выше. Можно также нажать «Загрузить пример», чтобы попробовать .env для Node/Vite, env-файл Docker Compose или шаблон 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, чтобы загрузить конфигурацию окружения в инструменты, скрипты и SDK, которые читают JSON, а не переменные окружения — валидаторы конфигурации, проверки по схеме и генераторы кода.

Импорт секретов в менеджер

Многие менеджеры секретов (AWS Secrets Manager, Vault, Doppler) принимают JSON для массового импорта. Сначала преобразуйте файл .env в объект JSON, затем загрузите весь набор за одну операцию вместо переменной за переменной.

Беглый осмотр длинного .env

Превратите разросшийся файл .env в структурированный JSON с отступами, чтобы просматривать ключи, замечать дубликаты по предупреждению и проверять конфигурацию в читаемом формате перед фиксацией изменений.

Генерация типизированных объектов конфигурации

Включите «Определять типы», чтобы получить в JSON числа, логические значения и null, затем передайте его в типизированный слой конфигурации или на шаг JSON-to-TypeScript, чтобы вывести интерфейс для ваших переменных окружения.

Проверка по JSON Schema

Преобразуйте .env в JSON и прогоните его через валидатор JSON Schema, чтобы обеспечить обязательные ключи, форматы значений и допустимые перечисления в CI — отлавливая неправильно настроенные окружения до деплоя.

Миграция конфигурации env_file Docker Compose

Превратите env_file, который читает ваш стек Compose, в JSON для использования в другом инструменте оркестрации, сервере конфигурации или документации — не раскрывая реальные учётные данные ни одному внешнему сервису.

Технические детали

Построчный разбор, совместимый с dotenv

Ввод разбирается строка за строкой. Пустые строки и строки-комментарии (первый непробельный символ #) пропускаются, необязательный префикс export удаляется, а каждая оставшаяся строка разделяется по первому = на ключ и значение. У ключей обрезаются окружающие пробелы. Значения следуют правилам dotenv: двойные кавычки обрабатывают экранирование \n \t \r \\ \" и допускают многострочные диапазоны, одинарные кавычки буквальны, а значения без кавычек удаляют завершающие пробелы и встроенные комментарии.

Необязательное определение типов

По умолчанию все значения выводятся как строки JSON, что соответствует поведению dotenv во время выполнения, где значения process.env всегда строки. При включённом «Определять типы» значения без кавычек повышаются: числовые строки становятся числами JSON, true/false становятся логическими значениями, а пустые или null-значения становятся JSON null. Значения в кавычках никогда не приводятся к типу — кавычки помечают их как явные строки. Дублирующиеся ключи разрешаются по правилу «побеждает последний» с предупреждением.

На стороне браузера — без загрузки, без сервера

Вся обработка происходит целиком в движке JavaScript вашего браузера; данные .env ни в какой момент не передаются по сети. Внешних зависимостей нет, потому что парсер написан внутри проекта — библиотека Node dotenv опирается на файловую систему и небезопасна для браузера. Ввод размером более 200 КБ переключается из живого режима в ручной (явное нажатие «Преобразовать»), чтобы сохранить отзывчивость браузера.

Лучшие практики

Оставляйте строковый вывод по умолчанию, чтобы соответствовать dotenv

dotenv загружает каждое значение как строку, поэтому строковый вывод по умолчанию отражает в точности то, что видит приложение во время выполнения. Включайте «Определять типы» только тогда, когда последующий потребитель действительно ожидает типизированный JSON — иначе вы рискуете несоответствием, при котором '0' или 'false' ведут себя в JSON иначе, чем в работающем приложении.

Заключайте в кавычки значения, содержащие # или пробелы

В значениях без кавычек пробел, за которым следует #, начинает встроенный комментарий, а завершающие пробелы обрезаются. Если значение законно содержит # (hex-цвета, URL с фрагментом) или значимые пробелы, заключите его в двойные кавычки, чтобы оно сохранилось в JSON дословно.

Разрешайте дублирующиеся ключи в источнике

Инструмент сохраняет последнее значение и предупреждает вас при дублировании ключа, но дубликат в файле .env почти всегда является ошибкой. Уберите лишнюю строку, чтобы не было неоднозначности относительно того, какой секрет активен.

Никогда не вставляйте продакшен-секреты в серверные конвертеры

Поскольку файл .env фактически является списком учётных данных, преобразуйте его только в инструменте, который работает целиком в браузере. Этот конвертер именно таков — проверьте отсутствие сетевых запросов в DevTools — поэтому он безопасен для реальных секретов, в отличие от серверных или API-конвертеров.

Проверяйте JSON перед использованием далее

После преобразования прогоните JSON через форматировщик JSON, чтобы подтвердить структуру перед передачей в валидатор схемы, импортом в менеджер секретов или загрузчиком конфигурации, чтобы структурный сюрприз всплыл рано.

Часто задаваемые вопросы