如何让Docker Compose根据主机架构自动选择对应镜像？

可以通过Docker内置的环境变量${TARGETARCH}实现单文件自动匹配对应架构的镜像，无需维护两个Compose文件：

1. 修改Docker Compose文件的image字段为带变量的形式：

   services:
     typesense:
       image: docker.io/typesense/typesense:0.25.2${TARGETARCH:+-$TARGETARCH}
       # 其他原有配置（端口、卷、环境变量等）保持不变
   

2. 直接运行启动命令即可：

   docker compose up -d
   

原理说明 #

• TARGETARCH是Docker自动注入的环境变量，会根据主机架构自动赋值（比如arm64、amd64）
• ${TARGETARCH:+-$TARGETARCH}是Shell参数扩展语法：如果TARGETARCH有值且不为空，就追加-加上变量值；如果是空值（旧版本Docker可能不支持，主流版本已适配），则不追加任何内容
• 这样arm64架构主机（如M系列Mac）会自动拉取0.25.2-arm64镜像，非arm64架构则拉取原版0.25.2镜像

如果你的Docker版本较旧不支持TARGETARCH，也可以手动指定变量后启动：

# arm64架构
export TARGETARCH=arm64 && docker compose up -d

# amd64架构
export TARGETARCH=amd64 && docker compose up -d

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