这是适用于i386架构的Go (Golang) 编程语言官方Docker镜像,提供Go开发和运行环境,支持应用编译、运行及跨平台构建。
** 注意 **:这是https://hub.docker.com/_/golang的`i386`架构构建的"特定架构"仓库——更多信息请参见官方镜像文档中的"https://github.com/docker-library/official-images#architectures-other-than-amd64"和官方镜像FAQ中的"https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what"。
快速参考
-** 维护者 **:
https://github.com/docker-library/golang
-** 获取帮助 **:
https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic
支持的标签及对应的Dockerfile链接
(参见FAQ中的"https://github.com/docker-library/faq#whats-the-difference-between-shared-and-simple-tags")
简单标签
-
https://github.com/docker-library/golang/blob/fca8040176e4e0c3d409c87d58fd8a81b16f2429/1.25/trixie/Dockerfile
-
https://github.com/docker-library/golang/blob/fca8040176e4e0c3d409c87d58fd8a81b16f2429/1.25/bookworm/Dockerfile
-
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/trixie/Dockerfile
-
https://github.com/docker-library/golang/blob/411dd143e04f39d9664f81d5284d7dd55949dbde/1.24/bookworm/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/trixie/Dockerfile
-
https://github.com/docker-library/golang/blob/a2c7bd4dead271ecf010ec1149d4a871fe7313b9/tip/bookworm/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
共享标签
-
1.25.3,1.25,1,latest:- https://github.com/docker-library/golang/blob/fca8040176e4e0c3d409c87d58fd8a81b16f2429/1.25/trixie/Dockerfile
-
1.24.9,1.24:- https://github.com/docker-library/golang/blob/411dd143e04f39d9664f81d5284d7dd55949dbde/1.24/trixie/Dockerfile
-
tip-20251017,tip:- https://github.com/docker-library/golang/blob/a2c7bd4dead271ecf010ec1149d4a871fe7313b9/tip/trixie/Dockerfile
快速参考(续)
-** 提交issue地址 **:
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/、https://hub.docker.com/r/arm32v6/golang/、https://hub.docker.com/r/arm32v7/golang/、https://hub.docker.com/r/arm64v8/golang/、https://hub.docker.com/r/i386/golang/、https://hub.docker.com/r/mips64le/golang/、https://hub.docker.com/r/ppc64le/golang/、https://hub.docker.com/r/riscv64/golang/、https://hub.docker.com/r/s390x/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)
(镜像元数据、传输大小等)
-** 镜像更新 **:
https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fgolang
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)
如何使用此镜像
注意:/go目录设置为可全局写入,以允许灵活指定运行容器的用户(例如,在使用--user 1000:1000启动的容器中,将go get github.com/example/...运行到默认$GOPATH时会成功)。虽然777权限在常规主机设置中可能不安全,但容器内通常没有其他进程或用户,因此在Docker使用场景下等同于700权限,同时支持--user灵活性。
在应用中启动Go实例
使用此镜像最直接的方式是将Go容器同时用作构建和运行环境。在Dockerfile中,以下内容将编译并运行项目(假设项目使用go.mod进行依赖管理):
dockerfileFROM docker.xuanyuan.run/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镜像:
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 i386/golang:1.25 go build -v
此命令会将当前目录作为卷挂载到容器中,将工作目录设置为该卷,并运行go build命令,该命令会编译工作目录中的项目并将可执行文件输出到myapp。或者,如果有Makefile,可在容器内运行make命令:
console$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp i386/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 i386/golang:1.25 go build -v
或者,可同时为多个平台构建:
console$ 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等名称,这些是https://wiki.debian.org/DebianReleases的发行版代号,表示镜像基于哪个Debian版本构建。如果镜像需要安装镜像自带之外的额外软件包,建议显式指定这些代号,以减少Debian新版本发布时可能出现的兼容性问题。
i386/golang:<version>-alpine
此镜像基于流行的https://alpinelinux.org,该项目在https://hub.docker.com/_/alpine中可用。Alpine Linux比大多数发行版基础镜像小得多(约5MB),因此通常会生成更精简的镜像。
此变体高度实验性,且未得到Go项目的官方支持(详见https://github.com/golang/go/issues/***)。
需要注意的主要问题是,它使用https://musl.libc.org而非https://www.etalabs.net/compare_libcs.html,可能导致意外行为。有关可能出现的问题及使用Alpine基础镜像的优缺点对比,详见此Hacker News评论线程。
为最小化镜像大小,Alpine基础镜像不包含Git、GCC或Bash等额外相关工具。如果以此镜像为基础,需在自己的Dockerfile中添加所需工具(若不熟悉Alpine安装软件包的方法,可参见https://hub.docker.com/_/alpine/中的示例)。另见https://github.com/docker-library/golang/issues/250#issuecomment-451201761了解更多说明。
i386/golang:<version>-tip
Go社区中的"tip"一词指最新开发分支(https://github.com/golang/build/blob/6383021611af0e07cbf0a60222e066662557c796/cmd/coordinator/internal/legacydash/build.go#L313-L314)。
这些标签包含Go最新开发分支的构建,约每周更新一次。
许可证
查看此镜像中包含的软件的http://golang.org/LICENSE。
与所有Docker镜像一样,这些镜像可能还包含其他软件,这些软件可能受其他许可证约束(如基础发行版中的Bash等,以及主要软件的任何直接或间接依赖项)。
部分可自动检测的额外许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/golang中。
对于任何预构建镜像的使用,镜像用户有责任确保对本镜像的任何使用均符合其中包含的所有软件的相关许可证。
i386 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务