本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

dotenv/dotenvx

由dotenv创建者开发的安全环境变量管理工具，支持跨平台运行、多环境配置和加密环境变量，适用于各种编程语言、框架及部署场景。

1 收藏0 次下载activedotenv

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

dotenvx - 安全的环境变量管理工具

概述

dotenvx 是由 dotenv 创建者开发的安全环境变量管理工具，提供跨平台运行能力、多环境配置支持和环境变量加密功能。它解决了传统环境变量管理中的安全性和灵活性问题，可无缝集成到各种编程语言、框架和部署流程中。

核心功能与特性

跨平台运行：支持 Windows、macOS、Linux 等操作系统，兼容各种终端和脚本环境。
多环境管理：通过不同 .env 文件（如 .env、.env.production）轻松切换开发、测试、生产等环境。
加密保护：使用 secp256k1 椭圆曲线加密算法保护敏感环境变量，防止泄露。
变量扩展与替换：支持环境变量引用、默认值设置、命令输出嵌入等高级功能。
多语言兼容：适配 Node.js、Python、Java、Go、Ruby 等几乎所有主流编程语言。
框架集成：支持 Next.js、Rails、Django、Laravel 等常见开发框架。

使用场景与适用范围

本地开发：安全管理开发环境变量，避免硬编码敏感信息。
多环境部署：通过不同环境文件快速切换配置，简化部署流程。
CI/CD 流程：在 GitHub Actions、GitLab CI 等持续集成环境中安全注入环境变量。
容器化部署：与 Docker、Kubernetes 等容器技术结合，管理容器环境变量。
服务器运维：在 cron 任务、系统服务中安全使用环境变量。

安装方法

npm 安装

npm install @dotenvx/dotenvx --save

全局安装（支持任意语言/框架）

通过 curl 安装 🌐

curl -sfS [***] | sh
dotenvx help

通过 brew 安装 🍺

brew install dotenvx/brew/dotenvx
dotenvx help

通过 Docker 运行 🐳

docker run -it --rm -v $(pwd):/app dotenv/dotenvx help

通过 GitHub Releases 安装 🐙

curl -L -o dotenvx.tar.gz "[***] -s)-$(uname -m).tar.gz"
tar -xzf dotenvx.tar.gz
./dotenvx help

Windows 安装 🪟

winget install dotenvx
dotenvx help

使用指南

基本使用

创建 .env 文件：

echo "HELLO=World" > .env

创建示例脚本（以 Node.js 为例）：

// index.js
console.log(`Hello ${process.env.HELLO}`);

不使用 dotenvx 运行（环境变量未加载）：

node index.js  # 输出: Hello undefined

使用 dotenvx 运行（环境变量已加载）：

dotenvx run -- node index.js  # 输出: Hello World

多环境配置

通过 -f 参数指定环境文件，实现多环境切换：

# 创建生产环境文件
echo "HELLO=Production" > .env.production

# 加载生产环境变量运行
dotenvx run -f .env.production -- node index.js
# 输出: [dotenvx@1.X.X] injecting env (1) from .env.production
#       Hello Production

高级多环境特性

多文件组合加载

echo "HELLO=local" > .env.local
echo "HELLO=World" > .env

# 按顺序加载多个文件，前面文件的变量优先
dotenvx run -f .env.local -f .env -- node index.js
# 输出: Hello local

变量覆盖（--overload 标志）

# 后面文件的变量覆盖前面文件
dotenvx run -f .env.local -f .env --overload -- node index.js
# 输出: Hello World

框架约定加载（--convention 标志）

支持 Next.js 或 dotenv-flow 的环境加载约定：

# 按 Next.js 约定加载环境文件
dotenvx run --convention=nextjs -- node index.js

环境变量加密

使用 dotenvx encrypt 命令加密环境文件，保护敏感信息：

创建并加密环境文件：

echo "HELLO=Secret" > .env
dotenvx encrypt  # 生成加密的 .env 文件和密钥对

运行时自动解密：

dotenvx run -- node index.js  # 输出: Hello Secret

加密高级用法

指定环境文件加密

# 加密生产环境文件
dotenvx encrypt -f .env.production

# 使用生产环境私钥运行
DOTENV_PRIVATE_KEY_PRODUCTION="<私钥>" dotenvx run -- node index.js

多加密文件组合

# 为多个环境文件设置私钥
DOTENV_PRIVATE_KEY="<.env私钥>" DOTENV_PRIVATE_KEY_PRODUCTION="<.env.production私钥>" dotenvx run -- node index.js

高级功能

变量扩展与替换

变量引用

# .env
USERNAME="admin"
DATABASE_URL="postgres://${USERNAME}@localhost/mydb"

dotenvx run -- node -e "console.log(process.env.DATABASE_URL)"
# 输出: postgres://admin@localhost/mydb

默认值与备选值

# .env
NODE_ENV=production
DB_HOST=${DB_HOST:-localhost}  # 未设置则使用默认值
DEBUG=${NODE_ENV:+false}       # 设置则使用备选值

命令输出嵌入

# .env
CURRENT_USER="$(whoami)"  # 嵌入命令输出

dotenvx run -- node -e "console.log(process.env.CURRENT_USER)"
# 输出: 当前系统用户名

多语言与框架示例

Node.js/TypeScript

# TypeScript 示例
npm install tsx --save-dev
echo "HELLO=World" > .env
echo 'console.log(`Hello ${process.env.HELLO}`)' > index.ts
dotenvx run -- npx tsx index.ts  # 输出: Hello World

Python

echo "HELLO=World" > .env
echo 'import os; print(f"Hello {os.getenv("HELLO")}")' > index.py
dotenvx run -- python3 index.py  # 输出: Hello World

Java

echo "HELLO=World" > .env
echo 'public class Main { public static void main(String[] args) { System.out.println("Hello " + System.getenv("HELLO")); } }' > Main.java
javac Main.java
dotenvx run -- java Main  # 输出: Hello World

框架示例（Next.js/Rails）

# Next.js
dotenvx run -- next dev

# Ruby on Rails
dotenvx run -- bin/rails s

Docker 部署示例

直接运行

docker run -it --rm -v $(pwd):/app dotenv/dotenvx run -- node index.js

Dockerfile 集成

FROM node:latest
WORKDIR /app
COPY . .
RUN curl -fsS [***] | sh
RUN npm install
CMD ["dotenvx", "run", "--", "node", "index.js"]

构建并运行：

docker build -t my-app .
docker run -it --rm my-app

注意事项

Deno 兼容性：不建议直接通过 deno run 使用 npm 模块，推荐安装二进制 CLI。
密钥管理：加密私钥需妥善保管，生产环境建议通过环境变量或密钥管理服务注入。
环境变量优先级：默认情况下，较早加载的文件变量优先，使用 --overload 可让后续文件覆盖。

更多详细文档请访问 dotenvx 官方文档。

查看更多 dotenvx 相关镜像 →

常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

🔐

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

🐧

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

🖥️

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

📦

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

📋

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

🔧

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

💾

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

🐂

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

📱

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

⚡

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

🔗

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

🌐

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

📦

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

📚

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

🚀

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

dotenvx Docker 镜像下载 - 轩辕镜像

dotenvx 镜像详细信息和使用指南

dotenvx 镜像标签列表和版本信息

dotenvx 镜像拉取命令和加速下载

dotenvx 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

dotenvx 镜像详细信息

dotenvx 镜像标签列表

dotenvx 镜像使用说明

dotenvx 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南