Skip to content

Latest commit

 

History

History
542 lines (311 loc) · 46 KB

README_FA.md

File metadata and controls

542 lines (311 loc) · 46 KB

🇷🇺 Русский · 🇬🇧 English · 🇪🇬 العربية · 🇮🇷 فارسی · 🇨🇳 简体中文 · 🇪🇸 Español · 🇹🇷 Türkçe

3X-UI AUTO NGINX

راه‌اندازی خودکار 3X-UI / XRAY-CORE روی VPS شخصی

REALITY · XHTTP · HYSTERIA2 · NGINX · HTTPS · BACKUP / RESTORE

دو دامنه، یک VPS تازه و تنها چند دقیقه برای نصب.

Releases Downloads Ubuntu Support

📦 نسخه‌های منتشرشده · 🔗 اتصال زنجیره‌ای · 🌐 وب‌سایت‌های پوششی · ✈️ Telegram Web Proxy Manager · ❤️ حمایت · 💬 ارتباط با ما

3X-UI AUTO NGINX نصب‌کننده‌ای رایگان برای راه‌اندازی 3x-ui و Xray روی VPS شخصی شماست. این ابزار Nginx، گواهی‌های HTTPS، اتصال‌های REALITY، XHTTP و Hysteria2، اشتراک‌ها (از جمله در قالب Clash/Mihomo) و ابزارهای عیب‌یابی را پیکربندی می‌کند. مدیر تعاملی نصب سرور، تغییر دامنه‌ها، Backup/Restore v3 و اتصال زنجیره‌ای دو VPS را مدیریت می‌کند. XTLS Vision، AmneziaWG 3.1، Cloudflare WARP برای سایت‌های روسی و AdGuard Home همراه با DNS-over-HTTPS (DoH) نیز به‌صورت اختیاری در دسترس‌اند.

فراتر از نصب معمولی 3x-ui: سرورهای جدید برای پنل و REALITY وب‌سایت‌های چندصفحه‌ای اختصاصی دریافت می‌کنند. دست‌کم ۲۵۹۲ ترکیب آماده از طراحی و متن وجود دارد و در هر نصب، رنگ‌ها، آیکون‌ها و تاریخ‌ها نیز تغییر می‌کنند. سایت‌ها ناوبری فعال و صفحه‌های اضافی دارند. در دامنه REALITY، درخواست‌های معمول HTTPS روی TCP و درخواست‌های HTTP/3 بدون احراز هویت روی UDP همان وب‌سایت را نمایش می‌دهند. همه‌چیز با Nginx و Xray موجود کار می‌کند و به Docker یا وب‌سرور اضافی نیازی نیست.

✨ چرا این پروژه؟

اتصال‌های آماده
REALITY، XHTTP و Hysteria2 به‌صورت خودکار پیکربندی می‌شوند. اتصال‌های اختیاری XTLS Vision، AmneziaWG و XHTTP برای CDN نیز در صورت انتخاب هنگام نصب به‌صورت خودکار تنظیم می‌شوند.
وب‌سایت‌های پوششی کامل
دست‌کم ۲۵۹۲ ترکیب آماده از طراحی و متن. سایت‌های چندصفحه‌ای با ناوبری فعال، نوشته‌ها و تصاویر اختصاصی و پوشش HTTP/3 برای Hysteria2.
اتصال زنجیره‌ای دو VPS
دو سرور را از طریق منو به هم متصل کنید. سایت‌ها و IPهای روسی مستقیماً از سرور ورودی باز می‌شوند و بقیهٔ ترافیک از سرور خروجی می‌گذرد.
Nginx و HTTPS روی VPS خودتان
Nginx روی VPS شما اتصال‌های TCP ورودی را دریافت می‌کند. پنل و اشتراک‌ها با HTTPS روی دامنهٔ خودتان در دسترس‌اند و پورت‌های داخلی مستقیماً به اینترنت باز نمی‌شوند.
Backup / Restore v3
پشتیبان‌گیری، بازیابی و انتقال به VPS دیگر همراه با حفظ داده‌ها و سایت‌های شخصی‌سازی‌شده.
مدیر و تغییر دامنه
تغییر دامنهٔ پنل، REALITY یا هر دو بدون نصب مجدد 3X-UI و سایر سرویس‌ها.
گواهی و امنیت خودکار
تمدید خودکار گواهی‌های Let's Encrypt بدون توقف Nginx؛ محافظت SSH و به‌روزرسانی‌های امنیتی VPS اختیاری هستند.
امکانات اضافی
XTLS Vision، AmneziaWG 3.1، XHTTP برای CDN، Cloudflare WARP، AdGuard Home با DoH و راه‌اندازی اتصال زنجیره‌ای.

🚀 شروع سریع

رکوردهای DNS دو دامنه را به نشانی IP سرور VPS خود هدایت کنید: یکی برای پنل و دیگری برای REALITY. با SSH و کاربر root وارد شوید و مطمئن شوید پورت‌های TCP 80 و 443 و پورت UDP 443 از اینترنت در دسترس‌اند. سیستم‌عامل‌های پشتیبانی‌شده.

curl -fSL https://github.com/xPROMSx/3x-ui-auto-nginx/releases/latest/download/x-ui-latest.sh -o x-ui-latest.sh && bash x-ui-latest.sh

