PP مستندات فضای ابری پارس‌پک
راهنمای تصویری برای cPanel /WHM

مقصد بکاپ JetBackup را روی پارس‌پک بسازید

این راهنما فقط به سبزشدن وضعیت Destination ختم نمی‌شود. ابتدا Bucket و یک کاربر اختصاصی آماده می‌کنید، بعد S3 Compatible Destination را می‌سازید و در پایان یک Job کوچک را تا مرحلهٔ Restore امتحان می‌کنید.

JetBackup 5.4 cPanel / WHM Custom S3 Vendor ۱۶ تصویر مرحله‌به‌مرحله
مقادیر Endpoint، Access Key، Secret Key و Bucket در تصویر اصلی پاک‌سازی شده‌اند. مقادیر واقعی را فقط از «مدیریت دسترسی» پنل پارس‌پک بردارید و هرگز در اسکرین‌شات یا تیکت عمومی قرار ندهید.
۱

سه انتخابی که اتصال به آن‌ها وابسته است

نوع مقصد، Vendor و تنظیم TLS باید مطابق مقادیر زیر باشند. ظرفیت و Thread را بعداً براساس بار واقعی سرور تنظیم کنید.

نوع Destination S3 Compatible پلاگین S3 باید نصب و فعال باشد.
Vendor Custom Vendor پارس‌پک در فهرست Vendorهای آماده نیست.
Region و TLS Region: empty Verify SSL = Yes
!

پارس‌پک برای هر Bucket سقف ۳۰۰ درخواست در دقیقه اعلام کرده است؛ Maximum Concurrent Threads سقف Workerها است و با درخواست‌ بر دقیقه یکسان نیست. عدد 5 در این راهنما فقط یک شروع محافظه‌کارانه برای تست است، نه مقدار رسمی سرویس‌دهنده. اگر 429 یا SlowDown دیدید، Threadها و Jobهای هم‌زمان را کمتر کنید.

۲

محیط را پیش از نصب بررسی کنید

فرمان‌های این بخش برای JetBackup 5 روی cPanel/WHM است و با کاربر root اجرا می‌شود.

  • دسترسی root به سرور و لایسنس یا Trial معتبر JetBackup
  • سیستم‌عامل و نسخه cPanel سازگار با راهنمای نصب فعلی JetBackup
  • Bucket اختصاصی پارس‌پک با فضای کافی و دسترسی خواندن/نوشتن/حذف
  • ارتباط خروجی HTTPS، DNS سالم و ساعت دقیق سرور

با کاربر root ابتدا مخزن JetApps و سپس نسخه Release مخصوص cPanel را نصب کنید:

