.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 オブジェクトに変換し、変数を 1 つずつではなく全体を 1 操作でプッシュできます。

長い .env を一目で確認

膨大な .env ファイルを構造化された整形済み JSON に変えれば、キーをざっと見渡し、警告で重複を見つけ、変更をコミットする前に読みやすい形式で設定を確認できます。

型付き設定オブジェクトを生成

「型を推論」を有効にして JSON に数値、ブール値、null を取得し、型付き設定レイヤーや JSON から TypeScript への工程に渡して、環境変数のインターフェースを導き出せます。

JSON スキーマに対して検証

.env を JSON に変換して JSON スキーマバリデーターに通し、CI で必須キー、値の形式、許可される列挙値を強制します。設定ミスの環境をデプロイ前に捕捉できます。

Docker Compose の env_file 設定を移行

Compose スタックが読み込む env_file を JSON に変え、別のオーケストレーションツール、設定サーバー、ドキュメントで使えます。実際の認証情報を外部サービスに晒すことはありません。

技術的な詳細

行単位の dotenv 互換解析

入力は 1 行ずつ解析されます。空行とコメント行（先頭の非空白文字が #）はスキップされ、任意の export プレフィックスは取り除かれ、残りの各行は最初の = でキーと値に分割されます。キーは周囲の空白がトリムされます。値は dotenv のルールに従います。二重引用符は \n \t \r \\ \" のエスケープを処理して複数行のまたがりを許可し、単一引用符は文字どおり、引用符なしの値は末尾の空白とインラインコメントを除去します。

任意の型推論

デフォルトではすべての値が JSON 文字列として出力され、process.env の値が常に文字列である dotenv の実行時の挙動と一致します。「型を推論」を有効にすると引用符なしの値が昇格されます。数値文字列は JSON 数値に、true/false はブール値に、空または null の値は JSON null になります。引用符付きの値は推論されません。引用符は明示的な文字列の印です。重複キーは警告付きで last-wins（最後優先）で解決されます。

ブラウザベース — アップロードもサーバーもなし

すべての処理はブラウザの JavaScript エンジン内のみで行われ、.env データがネットワークを介して送信されることはありません。パーサーは自前で書かれているため外部依存はありません。Node の dotenv ライブラリはファイルシステムに依存しており、ブラウザでは安全に動きません。200KB を超える入力は、ブラウザの応答性を保つためライブモードから手動モード（明示的な「変換」クリック）に切り替わります。

ベストプラクティス

dotenv に合わせてデフォルトの文字列出力を保つ

dotenv はすべての値を文字列として読み込むため、デフォルトの文字列出力はアプリが実行時に受け取るものを正確に反映します。下流の消費側が本当に型付き JSON を期待する場合のみ「型を推論」を有効にしてください。さもないと '0' や 'false' が JSON と実行中のアプリで異なる挙動を示す不一致のリスクがあります。

# や空白を含む値は引用符で囲む

引用符なしの値では、スペースに続く # がインラインコメントを開始し、末尾の空白はトリムされます。値に正当に #（16 進カラー、フラグメント URL）や意味のあるスペースが含まれる場合は、二重引用符で囲んで JSON にそのまま保持してください。

重複キーは元の場所で解決する

本ツールは最後の値を保持し、キーの重複時に警告しますが、.env ファイルの重複はほぼ常に間違いです。どのシークレットが有効かに曖昧さが残らないよう、冗長な行を取り除いてください。

本番のシークレットをサーバー側の変換ツールに貼り付けない

.env ファイルは事実上認証情報のリストなので、完全にブラウザ内で動作するツールでのみ変換してください。本変換ツールはそうしており（DevTools でネットワークリクエストがゼロであることを確認してください）、サーバー側や API ベースの変換ツールとは違って実際のシークレットでも安全です。

下流で使う前に JSON を検証する

変換後は JSON フォーマッター に JSON を通して構造を確認してから、スキーマバリデーター、シークレットマネージャーのインポート、設定ローダーに渡してください。構造上の意外な問題を早期に表面化できます。

よくある質問