پس از اجرای اسکریپت 1 — English یا 2 — Русский را انتخاب کنید. سپس منوی اصلی باز می‌شود:

  • 1 — Installation: راه‌اندازی سرور جدید یا نصب مجدد کامل.
  • 2 — Change Domains: تغییر دامنهٔ پنل، REALITY یا هر دو بدون نصب مجدد.
  • 3 — Backups: ایجاد، نمایش و بازیابی نسخه‌های پشتیبان.
  • 4 — Telegram Web Proxy Manager: اجرای مدیر مستقل پروکسی تلگرام یا نصب آن.
  • 5 — Cascade: اتصال زنجیره‌ای دو سرور، بررسی وضعیت یا قطع اتصال.
  • 0 — Exit: خروج.

برای استفاده از منو باید از یک ترمینال تعاملی SSH استفاده کنید.

دریافت جایگزین — اگر GitHub Releases در دسترس نیست

شاخهٔ main شامل نسخهٔ آلفای پروژه است. نصب آن توصیه نمی‌شود. از انتشار پایدار با فرمان اصلی بالا استفاده کنید.

curl -fSL https://raw.githubusercontent.com/xPROMSx/3x-ui-auto-nginx/main/x-ui-latest.sh -o x-ui-latest.sh && bash x-ui-latest.sh

Caution

نصب به معنی به‌روزرسانی نیست!

اجرای دوبارهٔ اسکریپت بدون پارامتر فقط مدیر را باز می‌کند و سرور را دوباره نصب نمی‌کند. با این حال، گزینهٔ Installation برای VPS تازه یا نصب مجدد کامل است.

اگر نصب قبلی شناسایی شود، اسکریپت دربارهٔ حذف داده‌های تحت مدیریت پروژه هشدار می‌دهد و تأیید دقیق YES را می‌خواهد. در نصب مجدد، پایگاه دادهٔ 3X-UI و پیکربندی nginx جایگزین می‌شوند. ابتدا یک نسخهٔ پشتیبان را خارج از VPS نگه دارید.

Change Domains و Backups عملیات مستقلی هستند و پنل را دوباره نصب نمی‌کنند.

چطور به‌روزرسانی کنیم؟
  • 3X-UI و Xray: از ابزارهای داخلی پنل برای به‌روزرسانی استفاده کنید. ممکن است سازگاری نسخه‌های جدید با پیکربندی این پروژه هنوز تأیید نشده باشد.
  • 3X-UI AUTO NGINX: به‌روزرسانی مستقیم سیستم نصب‌شده پشتیبانی نمی‌شود. برای استفاده از امکانات جدید مدیر، مانند 5 — Cascade، اسکریپت جدید را دانلود کنید و عملیات موردنظر را انتخاب کنید. مدیر سازگاری تنظیمات موجود را بررسی می‌کند.
  • Backup / Restore: داده‌ها را ذخیره و بازیابی می‌کند، نه اینکه سیستم را به‌روزرسانی کند.

فقط برای به‌روزرسانی گزینهٔ Installation را انتخاب نکنید! nginx، هستهٔ Linux و بسته‌های سیستم را با ابزارهای سیستم‌عامل به‌روز کنید.

در ادامه تنظیماتی توضیح داده شده‌اند که پس از انتخاب Installation از منوی اصلی ارائه می‌شوند.


1. 🌐 دامنهٔ پنل 3X-UI

Enter the domain for your 3X-UI panel:

دامنه‌ای را وارد کنید که پنل مدیریت، اشتراک‌ها و سرویس‌های وب اضافی از طریق آن در دسترس خواهند بود.


2. 🛰️ دامنهٔ VLESS REALITY

Enter the domain for VLESS REALITY:

دامنهٔ دوم را برای REALITY وارد کنید. رکوردهای DNS هر دو دامنه باید به نشانی IP سرور VPS شما اشاره کنند.

ℹ️ پارامترهای اضافی اجرا

می‌توانید هر دو دامنه را از ابتدا در فرمان وارد کنید و نیازی به پاسخ تعاملی برای آن‌ها نباشد:

bash x-ui-latest.sh -subdomain panel.example.com -reality_domain reality.example.com

به‌جای panel.example.com و reality.example.com دامنه‌های خودتان را بگذارید. قابلیت‌های اختیاری همچنان هنگام نصب پرسیده می‌شوند.


3. 🔐 امنیت پیشرفتهٔ VPS

Enhance VPS security? [Y/n]:

پیشنهادشده برای کاربران کم‌تجربه · به‌صورت پیش‌فرض فعال (Y)

نصب‌کننده Fail2ban را برای حفاظت SSH، DNS رمزگذاری‌شدهٔ سیستم (DoT) و به‌روزرسانی‌های امنیتی خودکار تنظیم می‌کند. اگر شرایط مناسب باشد، مستقل از انتخاب حفاظت اضافی، فایل swap با اندازهٔ ۱ GiB نیز می‌سازد.

پیش از فعال‌کردن این گزینه توضیحات زیر را بخوانید، به‌ویژه زمان‌بندی راه‌اندازی مجدد خودکار.

🔐 توضیحات کامل تنظیمات امنیتی

