arm32v6/golang Docker镜像文档

注意： 这是golang官方镜像的arm32v6架构专用仓库。更多信息请参见官方镜像文档中的"非amd64架构？"和官方镜像FAQ中的"镜像源在Git中已更改，该怎么办？"。

快速参考

• 维护者：
  Docker社区

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应的Dockerfile链接

（参见FAQ中的"'Shared'和'Simple'标签有什么区别？"）

简单标签

• 1.25.3-alpine3.22, 1.25-alpine3.22, 1-alpine3.22, alpine3.22, 1.25.3-alpine, 1.25-alpine, 1-alpine, alpine

• 1.25.3-alpine3.21, 1.25-alpine3.21, 1-alpine3.21, alpine3.21

• 1.24.9-alpine3.22, 1.24-alpine3.22, 1.24.9-alpine, 1.24-alpine

• 1.24.9-alpine3.21, 1.24-alpine3.21

• tip-20251017-alpine3.22, tip-alpine3.22, tip-20251017-alpine, tip-alpine

• tip-20251017-alpine3.21, tip-alpine3.21

共享标签

快速参考（续）

• 提交问题：
  [***]

• 支持的架构： (更多信息)
  amd64、arm32v6、arm32v7、arm64v8、i386、mips64le (ppc64le、riscv64、s390x、windows-amd64]([]]([]

• 镜像 artifact 详情：
  repo-info 仓库的 repos/golang/ 目录 (历史记录)
  镜像元数据、传输大小等。

• 镜像更新：
  官方镜像仓库的 library/golang 标签]([]
  官方镜像仓库library/golang 文件]([] (历史记录)

• 本描述的来源：
  docs 仓库的 golang/ 目录 (历史记录)

什么是 Go？

Go（又称 Golang）是由 Google 开发的编程语言。它是一种静态类型语言，语法大致源自 C，但增加了垃圾回收内存管理、类型安全、部分动态类型功能、额外内置类型（如变长数组和键值映射）以及庞大的标准库。

***.org/wiki/Go_(programming_language)

!logo

如何使用本镜像

注意： /go 目录设置为可全局写入，以支持灵活指定运行容器的用户（例如，使用 --user 1000:1000 启动容器时，在默认 $GOPATH 中运行 go get github.com/example/... 可成功执行）。虽然在常规主机环境中 777 权限目录不安全，但容器内通常没有其他进程或用户，因此在 Docker 使用场景下等效于 700 权限，同时支持 --user 灵活性。

在应用中启动 Go 实例

使用本镜像最直接的方式是将 Go 容器同时作为构建和运行环境。在 Dockerfile 中，以下内容可编译并运行项目（假设使用 go.mod 管理依赖）：

FROM arm32v6/golang:1.25

WORKDIR /usr/src/app

# 预复制/缓存 go.mod 以预下载依赖，后续构建中仅在依赖变更时重新下载
COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN go build -v -o /usr/local/bin/app ./...

CMD ["app"]

然后构建并运行 Docker 镜像：

$ docker build -t my-golang-app .
$ docker run -it --rm --name my-running-app my-golang-app

在 Docker 容器内编译应用

有时可能不需要在容器内运行应用，仅需编译。可通过以下命令在 Docker 实例内编译：

$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v6/golang:1.25 go build -v

此命令会将当前目录挂载为容器卷，设置工作目录为该卷，并运行 go build 命令编译项目，输出可执行文件到 myapp。若项目有 Makefile，也可在容器内运行 make：

$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v6/golang:1.25 make

在 Docker 容器内交叉编译应用

如需为非 linux/amd64 平台（如 windows/386）编译应用：

$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp -e GOOS=windows -e GOARCH=386 arm32v6/golang:1.25 go build -v

也可一次性为多个平台编译：

$ docker run --rm -it -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v6/golang:1.25 bash
$ for GOOS in darwin linux; do
>   for GOARCH in 386 amd64; do
>     export GOOS GOARCH
>     go build -v -o myapp-$GOOS-$GOARCH
>   done
> done

Git LFS

若下载依赖时出现“checksum mismatch”错误，需检查依赖是否使用 Git LFS（需安装 Git LFS 以正确下载依赖并计算 go.sum 值）。

镜像变体

arm32v6/golang 镜像有多种变体，适用于不同场景。

arm32v6/golang:<version>

默认镜像。若不确定需求，建议使用此变体。设计用于临时容器（挂载源码并启动容器运行应用）或作为构建其他镜像的基础。

arm32v6/golang:<version>-alpine

基于流行的 Alpine Linux 项目（来自 alpine 官方镜像）。Alpine Linux 体积远小于大多数发行版基础镜像（约 5MB），因此生成的镜像更精简。

此变体为高度实验性，不受 Go 项目官方支持（详见 golang/go#19938）。

主要注意事项：使用 musl libc 而非 glibc 等，可能导致意外行为。详见 Hacker News 评论线程 了解潜在问题及 Alpine 镜像的优缺点。

为最小化镜像体积，Alpine 变体不包含额外工具（如 git、gcc、bash）。如需使用，需在基于此镜像的 Dockerfile 中自行安装（参见 alpine 镜像描述 了解安装方法）。另见 docker-library/golang#250 (comment) 了解更多说明。

arm32v6/golang:<version>-tip

“tip”在 Go 社区指最新开发分支（源自 hg 版本控制时代的遗留约定）。

这些标签包含 Go 最新开发分支的构建，约每周更新一次。

许可证

查看本镜像包含软件的 许可证信息。

与所有 Docker 镜像一样，本镜像可能包含其他软件，可能受其他许可证约束（如基础发行版中的 Bash 等，以及主要软件的直接或间接依赖）。

部分可自动检测的额外许可证信息可能位于 repo-info 仓库的 golang/ 目录。

对于任何预构建镜像的使用，镜像用户有责任确保其使用符合包含的所有软件的相关许可证要求。