推荐优先使用 https://goproxy.cn,它兼容 Go 1.13+,自动处理校验和,且对私有仓库支持较好;设置方式包括临时 export、永久 go env -w 和单次命令覆盖,并需配合 GOPRIVATE 跳过私有模块代理。

直接配置 GOPROXY 是提升 Go 模块下载速度最简单有效的方式,尤其在国内访问官方 proxy.golang.org 常常缓慢或失败。设置一个可靠的代理地址,能让 go get、go mod download 等命令跳过直连,从国内镜像快速拉取模块。
常用 GOPROXY 配置地址
目前稳定可用的公开代理主要有:
- https://goproxy.cn(七牛云维护,国内首选,支持 HTTPS 和私有模块)
- https://proxy.golang.org(官方代理,海外访问快,国内不稳定)
- https://goproxy.io(已停止维护,不建议使用)
- https://mirrors.aliyun.com/goproxy/(阿里云镜像,可用但偶尔同步延迟)
推荐优先使用 https://goproxy.cn,它兼容 Go 1.13+,自动处理校验和,且对私有仓库支持较好(配合 GOPRIVATE 可绕过代理)。
设置 GOPROXY 的三种方式
Go 会按顺序读取环境变量、go env -w 配置、命令行参数,优先级从高到低:
立即学习“go语言免费学习笔记(深入)”;
-
临时设置(当前终端生效):
export GOPROXY=https://goproxy.cn,direct -
永久设置(推荐):
go env -w GOPROXY=https://goproxy.cn,direct
执行后会写入$HOME/go/env,所有后续终端自动生效。 -
单次命令覆盖:
GOPROXY=https://goproxy.cn go get github.com/sirupsen/logrus
注意末尾的 ,direct:表示对 GOPRIVATE 中指定的私有域名(如公司内网模块)不走代理,直接拉取,避免泄露或认证失败。
2010.09.03更新优化前台内核处理代码;优化后台内核、静态生成相关代码,生成速度全面提升;修改前台静态模板中所有已知错误;修正后台相关模块所有已知错误;更换后台编辑器,功能更强大;增加系统说明书。免费下载、免费使用、完全无限制。完全免费拥有:应广大用户要求,千博网络全面超值发布企业网站系统个人版程序包:内含Flash动画源码、Access数据库程序包、SQL数据库程序包。全站模块化操作,静态
配合 GOPRIVATE 跳过私有模块代理
如果你的项目依赖公司内部 Git 仓库(如 git.company.com/my/lib),必须跳过代理,否则会 404 或鉴权失败:
- 设置私有域名前缀:
go env -w GOPRIVATE=git.company.com - 支持通配符:
go env -w GOPRIVATE=*.company.com,github.company.internal - 多个用逗号分隔,无需空格。
设置后,Go 会自动对匹配域名的模块跳过 GOPROXY,改用 git clone 或 https 下载,并尊重 ~/.netrc 或 Git 凭据管理器。
验证和排错小技巧
配置完可以快速检查是否生效:
- 查看当前值:
go env GOPROXY - 触发一次模块下载并观察日志:
go mod download -x github.com/go-sql-driver/mysql@v1.7.1
输出中若出现GET https://goproxy.cn/github.com/go-sql-driver/mysql/@v/v1.7.1.info即表示走代理成功。 - 如果仍慢或报错,检查是否漏设
GOPRIVATE,或代理地址拼写错误(注意是https,不是http)。
不复杂但容易忽略。