با انتخاب Y تنظیمات امنیتی اضافی فعال می‌شوند. پیکربندی swap مستقل از این انتخاب انجام می‌شود:

  • Swap با اندازهٔ ۱ GiB. اگر swap فعال وجود نداشته باشد، سیستم فایل پشتیبانی شود و دست‌کم ۴ GiB فضای آزاد باشد، نصب‌کننده فایل swap را ایجاد و فعال می‌کند. تنظیمات swap موجود تغییر نمی‌کنند. اگر شرایط برقرار نباشد، این مرحله بدون توقف نصب رد می‌شود.
  • محافظت SSH — Fail2ban. تعداد تلاش‌های ناموفق و تکراری ورود را با توجه به پورت‌های واقعی SSH محدود می‌کند. تنظیمات فعلی احراز هویت SSH تغییر نمی‌کنند.
  • DNS رمزگذاری‌شده (DoT). سرورهای سراسری Cloudflare و Google از DNS-over-TLS اجباری از طریق systemd-resolved استفاده می‌کنند. مسیرهای DNS و دامنه‌های جست‌وجوی رابط‌ها و VPN حفظ می‌شوند؛ پرس‌وجوهای آن‌ها ممکن است بدون رمزگذاری باقی بمانند. اگر آماده‌سازی DoT شکست بخورد و DNS اصلی با موفقیت بازیابی شود، نصب بخش اصلی، Fail2ban و به‌روزرسانی‌های خودکار مستقل از DoT ادامه می‌یابد؛ نتیجهٔ نهایی خطا را اعلام می‌کند و کد خروج غیرصفر است.
  • به‌روزرسانی‌های امنیتی خودکار. فهرست بسته‌ها ساعت 02:30 به‌روز و به‌روزرسانی‌های امنیتی ساعت 02:50 نصب می‌شوند.
  • راه‌اندازی مجدد خودکار — 04:38. اگر پس از به‌روزرسانی نیاز به راه‌اندازی مجدد باشد، در ساعت تعیین‌شده انجام می‌شود، حتی اگر کاربران اتصال فعال داشته باشند. در نتیجه ممکن است ارتباط‌ها قطع شوند.

این ساعت‌ها براساس منطقهٔ زمانی محلی VPS هستند.

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

مهم: این گزینه ورود SSH با رمز عبور را غیرفعال نمی‌کند و جای مدیریت درست سرور را نمی‌گیرد. ابتدا ورود با کلید SSH را تنظیم و سپس احراز هویت با رمز عبور را خودتان غیرفعال کنید.


4. 🔗 VLESS XTLS Vision

Set up an additional VLESS TCP/TLS (XTLS Vision) connection? (requires a separate domain) [y/N]:

اتصال اضافی · به‌صورت پیش‌فرض غیرفعال (N)

اتصال VLESS جایگزین مبتنی بر TLS که در صورت ناپایداری یا مسدود شدن REALITY در شبکهٔ شما می‌تواند مفید باشد. این اتصال به‌صورت پروفایلی مستقل در پنل 3X-UI ساخته می‌شود.

Important

XTLS Vision به دامنهٔ سوم و مجزا نیاز دارد که با دامنه‌های پنل و REALITY متفاوت باشد. رکورد DNS آن باید به IP سرور اشاره کند. گواهی HTTPS و مسیریابی nginx خودکار تنظیم می‌شوند.

پس از انتخاب Y نصب‌کننده این دامنه را نیز می‌پرسد: Enter the domain for VLESS TLS Vision (must differ from the panel and REALITY domains):.


5. 🔑 Amnezia WG

Set up an additional AmneziaWG connection? [y/N]:

اتصال اضافی · به‌صورت پیش‌فرض غیرفعال (N)

یک اتصال مستقل AmneziaWG در پنل 3X-UI ساخته می‌شود. به دامنهٔ اضافی نیاز نیست.

ℹ️ دربارهٔ Amnezia WG

نصب‌کننده AmneziaWG 3.1 را روی UDP/8443 تنظیم می‌کند و قانون لازم UFW را خودکار اضافه می‌کند.

پس از نصب، کلاینت را در پنل 3X-UI بسازید و پیکربندی یا لینک vpn:// را برای برنامهٔ سازگار Amnezia دریافت کنید.

نصب‌کننده اتصال سمت سرور را می‌سازد، اما کلاینت‌های AmneziaWG را خودکار ایجاد نمی‌کند.

پیکربندی و قانون لازم فایروال در Backup / Restore v3 ذخیره می‌شوند.


6. 🌐 VLESS + XHTTP برای CDN

Add an additional CDN-compatible XHTTP connection? [y/N]:

اتصال اضافی · به‌صورت پیش‌فرض نصب نمی‌شود (N)

یک اتصال مستقل VLESS با انتقال XHTTP در حالت packet-up ساخته می‌شود که تنظیمات سرور آن برای استفاده از CDN آماده شده است. این اتصال در پنل 3X-UI به‌صورت غیرفعال ساخته می‌شود.

از دامنهٔ HTTPS فعلی پنل استفاده می‌شود و نیازی به دامنه یا گواهی اضافی نیست. پس از فعال‌سازی، اتصال بدون CDN نیز به‌صورت مستقیم قابل استفاده است.

برای استفاده از CDN، کاربر باید سرویس‌دهندهٔ خود را تنظیم کند و پارامترهای Host را در 3X-UI تغییر دهد. نصب‌کننده CDN را تنظیم نمی‌کند؛ فقط یک پروفایل آمادهٔ سرور برای استفاده و تنظیمات بعدی ارائه می‌دهد.


7. 🌐 سایت‌های روسی از طریق Cloudflare WARP

Route Russian websites through Cloudflare WARP to hide your VPS IP? [y/N]:

مسیریابی اختیاری · در منوی روسی به‌صورت پیش‌فرض فعال (Y) و در منوی انگلیسی غیرفعال (N)

