跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Podman 与 Docker 国内镜像源配置指南(2025-05)

Docker 与 Podman 国内镜像源配置指南。通过修改 daemon.json 和 registries.conf.d 文件设置镜像加速地址,解决拉取超时问题。涵盖 systemctl 重启服务、podman machine 操作及 pull 测试命令。针对 search 功能报错情况,建议通过 Web 界面手动查找镜像后使用限定名称拉取。

开源信徒发布于 2025/9/29更新于 2026/6/722 浏览
Podman 与 Docker 国内镜像源配置指南(2025-05)

添加 Docker 国内镜像源

1. 修改 /etc/docker/daemon.json

设置 registry-mirrors,具体命令如下:

sudo cat > /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me",
    "https://hub.rat.dev",
    "https://docker.1panel.live"
  ]
}
EOF

2. 重启 Docker

systemctl daemon-reload
systemctl restart docker

添加 Podman 国内镜像源

1. 修改 /etc/containers/registries.conf.d/999-podman-machine.conf

该配置文件名可能因机器而异,请在路径下确认实际文件名。

设置 registry-mirror,具体命令如下:

# 进入 Podman 虚拟机
podman machine ssh
# 修改 Podman 注册表配置
sudo vi /etc/containers/registries.conf.d/999-podman-machine.conf
# ---------- 配置内容如下 -----------------
unqualified-search-registries = ["docker.io"]
[[registry]]
prefix = "docker.io"
location = "docker.1ms.run"
[[registry]]
prefix = "docker.io"
location = "hub.rat.dev"
[[registry]]
prefix = "docker.io"
location = "docker.xuanyuan.me"
[[registry]]
prefix = "docker.io"
location = "docker.1panel.live"

当前环境为 Windows 11 下的 Podman,需要执行 Podman Machine 步骤。纯 Linux 环境可跳过此步。

2. 重新启动 Podman Machine

podman machine stop
podman machine start

3. 测试是否成功

podman pull docker.1ms.run/library/hello-world

Trying to pull docker.1ms.run/library/hello-world:latest... Getting image source signatures Copying blob sha256:e6590344b1a5dc518829d6ea1524fc12f8bcd14ee9a02aa6ad8360cce3a9a9e9 Copying config sha256:74cc54e27dc4b2226072d44602 Writing manifest to image destination 74cc54e27dc4b2226072d44602

输出所示,表示 Registry 配置成功。

Docker/Podman Search 镜像名报错处理

通过 docker/podman search 镜像名不能查找的时候,通常报错:Get "https://index.docker.io/v2/" ...timeout.

podman search hello-world Error: 2 errors occurred: * couldn't search registry "docker.io": pinging container registry index.docker.io: Get "https://index.docker.io/v2/": dial tcp 202.160.130.52:443: i/o timeout * couldn't search registry "xuanyuan.me": pinging container registry xuanyuan.me: StatusCode: 404, "\r\n404 Not Found\r..."

通过 podman search image_name 查询报错,并不表示 Registry 上没有镜像,只是没有 index 文件。

解决办法:

可以尝试在网站上手动查找自己需要的镜像,然后使用 pull 命令加镜像限定名称拉取你需要的镜像。

以下是通过 Web 界面查询镜像的地址:

https://docker.1ms.run

https://docker.xuanyuan.me

目录

  1. 添加 Docker 国内镜像源
  2. 1. 修改 /etc/docker/daemon.json
  3. 2. 重启 Docker
  4. 添加 Podman 国内镜像源
  5. 1. 修改 /etc/containers/registries.conf.d/999-podman-machine.conf
  6. 进入 Podman 虚拟机
  7. 修改 Podman 注册表配置
  8. ---------- 配置内容如下 -----------------
  9. 2. 重新启动 Podman Machine
  10. 3. 测试是否成功
  11. Docker/Podman Search 镜像名报错处理
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Qt QWebChannel 前后端通信原理与示例
  • C++ 继承:语法、访问权限与虚继承详解
  • GFPGAN 跨平台部署与人脸图像修复实战指南
  • 主流无人机倾斜摄影三维建模服务商盘点
  • Python 使用 Ksycopg2 驱动连接和操作 Kingbase 数据库
  • GitHub 2FA 双重验证实战指南:Edge 插件配置方案
  • Eino ADK 中的 ChatModelAgent 详解与实战
  • Android 设备 Termux 安装 llama.cpp 并启动 WebUI
  • 开源 GEO 优化工具源码部署搭建指南
  • Webnovel Writer:基于 Claude Code 的长篇网文 AI 创作系统
  • AI 大模型在智慧城市 11 个行业的应用场景
  • GitHub 国内镜像站与加速方案汇总
  • AI 生图去水印的 5 种实用方法与技巧
  • 前端流式输出实现详解:从原理到实践
  • MCP Gateway:零侵入式 API 至 MCP 协议转换网关
  • 申请 Hugging Face 访问令牌:以 Meta-Llama-3.1-8B-Instruct 为例
  • Vue 3 与 React 文件上传实战
  • macOS 安装 Claude 提示 command not found 问题排查与解决
  • ToDesk、顺网云、青椒云三款云电脑 AIGC 性能实测对比
  • C++ 继承机制详解:从单继承到多继承菱形问题

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online