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

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

```bash
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](/docs/config/ssl-certificates)
(آیتم‌های 20–21)، [امنیت](/docs/operations/security) (محدودیت IP، فایروال)،
[پروکسی معکوس](/docs/operations/reverse-proxy) و [تنظیمات پنل](/docs/config/panel)
(TLS)، و [پایگاه‌داده](/docs/reference/database) (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 (نگاه کنید به [پایگاه‌داده](/docs/reference/database)) |
| `x-ui install` / `uninstall` | نصب / حذف                                          |

## به‌روزرسانی

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

به‌روزرسانی، پایگاه‌داده و تنظیمات شما را حفظ می‌کند. پیش از یک جهش نسخهٔ اصلی، یک
[پشتیبان](/docs/operations/backup-restore) بگیرید.

<Callout type="info">
  کاربران Docker به شیوهٔ دیگری به‌روزرسانی می‌کنند — به‌جای استفاده از دستورهای
  به‌روزرسانی `x-ui`، ایمیج جدید را pull کرده و کانتینر را از نو بسازید
  (`docker compose pull && docker compose up -d`).
</Callout>

## حذف

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

<Callout type="warn">
  حذف، پایگاه‌داده (`/etc/x-ui/x-ui.db`) و پیکربندی شما را پاک می‌کند. اگر ممکن است
  بعداً به آن نیاز داشته باشید، ابتدا [پشتیبان بگیرید](/docs/operations/backup-restore).
</Callout>