اگر می‌خواهید از این VPS به‌عنوان سرور ورودی اتصال زنجیره‌ای استفاده کنید، N را انتخاب کنید. WARP روی سرور ورودی سازگار نیست، اما روی سرور خروجی مجاز است.

با انتخاب Y، نصب‌کننده Cloudflare WARP (MASQUE) را تنظیم می‌کند تا سایت‌های روسی و برخی سرویس‌های شبکه به‌جای IP سرور VPS شما، IP متعلق به Cloudflare را ببینند. این کار برای محافظت از IP سرور VPS ضروری است.

این تنظیم فقط بر ترافیکی اثر می‌گذارد که از VPS عبور می‌کند. اگر برنامه‌ای مستقیماً به سایتی متصل شود، WARP روی سرور تأثیری بر آن اتصال ندارد.

با فعال‌سازی این قابلیت، نصب‌کننده یک دستگاه را در Cloudflare ثبت می‌کند و شرایط استفاده از سرویس را می‌پذیرد.

اگر تنظیم WARP ناموفق باشد، نصب بدون آن ادامه می‌یابد و گزارش نهایی نتیجه را به‌صورت ناقص اعلام می‌کند. اگر تأیید بازگردانی تنظیمات ممکن نباشد، عملکرد Xray را در پنل بررسی کنید.

ℹ️ کدام سایت‌ها از WARP استفاده می‌کنند و چگونه تنظیمات را بررسی کنیم

نصب‌کننده یک اتصال خروجی با نام warp-masque و سه قانون مسیریابی به تنظیمات Xray اضافه می‌کند:

  • WARP - RU: دامنه‌های روسی در geosite:category-ru.
  • WARP - RU2: آدرس‌های IP در geoip:ru.
  • WARP - RU3: ipify.org، ifconfig.me، checkip.amazonaws.com، ipapi.is، iplocate.io، ip.sb و 2gis.com.

این قوانین به انتهای فهرست مسیریابی اضافه می‌شوند و قوانین قبلی اولویت خود را حفظ می‌کنند. این قابلیت یک پروفایل اتصال جداگانه برای کلاینت یا VPN سراسری سیستم نیست؛ مسیریابی درون Xray انجام می‌شود.

پس از نصب، در پنل 3X-UI وجود warp-masque را در Xray → Outbounds و سه قانون بالا را در Xray → Routing بررسی کنید. این تنظیمات همراه با پیکربندی 3X-UI در Backup v3 ذخیره می‌شوند.


8. 🛡️ AdGuard Home + DNS-over-HTTPS

Install and configure AdGuard Home? [y/N]:

سرور DNS اختیاری · به‌صورت پیش‌فرض غیرفعال (N)

سرور DNS شخصی برای مسدود کردن تبلیغات و ردیاب‌ها، مدیریت کلاینت‌ها و پاسخ‌گویی به درخواست‌های DNS رمزگذاری‌شده.

ℹ️ دربارهٔ AdGuard Home و کنترل دسترسی

نیازی به دامنهٔ اضافی نیست.

پس از نصب این نشانی‌ها در دسترس خواهند بود:

  • پنل مدیریت AdGuard Home: https://panel.example.com/adg-.../ — مسیر تصادفی و اختصاصی.
  • DNS-over-HTTPS: https://panel.example.com/dns-query.

پورت عمومی 53 برای TCP/UDP باز نمی‌شود. پیکربندی و داده‌های AdGuard Home در Backup / Restore v3 ذخیره می‌شوند.

⚠️ توصیهٔ امنیتی

برای VPS شخصی، بهتر است برای هر دستگاه یک ClientID جداگانه بسازید.

در AdGuard Home به تنظیمات ← تنظیمات DNS ← تنظیمات دسترسی ← کلاینت‌های مجاز بروید و فقط ClientIDها را وارد کنید، نه آدرس‌های IP یا زیرشبکه‌ها را.

از آدرس‌های DoH به این شکل استفاده کنید:

https://panel.example.com/dns-query/<ClientID>

پس از تنظیم، درخواست‌های فاقد ClientID مجاز، از جمله درخواست‌های مسیر معمول /dns-query، رد خواهند شد.

شناسه‌های طولانی و تصادفی انتخاب کنید. راهنمای رسمی امنیت AdGuard Home را ببینید.

از نسخهٔ v2.4.1، در نصب‌های جدید می‌توانید به‌روزرسانی‌های AdGuard Home را مستقیماً از رابط وب آن بررسی و نصب کنید. اگر AdGuard Home را با نسخهٔ قدیمی‌تر این نصب‌کننده راه‌اندازی کرده‌اید، با یک دستور روی VPS به‌روزرسانی را فعال کنید:

sudo bash -c 'set -euo pipefail; umask 077; d=$(mktemp -d); trap '\''rm -rf -- "$d"'\'' EXIT; cd "$d"; u=https://github.com/xPROMSx/3x-ui-auto-nginx/releases/download/v2.4.2; curl -fLsS --connect-timeout 15 --max-time 120 "$u/x-ui-latest.sh" -o x-ui-latest.sh; curl -fLsS --connect-timeout 15 --max-time 120 "$u/x-ui-latest.sh.sha256" -o x-ui-latest.sh.sha256; sha256sum --check --strict x-ui-latest.sh.sha256; bash ./x-ui-latest.sh --enable-agh-updates'

9. 👤 ساخت خودکار کلاینت و اشتراک

Create a client in 3X-UI and display a subscription link after installation? [Y/n]:

