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 不是应写入的格式。环境文件应限制权限,尤其不要让普通用户可写。

在 [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.service 和 journalctl -u myapp.service 的错误,再处理路径、权限或编码。

覆盖关系和敏感配置要分开判断
如果同一个变量同时出现在 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= 文档,重点看文件格式、读取时机、覆盖顺序和可选文件前缀。
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
423 收藏
-
218 收藏
-
221 收藏
-
400 收藏
-
422 收藏
-
198 收藏
-
270 收藏
-
488 收藏
-
125 收藏
-
143 收藏
-
440 收藏
-
161 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习