如何传递容器版本？求替代ENV变量与文件写入的方案

1. 构建时直接将版本嵌入脚本内容 #

这种方式在镜像构建阶段就把版本号写入脚本代码中，不依赖环境变量或额外文件，既能避免容器管理器保留旧环境变量的问题，也能防止用户随意篡改版本号。

实现步骤： #

• 先在脚本（比如app.sh）里预留版本占位符：

  # app.sh
  CURRENT_VERSION="__VERSION__"
  
  echo "当前版本：$CURRENT_VERSION"
  

• 修改Dockerfile，添加构建参数并替换脚本内的占位符：

  ARG VERSION_ARG="0.0"
  # 假设脚本在上下文的scripts目录，复制到容器内/app路径
  COPY scripts/app.sh /app/app.sh
  # 替换脚本中的版本占位符
  RUN sed -i "s/__VERSION__/$VERSION_ARG/" /app/app.sh
  

• 构建镜像时传入版本参数：

  docker build . --build-arg "VERSION_ARG=1.0"
  

构建完成后，脚本本身已包含正确版本号，运行时直接读取脚本内的变量即可，Portainer更新镜像后，新容器会自动使用新版本，用户也无法通过修改环境变量篡改版本显示。

2. 将版本编译进二进制程序（适用于编译型语言） #

如果你的应用是Go、Rust等编译型语言编写的，可以在构建阶段把版本号作为编译参数注入二进制文件，版本会永久嵌在程序内部，无法通过容器环境变量或文件修改。

示例（Go语言）： #

• 代码中定义版本变量：

  package main
  
  var version string
  
  func main() {
      println("当前版本：", version)
  }
  

• Dockerfile中构建时传入版本参数：

  ARG VERSION_ARG="0.0"
  FROM golang:alpine as builder
  WORKDIR /app
  COPY . .
  # 编译时注入版本号
  RUN go build -ldflags="-X main.version=$VERSION_ARG" -o myapp .
  
  FROM alpine
  COPY --from=builder /app/myapp /usr/bin/myapp
  CMD ["myapp"]
  

• 构建命令同样使用--build-arg传入版本：

  docker build . --build-arg "VERSION_ARG=1.0"
  

这种方式安全性最高，版本号直接嵌在二进制程序里，用户几乎无法篡改，容器更新后也会自动使用新镜像的版本。

3. 利用镜像LABEL元数据（需注意权限） #

你可以在构建镜像时将版本号添加到镜像的LABEL中，然后在容器内读取镜像元数据获取版本。不过这种方式需要容器能访问Docker守护进程，存在安全风险，仅在必要时使用。

实现步骤： #

• Dockerfile中添加LABEL：

  ARG VERSION_ARG="0.0"
  LABEL app.version=$VERSION_ARG
  

• 容器内安装Docker客户端后，可通过以下命令获取版本：

  # 需要挂载/var/run/docker.sock到容器内，且容器内有docker命令
  docker inspect --format '{{ index .Config.Labels "app.version" }}' $(hostname)
  

但该方式需要给容器挂载Docker套接字，会让容器拥有宿主机Docker的管理权限，存在安全隐患，不推荐用于生产环境。

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