پیشنهادشده · به‌صورت پیش‌فرض فعال (Y)

نصب‌کننده یک کلاینت در 3X-UI می‌سازد و برای اتصال‌های پیکربندی‌شده و پشتیبانی‌شده، لینک اشتراک HTTPS اختصاصی تولید می‌کند.

لینک اشتراک در گزارش پایانی نصب نمایش داده می‌شود. اگر این گزینه را نپذیرید، می‌توانید کلاینت‌ها را بعداً به‌صورت دستی در پنل بسازید.


در پایان، آدرس پنل، نام کاربری و رمز عبور، نشانی ابزار تشخیص و لینک اشتراک (در صورت انتخاب ساخت کلاینت) نمایش داده می‌شوند. اگر AdGuard Home نصب شود، آدرس مدیریت، رمز عبور و نشانی DoH آن نیز نمایش داده می‌شوند. نتیجهٔ پیکربندی WARP نیز نمایش داده می‌شود.

اگر پس از به‌روزرسانی سیستم‌عامل راه‌اندازی مجدد لازم باشد، نصب‌کننده اطلاع می‌دهد. راه‌اندازی مجدد اولیه دستی است: فرمان sudo reboot را اجرا کنید.

🌐 وب‌سایت‌های پوششی و HTTP/3

وب‌سایت‌های کامل به‌جای صفحات سادهٔ موقت. نصب تازه به‌صورت خودکار برای پنل و REALITY سایت‌های چندصفحه‌ای متفاوت ایجاد می‌کند. دست‌کم ۲۵۹۲ ترکیب آماده از طراحی و متن، همراه با ناوبری فعال، تصاویر و طراحی سازگار با موبایل وجود دارد. برای XTLS Vision اختیاری نیز سایت جداگانه‌ای انتخاب می‌شود.

هر نصب ظاهر خاص خود را دارد. نام‌ها، رنگ‌بندی، تصاویر، آیکون‌ها و متن‌ها به‌صورت خودکار شخصی‌سازی می‌شوند. صفحه‌های اضافی مطالب و تاریخ انتشار متفاوت دارند. طرح انتخاب‌شده هنگام Backup/Restore و تغییر دامنه‌ها حفظ می‌شود.

Hysteria2 با پوشش HTTP/3. درخواست‌های معمول HTTPS روی TCP و درخواست‌های HTTP/3 بدون احراز هویت روی UDP در دامنه REALITY، همان وب‌سایت کامل را دریافت می‌کنند. پنل و اشتراک‌ها از پوشش عمومی HTTP/3 جدا باقی می‌مانند.

🚀 پروفایل‌های اتصال

اتصال وضعیت
VLESS + REALITY ✅ فعال به‌صورت پیش‌فرض
VLESS + XHTTP ✅ فعال به‌صورت پیش‌فرض
VLESS + XHTTP برای CDN 🔧 اختیاری، غیرفعال
Hysteria2 ✅ فعال به‌صورت پیش‌فرض
VLESS + WebSocket (TLS) ◻️ غیرفعال به‌صورت پیش‌فرض
Trojan + gRPC ◻️ غیرفعال به‌صورت پیش‌فرض
VLESS + XTLS Vision 🔧 اختیاری
Amnezia WG 🔧 اختیاری

REALITY، XHTTP و Hysteria2 پس از نصب فعال‌اند. WebSocket TLS و Trojan gRPC ایجاد می‌شوند اما تا زمانی که آن‌ها را در پنل 3X-UI فعال نکنید، غیرفعال می‌مانند.

XTLS Vision، Amnezia WG و XHTTP برای CDN فقط در صورت انتخاب هنگام نصب اضافه می‌شوند. XHTTP برای CDN به‌صورت غیرفعال ساخته می‌شود و تا زمان فعال‌سازی و اتصال یک کلاینت، در اشتراک‌ها ظاهر نمی‌شود.

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

سازگاری به برنامهٔ کلاینت و نسخهٔ آن بستگی دارد. برای XHTTP از طریق CDN، تنظیمات و محدودیت‌های سرویس‌دهندهٔ CDN نیز اهمیت دارند.

اشتراک‌ها

اشتراک‌های استاندارد، JSON و Mihomo / Clash از طریق nginx و HTTPS ارائه می‌شوند. provider=1 به‌جای پیکربندی کامل Clash، اشتراک اصلی را برای proxy providerها برمی‌گرداند.

🌐 تغییر دامنه‌ها

در منوی اصلی گزینهٔ 2 — Change Domains را انتخاب کنید. می‌توانید دامنهٔ پنل، REALITY یا هر دو را بدون نصب مجدد تغییر دهید. رکوردهای DNS جدید باید به VPS اشاره کنند و برای صدور گواهی، پورت TCP/80 در دسترس باشد. دامنه‌ها باید با یکدیگر و دامنهٔ Vision متفاوت باشند.

پیش از هر تغییر، یک Backup v3 کامل به‌صورت خودکار ساخته می‌شود. کلاینت‌ها، کلیدها، تنظیمات و آمار ترافیک حفظ می‌شوند. دامنهٔ Vision تغییر نمی‌کند. پس از تغییر ممکن است لازم باشد نشانی اشتراک‌ها و تنظیمات کلاینت را به‌روزرسانی کنید.

