免费Docker镜像站失效？部署这款开源工具，自动优选最快节点

前言

大家好，我是飘雷。

只要是玩NAS的兄弟，肯定都绕不开一个让人极其头疼的问题——Docker Hub在国内被大规模阻断，拉取Docker镜像时常常会失败。

谈起这件事，是因为前几天我发布了Easytier异地组网教程后，小黑盒有兄弟在问怎么解决拉取失败的问题。

虽然我自己目前在用比较稳定的付费Docker镜像站，但考虑到有不少兄弟还是倾向于使用免费资源，我就去研究了一下。

现在网上有不少帖子分享了免费的镜像站地址，但问题在于，这些帖子里的链接往往生存周期存疑，可能上个月还能用，现在就失效了。

如果每次拉取镜像时，都要一遍遍去网上找新地址，然后挨个尝试，这会白白浪费大量时间精力，属实是太麻烦了。

那么有没有一劳永逸的办法呢？

有的兄弟，有的。

今天飘雷就给大家分享一款GitHub上的实用开源项目——Docker-Hub-Proxy。

简单来说，它不是自己去给你做一个镜像库，而是一个聪明的Docker镜像站导航与测速工具。

https://github.com/xingfeng7788/docker-hub-proxy

Docker-Hub-Proxy的核心作用有三个：

1. 汇总统计全网公开的镜像站资源。

2. 自动对这些镜像站进行连通性测速。

3. 帮你筛选出延迟最低、当前绝对可用的节点，让你直接复制去拉取镜像。

废话不多说，因为原项目代码有些陈旧，在最新环境部署会报错，所以今天我会手把手教大家如何修改代码，并在NAS上完美部署。

部署流程

这里我们来展示如何在威联通NAS上使用Docker形式部署Docker-Hub-Proxy，用到的设备是威联通最新的8盘位旗舰型号Qu805。

1.下载项目文件

和之前使用Docker Compose代码的常规部署方式不同，这次因为我们需要修改源码，所以首先要前往 GitHub 下载打包后的项目文件 ZIP 压缩包。

解压缩后得到docker-hub-proxy-master文件夹：

2.修改docker-compose.yaml文件

首先使用Notepad++或VS Code之类的代码编辑器，打开文件夹中的docker-compose.yaml文件，根据自己NAS的实际情况，修改为代码中的映射端口号和NAS的实际路径，参考如下：

services: docker-hub-proxy: build: . container_name: docker-hub-proxy ports: # 冒号左边修改为未被占用的随意端口号，右侧8000不要变动 - "8765:8000" volumes: # 冒号左边修改为你NAS的绝对路径 - /share/Container/dockerhubproxy/data:/app/data restart: unless-stopped

在这段代码中，因为我的Qu805的8000端口号被其他Docker占用了，所以这里我随意将其映射成了8765端口，另外用于保存这个项目数据库的绝对路径设置为/share/Container/dockerhubproxy/data。

3.修改web_ui.py文件

我自己实测，在修改docker-compose.yaml文件，部署后无法正常访问项目的WEB UI管理界面。

猜测可能是因为该项目编写时使用的FastAPI/Starlette库版本较早，现在通过Dockerfile构建时，会自动拉取最新版的库。而在最新版中，TemplateResponse 的调用语法发生了变化，如果不改代码，容器运行后处理网页模板时直接就会崩溃。

这里我们打开docker-hub-proxy-masterapprouters文件夹下的web_ui.py文件，找到第 25 行左右。

修改前的旧代码：

return templates.TemplateResponse("index.html", { "request": request, "proxies": [p.model_dump(mode='json') for p in proxies], "stats": [s.model_dump(mode='json') for s in stats], "total_download": total_download, "pull_count": pull_count, "pull_history": [p.model_dump(mode='json') for p in pull_history] })

我们将其修改为支持新版本库的代码：

return templates.TemplateResponse( request=request, name="index.html", context={ "proxies": [p.model_dump(mode='json') for p in proxies], "stats": [s.model_dump(mode='json') for s in stats], "total_download": total_download, "pull_count": pull_count, "pull_history": [p.model_dump(mode='json') for p in pull_history] } )

4.上传并构建部署Docker

