golang

随着 go module 的不断普及，通常情况下，我们可以直接使用 goproxy.io 公共服务来解决海外依赖问题，但是有时候公司内部的仓库就很难办了，这些 git server 通常运行在企业内网环境下，开发人员既想能快速的下载海外依赖，又想能下载到公司内部的代码库。这时候可以在公司内部部署一个属于自己的 goproxy.io 服务来解决这个问题。还有哪些场景需要我们自己部署公司内部的 goproxy server 呢

  • 访问公司内网的 git server
  • 防止公网仓库变更或者消失，导致线上编译失败或者紧急回退失败
  • 公司审计和安全需要
  • 防止公司内部开发人员配置不当造成 import path 泄露
  • cache 热点依赖，降低公司公网出口带宽

编译

确保要运行的服务器是已经安装了 go 命令，goproxy 项目是开源的，用 go 语言开发，使用 go modules 可以很方便的进行编译：

  1. git clone https://github.com/goproxyio/goproxy.git
  2. cd goproxy
  3. make

服务运行模式

编译好的文件位置是 ./bin/goproxy ， 使用 ./bin/goproxy -h 查看参数使用说明：

  1. Usage of ./bin/goproxy:
  2.   -cacheDir string
  3.         go modules cache dir  [指定 Go 模块的缓存目录]
  4.   -exclude string
  5.         exclude host pattern  [proxy 模式下指定哪些 path 不经过上游服务器]
  6.   -listen string
  7.         service listen address [服务监听端口，默认 8081]
  8.   -proxy string
  9.         next hop proxy for go modules [指定上游 proxy server，推荐 goproxy.io]

Proxy Mode

如果服务没有访问海外资源的需求，只访问公司内部资源可以不指定上游服务器，启动服务：

  1. ./bin/goproxy -listen=0.0.0.0:80 -cacheDir=/tmp/test

Router Mode

  1.                                          direct
  2.                       +----------------------------------> private repo
  3.                       |
  4.                  match|pattern
  5.                       |
  6.                   +---+---+           +----------+
  7. go get  +-------> |goproxy| +-------> |goproxy.io| +---> golang.org/x/net
  8.                   +-------+           +----------+
  9.                  router mode           proxy mode

使用 -proxy 参数启用 Router mode, Router 模式下你将可以配置哪些仓库从海外获取，哪些仓库从公司内部获取， 启动服务命令如下：

  1. ./bin/goproxy -listen=0.0.0.0:80 -cacheDir=/tmp/test -proxy https://goproxy.io -exclude "git.corp.example.com,rsc.io/private"

使用 docker 运行服务

如果上面这些你感觉非常麻烦，可以直接用 docker hub 上编译好的镜像来运行这个服务：

  1. docker run -d -p80:8081 goproxy/goproxy

这样服务就运行在本地的 80 端口服务上了。

测试

在本地开发机上，通过环境变量将 proxy server 指定到你刚部署的服务器：

Mac 和 Linux 用户：

  1. export GO111MODULE=on
  2. export GOPROXY=http://[你的服务器IP]:80

如果是 windows 用户：

  1. $env:GO111MODULE="on"
  2. $env:GOPROXY="http://[你的服务器IP]:80"

接着运行下面命令，查看是否成功，观察服务器日志输出是否正常。

go get github.com/pkg/errors

最后再给自己的服务绑定个域名就大功告成了。有任何问题和bug，欢迎点击这里进行反馈。