Konwerter .env na JSON

Czym jest plik .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"
// }

Kluczowe funkcje

Przykłady

# 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": ""
}

Jak używać

1. 1

   Wklej swój plik .env

   Wprowadź lub wklej zawartość .env do pola wejściowego powyżej. Możesz też kliknąć „Wczytaj przykład”, aby wypróbować .env dla Node/Vite, plik env Docker Compose lub szablon sekretów CI.

2. 2

   Zobacz wynik JSON na żywo

   JSON pojawia się natychmiast w panelu wynikowym. Przełącz „Wnioskuj typy”, jeśli chcesz liczby i wartości logiczne zamiast ciągów znaków, i wybierz wcięcie 2 lub 4 spacji.

3. 3

   Kopiuj lub pobierz

   Kliknij Kopiuj, aby pobrać JSON do schowka, lub Pobierz, aby zapisać go jako plik .json — gotowy dla loadera konfiguracji, menedżera sekretów lub dowolnego narzędzia, które czyta JSON.

Częste pułapki .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

Typowe zastosowania

Podawanie konfiguracji do narzędzi opartych na JSON

Przekonwertuj plik .env na JSON, aby załadować konfigurację środowiska do narzędzi, skryptów i SDK, które czytają JSON zamiast zmiennych środowiskowych — walidatorów konfiguracji, sprawdzaczy schematów i generatorów kodu.

Import sekretów do menedżera

Wiele menedżerów sekretów (AWS Secrets Manager, Vault, Doppler) przyjmuje JSON do importu zbiorczego. Najpierw przekonwertuj plik .env na obiekt JSON, a potem wgraj cały zestaw w jednej operacji zamiast jednej zmiennej naraz.

Obejrzyj długi .env w jednym spojrzeniu

Zamień rozległy plik .env w strukturalny, wcięty JSON, abyś mógł przejrzeć klucze, wypatrzyć duplikaty dzięki ostrzeżeniu i przeanalizować konfigurację w czytelnym formacie przed zatwierdzeniem zmian.

Generowanie typowanych obiektów konfiguracji

Włącz „Wnioskuj typy”, aby uzyskać liczby, wartości logiczne i null w JSON, a następnie podaj go do typowanej warstwy konfiguracji lub kroku JSON na TypeScript, aby wyprowadzić interfejs dla zmiennych środowiskowych.

Walidacja względem schematu JSON

Przekonwertuj .env na JSON i przepuść go przez walidator schematu JSON, aby wymusić wymagane klucze, formaty wartości i dozwolone wyliczenia w CI — wyłapując źle skonfigurowane środowiska przed wdrożeniem.

Migracja konfiguracji env_file Docker Compose

Zamień plik env_file, który czyta Twój stos Compose, na JSON do użycia w innym narzędziu do orkiestracji, serwerze konfiguracji lub dokumentacji — bez ujawniania prawdziwych poświadczeń żadnej usłudze zewnętrznej.

Szczegóły techniczne

Parsowanie linia po linii zgodne z dotenv

Dane wejściowe są parsowane linia po linii. Puste linie i linie komentarzy (pierwszy znak niebędący białym znakiem #) są pomijane, opcjonalny prefiks export jest usuwany, a każda pozostała linia jest dzielona na pierwszym znaku = na klucz i wartość. Klucze są przycinane z otaczających białych znaków. Wartości podążają za regułami dotenv: podwójne cudzysłowy przetwarzają sekwencje ucieczki \n \t \r \\ \" i pozwalają na rozpiętości wieloliniowe, pojedyncze cudzysłowy są dosłowne, a wartości bez cudzysłowów usuwają końcowe białe znaki i komentarze inline.

Opcjonalne wnioskowanie typów

Domyślnie wszystkie wartości są emitowane jako ciągi znaków JSON, co odpowiada zachowaniu dotenv w czasie działania, gdzie wartości process.env są zawsze ciągami znaków. Po włączeniu opcji „Wnioskuj typy” wartości bez cudzysłowów są promowane: ciągi numeryczne stają się liczbami JSON, true/false stają się wartościami logicznymi, a puste lub null wartości stają się null w JSON. Wartości w cudzysłowach nigdy nie podlegają wnioskowaniu — cudzysłowy oznaczają je jako jawne ciągi znaków. Zduplikowane klucze rozwiązują się z wygraną ostatniego, z ostrzeżeniem.

Po stronie przeglądarki — bez wysyłania, bez serwera

Całe przetwarzanie odbywa się w całości w silniku JavaScript Twojej przeglądarki; żadne dane .env nie są w żadnym momencie przesyłane przez sieć. Nie ma zależności zewnętrznych, ponieważ parser jest napisany we własnym zakresie — biblioteka Node dotenv polega na systemie plików i nie jest bezpieczna dla przeglądarki. Dane wejściowe większe niż 200 KB przełączają się z trybu na żywo w tryb ręczny (jawne kliknięcie Konwertuj), aby przeglądarka pozostała responsywna.

Najlepsze praktyki

Zachowaj domyślny wynik tekstowy, aby dopasować się do dotenv

dotenv ładuje każdą wartość jako ciąg znaków, więc domyślny wynik tekstowy odzwierciedla dokładnie to, co Twoja aplikacja widzi w czasie działania. Włączaj „Wnioskuj typy” tylko wtedy, gdy odbiorca w dalszej części potoku rzeczywiście oczekuje typowanego JSON — w przeciwnym razie ryzykujesz niezgodność, w której '0' lub 'false' zachowuje się inaczej w JSON niż w Twojej działającej aplikacji.

Ujmuj w cudzysłowy wartości zawierające # lub białe znaki

W wartościach bez cudzysłowów spacja, po której następuje #, rozpoczyna komentarz inline, a końcowe białe znaki są przycinane. Jeśli wartość zasadnie zawiera # (kolory szesnastkowe, fragmenty adresów URL) lub znaczące spacje, ujmij ją w podwójne cudzysłowy, aby została zachowana dosłownie w JSON.

Rozwiązuj zduplikowane klucze u źródła

Narzędzie zachowuje ostatnią wartość i ostrzega Cię, gdy klucz jest zduplikowany, ale duplikat w pliku .env to prawie zawsze pomyłka. Usuń zbędną linię, aby nie było wątpliwości, który sekret jest aktywny.

Nigdy nie wklejaj produkcyjnych sekretów do konwerterów po stronie serwera

Ponieważ plik .env to w istocie lista poświadczeń, konwertuj go tylko w narzędziu, które działa w całości w przeglądarce. Ten konwerter tak działa — zweryfikuj zero żądań sieciowych w DevTools — więc jest bezpieczny dla prawdziwych sekretów, w przeciwieństwie do konwerterów po stronie serwera lub opartych na API.

Zweryfikuj JSON przed użyciem go w dalszej części potoku

Po konwersji przepuść JSON przez formater JSON, aby potwierdzić strukturę przed podaniem go do walidatora schematu, importu do menedżera sekretów lub loadera konfiguracji, aby strukturalna niespodzianka ujawniła się wcześnie.

Najczęściej zadawane pytania