3x-ui3x-ui
شروع به کار

به‌روزرسانی و حذف

مدیریت 3x-ui با منوی x-ui و خط فرمان — به‌روزرسانی (پایدار، dev یا نسخه‌های قدیمی)، تغییر تنظیمات و حذف تمیز و کامل.

پس از نصب با اسکریپت، دستور x-ui مرکز کنترل شماست. آن را بدون هیچ آرگومانی اجرا کنید تا منوی تعاملی باز شود، یا یک زیردستور به آن بدهید تا یک عملیات تک‌مرحله‌ای انجام شود.

x-ui

منوی مدیریت x-ui

منو (آیتم‌های 028) وضعیت پنل/Xray را در بالا نشان می‌دهد و سپس:

#آیتمکاری که انجام می‌دهد
1Install(دوباره) نصب از روی اسکریپت راه دور
2Updateبه‌روزرسانی به آخرین نسخهٔ پایدار
3Update to Dev Channel (latest commit)به‌روزرسانی به بیلد غلتان dev-latest
4Update Menuبه‌روزرسانی فقط اسکریپت منوی x-ui
5Legacy Versionنصب یک نسخهٔ قدیمی مشخص (تگ را می‌پرسد)
6Uninstallحذف 3x-ui (در ادامه ببینید)
7Reset Username & Passwordتنظیم مشخصات جدید؛ اختیاراً غیرفعال‌کردن 2FA
8Reset Web Base Pathتصادفی‌کردن مسیر پایهٔ وب
9Reset Settingsبازنشانی تنظیمات پنل (حساب شما حفظ می‌شود)
10Change Portتغییر پورت پنل
11View Current Settingsنمایش نام کاربری، پورت، مسیر پایهٔ وب، مسیرهای گواهی
12–14Start / Stop / Restartکنترل سرویس پنل
15Restart Xrayبارگذاری مجدد فقط Xray-core
16Check Statusوضعیت سرویس
17Logs Managementمشاهدهٔ لاگ‌های دیباگ / پاک‌سازی لاگ‌ها
18–19Enable / Disable Autostartفعال/غیرفعال‌کردن اجرای خودکار در زمان بوت
20SSL Certificate ManagementLet's Encrypt (دامنه یا IP)، مسیرهای سفارشی، تمدید/ابطال
21Cloudflare SSL Certificateگواهی wildcard از طریق DNS-01 با Cloudflare
22IP Limit Managementمحدودیت IP به‌ازای هر کلاینت مبتنی بر Fail2ban
23Firewall Managementنصب ufw و قواعد پورت
24SSH Port Forwarding Managementاتصال پنل به localhost و تونل‌زدن روی SSH
25PostgreSQL Managementنصب/مهاجرت/مدیریت PostgreSQL
26Enable BBRفعال/غیرفعال‌کردن sysctl کنترل ازدحام BBR
27Update Geo Filesبه‌روزرسانی دادهٔ geoip/geosite (Loyalsoldier، IR، RU)
28Speedtest by Ooklaاجرای تست سرعت Ookla
0Exit

برخی از این موارد صفحهٔ مخصوص خود را دارند: گواهی‌های SSL (آیتم‌های 20–21)، امنیت (محدودیت IP، فایروال)، پروکسی معکوس و تنظیمات پنل (TLS)، و پایگاه‌داده (PostgreSQL).

زیردستورهای خط فرمان

برای اسکریپت‌ها و اقدام‌های سریع، x-ui یک زیردستور را هم مستقیماً می‌پذیرد:

دستورعملیات
x-ui start / stop / restartکنترل سرویس
x-ui restart-xrayبارگذاری مجدد فقط Xray-core
x-ui statusنمایش وضعیت
x-ui settingsنمایش تنظیمات فعلی
x-ui enable / disableفعال/غیرفعال‌کردن اجرای خودکار در زمان بوت
x-ui logدنبال‌کردن لاگ دیباگ
x-ui banlogنمایش لاگ مسدودسازی Fail2ban
x-ui updateبه‌روزرسانی به آخرین نسخهٔ پایدار
x-ui update-devبه‌روزرسانی به بیلد غلتان dev-latest
x-ui legacyنصب یک نسخهٔ قدیمی مشخص (می‌پرسد)
x-ui update-all-geofilesبه‌روزرسانی همهٔ فایل‌های geo و راه‌اندازی مجدد در صورت تغییر
x-ui migrate-db --dsn …مهاجرت SQLite ← PostgreSQL (نگاه کنید به پایگاه‌داده)
x-ui install / uninstallنصب / حذف

به‌روزرسانی

  • پایدار: گزینهٔ منوی ۲ یا x-ui update. اجرای دوبارهٔ اسکریپت نصب هم در همان محل به‌روزرسانی می‌کند.
  • کانال dev: گزینهٔ منوی ۳ یا x-ui update-dev — بیلد غلتان dev-latest به‌ازای هر کامیت (نه یک نسخهٔ پایدار).
  • یک نسخهٔ قدیمی مشخص: گزینهٔ منوی ۵ (Legacy Version).

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

کاربران Docker به شیوهٔ دیگری به‌روزرسانی می‌کنند — به‌جای استفاده از دستورهای به‌روزرسانی x-ui، ایمیج جدید را pull کرده و کانتینر را از نو بسازید (docker compose pull && docker compose up -d).

حذف

گزینهٔ منوی ۶ یا x-ui uninstall. سرویس را متوقف و غیرفعال می‌کند، یونیت سرویس را حذف می‌کند و /etc/x-ui/ و پوشهٔ نصب را پاک می‌کند. اگر پنل از یک PostgreSQL نصب‌شده به‌صورت محلی استفاده می‌کرده، پیشنهاد می‌دهد آن را هم پاک‌سازی کند (یک تأیید جداگانه و برگشت‌ناپذیر).

حذف، پایگاه‌داده (/etc/x-ui/x-ui.db) و پیکربندی شما را پاک می‌کند. اگر ممکن است بعداً به آن نیاز داشته باشید، ابتدا پشتیبان بگیرید.

On this page