Note

这是golang官方镜像的“特定架构”仓库，用于windows-amd64构建——更多信息请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“Git中镜像源已更改，该怎么办？”。

快速参考

• 维护者：
  Docker社区

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

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

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

Simple Tags

• 1.25.3-windowsservercore-ltsc2025, 1.25-windowsservercore-ltsc2025, 1-windowsservercore-ltsc2025, windowsservercore-ltsc2025

• 1.25.3-windowsservercore-ltsc2022, 1.25-windowsservercore-ltsc2022, 1-windowsservercore-ltsc2022, windowsservercore-ltsc2022

• 1.25.3-nanoserver-ltsc2025, 1.25-nanoserver-ltsc2025, 1-nanoserver-ltsc2025, nanoserver-ltsc2025

• 1.25.3-nanoserver-ltsc2022, 1.25-nanoserver-ltsc2022, 1-nanoserver-ltsc2022, nanoserver-ltsc2022

• 1.24.9-windowsservercore-ltsc2025, 1.24-windowsservercore-ltsc2025

• 1.24.9-windowsservercore-ltsc2022, 1.24-windowsservercore-ltsc2022

• 1.24.9-nanoserver-ltsc2025, 1.24-nanoserver-ltsc2025

• 1.24.9-nanoserver-ltsc2022, 1.24-nanoserver-ltsc2022

Shared Tags

• 1.25.3, 1.25, 1, latest:

  • 1.25.3-windowsservercore-ltsc2025
  • 1.25.3-windowsservercore-ltsc2022

• 1.25.3-windowsservercore, 1.25-windowsservercore, 1-windowsservercore, windowsservercore:

  • 1.25.3-windowsservercore-ltsc2025
  • 1.25.3-windowsservercore-ltsc2022

• 1.25.3-nanoserver, 1.25-nanoserver, 1-nanoserver, nanoserver:

  • 1.25.3-nanoserver-ltsc2025
  • 1.25.3-nanoserver-ltsc2022

• 1.24.9, 1.24:

  • 1.24.9-windowsservercore-ltsc2025
  • 1.24.9-windowsservercore-ltsc2022

• 1.24.9-windowsservercore, 1.24-windowsservercore:

  • 1.24.9-windowsservercore-ltsc2025
  • 1.24.9-windowsservercore-ltsc2022

• 1.24.9-nanoserver, 1.24-nanoserver:

  • 1.24.9-nanoserver-ltsc2025
  • 1.24.9-nanoserver-ltsc2022

快速参考（续）

• 提交issue的地址：
  [***]

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

• 已发布镜像的详细信息：
  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 winamd64/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 winamd64/golang:1.25 go build -v

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

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

或者，可以一次性为多个平台构建：

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

镜像变体

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

winamd64/golang:<version>

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

winamd64/golang:<version>-windowsservercore

此镜像基于[Windows Server Core (mcr.microsoft.com/windows/servercore)]([***]