Golang Go语言首发特性：goproxy.cn 现已推出首个 Go 模块代理统计数据 API

前言

这周很值得纪念，首先是 goproxy.cn 已缓存的模块版本总数突破了一百万，这甚至比起 Go 官方的 proxy.golang.org 已缓存的还要多出不少。其次是 goproxy.cn 的日访问量已稳定在千万级，正在朝着亿级进发，目前这在国内我了解到的别的几个同类服务中是最多的了。另外尤为重要的一点是，经过我们的不懈努力，甚至付出了两次事故的代价（详见：status.goproxy.cn），我们终于使得 goproxy.cn 达到了零错误率！现在的 goproxy.cn 可以说是很稳的了，大家可以放心使用。当然，我也知道最近一个月可能有些朋友对 goproxy.cn 产生了些许的不信任感，这个责任在我个人。我为了实现零错误率尝试过了太多不寻常的操作，很多人都告诉我不可能、别想了，但我自己爱折腾的毛病致使我无法不去研究。我坚信哪怕只有两三天的零错误率也能为服务的可靠性大大地加上一分，所以我不停地尝试不同的方法，导致了这个月间断性地出过几次问题。我在 www.v2ex.com/t/651330 这片帖子中也有解释过，我曾在潜意识里认为 goproxy.cn 还是那个我自己搭建自己跑的鲜有人用的小服务，所以做事欠考虑，甚至还跟别人说出过“我不介意用事故来换取低错误率的优化方式”这种不负责任的话……在这里我再次为自己的鲁莽行为向大家郑重地道个歉，以后我会铭记“基础服务以稳定为本”这句话，克制住自己爱折腾的毛病……恐怕在所有同类服务的维护者中只有我是最喜欢瞎搞的了……

好了，开头稍微为这一个月发生的事情做了个小总结。接下来说一下本次的重点，也就是 goproxy.cn 推出了 Go 模块代理世界中的首个统计数据 API （文档详见：goproxy.cn/stats），这是个原本计划在二月底就发布的特性。统计数据 API 其实很早就开发完了（几个月前就基本完工了），但却迟迟未发布，主要原因是跟我们前一阵子在探索零错误率相关，我们想在一个完美的时间点把它介绍给大家。这一阵子有很多大佬催过我，比如光无闻大哥一人就已经催过我很多次了……在这里统一道个歉……当然，迟到总比不到好，让大家久等了！

目前先推出了 4 种呼声较高的 API，后续可能还会有其他 API 被添加进来。

*注意：由于数据不慎丢失，目前 goproxy.cn 的数据统计 API 所展示的只是最近三个月的数据，而不是自 goproxy.cn 上线起的所有历史数据。

API：获取服务摘要

首先是一个用于获取服务摘要信息的 API，通过调用这个 API 你可以获取到 goproxy.cn 中诸如所有模块版本的总尺寸和总数等信息。

获取服务摘要 API 的 URL 是固定的，没有路径参数：goproxy.cn/stats/summary。

{
	"cacher_size": 2663405247231,
	"module_version_count": 1035421,
	"module_host_count": 1120,
	"top_10_module_hosts": [
		{"module_host": "github.com", "module_version_count": 921606},
		{"module_host": "k8s.io", "module_version_count": 24982},
		{"module_host": "gitlab.com", "module_version_count": 13172},
		{"module_host": "gopkg.in", "module_version_count": 10479},
		{"module_host": "golang.org", "module_version_count": 8000},
		{"module_host": "gitee.com", "module_version_count": 4650},
		{"module_host": "bitbucket.org", "module_version_count": 4177},
		{"module_host": "sigs.k8s.io", "module_version_count": 3280},
		{"module_host": "google.golang.org", "module_version_count": 2703},
		{"module_host": "istio.io", "module_version_count": 2487}
	]
}

上面的示例响应中各字段的含义如下：

cacher_size：所有模块版本的总尺寸，单位是“字节”
module_version_count：所有模块版本的总数
module_host_count：模块主机地址的总数
top_10_module_hosts：所拥有的模块版本数排名前十的模块主机地址
top_10_module_hosts.module_host：模块主机地址
top_10_module_hosts.module_version_count：模块主机地址所拥有的模块版本总数

API：获取模块趋势

然后呼声蛮高的一个 API 就是获取服务中的模块趋势，有很多人好奇自己的模块在 goproxy.cn 中的活跃度排名究竟是怎样的。

目前我们提供了三类趋势，它们均只返回一段时间内的最活跃的最多前 1000 个模块：

goproxy.cn/status/trends/latest：获取最新趋势
goproxy.cn/status/trends/last-7-days：获取最近 7 天的趋势
goproxy.cn/status/trends/last-30-days：获取最近 30 天的趋势

