用临时 HTTP 代理拯救 Docker Hub 拉镜像

Docker Hub 国内不通,11 个免费镜像全军覆没,最后用一个临时代理搞定,顺便部署了两个测速工具。

运行环境

  • 主机:ThinkPad T14 Gen 1(Linux 6.8.0-138-generic, x86_64)
  • 系统:Ubuntu 22.04 LTS (jammy)
  • Docker:29.9.0(CE,官方 jammy/stable 仓库)
  • 网络:LAN `192.168.100.4/24`,docker0 桥 `172.17.0.1/16`
  • 代理源:192.168.9.3:7893(Clash mixed port,同网段另一台机)
  • 外置硬盘:`/media/myzhangxiubing/Backup/`(NTFS,挂载的移动硬盘)

起因

家里 T14 上有个 12 个月前的 `badapple9/speedtest-x` 容器,`Exited (137)` 一直没动过。今天想升级一下,顺手再加一个 LibreSpeed。


$ docker ps -a
CONTAINER ID   IMAGE                   NAMES               STATUS
a97515bbac3c   badapple9/speedtest-x   practical_hermann   Exited (137) 12 months ago

困境:国内镜像全军覆没

按惯例先升级容器:


docker rm a97515bbac3c
docker run -d --restart unless-stopped --name speedtest-x badapple9/speedtest-x:latest

![图 1:speedtest-x 容器起来,但镜像还是 2022-07-27 的旧版](./images/01-old-image.png)

`docker pull` 直接超时:


Error response from daemon: Get "https://registry-1.docker.io/v2/":
context deadline exceeded (Client.Timeout exceeded while awaiting headers)

测了 11 个国内镜像,结果如下:

镜像 状态 备注
registry-1.docker.io(官方) 超时 直接连不上
docker.m.daocloud.io 401 要付费 / 认证
docker.1ms.run 401 要 token
registry.cn-hangzhou.aliyuncs.com(阿里云) 401 要阿里云账号
mirror.baidubce.com 000 不可达
docker.mirrors.ustc.edu.cn 000 不可达
dockerproxy.com 000 不可达
dockerpull.com 000 不可达
docker.ketches.cn 502 上游坏
hub.rat.dev 302 重定向后拉取挂死

![图 2:国内镜像测活结果截图](./images/02-mirror-test.png)

免费能用的一家都没有。

转机:临时 HTTP 代理

192.168.9.3 这台机子上跑着 Clash(默认 mixed port `7893`),先验证代理通:


$ curl -x http://192.168.9.3:7893 -I https://www.google.com
HTTP 200  time=0.206s

代理 OK。接下来让 `dockerd` 也走这个代理——注意 shell 里设 `HTTP_PROXY` 没用,daemon 是独立进程,得写到它的配置里:


sudo tee /etc/docker/daemon.json >/dev/null <<'EOF'
{
  "proxies": {
    "http-proxy": "http://192.168.9.3:7893",
    "https-proxy": "http://192.168.9.3:7893",
    "no-proxy": "localhost,127.0.0.1,192.168.100.0/24,192.168.9.3,172.17.0.0/16"
  }
}
EOF
sudo systemctl restart docker

![图 3:/etc/docker/daemon.json 配置内容](./images/03-daemon-json.png)

`no-proxy` 一定要包含:

  • `localhost` / `127.0.0.1`:本机服务(如本地 apt 源)
  • `192.168.100.0/24`:家里 LAN,speedtest web UI 走这个网段
  • `192.168.9.3`:代理本身,不能再走代理访问(鸡生蛋问题)
  • `172.17.0.0/16`:docker0 桥,容器回宿主用

验证 daemon 已识别代理:


$ docker info | grep -iE 'HTTP Proxy|HTTPS Proxy|No Proxy'
 HTTP Proxy: http://192.168.9.3:7893
 HTTPS Proxy: http://192.168.9.3:7893
 No Proxy: localhost,127.0.0.1,192.168.100.0/24,192.168.9.3,172.17.0.0/16

注意:踩过一个坑——`HTTP_PROXY=http://… docker pull …` 这种**环境变量方式不行**。Docker 拉镜像是 daemon 在跑,shell 变量传不到它。必须写到 daemon.json 里。

部署 1:speedtest-x(9001)

镜像已经在本地缓存里(旧版),直接起:


docker rm -f speedtest-x
docker run -d --name speedtest-x --restart unless-stopped -p 9001:80 \
  badapple9/speedtest-x:latest

$ docker ps --filter name=speedtest-x
NAMES         STATUS         PORTS
speedtest-x   Up 2 seconds   0.0.0.0:9001->80/tcp

