نصب با اینترنت ملی ایران (بدون دسترسی خارجی)

این راهنما برای کسانی است که فقط به اینترنت ملی ایران دسترسی دارند و نمی‌توانند مستقیماً به Docker Hub متصل شوند. با استفاده از رجیستری آروان‌کلاود، می‌توانید تمام ایمیج‌های Docker را از سرورهای داخل ایران دانلود کنید.

چرا این روش؟

• ✅ دسترسی به ایمیج‌های Docker از طریق سرورهای داخل ایران
• ✅ سرعت دانلود بالاتر (بدون نیاز به VPN یا پروکسی)
• ✅ بدون نیاز به اینترنت جهانی
• ✅ کاملاً قانونی و مطابق با قوانین کشور

پیش‌نیازها

• Docker و Docker Compose نصب شده باشد
• دسترسی به اینترنت ملی ایران
• دسترسی root یا sudo برای تغییر تنظیمات Docker

مراحل نصب

مرحله ۱: تنظیم رجیستری آروان‌کلاود

برای استفاده از رجیستری آروان‌کلاود، باید فایل تنظیمات Docker را ویرایش کنید.

لینوکس:

1. فایل /etc/docker/daemon.json را بسازید یا ویرایش کنید:

sudo nano /etc/docker/daemon.json

1. محتوای زیر را در فایل قرار دهید:

{
  "registry-mirrors": ["https://docker.arvancloud.ir"]
}

1. فایل را ذخیره کنید (در nano: Ctrl+O سپس Enter، سپس Ctrl+X)

2. سرویس Docker را ری‌استارت کنید:

sudo systemctl restart docker

ویندوز:

1. Docker Desktop را باز کنید
2. به Settings → Docker Engine بروید
3. فایل daemon.json را ویرایش کنید و خط زیر را اضافه کنید:

{
  "registry-mirrors": ["https://docker.arvancloud.ir"]
}

1. روی "Apply & Restart" کلیک کنید

macOS:

1. Docker Desktop را باز کنید
2. به Preferences → Docker Engine بروید
3. فایل daemon.json را ویرایش کنید و خط زیر را اضافه کنید:

{
  "registry-mirrors": ["https://docker.arvancloud.ir"]
}

1. روی "Apply & Restart" کلیک کنید

مرحله ۲: بررسی تنظیمات

برای اطمینان از اینکه تنظیمات درست اعمال شده‌اند:

docker info | grep -A 5 "Registry Mirrors"

باید آدرس https://docker.arvancloud.ir را ببینید.

مرحله ۳: دانلود فایل‌های پیکربندی

فایل‌های docker-compose.yml و .env را دانلود کنید (از سایت پن‌پاتیفای یا از مخزن GitHub).

مرحله ۴: تنظیم فایل .env

فایل .env را باز کنید و تنظیمات زیر را بررسی کنید:

PENPOT_PUBLIC_URI=http://localhost:9001
PENPOT_REGISTRATION_ENABLED=true

مرحله ۵: اجرای Penpot

حالا می‌توانید Penpot را اجرا کنید. تمام ایمیج‌ها از طریق سرورهای آروان‌کلاود دانلود می‌شوند:

docker compose up -d

نکته: اگر ایمیج خاصی در رجیستری آروان موجود نبود، Docker به صورت خودکار از Docker Hub اصلی تلاش می‌کند (که ممکن است نیاز به VPN داشته باشد). در این صورت، می‌توانید از بسته آفلاین کامل استفاده کنید.

مرحله ۶: دسترسی به Penpot

مرورگر خود را باز کنید و به آدرس زیر بروید:

http://localhost:9001

رجیستری‌های جایگزین

اگر آروان‌کلاود برای شما کار نمی‌کند، می‌توانید از رجیستری‌های دیگر استفاده کنید:

رجیستری شاتل:

{
  "registry-mirrors": ["https://registry.docker.ir"]
}

استفاده از چند رجیستری:

{
  "registry-mirrors": [
    "https://docker.arvancloud.ir",
    "https://registry.docker.ir"
  ]
}

عیب‌یابی

مشکل: ایمیج دانلود نمی‌شود - بررسی کنید که تنظیمات daemon.json درست اعمال شده باشد - Docker را ری‌استارت کنید - لاگ‌های Docker را بررسی کنید: docker compose logs

مشکل: سرعت دانلود پایین است - از رجیستری دیگری استفاده کنید - اتصال اینترنت خود را بررسی کنید

مشکل: ایمیج خاصی پیدا نمی‌شود - برخی ایمیج‌های خاص ممکن است در رجیستری‌های ایرانی موجود نباشند - در این صورت از بسته آفلاین کامل استفاده کنید

نکات مهم

• رجیستری‌های ایرانی معمولاً ایمیج‌های محبوب را دارند، اما ممکن است همه ایمیج‌ها موجود نباشند
• برای اطمینان کامل از دسترسی آفلاین، از بسته آفلاین استفاده کنید
• تنظیمات رجیستری روی تمام پروژه‌های Docker شما تأثیر می‌گذارد

گام بعدی

بعد از نصب موفق، می‌توانید: - نحوه کارکرد پن‌پاتیفای را بخوانید - برای استفاده تیمی، راهنمای نصب برای تیم را مطالعه کنید