运行环境
- 主机: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

`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 | 重定向后拉取挂死 |

免费能用的一家都没有。
转机:临时 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

`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

访问:
- 本机: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

启动:
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

访问:
- 本机:http://localhost:9002/
- 局域网:http://192.168.100.4:9002/
`linuxserver` 镜像默认还暴露 443,但没映射到宿主机,不影响使用。
两套测速对比
| 端口 | 服务 | 风格 |
|---|---|---|
| 9001 | badapple9/speedtest-x | 单页极简,开箱即用 |
| 9002 | linuxserver/librespeed | 多页面,有历史记录 / 参数设置 |

收尾:把代理做成可复用脚本
代理是临时的,下次再拉镜像还要用。把它打成 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 使用说明

下次要拉被墙的镜像:
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.<时间戳>`,不丢配置。

`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 重启)。

经验总结
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
