Troubleshooting

عیب‌یابی، بک‌آپ و رول‌بک (Troubleshooting & Rollback)

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

---

🔍 بررسی لاگ‌ها و وضعیت سرویس‌ها

۱. بررسی لاگ‌های سرور ایران:

sudo journalctl -u rathole-server -n 50 --no-pager
sudo nginx -t

۲. بررسی لاگ‌های نود خارج:

sudo journalctl -u rathole-client -n 50 --no-pager
sudo ratholenode status

---

📦 سیستم بک‌آپ و رول‌بک خودکار (Automatic Rollback)

هر زمان که دستور آپدیت (install.sh --update یا ratholectl update) اجرا می‌شود:

1. یک اسنپ‌شات کامل از فایلهای اجرایی CLI، کانفیگ‌ها و سرویس‌های systemd در مسیر /var/backups/rathole-manager/pre-update-<timestamp>/ ذخیره می‌شود.
2. آپدیت اعمال شده و هلت‌چک سرویس‌ها بررسی می‌شود.
3. در صورت شکست هلت‌چک یا عدم تایید nginx -t، کدهای قبلی به‌صورت خودکار رول‌بک می‌شوند.

مدیریت دستی بک‌آپ‌ها:

# مشاهده لیست بک‌آپ‌های موجود
sudo update.sh --list-backups

# بازگردانی (Rollback) به آخرین اسنپ‌شات سالم
sudo update.sh --rollback

# بازگردانی به یک اسنپ‌شات مشخص
sudo update.sh --rollback 20260725-094447