فقط نصب‌های شناخته‌شدهٔ پروژه، از جمله نصب‌های سازگار v2.1.7، پشتیبانی می‌شوند. در صورت بروز خطا، نسخه‌های پشتیبان و اطلاعات بازیابی را حذف نکنید. اگر ROLLBACK_UNVERIFIED نمایش داده شد، متوقف شوید و اطلاعات تشخیص خطا را نگه دارید. جزئیات، محدودیت‌ها و بازیابی.

💾 پشتیبان‌گیری و بازیابی

در منوی اصلی 3 — Backups را باز کنید تا نسخهٔ پشتیبان بسازید، فهرست آرشیوها را ببینید یا Restore را اجرا کنید. می‌توانید پس از نصب مجدد سیستم‌عامل یا برای انتقال به VPS دیگر از نسخهٔ پشتیبان استفاده کنید. برای بازیابی، سیستم‌عامل، نسخهٔ آن و معماری پردازنده باید با اطلاعات نسخهٔ پشتیبان یکسان باشند.

دستورات خط فرمان زیر نیز با دسترسی root در دسترس‌اند:

# ایجاد نسخه پشتیبان
x-ui-backup backup

# نمایش نسخه‌های پشتیبان
x-ui-backup list

# بازیابی یک نسخه پشتیبان
x-ui-backup restore /var/backups/x-ui/<archive>.tar.gz

فایل‌های پشتیبان در /var/backups/x-ui/ ذخیره می‌شوند.

نسخه‌های پشتیبان حاوی اطلاعات حساس‌اند: پایگاه داده کاربران، گذرواژه‌ها و کلیدهای خصوصی گواهی‌ها. یک نسخه را خارج از VPS نگه دارید و فقط فایل‌های پشتیبان قابل اعتماد را بازیابی کنید.

بازیابی روی VPS جدید.

🔗 اتصال زنجیره‌ای دو سرور

اتصال زنجیره‌ای دو VPS دارای پروژهٔ 3X-UI AUTO NGINX را به هم متصل می‌کند: دستگاه‌ها به سرور ورودی وصل می‌شوند و از طریق سرور خروجی به اینترنت دسترسی پیدا می‌کنند. اگر در اتصال به VPS مشکل دارید یا می‌خواهید از طریق سروری در کشور دیگری به اینترنت وصل شوید، این قابلیت ممکن است مفید باشد.

دستگاه → VPS ورودی → VPS خروجی → اینترنت

سایت‌ها و آدرس‌های IP روسی مستقیماً از سرور ورودی باز می‌شوند. پس از راه‌اندازی می‌توانید این رفتار را در قوانین مسیریابی VPS ورودی غیرفعال کنید. سایر ترافیک‌هایی که قوانین قبلی شاملشان نمی‌شوند، از سرور خروجی عبور می‌کنند.

برای راه‌اندازی، گزینهٔ 5 — Cascade را در منوی اصلی باز کنید. نیازی به ویرایش دستی فایل‌های تنظیمات نیست.

راه‌اندازی، بررسی وضعیت و قطع اتصال زنجیره‌ای

پیش‌نیازها

  • دو VPS با نصب فعال 3X-UI AUTO NGINX.
  • نام کاربری و رمز عبور پنل 3X-UI هر سرور.
  • آخرین اسکریپت نصب با گزینهٔ 5 — Cascade.
  • نباید WARP روی سرور ورودی تنظیم شده باشد (می‌توانید آن را دستی حذف کنید).

1. ساخت کلید روی سرور خروجی

اسکریپت نصب جدید را روی VPS موردنظر برای دسترسی به اینترنت اجرا کنید.

گزینهٔ 5 — Cascade → 1 — Create key (exit server) را انتخاب کنید.

نام کاربری و رمز عبور پنل 3X-UI را وارد کنید. ورودی پنهان است و این اطلاعات ذخیره نمی‌شوند. مدیر یک کلاینت به نام cascade به اتصال REALITY فعلی اضافه می‌کند و پیوند کلیدی با ابتدای vless:// نمایش می‌دهد.

پیوند را کپی کنید؛ در سرور دوم به آن نیاز خواهید داشت.

پیوند کلید را عمومی نکنید: هر کسی که آن را داشته باشد می‌تواند از این کلاینت استفاده کند.

کلاینت‌های موجود تغییر نمی‌کنند.

2. اتصال سرور ورودی

اسکریپت نصب جدید را روی VPSی که دستگاه‌هایتان به آن وصل می‌شوند اجرا کنید.

گزینهٔ 5 — Cascade → 2 — Connect exit server (entry server) را انتخاب کنید.

نام کاربری و رمز عبور پنل 3X-UI را وارد کنید (آن‌ها ذخیره نمی‌شوند)، سپس پیوند کلید مرحلهٔ اول را جای‌گذاری کنید. پیوند هنگام جای‌گذاری در ترمینال دیده می‌شود، اما ذخیره نمی‌شود.

مدیر ابتدا اتصال به سرور خروجی را آزمایش می‌کند. در صورت موفقیت، اتصال خروجی cascade-exit و سه قانون مسیریابی CASCADE را اضافه می‌کند.

سایت‌ها و IPهای روسی مستقیماً از سرور ورودی باز می‌شوند، مگر اینکه بعداً قوانین مربوط را غیرفعال کنید. سایر ترافیک مناسب از سرور خروجی عبور می‌کند.

اعمال تنظیمات ممکن است اتصال همهٔ کاربران را برای چند ثانیه قطع کند. اگر بررسی ناموفق باشد، مدیر تلاش می‌کند تنظیمات قبلی را برگرداند و نتیجه را نشان می‌دهد.

