Skip to content

FA Update Backup Restore

github-actions[bot] edited this page Oct 29, 2026 · 3 revisions

به‌روزرسانی، پشتیبان و بازیابی

فهرست راهنما · عیب‌یابی · نصب

همهٔ دستورهای این صفحه را روی سرور و با sudo اجرا کنید. اگر BOBRES را جای دیگری نصب کرده‌اید، به هر دستور --dir <مسیر> اضافه کنید (پیش‌فرض /opt/bobres).

به‌روزرسانی

انتشارهای BOBRES امضا دارند (Ed25519) و هر نصبی، حتی بدون لایسنس، همهٔ آن‌ها را می‌گیرد. اصلاحیه‌های امنیتی هیچ‌وقت نگه داشته نمی‌شوند. هسته و ربات همیشه با هم جلو می‌روند.

اول ببینید نسخهٔ تازه‌ای هست یا نه:

sudo bobres update --check

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

sudo bobres update

این دستور به ترتیب: امضای انتشار را می‌سنجد، دست‌کم ۲ گیگابایت فضای خالی می‌خواهد، از شما تأیید می‌گیرد، bobres تازه را می‌گیرد و با checksum می‌سنجد، نقطهٔ بازگشت می‌سازد (پشتیبان پایگاه داده و نسخهٔ فایل‌های نصب)، تصویرهای تازه را می‌گیرد، سرویس‌ها را دوباره بالا می‌آورد و تا ۵ دقیقه منتظر سالم شدن می‌ماند. ربات یکی دو دقیقه پاسخ نمی‌دهد، پس ساعت کم‌رفت‌وآمد را انتخاب کنید. لینک‌های VPN مشتری‌ها در این مدت کار می‌کنند. مهاجرت پایگاه داده را خود به‌روزرسانی انجام می‌دهد و فقط چیز اضافه می‌کند، پس سفارش‌ها و اعتبار از بین نمی‌روند.

بازگشت خودکار: اگر نسخهٔ تازه نصب نشود یا ظرف مهلت سالم نشود، به‌روزرسانی خودش به نسخهٔ قبلی برمی‌گردد و می‌گوید چه شد.

از داشبورد

مالک می‌تواند بدون SSH به‌روزرسانی کند: سیستم ← به‌روزرسانی ← «به‌روزرسانی اکنون». پنجرهٔ تأیید نسخه و کانال را می‌گوید و یادآوری می‌کند داشبورد و ربات چند دقیقه در دسترس نیستند (اگر با رمز و برنامهٔ احراز هویت وارد شده‌اید، کد فعلی را هم می‌خواهد). همان مراحل (امضا، پشتیبان، دریافت، راه‌اندازی، بررسی سلامت و بازگشت خودکار) نشان داده می‌شود و پایان کار به همهٔ مالک‌ها در تلگرام خبر می‌رسد. «بررسی دوباره» همان لحظه GitHub را نگاه می‌کند (به‌طور عادی هر ۱۲ ساعت). اگر دکمه کار نمی‌کند و پیام «به‌روزرسان نصب نیست» آمد، یک بار sudo bobres update را روی سرور بزنید تا به‌روزرسان داشبورد نصب شود.

کانال: «پایدار» (پیش‌فرض، فقط انتشارهای آزموده) یا «بتا» (پیش‌انتشارها هم). در همان زبانه یا با تنظیم updates.channel عوض می‌شود.

برگرداندن آخرین به‌روزرسانی

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

sudo bobres rollback

نسخهٔ قبلی و پایگاه داده‌ای که پیش از به‌روزرسانی بود برمی‌گردد. هرچه بعد از به‌روزرسانی ثبت شده (سفارش، پرداخت) از دور خارج می‌شود، ولی در یک پشتیبان به نام bobres-<زمان>-before-rollback.bkp ذخیره می‌ماند. فقط آخرین به‌روزرسانی نقطهٔ بازگشت دارد و یک بار قابل استفاده است. داشبورد دکمهٔ بازگشت ندارد.