![图 4:http://localhost:9001 首页](./images/04-speedtest-x.png)

访问:

  • 本机:http://localhost:9001/
  • 局域网:http://192.168.100.4:9001/

部署 2:linuxserver/librespeed(9002)

这次要拉新镜像,正好测一下代理:


$ docker pull linuxserver/librespeed:latest
Status: Downloaded newer image for linuxserver/librespeed:latest
docker.io/linuxserver/librespeed:latest

![图 5:通过代理成功拉取 linuxserver/librespeed](./images/05-pull-librespeed.png)

启动:


docker run -d --name librespeed --restart unless-stopped -p 9002:80 \
  linuxserver/librespeed:latest

$ docker ps --filter name=librespeed
NAMES        STATUS         PORTS
librespeed   Up 9 seconds   443/tcp, 0.0.0.0:9002->80/tcp

![图 6:http://localhost:9002 首页(LibreSpeed)](./images/06-librespeed.png)

访问:

  • 本机:http://localhost:9002/
  • 局域网:http://192.168.100.4:9002/

`linuxserver` 镜像默认还暴露 443,但没映射到宿主机,不影响使用。

两套测速对比

端口 服务 风格
9001 badapple9/speedtest-x 单页极简,开箱即用
9002 linuxserver/librespeed 多页面,有历史记录 / 参数设置

![图 7:两个页面并排截图](./images/07-both-services.png)

收尾:把代理做成可复用脚本

代理是临时的,下次再拉镜像还要用。把它打成 4 个文件备份到外置硬盘:


/media/myzhangxiubing/Backup/Ubuntu临时代理/
├── daemon.json    195 B   代理配置
├── apply.sh       465 B   启用代理(sudo bash apply.sh)
├── teardown.sh    481 B   移除代理(sudo bash teardown.sh)
└── README.md     1856 B   使用说明

![图 8:备份目录文件列表](./images/08-backup-files.png)

下次要拉被墙的镜像:


sudo bash /media/myzhangxiubing/Backup/Ubuntu临时代理/apply.sh

用完想关:


sudo bash /media/myzhangxiubing/Backup/Ubuntu临时代理/teardown.sh

`teardown.sh` 会自动备份当前 `daemon.json` 到 `/etc/docker/daemon.json.bak.<时间戳>`,不丢配置。

![图 9:teardown.sh 内容](./images/09-teardown-script.png)

`apply.sh` 完整内容:


#!/bin/bash
set -e
if [[ $EUID -ne 0 ]]; then
  echo "请用 sudo 执行:sudo bash $0" >&2
  exit 1
fi
DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cp "$DIR/daemon.json" /etc/docker/daemon.json
systemctl restart docker
sleep 2
echo "✓ daemon.json 已写入,dockerd 已重启"
docker info 2>/dev/null | grep -iE 'HTTP Proxy|HTTPS Proxy|No Proxy'

恢复正常(移除代理)


sudo bash /media/myzhangxiubing/Backup/Ubuntu临时代理/teardown.sh

验证:


$ docker info | grep -i Proxy
(无输出,说明代理已移除)
$ docker ps
NAMES         IMAGE                           STATUS
librespeed    linuxserver/librespeed:latest   Up
speedtest-x   badapple9/speedtest-x:latest    Up

容器都还在(`unless-stopped` 自启策略扛住了 daemon 重启)。

![图 10:最终状态:代理已清,容器全在](./images/10-final-state.png)

经验总结

1. **shell 环境变量没法让 dockerd 走代理**——daemon 是独立进程,必须写 `/etc/docker/daemon.json` 的 `proxies` 段。

2. **`no-proxy` 一定要包含代理自己**——否则 daemon 连代理都连不上(鸡生蛋)。

3. **不要忘记 docker0 网段**——不加的话容器起不来,或容器到宿主通信断。

4. **临时代理用完最好清掉**——避免每次拉镜像都走代理(慢 + 留痕)。

5. **做成脚本最省事**——`apply.sh` / `teardown.sh` 一行命令切换,比手动编辑 JSON 安全。

附录:所有命令速查


# 启用代理
sudo bash /media/myzhangxiubing/Backup/Ubuntu临时代理/apply.sh

# 部署 speedtest-x
docker run -d --name speedtest-x --restart unless-stopped \
  -p 9001:80 badapple9/speedtest-x:latest

# 部署 librespeed
docker run -d --name librespeed --restart unless-stopped \
  -p 9002:80 linuxserver/librespeed:latest

# 验证
docker ps
docker info | grep -i Proxy

# 移除代理
sudo bash /media/myzhangxiubing/Backup/Ubuntu临时代理/teardown.sh

# 查看备份
ls -la /media/myzhangxiubing/Backup/Ubuntu临时代理/

用 Docker Compose 5 分钟部署 Aria2-pro 高速下载器(配 AriaNg Web UI):https://www.hao0564.com/6343.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注