背景

在 NAS 上搭建开发环境, 发现安装 vim-go 时, 一直有报错: request timeout, dial tcp 172.217.24.17:443: i/o timeout 原因应该是 GFW 导致 vim-go 部分依赖包下载失败。

在做 Go 项目开发的时候,会经常依赖各种轮子,所以需要有类似 Proxy,用于快速下载各种 Package(有 VPN 的请忽略)。

Module proxy protocol

Go Modules 是 Golang 官方最近几个版本推出的包管理工具, Go Mod 支持 Module proxy protocol , 配置后用户可以转发请求到代理服务器(但是不支持请求参数),来获取源服务器上的依赖包。

Modules proxy 在处理最近版本包的下载请求, 会先在服务器上找 @latest 对应的包。如果没有找到会请求<module/@v/list>, 拿到最新预发布的版本号并下载。

同时 proxy protocol 会对请求路径中的 <module><version> 的大写字母转换成小写,以解决在大小写文件系统上可能存在的冲突。

即使直接从版本控制系统下载,go 命令也会合成显式信息、mod 和 zip 文件,并将其存储在本地缓存 $GOPATH/pkg/mod/cache/download 中, 从 proxy 服务器上下载的包也会放到这个文件夹上。 因为缓存地址和 Proxy URL 下载文件存储地址相同, 通过设置 GOPROXY=https://example.com/proxy,允许用户访问这些缓存的模板版本。

Goproxy

Goproxy 是一个基于 Go 的 module proxy protocol 协议实现的一个代理处理器,用于快速接入模块的代理, 使用方法详见官方文档。

同时 Goproxy 官方提供了一个很完整的包代理服务器。

解决方案

1
2
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

总结

本文主要分析 Go 官方最近推出的 Module proxy protocol 如何加速依赖包下载的工作原理, 并提供一种通过 Goproxy 快速解决请求超时导致的包下载失败的处理办法。

参考

  1. Goproxy
  2. Module proxy protocol