پشتیبان‌گیری

  • روزانه ساعت ۰۳:۳۰ (به منطقهٔ زمانی نصب؛ پیش‌فرض Asia/Tehran) یک پشتیبان کامل از پایگاه داده ساخته می‌شود.
  • در /opt/bobres/backups نگه داشته می‌شوند (۷ تای آخر) و هر کدام به تلگرام مالک هم فرستاده می‌شود. فایل بزرگ‌تر از ۵۰ مگابایت به تلگرام نمی‌رود؛ پیام می‌گیرید و فایل روی سرور می‌ماند.
  • اختیاری: کپی هر پشتیبان در فضای سازگار با S3 (Arvan، MinIO، Backblaze، AWS) با گزینه‌های --s3-endpoint و --s3-bucket در sudo bobres install. پشتیبان همیشه رمزگذاری‌شده است.
  • از داشبورد: سیستم ← پشتیبان‌ها فهرست را با اندازه، وضعیت ارسال به تلگرام و کپی بیرونی و دکمهٔ «پشتیبان‌گیری الان» دارد. مالک می‌تواند هر پشتیبان را دانلود کند.

پشتیبان فوری از خط فرمان:

sudo bobres backup

کلید پشتیبان

پشتیبان‌ها با کلید پشتیبان (BOBRES_BACKUP_KEY) رمزگذاری می‌شوند. نصب‌کننده آن را یک بار چاپ می‌کند. آن را جایی دور از سرور نگه دارید: بدون آن هیچ پشتیبانی خوانده نمی‌شود. کلید هیچ‌وقت به تلگرام نمی‌رود. روی سرور با sudo bobres و گزینهٔ «Backup key» دوباره دیده می‌شود. هر پشتیبان، کلیدهای اصلی را هم در خود دارد؛ پس «پشتیبان + کلید پشتیبان» برای بازیابی روی سرور تازه کافی است.

عوض کردن کلیدهای اصلی

کلیدهای اصلی (BOBRES_CORE_MASTER_KEY و دو کلید دیگر) توکن‌های 3x-ui، رمزهای برنامهٔ احراز هویت کارکنان و تنظیمات درگاه‌ها را در پایگاه داده رمز می‌کنند. اگر .env یا یک پشتیبان با کلیدش به دست دیگری افتاده، یا می‌خواهید زمان‌بندی‌شده عوضشان کنید:

sudo bobres rotate-key --dry-run   # همه‌چیز را می‌شمرد و می‌سنجد، چیزی را عوض نمی‌کند
sudo bobres rotate-key

