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

نصب

نصب 3x-ui با اسکریپت رسمی (نسخهٔ پایدار، نسخهٔ مشخص یا dev-latest)، نصب خودکار/cloud-init یا Docker — و انتخاب میان SQLite و PostgreSQL.

‏3x-ui روی طیف گسترده‌ای از توزیع‌های Linux اجرا می‌شود — Ubuntu، Debian، Armbian، Fedora، CentOS، RHEL، AlmaLinux، Rocky Linux، Oracle Linux، Amazon Linux، Virtuozzo، Arch، Manjaro، openSUSE (Tumbleweed/Leap)، Alpine — و همچنین Windows، روی معماری‌های amd64، 386، arm64، armv7، armv6، armv5 و s390x.

نصب‌کنندهٔ اسکریپتی را به‌صورت root (یا با sudo) اجرا کنید. این اسکریپت یک سرویس نصب می‌کند، دستور مدیریتی x-ui را راه‌اندازی می‌کند و پنل را در زمان بوت فعال می‌سازد.

اسکریپت رسمی مسیر توصیه‌شده است. این اسکریپت در طول نصب یک نام کاربری، رمز عبور و مسیر دسترسی (مسیر پایهٔ وب) تصادفی تولید می‌کند، سرویس را راه‌اندازی می‌کند و دستور مدیریتی x-ui را نصب می‌کند.

latest stable
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

برای نصب یک نسخهٔ مشخص، تگ آن را در انتها اضافه کنید:

pinned version
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) v3.4.0

برای نصب نسخهٔ dev غلتان (آخرین پیش‌انتشار به‌ازای هر کامیت از شاخهٔ main — نه یک نسخهٔ پایدار) عبارت dev-latest را پاس دهید:

rolling dev build
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) dev-latest

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

دستور نصب خود را بسازید

دستور را متناسب با تنظیمات خود سفارشی کنید:

Install command builder

Build the exact install command for your setup. It is assembled in your browser.

blank = latest stable · a tag like v3.4.0 · or dev-latest for the rolling dev build
Run on your server
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

انتخاب یک پایگاه‌داده

شما بک‌اند ذخیره‌سازی را در زمان نصب انتخاب می‌کنید:

  • SQLite (پیش‌فرض) — یک فایل واحد در مسیر /etc/x-ui/x-ui.db. بدون نیاز به هیچ تنظیماتی.
  • PostgreSQL — برای تعداد کلاینت بالا یا پیکربندی‌های چندنودی. نصب‌کننده می‌تواند آن را به‌صورت محلی نصب کند یا از یک DSN که شما ارائه می‌دهید استفاده کند.

برای جزئیات و مهاجرت SQLite→PostgreSQL به پایگاه‌داده مراجعه کنید.

نصب خودکار / cloud-init

نصب‌کننده برای خودکارسازی به‌صورت غیرتعاملی نیز اجرا می‌شود. XUI_NONINTERACTIVE=1 را تنظیم کنید (یا بدون TTY اجرا کنید) تا نصب به‌صورت سرتاسری و بدون هیچ پرسشی انجام شود، مشخصات تصادفی تولید کند و آن‌ها را در /etc/x-ui/install-result.env بنویسد:

XUI_NONINTERACTIVE=1 bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

دایرکتوری deploy/ در مخزن یک user-data آمادهٔ cloud-init برای نصب‌های خودکار روی هر ابری (Hetzner، AWS، DigitalOcean، Vultr، GCP، Azure، Oracle) دارد.

گام‌های بعدی

On this page