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

3x-ui