میرور داکر در ایران: pull بدون VPN با نوین کلاد

اگر docker pull روی سرورتان در ایران خطا میدهد یا وسط کار قطع میشود، سادهترین راه این است که داکر را به میرور نوین کلاد (Novin Cloud) وصل کنید. با یک خط در فایل /etc/docker/daemon.json همهی pullهای معمولی از docker.novin.cloud رد میشوند و نیازی به VPN یا لاگین ندارید.
میرور داکر نوین کلاد چیست؟
نوین کلاد (که گاهی ابرنوین یا نوین کلود هم نوشته میشود) یک رجیستری عمومی داکر را بهصورت میرور در اختیار همه گذاشته است. این رجیستری بدون ثبتنام کار میکند و ایمیجهای Docker Hub را از داخل کشور سرو میکند. دو آدرس برای آن وجود دارد: دامنهی کوتاه docker.novin.cloud و مسیر عمومی mirror.novin.cloud/docker.
یک نکته قبل از شروع: اگر با curl آدرس /v2/ را صدا بزنید، پاسخ 401 میگیرید. طبق مستندات Docker و OCI این رفتار طبیعی است و بخشی از فرایند استاندارد توکن داکر است. خود داکر توکن ناشناس را خودکار میگیرد. ما امروز همین مسیر را امتحان کردیم و manifest ایمیج hello-world با توکن ناشناس بدون مشکل برگشت.
راهاندازی میرور Docker Hub قدمبهقدم
-
یک pull مستقیم امتحان کنید. بدون تغییر هیچ تنظیمی، نام ایمیج را با پیشوند میرور بنویسید:
docker pull docker.novin.cloud/library/nginx docker pull docker.novin.cloud/bitnami/postgresqlاگر این کار کرد، اتصال سرورتان به میرور سالم است.
-
میرور را پیشفرض داکر کنید. فایل
/etc/docker/daemon.jsonرا باز کنید (اگر نیست، بسازید) و این کلید را اضافه کنید:{ "registry-mirrors": ["https://docker.novin.cloud"] }اگر فایل از قبل کلیدهای دیگری دارد، فقط
registry-mirrorsرا کنارشان بگذارید تا JSON خراب نشود. -
سرویس داکر را ریاستارت کنید.
sudo systemctl restart dockerاز این به بعد
docker pull nginxو دستورهای معمولی دیگر از میرور عبور میکنند. -
نتیجه را بررسی کنید.
docker pull docker.novin.cloud/library/hello-world docker image inspect hello-world --format '{{.RepoDigests}}' -
CI را هم به میرور بسپارید. در GitLab Runner یا هر CI دیگری کافی است
image:را با پیشوند میرور بنویسید:build: image: docker.novin.cloud/library/node:20 -
اگر از containerd استفاده میکنید (مثلاً روی نودهای کوبرنتیز)، در
/etc/containerd/config.tomlاین بخش را اضافه کنید و سرویس را ریاستارت کنید:[plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"] endpoint = ["https://docker.novin.cloud"]sudo systemctl restart containerdجزئیات بیشتر در راهنمای containerd آمده است.
رجیستریهای دیگر غیر از Docker Hub
ایمیجهای ghcr.io و quay.io و registry.k8s.io و چند رجیستری دیگر هم هر کدام در مخزن جدایی میرور شدهاند. مثلاً برای GitHub Container Registry این الگو کار میکند:
docker pull mirror.novin.cloud/docker-ghcr/<owner>/<image>
فهرست کامل نام مخزنها و دستور نصب خود Docker Engine از میرور در راهنمای Docker در مستندات نوین کلاد هست. اگر روی سرور اوبونتو کار میکنید، تنظیم apt با میرور اوبونتو را هم ببینید تا نصب پکیجها هم از داخل انجام شود.
برگرداندن تنظیمات
کلید registry-mirrors را از /etc/docker/daemon.json پاک کنید و داکر را ریاستارت کنید. pullهایی که مستقیم با docker.novin.cloud/... نوشتهاید چیزی برای برگرداندن ندارند و کافی است دوباره از docker.io/... استفاده کنید.
سؤالات متداول
برای استفاده از میرور داکر باید ثبتنام کنم؟
خیر. طبق مستندات، رجیستری عمومی است و docker pull بدون لاگین کار میکند.
چرا curl روی /v2/ خطای 401 میدهد؟
این پاسخ بخشی از فرایند توکن داکر است. کلاینت داکر خودش توکن ناشناس میگیرد و pull ادامه پیدا میکند، پس جای نگرانی نیست.
با registry-mirrors ایمیجهای ghcr.io هم از میرور میآیند؟
این تنظیم برای pullهای معمولی Docker Hub است. برای ghcr.io و رجیستریهای دیگر از مسیر مخزن خودشان روی mirror.novin.cloud استفاده کنید، مثل docker-ghcr.
شروع کنید
اگر سرور یا CI شما هنوز برای pull ایمیج به VPN وابسته است، همین امروز daemon.json را عوض کنید. معرفی کامل سرویس را در صفحهی رجیستری داکر نوین کلاد و فهرست بقیهی میرورها را در میرورهای نوین کلاد ببینید.