riscv64/golang

注意：这是 https://hub.docker.com/_/golang 的 riscv64 架构构建的“每个架构”仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%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%E2%80%9D%EF%BC%89

Simple Tags

• https://github.com/docker-library/golang/blob/12bb165f4ed0318d0425a869ed69b59f2e9a29c9/1.26-rc/trixie/Dockerfile

• https://github.com/docker-library/golang/blob/12bb165f4ed0318d0425a869ed69b59f2e9a29c9/1.26-rc/alpine3.23/Dockerfile

• https://github.com/docker-library/golang/blob/12bb165f4ed0318d0425a869ed69b59f2e9a29c9/1.26-rc/alpine3.22/Dockerfile

• https://github.com/docker-library/golang/blob/1c0ced42456a245f7952d1d3099c7bc51da8ef00/1.25/trixie/Dockerfile

• https://github.com/docker-library/golang/blob/1c0ced42456a245f7952d1d3099c7bc51da8ef00/1.25/alpine3.23/Dockerfile

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

• https://github.com/docker-library/golang/blob/7262312f3644ba6a680fcf4e78575ebd1d10b98a/1.24/trixie/Dockerfile

• https://github.com/docker-library/golang/blob/7262312f3644ba6a680fcf4e78575ebd1d10b98a/1.24/alpine3.23/Dockerfile

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

• https://github.com/docker-library/golang/blob/a6031005a3cc64e204be***c4a77328e90/tip/trixie/Dockerfile

• https://github.com/docker-library/golang/blob/a6031005a3cc64e204be***c4a77328e90/tip/alpine3.23/Dockerfile

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

Shared Tags

• 1.26rc2, 1.26-rc:

  • https://github.com/docker-library/golang/blob/12bb165f4ed0318d0425a869ed69b59f2e9a29c9/1.26-rc/trixie/Dockerfile

• 1.25.6, 1.25, 1, latest:

  • https://github.com/docker-library/golang/blob/1c0ced42456a245f7952d1d3099c7bc51da8ef00/1.25/trixie/Dockerfile

• 1.24.12, 1.24:

  • https://github.com/docker-library/golang/blob/7262312f3644ba6a680fcf4e78575ebd1d10b98a/1.24/trixie/Dockerfile

• tip-20260116, tip:

  • https://github.com/docker-library/golang/blob/a6031005a3cc64e204be***c4a77328e90/tip/trixie/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/%E3%80%81https://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://github.com/docker-library/repo-info/blob/master/repos/golang%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/golang%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fgolang
  https://github.com/docker-library/official-images/blob/master/library/golang%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/golang%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/golang%EF%BC%88https://github.com/docker-library/docs/commits/master/golang%EF%BC%89

什么是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启动的容器中，将go get github.com/example/...运行到默认$GOPATH会成功）。虽然777权限的目录在常规主机设置中不安全，但容器内通常没有其他进程或用户，因此这在Docker使用中相当于700权限，但允许--user灵活性。

在应用中启动Go实例

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

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

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

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

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

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

镜像变体

riscv64/golang镜像有多种版本，每种版本设计用于特定场景。

riscv64/golang:<version>

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

某些标签可能包含如trixie之类的名称，这些是Debian发行版的代号，表示镜像基于哪个发行版。如果镜像需要安装除自带软件之外的其他包，可能需要显式指定其中一个代号，以减少Debian新版本发布时的中断。

riscv64/golang:<version>-alpine

此镜像基于流行的Alpine Linux项目，可在https://hub.docker.com/_/alpine%E4%B8%AD%E8%8E%B7%E5%8F%96%E3%80%82Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

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

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

为最小化镜像大小，Alpine基础镜像中不包含额外的相关工具（如git、gcc或bash）。以此镜像为基础，可在自己的Dockerfile中添加所需工具（如果不熟悉如何安装包，参见https://hub.docker.com/_/alpine/%E4%B8%AD%E7%9A%84%E7%A4%BA%E4%BE%8B%EF%BC%89%E3%80%82%E5%8F%A6%E8%A7%81https://github.com/docker-library/golang/issues/250#issuecomment-451201761%E4%BA%86%E8%A7%A3%E6%9B%B4%E8%AF%A6%E7%BB%86%E7%9A%84%E8%A7%A3%E9%87%8A%E3%80%82

riscv64/golang:<version>-tip

Go社区中的“tip”一词指最新开发分支（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%E4%B8%AD%E3%80%82

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