Go 配置 GOPROXY 镜像源

平时我们在终端执行 go get 下载第三方包,或者在 VSCode 中安装 gopls 等扩展工具时,国内网络环境下很容易卡住半天。等上一段时间后,终端经常会报出类似下面的连接超时错误:

(报错)dial tcp 142.251.42.241:443: connectex: A connection attempt failed...

出现这个报错并不是我们的代码写错了,而是因为 Go 语言默认的模块代理服务器 proxy.golang.org 位于海外,在国内无法直接访问。想要解决这个问题非常简单,我们只需要把模块下载源 GOPROXY 切换为国内镜像站就可以了。

常用的国内镜像源

GOPROXY 是 Go 官方提供的模块代理配置项,其中 proxy 是英文 “代理、中转站” 的意思。国内镜像站会提前把常用的 Go 开源包缓存到国内节点。配置好之后,我们执行 go get 或 go mod tidy 时就会直接从国内服务器拉取,下载速度非常快。

目前国内稳定且免费开放的 Go 模块镜像源如下表所示。

常用 GOPROXY 镜像源
提供方 镜像地址 说明
七牛云(推荐) https://goproxy.cn 国内公益镜像源,稳定高速
阿里云 https://mirrors.aliyun.com/goproxy/ 阿里云维护的公共镜像源
Goproxy.io https://goproxy.io 开源社区维护的代理镜像源

大多数国内开发者平时优先使用的都是七牛云维护的 goproxy.cn,配好这一条地址就够用了。

配置与验证 GOPROXY

以前如果想修改这类代理参数,通常需要去操作系统的设置面板里手动添加系统环境变量,步骤比较繁琐。

而在现在的 Go 版本中,我们只需要打开命令提示符、PowerShell 或编辑器的内置终端,执行一次 go env -w 命令即可。修改后的全局配置会永久保存,以后创建的所有 Go 项目都会自动生效。

语法:

# 写入并永久保存配置
go env -w GOPROXY="镜像地址,direct"

# 查看当前生效的 GOPROXY 配置
go env GOPROXY

说明:

go env -w 中的 -w 是英文 “write(写入)” 的缩写,表示把配置写入 Go 自身的配置文件中永久保存,关闭终端或重启电脑后依然有效。

这里建议小伙伴们给等号后面的地址加上英文双引号。因为在 Windows 的 PowerShell 终端里,不加引号的英文逗号(,)会被当成参数分隔符而报错,加上双引号就能在所有系统的终端下通用。

为什么镜像地址末尾还要跟一个 ,direct 呢?这里的 direct 是英文 “直接连接” 的意思。把它跟在镜像地址后面,表示如果遇到刚发布或极冷门的包在镜像站里暂时找不到时,允许 Go 绕过镜像站,直接回原始代码仓库(如 GitHub)去拉取。

示例 1:配置并验证国内镜像源

# 1. 确保开启 Go Modules 模块模式
go env -w GO111MODULE=on

# 2. 将 GOPROXY 设置为七牛云国内镜像源
go env -w GOPROXY="https://goproxy.cn,direct"

# 3. 查看配置是否生效
go env GOPROXY

运行结果如下。

https://goproxy.cn,direct

分析:

第 1 行 go env -w GO111MODULE=on 表示确保开启 Go Modules 模块管理模式。从 Go 1.16 版本开始,该项默认就是 on,这里一并执行一次是为了防止旧环境曾经被改动过。

第 2 行设置好 GOPROXY 后,我们用第 3 行命令检查是否生效。只要终端输出 https://goproxy.cn,direct,就说明国内镜像源配置成功了。此时再去下载第三方库或安装编辑器插件,速度都会快很多。

注意:

  • Windows 系统冲突处理:如果以前在系统里手动加过 GOPROXY,执行 go env -w 时会报 does not override conflicting OS environment variable 警告,意思是无法覆盖冲突的系统变量。此时打开系统 “环境变量” 面板删掉旧的 GOPROXY,再重启终端重新执行即可。
  • macOS 与 Linux 系统冲突处理:如果同样遇到系统变量冲突警告,打开 ~/.zshrc 或 ~/.bash_profile 文件,移除原有的 GOPROXY 配置后重新打开终端再执行。

如果担心单个镜像站偶尔维护,我们还可以同时配置两个镜像源互为备份。

示例 2:串联配置备用镜像源

# 1. 用英文逗号串联七牛云与阿里云镜像源
go env -w GOPROXY="https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct"

# 2. 查看当前生效的配置
go env GOPROXY

运行结果如下。

https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct

分析:

在上面的命令中,我们使用英文逗号(,)把七牛云和阿里云两个镜像地址串联了起来。下载依赖包时,Go 会优先从排在第 1 位的 goproxy.cn 拉取。只有当第 1 个地址请求失败时,才会自动切换到第 2 个阿里云地址。

此外,如果以后想要撤销通过 go env -w 写入的自定义设置,我们可以执行下面的命令:

go env -u GOPROXY

其中 -u 是英文 “unset(取消设置)” 的缩写,执行后就会把 GOPROXY 恢复成 Go 出厂时的默认状态。平时正常开发时保留国内镜像源就可以了,不需要执行这条取消命令。

私有仓库配置 GOPRIVATE

在个人学习或使用公开的开源包时,只要配好上面的 GOPROXY 就够用了。不过进入公司参与团队开发后,公司内部一般会搭建自己的私有代码仓库,比如域名为 git.mycompany.com 的内网 GitLab。

公司内网的私有代码包不会出现在外部公共镜像站里,如果依然去公共镜像站查找就会报错。遇到这种情况,我们可以执行 go env -w GOPRIVATE="*.mycompany.com",让匹配该域名的私有包直接跳过公共代理,走公司内网拉取。

对于正在学习基础语法的小伙伴来说,本地没有公司内网私有仓库,暂时不需要配置 GOPRIVATE。

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号