自用docker镜像源搭建

Fri, 14 Aug 2026 23:09:30 +0800

公共 docker 加速器关了一大批，自己用一台海外服务器反代镜像仓库，一劳永逸。

快速搭建

安装caddy

二进制放 /usr/bin/caddy，服务文件 /etc/systemd/system/caddy.service，配置 /etc/caddy/Caddyfile

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


sudo mv caddy /usr/bin/caddy
sudo chmod 755 /usr/bin/caddy
sudo setcap cap_net_bind_service=+ep /usr/bin/caddy

sudo groupadd --system caddy
sudo useradd --system \
 --gid caddy \
 --create-home \
 --home-dir /var/lib/caddy \
 --shell /usr/sbin/nologin \
 --comment "Caddy web server" \
 caddy

配置caddy守护进程

/etc/systemd/system/caddy.service：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


[Unit]
Description=Caddy
Documentation=https://caddyserver.com/docs/
After=network.target network-online.target
Requires=network-online.target

[Service]
Type=notify
User=caddy
Group=caddy
ExecStart=/usr/bin/caddy run --environ --config /etc/caddy/Caddyfile
ExecReload=/usr/bin/caddy reload --config /etc/caddy/Caddyfile --force
TimeoutStopSec=5s
LimitNOFILE=1048576
LimitNPROC=512
PrivateTmp=true
ProtectSystem=full
AmbientCapabilities=cap_net_bind_service

[Install]
WantedBy=multi-user.target

1
2


sudo systemctl daemon-reload
sudo systemctl enable --now caddy

配置caddyfile

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56


# 换成你自己的域名
DOMAIN="example.com"

cat << EOF > /etc/caddy/Caddyfile
{
 email you@example.com
}

hub.docker.\${DOMAIN} {
 reverse_proxy https://registry-1.docker.io {
 header_up Host registry-1.docker.io
 header_down Www-Authenticate "https://auth.docker.io" "https://auth.docker.\${DOMAIN}"
 header_down Location "https://production.cloudflare.docker.com" "https://production.cloudflare.docker.\${DOMAIN}"
 }
}

auth.docker.\${DOMAIN} {
 reverse_proxy https://auth.docker.io {
 header_up Host auth.docker.io
 }
}

production.cloudflare.docker.\${DOMAIN} {
 reverse_proxy https://production.cloudflare.docker.com {
 header_up Host production.cloudflare.docker.com
 }
}

hub.quay.\${DOMAIN} {
 reverse_proxy https://quay.io {
 header_up Host quay.io
 header_down Www-Authenticate "https://quay.io/v2/auth" "https://hub.quay.\${DOMAIN}/v2/auth"
 }
}

hub.gcr.\${DOMAIN} {
 reverse_proxy https://gcr.io {
 header_up Host gcr.io
 header_down Www-Authenticate "https://gcr.io/v2/token" "https://hub.gcr.\${DOMAIN}/v2/token"
 }
}

hub.k8s.\${DOMAIN} {
 reverse_proxy https://registry.k8s.io {
 header_up Host registry.k8s.io
 header_down Www-Authenticate "https://registry.k8s.io/v2/token" "https://hub.k8s.\${DOMAIN}/v2/token"
 header_down Location "https://storage.googleapis.com" "https://storage.googleapis.\${DOMAIN}"
 }
}

storage.googleapis.\${DOMAIN} {
 reverse_proxy https://storage.googleapis.com {
 header_up Host storage.googleapis.com
 }
}
EOF

注意事项：

email 换成自己的邮箱
证书不用管，Caddy 自动申请续期，配置里不用写任何 tls
k8s.gcr.io 已退役，k8s 站点反代的是新的 registry.k8s.io
header_down 两个参数是删除、三个参数才是替换，且查找串要写上游实际域名（https://auth.docker.io 这种），写成"期望结果"不会生效

配置dns

7 条 A 记录指向服务器公网 IP：

1
2
3
4
5
6
7