[
	{"module_path": "golang.org/x/sys", "download_count": 1822180},
	{"module_path": "golang.org/x/net", "download_count": 1713080},
	{"module_path": "golang.org/x/tools", "download_count": 1503522},
	{"module_path": "golang.org/x/crypto", "download_count": 1032270},
	{"module_path": "gopkg.in/yaml.v2", "download_count": 578120}
]

上面的示例响应中各字段的含义如下：

module_path：模块路径
download_count：模块路径对应的所有模块版本的总下载次数

API：获取模块（版本）统计

当然，我们支持获取服务中指定模块（版本）的统计，这也算是统计数据 API 的刚需了。

获取模块（版本）统计的 API 的 URL 格式为 goproxy.cn/stats/<module-path>[@<module-version>]。如 goproxy.cn/stats/golang.org/x/text 表示获取模块路径为 golang.org/x/text 的模块的所有模块版本的总统计，而 goproxy.cn/stats/golang.org/x/[email protected] 表示获取该模块的 v0.3.2 版本的统计。

{
	"download_count": 476705,
	"last_30_days": [
		{"date": "2020-03-25T00:00:00Z", "download_count": 8778},
		{"date": "2020-03-24T00:00:00Z", "download_count": 16884},
		{"date": "2020-03-23T00:00:00Z", "download_count": 15842},
		{"date": "2020-03-22T00:00:00Z", "download_count": 11232},
		{"date": "2020-03-21T00:00:00Z", "download_count": 11894},
		{"date": "2020-03-20T00:00:00Z", "download_count": 14968},
		{"date": "2020-03-19T00:00:00Z", "download_count": 11017},
		{"date": "2020-03-18T00:00:00Z", "download_count": 5209},
		{"date": "2020-03-17T00:00:00Z", "download_count": 5759},
		{"date": "2020-03-16T00:00:00Z", "download_count": 4166},
		{"date": "2020-03-15T00:00:00Z", "download_count": 2145},
		{"date": "2020-03-14T00:00:00Z", "download_count": 2218},
		{"date": "2020-03-13T00:00:00Z", "download_count": 4609},
		{"date": "2020-03-12T00:00:00Z", "download_count": 5503},
		{"date": "2020-03-11T00:00:00Z", "download_count": 5412},
		{"date": "2020-03-10T00:00:00Z", "download_count": 6453},
		{"date": "2020-03-09T00:00:00Z", "download_count": 4798},
		{"date": "2020-03-08T00:00:00Z", "download_count": 2323},
		{"date": "2020-03-07T00:00:00Z", "download_count": 2332},
		{"date": "2020-03-06T00:00:00Z", "download_count": 4806},
		{"date": "2020-03-05T00:00:00Z", "download_count": 6339},
		{"date": "2020-03-04T00:00:00Z", "download_count": 5858},
		{"date": "2020-03-03T00:00:00Z", "download_count": 5579},
		{"date": "2020-03-02T00:00:00Z", "download_count": 8862},
		{"date": "2020-03-01T00:00:00Z", "download_count": 2119},
		{"date": "2020-02-29T00:00:00Z", "download_count": 2053},
		{"date": "2020-02-28T00:00:00Z", "download_count": 4735},
		{"date": "2020-02-27T00:00:00Z", "download_count": 6578},
		{"date": "2020-02-26T00:00:00Z", "download_count": 4954}
	],
	"top_10_module_versions": [
		{"module_version": "v0.3.2", "download_count": 232795},
		{"module_version": "v0.3.0", "download_count": 146009},
		{"module_version": "v0.3.1-0.20180807135948-17ff2d5776d2", "download_count": 67096},
		{"module_version": "v0.3.1-0.20181227161524-e6919f6577db", "download_count": 11494},
		{"module_version": "v0.0.0-20160726164857-2910a502d2bf", "download_count": 11223},
		{"module_version": "v0.0.0-20170915032832-14c0d48ead0c", "download_count": 3991},
		{"module_version": "v0.3.1-0.20171227012246-e19ae1496984", "download_count": 1128},
		{"module_version": "v0.0.0-20170915090833-1cbadb444a80", "download_count": 937},
		{"module_version": "v0.3.1-0.20181030141323-6f44c5a2ea40", "download_count": 480},
		{"module_version": "v0.3.1", "download_count": 353}
	]
}

上面的示例响应中各字段的含义如下：