اتصال‌ها و اشتراک‌های فعلی همچنان استفاده می‌شوند؛ نیازی به ساخت پروفایل جداگانه برای اتصال زنجیره‌ای نیست.

3. بررسی وضعیت

روی هر VPS گزینهٔ 5 — Cascade → 3 — Status را باز کنید.

مدیر مانند سایر عملیات، نام کاربری و رمز عبور پنل را می‌خواهد.

وضعیت نقش‌های ورودی و خروجی روی آن سرور و وضعیت Xray را نشان می‌دهد. این بررسی تنظیمات را تغییر نمی‌دهد.

4. قطع اتصال زنجیره‌ای

روی VPS موردنظر گزینهٔ 5 — Cascade → 4 — Disable را باز کنید.

روی سرور ورودی مدیر حذف اتصال cascade-exit و سه قانون CASCADE را پیشنهاد می‌دهد. سایر اتصال‌ها و قوانین پنل باقی می‌مانند.

روی سرور خروجی فقط کلاینت cascade حذف می‌شود. سرورهای ورودی که از کلید آن استفاده می‌کنند دیگر نمی‌توانند از این خروجی استفاده کنند.

حذف هر نقش تأیید جداگانه می‌خواهد. اعمال تغییرات روی سرور ورودی ممکن است اتصال کاربران را کوتاه‌مدت قطع کند.

محدودیت‌ها

  • WARP: روی سرور ورودی سازگار نیست. پیش از اتصال، خروجی و قوانین آن را از پنل 3X-UI حذف کنید. روی سرور خروجی مجاز است.
  • AmneziaWG: اتصال‌های آن از سرور خروجی عبور نمی‌کنند.
  • قوانین مسیریابی: قوانین قبلی ممکن است بخشی از ترافیک را از مسیر دیگری بفرستند؛ مدیر پیش از اتصال هشدار می‌دهد.
  • قطع دسترسی به خروجی: ترافیک هدایت‌شده به خروجی تا بازگشت اتصال کار نخواهد کرد. خروجی پشتیبان خودکار وجود ندارد.
  • QUIC از طریق Vision: ترافیک UDP/443 از این اتصال عبور نمی‌کند.
  • تغییر دامنه: پس از تغییر دامنه‌های سرور خروجی، باید آن را دوباره از سرور ورودی متصل کنید.

نسخه‌های پشتیبان

Backup v3 تنظیمات اتصال زنجیره‌ای را ذخیره می‌کند. پس از بازیابی روی سرور ورودی، این تنظیمات همراه با داده‌های 3X-UI باقی می‌مانند.

این قابلیت روی دو VPS واقعی با REALITY، XHTTP و Hysteria2 آزمایش شده است. سازگاری آن با همهٔ برنامه‌های کلاینت و تنظیمات هنوز تأیید نشده است.

اگر مشکلی پیدا کردید، در GitHub گزارش دهید.

🔐 امنیت

رابط‌های سرویس‌ها مستقیماً در اینترنت منتشر نمی‌شوند. پنل، اشتراک‌ها و سرویس‌های جانبی از طریق nginx و HTTPS در دسترس‌اند و پورت‌های داخلی فقط روی میزبان محلی گوش می‌دهند.

مطمئن نیستید چطور از VPS خود محافظت کنید؟ هنگام نصب می‌توانید تنظیمات امنیتی پیشرفته را فعال کنید تا محافظت SSH در برابر تلاش‌های ورود، DNS رمزگذاری‌شده و به‌روزرسانی‌های امنیتی خودکار تنظیم شوند. پیش از فعال‌سازی، توضیحات و برنامهٔ راه‌اندازی مجدد شبانه را در بخش شروع سریع بخوانید.

مهم: دسترسی به خود سرور را نیز ایمن کنید. از کلیدهای SSH استفاده کنید و پس از اطمینان از امکان ورود با کلید، ورود با رمز عبور را غیرفعال کنید. نصب‌کننده این کار را خودکار انجام نمی‌دهد.

✈️ Telegram Web Proxy Manager

Telegram Web Proxy Manager پروژه‌ای مستقل برای راه‌اندازی Telegram WEB Proxy شخصی با HTTPS، وب‌سایت پوششی و به‌روزرسانی همراه با امکان بازگشت به نسخهٔ قبلی است.

TWPM بخشی از نصب پیش‌فرض 3X-UI نیست. گزینهٔ 4 منوی اصلی اجازه می‌دهد آن را اجرا کنید یا پس از تأیید، نصب مستقل آن را آغاز کنید. مدیریت دو پروژه مستقل است.

⚙️ جزئیات فنی و سازگاری

  • سیستم‌عامل‌ها: Ubuntu 24.04، Ubuntu 26.04 و Debian 13.
  • UFW: پورت‌های 80/tcp، 443/tcp و 443/udp را مجاز می‌کند (با انتخاب AmneziaWG، پورت 8443/udp نیز افزوده می‌شود). هنگام Installation، UFW تنها پس از بررسی دسترسی SSH فعال می‌شود؛ در غیر این صورت با هشدار غیرفعال می‌ماند. پس از Restore از طریق منو، UFW فقط با انتخاب صریح شما و گذراندن بررسی‌های ایمنی قابل فعال‌سازی است. دستور x-ui-backup restore، UFW را فعال نمی‌کند.
  • گواهی‌ها: گواهی‌های Let's Encrypt با روش webroot و تایمر استاندارد certbot.timer بدون توقف nginx تمدید می‌شوند.
  • نسخه 3x-ui: به‌صورت پیش‌فرض جدیدترین نسخه‌ای نصب می‌شود که سازگاری آن با 3X-UI AUTO NGINX به‌دقت آزمایش شده است؛ این نسخه لزوماً آخرین انتشار رسمی 3x-ui نیست. پس از نصب می‌توانید 3x-ui را با روش به‌روزرسانی داخلی خودش ارتقا دهید، اما ممکن است سازگاری نسخه جدید با پیکربندی فعلی هنوز تأیید نشده باشد. همچنین می‌توانید با -version <tag> نسخه پایدار دیگری را انتخاب کنید (حداقل نسخه پشتیبانی‌شده v3.8.0 است)؛ نصب‌کننده درباره تأیید نشدن سازگاری هشدار می‌دهد.

