
> 假设 Registry 地址为 `192.168.110.123:5000`，以下操作在局域网内任意机器执行。
> 可以将本文链接直接扔你的Openclaw或者QClaw，让它帮你配置

---

## 一、配置 Docker 信任私有 Registry

Docker 默认只信任 Docker Hub 等公开 registry。首次使用私有 registry 前，需要将其加入信任列表。

### macOS / Linux 编辑 daemon.json

```bash
sudo vim /etc/docker/daemon.json
```

添加或合并以下内容：

```json
{
  "insecure-registries": ["192.168.110.123:5000"],
  "registry-mirrors": ["http://192.168.110.123:5000"]
}
```

### Docker Desktop（macOS）

打开 Docker Desktop → **Settings** → **Docker Engine**，在右侧编辑器中添加：

```json
{
  "insecure-registries": ["192.168.110.123:5000"],
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  }
}
```

点击 **Apply & Restart**。

### 验证配置生效

```bash
docker info 2>/dev/null | grep -A5 "Insecure Registries"
```

输出应包含 `192.168.110.123:5000`。

---

## 二、拉取镜像

### 通用方式

```bash
# 拉取指定 tag
docker pull 192.168.110.123:5000/<镜像名>:<标签>

# 示例：拉取 node:20-alpine（amd64 版本）
docker pull 192.168.110.123:5000/node-20-alpine:amd64

# 示例：拉取 node:20-alpine（arm64 版本）
docker pull 192.168.110.123:5000/node-20-alpine:arm64
```

### 使用多架构镜像

⚠️ **当前 registry 配置说明**：由于 Docker Desktop 的 HTTPS 访问限制，
`latest` 多架构 manifest list 暂未创建。推荐直接指定架构拉取：

```bash
# 根据本机架构二选一（Docker 会自动识别本机架构）
docker pull 192.168.110.123:5000/node-20-alpine:amd64   # Intel / AMD 机器
docker pull 192.168.110.123:5000/node-20-alpine:arm64   # Apple Silicon / ARM 机器
```

> 如果 `latest` tag 已存在（manifest list），可直接 `pull latest`，
> Docker 会自动选择本机架构。

### Docker Build 中使用

在 `Dockerfile` 的 `FROM` 或 `COPY --from` 中直接引用：

```dockerfile
# 使用私有 registry 中的基础镜像
FROM 192.168.110.123:5000/node-20-alpine:amd64

# 或跨阶段复制
COPY --from=192.168.110.123:5000/node-20-alpine:amd64 /usr/local/bin/node /usr/local/bin/node
```

---

## 三、查看 Registry 中已有的镜像

```bash
curl http://192.168.110.123:5000/v2/_catalog
```

当前已推送的镜像：

| 镜像名 | 架构标签 | 说明 |
|--------|---------|------|
| `node-20-alpine` | `amd64`, `arm64` | Node.js 20 Alpine |
| `mcp-search-service` | `linux/amd64` | MCP 搜索服务 |
| `new-api` | `linux/amd64` | New API 服务 |

---

## 四、推送新镜像到私有 Registry

```bash
# 1. 打 tag
docker tag <本地镜像> 192.168.110.123:5000/<镜像名>:<标签>

# 2. 推送
docker push 192.168.110.123:5000/<镜像名>:<标签>
```

### 推送多架构镜像（推荐）

在构建机器上构建多架构镜像并推送：

```bash
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  --cache-to type=registry,ref=192.168.110.123:5000/<镜像名>:cache,mode=max \
  --cache-from type=registry,ref=192.168.110.123:5000/<镜像名>:cache \
  -t 192.168.110.123:5000/<镜像名>:latest \
  -t 192.168.110.123:5000/<镜像名>:<版本号> \
  --push .
```

---

## 五、常见问题

### Q: `Error response from daemon: Get "https://192.168.110.123:5000/v2/": dial tcp: i/o timeout`

Docker daemon 尚未信任该私有 registry。请按照 **第一节** 配置 `insecure-registries` 并重启 Docker。

### Q: `http: server gave HTTP response to HTTPS client`

同上，未配置 insecure registry。

### Q: 想拉取特定架构怎么办？

```bash
docker pull --platform linux/amd64 192.168.110.123:5000/node-20-alpine:amd64
docker pull --platform linux/arm64 192.168.110.123:5000/node-20-alpine:arm64
```

### Q: Registry 磁盘空间不足怎么办？

登录 Registry 服务器清理：

```bash
# 进入 registry 容器
docker exec -it <registry容器名> sh

# 清理未引用的 blob（慎用）
bin/registry garbage-collect /etc/docker/registry/config.yml

# 或者直接清理磁盘
docker system prune -a
```


假设 Registry 地址为 192.168.110.123:5000，以下操作在局域网内任意机器执行。 可以将本文链接直接扔你的Openclaw或者QClaw，让它帮你配置

私有 Docker Registry 使用指南

将本文链接直接扔你的Openclaw或者QClaw，让它帮你配置使用私有的Docker Registry

后端

配置Docker私有Registry教程：设置192.168.110.123:5000为信任地址，支持镜像拉取、推送和多架构管理。包含daemon.json配置、常用命令及常见问题解决方案，适用于局域网Docker环境快速部署。

服务器

容器

Docker

Linux

2026采购季 | AI焕新·智启新局

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

私有 Docker Registry 使用指南-腾讯云开发者社区-腾讯云

私有 Docker Registry 使用指南

私有 Docker Registry 使用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