arm32v7/golang

Go（golang）是一种通用、高级、命令式编程语言。

26 收藏0 次下载activearm32v7镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

** 注意 ：这是 golang 镜像的 arm32v7 架构构建的“每架构”仓库——更多信息，请参见镜像文档中的“除 amd64 外的架构？”以及*镜像常见问题中的“镜像源在 Git 中已更改，现在该怎么办？”。

快速参考

-** 维护者 **：
Docker 社区

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

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

（参见常见问题中的“‘Shared’ 和 ‘Simple’ 标签有什么区别？”）

简单标签

1.25.3-trixie, 1.25-trixie, 1-trixie, trixie
1.25.3-bookworm, 1.25-bookworm, 1-bookworm, bookworm
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-trixie, 1.24-trixie
1.24.9-bookworm, 1.24-bookworm
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-trixie, tip-trixie
tip-20251017-bookworm, tip-bookworm
tip-20251017-alpine3.22, tip-alpine3.22, tip-20251017-alpine, tip-alpine
tip-20251017-alpine3.21, tip-alpine3.21

共享标签

1.25.3, 1.25, 1, latest:
- 1.25.3-trixie
1.24.9, 1.24:
- 1.24.9-trixie
tip-20251017, tip:
- tip-20251017-trixie

快速参考（续）

-** 提交 issue 的位置：
[*]

-** 支持的架构 **：(更多信息)
amd64, arm32v6, arm32v7, arm64v8, i386, mips64le, ppc64le, riscv64, s390x

-** 已发布镜像工件详情 **：
repo-info 仓库的 repos/golang/ 目录 (历史记录)
（镜像元数据、传输大小等）

-** 镜像更新 **：
official-images 仓库的 library/golang 标签
official-images 仓库的 library/golang 文件 (历史记录)

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

什么是 Go？

Go（又称 Golang）是一种最初由 Google 开发的编程语言。它是一种静态类型语言，语法大致源自 C，但具有额外功能，如垃圾回收、类型安全、一些动态类型能力、额外的内置类型（例如变长数组和键值映射）以及大型标准库。

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

!logo

如何使用此镜像

注意：/go 目录是可全局写入的，以允许灵活指定运行容器的用户（例如，在使用 --user 1000:1000 启动的容器中，将 go get github.com/example/... 运行到默认 $GOPATH 会成功）。虽然在常规主机设置中 777 目录是不安全的，但容器内通常没有其他进程或用户，因此对于 Docker 使用而言，这相当于 700，但允许 --user 灵活性。

在应用中启动 Go 实例

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

dockerfile
FROM arm32v7/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 arm32v7/golang:1.25 go build -v

这会将当前目录作为卷添加到容器，将工作目录设置为该卷，并运行 go build 命令，该命令会告诉 Go 编译工作目录中的项目，并将可执行文件输出到 myapp。或者，如果有 Makefile，可以在容器内运行 make 命令：

console
$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v7/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 arm32v7/golang:1.25 go build -v

或者，可以同时为多个平台构建：

console
$ docker run --rm -it -v "$PWD":/usr/src/myapp -w /usr/src/myapp arm32v7/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（因此需要安装它来下载依赖项并计算正确的 go.sum 值）。

镜像变体

arm32v7/golang 镜像有多种版本，每种版本针对特定用例设计。

`arm32v7/golang:<version>`

这是默认镜像。如果不确定需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以启动应用），也可作为构建其他镜像的基础。

某些标签可能包含 bookworm 或 trixie 等名称。这些是 Debian 发行版的代号，表示镜像所基于的发行版。如果镜像需要安装超出镜像自带的额外软件包，可能需要显式指定其中一个代号，以最大程度减少 Debian 有新版本时的中断。

`arm32v7/golang:<version>-alpine`

此镜像基于流行的 Alpine Linux 项目，可在 alpine ***镜像中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常会生成更精简的镜像。

此变体高度实验性，且未得到 Go 项目的支持（详见 golang/go#）。

需要注意的主要问题是它使用 musl libc 而非 glibc 及相关库，这可能导致意外行为。有关可能出现的问题以及使用 Alpine 基础镜像的优缺点比较，详见此 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像中不包含额外的相关工具（如 git、gcc 或 bash）。将此镜像用作基础时，需在自己的 Dockerfile 中添加所需工具（如果不熟悉如何安装软件包，可参见 alpine 镜像描述中的示例）。另见 docker-library/golang#250 (comment) 了解更详细解释。