Linux 与服务器运维 / 系统课时
敏感配置适合直接写 Unit 吗
敏感配置适合直接写 Unit 吗
密码、访问 Token 和私钥一旦直接写进 Unit,就会与普通服务配置一起被读取、备份和复制。本课建立一条实用边界:Unit 负责声明“去哪里取配置”,而不是充当明文秘密仓库,并学习环境文件与 systemd credential 的适用差异。
学习目标
- 识别把密码、Token 等明文写入 Unit 的暴露风险
- 使用独立文件和权限控制分离普通配置与敏感配置
- 理解
EnvironmentFile=与LoadCredential=在秘密传递方式上的区别
为什么不要把秘密直接写进 Unit
下面这种写法技术上能够工作,但不适合作为敏感信息的长期存放方式:
[Service]
Environment=API_TOKEN=replace-with-real-token
ExecStart=/usr/local/bin/myappUnit 文件通常按普通系统配置管理,管理员可能通过 systemctl cat、配置备份、自动化发布仓库或故障排查工具读取它。秘密与 Unit 混在一起后,复制一份服务定义往往也会复制一份秘密,轮换 Token 时还需要修改服务配置本身。
更重要的是,Environment= 的值会成为服务进程环境的一部分。环境变量很适合非敏感参数,例如监听地址、日志级别和功能开关,但不应把它理解为专门的秘密存储机制。
用独立文件先完成配置分离
一种基础做法是把配置移到独立文件,并限制文件权限。先创建只允许 root 访问的目录和文件:
sudo install -d -m 700 -o root -g root /etc/myapp
sudo touch /etc/myapp/secret.env
sudo chown root:root /etc/myapp/secret.env
sudo chmod 600 /etc/myapp/secret.env
sudoedit /etc/myapp/secret.env
stat -c 'mode=%a owner=%U:%G' /etc/myapp/secret.env在编辑器中写入实际值,例如 API_TOKEN=<TOKEN>,其中 <TOKEN> 替换为真实 Token。不要把真实秘密直接写进可被 shell 历史记录保存的命令行参数。
预期输出:
mode=600 owner=root:root然后让 Unit 只引用文件:
[Service]
EnvironmentFile=/etc/myapp/secret.env
ExecStart=/usr/local/bin/myapp这是配置文件片段示例,假设 /usr/local/bin/myapp 从环境变量读取 API_TOKEN。修改后可执行 systemctl daemon-reload 并重启服务验证是否生效。
这种方式解决了“秘密直接出现在 Unit 中”的问题,也能让秘密文件拥有更严格的权限和独立轮换流程。但内容最终仍会进入服务进程的环境,因此它更适合完成配置分离,不等于获得专门的秘密传递通道。
更敏感的值优先使用 credential
支持 systemd credentials 的系统可以通过 LoadCredential= 把秘密作为文件提供给服务,而不是把秘密值放进环境变量。下面是片段示例,假设应用支持从文件读取 Token:
[Service]
Type=simple
LoadCredential=api-token:/etc/myapp/credentials/api-token
ExecStart=/usr/local/bin/myapp --token-file=${CREDENTIALS_DIRECTORY}/api-tokensystemd 启动服务时会准备专用 credential 目录,并通过 CREDENTIALS_DIRECTORY 告诉进程位置。Unit 中保存的是 credential 名称和来源路径,而不是 Token 本身;应用读取文件即可获得内容。
如果部署流程还需要避免在磁盘上长期保存明文 credential,可以进一步评估 systemd 的加密 credential 机制。是否采用它取决于发行版所带 systemd 版本以及现有秘密管理体系,不应为了使用新机制而绕开组织已有的 Vault、KMS 或容器秘密管理方案。
按敏感程度选择注入方式
普通配置,例如 LOG_LEVEL=info、端口和功能开关,可以直接使用 Environment= 或普通配置文件。需要与 Unit 分开维护、但应用只能读取环境变量的值,可以放进权限受控的 EnvironmentFile=。
密码、长期 Token 等秘密在应用支持文件读取时,更适合通过 credential 或现有秘密管理系统交付。私钥通常也应保存在严格授权的独立文件中,让 Unit 只保存文件路径,而不是把完整 PEM 内容嵌入服务定义。
核心判断标准不是“systemd 能不能写进去”,而是秘密是否会因为 Unit 的读取、复制、备份和发布流程扩大暴露面。让 Unit 描述秘密的来源,让秘密本身拥有独立权限与轮换周期,才更容易长期维护。