Harbor یک Registry متنباز برای ایمیجهای کانتینر است که زیر چتر CNCF توسعه داده میشود. Docker Registry ساده فقط ایمیج نگه میدارد، ولی Harbor پروژه و سطح دسترسی، حساب Robot برای CI/CD، اسکن آسیبپذیری با Trivy، Proxy Cache، Replication و سیاست نگهداری نسخهها هم دارد. برای تیمهای داخل ایران، Proxy Cache آن مشکل دسترسی به Docker Hub را به شکلی پایدار و قابل کنترل حل میکند. در این راهنما Harbor را روی Ubuntu ۲۴.۰۴ نصب میکنیم.
پیشنیازها
- سرور Ubuntu ۲۴.۰۴. حداقل طبق مستندات Harbor: ۲ هسته CPU، ۴ گیگابایت RAM و ۴۰ گیگابایت دیسک. برای کار تیمی ۴ هسته و ۸ گیگابایت RAM و دیسک بزرگتر بهتر است.
- Docker Engine و پلاگین Docker Compose (حداقل نسخهها در صفحهی پیشنیازهای Harbor آمده).
- یک دامنه، مثلاً
harbor.example.com، با گواهی SSL معتبر. - پورت ۴۴۳ باز روی فایروال (و ۸۰ اگر ریدایرکت میخواهید).
Harbor را کجا نصب کنیم؟
برای Proxy Cache، خود سرور Harbor باید به Docker Hub دسترسی پایدار داشته باشد. پس یا Harbor را روی یک سرور مجازی خارج از ایران بگذارید، یا Harbor داخل ایران و کنار سرورهای Production داشته باشید که ایمیجها را از یک Registry خارج Replicate کند. راهحلهای دیگر را در دسترسی به Docker Hub از ایران مقایسه کردهایم.
قدم ۱: نصب Docker
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
docker compose version
اگر مخزن Docker از سرور باز نمیشود، یک مخزن واسط مثل Nexus بگذارید (آموزش راهاندازی Nexus).
قدم ۲: دانلود Installer
در صفحهی Releases مخزن goharbor/harbor در GitHub دو Installer هست. Online Installer ایمیجها را هنگام نصب از Docker Hub میگیرد و روی سرور داخل ایران معمولاً با خطای ۴۰۳ متوقف میشود. Offline Installer همهی ایمیجها را در خودش دارد و برای سرور داخل ایران همین را بردارید.
اگر GitHub از روی سرور کند است، فایل را جای دیگری بگیرید و با scp منتقل کنید. شمارهی آخرین نسخهی پایدار را در متغیر VER بگذارید:
VER=v2.x.y # آخرین نسخهی پایدار را از صفحهی Releases جایگزین کنید
wget https://github.com/goharbor/harbor/releases/download/${VER}/harbor-offline-installer-${VER}.tgz
wget https://github.com/goharbor/harbor/releases/download/${VER}/harbor-offline-installer-${VER}.tgz.asc
sudo tar xzvf harbor-offline-installer-${VER}.tgz -C /opt
cd /opt/harbor
فایل .asc امضای Installer است و روش بررسیاش در مستندات Harbor آمده.
قدم ۳: گواهی SSL
Harbor را بدون HTTPS بالا نیاورید. Docker هم بهطور پیشفرض با Registry بدون TLS کار نمیکند. برای دامنهی عمومی:
sudo apt install -y certbot
sudo certbot certonly --standalone -d harbor.example.com
اگر سرور از اینترنت در دسترس نیست، از CA داخلی سازمان گواهی بگیرید و گواهی CA را روی هر کلاینت در /etc/docker/certs.d/harbor.example.com/ca.crt بگذارید.
قدم ۴: تنظیم harbor.yml
sudo cp harbor.yml.tmpl harbor.yml
sudo nano harbor.yml
hostname: harbor.example.com
http:
port: 80
https:
port: 443
certificate: /etc/letsencrypt/live/harbor.example.com/fullchain.pem
private_key: /etc/letsencrypt/live/harbor.example.com/privkey.pem
harbor_admin_password: A-Strong-Password-Here
database:
password: Another-Strong-Password
data_volume: /data
hostnameهمان دامنهای است که کلاینتها با آن وصل میشوند، نهlocalhostیا IP.harbor_admin_passwordفقط برای اولین ورود است. بعدش رمز را از پنل عوض کنید.data_volumeمحل ایمیجها و دیتابیس است و باید روی دیسک بزرگ و جدا باشد. ایمیجها را میشود در Object Storage سازگار با S3 هم نگه داشت (بخشstorage_service).
قدم ۵: نصب همراه با Trivy
نصب پیشفرض Trivy را ندارد و باید فلگ --with-trivy را بدهید:
sudo ./install.sh --with-trivy
sudo docker compose ps
همهی سرویسها باید healthy باشند. حالا https://harbor.example.com را باز کنید و با کاربر admin وارد شوید. هر بار harbor.yml را عوض کردید، sudo ./prepare --with-trivy و بعد docker compose down و docker compose up -d را اجرا کنید.
Trivy برای بهروز کردن پایگاه آسیبپذیریها اینترنت لازم دارد و روی سرور داخل ایران ممکن است شکست بخورد. حالت آفلاین Trivy در مستندات Harbor آمده.
قدم ۶: ساخت پروژه و Push اولین ایمیج
هر ایمیج داخل یک Project است. از منوی Projects یک پروژهی خصوصی مثل myteam بسازید و در تنظیماتش Automatically scan images on push (اسکن هر ایمیج تازه) و Prevent vulnerable images from running (جلوگیری از Pull ایمیج با آسیبپذیری بالاتر از سطح تعیینشده) را روشن کنید.
docker login harbor.example.com
docker tag myapp:1.0 harbor.example.com/myteam/myapp:1.0
docker push harbor.example.com/myteam/myapp:1.0
تا نسخههای Release بازنویسی نشوند، در Policy پروژه یک قانون Tag Immutability مثلاً برای الگوی v* بگذارید.
قدم ۷: Robot Account برای CI/CD
رمز admin یا کاربر شخصی را در CI نگذارید. از بخش Robot Accounts پروژه یک Robot با دسترسی Push و Pull فقط روی همان پروژه و با تاریخ انقضا بسازید. نام کاربری (با پیشوند robot$) و توکن را در متغیرهای مخفی CI بگذارید:
echo "$HARBOR_TOKEN" | docker login harbor.example.com -u 'robot$myteam+ci' --password-stdin
سرورهای Production یک Robot جدا با دسترسی فقط Pull بگیرند. یک Pipeline کامل در راهاندازی CI/CD با GitLab و Docker هست.
قدم ۸: Proxy Cache برای Docker Hub
- از Administration ← Registries یک Endpoint از نوع
Docker Hubبسازید. نام کاربری و Access Token یک حساب Docker Hub را بدهید تا سقف Pull بالاتر برود و با Test Connection چک کنید. - از Projects ← New Project پروژهای مثل
dockerhubبسازید، Proxy Cache را روشن کنید و همان Endpoint را انتخاب کنید.
از این به بعد ایمیجها را با پیشوند این پروژه بگیرید. ایمیجهای رسمی زیر library هستند:
docker pull harbor.example.com/dockerhub/library/nginx:alpine
docker pull harbor.example.com/dockerhub/bitnami/redis:latest
در Dockerfile و فایل Compose هم همین آدرس را بنویسید. برای GitHub Container Registry یا Quay هم میشود Endpoint و پروژهی Proxy Cache جدا ساخت.
قدم ۹: Replication
از Administration ← Replications ایمیجها را بین دو Registry بهصورت Push یا Pull همگام کنید، با فیلتر نام و Tag، و اجرای دستی، زمانبندیشده یا بلافاصله بعد از Push. مثلاً CI روی سرور خارج ایمیج را در Harbor خارج Push میکند و Replication آن را به Harbor داخل ایران کنار Production میبرد.
قدم ۱۰: پاکسازی و Garbage Collection
حذف ایمیج از پنل فقط ارجاع را برمیدارد و لایهها روی دیسک میمانند. پس:
- Tag Retention در تنظیمات هر پروژه، مثلاً نگهداشتن ۱۰ نسخهی آخر هر Repository یا نسخههایی که در ۳۰ روز اخیر Pull شدهاند.
- Garbage Collection از Administration ← Clean Up، هفتگی و در ساعت کمترافیک. اول با Dry Run ببینید چقدر آزاد میشود.
قدم ۱۱: بکاپ
دو چیز بکاپ لازم دارد: دیتابیس PostgreSQL (کاربران، پروژهها، تنظیمات) و ایمیجها در data_volume. سادهترین بکاپ سازگار با یک توقف کوتاه:
cd /opt/harbor
sudo docker compose down
sudo tar czf /backup/harbor-$(date +%F).tar.gz /data /opt/harbor/harbor.yml
sudo docker compose up -d
اگر توقف ممکن نیست، از دیتابیس با pg_dump داخل کانتینر harbor-db بکاپ بگیرید و پوشهی ایمیجها را جدا کپی کنید، یا ایمیجها را در Object Storage نگه دارید. بکاپ را به سرور دیگری بفرستید (بکاپ با Restic روی Object Storage) و بازیابی را دستکم یک بار روی سرور تست امتحان کنید.
چند نکته برای Production
- پیش از ارتقا، یادداشتهای انتشار و راهنمای Upgrade را بخوانید و بکاپ بگیرید. ارتقا معمولاً Migration دیتابیس دارد.
- Self-registration را خاموش کنید و اگر میشود Harbor را به LDAP یا OIDC سازمان وصل کنید.
- فضای
data_volumeرا مانیتور کنید. Registry که پر شود، Build و Deploy هم میایستد.
اگر نمیخواهید راهاندازی و نگهداری Harbor یا Nexus را خودتان انجام دهید، تیم مروانت آن را روی زیرساخت شما یا سرورهای مروانت راه میاندازد و به CI/CD وصل میکند. صفحهی برونسپاری پروژههای Docker را ببینید.


