Registry从安装到摸鱼全指南 🐳

一、前期准备：给服务器”加油”

1. 双机装备检查

角色	IP地址	必备技能
Server	192.168.186.129	会唱《我是仓库管理员》
Client	192.168.186.128	擅长《镜像搬运工》

温馨提示：

• 两台机器都要安装Docker（没装的快去面壁！）

• 检查网络：互相ping一下，确保不是”最熟悉的陌生人”

二、Server端操作：搭建私人车库

1. 拉取Registry镜像

docker pull registry

说人话：相当于去4S店提了台仓库管理专用车！

2. 配置”车库通行证”

修改/etc/docker/daemon.json：

{
  "registry-mirrors": ["https://镜像加速地址"],
  "insecure-registries": ["192.168.186.129:5000"]  // 告诉Docker："这个车库不用安检！"
}

重点提示：

• 逗号别漏！JSON格式错误会哭给你看

• 修改完记得重启Docker：systemctl restart docker

3. 启动Registry容器

docker run -d -p 5000:5000 --name my_garage registry

参数解密：

• -p 5000:5000：给车库开个5000号大门

• --name my_garage：给你的车库起个酷炫名字

验货方式： 浏览器打开http://你的IP:5000/v2/_catalog，看到{"repositories":[]}说明车库建好了！

三、上传爱车：把镜像停进车库

1. 给镜像挂车牌

docker tag nginx 192.168.186.129:5000/nginx:v1

比喻时刻：

原镜像：“京A·NGINX”

新车牌：“私A·192.168.186.129:5000/nginx”

2. 入库操作

docker push 192.168.186.129:5000/nginx:v1

进度条玄学：

• 卡在99%？喝杯咖啡等等

• 报错？检查防火墙是否在搞事情

3. 查看库存清单

curl http://192.168.186.129:5000/v2/_catalog

成功信号：看到{"repositories":["nginx"]}说明爱车已入库！

四、Client端操作：共享你的车库

1. 配置客户端通行证

同样修改/etc/docker/daemon.json：

{
  "insecure-registries": ["192.168.186.129:5000"]
}

重要提示：

• 改完必须systemctl restart docker

• 两边配置要像双胞胎一样一致！

2. 远程提车体验

docker pull 192.168.186.129:5000/nginx:v1

成功画面：

Status: Downloaded newer image

此刻你已实现镜像自由！

五、高阶玩法：私人车库扩展包

1. 批量管理技巧

# 查看所有库存
curl http://你的IP:5000/v2/_catalog

# 查看某个镜像版本
curl http://你的IP:5000/v2/nginx/tags/list

2. 车库清洁指南

# 删除指定版本
docker exec registry bin/registry garbage-collect /etc/docker/registry/config.yml

注意：清理前请备份，别把”爱车”误删了！

3. HTTPS安全升级

# 生成自签名证书
openssl req -newkey rsa:4096 -nodes -sha256 -keyout domain.key -x509 -days 365 -out domain.crt

比喻：给车库装上指纹锁！

六、常见翻车现场救援

Q1：push时报错”http: server gave HTTP response to HTTPS client”

急救方案：

1. 检查daemon.json的insecure-registries配置

2. 确认IP和端口没写反

3. 重启Docker服务

Q2：客户端pull不到镜像

排查步骤：

1. 在Client端执行curl 仓库IP:5000/v2/_catalog

2. 检查防火墙：firewall-cmd --list-ports

3. 确认镜像tag完全一致

Q3：仓库突然失联

复活指令：

docker start my_garage  # 唤醒你的车库管理员

七、可视化神器：给车库装个监控

推荐使用这些Web UI工具：

1. Portus：SUSE出品的仓库管家

2. Docker Registry UI：极简风监控屏

3. Harbor：企业级豪华车库管理系统

安装示例：

docker run -d -p 8080:80 -e REGISTRY_URL=http://你的仓库:5000 joxit/docker-registry-ui:static

文末彩蛋：

🐢 试过用Registry存表情包吗？

🚀 下次教你把Registry改造成私人网盘！

💬 你在搭建时遇到过什么奇葩问题？评论区等你吐槽！