将修改好代码的整个文件夹里的文件，全部上传到你的NAS中，比如我就上传到了/share/Container/dockerhubproxy，再在这个文件夹下新建一个data文件夹：

然后开启NAS的SSH功能，使用 Putty 或 FinalShell 登录进NAS后台。

cd进入我们刚才上传的目录：

cd /share/Container/dockerhubproxy

运行构建并启动容器的命令（注意，因为要现场构建镜像，所以必须带上 --build 参数，这个过程可能需要几分钟，请耐心等待）：

sudo docker compose up -d --build

出现下述字样时，说明项目已经部署成功了：

✔ Network dockerhubproxy_default Created ✔ Container docker-hub-proxy Started

使用方法与配置

1.WEB UI管理设置

部署完成后，在浏览器输入 http://:8765（例如 http://192.168.10.70:8765），就能看到 Docker 镜像加速的 UI 界面了。

项目原本设计了搜索Docker 镜像的功能，项目作者给出的效果是这样的：

但不知为何在我这边无法正常工作，不过这并不影响我们拉取镜像的核心需求。

另外，作者原本设计了从特定 URL来自动抓取全网可用的Docker加速节点：

https://status.anye.xyz/status.json

但可能因为反爬虫或网站改版，自动抓取功能目前也失效了。

不过这倒是影响不大，我们自己用浏览器打开这个网站，就能看到汇总后的各公共镜像站节点信息：

通过手动添加代理节点的方式同样可以实现汇总，无非就是前期操作稍微麻烦一点儿：

多次添加后，你的列表里就会拥有一个代理池。点击列表上方的「测速」按钮，程序就会自动测试NAS与各个加速节点之间的连通延迟，并且在后续我们使用时，Docker-Hub-Proxy会首选延迟最低的节点链接，为我们实现镜像代理功能。

这里需要提醒大家的是，加速节点延迟低，并不一定代表实际拉取的速度快啊，如果测出来延迟最低的那个站点实际下载很慢，可以把它临时删掉，换延迟第二低的节点测试实际效果。

2.Container Station添加自定义存储库

接下来，我们打开威联通的 Container Station，依次点击左侧的「存储库」 -> 「添加存储库」：

• 提供商：选择「其他」

• 名称：随便起（比如 Local_Turbo）

• URL：填写刚才本机IP+前面我们自定义的端口号（如 http://127.0.0.1:8765）

• 点击应用。

为了验证咱们搭建的加速节点是不是真的好使，咱们直接通过NAS的SSH命令行来一次测试。

如下图所示，在拉取镜像时，我们只需要在原本的镜像名字前面，加上咱们NAS的局域网IP和端口号（例如我的就是 192.168.10.70:8765/），敲下回车后，看到这一排排丝滑的 Pull complete：

然后我们在Container Station中提取映像时，也可以在下拉菜单里选择刚才添加的存储库，同样能够正常拉取：

如果回到WEB UI界面，还可以统计拉取次数、流量历史，以及拉取过的文件等信息：

总结

以上就是本期的全部内容了，感谢大家看到这里。

总的来说，对于被拉取Docker镜像难住，又不想使用付费方案的NAS玩家来说，Docker-Hub-Proxy非常好用，再也不用在各大论坛苦苦求镜像地址了。

只要在后台添加一批公共代理节点，以后咱们拉取镜像时，只需要在镜像名前面加上NAS的局域网IP+端口号就行了，Docker-Hub-Proxy会在后台自动帮我们把请求转发给当前速延迟最低的那个外部节点，实现真正的一劳永逸。

它就像是一个私人定制的镜像站测速探针，虽然不能直接提供代理功能，但能帮我们系统化地管理、筛选网络上那些网络质量良莠不齐的公开镜像站，让我们每次拉取镜像前都能心中有数。

在写作本文过程中，整理代码报错、跑通流程都不易，如果这篇教程对你有所帮助，强烈建议先点个收藏，以防以后需要找可用节点时找不到路，也欢迎大家在评论区互相分享当前还可以使用的节点URL。

最后给我喜欢的威联通打个广子，它家的618抽奖活动依然在生效，有兴趣朋友可以去QNAP公众号看下活动介绍，别忘了试试手气，我们下期再见~