بازیابی روی VPS جدید

سیستم‌عامل، نسخه آن و معماری پردازنده باید با نسخه پشتیبان مطابقت داشته باشند. اگر آدرس IP سرور VPS تغییر کرد، رکوردهای DNS دامنه‌ها را به‌روزرسانی کنید. اسکریپت x-ui-latest.sh را اجرا نکنید؛ فقط ابزار بازیابی را نصب کرده و یک آرشیو معتبر را بازیابی کنید:

curl -fSL https://raw.githubusercontent.com/xPROMSx/3x-ui-auto-nginx/main/assets/backup/x-ui-backup.sh -o /tmp/x-ui-backup
install -o root -g root -m 0755 /tmp/x-ui-backup /usr/local/bin/x-ui-backup
rm -f /tmp/x-ui-backup
x-ui-backup restore /root/<archive>.tar.gz

SSH، تنظیمات سیستم‌عامل و فایروال پایه همچنان بر عهده مدیر سرور است. برای آرشیوهای v2 باید از ابزار نسخه قدیمی متناظر استفاده شود.

🤝 خاستگاه پروژه و قدردانی

این پروژه بر پایهٔ 3x-ui-pro ساختهٔ mozaroc توسعه یافته است. آن پروژه از فورک x-ui-pro شکل گرفت و ریشه‌اش به نسخهٔ اصلی x-ui-pro از GFW4Fun می‌رسد. این پروژه اکنون به‌صورت مستقل توسعه داده می‌شود. پس از فورک، مسیریابی nginx/SNI و پیکربندی XHTTP به‌طور گسترده بازطراحی شده‌اند، فرایند صدور و تمدید خودکار گواهی‌های TLS اصلاح شده و Backup / Restore v3 با قابلیت بازیابی و بازگشت به وضعیت پیشین ارائه شده است. Hysteria2 روی UDP/443 اضافه شده و مشکلات امنیتی شناسایی‌شده برطرف شده‌اند.

پنل اصلی از MHSanaei/3x-ui ارائه می‌شود. حقوق نویسندگان اجزای شخص ثالث و مجوزهای موجود آن‌ها محفوظ است.

توسعه‌ها و تغییرات اصیل نویسندگان xPROMSx تحت GNU GPL-3.0-only ارائه می‌شوند. Copyright (C) 2026 xPROMSx contributors. این مجوز فقط حقوقی را شامل می‌شود که مشارکت‌کنندگان بر این بخش‌ها دارند؛ کد به‌ارث‌رسیده را مجدداً مجوزدهی نمی‌کند و به معنای تحت GPL بودن کل مخزن نیست. دامنهٔ مجوز و اطلاعیه‌های اجزای شخص ثالث در THIRD_PARTY_NOTICES.md توضیح داده شده است.

اگر می‌خواهید از کد ما استفاده کنید. برای نصب و استفاده از این پروژه نیازی به انجام کاری ندارید؛ مثل قبل رایگان است. اگر نسخهٔ خودتان را منتشر می‌کنید یا کد ما را در پروژهٔ دیگری به کار می‌برید، عبارت © xPROMSx · github.com/xPROMSx/3x-ui-auto-nginx را در فایل README نگه دارید و اگر نصاب تعاملی دارید، آن را در صفحهٔ آغازین یا منوی اصلی نصاب هم نشان دهید. روشن بگویید که نسخه را تغییر داده‌اید و کار ما را به نام خودتان معرفی نکنید. متن کامل شرایط: docs/NOTICE.md.

🖥️ پرچم کشورها در Windows 11

اگر هنگام باز کردن پنل 3x-ui در Chrome، Edge یا Brave روی Windows 11 به‌جای پرچم کشورها کدهای دوحرفی (FI، DE، US) می‌بینید، می‌توانید از پروژه کوچک ما Flag Emojis Windows Installer استفاده کنید. این ابزار نمایش پرچم‌ها را درست می‌کند، فونت اصلی Windows را حفظ می‌کند و امکان بازگرداندن تغییرات را دارد.

❤️ حمایت از توسعه

اگر این پروژه برایتان مفید است، می‌توانید داوطلبانه از ادامهٔ توسعهٔ آن حمایت کنید. پروژه و همهٔ قابلیت‌هایش، مستقل از کمک‌های مالی، رایگان و متن‌باز می‌مانند.

دو دامنه، چند دقیقه و سرور 3x-ui / Xray شخصی شما.

⭐ اگر این نصب‌کننده برایتان مفید بود، با دادن Star در GitHub از پروژه حمایت کنید تا دیگران راحت‌تر آن را پیدا کنند.

نصب · نسخه‌های منتشرشده · گزارش مشکل