当前位置:首页 > 文章列表 > 文章 > linux > systemd 服务怎么从文件读取环境变量

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

来源:17golang原创 2026-09-06 03:09:10 0浏览 收藏

可以用 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删除
Go 怎么把带 BOM 的 UTF16 文件转成 UTF8Go 怎么把带 BOM 的 UTF16 文件转成 UTF8
上一篇
Go 怎么把带 BOM 的 UTF16 文件转成 UTF8
Go XML 标签有命名空间前缀时为什么匹配不到
下一篇
Go XML 标签有命名空间前缀时为什么匹配不到
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • SuperCLUE中文大模型评测基准:功能、能力维度与应用指南
    SuperCLUE
    SuperCLUE是权威的中文大语言模型综合评测基准,涵盖语言理解、知识应用、AI Agent智能体及安全性等12项核心能力。通过多轮对话与客观测试,定期发布榜单与技术报告,为模型研发、优化及行业选型提供科学依据。
    158次使用
  • C-Eval中文评测基准:大语言模型多学科能力评估指南
    C-Eval
    深入了解C-Eval中文评估套件,涵盖52个学科与4级难度。本文详解其功能特点、Zero-shot/Few-shot使用方法及代码示例,助您全面评测LLM中文理解与泛化能力。
    87次使用
  • ClickPrompt:AI提示词生成与优化工具,支持Stable Diffusion、ChatGPT及代码辅助
    ClickPrompt
    ClickPrompt是一款专为AI提示词编写者设计的开源在线工具,支持Stable Diffusion绘图、ChatGPT对话及GitHub Copilot代码辅助。提供Prompt自动生成、一键运行、社区分享及可视化优化功能,帮助用户高效获取精准AI输出。
    46次使用
  • PromptHero官网:AI提示词搜索、优化与学习平台,支持Midjourney/Stable Diffusion
    PromptHero
    PromptHero是专业的AI提示词搜索引擎与优化平台,支持Stable Diffusion、Midjourney等主流模型。提供海量提示词库、分类搜索、在线课程及社区互动,助力用户高效生成高质量AI图像与文本。
    30次使用
  • OpenArt免费开源指南:Stable Diffusion Prompt Book提示词手册详解
    Stable Diffusion Prompt Book
    深入解析OpenArt推出的Stable Diffusion Prompt Book,这本免费的开源提示词指南涵盖从基础语法到高级技巧,提供风格化词库与参数建议,助您优化AI绘画生成效果。
    30次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码