Golang 构建环境镜像(golang / golang+fnpack / golang+wails3 / golang+wails2 / golang+fyne / golang+mygo / golang+gio / golang+nsgo / golang+viva / golang+asuka)
本仓库用三套平台构建十个自建镜像:CNB 推送到制品库(docker.cnb.cool/dtapp/golang),GitHub Actions 推送到 GHCR(ghcr.io/dtapps/golang),GitLab CI 推送到 GitLab Container Registry(registry.gitlab.com/dtapps/golang;脚本里不写死地址,用的是 GitLab 自动注入的 CI_REGISTRY_IMAGE,其值就是 registry.gitlab.com/<group>/<project>)。每个镜像在每套平台上都有独立的 workflow / job 与构建脚本(各自维护,不互相引用),标签契约保持一致;改镜像内容或标签规则时三份都要改,见 docs/github.md 与 docs/gitlab.md。
| 镜像 | CNB 地址 | GitHub 地址(GHCR) | GitLab 地址 | Dockerfile(CNB / GitHub / GitLab) | 文档 |
|---|---|---|---|---|---|
| Golang 构建环境(不含 fnpack) | docker.cnb.cool/dtapp/golang |
ghcr.io/dtapps/golang |
registry.gitlab.com/dtapps/golang |
.cnb/docker/Dockerfile.golang / .github/docker/Dockerfile.golang / .gitlab/docker/Dockerfile.golang |
docs/golang/ |
| Golang 构建环境 + fnpack | docker.cnb.cool/dtapp/golang/fnpack |
ghcr.io/dtapps/golang/fnpack |
registry.gitlab.com/dtapps/golang/fnpack |
.cnb/docker/Dockerfile.fnpack / .github/docker/Dockerfile.fnpack / .gitlab/docker/Dockerfile.fnpack |
docs/fnpack/ |
| Golang 构建环境 + wails3 | docker.cnb.cool/dtapp/golang/wails3 |
ghcr.io/dtapps/golang/wails3 |
registry.gitlab.com/dtapps/golang/wails3 |
.cnb/docker/Dockerfile.wails3 / .github/docker/Dockerfile.wails3 / .gitlab/docker/Dockerfile.wails3 |
docs/wails3/ |
| Golang 构建环境 + wails2 | docker.cnb.cool/dtapp/golang/wails2 |
ghcr.io/dtapps/golang/wails2 |
registry.gitlab.com/dtapps/golang/wails2 |
.cnb/docker/Dockerfile.wails2 / .github/docker/Dockerfile.wails2 / .gitlab/docker/Dockerfile.wails2 |
docs/wails2/ |
| Golang 构建环境 + fyne | docker.cnb.cool/dtapp/golang/fyne |
ghcr.io/dtapps/golang/fyne |
registry.gitlab.com/dtapps/golang/fyne |
.cnb/docker/Dockerfile.fyne / .github/docker/Dockerfile.fyne / .gitlab/docker/Dockerfile.fyne |
docs/fyne/ |
| Golang 构建环境 + mygo | docker.cnb.cool/dtapp/golang/mygo |
ghcr.io/dtapps/golang/mygo |
registry.gitlab.com/dtapps/golang/mygo |
.cnb/docker/Dockerfile.mygo / .github/docker/Dockerfile.mygo / .gitlab/docker/Dockerfile.mygo |
docs/mygo/ |
| Golang 构建环境 + gio | docker.cnb.cool/dtapp/golang/gio |
ghcr.io/dtapps/golang/gio |
registry.gitlab.com/dtapps/golang/gio |
.cnb/docker/Dockerfile.gio / .github/docker/Dockerfile.gio / .gitlab/docker/Dockerfile.gio |
docs/gio/ |
| Golang 构建环境 + nsgo | docker.cnb.cool/dtapp/golang/nsgo |
ghcr.io/dtapps/golang/nsgo |
registry.gitlab.com/dtapps/golang/nsgo |
.cnb/docker/Dockerfile.nsgo / .github/docker/Dockerfile.nsgo / .gitlab/docker/Dockerfile.nsgo |
docs/nsgo/ |
| Golang 构建环境 + viva | docker.cnb.cool/dtapp/golang/viva |
ghcr.io/dtapps/golang/viva |
registry.gitlab.com/dtapps/golang/viva |
.cnb/docker/Dockerfile.viva / .github/docker/Dockerfile.viva / .gitlab/docker/Dockerfile.viva |
docs/viva/ |
| Golang 构建环境 + asuka | docker.cnb.cool/dtapp/golang/asuka |
ghcr.io/dtapps/golang/asuka |
registry.gitlab.com/dtapps/golang/asuka |
.cnb/docker/Dockerfile.asuka / .github/docker/Dockerfile.asuka / .gitlab/docker/Dockerfile.asuka |
docs/asuka/ |
构建脚本按镜像拆分:CNB 用 .cnb/scripts/build-golang.sh、build-fnpack.sh、build-wails3.sh、build-wails2.sh、build-fyne.sh、build-mygo.sh、build-gio.sh、build-nsgo.sh、build-viva.sh 与 build-asuka.sh,GitHub 用 .github/scripts/ 下的同名十份,GitLab 用 .gitlab/scripts/ 下的同名十份。九个变体都依赖同版本的 golang 基础镜像:先发布基础镜像,再 FROM 它构建各自的变体,彼此平级、互不包含。三侧的标签名、提升规则、冒烟断言必须保持一致,平台胶水(触发器、镜像源、元数据落地)各自维护。
镜像里有什么
- Go 工具链(基座
golang:1-trixie,自动跟随最新稳定 Go) - UPX、nfpm、wixl(
wixl+wixl-data,在 Linux 上编译 Windows MSI) - Node.js + npm + pnpm
- sqlc、ent/entc、golangci-lint、govulncheck、shfmt、dockerfmt、yamlfmt、gojq、sql-formatter、gotestsum、markdownfmt、gocover-cobertura、gcov2lcov(都用
go install -v,CI 日志能看编译进度) - 基础命令:git、curl、make、jq、zip/unzip、pkg-config
- 时区与语言:
TZ=Asia/Shanghai、LANG/LC_ALL=C.UTF-8,已装tzdata - fnpack 镜像只多一个
fnpack;wails3 镜像多 GTK4/WebKitGTK 开发包与wails3CLI;wails2 镜像多 GTK3/WebKit2GTK 4.1 开发包与wailsCLI;fyne 镜像多 OpenGL/X11/Wayland 开发包与fyneCLI;mygo 镜像多 GTK3/WebKitGTK 4.1 开发包、无头运行库、mygoCLI 与bun;gio 镜像多 EGL/GLES、X11、Wayland、Vulkan 开发包与无头运行库、gogioCLI(模块gioui.org/cmd);nsgo 镜像多 GTK4/WebKitGTK 6.0/GStreamer 开发包、无头运行库与nsgoCLI;viva 镜像多 XCB/Vulkan、GTK3/WebKit2GTK 4.1 开发包、无头运行库与vivaCLI;asuka 镜像多 GTK4/libadwaita 开发包、无头运行库与asukaCLI。十个镜像的工具链完全一致
十个镜像怎么选
- 只需要 Go 构建、打包 deb/rpm、前端依赖或代码检查:用
golang。 - 需要给 FnOS 打
.fpk包:用golang/fnpack。 - 需要编译 Wails v3 桌面应用:用
golang/wails3。 - 需要编译 Wails v2 桌面应用:用
golang/wails2,构建时加-tags webkit2_41(见 docs/wails2/)。 - 需要编译 Fyne 桌面应用:用
golang/fyne,镜像里已备好 OpenGL/X11/Wayland 开发包与fyneCLI(见 docs/fyne/)。 - 需要编译 MyGo 桌面应用:用
golang/mygo,镜像里已备好 GTK3/WebKitGTK 4.1 开发包、无头运行库、mygoCLI 与bun(见 docs/mygo/)。 - 需要编译 Gio 桌面应用:用
golang/gio,镜像里已备好 EGL/GLES、X11、Wayland、Vulkan 开发包与无头运行库,以及打包工具gogio(模块gioui.org/cmd;gogio没有 linux 目标,Linux 桌面程序就是普通go build+ cgo,见 docs/gio/)。 - 需要编译 nsgo 桌面应用:用
golang/nsgo,镜像里已备好 GTK4/WebKitGTK 6.0/GStreamer 开发包与无头运行库,以及nsgoCLI(Linux 后端纯 Go、运行期dlopen,见 docs/nsgo/)。 - 需要编译 viva 桌面应用:用
golang/viva,镜像里已备好 XCB/Vulkan 开发包与无头运行库(另带 GTK3/WebKit2GTK 4.1,供可选的vivagtk构建标记),以及vivaCLI(见 docs/viva/)。 - 需要编译 asuka 桌面应用:用
golang/asuka,镜像里已备好 GTK4/libadwaita 开发包、无头运行库与asukaCLI(Linux 目标不需要额外 build tag,见 docs/asuka/)。 - 十个镜像的标签完全对应:同一个
<go 版本>下,各变体就是基础镜像加各自的 CLI 与依赖。
# 拉 CNB 制品库、GHCR 或 GitLab Registry 都行,标签规则一致
docker run --rm -it docker.cnb.cool/dtapp/golang:latest bash
docker run --rm -it ghcr.io/dtapps/golang:latest bash
docker run --rm -it registry.gitlab.com/dtapps/golang:latest bash
# 带 fnpack 的版本
docker run --rm docker.cnb.cool/dtapp/golang/fnpack:latest fnpack --help
docker run --rm ghcr.io/dtapps/golang/fnpack:latest fnpack --help
# 带 wails3 的版本
docker run --rm docker.cnb.cool/dtapp/golang/wails3:latest wails3 version
docker run --rm ghcr.io/dtapps/golang/wails3:latest wails3 version
# 带 wails2 的版本(构建应用时加 -tags webkit2_41)
docker run --rm docker.cnb.cool/dtapp/golang/wails2:latest wails version
docker run --rm ghcr.io/dtapps/golang/wails2:latest wails version
# 带 fyne 的版本
docker run --rm docker.cnb.cool/dtapp/golang/fyne:latest fyne version
docker run --rm ghcr.io/dtapps/golang/fyne:latest fyne version
# 带 mygo 的版本
docker run --rm docker.cnb.cool/dtapp/golang/mygo:latest mygo version
docker run --rm ghcr.io/dtapps/golang/mygo:latest mygo version
# 带 gio 的版本(gogio 没有 version 子命令,看 go version -m 里记录的模块版本)
docker run --rm docker.cnb.cool/dtapp/golang/gio:latest sh -c 'go version -m "$(command -v gogio)"'
docker run --rm ghcr.io/dtapps/golang/gio:latest sh -c 'go version -m "$(command -v gogio)"'
# 带 nsgo 的版本
docker run --rm docker.cnb.cool/dtapp/golang/nsgo:latest nsgo --help
docker run --rm ghcr.io/dtapps/golang/nsgo:latest nsgo --help
# 带 viva 的版本
docker run --rm docker.cnb.cool/dtapp/golang/viva:latest viva --version
docker run --rm ghcr.io/dtapps/golang/viva:latest viva --version
# 带 asuka 的版本(asuka 没有 version 子命令,用 --help 验证)
docker run --rm docker.cnb.cool/dtapp/golang/asuka:latest asuka --help
docker run --rm ghcr.io/dtapps/golang/asuka:latest asuka --help作为基础镜像:
FROM docker.cnb.cool/dtapp/golang:latest
# 或
FROM ghcr.io/dtapps/golang:latest
# 需要 fnpack:ghcr.io/dtapps/golang/fnpack:latest
# 需要 wails3:ghcr.io/dtapps/golang/wails3:latest
# 需要 wails2:ghcr.io/dtapps/golang/wails2:latest
# 需要 fyne:ghcr.io/dtapps/golang/fyne:latest
# 需要 mygo:ghcr.io/dtapps/golang/mygo:latest
# 需要 gio:ghcr.io/dtapps/golang/gio:latest
# 需要 nsgo:ghcr.io/dtapps/golang/nsgo:latest
# 需要 viva:ghcr.io/dtapps/golang/viva:latest
# 需要 asuka:ghcr.io/dtapps/golang/asuka:latest.cnb/
├── docker/
│ ├── Dockerfile.golang # golang 基础镜像(不含 fnpack / wails3 / wails2 / fyne / mygo / gio / nsgo / viva / asuka)
│ ├── Dockerfile.fnpack # 在 golang 镜像上加 fnpack
│ ├── Dockerfile.wails3 # 在 golang 镜像上加 GTK4/WebKitGTK + wails3
│ ├── Dockerfile.wails2 # 在 golang 镜像上加 GTK3/WebKit2GTK 4.1 + wails
│ ├── Dockerfile.fyne # 在 golang 镜像上加 OpenGL/X11/Wayland + fyne
│ ├── Dockerfile.mygo # 在 golang 镜像上加 GTK3/WebKitGTK 4.1 + 无头运行库 + mygo + bun
│ ├── Dockerfile.gio # 在 golang 镜像上加 EGL/GLES + X11 + Wayland + Vulkan + 无头运行库 + gogio
│ ├── Dockerfile.nsgo # 在 golang 镜像上加 GTK4/WebKitGTK 6.0/GStreamer + 无头运行库 + nsgo
│ ├── Dockerfile.viva # 在 golang 镜像上加 XCB/Vulkan + GTK3/WebKit2GTK 4.1 + 无头运行库 + viva
│ └── Dockerfile.asuka # 在 golang 镜像上加 GTK4/libadwaita + 无头运行库 + asuka
├── scripts/
│ ├── build-golang.sh # CNB:构建、冒烟、发布 golang 基础镜像
│ ├── build-fnpack.sh # CNB:基于基础镜像构建、冒烟、发布 fnpack
│ ├── build-wails3.sh # CNB:基于基础镜像构建、冒烟、发布 wails3
│ ├── build-wails2.sh # CNB:基于基础镜像构建、冒烟、发布 wails2
│ ├── build-fyne.sh # CNB:基于基础镜像构建、冒烟、发布 fyne
│ ├── build-mygo.sh # CNB:基于基础镜像构建、冒烟、发布 mygo
│ ├── build-gio.sh # CNB:基于基础镜像构建、冒烟、发布 gio
│ ├── build-nsgo.sh # CNB:基于基础镜像构建、冒烟、发布 nsgo
│ ├── build-viva.sh # CNB:基于基础镜像构建、冒烟、发布 viva
│ └── build-asuka.sh # CNB:基于基础镜像构建、冒烟、发布 asuka
├── workflows/ # build-{golang,fnpack,wails3,wails2,fyne,mygo,gio,nsgo,viva,asuka}.yml / 扫描与评审
└── web_trigger.yml # 十个手动构建按钮(golang / fnpack / wails3 / wails2 / fyne / mygo / gio / nsgo / viva / asuka)
.github/
├── docker/ # GitHub 侧的 Dockerfile
├── scripts/ # GitHub 侧的十份构建脚本
├── workflows/
│ ├── build-golang.yml # GitHub:构建并推送 golang 基础镜像
│ ├── build-fnpack.yml # GitHub:定时构建并推送 fnpack
│ ├── build-wails3.yml # GitHub:定时构建并推送 wails3
│ ├── build-wails2.yml # GitHub:定时构建并推送 wails2
│ ├── build-fyne.yml # GitHub:定时构建并推送 fyne
│ ├── build-mygo.yml # GitHub:定时构建并推送 mygo
│ ├── build-gio.yml # GitHub:定时构建并推送 gio
│ ├── build-nsgo.yml # GitHub:定时构建并推送 nsgo
│ ├── build-viva.yml # GitHub:定时构建并推送 viva
│ └── build-asuka.yml # GitHub:定时构建并推送 asuka
├── annotation.json # golang 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-fnpack.json # fnpack 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-wails3.json # wails3 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-wails2.json # wails2 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-fyne.json # fyne 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-mygo.json # mygo 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-gio.json # gio 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-nsgo.json # nsgo 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-viva.json # viva 镜像元数据(CI 生成,.gitignore 已排除)
├── annotation-asuka.json # asuka 镜像元数据(CI 生成,.gitignore 已排除)
└── dependabot.yml # GitHub Actions 与 Docker 镜像依赖更新
.gitlab/
├── docker/ # GitLab 侧的 Dockerfile
├── scripts/ # GitLab 侧的十份构建脚本
├── workflows/
│ ├── build-golang.yml # GitLab:构建并推送 golang 基础镜像
│ ├── build-fnpack.yml # GitLab:构建并推送 fnpack
│ ├── build-wails3.yml # GitLab:构建并推送 wails3
│ ├── build-wails2.yml # GitLab:构建并推送 wails2
│ ├── build-fyne.yml # GitLab:构建并推送 fyne
│ ├── build-mygo.yml # GitLab:构建并推送 mygo
│ ├── build-gio.yml # GitLab:构建并推送 gio
│ ├── build-nsgo.yml # GitLab:构建并推送 nsgo
│ ├── build-viva.yml # GitLab:构建并推送 viva
│ └── build-asuka.yml # GitLab:构建并推送 asuka
└── annotation*.json # 镜像元数据(CI 生成,.gitignore 已排除)
docs/
├── golang/ # 镜像层文档(README + 分册索引 + 分册,十个镜像合写)
├── fnpack/ # fnpack 专属文档(速查 + 索引 + 打包/Dockerfile/元数据徽章)
├── wails3/ # wails3 专属文档(速查 + 版本策略 + 元数据)
├── wails2/ # wails2 专属文档(速查 + 版本策略 + build tag + 元数据)
├── fyne/ # fyne 专属文档(速查 + 版本策略 + 元数据)
├── mygo/ # mygo 专属文档(速查 + 版本策略 + 元数据)
├── gio/ # gio 专属文档(速查 + 版本策略 + cgo 依赖 + 元数据)
├── nsgo/ # nsgo 专属文档(速查 + 版本策略 + GTK4/GStreamer 依赖 + 元数据)
├── viva/ # viva 专属文档(速查 + 版本策略 + XCB/Vulkan 依赖 + 元数据)
├── asuka/ # asuka 专属文档(速查 + 版本策略 + GTK4/libadwaita 依赖 + 元数据)
├── cache-implementation.md # buildx 层缓存的实现与失效边界
├── cnb.md # CNB 平台层说明
├── github.md # GitHub Actions / GHCR 平台说明
└── gitlab.md # GitLab CI / GitLab Registry 平台说明
备份/ # 改造前的两份参考 Dockerfile
| 平台 | GitHub Release / nodejs.org | APT | Go module | npm / pnpm |
|---|---|---|---|---|
| GitHub Actions | 直连 github.com / nodejs.org | 默认 deb.debian.org | 默认 proxy.golang.org | 官方 registry.npmjs.org |
| GitLab CI | 直连 github.com / nodejs.org | 默认 deb.debian.org | 默认 proxy.golang.org | 官方 registry.npmjs.org |
| CNB | https://files.m.daocloud.io |
腾讯云 | mirrors.cloud.tencent.com |
腾讯云 |
GitHub 与 GitLab 的 Dockerfile 全部直连官方源(Go / APT / npm / 下载源都不设镜像);CNB 的 Dockerfile 有 GITHUB_MIRROR / NODE_MIRROR 开关,由构建脚本传入 DaoCloud 镜像,并把 APT、Go module、npm 换成腾讯云。细节见 docs/golang/mirrors.md。
- 提交前跑
make format(yamlfmt / markdownfmt / shfmt / dockerfmt)与make lint-shell;范围包含.cnb/、.github/与.gitlab/三侧的脚本、Dockerfile 与 workflow。 - CI 启用 buildx 层缓存(
<镜像>:buildcache):工具版本在构建前解析成具体版本号,上游没发新版时构建只拉基座、跑冒烟。需要一次干净的全量重建时设CACHE=off,见 docs/golang/build.md。 - 标签是对外契约:
<go 版本>/<major.minor>/latest,外加<go 版本>-linux-{amd64,arm64}。标签每天可能被同名覆盖,固定产物请用元数据里的 digest。 - fnpack / wails3 / wails2 / fyne / mygo / gio / nsgo / viva / asuka 镜像永远基于同版本的 golang 基础镜像构建;基础镜像的
latest/<minor>没跟上时,各变体都不会单独提升这两个标签。 - 变体 CLI 的版本跟随上游最新:wails3 的
WAILS3_VERSION、wails2 的WAILS2_VERSION、fyne 的FYNE_VERSION、mygo 的MYGO_VERSION、gio 的GIO_VERSION、nsgo 的NSGO_VERSION、viva 的VIVA_VERSION与 asuka 的ASUKA_VERSION默认都是latest,CI 构建前用go list -m解析成具体版本再传进--build-arg(层缓存才跟得上版本;nsgo 上游无 tag,解析结果是伪版本);mygo 镜像里的bun走BUN_VERSION,构建前用npm view bun version解析;fnpack 上游没有 latest 接口,FNPACK_VERSION是具体版本号(当前1.2.3)。实际安装的版本记录在元数据fnpack_version/wails3_version/wails2_version/fyne_version/mygo_version/bun_version/gio_version/nsgo_version/viva_version/asuka_version,不占标签。 - wails2 镜像装的是 WebKit2GTK 4.1,编译应用时要加
-tags webkit2_41,见 docs/wails2/。 - fyne 镜像装的是 OpenGL/X11/Wayland 开发包与
fyneCLI,编译应用直接fyne build/fyne package,见 docs/fyne/。 - mygo 镜像装的是 GTK3/WebKitGTK 4.1 开发包、无头运行库、
mygoCLI 与bun;mygo 的 Linux 后端纯 Go(运行期dlopenGTK3),编译应用不需要 build tag,见 docs/mygo/。 - gio 镜像装的是 EGL/GLES、X11、Wayland、Vulkan 开发包、无头运行库与打包工具
gogio(模块gioui.org/cmd,不是gio);gogio没有 linux 目标也没有version子命令,Linux 桌面程序就是普通go build+ cgo,镜像的价值在 cgo 依赖齐全(Dockerfile 里会真实编译一个最小 Gio 程序自证),见 docs/gio/。 - nsgo 镜像装的是 GTK4、WebKitGTK 6.0、GStreamer 开发包与无头运行库、
nsgoCLI(模块github.com/nsgo-dev/nsgo,上游无 tag,版本为伪版本);Linux 后端纯 Go、运行期dlopen,编译应用不需要 build tag,见 docs/nsgo/。 - viva 镜像装的是 XCB、Vulkan、GTK3/WebKit2GTK 4.1 开发包与无头运行库、
vivaCLI;Linux 默认后端是 XCB + Vulkan,可选的vivagtk构建标记会用到 GTK3/WebKit2GTK 4.1,见 docs/viva/。 - asuka 镜像装的是 GTK4、libadwaita 开发包与无头运行库、
asukaCLI(模块github.com/egoist/asuka,命令在cmd/asuka);Linux 目标直接asuka build -p linux即可,不需要额外 build tag,见 docs/asuka/。 - 三个平台的 Dockerfile 与脚本各自维护(
.cnb/、.github/与.gitlab/):改镜像内容、标签规则或冒烟断言时三处都要改;只改平台胶水时各改各的。平台层说明见 docs/cnb.md、docs/github.md 与 docs/gitlab.md。 - 安全报告走 SECURITY.md,贡献流程与硬性规则见 CONTRIBUTING.md。
- 文档入口:docs/README.md。
| 平台 | 地址 |
|---|---|
| CNB | https://cnb.cool/dtapp/golang |
| GitHub | https://github.com/dtapps/golang |
| GitLab | https://gitlab.com/dtapps/golang |
| Gitee | https://gitee.com/dtapps/golang |
| GitCode | https://gitcode.com/dtapp/golang |
见 LICENSE 文件。