17370845950

真正禁用 Go 模块代理需设 GOPROXY=direct，而非留空；同时应配置 GOPRIVATE 匹配私有域名，并可选设 GOSUMDB=off 绕过校验，配合 Git 凭据确保私有仓库访问。

如何彻底禁用 Go 的模块代理（GOPROXY）

Go 默认会通过 GOPROXY 从公共代理（如 https://proxy.golang.org）下载模块，这在无法访问外网或需要走私有仓库时会导致失败。禁用代理不是“设为空字符串”那么简单——Go 1.13+ 会把空值视为未设置，自动 fallback 到默认代理。

真正禁用的方式是显式设置为 direct：

go env -w GOPROXY=direct

这样 Go 会跳过所有代理，直接向模块的 go.mod 中声明的源地址（如 GitHub、GitLab 或私有 Git 服务器）发起请求。注意：direct 不等于关闭校验，GOSUMDB 仍会生效。

同时绕过校验：禁用 sumdb 和私有模块认证问题

仅设 GOPROXY=direct 后，还可能遇到两个典型问题：

• verifying github.com/xxx/yyy@v1.2.3: checksum mismatch —— 因 GOSUMDB 仍尝试校验，但私有模块没发布到官方 sumdb
• 401 Unauthorized 或 fatal: could not read Username —— Git 认证失败，尤其用 SSH 或 Token 访问私有仓库时

对应处理方式：

• 禁用校验：

  go env -w GOSUMDB=off

• 确保 Git 能凭据登录：对 HTTPS 仓库，配置 git config --global credential.helper store 并首次手动输入账号密码；对 SSH 仓库，确认 ~/.ssh/id_rsa 已加载且 git@your-git-server.com 可 ssh 连通

临时禁用 vs 永久禁用：按场景选择作用域

用 go env -w 是全局永久修改，影响所有项目。开发中更安全的做法是临时覆盖：

• 单次命令生效：

  GOPROXY=direct GOSU
  MDB=off go build

• 当前 shell 会话生效：

  export GOPROXY=direct; export GOSUMDB=off

• CI/CD 脚本中推荐用环境变量前缀方式，避免污染构建机全局配置

注意 Windows PowerShell 用户需用 $env:GOPROXY="direct"，CMD 则用 set GOPROXY=direct，语法不通用。

私有模块路径匹配失败？检查 GOPRIVATE 设置

即使用了 direct，Go 仍会对匹配 GOPRIVATE 模式的模块跳过代理和校验。如果你的模块域名是 git.internal.company.com，但没配置它：

• Go 仍可能尝试走 proxy.golang.org 查找该路径（导致 404）
• GOSUMDB=off 也不会自动生效，除非域名被 GOPRIVATE 显式涵盖

正确做法是添加匹配规则：

go env -w GOPRIVATE=git.internal.company.com,github.com/my-org/*

支持通配符 * 和逗号分隔多个域名。注意：正则不支持，只认前缀匹配；子域名需单独列，example.com 不匹配 api.example.com。

最易忽略的是：GOPRIVATE 必须在 GOPROXY=direct 之前生效，否则 Go 在解析模块路径阶段就已决定是否走代理。