دستور فقط وقتی شروع می‌کند که فروشگاه سالم باشد و کلیدهای فعلی همهٔ دادهٔ رمزشده را بخوانند. اول پشتیبان می‌گیرد و آن را کامل می‌خواند، بعد کلید تازه می‌سازد، سرویس‌های BOBRES را حدود یک دقیقه نگه می‌دارد، همهٔ دادهٔ رمزشده را با کلید تازه دوباره رمز می‌کند و سرویس‌ها را به ترتیب بالا می‌آورد. اگر چیزی خراب شود، کلیدهای قدیمی خودکار برمی‌گردند و پیام «nothing was rotated» می‌آید. اگر دستور وسط کار قطع شود (قطع SSH یا برق)، فروشگاه با هر دو کلید بالا می‌آید و هیچ داده‌ای خوانده‌نشدنی نمی‌شود؛ دوباره sudo bobres rotate-key را بزنید تا کار تمام شود. کلیدهای قدیمی در .env به‌صورت توضیح (خط #) می‌مانند تا پشتیبان‌های قدیمی را بشود باز کرد؛ با --forget-old نگه داشته نمی‌شوند. کلید پشتیبان (BOBRES_BACKUP_KEY) کلید دیگری است و عوض نمی‌شود. پس از آن sudo bobres backup بزنید تا تازه‌ترین پشتیبان کلیدهای تازه را داشته باشد. جزئیات: rotate-secrets.

بازیابی

بازیابی همهٔ داده‌ها (مشتری‌ها، سفارش‌ها، دفتر، تنظیمات) را با داده‌های پشتیبان جایگزین می‌کند. هرچه پس از زمان ساخت آن پشتیبان ثبت شده باشد از بین می‌رود. برای همین، پیش از آن از داده‌های فعلی یک پشتیبان ایمنی (...-before-restore.bkp) می‌گیرد و می‌شود به آن برگشت.

sudo bobres restore /opt/bobres/backups/bobres-20261011T033000Z.bkp

دستور بالا اول فایل را کامل می‌سنجد، زمان ساخت را نشان می‌دهد و می‌پرسد. بعد سرویس‌ها را متوقف می‌کند، پشتیبان ایمنی می‌گیرد، پایگاه داده را در یک تراکنش بازیابی می‌کند (اگر خطایی شد، چیزی عوض نشده) و دوباره راه می‌اندازد.

  • پشتیبان سرور دیگر: کلید آن سرور را در فایلی بگذارید و بدهید: sudo bobres restore bobres-....bkp --key-file /root/old-backup-key.txt.
  • از S3: sudo bobres restore s3://my-shop-backups/bobres/bobres-....bkp.
  • از داشبورد: مالک در سیستم ← پشتیبان‌ها می‌تواند یکی از فهرست یا فایل بارگذاری‌شده را بازیابی کند. در پنجرهٔ تأیید باید دامنهٔ فروشگاه را تایپ کنید و بپذیرید که چه چیزی از دست می‌رود (و کد برنامهٔ احراز هویت را بدهید، اگر دارید). اگر داده‌های بازیابی‌شده سالم بالا نیایند، خودش به پشتیبان ایمنی برمی‌گردد. داشبورد فقط پشتیبانی را بازیابی می‌کند که با کلید پشتیبان همین نصب باز شود؛ برای پشتیبان سرور دیگر از خط فرمان استفاده کنید.

انتقال به سرور دیگر: روی سرور تازه با همان دامنه و همان توکن ربات نصب کنید، بعد فایل پشتیبان و کلید قدیمی را برسانید و bobres restore بزنید. لایسنس هم با پایگاه داده می‌آید.

بعد از بازیابی، پرداخت‌های بعد از زمان پشتیبان را با پنل درگاه (مثلاً زرین‌پال) مقایسه کنید و اگر لازم بود دستی اعتبار بدهید، و پنل‌های 3x-ui را برای سرویس‌های ساخته‌شده پس از آن زمان بررسی کنید. جزئیات: راهنمای restore و update و rollback.

حذف BOBRES

دستور چه می‌کند
sudo bobres uninstall کانتینرها را متوقف و حذف می‌کند. داده‌ها، گواهی‌ها و /opt/bobres می‌مانند و با sudo bobres start فروشگاه برمی‌گردد (ریبوت سرور آن را برنمی‌گرداند)
sudo bobres uninstall --purge --dry-run فقط نشان می‌دهد چه چیزهایی پاک می‌شود، بدون هیچ تغییر
sudo bobres uninstall --purge هرچه BOBRES روی سرور گذاشته (داده، رمزها، پشتیبان‌ها، کانتینرها، فایروال و خود دستور) پاک می‌کند. پشتیبان نهایی پیشنهاد می‌دهد و دامنه را کامل از شما می‌خواهد
sudo bobres uninstall --purge --backup-to /root/final.bkp همان، با پشتیبان نهایی که خوانده و سنجیده می‌شود پیش از هر حذفی
sudo bobres uninstall --verify سرور را برای ردپای باقی‌مانده می‌گردد

با --purge پایگاه داده و همهٔ پشتیبان‌های روی سرور هم می‌روند. پیش از آن پشتیبان نهایی را از سرور بیرون ببرید و کلید پشتیبان را نگه دارید. به SSH و قاعدهٔ فایروال آن دست نمی‌زند. جزئیات: راهنمای uninstall.

Clone this wiki locally