بکاپ و ریستور

از مسیر پنل مدیریت → 📦 بکاپ ربات می‌توانید بکاپ بگیرید و فاصلهٔ بکاپ خودکار را تنظیم کنید. فایل بکاپ به کانال 🗄 بکاپ ربات ارسال می‌شود؛ این کانال را از مدیریت لاگ‌ها ست کنید.

نکته مهم درباره بکاپ و ریستور

وقتی از داخل ربات بکاپ می‌گیرید، فقط از دیتابیس و فایل .env بکاپ گرفته می‌شود.

برای ریستور بکاپ:

1. اول ربات را روی سرور جدید نصب کنید.
2. بعد فایل SQL داخل ZIP را از طریق phpMyAdmin ایمپورت کنید.
3. مقدار CRYPTO_KEY را از فایل .env داخل بکاپ، دقیقاً روی .env سرور جدید بگذارید.

اگر CRYPTO_KEY را عوض نکنید، پسورد پنل‌ها و نمایندگی‌ها درست خوانده نمی‌شود و بعداً به مشکل می‌خورید.

بکاپ شامل چیست؟

داخل فایل ZIP معمولاً این دو فایل هست:

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

گرفتن بکاپ

پیش‌نیاز

از 📝 مدیریت لاگ‌ها کانال 🗄 بکاپ ربات را ست کنید. بدون این کانال، بکاپ ساخته/ارسال نمی‌شود. جزئیات: مدیریت لاگ‌ها.

بکاپ همین الان

1. وارد پنل مدیریت شوید.
2. 📦 بکاپ ربات را بزنید.
3. 🚀 بکاپ همین الان را انتخاب کنید.
4. فایل ZIP در کانال بکاپ ارسال می‌شود (مثلاً pasarguardbot-backup-YYYYMMDD-HHMMSS.zip).

بکاپ خودکار

از همان منو ⚙️ تنظیم فاصله را بزنید و تعداد ساعت را بفرستید (مثلاً 24). عدد 0 بکاپ خودکار را خاموش می‌کند.

ریستور — راهنمای مو به مو

ترتیب درست این است: نصب تازه → ست کردن CRYPTO_KEY → ایمپورت SQL → ری‌استارت.

مرحله ۱ — نصب ربات روی سرور جدید

طبق راهنمای نصب ربات را نصب کنید تا MariaDB، phpMyAdmin و خود ربات بالا بیایند.

همان BOT_TOKEN و ADMIN_ID قبلی را وارد کنید تا همان ربات تلگرام وصل شود.

بعد از نصب، از منوی سرور گزینهٔ 8) Show webhook & URLs را بزنید و آدرس‌ها را یادداشت کنید.

مرحله ۲ — آماده‌سازی فایل بکاپ

1. ZIP بکاپ را از کانال دانلود کنید.
2. آن را Extract کنید تا این دو فایل را ببینید:
   • database.sql
   • .env

مرحله ۳ — ست کردن CRYPTO_KEY (خیلی مهم)

روی سرور جدید، .env تازه ساخته شده را باز کنید:

pasarguardbot

سپس گزینهٔ 5) Edit .env file را بزنید.

داخل .env سرور جدید این خط را پیدا کنید:

CRYPTO_KEY=...

مقدارش را پاک کنید و مقدار CRYPTO_KEY فایل .env داخل بکاپ را دقیقاً جای آن بگذارید. بعد ذخیره کنید.

مرحله ۴ — پیدا کردن آدرس و رمز phpMyAdmin

آدرس

از منو گزینهٔ 8) Show webhook & URLs:

http://IP_سرور:6163

اگر دامنه دارید، همان دامنه را به‌جای IP بگذارید. جزئیات پورت‌ها: پورت‌ها.

یوزر و رمز دیتابیس

رمزها داخل .env سرور جدید هستند (همان فایل گزینهٔ ۵):

برای ورود به phpMyAdmin معمولاً کافی است:

• Username: pasarguardbot
• Password: مقدار MARIADB_PASSWORD

اگر با این یوزر مشکل داشتید، با root و MARIADB_ROOT_PASSWORD وارد شوید.

این رمزها موقع نصب هم یک‌بار در ترمینال چاپ می‌شوند؛ اگر از دست رفتند، فقط از .env بخوانید.

مرحله ۵ — بالا آوردن سرویس‌ها

اگر بعد از نصب همه چیز بالا است، نیازی به کار اضافه نیست. در غیر این صورت:

pasarguardbot

گزینهٔ 6) Full restart را بزنید. برای وضعیت:

• 7) Service status

باید MariaDB و phpMyAdmin فعال باشند تا ایمپورت ممکن شود.

مرحله ۶ — ایمپورت database.sql در phpMyAdmin

1. در مرورگر باز کنید: http://IP_سرور:6163
2. با یوزر/رمز مرحله ۴ وارد شوید.
3. از ستون چپ دیتابیس pasarguardbot را انتخاب کنید.
4. چون نصب تازه جدول‌های خالی ساخته، قبل از ایمپورت آن‌ها را پاک کنید:
   • تب Structure (ساختار)
   • پایین صفحه Check all (انتخاب همه)
   • از لیست عملیات Drop را بزنید و تأیید کنید
     تا هیچ جدولی نماند.
5. تب Import (درون‌ریزی / وارد کردن) را باز کنید.
6. Choose File / انتخاب فایل را بزنید و فایل database.sql را انتخاب کنید.
7. بقیه تنظیمات را پیش‌فرض بگذارید و Go / اجرا را بزنید.
8. صبر کنید تا پیام موفقیت بیاید (اگر فایل بزرگ است ممکن است چند دقیقه طول بکشد).

اگر خطای حجم فایل گرفتید، در phpMyAdmin محدودیت آپلود کم است؛ فایل را فشرده (database.sql.gz اگر ساختید) امتحان کنید یا از پشتیبانی هاست/سرور upload_max_filesize را بالا ببرید. برای اکثر بکاپ‌های ربات همان آپلود عادی کافی است.

مرحله ۷ — ری‌استارت نهایی ربات

بعد از ایمپورت و ست شدن CRYPTO_KEY:

pasarguardbot

گزینهٔ 6) Full restart را بزنید تا ربات با دیتابیس ریستور‌شده و کلید رمزنگاری درست بالا بیاید.

مرحله ۸ — بررسی بعد از ریستور

• در تلگرام به ربات /start یا /panel بدهید و پنل مدیریت باز شود.
• از منوی پنل‌ها وضعیت اتصال پنل‌ها را چک کنید.
• اگر نمایندگی دارید، نمایش رمز/ورود نمایندگی را یک‌بار تست کنید.
• اگر IP یا دامنه سرور عوض شده، وب‌هوک پنل پاسارگارد را با خروجی گزینهٔ 8 دوباره ست کنید. راهنما: نصب.

چک‌لیست سریع ریستور

1. نصب تازه روی سرور جدید
2. Extract کردن ZIP بکاپ
3. کپی دقیق CRYPTO_KEY از .env بکاپ روی .env جدید
4. ورود به phpMyAdmin با رمز داخل .env جدید
5. Drop کردن جدول‌های دیتابیس pasarguardbot
6. Import کردن database.sql
7. Full restart از منوی pasarguardbot
8. تست پنل‌ها / نمایندگی‌ها و در صورت نیاز ست مجدد وب‌هوک

اشتباهات رایج

آموزش‌های ویدیویی «Import SQL در phpMyAdmin» زیاد است؛ اگر اولین بار است، قبل از کار روی سرور اصلی یک‌بار با یک فایل تست تمرین کنید.