نصب
نصب 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 را نصب میکند.
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)برای نصب یک نسخهٔ مشخص، تگ آن را در انتها اضافه کنید:
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) v3.4.0برای نصب نسخهٔ dev غلتان (آخرین پیشانتشار بهازای هر کامیت از شاخهٔ main
— نه یک نسخهٔ پایدار) عبارت dev-latest را پاس دهید:
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.
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) دارد.
گامهای بعدی
آشنایی با 3x-ui
یک پنل تحت وب برای Xray-core — ورودیها، پروتکلها، کلاینتها و اشتراکها را بهجای ویرایش دستی JSON، از مرورگر خود مدیریت کنید.
نخستین ورود
مشخصات ورود تولیدشدهٔ 3x-ui را بیابید، به پنل دسترسی پیدا کنید، احراز هویت دومرحلهای را فعال کنید و پیش از در معرض قرار دادن هر چیزی، پنل را ایمنسازی کنید.

3x-ui