به‌روزرسانی

به‌روزرسانی معمول

به‌طور پیش‌فرض همه مؤلفه‌ها با تگ latest گرفته می‌شوند، بنابراین به‌روزرسانی دو دستور است:

docker compose pull
docker compose up -d

اگر لازم است نسخه مشخصی ثابت شود، آن را در .env تعیین کنید — یک متغیر برای همه مؤلفه‌ها:

# .env
XLADA_VERSION=1.1.7

مهاجرت‌های پایگاه داده هنگام راه‌اندازی کانتینر پنل به‌طور خودکار اعمال می‌شوند.

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

از پایگاه داده dump بگیرید — این تنها راه مطمئن برای عقب‌گرد است:

docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

.env را هم نگه دارید: مقادیر APP_SECRET، POSTGRES_PASSWORD و دامنه‌ها باید بدون تغییر از به‌روزرسانی جان سالم به در ببرند.

کارهایی که نباید انجام داد

• docker compose down -v — فلگ -v والیوم‌ها را همراه با پایگاه داده حذف می‌کند.
• تغییر APP_SECRET پس از نخستین راه‌اندازی — ورود و TOTP از کار می‌افتند.
• تغییر نام والیوم‌ها و سرویس‌ها — هنگام به‌روزرسانی compose والیوم‌های خالی جدیدی می‌سازد و داده‌ها در والیوم‌های قدیمی باقی می‌مانند.

عقب‌گرد

docker compose down
# مقدار قبلی XLADA_VERSION را در .env بازگردانید
docker compose up -d
docker exec -i xpanel-db psql -U xpanel -d xpanel < backup-2026-01-01.sql

هشدار

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

مشاهده نسخه فعلی

نسخه در پاورقی پنل و در پاسخ API دیده می‌شود:

curl -s https://panel.example.com/api/system/health | head