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

项目地址：https://github.com/pengfujin-momo/hammal

环境要求：

1、如何部署

1.1、安装wrangler并登录

安装 https://developers.cloudflare.com/workers/get-started/guide/, 并登录

npm install -g wrangler

wrangler login

1.2、克隆项目

如需使用git命令还需额外安装git插件；

建议下载项目ZIP文件，无需安装git插件。

克隆或者下载项目到本地，并在文件夹目录下操作

git clone https://github.com/tomwei7/hammal.git 

cd hammal

mv wrangler.toml.sample wrangler.toml

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

1.3、获取account_id

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

wrangler whoami

1.4、获取kv_namespaces

创建 KV namespace

wrangler kv:namespace create hammal_cache

上面的代码不要修改kv名称，代码中还有依赖

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

1.5、最终配置文件

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

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

修改后的代码

name = "hammal"
type = "webpack"
main = "src/index.ts"
compatibility_date = "2022-10-29"
account_id = "改为自己的 account_id"
workers_dev = true
route = ""
zone_id = ""
webpack_config = "webpack.config.js"
kv_namespaces = [
	 { binding = "HAMMAL_CACHE", id = "改为自己的 kv_namespaces id" }
]

1.6、发布

  • 发布完成后需等待路由建立成功，可能需要几小时才能完成；

  • 若配置自己的域名，则需要将域名DNS托管到Cloudflare，产生的影响：

    • 后续添加解析需在Cloudflare中添加，已有解析会自动同步过来；

    • 这也可能影响到DDNS解析，建议使用一个新的域名完成托管。

发布 workers，大功告成~~

wrangler deploy

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

sudo tee /etc/docker/daemon.json

{
  "registry-mirrors": [
    "你的域名"
  ]
}

2、添加其他镜像源镜像

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

# 拉取 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