docker desktop私有仓库搭建

### 如何在 Docker Desktop 上设置和配置私有仓库

#### 安装并启动 Docker Desktop
确保已安装 Docker Desktop 并成功运行。对于 Windows 用户，需遵循特定指南来准备环境[^2]。

#### 创建本地私有仓库容器
通过命令行创建一个持续运行的私有仓库实例，该实例映射主机端口至容器内部服务，并赋予必要的权限以便稳定工作：

docker run -d -p 5000:5000 --name local_registry --restart=always --privileged=true --log-driver=none -v /usr/local/docker/registry-data:/var/lib/registry registry:2

此命令基于官方 `registry` 镜像版本 2 来部署私有仓库[^5]。

#### 修改 Docker Daemon 配置以信任自定义仓库
编辑 `/etc/docker/daemon.json` 文件（Windows 中路径不同），加入如下 JSON 片段指定不安全注册表地址，允许客户端连接未经认证的安全协议传输的数据流:

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

保存更改后执行以下指令使新参数生效并重启守护进程[^4]:

sudo systemctl daemon-reload && sudo systemctl restart docker

#### 测试与验证私有仓库功能
完成上述步骤之后，可以通过推送镜像到新建的私有库来进行初步的功能检验。例如，标记现有镜像并向其分配目标位置标签，随后利用 `push` 命令将其发送给私有仓库服务器；最后访问 API 接口确认资源已被正确接收存储[^3]。