Linux 与服务器运维 / 系统课时

用环境文件注入运行参数

用环境文件注入运行参数

本节把端口、数据目录和日志级别从启动命令拆到受保护的环境文件,再由 systemd 在启动进程时注入。你还会直接检查服务进程的环境,确认实际生效值,并划清环境变量与敏感凭据的边界。

学习目标

  • 使用 EnvironmentFile= 为 systemd 服务注入运行参数
  • 区分修改环境文件与修改 unit 后各自需要的重载动作
  • 从正在运行的进程验证 systemd 实际注入的变量值

先把参数从启动命令拆出来

把大量 --port、--data-dir 或日志级别直接写进 ExecStart=,发布时很容易把程序版本和环境差异绑在一起。更稳妥的做法是让 unit 保持稳定,把可变参数集中放在 /etc/myapp/myapp.env。

环境文件不是完整的 Shell 脚本。使用 KEY=value 形式即可,不写 export,也不要依赖命令替换或引用其他变量来动态拼接值。

bash
sudo install -d -o root -g root -m 0755 /etc/myapp
sudo sh -c 'cat > /etc/myapp/myapp.env <<EOF
APP_PORT=8080
APP_DATA_DIR=/var/lib/myapp
APP_LOG_LEVEL=info
EOF'
sudo chown root:root /etc/myapp/myapp.env
sudo chmod 0600 /etc/myapp/myapp.env
sudo sed -n '1,3p' /etc/myapp/myapp.env

预期输出

text
APP_PORT=8080
APP_DATA_DIR=/var/lib/myapp
APP_LOG_LEVEL=info

0600 root:root 可以避免普通用户直接读取该文件。systemd 的系统管理器会在启动服务前读取环境文件,再把变量放进子进程环境,因此文件本身不需要由运行账号读取。

让 systemd 在启动时加载文件

下面是 unit 片段示例,假设实际服务名为 myapp.service,应用会从进程环境读取这些变量。将它放入该服务的 [Service] 段。

ini
[Service]
EnvironmentFile=/etc/myapp/myapp.env
ExecStart=/opt/myapp/bin/myapp

环境文件、systemd 与应用之间的关系如下。修改环境文件后,旧进程不会自动获得新值,必须重启服务。

EnvironmentFile 注入进程环境的数据流

如果只是修改 /etc/myapp/myapp.env 的内容,直接重启服务即可;只有改了 unit 文件本身或 drop-in 配置,才需要先执行 systemctl daemon-reload。

验证正在运行的进程拿到了什么

下面以已经能够正常启动的 myapp.service 为例。完成 unit 修改后先让 systemd 重新读取 unit,再重启服务,取得主进程 PID 并检查 /proc 中的实际环境。

bash
sudo systemctl daemon-reload
sudo systemctl restart myapp.service

PID="$(systemctl show --property=MainPID --value myapp.service)"
sudo tr '\0' '\n' < "/proc/$PID/environ" | grep '^APP_' | sort

预期输出

text
APP_DATA_DIR=/var/lib/myapp
APP_LOG_LEVEL=info
APP_PORT=8080

如果 MainPID 为 0,说明服务没有保持运行,应先执行 systemctl status myapp.service 和 journalctl -u myapp.service -n 50 查启动失败原因。若进程存在但缺少变量,检查 EnvironmentFile= 路径、拼写以及 unit 是否确实完成重载和重启。

敏感凭据不要默认塞进环境变量

环境文件权限设为 0600 只能保护磁盘上的文件,变量进入进程环境后仍可能被有权限的调试工具、崩溃转储或进程检查读取。因此端口、目录、功能开关和日志级别很适合放环境文件,数据库密码、长期 Token、私钥等高敏感值则优先考虑 systemd credentials、专用密钥服务或只在需要时打开的受限文件。

环境文件解决的是“把运行参数和启动命令解耦”,不是自动完成秘密管理。验证时既要确认文件权限,也要确认新进程真正拿到了期望值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用环境文件注入运行参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通