Go / 系统课时

让私有模块绕过公开代理

让私有模块绕过公开代理

仅设置仓库地址还不够,企业还需要确保私有模块不会被公开模块代理和公共校验服务处理。Go 的 GOPRIVATE、GONOPROXY、GONOSUMDB 与 GOPROXY 共同决定了这条依赖链如何走。

学习目标

  • 理解 GOPRIVATE 与公开代理、校验数据库之间的关系
  • 配置私有模块直连内部仓库,避免经过公开代理
  • 能检查最终环境并验证模块下载行为

GOPRIVATE 为什么能改变下载路径

GOPRIVATE 用来声明哪些模块属于私有范围。对于匹配到的模块,Go 默认会把这个范围用于相关的代理和校验排除设置,因此私有模块不会按照普通公开模块的方式访问公共代理和校验数据库。

常见的公开代理配置可能是:

bash
go env -w GOPROXY=https://proxy.golang.org,direct

这表示普通模块优先使用公共代理,代理无法提供时再尝试直接访问源站。

配置企业私有范围后:

bash
go env -w GOPRIVATE=git.corp.example.com

匹配 git.corp.example.com/... 的模块会按私有模块处理,不再走公共代理的正常获取路径。

什么时候显式设置 GONOPROXY 和 GONOSUMDB

大多数企业场景只配置 GOPRIVATE 就足够,因为它会作为相关默认范围使用。若组织已有复杂的环境变量策略,也可以显式写出相同范围,减少团队成员对实际行为的猜测:

bash
go env -w GOPRIVATE=git.corp.example.com
go env -w GONOPROXY=git.corp.example.com
go env -w GONOSUMDB=git.corp.example.com
go env -w GOPROXY=https://proxy.golang.org,direct

预期结果:

text
GOPRIVATE=git.corp.example.com
GONOPROXY=git.corp.example.com
GONOSUMDB=git.corp.example.com
GOPROXY=https://proxy.golang.org,direct

这里要区分三个职责:GOPROXY 决定模块获取使用哪些代理;GONOPROXY 指定哪些模块不使用代理;GONOSUMDB 指定哪些模块不使用公共校验数据库。GOPRIVATE 则提供私有模块范围,并可作为后两者的默认依据。

验证私有模块是否按预期获取

先确认配置:

bash
go env GOPRIVATE GONOPROXY GONOSUMDB GOPROXY

预期结果:

text
git.corp.example.com
git.corp.example.com
git.corp.example.com
https://proxy.golang.org,direct

然后在一个已经包含私有模块依赖的 Go 项目中执行:

bash
go mod download

预期结果:

text
命令成功完成;私有模块按当前 GOPRIVATE/GONOPROXY 规则获取,具体输出可能为空或因 Go 版本与缓存状态不同而变化。

常见配置误区

最容易出错的是只修改 GOPROXY,却没有定义私有模块范围。这样无法准确表达“哪些模块不能经过公开服务”。另一个问题是范围写得过大,例如直接覆盖整个顶级域名,导致本来可以使用公共代理和校验数据库的模块也被视为私有。

实际部署时,应先列出企业模块路径的共同前缀,再决定 GOPRIVATE 的范围;只有确实存在特殊规则时,才额外配置 GONOPROXY 或 GONOSUMDB。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让私有模块绕过公开代理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通