Go的包管理工具（四）：Go Module Proxy

在前面的文章，我们介绍了Go Modules。Go module支持了Versioned Go，并初步解决了包依赖管理的问题。

新的工作模式也带来了一些问题，在大陆地区我们无法直接通过 go get 命令获取到一些第三方包，最常见的就是 golang.org/x 下面的各种优秀的包。一旦工作在模块下，go build 将不再关心 GOPATH 或是 vendor 下的包，而是到 GOPATH/pkg/mod 查询是否有cache，如果没有，则会去下载某个版本的 module，而对于某些包的 module，在大陆地区往往会失败。本文将重点介绍 go module 的 proxy 配置实现，包括如下两种的代理配置：

• GOPROXY
• Athens

GOPROXY

goproxy 是一个开源项目，当用户请求一个依赖库时，如果它发现本地没有这份代码就会自动请求源，然后缓存到本地，用户就可以从 goproxy.io 请求到数据。当然，这些都是在一个请求中完成的。goproxy.io 只支持 go module 模式。当用户执行 go get 命令时，会去检查 $GOPROXY//@v/list 这个文件中是否有用户想要获取的版本，如果有，就依次获取 $GOPROXY//@v/.info、$GOPROXY//@v/.mod、$GOPROXY//@v/.zip 等文件，如果没有就直接从源码库中去下载。

通过命令：

export GOPROXY=https://goproxy.io

设置了这个环境变量，一旦设置生效，后续 go 命令会通过 go module download protocol与 proxy 交互下载特定版本的 module。当然，我们还可以置空 GOPROXY 变量，来关闭 GOPROXY 代理。

详见： https://github.com/goproxyio/goproxy

Athens

Athens 是一个建立在 vgo（或者是1.11 +）之上的项目，试图让依赖关系更接近你，即使在 VCS 关闭时你也可以依赖可重复的构建。

依赖关系是来自 Github 的不可变的代码块和相关的元数据。 他们存储在 Athens 控制的仓库里。

您可能已经知道“不可变”意味着什么，但让我再次指出它，因为它对整个系统非常重要。当人们改变他们的包，迭代，实验或其他任何东西时，Athens 的代码都不会改变。如果软件包作者发布了一个新版本，Athens 将把它拉下来。比如某个项目依赖于包 M 版 v1.2.3，它将永远不会改变 Athens 上的包。

安装

Athens 支持多种方式的安装，docker 容器、k8s 和二进制安装包，本文将会介绍如何通过二进制包安装。

git clone https://github.com/gomods/athens
cd athens
make build-ver VERSION="0.2.0"

 ./athens -version

获取私有仓库

Athens 获取私有仓库中的 module，这也是一个企业级的需求。通常企业私有仓库都是需要身份验证的，因此我们需要在 Athens 中配置访问私有仓库的账号和凭证信息。目前 Athens 官方文档中提供了通过 .netrc 方式访问带有身份验证的私有仓库的功能。

通过创建 .netrc 文件，进行私有仓库身份验证。

//.netrc

machine github.com
  login MY_USERNAME
  password MY_PASSWORD

本地应用

export GO111MODULE=on
export GOPROXY=http://127.0.0.1:3000

我们可以使用 Athens 提供的 walkthrough。

git clone https://github.com/athens-artifacts/walkthrough.git

$ cd ../walkthrough
$ go run .
go: finding github.com/athens-artifacts/samplelib v1.0.0
handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.info [200]
handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.mod [200]
go: downloading github.com/athens-artifacts/samplelib v1.0.0
handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.zip [200]
The  says rawr!

go run . 的输出包括尝试查找 github.com/athens-artifacts/samplelib 依赖项。由于代理是在后台运行的，因此还可以看到来自 Athens 的输出，表明它正在处理对依赖项的请求。

global public proxy

Athens 还提供了一个试验性的 proxy：athens.azurefd.net 供全球gopher 使用。导入环境变量：

export GOPROXY="https://athens.azurefd.net"

当然虽然可以使用这些公有的代理，但是包的源并不是很全，最稳妥的方法还是自建 Athens 服务。官方issue中所说：

athens.azurefd.net 处于 alpha 的版本，目前基础设施还没有很好地维护，所以看到超时并不感到惊讶。自建 Athens 或使用 GoCenter（目前唯一的托管Go模块存储库）。

推荐阅读

Go的包管理工具

订阅最新文章，欢迎关注我的公众号

微信公众号

参考

1. Athens docs
2. 再探go modules：使用与细节