一、什么是环境变量与运行环境?
程序并不是在完全独立的条件下运行的。它通常需要依赖操作系统、运行时、配置文件、网络服务、数据库、文件系统以及其他外部资源。
这些外部条件共同构成了程序的运行环境。
在运行环境中,环境变量是一种非常常见的配置传递机制。
1. 什么是环境变量?
环境变量(Environment Variable) 是操作系统进程环境中的一组键值对,用于向程序及其子进程传递配置信息。
例如:
APP_ENV=production
PORT=8080
LOG_LEVEL=info
DATABASE_HOST=127.0.0.1
其中:
APP_ENV:表示当前应用环境。PORT:表示应用监听端口。LOG_LEVEL:表示日志级别。DATABASE_HOST:表示数据库主机地址。
程序启动时可以读取这些变量,根据不同配置调整自身行为。
例如,同一个程序可以通过不同环境变量连接不同数据库,而不需要修改源代码。
2. 什么是运行环境?
运行环境(Runtime Environment) 是程序执行所依赖的软件、系统配置和资源条件的集合。
它通常包括:
- 操作系统及其版本。
- CPU 架构。
- 编程语言运行时。
- 虚拟机或解释器。
- 系统库和动态链接库。
- 环境变量。
- 配置文件。
- 网络和文件系统。
- 数据库、消息队列等外部服务。
- 用户权限和安全策略。
例如,一个 Java Web 应用的运行环境可能包括:
Linux
├── JDK 17
├── Spring Boot 应用
├── JVM 参数
├── 环境变量
├── 数据库连接配置
├── 日志配置
└── 网络与文件系统
环境变量只是运行环境的一部分,不能将二者等同。
3. 环境变量与运行环境的关系
| 对比维度 | 环境变量 | 运行环境 |
|---|---|---|
| 本质 | 键值对配置 | 程序执行条件的集合 |
| 作用 | 向程序传递外部信息 | 提供程序执行所需条件 |
| 内容 | 字符串形式的变量 | 操作系统、运行时、配置、资源等 |
| 生命周期 | 通常与进程及其环境相关 | 取决于系统和运行资源的生命周期 |
| 管理方式 | Shell、系统服务、容器、CI/CD | 操作系统、运行时、容器、部署平台 |
| 典型示例 | PATH、PORT、APP_ENV |
Linux、JVM、Node.js、数据库 |
二者之间的关系可以概括为:
flowchart TD
A["运行环境"] --> B["操作系统"]
A --> C["语言运行时"]
A --> D["系统依赖与资源"]
A --> E["配置管理"]
E --> F["环境变量"]
E --> G["配置文件"]
F --> H["应用程序"]
G --> H
B --> H
C --> H
D --> H
style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style B fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style C fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style D fill:#E8EDF2,stroke:#B8C3CE,color:#334155
style E fill:#FFF5DE,stroke:#E8D29A,color:#334155
style F fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style G fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style H fill:#E5F4EC,stroke:#A3CBB5,color:#334155
linkStyle default stroke:#A3B8AC,stroke-width:1.5px
二、环境变量的基本原理
环境变量并不是由应用程序自行随意创建的一组全局变量,而是操作系统提供的一种进程环境机制。
在类 Unix 系统中,进程通常可以通过环境字符串数组访问环境变量。
1. 环境变量的存储形式
环境变量通常采用以下形式:
KEY=VALUE
例如:
PATH=/usr/local/bin:/usr/bin:/bin
HOME=/home/user
LANG=zh_CN.UTF-8
其中:
KEY是变量名称。VALUE是变量值。=用于分隔名称和值。
环境变量的值通常以字符串形式传递。
即使变量表示数字、布尔值或路径,程序读取后也通常需要自行解析。
例如:
PORT=8080
DEBUG=true
程序读取后需要决定:
PORT是否转换为整数。DEBUG应该按照什么规则解析为布尔值。- 配置缺失时使用什么默认值。
2. 进程环境(Process Environment)
在类 Unix 系统中,进程可以拥有自己的环境变量集合。
进程启动时,操作系统会将环境信息传递给新程序。
在 C 语言中,可以通过 environ 或 getenv() 访问环境变量。
示例:
#include <stdio.h>
#include <stdlib.h>
int main(void) {
const char *env = getenv("APP_ENV");
if (env != NULL) {
printf("Environment: %s\n", env);
} else {
printf("APP_ENV is not set\n");
}
return 0;
}
运行:
APP_ENV=production ./app
输出:
Environment: production
这里的 APP_ENV=production 只对本次启动的进程及其后续环境传递产生影响,不会自动修改系统中所有进程的环境变量。
3. 父进程与子进程的环境变量继承
进程创建时,子进程通常可以继承父进程的环境变量。
在 Unix/Linux 中,典型情况是:
- Shell 保存当前环境变量。
- Shell 启动子进程。
- 子进程获得环境变量副本。
- 子进程读取自己的环境变量。
- 子进程修改环境变量,不会反向修改父进程的环境。
示例:
export APP_ENV=development
python app.py
Python 进程可以读取 APP_ENV。
如果 Python 程序内部修改环境变量,通常不会改变启动它的 Shell 环境。
flowchart TD
A["Shell 进程"] --> B["设置 APP_ENV=development"]
B --> C["启动子进程"]
C --> D["子进程继承环境变量"]
D --> E["读取环境变量"]
E --> F["修改子进程环境"]
F --> G["子进程环境发生变化"]
G --> H["父进程环境保持不变"]
style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style B fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style C fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style D fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style E fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style F fill:#FFF5DE,stroke:#E8D29A,color:#334155
style G fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style H fill:#E8EDF2,stroke:#B8C3CE,color:#334155
linkStyle default stroke:#A3B8AC,stroke-width:1.5px
需要注意,进程继承环境变量的具体实现与操作系统有关。
在 Windows 中,进程也有自己的环境块(Environment Block),子进程可以在创建时获得相应的环境配置。
4. 环境变量的作用范围
环境变量可以根据设置方式具有不同的作用范围。
| 设置方式 | 作用范围 | 示例 |
|---|---|---|
| 命令前临时赋值 | 通常仅影响本次命令及其子进程 | APP_ENV=prod app |
| Shell 普通变量 | 当前 Shell | APP_ENV=prod |
| Shell 导出变量 | 当前 Shell 及后续启动的子进程 | export APP_ENV=prod |
| 用户级配置 | 用户登录或启动的相关会话 | Shell 配置文件 |
| 系统级配置 | 系统服务或相关进程 | 系统环境配置 |
| 容器环境配置 | 容器内进程 | Docker ENV |
| CI/CD 配置 | 流水线任务或 Job | CI Variables |
并不是所有设置都能自动影响已经运行的进程。
大多数情况下,进程启动后拥有自己的环境变量集合。修改 Shell 配置文件或系统配置,不会自动刷新现有进程的环境。
三、环境变量的常见类型
环境变量可以按照用途进行分类。
1. 系统环境变量
系统环境变量通常用于配置操作系统和命令行工具。
常见变量:
| 变量 | 作用 | 常见系统 |
|---|---|---|
PATH |
命令搜索路径 | Linux、macOS、Windows |
HOME |
用户主目录 | Linux、macOS |
USER |
当前用户名 | 常见 Unix 系统 |
SHELL |
用户默认 Shell | 常见 Unix 系统 |
LANG |
默认语言和区域设置 | Linux、macOS |
TMPDIR |
临时目录 | Unix 系统 |
TEMP |
临时文件目录 | Windows 等 |
SystemRoot |
Windows 系统目录 | Windows |
USERPROFILE |
Windows 用户配置文件目录 | Windows |
不同操作系统的变量名称和语义并不完全相同。
2. PATH 环境变量
PATH 是最常见、最重要的环境变量之一。
它用于指定系统搜索可执行程序的目录。
例如:
echo "$PATH"
可能输出:
/usr/local/bin:/usr/bin:/bin
当用户执行:
python
Shell 通常会按照 PATH 中的目录顺序搜索对应的可执行文件。
如果某个目录中存在多个同名程序,通常会优先找到搜索顺序靠前的那个。
例如:
export PATH="/opt/python/bin:$PATH"
这会将 /opt/python/bin 放在原有搜索路径之前。
检查命令位置:
which python
在更强调可靠性的脚本中,也可以使用:
command -v python
Windows 中的 PATH 使用分号分隔路径,而 Unix 类系统通常使用冒号。
3. 应用程序环境变量
应用程序可以定义自己的环境变量。
例如:
APP_ENV
APP_PORT
APP_DEBUG
APP_LOG_LEVEL
APP_CONFIG_PATH
这些变量通常用于控制:
- 应用运行模式。
- 服务监听端口。
- 日志输出级别。
- 功能开关。
- 配置文件路径。
- 外部服务地址。
应用程序应明确规定变量名称、数据类型、默认值和校验规则,避免配置含义不清晰。
4. 敏感信息环境变量
一些环境变量可能用于传递敏感信息:
DATABASE_PASSWORD
API_TOKEN
JWT_SECRET
PRIVATE_KEY
虽然环境变量经常被用来传递密钥,但它并不是专门的密钥管理系统。
环境变量可能出现在:
- 进程信息或调试信息中。
- 崩溃转储中。
- 诊断日志中。
- CI/CD 日志中。
- 容器配置和管理接口中。
- 错误输出中。
因此,不应将环境变量视为天然安全的存储方式。
生产环境中应优先使用专门的密钥管理服务、受控的 Secret 注入机制或操作系统提供的安全凭据管理能力。
四、如何设置与读取环境变量?
不同操作系统和编程语言提供了不同的环境变量管理方式。
1. Linux / macOS
查看变量:
echo "$APP_ENV"
设置当前 Shell 变量:
APP_ENV=development
导出环境变量:
export APP_ENV=production
删除环境变量:
unset APP_ENV
为单次命令设置变量:
APP_ENV=test python app.py
这种写法通常只影响当前命令及其子进程,不会永久修改 Shell 配置。
2. Windows CMD
查看变量:
echo %APP_ENV%
设置当前命令行会话变量:
set APP_ENV=production
删除变量:
set APP_ENV=
设置只对当前 CMD 会话有效,关闭窗口后通常不会保留。
3. Windows PowerShell
读取:
$env:APP_ENV
设置:
$env:APP_ENV = "production"
删除:
Remove-Item Env:APP_ENV
设置只影响当前 PowerShell 进程及其后续启动的子进程,不等于永久修改系统环境变量。
4. Python 读取环境变量
Python 可以使用 os.environ 访问环境变量。
import os
app_env = os.environ.get(
"APP_ENV",
"development"
)
port = int(
os.environ.get("PORT", "8000")
)
print(app_env)
print(port)
其中:
os.environ:访问进程环境变量。get():读取变量并支持默认值。int():将字符串转换为整数。
设置环境变量:
import os
os.environ["APP_ENV"] = "production"
这里修改的是当前 Python 进程的环境变量集合,不会自动修改父进程环境。
5. Java 读取环境变量
Java 可以通过 System.getenv() 读取环境变量。
public class Main {
public static void main(String[] args) {
String appEnv =
System.getenv("APP_ENV");
String port =
System.getenv("PORT");
System.out.println(appEnv);
System.out.println(port);
}
}
读取单个变量:
String value = System.getenv("APP_ENV");
获取全部环境变量:
Map<String, String> env =
System.getenv();
Java 标准 API 提供读取环境变量的能力,但没有提供通过 System.getenv() 修改当前进程环境变量的标准接口。
6. JavaScript / Node.js 读取环境变量
Node.js 使用 process.env 访问环境变量。
const appEnv =
process.env.APP_ENV || "development";
const port =
Number(process.env.PORT || 3000);
console.log(appEnv);
console.log(port);
设置变量:
process.env.APP_ENV = "production";
这里修改的是当前 Node.js 进程中的环境变量对象,不会反向修改父进程的环境。
还需要注意,process.env 中的环境变量值通常以字符串形式处理,应用程序应自行进行类型转换和校验。
7. Go 读取环境变量
Go 使用 os.Getenv() 和 os.LookupEnv()。
package main
import (
"fmt"
"os"
)
func main() {
appEnv := os.Getenv("APP_ENV")
port, exists := os.LookupEnv("PORT")
fmt.Println(appEnv)
fmt.Println(port, exists)
}
两种方法的区别:
os.Getenv():变量不存在时返回空字符串。os.LookupEnv():额外返回变量是否存在。
这一区别对于判断变量是否显式配置非常重要。
8. Rust 读取环境变量
Rust 标准库提供 std::env 模块。
use std::env;
fn main() {
let app_env = env::var("APP_ENV")
.unwrap_or_else(|_| {
"development".to_string()
});
println!("{}", app_env);
}
读取结果可能包含错误,例如变量不存在或变量值无法转换为有效的 Unicode 字符串。
生产代码应根据具体业务决定如何处理这些错误。
五、运行环境的组成结构
运行环境不仅包含操作系统,还包括程序执行时所依赖的整个软件和资源体系。
1. 操作系统环境
操作系统为程序提供基础运行能力。
主要包括:
- 进程管理。
- 线程调度。
- 内存管理。
- 文件系统。
- 网络通信。
- 权限控制。
- 系统调用接口。
例如,Linux、Windows 和 macOS 都可以运行 Java 程序,但它们的文件路径、进程管理、系统调用和动态链接机制存在差异。
2. 编程语言运行时
不同语言通常需要不同的运行时支持。
| 语言 | 常见运行环境 | 主要职责 |
|---|---|---|
| Java | JVM | 字节码执行、内存管理、垃圾回收 |
| Python | CPython 等实现 | 解释执行、对象管理、模块加载 |
| JavaScript | V8、SpiderMonkey 等 | JavaScript 执行、优化编译、垃圾回收 |
| .NET | CLR | IL 执行、JIT、垃圾回收 |
| Go | Go Runtime | 调度、内存管理、垃圾回收 |
| Rust | 原生可执行程序及标准库 | 提供语言库和运行支持 |
需要注意,语言运行时并不一定是独立的虚拟机进程。
例如,Go 程序通常将 Go Runtime 相关代码链接进生成的可执行程序中;Java 程序则通常运行在 JVM 之上。
3. 系统依赖与动态链接库
程序可能依赖操作系统提供的动态库。
例如:
- Linux 中的
.so文件。 - Windows 中的
.dll文件。 - macOS 中的
.dylib文件。
如果程序依赖的动态库不存在,可能出现加载失败。
Linux 中可以使用:
ldd ./app
查看动态依赖。
对于不可信的二进制文件,直接使用 ldd 需要注意安全风险。静态检查 ELF 动态依赖时,可以考虑:
readelf -d ./app
4. 外部服务环境
现代应用通常依赖其他服务:
- MySQL、PostgreSQL 等数据库。
- Redis 等缓存系统。
- Kafka、RabbitMQ 等消息队列。
- 对象存储服务。
- 第三方 API。
- 身份认证服务。
这些服务可能位于本机、局域网、云平台或其他容器中。
因此,应用运行环境不仅是本地软件环境,也包含外部服务的可访问性、网络连通性和认证配置。
5. 运行环境的层次结构
flowchart TD
A["应用程序"] --> B["语言运行时"]
B --> C["系统库与运行时依赖"]
C --> D["操作系统"]
D --> E["硬件与虚拟化资源"]
A --> F["应用配置"]
F --> G["环境变量"]
F --> H["配置文件"]
A --> I["外部服务"]
I --> J["数据库"]
I --> K["缓存与消息队列"]
I --> L["第三方 API"]
style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style B fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style C fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style D fill:#E8EDF2,stroke:#B8C3CE,color:#334155
style E fill:#FFF5DE,stroke:#E8D29A,color:#334155
style F fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style G fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style H fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style I fill:#FFF5DE,stroke:#E8D29A,color:#334155
style J fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style K fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style L fill:#F3EDFC,stroke:#C4B2E3,color:#334155
linkStyle default stroke:#A3B8AC,stroke-width:1.5px
六、开发环境、测试环境与生产环境
软件项目通常不会只使用一个运行环境,而是根据软件开发和交付流程划分多个环境。
1. 开发环境(Development)
开发环境主要用于日常编码和调试。
典型特点:
- 允许频繁修改代码。
- 使用本地数据库或开发数据库。
- 启用详细日志。
- 支持调试工具。
- 可能启用热重载。
- 配置通常较为宽松。
例如:
APP_ENV=development
DEBUG=true
LOG_LEVEL=debug
开发环境的重点是提高开发效率。
2. 测试环境(Testing)
测试环境用于验证程序行为和质量。
常见类型:
- 单元测试环境。
- 集成测试环境。
- 自动化测试环境。
- 性能测试环境。
- 验收测试环境。
典型配置:
APP_ENV=test
DEBUG=false
LOG_LEVEL=info
测试环境应尽可能接近生产环境,但通常会使用独立的测试数据和外部服务。
3. 预发布环境(Staging)
预发布环境用于模拟生产环境,验证上线前的部署过程和系统行为。
通常会尽可能保持以下配置与生产环境一致:
- 操作系统。
- 运行时版本。
- 部署方式。
- 网络结构。
- 服务依赖。
- 应用配置结构。
预发布环境不一定拥有与生产环境完全相同的资源规模,但应尽可能减少关键环境差异。
4. 生产环境(Production)
生产环境是实际承载用户请求的运行环境。
主要关注:
- 系统稳定性。
- 安全性。
- 性能。
- 可用性。
- 监控与告警。
- 日志与审计。
- 数据备份。
- 故障恢复。
典型配置:
APP_ENV=production
DEBUG=false
LOG_LEVEL=warn
生产环境应避免输出敏感信息,并限制调试接口和不必要的管理权限。
5. 多环境配置对比
| 对比维度 | 开发环境 | 测试环境 | 预发布环境 | 生产环境 |
|---|---|---|---|---|
| 主要目的 | 编码与调试 | 验证功能 | 上线前验证 | 对外提供服务 |
| 日志级别 | debug | info/debug | info | info/warn |
| 调试功能 | 通常开启 | 按需开启 | 通常关闭 | 关闭 |
| 数据 | 开发数据 | 测试数据 | 脱敏或模拟数据 | 真实业务数据 |
| 外部服务 | 本地或开发服务 | 测试服务 | 预发布服务 | 生产服务 |
| 安全要求 | 基础 | 较高 | 高 | 最高 |
6. 多环境配置切换流程
flowchart TD
A["应用启动"] --> B["读取 APP_ENV"]
B --> C{"识别运行环境"}
C -->|"development"| D["加载开发配置"]
C -->|"test"| E["加载测试配置"]
C -->|"staging"| F["加载预发布配置"]
C -->|"production"| G["加载生产配置"]
C -->|"未知"| H["使用安全默认策略或启动失败"]
D --> I["合并配置"]
E --> I
F --> I
G --> I
I --> J["校验必需配置"]
J --> K{"配置是否合法"}
K -->|"是"| L["初始化应用"]
K -->|"否"| M["输出配置错误并终止启动"]
style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style B fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style C fill:#FFF5DE,stroke:#E8D29A,color:#334155
style D fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style E fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style F fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style G fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style H fill:#FBE9E9,stroke:#D9AAAA,color:#334155
style I fill:#E8EDF2,stroke:#B8C3CE,color:#334155
style J fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style K fill:#FFF5DE,stroke:#E8D29A,color:#334155
style L fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style M fill:#FBE9E9,stroke:#D9AAAA,color:#334155
linkStyle default stroke:#A3B8AC,stroke-width:1.5px
七、配置文件与环境变量的关系
环境变量并不是唯一的应用配置来源。
实际项目中,通常还会使用配置文件、命令行参数、配置中心和密钥管理服务。
1. 常见配置来源
| 配置来源 | 示例 | 适用场景 |
|---|---|---|
| 默认配置 | 程序内置默认值 | 基础参数 |
| 配置文件 | application.yml |
结构化配置 |
| 环境变量 | DATABASE_HOST |
部署环境注入 |
| 命令行参数 | --port=8080 |
临时覆盖 |
| 配置中心 | Nacos、Consul 等 | 动态集中管理 |
| 密钥管理服务 | Vault、云 Secret 服务 | 敏感配置 |
不同配置来源各有特点。
环境变量适合部署时注入简单配置,但当配置数量巨大、需要动态更新或需要复杂权限管理时,通常需要结合配置中心或专门的密钥管理服务。
2. 配置优先级
应用可以定义多个配置来源的优先级。
例如:
命令行参数
>
环境变量
>
外部配置文件
>
默认配置
这种优先级是一种常见设计,并不是所有框架都采用完全相同的规则。
以 Spring Boot 为例,它拥有自己的外部化配置机制,并定义了较完整的属性来源优先级。
3. 配置加载流程
flowchart TD
A["应用启动"] --> B["加载默认配置"]
B --> C["读取配置文件"]
C --> D["读取环境变量"]
D --> E["解析命令行参数"]
E --> F["合并配置来源"]
F --> G["执行类型转换"]
G --> H["执行配置校验"]
H --> I{"配置是否合法"}
I -->|"是"| J["生成最终配置对象"]
I -->|"否"| K["报告配置错误"]
J --> L["初始化业务模块"]
style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style B fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style C fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style D fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
style E fill:#FFF5DE,stroke:#E8D29A,color:#334155
style F fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style G fill:#E8EDF2,stroke:#B8C3CE,color:#334155
style H fill:#F3EDFC,stroke:#C4B2E3,color:#334155
style I fill:#FFF5DE,stroke:#E8D29A,color:#334155
style J fill:#E5F4EC,stroke:#A3CBB5,color:#334155
style K fill:#FBE9E9,stroke:#D9AAAA,color:#334155
style L fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
linkStyle default stroke:#A3B8AC,stroke-width:1.5px
4. 配置类型转换
环境变量通常以字符串形式提供,但应用需要使用不同的数据类型。
例如:
PORT=8080
DEBUG=false
TIMEOUT=30
应用需要转换为:
PORT → Integer
DEBUG → Boolean
TIMEOUT → Integer
需要注意,布尔值不能简单地使用所有语言的默认类型转换规则。
例如 Python 中:
bool("false")
结果是 True,因为非空字符串会被视为真值。
因此应显式解析:
def parse_bool(value: str) -> bool:
normalized = value.strip().lower()
if normalized in ("true", "1", "yes", "on"):
return True
if normalized in ("false", "0", "no", "off"):
return False
raise ValueError(
f"Invalid boolean value: {value}"
)
5. 配置校验
配置读取后,不能直接假设所有值都正确。
例如:
import os
port = int(os.getenv("PORT", "8000"))
if not 1 <= port <= 65535:
raise ValueError("Invalid port")
实际项目还应该校验:
- 必需变量是否存在。
- 数据类型是否合法。
- 数值是否处于有效范围。
- URL 格式是否正确。
- 文件路径是否存在。
- 数据库连接参数是否完整。
- 敏感配置是否符合安全要求。
八、环境变量与 Docker 容器
容器技术让应用运行环境更加标准化,但容器并不意味着环境变量可以自动共享或同步。
Docker 可以在创建容器时注入环境变量。
1. Dockerfile 中设置环境变量
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
ENV APP_ENV=production
ENV PORT=8000
CMD ["python", "app.py"]
ENV 指令用于设置镜像中的环境变量。
容器启动后,容器内的进程可以读取这些变量。
需要注意:不应该将数据库密码、API Token 等敏感信息直接写入 Dockerfile,因为这些值可能保留在镜像元数据或构建历史中。
2. docker run 注入环境变量
docker run \
-e APP_ENV=production \
-e PORT=8000 \
my-app
也可以使用环境变量文件:
docker run \
--env-file .env \
my-app
示例 .env:
APP_ENV=production
PORT=8000
LOG_LEVEL=info
.env 文件通常是应用或容器工具约定的配置文件,并不是操作系统自动识别的环境变量文件。