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

快速参考

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

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

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

（参见FAQ中的"‘共享’标签和‘简单’标签有什么区别？"）

简单标签

• 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、windows-amd64

-** 已发布镜像 artifact 详情 **：
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进行依赖管理）：

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

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

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

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

$ docker run --rm -it -v "$PWD":/usr/src/myapp -w /usr/src/myapp i386/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值）。

镜像变体

i386/golang镜像有多种版本，每种版本针对特定使用场景设计。

i386/golang:<version>

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

部分标签可能包含bookworm或trixie等名称，这些是Debian的发行版代号，表示镜像基于哪个Debian版本构建。如果镜像需要安装镜像自带之外的额外软件包，建议显式指定这些代号，以减少Debian新版本发布时可能出现的兼容性问题。

i386/golang:<version>-alpine

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

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

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

为最小化镜像大小，Alpine基础镜像不包含Git、GCC或Bash等额外相关工具。如果以此镜像为基础，需在自己的Dockerfile中添加所需工具（若不熟悉Alpine安装软件包的方法，可参见alpine镜像描述中的示例）。另见docker-library/golang#250 (comment)了解更多说明。

i386/golang:<version>-tip

Go社区中的"tip"一词指最新开发分支（源于之前使用hg进行版本控制的传统）。

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

许可证

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

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

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

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