简介

因为近期国内镜像站点的变动，自建docker镜像也提上了日程。顺便发现了Hammal这个优秀的项目。

Hammal 是运行于 cloudflare workers 上的 Docker 镜像加速工具，用于解决获取 Docker 官方镜像速度缓慢以及完全无法获取 k8s.gcr.io 上镜像的问题。

在这里感谢如下两个项目

tomwei7/hammal: docker-registry proxy run in cloudflare workers (github.com)

pengfujin-momo/hammal: docker-registry proxy run in cloudflare workers (github.com)

使用姿势

1
2
npm install -g wrangler
wrangler login

克隆或者下载项目到本地

并在文件夹目录下操作

1
2
3
git clone https://github.com/tomwei7/hammal.git 
cd hammal
mv wrangler.toml.sample wrangler.toml

参考wrangler.toml.sample，进行如下修改并保存为wrangler.toml

获取 account_id id, 并修改 wrangler.toml 文件中的 account_id id

1
wrangler whoami

创建 KV namespace

1
wrangler kv:namespace create hammal_cache

上面的代码别改kv名称，代码中还有依赖（

修改 wrangler.toml 文件填充 kv_namespaces 中的 id

另，原作者的wrangler.toml.sample缺少如下两行，手动添加上去，否则部署会报错~

1
2
main = "src/index.ts"
compatibility_date = "2022-10-29"

修改后的代码大致长这样

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
name = "hammal"
type = "webpack"
main = "src/index.ts"
compatibility_date = "2022-10-29"
account_id = "your account_id"
workers_dev = true
route = ""
zone_id = ""
webpack_config = "webpack.config.js"
kv_namespaces = [
	 { binding = "HAMMAL_CACHE", id = "you kv id" }
]

最后发布 workers，大功告成~~

1
wrangler deploy

发布 workers 可以获得类似 https://hammal.{your_name}.workers.dev 的地址，修改 registry-mirrors 地址为该地址即可。但是强烈建议前往workers-设置-触发器中绑定自己的域名。官方workers.dev访问效果不佳。

1
2
3
4
5
6
7
<<EOF sudo tee /etc/docker/daemon.json
{
  "registry-mirrors": [
    "你的域名"
  ]
}
EOF

添加其他镜像源镜像

目前 hammal 支持获取 k8s.gcr.io, gcr.io, quay.io 的镜像，可以通过修改 handler.ts 中的 ORG_NAME_BACKEND 添加

1
2
3
4
5
6
7
8
# 拉取 k8s.gcr.io 镜像
docker pull hammal.{your_name}.workers.dev/k8sgcr/kubernetes-dashboard-amd64:v1.8.3

# 拉取 gcr.io 镜像
docker pull hammal.{your_name}.workers.dev/gcr/youlib/image:tags

# 拉取 quay.io 镜像
docker pull hammal.{your_name}.workers.dev/quay/coreos/flannel:v0.13.1-rc2