download_count：模块（版本）的总下载次数
last_30_days：模块（版本）最近 30 天的统计
last_30_days.date：模块（版本）统计的日期
last_30_days.downlaod_count：模块（版本）单日的下载次数
top_10_module_versions：该字段仅在根据模块路径获取其对应的所有模块版本的总统计时才会返回，表示其下载次数排行前十的模块版本
top_10_module_versions.module_version：模块版本
top_10_module_versions.download_count：模块版本的下载次数

API：获取模块总下载次数徽章

为了使模块作者们能更好地展示自己的模块在 goproxy.cn 的总下载次数，我们支持了 SVG 徽章。

获取模块总下载次数徽章的 API 的 URL 格式为 goproxy.cn/stats/<module-path>/badges/download-count.svg。

你可以通过下述 Markdown 语法轻松地将指定模块的总下载次数徽章放入项目 README.md 中：

[![goproxy.cn]( https://goproxy.cn/stats/<module-path>/badges/download-count.svg)]( https://goproxy.cn)

比如 goproxy.cn/stats/golang.org/x/text/badges/download-count.svg：

结语

由于我们是首家支持统计数据 API 的 Go 模块代理，所以我们预留了一段时间的功能探索期，在此期间内我们欢迎大家随时通过 goproxy.cn/stats 页面中提到的联系方式来分享你们的意见建议，一起为咱们中国 Go 语言社区的这个 Go 模块代理打造出一个功能性良好的统计数据 API 。

最后再强调一点，goproxy.cn 由七牛运营，服务于 Go 语言社区，它永久免费，也一如既往地不加以任何形式的带宽限制、速率限制，大家可以敞开了用、放心地用。有问题？问；有建议？提。我们一直那里，欢迎随时来访。

更多关于Golang Go语言首发特性：goproxy.cn 现已推出首个 Go 模块代理统计数据 API的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html

sinazl 1楼•1 天前

这是什么东东？科学上网？

更多关于Golang Go语言首发特性：goproxy.cn 现已推出首个 Go 模块代理统计数据 API的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html

itying888 2楼•1 天前

这是一个类似于 Docker Reistry 、NPM 、RubyGems 的用来加速项目构建的东东，但是是给 Go 语言用的。并且，也的确是可以在一定程度上避免在使用 go get 等命令抓包时可能出现的 DNS 污染、电信运营商拦截等现象。

wuwangju 3楼•1 天前

严重支持，有了 go mod 和 goproxy.cn ，编译起程序来真是太方便了

htzhanglong 4楼•1 天前

支持一下

nodeper 5楼•1 天前

之前一直用 cn 这个，但是有时候同步包出现错误，换 io 那个正常，不确定是什么问题，

itying888 6楼•1 天前

不是太懂原理。代理有延迟吗，比如 github 上刚刚更新了 latest 版本，我获取到的是最新的版本吗？

sinazl 7楼•1 天前

👍

nodeper 8楼•1 天前

支持

yuanlaile 9楼•1 天前

666
一直用 goproxy.cn

songsunli 10楼•1 天前

感谢奉献，是用国内存储缓存的包数据么，挺好奇是咋实现的。

nodeper 11楼•1 天前

抱歉，这个应该跟我自己的操作有关了，我们前一阵子在探索零错误率，所以导致了一些问题的产生。不过现在已经搞定了，错误应该也基本都消失了，老哥你愿意的话可以再尝试一下。再遇到问题欢迎随时去提 issue，我们会尽快回应的。

bupafengyu 12楼•1 天前

可以顺手写个趋势页面啊

ionicwang 13楼•1 天前

这个跟传统的比如 APT 镜像源之类的倒不完全一样，Go 模块代理可以做到零延迟，至少 goproxy.cn 是这么实现的。比如你在 GitHub 上刚提交了一个代码修改，那么你是可以通过 go get github.com/foo/barmaster 立刻拿到那个修改的，此时就是零延迟。同理，如果打了个新的 Tag，比如 v1.2.3，那么也是可以通过 go get github.com/foo/[email protected] 立刻拿到的，同样也是零延迟。

nodeper 14楼•1 天前

songsunli 15楼•1 天前

go get 怎么用这个代理啊

htzhanglong 16楼•1 天前

支持 👍

gougou168 17楼•1 天前

👍👍👍

yuanlaile 18楼•1 天前

首页有“用法”说明的，其实很简单，就是修改 GOPROXY 环境变量：

export GOPROXY=https://goproxy.cn,direct

需要注意的就是另外也建议把 GO111MODULE 环境变量设置为 on，发现很多朋友在遇到问题时都是不明白默认值 auto 的含义，所以建议设置为 on 一劳永逸。

nodeper 19楼•1 天前

WIP……先把 API 放出来了让大家用着，集思广益。

bupafengyu 20楼•1 天前

谢谢，给我们这些 goer 提供了很大的方便，赞！

nodeper 21楼•1 天前

好奇你们如果盈利呢？
很感谢你们的代理服务，有在用。

htzhanglong 22楼•1 天前

不盈利，是七牛无偿提供的服务基础设施支持，毕竟七牛和 Go 的关系很深，他们对此是很慷慨的。而且七牛之前也支持过类似的其他服务，staticfile.org 相信也有不少人用过。

phonegap100 23楼•1 天前

太慷慨了，感谢感谢

sinazl 24楼•1 天前

Gopher

htzhanglong 25楼•1 天前

七牛真是国内少数几家具有极客精神的公司，从创始人到产品都是，期待有一天能到七牛工作

vueper 26楼•1 天前

一直在用 goproxy.io ，没想到还有个 cn

caililin 27楼•1 天前作者

赞！我用的就是这个

nodeper 28楼•1 天前

支持支持，一直在用这个，也推荐给实验室同学使用了。经常在 go tg 群里见到你发言～

ionicwang 29楼•1 天前

大赞，一直在用，稳如磐石！

songsunli 30楼•1 天前

严重支持，有了 go mod 和 goproxy.cn ，稳如老狗

nodeper 31楼•1 天前

大赞我总是开飞机去拖货~ 这个太棒了~

caililin 32楼•1 天前作者

之前学 go 的时候被 go get 折腾的死去活来，用了 goproxy.cn 之后爽到飞起，感谢作者和七牛🙏

itying888 33楼•1 天前

群 id 是啥呀，求告知

yuanlaile 34楼•1 天前

同求 go tg 的车

sinazl 35楼•1 天前

反对代理，我们需要中南 hai 专线

eggper 36楼•1 天前

请问这个项目和七牛是什么关系呢？一下子是自己搭建，一下子是七牛运营，有点懵
。。。

itying888 37楼•1 天前

https://t.me/GolangCN

gougou168 38楼•1 天前

同上

h691938207 39楼•1 天前

验证码填错了，直接给我拉黑了😭

caililin 40楼•1 天前作者

cool ～

itying888 41楼•1 天前

七牛提供的「基础设施」，具体可以去 https://github.com/goproxy/goproxy.cn 看看

gougou168 42楼•1 天前

抱歉，可能是我叙述的不是很清楚所以让大家产生了误解。这个项目大概是去年二月底三月初我还在学校的时候开发的，我自己的确也跑了一段时间（大概几个月），随后我跟七牛的 CEO 许叔提议了一下要把这个项目交给七牛来运营，他一口就答应了。现在这个项目跟七牛的关系是它完全属于七牛，包括它的域名也是备案在七牛名下的（沪 ICP 备 11037377 号-56 ），我跟这个项目的关系是我目前还是它的维护者。所以大家可以放心使用，因为它不是一个个人项目。❤️

gougou168 43楼•1 天前

感恩大神对国内 Go 开发体验的巨大促进！大神目前在哪高就啊？

vueper 44楼•1 天前

好的,测试确实正常了，还会正常使用的，辛苦大佬了

bupafengyu 45楼•1 天前

小弟我目前还在家里等待着疫情结束……😩

eggper 46楼•1 天前

支持支持，goproxy.cn 出来之后，就从 goproxy.io 转移过来了

h691938207 47楼•1 天前

好用！

ionicwang 48楼•1 天前

一直用这个

yuanlaile 49楼•1 天前

这个不好吗？ goproxy.io ，新手

gougou168 50楼•1 天前

针对您提到的Golang Go语言首发特性——goproxy.cn推出的首个Go模块代理统计数据API，以下是我的专业回复：

goproxy.cn此次推出的Go模块代理统计数据API，是Go语言社区的一个重要里程碑。这一特性为开发者提供了更加便捷的方式来查询和监控Go模块的使用情况，从而优化模块管理和依赖关系。

通过该API，开发者可以轻松获取服务中所有模块版本的统计数据，了解模块的活跃度、版本分布等信息。这不仅有助于开发者更好地掌握项目的依赖状况，还能在模块升级、兼容性评估等方面提供有力支持。

值得一提的是，goproxy.cn的RESTful API设计得体，使得查询过程简单明了。开发者只需按照API文档中的说明，发送相应的HTTP请求，即可获取所需的统计数据。

此外，goproxy.cn还提供了自托管Go模块代理搭建方案，使得开发者可以在现有的Web服务中轻松引入Go模块代理支持。这一功能进一步增强了Go语言在模块管理方面的灵活性和可扩展性。

总之，goproxy.cn推出的首个Go模块代理统计数据API为Go语言社区带来了福音，将极大提升开发者在模块管理和依赖关系优化方面的效率。