CLI اضطراری

CLI اضطراری یک ابزار داخلی برای زمانی است که رابط وب پنل در دسترس نیست یا کارهای معمول از آن کمک نمی‌کند. این ابزار مستقیماً در کانتینر کار می‌کند، به پایگاه داده و Valkey وصل می‌شود و به مرورگر، ورود و API وابسته نیست.

CLI زمانی لازم است که رمز عبور مدیر را فراموش کرده‌اید، ورود با رمز عبور را اشتباهاً غیرفعال کرده‌اید، می‌خواهید دیسک را از رکوردهای قدیمی آزاد کنید یا SECRET_KEY نود را گم کرده‌اید.

اجرا

docker exec -it xpanel cli

منوی XLADA Rescue CLI v0.4 پدید می‌آید. پیش از نمایش منو، ابزار اتصال به پایگاه داده و Valkey را بررسی می‌کند: اگر یکی از آن‌ها در دسترس نباشد، خطا را گزارش می‌کند و پایان می‌یابد. یعنی باید خود کانتینر را درست کرد، نه داده‌ها را.

هشدار

همه دستورها با دور زدن API و ژورنال اقدامات مدیران اجرا می‌شوند. آن‌ها مستقیم در پایگاه داده می‌نویسند و بخشی از آن‌ها داده‌ها را بدون امکان بازگردانی حذف می‌کنند. پیش از عملیات خطرناک از پایگاه داده dump بگیرید.

چه کارهایی می‌تواند بکند

دستور	چه می‌کند
Reset superadmin	سوپرادمین را از پایگاه داده حذف می‌کند
Enable password authentication	ورود با رمز عبور را فعال می‌کند
Generate keypairs	کلیدهایی برای رمزنگاری قواعد پاسخ می‌سازد
Clean up HWID Devices	جدول hwid_user_devices را پاک می‌کند
Clean up SRH Table	تاریخ درخواست‌های اشتراک را پاک می‌کند
Clean up Users Usage Table	تاریخ ترافیک کاربران را پاک می‌کند
Delete Users Usage by date range	تاریخ ترافیک را برای یک بازه حذف می‌کند
Reset certs	گواهی‌های داخلی پنل را حذف می‌کند
Get SECRET_KEY for a XLADA Node	SECRET_KEY نود را نمایش می‌دهد
Exit	از ابزار خارج می‌شود

بازنشانی مدیر

Reset superadmin نخستین حساب مدیر را کاملاً حذف می‌کند. پس از آن پنل را در مرورگر باز کنید — دوباره پیشنهاد ساخت مدیر از صفر را می‌دهد. ابزار تأیید می‌خواهد و تنظیمات کش‌شده را بازنشانی می‌کند تا پنل داده‌های قدیمی را به یاد نداشته باشد.

ورود با رمز عبور

Enable password authentication زمانی به کار می‌آید که ورود با رمز عبور را در تنظیمات غیرفعال کرده و بدون دسترسی مانده‌اید. این دستور کلید را به حالت «فعال» برمی‌گرداند و پس از آن می‌توان با رمز عبور معمولی وارد شد.

کلیدها برای قواعد پاسخ

Generate keypairs یک جفت کلید برای رمزنگاری پاسخ‌های قواعد مسیریابی می‌سازد. می‌توان age1 (X25519) یا age1pq1 را انتخاب کرد — طرحی ترکیبی که در برابر محاسبات کوانتومی مقاوم است. کلید عمومی در قاعده درج می‌شود، کلید خصوصی نزد کلاینت نگه‌داری می‌شود و به سرور فرستاده نمی‌شود.

پاک‌سازی داده‌ها

سه دستور پاک‌سازی داده‌ها را کاملاً حذف می‌کنند، هرکدام با تأیید خودش:

• Clean up HWID Devices — همه دستگاه‌های کاربران؛
• Clean up SRH Table — تاریخ درخواست‌های اشتراک؛
• Clean up Users Usage Table — تاریخ ترافیک و ایندکس‌ها را از نو می‌سازد.

Delete Users Usage by date range تاریخ ترافیک را فقط برای بازه موردنظر حذف می‌کند. تاریخ‌ها دقیقاً در قالب DD-MM-YYYY وارد می‌شوند، برای مثال 01-01-2026. می‌توان درخواست تک (سریع‌تر، اما قفل را بیشتر نگه می‌دارد) یا حالت گروهی با نشانگر پیشرفت را انتخاب کرد. در پایان VACUUM اجرا می‌شود، بنابراین نمی‌توان پنجره را بست — وقفه جدول را باد کرده باقی می‌گذارد.

# پیش از پاک‌سازی، از پایگاه داده dump بگیرید
docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

گواهی‌ها و نودها

Reset certs گواهی‌های داخلی را حذف می‌کند. پس از آن SECRET_KEY روی همه نودها از کار می‌افتد و باید آن‌ها را از نو وصل کرد. پس از دستور، پنل را راه‌اندازی مجدد کنید:

docker compose down && docker compose up -d

Get SECRET_KEY for a XLADA Node برای اتصال نود جدید SECRET_KEY را نمایش می‌دهد — زمانی به کار می‌آید که گرفتن آن در پنل ممکن نباشد.

خطر

Reset certs ارتباط با همه نودها را یک‌جا می‌شکند. اگر آماده نیستید کلیدها را از نو برای هر سرور صادر کنید، آن را اجرا نکنید.

CLI نود

نود CLI خودش را با مجموعه دستورهای جداگانه دارد:

docker exec -it xpanel-node cli

می‌تواند پیکربندی کنونی Xray را بیرون بکشد، اتصال‌ها را بر اساس IP قطع کند و لاگ‌های Xray را پاک کند. دستورها بدون منو هم در دسترس‌اند:

docker exec -it xpanel-node cli --dump-config       # پیکربندی با رنگ‌آمیزی
docker exec -it xpanel-node cli --dump-config-raw   # خروجی ماشین‌خوان
docker exec -it xpanel-node cli --kill-sockets      # قطع اتصال‌ها بر اساس IP
docker exec -it xpanel-node cli --clear-logs        # پاک کردن لاگ‌های Xray
docker exec -it xpanel-node cli --help              # راهنما

پاک‌سازی لاگ‌ها فایل‌ها را rotate می‌کند، Xray در این هنگام راه‌اندازی مجدد نمی‌شود و ترافیک قطع نمی‌شود.

نکته

خروجی --dump-config-raw را راحت می‌توان برای مقایسه نسخه‌های پیکربندی به فایل هدایت کرد:

docker exec -i xpanel-node cli --dump-config-raw > xray-config.json

گام‌های بعدی

• خطاهای رایج — بررسی خرابی‌های معمول پنل.
• دستورهای مفید — کار روزمره با کانتینرها.
• به‌روزرسانی — چگونه پنل و نودها را به‌روز کنیم.
• امنیت پنل — محافظت از دسترسی.