public-image-mirror README

The project's README from github.com/DaoCloud/public-image-mirror. As one markdown file: README.md.

public-image-mirror

源仓库 Github
Mirror 仓库 Gitee

背景 & 目标

很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。

快速开始

docker run -d -P m.daocloud.io/docker.io/library/nginx

使用方法

增加前缀 (推荐方式)。比如：

              docker.io/library/busybox
                 |
                 V
m.daocloud.io/docker.io/library/busybox

或者 支持的镜像仓库 的 前缀替换 就可以使用。比如：

           docker.io/library/busybox
             |
             V
docker.m.daocloud.io/library/busybox

支持前缀替换的 Registry (不推荐)

推荐使用添加前缀的方式.

前缀替换的 Registry 的规则, 这是人工配置的, 有需求提 Issue.

这里每一个源站内容都是不同的, 不要把 docker.io 之外的站点配置给 docker 的 registry-mirrors

源站 替换为 备注
docker.elastic.co elastic.m.daocloud.io
docker.io docker.m.daocloud.io
dhi.io dhi.m.daocloud.io
gcr.io gcr.m.daocloud.io
ghcr.io ghcr.m.daocloud.io
k8s.gcr.io k8s-gcr.m.daocloud.io k8s.gcr.io 已被迁移到 registry.k8s.io
registry.k8s.io k8s.m.daocloud.io
mcr.microsoft.com mcr.m.daocloud.io
nvcr.io nvcr.m.daocloud.io
quay.io quay.m.daocloud.io
registry.ollama.ai ollama.m.daocloud.io 实验内测中，使用方法

最佳实践

部署内网缓存

本地缓存部署用于在内网环境中加速镜像拉取，减少对外网的依赖。通过设置一个本地镜像仓库，您可以缓存常用的镜像。 请参考文档

加速 Kubneretes

加速安装 kubeadm

apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
dns:
  imageRepository: k8s.m.daocloud.io/coredns
imageRepository: k8s.m.daocloud.io
...

加速安装 kind

kind create cluster --name kind --image m.daocloud.io/docker.io/kindest/node:v1.22.1

加速所有 Pod

https://github.com/wzshiming/repimage

不修改 yaml, helm 等, 仅使用 Webhook, 自动修改所有新建 Pod 的 image 使用本 mirror

kubectl create -f https://files.m.daocloud.io/github.com/wzshiming/repimage/releases/download/latest/repimage.yaml
kubectl rollout status deployment/repimage -n kube-system

加速 Containerd

加速 Docker

添加到 /etc/docker/daemon.json

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ]
}

加速 Podman

添加到 /etc/containers/registries.conf (rootless 模式也可以添加到 ~/.config/containers/registries.conf)

[[registry]]
location = "docker.io"

[[registry.mirror]]
location = "docker.m.daocloud.io"

与 Docker 不同, Podman 还支持为 docker.io 之外的 registry 配置 mirror, 例如:

[[registry]]
location = "gcr.io"

[[registry.mirror]]
location = "gcr.m.daocloud.io"

[[registry]]
location = "ghcr.io"

[[registry.mirror]]
location = "ghcr.m.daocloud.io"

[[registry]]
location = "quay.io"

[[registry.mirror]]
location = "quay.m.daocloud.io"

[[registry]]
location = "registry.k8s.io"

[[registry.mirror]]
location = "k8s.m.daocloud.io"

加速 Ollama & DeepSeek

加速安装 Ollama

CPU:

docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama docker.m.daocloud.io/ollama/ollama

GPU 版本:

  1. 首先安装 Nvidia Container Toolkit
  2. 运行以下命令启动 Ollama 容器：
docker run -d --gpus=all -v ollama:/root/.ollama -p 11434:11434 --name ollama docker.m.daocloud.io/ollama/ollama

更多信息请参考：

加速使用 Deepseek-R1 模型（实验内测中）

如上述步骤，在启动了ollama容器的前提下，还可以通过加速源，加速启动DeepSeek相关的模型服务

