Repository navigation
FA Update Backup Restore
فهرست راهنما · عیبیابی · نصب
همهٔ دستورهای این صفحه را روی سرور و با 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.
| دستور | چه میکند |
|---|---|
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.
BOBRES, made by TECSO-DEV. Source-available, all rights reserved (see LICENSE). Site: bobresai.cv.
Start
Run the store
- Dashboard Guide
- Bot Guide
- Mini App
- Plans and Pricing
- Payments
- Panels
- Resellers
- Digital Accounts
- Subscription Page
- Terms and Privacy Pages
- Reports
Operate
Develop
فارسی