bash <(curl -LSs https://repo.jetlicense.com/static/install)
jetapps --install jetbackup5-cpanel release
!

طبق مستندات فعلی JetBackup، برای Bucket این مقصد قابلیت‌های Versioning، Object Lock / Governance و Object Lifecycle نباید فعال باشند؛ این قابلیت‌ها ممکن است پاک‌سازی و یکپارچگی Backup را مختل کنند. برای JetBackup یک Bucket مستقل بسازید.

۳

Bucket و Credential را برای بکاپ جدا کنید

در پنل پارس‌پک، هم وضعیت Bucket را بررسی کنید و هم کلیدی بسازید که فقط به همین مقصد دسترسی داشته باشد.

ParsPack Panel→ Cloud Storage→ Access Management→ Connection Details
پنل پارس‌پک ۱

بازبینی تنظیمات Bucket

Bucket را خصوصی نگه دارید و Versioning و Object Lock را غیرفعال کنید. برای JetBackup یک Bucket مستقل در نظر بگیرید.

تنظیمات Bucket پارس‌پک با حالت خصوصی و Versioning و Lock غیرفعال
  • ۱ سطح اشتراک خصوصی
  • ۲ نسخه‌سازی غیرفعال
  • ۳ قفل Object غیرفعال
اطلاعات محل استفاده در JetBackup نکته
End Point URL Endpoint Endpoint اختصاصی همان سرویس را عیناً از پنل بردارید؛ پسوند آن ممکن است با نمونه‌های قدیمی متفاوت باشد.
Access Key Access Key برای JetBackup یک کاربر دسترسی مستقل بسازید تا چرخش یا لغو کلید ساده باشد.
Secret Key Secret Key مانند رمز عبور نگهداری کنید؛ آن را در Description، لاگ دستی یا تصویر ذخیره نکنید.
نام دقیق Bucket Bucket نام Bucket با Backup Directory تفاوت دارد و باید بدون تغییر وارد شود.
پنل پارس‌پک ۲

کاربر اختصاصی و مشخصات اتصال

در مدیریت دسترسی یک کاربر اختصاصی برای JetBackup بسازید و روی Bucket بکاپ دسترسی لازم برای خواندن، نوشتن، فهرست‌کردن و حذف Objectهای منقضی‌شده را بدهید.

Endpoint و کلیدها را همان لحظه در Password Manager ذخیره کنید. طبق پیام پنل، Secret Key کاربر جدید فقط تا ۲۴ ساعت قابل مشاهده است.

تنظیم دسترسی کامل کاربر JetBackup روی Bucket پارس‌پک
  • ۱ دسترسی کامل یا سیاست سفارشی معادل
  • ۲ Bucket اختصاصی Backup
  • ۳ ذخیره سطح دسترسی
مشخصات اتصال پاک‌سازی‌شده شامل Endpoint و Access Key و Secret Key در پنل پارس‌پک
تصویر رسمی پنل با Placeholderهای امن جایگزین شده است
  • ۱ End Point URL همان سرویس
  • ۲ Access Key
  • ۳ Secret Key؛ محرمانه
i

در نسخه فعلی JetBackup، Endpoint سفارشی به‌شکل hostname وارد می‌شود. اگر پنل پارس‌پک URL کامل با https:// نشان می‌دهد، بخش نام میزبان آن را در فیلد Endpoint قرار دهید؛ از مقدار نمونه داخل تصاویر کپی نکنید.

۴

S3 Destination را در WHM ثبت کنید

ابتدا افزونهٔ S3 Compatible را نصب کنید، بعد فرم اتصال را با مقدارهای همان Bucket پر کنید.

WHM→ JetBackup 5→ Destinations→ Create New Destination→ S3 Compatible
گام ۱

بازکردن JetBackup 5 در WHM

در جست‌وجوی WHM عبارت jet backup را بنویسید و JetBackup 5 را از بخش Plugins باز کنید.

جست‌وجوی JetBackup 5 در پنل WHM
  • ۱ جست‌وجوی نام افزونه
  • ۲ ورود به JetBackup 5
گام ۲

شروع ساخت Destination

از منوی JetBackup وارد Destinations شوید و Create New Destination را بزنید.

انتخاب Destinations در منوی JetBackup
  • ۱ منوی Destinations
دکمه Create New Destination در JetBackup
  • ۱ ساخت Destination جدید
گام ۳

انتخاب و نصب S3 Compatible

در فیلد Destination Type گزینه S3 Compatible را انتخاب کنید. اگر هنوز نصب نیست، JetBackup آن را از JetApps Repository نصب می‌کند.

انتخاب S3 Compatible از فهرست Destination Type
  • ۱ نوع S3 Compatible
دکمه Install Now برای نصب پلاگین S3 Compatible
  • ۱ نصب پلاگین در صورت نیاز
گام ۴

تکمیل فرم اتصال

فیلدها را با این الگو پر کنید:

  • Destination Name: نامی روشن مانند ParsPack S3
  • Read Only: برای مقصد فعال Backup روی No
  • Owner: در سناریوی سراسری WHM معمولاً root
  • Maximum Concurrent Threads: برای تست اولیه نمونه محافظه‌کارانه 5؛ این مقدار رسمی نیست و براساس Log و Rate Limit تنظیم می‌شود
  • Vendor: حتماً Custom Vendor
  • Backup Directory: مسیر مطلق و یکتا مانند /jetbackup/
  • Region: برای پارس‌پک خالی
  • Verify SSL: روی Yes
فرم کامل و پاک‌سازی‌شده ساخت S3 Destination در JetBackup
فرم کامل Destination؛ اطلاعات محرمانه با Placeholder جایگزین شده‌اند
  • ۱ S3 Compatible و نام Destination
  • ۲ سقف Concurrent Threads
  • ۳ Custom Vendor
  • ۴ Endpoint اختصاصی پارس‌پک
  • ۵ Access/Secret Key، Bucket و Region خالی
  • ۶ ذخیره تنظیمات
مقادیر تکمیلی فرم چه کاری انجام می‌دهند؟
فیلد شروع پیشنهادی زمان تغییر
HTTP Retries 3 (پیش‌فرض) فقط برای خطاهای گذرای شبکه افزایش دهید؛ Retry بیشتر زمان Job را زیاد می‌کند.
Large files upload chunk size 5120 MB (پیش‌فرض) اگر آپلود فایل‌های بزرگ شکست می‌خورد، مقدار را کاهش دهید.
Keep Alive timeout 60 sec برای ارتباط کند یا ناپایدار با اندازه‌گیری و تست افزایش دهید.
Max Keep Alive requests 100 در حالت عادی پیش‌فرض یا مقدار تعیین‌شده توسط Vendor کافی است.
Low Speed Timeout 2 min اگر ارتباط سالم ولی کند است، پیش از افزایش، شبکه و Packet Loss را بررسی کنید.
Upload Verification No فعال‌سازی هر Object را دوباره بررسی می‌کند و می‌تواند افت کارایی محسوسی ایجاد کند.
۵

Destination را پیش از ساخت Job اعتبارسنجی کنید

موفقیت Validate فقط نشان می‌دهد JetBackup می‌تواند با Destination کار کند؛ هنوز باید اجرای بکاپ و Restore را جداگانه بسنجید.

گام ۵

اجرای Validate Destination

Destination ساخته‌شده را باز کنید و روی Validate Destination بزنید. پیام سبز موفقیت یعنی Endpoint، Credential و دسترسی پایه Bucket پذیرفته شده‌اند.

Validation موفق جای آزمون Restore را نمی‌گیرد؛ بعد از نخستین Backup حتماً یک بازیابی آزمایشی انجام دهید.
انتخاب Validate Destination در JetBackup
  • ۱ اجرای اعتبارسنجی مقصد
پیام موفقیت Destination Validated Successfully
  • ۱ تأیید اتصال موفق
۶

بنای Backup Job را بر نیاز Restore بگذارید

پیش از انتخاب محتوا و Retention، مشخص کنید قرار است چه چیزی، با چه زمان بازگشتی و تا چند نسخه بازیابی شود.

Backup Jobs→ Create New Backup Job→ Add Destination→ ParsPack S3
گام ۶

ایجاد Job جدید

از منوی Backup Jobs وارد شوید و Create New Backup Job را انتخاب کنید.

انتخاب Backup Jobs در منوی JetBackup
  • ۱ منوی Backup Jobs
دکمه Create New Backup Job
  • ۱ ساخت Job جدید
گام ۷

افزودن مقصد پارس‌پک

در بخش Destinations روی Add Destination بزنید، مقصد S3 پارس‌پک را علامت بزنید و انتخاب را تأیید کنید.

دکمه Add Destination در فرم Backup Job
  • ۱ افزودن Destination
انتخاب مقصد S3 پارس‌پک در پنجره Destinations Selection
  • ۱ علامت‌زدن مقصد پارس‌پک
  • ۲ تأیید انتخاب
گام ۸

تنظیم نوع، محتوا و زمان‌بندی

  • Job Name: نام یکتا و قابل جست‌وجو
  • Owner: کاربر دارای مجوز مدیریت Job؛ در این سناریو root
  • Backup Type: Accounts، Directories یا Server Backup (BMR)
  • Backup Contains: فقط اقلام واقعاً موردنیاز
  • Backup Structure: متناسب با Restore، CPU، فضا و Retention
  • Retry failed items: روی Yes
  • Account Filters: دامنه حساب‌ها را آگاهانه محدود کنید
  • Schedules: زمان‌بندی خارج از ساعات پرترافیک
فرم کامل Create New Backup Job در JetBackup
  • ۱ نام و Owner
  • ۲ Destination پارس‌پک
  • ۳ Backup Type و محتوا
  • ۴ Backup Structure و Retry
  • ۵ Filter و Schedule
  • ۶ ذخیره Job
!

در JetBackup همه حساب‌های Active و Suspended به‌طور پیش‌فرض می‌توانند داخل Job باشند. قبل از اولین اجرای حجیم، Account Filters، Retention و Schedule را بازبینی کنید. برای تست اولیه، یک حساب کم‌حجم انتخاب کنید.

۷

بکاپ موفق را با Restore تأیید کنید

وضعیت Successful یعنی آرشیو نوشته شده است؛ قابل‌استفاده‌بودن آن را فقط یک Restore آزمایشی نشان می‌دهد.

  1. در فهرست Backup Jobs، Job جدید را باز کنید و Run Backup Job Now را بزنید.
  2. وضعیت را در Dashboard و Queue دنبال کنید.
  3. پس از پایان، Log را برای Partial/Warning، Retry زیاد یا Rate Limit بررسی کنید.
  4. در پنل پارس‌پک رشد Objectها و مصرف فضا را کنترل کنید؛ فایل‌های ساخته‌شده را دستی جابه‌جا یا حذف نکنید.
  5. یک فایل یا حساب آزمایشی را از JetBackup بازیابی و صحت محتوا و مجوزها را بررسی کنید.
✓

معیار تحویل: Validation موفق، پایان Job بدون خطای جدی، مشاهده Objectها در Bucket، و یک Restore آزمایشی موفق. پس از آن دامنه حساب‌ها و Retention را گسترش دهید.

۸

از Log همان Job شروع کنید

نتیجهٔ Validate و Log اجرا دو چیز متفاوت را نشان می‌دهند. برای خطای هر Job، همان Log را با کد HTTP و زمان رخداد بررسی کنید.

نشانه بررسی و اقدام
S3 Compatible در فهرست نیست روی Install Now بزنید؛ وضعیت JetApps Repository، Plugins و ارتباط سرور با مخزن JetBackup را بررسی کنید.
AccessDenied نام Bucket و کلیدها را دوباره بررسی کنید؛ کاربر باید مجوزهای لازم برای List/Get/Put/Delete در Bucket اختصاصی را داشته باشد.
SignatureDoesNotMatch Endpoint را از پنل دوباره کپی کنید، Region را برای پارس‌پک خالی بگذارید، ساعت سرور و Access/Secret Key را کنترل کنید.
خطای TLS یا Certificate DNS و تاریخ سرور را اصلاح کنید و زنجیره گواهی Endpoint را بررسی کنید؛ Verify SSL را برای دورزدن مشکل غیرفعال نکنید.
429 / Rate Limit Maximum Concurrent Threads و تعداد Jobهای هم‌زمان را مرحله‌ای کاهش دهید؛ Retry را بدون تحلیل زیاد نکنید.
آپلود فایل‌های بزرگ قطع می‌شود Packet Loss و پهنای باند را بررسی کنید؛ سپس Chunk Size را کاهش و در ارتباط سالمِ کند، Low Speed Timeout را کمی افزایش دهید.
Job به‌صورت Partial تمام می‌شود Queue و Log را بررسی کنید؛ فایل‌های دائماً درحال‌تغییر مثل Cache/Log/Temp را در صورت امکان Exclude کنید و Job را دوباره اجرا کنید.
مصرف دانلود از Object Storage دیده می‌شود JetBackup برای Indexing در هر اجرا فایل‌های SQLite مقصد را می‌خواند؛ مقداری Egress در مقصد S3 رفتار مورد انتظار است.
۹

منابع و دامنه اعتبار

رابط تصویری از سند ارائه‌شده و مقادیر فنی با مستندات جاری سازگار شده‌اند.