چگونگی پشتیبان‌گیری و بازیابی Coolify در ۱۲ دقیقه

امروز سرور شما امن به نظر می‌رسد. شما ساعت‌ها وقت صرف راه‌اندازی Coolify کرده‌اید. خودتان اپلیکیشن‌ها، پایگاه‌های داده و وبلاگ‌هایتان را میزبانی می‌کنید. احساس کنترل کامل دارید.

سپس یک فاجعه رخ می‌دهد. ارائه‌دهنده VPS شما منطقه (region) مورد نظر را از دسترس خارج می‌کند. یک دستور اشتباه اجرا می‌کنید. سرور از کار می‌افتد.

اگر بک‌آپ نداشته باشید، همه چیز را از دست می‌دهید. این راهنما از این اتفاق جلوگیری می‌کند. شما می‌توانید بک‌آپ‌های خودکار و یک بازیابی کامل را در ۱۲ دقیقه راه‌اندازی کنید.

مرحله ۱: راه‌اندازی ذخیره‌ساز S3

Coolify برای ذخیره بک‌آپ‌ها به یک مکان نیاز دارد. از ذخیره‌سازهای سازگار با S3 استفاده کنید. Cloudflare R2 انتخاب بسیار خوبی است زیرا هزینه خروجی داده (egress fees) ندارد.

شما به این جزئیات از ارائه‌دهنده ذخیره‌ساز خود نیاز دارید:

  • Endpoint
  • Region
  • Access Key
  • Secret Key
  • Bucket Name

در Coolify، به تب S3 Storage بروید. جزئیات خود را وارد کرده و روی Validate Connection کلیک کنید.

مرحله ۲: فعال‌سازی بک‌آپ‌های خودکار

به Settings و سپس Backup بروید.

  • S3 Backup را روشن کنید.
  • Backup را روشن کنید.
  • منبع ذخیره‌ساز S3 خود را انتخاب کنید.
  • فرکانس (frequency) را روی Daily تنظیم کنید.

بلافاصله یک بک‌آپ دستی اجرا کنید. با بررسی S3 bucket خود مطمئن شوید که فایل وجود دارد.

مرحله ۳: ذخیره کردن APP_KEY

این مهم‌ترین مرحله است. Coolify داده‌های شما را رمزنگاری می‌کند. اگر این کلید را از دست بدهید، بک‌آپ شما بی‌فایده خواهد بود.

از طریق SSH به سرور خود متصل شوید و دستور زیر را اجرا کنید: cat /data/coolify/source/.env

خطی که با APP_KEY شروع می‌شود را پیدا کنید. این مقدار را کپی کنید. آن را در یک مدیریت‌کننده رمز عبور (password manager) ذخیره کنید. این مرحله را نادیده نگیرید.

مرحله ۴: بازیابی در یک سرور جدید

اگر سرور شما از کار افتاد، این مراحل را در VPS جدید خود دنبال کنید:

۱. Coolify را با استفاده از دستور استاندارد curl نصب کنید. ۲. فایل .pgdump خود را از S3 bucket به سرور جدید دانلود کنید. ۳. دستور بازیابی را اجرا کنید:

sudo docker exec -i coolify-db pg_restore --username coolify --verbose --dbname coolify < /path/to/your-backup.pgdump

ممکن است هشدارهایی درباره جداول موجود مشاهده کنید. آن‌ها را نادیده بگیرید. فرآیند همچنان کار می‌کند.

مرحله ۵: رفع خطای ۵۰۰

پس از بازیابی، ممکن است هنگام کلیک روی اپلیکیشن‌ها با خطای ۵۰۰ مواجه شوید. این اتفاق به این دلیل می‌افتد که سرور جدید دارای APP_KEY متفاوتی است.

برای رفع این مشکل:

  • فایل .env جدید خود را باز کنید: nano /data/coolify/source/.env
  • این خط را اضافه کنید: APP_PREVIOUS_KEYS=base64:your-old-app-key
  • فایل را ذخیره کرده و Coolify را با استفاده از اسکریپت نصب مجدداً راه‌اندازی کنید.

اکنون داده‌های قدیمی شما دوباره قابل خواندن هستند.

چک‌لیست خلاصه:

  • راه‌اندازی ذخیره‌ساز S3.
  • فعال‌سازی بک‌آپ‌های روزانه.
  • ذخیره امن APP_KEY.
  • تست یک بک‌آپ دستی.

میزبانی شخصی (Self-hosting) به شما کنترل می‌دهد. بک‌آپ‌ها به شما آرامش خاطر می‌بخشند.

منبع: https://dev.to/dev-arafat-alim/how-to-backup-and-restore-coolify-in-12-minutes-before-your-server-dies-on-a-friday-night-254p