如何在Portainer中自动导入Ubuntu系统的环境变量？

我目前使用Portainer创建Stack，了解可通过「从.env文件加载变量」和「添加环境变量」按钮配置环境变量，但希望自动（或尽可能接近自动）导入Ubuntu系统中的非敏感信息（如路径类环境变量）。当前按以下示例配置Stack后，变量未生效：

当前配置与现象 #

Stack配置示例 #

environment:
  - TZ=America/Toronto
  - TEST=${MEDIA}

容器内执行结果 #

root@:/# echo $TEST

root@:/# echo $TZ
America/Toronto

Ubuntu系统环境变量输出 #

❯ echo $MEDIA
/home/user/data/media

可行实现方法 #

方法1：通过Portainer加载自定义.env文件 #

1. 在Ubuntu主机上，将需要导入的系统环境变量写入一个专属.env文件，比如/home/user/docker/host_vars.env：

   echo "MEDIA=$MEDIA" >> /home/user/docker/host_vars.env
   

   多变量可按变量名=变量值格式逐行追加。
2. 给该文件设置合理权限，确保Portainer能读取：

   chmod 644 /home/user/docker/host_vars.env
   

3. 在Portainer创建Stack时，选择「从.env文件加载变量」，上传该文件或直接填写主机绝对路径，Stack中的${MEDIA}即可被正确解析。

方法2：启动Portainer时注入系统环境变量 #

修改Portainer的启动命令，将需要的主机环境变量传递给Portainer容器，让它能直接读取这些变量：

1. 先停止并删除现有Portainer容器：

   docker stop portainer
   docker rm portainer
   

2. 重新启动Portainer，通过-e参数注入变量（多变量可重复添加-e）：

   docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data -e MEDIA=$MEDIA portainer/portainer-ce:latest
   

   此后创建Stack时，${MEDIA}会自动替换为主机对应变量值。

方法3：在Compose文件中使用env_file指令 #

若通过上传Compose文件创建Stack，可直接在文件中指定加载主机的.env文件：

version: '3'
services:
  your-service-name:
    image: your-target-image
    environment:
      - TZ=America/Toronto
      - TEST=${MEDIA}
    env_file:
      - /home/user/docker/host_vars.env

注意文件路径为Ubuntu主机的绝对路径，需确保Portainer有权限访问。

原配置失效原因 #

Portainer创建Stack时，仅会解析自身进程能获取到的环境变量，或通过指定.env文件提供的变量，不会主动读取主机系统的全局环境变量。原配置中${MEDIA}因Portainer进程未持有该变量，被替换为空字符串，导致容器内TEST变量无值。

内容的提问来源于stack exchange，提问作者Droppisalt