【2025年最新】Dockerイメージプル問題を解決する

「docker pull timeout…」
「Retrying in 5 seconds…」

中国国内でDockerやKubernetesを使用している開発者にとって、Docker Hubへの接続問題は頭痛の種です。かつては豊富にあったミラーサイト（DaoCloud、USTC、Azure Chinaなど）も、2024年の規制強化以降、次々とサービスを停止したり、公開アクセスを制限したりしています。

この記事では、2025年現在でも実際に使用可能なミラーソースと、それらを正しく設定して高速なプル環境を取り戻す方法をまとめました。

Railway - モダンなデプロイプラットフォーム、煩わしい運用から解放、数分で公開

今すぐ始める →広告

注意: ミラーサイトの状況は頻繁に変化します。この記事は定期的に更新されますが、接続できない場合はコメントでお知らせください。

1. 2025年現在も使えるミラーソース

現時点で稼働が確認されているミラーソースです。

クラウドプロバイダー系（要アカウント）

これらが最も安定しています。

1. Aliyun（阿里云）:

   • 特徴: 最も安定。ただし、個人専用のURLを取得する必要があります。
   • 取得方法: 阿里云容器镜像服务にログインし、「镜像加速器」メニューから専用アドレス（例：https://xxxx.mirror.aliyuncs.com）をコピーします。

2. Tencent Cloud（腾讯云）:

   • URL: https://mirror.ccs.tencentyun.com
   • 特徴: Tencent Cloudのサーバー（CVM）内であれば超高速。外部からのアクセスは制限されることがあります。

大学・オープンソース系（パブリック）

1. Nanjing University（南京大学）:

   • URL: https://docker.nju.edu.cn
   • 特徴: 教育機関向けネットワーク（CERNET）からのみアクセス可能な場合が多いですが、比較的安定しています。

2. Shanghai Jiao Tong University（上海交通大学）:

   • URL: https://docker.mirrors.sjtug.sjtu.edu.cn
   • 特徴: たまにメンテナンスに入りますが、信頼性は高いです。

2. 設定方法：daemon.jsonの編集

Dockerデーモンにミラーを設定するには、/etc/docker/daemon.jsonを編集します。

Linux (Ubuntu/CentOS)

1. ファイルを作成/編集する:

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.nju.edu.cn",
    "https://xxxx.mirror.aliyuncs.com"
  ]
}
EOF

※ xxxxの部分は自分のAliyun専用コードに置き換えてください。複数のミラーを設定しておくと、上から順に試行されます。

2. 設定を再読み込みしてDockerを再起動:

sudo systemctl daemon-reload
sudo systemctl restart docker

3. 適用確認:

docker info

出力の下の方に「Registry Mirrors」という項目があり、設定したURLが表示されていれば成功です。

Windows / Mac (Docker Desktop)

1. Docker Dashboardを開く。
2. 右上の歯車アイコン（Settings）をクリック。
3. 左メニューから「Docker Engine」を選択。
4. JSONエディタに"registry-mirrors"配列を追加。

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.nju.edu.cn",
    "https://mirror.ccs.tencentyun.com"
  ]
}

5. 「Apply & restart」をクリック。

3. もしミラーが全滅したら？（上級編）

すべてのパブリックミラーが使えない、あるいは極端に遅い場合、最後の手段があります。Cloudflare Workersを使って自分専用のミラーを構築する方法です。

Cloudflare Workersを使う方法

Githubには数多くの「Docker Registry Proxy」プロジェクトがあります。

Vultr - 高性能NVMeクラウドサーバー、世界32拠点、Dockerワンクリック展開対応

価格を見る →広告

1. cloudflare-docker-proxy などのリポジトリをフォーク。
2. ボタン一つでCloudflare Workersにデプロイ。
3. 発行されたドメイン（例：docker.your-domain.com）をdaemon.jsonに設定。

メリット:

• 自分専用なので帯域を独占できる。
• Cloudflareのネットワークを利用するため高速。
• 無料枠でも個人利用なら十分。

デメリット:

• Cloudflare Workersのドメイン（workers.dev）が汚染されている場合、カスタムドメインが必要になる。

まとめ

2025年現在、中国国内でDockerを使うのは少し工夫が必要ですが、Aliyunの個人用ミラーを取得するのが最も確実な解決策です。次点で大学系のミラー、それでもダメならCloudflare Workersでの自作を検討してください。

快適なコンテナライフを！

3 min read · 公開日: 2025年12月17日 · 更新日: 2026年1月22日

Easton

技術開発