离线局域网GitLab的Golang环境搭建与CI runner编译配置-Golang-PHP中文网

离线搭建go环境必须提前准备go二进制包、golang.org/x/等预编译模块（通过go mod download获取）及可选的go.dev离线文档；需配置goroot、path、gopath并写入/etc/profile.d/；构建时设goproxy=direct、gosumdb=off，用-mod=readonly确保不联网。

离线局域网gitlab的golang环境搭建与ci runner编译配置

离线环境必须提前准备哪些 Go 依赖文件

只解压 go1.22.3.linux-amd64.tar.gz 不够，go build 仍会报错：module golang.org/x/net@latest found, but does not contain package golang.org/x/net/http2。这是因为 golang.org/x/ 系列模块（如 x/net、x/sys、x/text、x/exp）不包含在主二进制包中，且离线时无法通过 go get 补全。

在联网机器上，用与目标环境**完全一致的 Go 版本**执行：go mod download -x golang.org/x/net golang.org/x/sys golang.org/x/text golang.org/x/exp
打包整个 $GOPATH/pkg/mod 目录（保留原始目录结构），连同 go.sum 一并拷贝
若项目用到私有模块（如 gitlab.internal.com/group/project），需提前在联网机运行 go mod download gitlab.internal.com/group/project 并同步其 /pkg/mod/cache/download/ 下对应路径

如何让离线 runner 正确识别 GOPROXY 和校验开关

即使配置了 GOPROXY=direct，CI job 仍可能卡在 verifying github.com/sirupsen/logrus@v1.9.3 —— 这是 Go 默认启用 GOSUMDB=off 失效或未被子进程继承导致的。

必须在 .gitlab-ci.yml 的 before_script 中显式设置：export GOPROXY=direct GOSUMDB=off GO111MODULE=on
若使用自定义 builder 镜像，这些变量应写入镜像的 /etc/profile.d/golang.sh，而非仅用户级 ~/.bashrc
加 -mod=readonly 到构建命令，避免意外触发 module 下载：go build -mod=readonly -o bin/app ./cmd/app

runner 容器挂载 docker.sock 后仍无法 build image 的原因

常见现象：job 中执行 docker build 报错 Cannot connect to the Docker daemon，即使已挂载 /var/run/docker.sock。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

确认 runner 启动时用了 --privileged 或至少 --cap-add=SYS_ADMIN（某些内核版本必需）
检查挂载路径是否一致：host 上 /var/run/docker.sock 必须映射到容器内相同路径，不能是 /docker.sock
如果 runner 使用 docker executor，还需在 config.toml 的 [runners.docker] 段中添加：volumes = ["/var/run/docker.sock:/var/run/docker.sock:rw"]
验证容器内能否调用：docker info | grep 'Server Version'，失败则说明 socket 权限或路径不对

离线 CI 中 go test 覆盖率和竞态检测为何常失败

go test -race 或 go test -cover 在离线环境下容易 panic 或超时，根本原因是 Go 工具链默认尝试访问 https://proxy.golang.org 获取 runtime 支持包（如 runtime/race 的预编译 stub）。

必须提前在联网机用相同 Go 版本运行一次完整测试：go test -race ./... && go test -cover ./...，触发下载并缓存所需 internal 包
打包 $GOROOT/src/runtime/race 和 $GOROOT/pkg/linux_amd64/runtime/race.a（按实际架构调整）一并带入离线环境
CI 中禁用网络探测：go test -race -vet=off -mod=readonly ./...，避免 vet 阶段触发 module lookup

离线 CI 最容易被忽略的不是 Go 本身，而是 go tool 子命令（如 cover、trace、pprof）隐式依赖的 runtime 数据——它们不会出现在 go.mod 里，但会在首次调用时尝试联网补全。