注：目前 Ollama 官方源的下载速度已经很快，您也可以直接使用官方源。

# 使用加速源
docker exec -it ollama ollama run ollama.m.daocloud.io/library/deepseek-r1:1.5b

# 或直接使用官方源下载模型
# docker exec -it ollama ollama run deepseek-r1:1.5b

[友情链接]加速二剑客

贡献者

Made with contrib.rocks.

public-image-mirror (DaoCloud/public-image-mirror)

Searching Database…

15.2K ·GitHub
Public-image-mirror
Что это такое?Это публичное зеркало для реестров контейнеров (таких как gcr.io, ghcr.io, docker.io, quay.io), которое работает от DaoCloud. Оно предназначено для ускорения загрузки образов для пользователей в Китае, где эти реестры работают медленно.
Это программа, которую нужно установить, или размещённый сервис?Это размещённый сервис-зеркало (m.daocloud.io), устанавливать его не нужно. Сам репозиторий в основном содержит документацию, списки конфигураций и CI-скрипты, которые управляют зеркалом.
Как этим пользоваться?Рекомендуемый способ — добавить префикс зеркала перед именем образа, например, загружать gcr.m.daocloud.io вместо gcr.io. Для Docker, Podman и Kubernetes также можно настроить зеркала реестров в daemon.json или registries.conf.
Нужен ли какой-то особый клиент или аккаунт, чтобы пользоваться зеркалом?Нет, достаточно обычных инструментов Docker, Podman, containerd или kubeadm/kind, которым нужно указать адрес зеркала или префикс. Ни аккаунт, ни дополнительное ПО не нужны.
Всегда ли в кеше есть нужный мне образ?Кешированные данные хранятся только 30 дней и обновляются по мере необходимости, поэтому блоб может исчезнуть и вернуть ошибку 404, если он истечёт в промежутке между 1-минутным кешем блобов и повторной синхронизацией. Лучше загружать в нерабочие часы (с 1 до 7 утра по пекинскому времени).
Для кого предназначено это зеркало?В первую очередь для разработчиков и DevOps-команд в материковом Китае, которым нужен более быстрый и надёжный доступ к зарубежным реестрам контейнеров.
Какие реестры входят в зеркало?Оно зеркалирует основные реестры, включая docker.io, gcr.io, ghcr.io, k8s.gcr.io/registry.k8s.io, mcr.microsoft.com, nvcr.io, quay.io, а также экспериментально registry.ollama.ai.
Гарантированно ли хеш и содержимое совпадают с исходным образом?Да. В описании сказано, что зеркало только повторяет исходный реестр и сохраняет все хеши sha256 идентичными оригиналу благодаря механизму ленивой загрузки.
Можно ли через это ускорить загрузку моделей Ollama и DeepSeek?Да, есть отдельный раздел по ускорению загрузки контейнеров Ollama (для конфигураций с CPU и с GPU/Nvidia Container Toolkit), а также экспериментальное ускорение загрузки моделей DeepSeek-R1 через Ollama.
Можно ли развернуть собственный локальный кеш вместо публичного зеркала?Да, в README описана лучшая практика развёртывания внутреннего кеша образов, которая снижает зависимость от внешней сети.
Можно ли автоматически переписать все образы подов Kubernetes без правки YAML?Да, упоминается подход на основе вебхука, который автоматически переписывает ссылки на образы новых подов так, чтобы они вели на зеркало, не трогая манифесты и Helm-чарты.
What are similar projects?awesome-docker, awesome-sysadmin, containerd, nerdctl, xpipe, evenfire, vps-security-enhancement-scripts, opensre
Which topics is it in?containerd, podman, registry, sysadmin, observability, ollama, shell, deepseek, kubernetes, proxy, monitoring, china
Creator
DaoCloud
Size
1.5 MB
Stars
15.2K
Updated
CommitOct 19
Age
5y
Commits · 90 Days