hub.docker.example.com
auth.docker.example.com
production.cloudflare.docker.example.com
hub.quay.example.com
hub.gcr.example.com
hub.k8s.example.com
storage.googleapis.example.com

嫌麻烦就加一条泛解析 *.docker.example.com。配置里出现的域名必须都能解析，否则 Caddy 会一直重试签证书。

验证部署

1
2
3


sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -sI https://hub.docker.example.com/v2/

返回 401 Unauthorized 是正常的，同时响应头里 Www-Authenticate 的 realm 应该是 https://auth.docker.example.com/token，说明重写生效。最终测试：

1

docker pull hub.docker.example.com/library/hello-world:latest

快速使用

unraid

Settings → Docker → Advanced View → Docker Hub URL 改成 https://hub.docker.example.com，或者拉镜像时直接写完整地址 hub.docker.example.com/linuxserver/plex。

其他主流linux

/etc/docker/daemon.json：

1
2
3


{
 "registry-mirrors": ["https://hub.docker.example.com"]
}

1

sudo systemctl restart docker

之后 docker pull nginx 自动走代理。registry-mirrors 只接管 Docker Hub，gcr/quay 镜像换前缀拉：

1
2


docker pull hub.quay.example.com/prometheus/prometheus:latest
docker pull hub.gcr.example.com/istio/proxyv2:1.20.0

可以加公共源兜底：

1
2
3
4
5
6


{
 "registry-mirrors": [
 "https://hub.docker.example.com",
 "https://mirrors.tuna.tsinghua.edu.cn"
 ]
}

Docker 使用指南：镜像、容器与 Dockerfile

Fri, 14 Aug 2026 21:06:32 +0800

前言

docker是一个轻量化且开源的容器引擎。借由Go驱动有着极低性能开销。不过仅支持linux发行版的系统

安装

金枪鱼镜像站

DOCKER的安装教程非常的多，再加上国外主机的访问速度奇差，这里建议直接用知名金枪鱼镜像站的文档去安装,节约更多的时间在搜索教程和镜像站上。

使用方法

镜像管理

1
2
3


docker image ls # 列出本地所有镜像
docker image rm {IMAGE_NAME} # 删除本地的某个镜像 
docker build # 编译docker镜像

docker build

-t为编译的镜像
-f为指定dockerfile路径
-no-cache 为不使用缓存构建镜像
.当前目录及其子目录被当作上下文

进阶操作

使用.dockerignore排除不必要的文件，减少镜像体积

容器操作

1
2
3
4
5
6
7


docker run # 创建并启动某个容器 
docker start {IMAGE_NAME} # 启动
docker stop {IMAGE_NAME} # 停止
docker restart {IMAGE_NAME} #重启
docker attach {IMAGE_NAME} # 在终端中直接进入容器内 (不推荐)
docker exec # 在终端中直接进入容器内 (推荐)
docker ps #查看所有容器

容器操作补充

docker restart 可以在docker容器没有运行的情况下直接启动，如果在运行就是重启
attach 会随着你输入ctrl c或exit的同时关闭容器
exec是你要访问的同一容器的新进程，需要查看你跑服务的进程请使用docker logs

docker run

-d 在后台运行
–name指定容器名称
-p 容器内端口映射到容器外
-v 主机路径映射到容器内
-it 打开交互式终端

docker exec

-i 允许向容器发送内容(交互)
-t 分配一个伪终端
-it -i和it的组合(常用)
-d 在后台运行
-u 指定用户
-e 设置环境变量
-w 指定容器内工作目录
–privileged 最高权限模式。等同于直接操作物理机(用之前先确定自己为什么要这么做)

docker ps

ps -a 查看所有容器
ps -q 只查看容器id
ps -s 显示容器大小
ps -n 显示最后创建的
ps -f 根据条件过滤容器(ps -f status=exited)

Dockerfile 的写法

基础内容

1
2


FROM {IMAGE_NAME}
RUN {CUSTOM}

参考资料

菜鸟教程廖雪峰的教程

Docker on 式鉴的博客