Skip to content

Global service map

Does Docker Hub Mirror work in China?

. Regenerated with each Chinaready Landscape publish.

Quick answer: Docker Hub Mirror is Unavailable in mainland China for practical production use. International bandwidth limits make Hub pulls slow or fail, cross-border image distribution raises data-compliance issues, and some images are not filed (备案) for mainland distribution. Chinaready currently lists Xuanyuan Mirror, 1ms Mirror, DaoCloud Mirror, Alibaba Cloud ACR, Tencent Cloud TCR, Huawei Cloud SWR, Harbor as China-market options on this alternatives page. Availability in China: Unavailable.

Availability in China: Unavailable

China container-image paths instead of Docker Hub

Docker Hub Mirror is Unavailable for reliable mainland China use. Do not plan Docker Hub as a production image dependency for mainland builds or runtime pulls:

  • International bandwidth limits: Hub endpoints sit overseas, so mainland docker pull and CI image fetches are often slow, timed out, or interrupted.
  • Cross-border data compliance: pulling and redistributing images across the border can conflict with mainland data-handling expectations for production systems.
  • Unfiled images: some Hub images are not filed (备案) for mainland distribution, so they may be incomplete, blocked, or unsuitable for production.

Public image accelerators

Use these for development and CI pull speed. They are not a production private registry, and public mirror availability can change.

Accelerator Endpoint Best fit
Xuanyuan Mirror (轩辕镜像) docker.xuanyuan.me Development and CI image pulls that need a mainland Hub accelerator
1ms Mirror (毫秒镜像) docker.1ms.run Development and CI pulls across Docker Hub and related overseas registries
DaoCloud Mirror docker.m.daocloud.io Long-standing public accelerator for Hub and other overseas registries

Cloud vendor private image services

Prefer these for production: stable mainland hosting, access control, and a clearer security path than public Hub mirrors.

Service Characteristics Best fit
Alibaba Cloud ACR Alibaba Cloud Container Registry (阿里云容器镜像服务) — managed private registry on Alibaba Cloud Production image hosting on an Alibaba Cloud stack
Tencent Cloud TCR Tencent Cloud Container Registry (腾讯云容器镜像服务) — managed private registry on Tencent Cloud Production image hosting on a Tencent Cloud stack
Huawei Cloud SWR Huawei Cloud SoftWare Repository for Container (华为云容器镜像服务) — managed private registry on Huawei Cloud Production image hosting on a Huawei Cloud stack

Self-hosted private registry

  • Harbor: open-source enterprise registry for teams that need a self-hosted private warehouse, vulnerability scanning, and high-security / on-prem control.

Selection guidance

  • Development / CI pull speed: start with Xuanyuan Mirror, 1ms Mirror, or DaoCloud Mirror — treat them as accelerators, not the system of record.
  • Production: host images in Alibaba Cloud ACR, Tencent Cloud TCR, or Huawei Cloud SWR on the cloud you already run.
  • Enterprise high-security / on-prem: self-host Harbor.

These candidates appear on the Docker Hub Mirror alternatives page only — Chinaready does not add Xuanyuan Mirror, 1ms Mirror, DaoCloud Mirror, Alibaba Cloud ACR, Tencent Cloud TCR, Huawei Cloud SWR, or Harbor as Landscape map product entries. Confirm image provenance, SLAs, and compliance before adoption.

Docker Hub Mirror alternatives in China

Mapped China-ready candidates

Xuanyuan Mirror

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

Xuanyuan Mirror (轩辕镜像, docker.xuanyuan.me) is a public mainland Docker Hub accelerator for faster image pulls. Best for development and CI — not a production private registry.

1ms Mirror

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

1ms Mirror (毫秒镜像, docker.1ms.run) is a public mainland Docker Hub accelerator commonly used to speed up Hub, GHCR, and related pulls. Best for development and CI — not a production private registry.

DaoCloud Mirror

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

DaoCloud Mirror (docker.m.daocloud.io) is a long-standing public image accelerator for Docker Hub and other overseas registries. Best for development and CI — not a production private registry.

Alibaba Cloud ACR

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

Alibaba Cloud ACR (阿里云容器镜像服务) is a managed private container registry for production: stable mainland hosting, access control, and a clearer compliance path than public Hub mirrors.

Tencent Cloud TCR

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

Tencent Cloud TCR (腾讯云容器镜像服务) is a managed private container registry for production workloads on Tencent Cloud — stable, access-controlled, and suited to mainland security expectations.

Huawei Cloud SWR

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

Huawei Cloud SWR (华为云容器镜像服务) is a managed private container registry for production on Huawei Cloud — commonly evaluated for stable, secure image hosting in mainland environments.

Harbor

Developer Tools & APIs · Container Registry & Image Mirrors · China-ready candidate

Harbor is an open-source enterprise container registry for self-hosted private warehouses — strongest when teams need high security, on-prem control, and vulnerability scanning rather than a public Hub mirror.

FAQ

Does Docker Hub work in China?

No for practical mainland China production use. Chinaready labels Docker Hub Mirror as Unavailable. International bandwidth limits make Hub pulls slow or fail, cross-border image distribution raises data-compliance issues, and some images are not filed (备案) for mainland distribution.

What are the best China alternatives to Docker Hub?

Chinaready currently lists these China-market options for Docker Hub Mirror: Xuanyuan Mirror, 1ms Mirror, DaoCloud Mirror, Alibaba Cloud ACR, Tencent Cloud TCR, Huawei Cloud SWR, Harbor. Prefer Xuanyuan Mirror, 1ms Mirror, or DaoCloud Mirror for development and CI pull speed; prefer Alibaba Cloud ACR, Tencent Cloud TCR, or Huawei Cloud SWR for production; prefer Harbor for enterprise self-hosted registries. Confirm fit before production adoption.

Is there a direct drop-in replacement for Docker Hub in mainland China?

Usually no. Public accelerators only speed up Hub pulls and are not a production registry. Production stacks typically move images into a cloud vendor private registry (ACR, TCR, or SWR) or a self-hosted Harbor, then retag CI/CD to pull from that warehouse.

Should teams use public Docker mirrors in production?

Prefer not to. Public accelerators such as Xuanyuan Mirror, 1ms Mirror, and DaoCloud Mirror help development and CI pull speed, but availability can change and they are a weak system of record. For production, use Alibaba Cloud ACR, Tencent Cloud TCR, Huawei Cloud SWR, or Harbor.

Where should teams go after shortlisting Docker Hub alternatives?

Decide whether you need pull acceleration, a managed private registry, or a self-hosted Harbor, then validate image provenance, access control, and mainland compliance. Use the interactive Chinaready Landscape for adjacent stack choices, then read Chinaready's main site for launch operating guidance. If the path remains unclear, book a call with Chinaready.