Ubuntu服务环境变量设置（从零开始配置systemd服务的环境变量）

什么是环境变量？

环境变量是操作系统用来存储配置信息的键值对。程序在运行时可以读取这些变量来获取数据库地址、密钥、日志级别等配置。在 Ubuntu 中，每个进程都有自己的环境变量空间。

为什么服务需要单独设置环境变量？

当你通过 systemctl 启动一个服务时，该服务运行在独立的环境中，不会继承你当前用户的环境变量。因此，即使你在终端里设置了 export API_KEY=xxx，服务启动时也读不到这个变量。这就需要我们在服务单元文件（unit file）中显式定义。

方法一：直接在服务文件中设置 Environment

这是最简单直接的方式。假设你有一个名为 myapp.service 的服务：

[Unit]Description=My ApplicationAfter=network.target[Service]Type=simpleUser=myuserWorkingDirectory=/home/myuser/myappExecStart=/usr/bin/python3 app.pyEnvironment=DATABASE_URL=postgresql://user:pass@localhost/mydbEnvironment=API_KEY=your_secret_key_hereEnvironment=LOG_LEVEL=info[Install]WantedBy=multi-user.target

如上所示，每行一个 Environment=KEY=value 即可。注意：如果值中包含空格或特殊字符，建议用双引号包裹，例如：
Environment="MESSAGE=Hello World!"

方法二：从外部文件加载环境变量（推荐用于敏感信息）

出于安全和管理方便考虑，我们通常会把敏感信息（如密码、密钥）放在单独的配置文件中，而不是直接写在服务文件里。systemd 支持通过 EnvironmentFile 指令加载。

首先，创建一个环境变量文件，例如 /etc/default/myapp.env：

# /etc/default/myapp.envDATABASE_URL=postgresql://user:pass@localhost/mydbAPI_KEY=your_secret_key_hereLOG_LEVEL=info

然后修改服务文件，使用 EnvironmentFile 引入：

[Unit]Description=My ApplicationAfter=network.target[Service]Type=simpleUser=myuserWorkingDirectory=/home/myuser/myappExecStart=/usr/bin/python3 app.pyEnvironmentFile=/etc/default/myapp.env[Install]WantedBy=multi-user.target

⚠️ 安全提示：确保该文件权限设置合理，例如只允许 root 和应用用户读取：
sudo chmod 600 /etc/default/myapp.env
sudo chown root:myuser /etc/default/myapp.env

重载配置并重启服务

修改服务文件后，必须重新加载 systemd 配置并重启服务才能生效：

# 重新加载 systemd 配置sudo systemctl daemon-reload# 重启服务sudo systemctl restart myapp# 查看服务状态（确认是否成功启动）sudo systemctl status myapp

验证环境变量是否生效

你可以通过以下命令查看服务实际加载的环境变量：

# 查看服务的环境变量sudo systemctl show myapp --property=Environment

或者进入服务的执行上下文查看（适用于调试）：

# 以服务用户身份运行命令（需先安装 systemd-cgtop 或使用其他方式）sudo -u myuser bash -c 'echo $API_KEY'

常见问题与 SEO 关键词总结

在配置过程中，你可能会遇到“变量未定义”、“服务启动失败”等问题。记住：服务不继承用户环境、路径要写绝对路径、敏感信息不要硬编码。掌握 Ubuntu环境变量、系统服务配置、systemd环境变量 和 Linux服务部署 这些核心概念，能让你更高效地运维应用。

现在，你已经学会了如何在 Ubuntu 中为 systemd 服务设置环境变量！无论是开发测试还是生产部署，这都是必备技能。快去试试吧！