登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  linux

systemd 服务怎么从文件读取环境变量

来源:17golang原创

时间:2026-09-06 03:09:10 141浏览 收藏

可以用 EnvironmentFile=。把变量写成独立的 UTF-8 文本文件,在服务的 [Service] 段加入绝对路径,例如 EnvironmentFile=/etc/myapp/api.env。它不是 shell 脚本,不要写 export,也不要把加载文件当成执行脚本。

要点速览
  • 必选文件不存在或格式非法时,服务会启动失败;路径前加 - 才表示可选。
  • 环境文件支持注释、引号和续行,但文件路径本身不展开 $HOME 这类 shell 变量。
  • 密码、密钥等敏感值不适合长期放进环境变量,优先考虑 systemd credential 机制。

先把变量放进 systemd 能识别的文件

环境文件是一组换行分隔的变量赋值。空行、没有等号的行,以及以 #; 开头的行会被忽略,适合把说明留在文件里。一个最小示例如下:

# /etc/myapp/api.env
APP_ENV=production
PORT=8080
LOG_DIR="/var/log/myapp"
FEATURE_FLAGS=search,metrics

值中有空格时用单引号或双引号包住;反斜杠可以续接下一行。这里的语法只提供环境赋值,不等同于 Bash:例如 export PORT=8080 不是应写入的格式。环境文件应限制权限,尤其不要让普通用户可写。

systemd EnvironmentFile 环境文件、变量赋值、引号解析与服务环境的静态关系图
图1:环境文件中的赋值经过 systemd 解析后,进入服务进程环境;注释和 shell 执行语句不属于同一层。

在 [Service] 中声明 EnvironmentFile=

把指令放在服务单元的 [Service] 段。路径使用绝对文件名,必要时可以声明多个文件:

[Unit]
After=network-online.target

[Service]
ExecStart=/usr/local/bin/myapp
EnvironmentFile=/etc/myapp/api.env
EnvironmentFile=-/etc/myapp/local.env
Restart=on-failure

[Install]
WantedBy=multi-user.target

第一行要求 api.env 必须存在且可读;第二行前面的短横线表示本地覆盖文件可以不存在。文件会在服务进程执行前读取,因此可以由前一个 unit 状态生成,再由下一次启动读取。它读取的是服务管理器看到的文件系统,不能把变量文件只放在之后才出现的 bind mount 里。

写法含义适用场景
EnvironmentFile=/path/app.env文件出错会影响启动生产必需配置
EnvironmentFile=-/path/local.env文件错误静默忽略可选的本机覆盖
多次声明按声明顺序读取,后者覆盖同名变量基础配置加环境覆盖

重载后再启动,别把旧进程当成新配置

修改 unit 文件后先让 systemd 重新读取配置,再重启服务:

# 让 systemd 重新读取 unit 文件
sudo systemctl daemon-reload
# 让服务进程在下一次启动时读取 EnvironmentFile
sudo systemctl restart myapp.service
# 查看该 unit 的环境属性,排查变量是否进入服务环境
systemctl show myapp.service --property=Environment

daemon-reload 只重载 unit 定义,不会自动替换正在运行的进程;所以只执行它看不到旧进程环境的变化。服务若因环境文件缺失或格式非法而启动失败,可先看 systemctl status myapp.servicejournalctl -u myapp.service 的错误,再处理路径、权限或编码。

systemd 服务管理器、EnvironmentFile、unit 配置和 ExecStart 进程之间的静态边界关系图
图2:服务管理器读取 unit 与环境文件后,把合成的环境交给 ExecStart 进程;重载定义和替换进程是两个不同边界。

覆盖关系和敏感配置要分开判断

如果同一个变量同时出现在 Environment=EnvironmentFile=,环境文件中的值优先;多个环境文件则按声明顺序由后者覆盖前者。另一方面,EnvironmentFile= 的路径不会把 $HOME 当作 shell 变量展开;需要动态路径时应查看 systemd 支持的 % specifier,通常仍建议写清楚绝对路径。

环境变量会出现在进程环境中,并可能被同一进程树中的其他程序看到。数据库密码、私钥、访问令牌等不要为了省事直接放在普通环境文件里;可根据 systemd 版本和部署方式改用 LoadCredential=LoadCredentialEncrypted=SetCredentialEncrypted=,把秘密放到 credential 通道。

常见问题

EnvironmentFile 能写 export 吗?

不能按 shell 脚本理解。写普通的 NAME=value,不要添加 export、命令替换或其他 shell 执行语句。

改了 env 文件为什么服务没变化?

环境变量是在启动进程前读取的。执行 systemctl restart,必要时先执行 daemon-reload;仅刷新文件不会改变旧进程。

EnvironmentFile 文件不存在怎么办?

必选写法会让服务启动失败;在确认该配置确实可选时,把路径写成 EnvironmentFile=-/绝对路径

systemd 环境文件适合保存密码吗?

不适合。权限控制只能降低文件读取风险,不能改变环境变量可能沿进程树暴露的特性;敏感值应评估 credential 方案。

相关规则可继续查阅 systemd.exec 的 EnvironmentFile= 文档,重点看文件格式、读取时机、覆盖顺序和可选文件前缀。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>