AgentSkillsCN

dotenvx

dotenvx 环境变量管理工具的参考手册。提供加密功能、多环境支持，以及在 GitHub Actions 中的应用示例。

SKILL.md
--- frontmatter
name: dotenvx
description: dotenvx 環境変数管理ツールのリファレンス。暗号化、複数環境対応、GitHub Actions での使用例を提供。

dotenvx Skill

dotenvx は .env ファイルの読み込み・暗号化を行う環境変数管理ツール。言語・フレームワーク非依存。

インストール

bash
# curl（推奨）
curl -sfS https://dotenvx.sh | sh

# brew
brew install dotenvx/brew/dotenvx

# npm
npm install @dotenvx/dotenvx --save

基本コマンド

bash
# 環境変数を読み込んでコマンド実行
dotenvx run -- node index.js

# 特定の .env ファイルを指定
dotenvx run -f .env.production -- npm start

# 複数ファイル読み込み（後が優先）
dotenvx run -f .env -f .env.local -- npm start

# 環境変数を取得
dotenvx get DATABASE_URL

# 全環境変数を表示
dotenvx get

暗号化

bash
# .env を暗号化（DOTENV_PUBLIC_KEY, DOTENV_PRIVATE_KEY 生成）
dotenvx encrypt

# 特定ファイルを暗号化
dotenvx encrypt -f .env.production

# 復号化
dotenvx decrypt

# 暗号化されたファイルを実行（DOTENV_PRIVATE_KEY が必要）
dotenvx run -- node index.js

暗号化の仕組み

  • •dotenvx encrypt 実行で公開鍵/秘密鍵ペアを生成
  • •DOTENV_PUBLIC_KEY: .env ファイル内に保存（暗号化用）
  • •DOTENV_PRIVATE_KEY: ローカル環境または CI に設定（復号化用）
  • •環境別: DOTENV_PRIVATE_KEY_PRODUCTION で自動判定

オプション

オプション説明
-f, --env-file.env ファイル指定
--overload後続ファイルで上書き
--quiet出力抑制
--verbose詳細表示
--debugデバッグ情報表示

複数環境の管理

code
.env                 # 共通設定
.env.local           # ローカル上書き（gitignore）
.env.production      # 本番環境
.env.development     # 開発環境
bash
# 本番環境で実行
dotenvx run -f .env.production -- npm start

# 開発 + ローカル上書き
dotenvx run -f .env.development -f .env.local -- npm run dev

GitHub Actions

curl でインストール。完全な例は assets/gh_action_example.yaml を参照。

yaml
steps:
  - uses: actions/checkout@v4

  - name: Install dotenvx
    run: curl -sfS https://dotenvx.sh | sh

  - name: Run tests
    env:
      DOTENV_PRIVATE_KEY: ${{ secrets.DOTENV_PRIVATE_KEY }}
    run: dotenvx run -- npm test

参考