最早在接触到自定义域名的Go包是Uber的`go.uber.org/zap`，当时感觉很酷。这种包的方式有几个优点： - 包名短，易于使用 - 品牌（装B）标识，很酷所以最近研究了下，准备自己搭建一个类似的自己的域名的Go仓库: `go.zoe.im`。 ### 原理 `go get`在获取包时，会向将包名作为URL发送`https`的的`GET`请求，然后解析响应HTML内容中Meta元素`go-import`和`go-source`。例如， ```html Nothing to see here. Please move along. ``` `go-import`的内容为`<包名> `。所以代码依然还是托管在Github上。只不过，包名换成了自己的域名。 ### 实现想实现上诉的HTML内容返回，我们可以有2中方案， 1. HTTP server 动态返回 2. HTML static 内容托管 `server`和`static`2中方式的优缺点都很明显， |方案|优点|缺点| |:-:|:-:|:-:| |`server`|1. 无需管理包|1. 需要部署和维护服务| |`static`|1. 部署简单无需服务器|1. 需要手动添加包| 对于这2中方案都不复杂也无需做取舍，都实现一下，用户按需使用即可。给他取个名字叫做`gopkg`好了。定义配置文件如下， ```yaml name: Zoe's golang packages description: Zoe's golang packages metadata: host: go.zoe.im base: theme: packages: - name: gopkg type: git schema: https path: github.com/jiusanzhou/gopkg - name: x path: github.com/jiusanzhou/x sub: - name: cli ``` 代码实现很简单，基本上围绕这个配置来展开生成HTML文件了。 > 注意，当前没有实现`server` 完整的代码可以查看[gopkg仓库](https://github.com/jiusanzhou/gopkg)。 ### 实际使用为了确保服务长期使用的稳定，我使用静态文件的形式。这样我只需要定期给DNS续费就可以了。我将我自己使用`go.zoe.im`托管在[go.zoe.im仓库](https://github.com/jiusanzhou/go.zoe.im)。先在`master`分支上添加一个`CNAME`文件，内容为`go.zoe.im`，并做好正确的DNS解析。如果，我需要添加库，只需修改`master`分支下的`gopkg.yaml`文件，下面是我现在全部库的配置， ```yaml name: Zoe's golang packages description: Zoe's golang packages host: go.zoe.im packages: - name: gopkg path: github.com/jiusanzhou/gopkg sub: - name: cmd - name: knife-go path: github.com/jiusanzhou/knife-go sub: - name: config - name: config/options - name: convert - name: pool - name: util - name: x path: github.com/jiusanzhou/x sub: - name: sh - name: cli - name: cli/opts - name: httputil - name: surferua path: github.com/jiusanzhou/surferua - name: injgo path: github.com/jiusanzhou/injgo sub: - name: cmd/injgo - name: pkg/w32 - name: unipaw path: github.com/jiusanzhou/unipaw ``` Github的Action会自动运行`gopkg gen`来生成，所以的HTML内容，并推送到`gh-pages`分支。然后就可以使用了。比如，我需要安装`go.zoe.im/x`库，像这样子就可以啦。 ```golang go get go.zoe.im/x ``` 如果你也想自己搭建一个类似的，你可以参考，[go.zoe.im仓库](https://github.com/jiusanzhou/go.zoe.im)中的`.github/workflows/main.yml`和`gopkg.yaml`。

标签: mod