arm32v6/golang

arm32v6/golang Docker镜像文档

注意： 这是https://hub.docker.com/_/golang%E7%9A%84%60arm32v6%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E4%BB%93%E5%BA%93%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/docker-library/golang

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

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

（参见FAQ中的https://github.com/docker-library/faq#whats-the-difference-between-shared-and-simple-tags%EF%BC%89

简单标签

• https://github.com/docker-library/golang/blob/fca8040176e4e0c3d409c87d58fd8a81b16f2429/1.25/alpine3.22/Dockerfile

• https://github.com/docker-library/golang/blob/fca8040176e4e0c3d409c87d58fd8a81b16f2429/1.25/alpine3.21/Dockerfile

• https://github.com/docker-library/golang/blob/411dd143e04f39d9664f81d5284d7dd55949dbde/1.24/alpine3.22/Dockerfile

• https://github.com/docker-library/golang/blob/411dd143e04f39d9664f81d5284d7dd55949dbde/1.24/alpine3.21/Dockerfile

• https://github.com/docker-library/golang/blob/a2c7bd4dead271ecf010ec1149d4a871fe7313b9/tip/alpine3.22/Dockerfile

• https://github.com/docker-library/golang/blob/a2c7bd4dead271ecf010ec1149d4a871fe7313b9/tip/alpine3.21/Dockerfile

共享标签

快速参考（续）

• 提交问题：
  https://github.com/docker-library/golang/issues?q=

• 支持的架构： (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/golang/%E3%80%81https://hub.docker.com/r/arm32v6/golang/%E3%80%81https://hub.docker.com/r/arm32v7/golang/%E3%80%81https://hub.docker.com/r/arm64v8/golang/%E3%80%81https://hub.docker.com/r/i386/golang/%E3%80%81https://hub.docker.com/r/mips64le/golang/ (https://hub.docker.com/r/ppc64le/golang/%E3%80%81https://hub.docker.com/r/riscv64/golang/%E3%80%81https://hub.docker.com/r/s390x/golang/%E3%80%81https://hub.docker.com/r/winamd64/golang/](https://hub.docker.com/r/winamd64/golang/)](https://hub.docker.com/r/winamd64/golang/)

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/golang (https://github.com/docker-library/repo-info/commits/master/repos/golang)
  镜像元数据、传输大小等。

• 镜像更新：
  官方镜像仓库的 library/golang 标签](https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fgolang)
  https://github.com/docker-library/official-images/blob/master/library/golang%60library/golang%60 文件](https://github.com/docker-library/official-images/blob/master/library/golang) (https://github.com/docker-library/official-images/commits/master/library/golang)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/golang (https://github.com/docker-library/docs/commits/master/golang)

什么是 Go？

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

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

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/golang/logo.png

如何使用本镜像

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

在应用中启动 Go 实例

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

dockerfile
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 镜像：

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

在 Docker 容器内编译应用

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

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

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

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

在 Docker 容器内交叉编译应用

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

console
$ 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

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

console
$ 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 项目（来自 https://hub.docker.com/_/alpine%EF%BC%89%E3%80%82Alpine Linux 体积远小于大多数发行版基础镜像（约 5MB），因此生成的镜像更精简。

此变体为高度实验性，不受 Go 项目官方支持（详见 https://github.com/golang/go/issues/***%EF%BC%89%E3%80%82

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

为最小化镜像体积，Alpine 变体不包含额外工具（如 git、gcc、bash）。如需使用，需在基于此镜像的 Dockerfile 中自行安装（参见 https://hub.docker.com/_/alpine/ 了解安装方法）。另见 https://github.com/docker-library/golang/issues/250#issuecomment-451201761 了解更多说明。

arm32v6/golang:<version>-tip

“tip”在 Go 社区指最新开发分支（源自 https://github.com/golang/build/blob/6383021611af0e07cbf0a60222e066662557c796/cmd/coordinator/internal/legacydash/build.go#L313-L314%EF%BC%89%E3%80%82

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

许可证

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

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

部分可自动检测的额外许可证信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/golang%E3%80%82

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