17370845950

Go模块代理通过配置GOPROXY环境变量（如https://goproxy.cn,direct）可解决国内访问proxy.golang.org慢或失败问题，推荐使用goproxy.cn并配合GOSUMDB=off和GOPRIVATE处理校验错误与私有模块。

Go 模块代理（Go Proxy）是解决国内访问 proxy.golang.org 慢或超时、模块拉取失败的核心方案。只需正确配置环境变量或 Go 命令参数，就能显著提升依赖下载速度和稳定性。

设置 GOPROXY 环境变量（推荐）

这是最常用、最稳定的方式，适用于所有 Go 命令（go get、go mod download 等）。

• 临时生效（当前终端）：
  export GOPROXY=https://goproxy.cn,direct
• 永久生效（写入 shell 配置）：
  在 ~/.bashrc 或 ~/.zshrc 中添加：
  export GOPROXY=https://goproxy.cn,direct
  然后执行 source ~/.bashrc（或 source ~/.zshrc）
• direct 表示：当代理无法提供某模块时，回退到直接从模块源仓库（如 GitHub）拉取，避免因代理缺失导致失败

可选的国内可信代理地址

多个镜像可互为备份，按需组合使用：

• goproxy.cn（七牛云维护，稳定、更新快，推荐首选）
• goproxy.io（原官方支持，现由社区维护，可用但偶有延迟）
• https://mirrors.aliyun.com/goproxy/（阿里云镜像，适合内网或企业环境）
• 多代理串联写法：GOPROXY=https://goproxy.cn,https://goproxy.io,direct

跳过校验与私有模块处理

某些场景下还需配合其他变量确保顺利拉取：

• 若遇到 verifying ...: checksum mismatch 错误，可能是代理缓存与源不一致，可临时跳过校验（仅调试用）：
  export GOSUMDB=off
• 若项目含私有 Git 仓库模块（如公司内部 GitLab），需让 Go 绕过代理直连：
  export GOPRIVATE=git.example.com/internal/*（替换为你的私有域名和路径前缀）
• 多个私有域名用逗号分隔：GOPRIVATE=git.example.com,github.company.com

验证配置是否生效

执行以下命令确认当前配置和实际行为：

• 查看当前代理设置：go env GOPROXY
• 触发一次模块下载并观察日志：go mod download github.com/go-sql-driver/mysql@v1.7.1
  成功时会显示类似 Fetching https://goproxy.cn/github.com/go-sql-driver/mysql/@v/v1.7.1.info
• 检查是否跳过私有模块：go env GOPRIVATE，再尝试拉取私有模块，应无代理 URL 日志输出

不复杂但容易忽略的是：GOPROXY 必须包含 direct 回退项，且 GOPRIVATE 要精确匹配私有路径——配错会导致部分模块走代理失败或泄露代码。