📡 راهنمای کامل اتصال به سرور X-UI

همه چیزی که برای اتصال موفق نیاز دارید

📋 اطلاعات مورد نیاز برای اتصال

🔑 اطلاعات ضروری

1️⃣ نام سرور
مثال: سرور آلمان یا Main Server
2️⃣ آی پی سرور (Server IP)
مثال: 82.115.26.209
3️⃣ پورت پنل (Panel Port)
معمولاً: 2083 یا 54321 یا 2053
4️⃣ مسیر پنل (Panel Path)
معمولاً: / (یک اسلش)
5️⃣ نام کاربری (Username)
مثال: admin یا root
6️⃣ رمز عبور (Password)
رمزی که هنگام نصب تنظیم کردید
7️⃣ پروتکل (Protocol)
http یا https (معمولاً https)
8️⃣ Inbound ID (اختیاری)
معمولاً: 1 یا از پنل دریافت می‌شود

🔍 چطور این اطلاعات رو پیدا کنیم؟

1آی پی سرور (Server IP)

روش 1: از پنل هاست VPS

  • وارد پنل VPS خودتون بشید (مثلاً Hetzner, Contabo, DigitalOcean)
  • سرور خودتون رو پیدا کنید
  • آی پی عمومی (Public IP) رو کپی کنید

روش 2: از داخل سرور (SSH)

# اگه به سرور SSH داری، این دستور رو بزن: curl ifconfig.me # یا این: hostname -I

✅ مثال صحیح

82.115.26.209

185.123.45.67

2پورت پنل (Panel Port)

پنل X-UI معمولاً روی یکی از این پورت‌ها نصب میشه:

پورت احتمال توضیحات
54321 ⭐⭐⭐⭐⭐ پورت پیش‌فرض X-UI
2083 ⭐⭐⭐⭐ پورت رایج برای پنل‌های وب
2053 ⭐⭐⭐ پورت جایگزین
80 یا 443 ⭐⭐ اگه Nginx یا آپاچی تنظیم شده

⚠️ چطوری پورت رو پیدا کنم؟

از SSH به سرور وصل شو و این دستور رو بزن:

# چک کردن پورت X-UI netstat -tulpn | grep x-ui # یا اینکه فایل کانفیگ رو بخون: cat /usr/local/x-ui/bin/config.json | grep port

3نام کاربری و رمز عبور

مورد 1: اگه یادت نیست

# از SSH به سرور وصل شو و این دستور رو بزن: x-ui # بعد از اجرا، منویی باز میشه: # گزینه 6 رو انتخاب کن: "Reset username and password" # نام کاربری و رمز جدید تنظیم کن

مورد 2: نام کاربری پیش‌فرض

نام کاربری‌های رایج:

  • admin
  • root
  • sanaei (برای Sanaei X-UI)

4پروتکل (http یا https)

چک کردن SSL:

# اگه SSL داری: https://YOUR_IP:PORT # اگه SSL نداری: http://YOUR_IP:PORT

⚠️ چطوری بفهمم کدومو انتخاب کنم؟

تو مرورگر امتحان کن:

  • اول این رو تست کن: https://IP:PORT
  • اگه خطا داد این رو تست کن: http://IP:PORT
  • هر کدوم باز شد، همونو انتخاب کن

5مسیر پنل (Panel Path)

معمولاً / هست، ولی ممکنه تغییر کرده باشی:

مسیر مثال URL کامل
/ https://82.115.26.209:2083/
/panel https://82.115.26.209:2083/panel
/xui https://82.115.26.209:2083/xui

✅ نکته

اگه تو مرورگر URL پنلت اینجوریه:

https://82.115.26.209:2083/admin/login

پس مسیر پنل: /admin

6Inbound ID

این رو بعداً از خود پنل می‌گیریم. فعلاً خالی بذار یا عدد 1 بزار.

📝 چطوری Inbound ID رو پیدا کنیم؟

  1. وارد پنل X-UI بشو
  2. منوی "Inbounds" رو باز کن
  3. ستون "ID" رو ببین
  4. اولین Inbound که پروتکلش VLESS هست رو پیدا کن
  5. ID اون رو یادداشت کن (معمولاً 1 یا 2 یا 3)

✨ مثال کامل و واقعی

🎯 سناریو 1: سرور با SSL

فیلد مقدار
نام سرور سرور آلمان
آی پی سرور 82.115.26.209
پورت پنل 2083
مسیر پنل /
نام کاربری admin
رمز عبور MySecurePass123
پروتکل https
Inbound ID 1 (یا خالی بذار)
URL کامل پنل: https://82.115.26.209:2083/

🎯 سناریو 2: سرور بدون SSL

فیلد مقدار
نام سرور Main Server
آی پی سرور 185.123.45.67
پورت پنل 54321
مسیر پنل /
نام کاربری sanaei
رمز عبور Admin@2024
پروتکل http
Inbound ID 2
URL کامل پنل: http://185.123.45.67:54321/

🧪 تست اتصال قبل از وارد کردن در ربات

1تست با مرورگر

قبل از وارد کردن اطلاعات در ربات، حتماً با مرورگر تست کن:

  1. URL کامل پنل رو در مرورگر باز کن
  2. صفحه لاگین باید باز بشه
  3. نام کاربری و رمز رو وارد کن
  4. اگه وارد شدی، یعنی اطلاعات درسته! ✅

✅ علائم موفقیت

  • صفحه لاگین باز میشه
  • بعد از لاگین، داشبورد پنل رو می‌بینی
  • منوی Inbounds رو می‌بینی

❌ علائم خطا

  • "This site can't be reached" → آی پی یا پورت اشتباهه
  • "Connection refused" → سرویس X-UI اجرا نشده
  • "Invalid username or password" → نام کاربری یا رمز اشتباهه
  • Certificate error → باید http بزنی نه https

2تست با cURL (پیشرفته)

اگه به SSH دسترسی داری، از ماشین محلی این دستور رو بزن:

# تست اتصال: curl -k https://82.115.26.209:2083/login # اگه جواب گرفتی (حتی اگه HTML بود)، یعنی سرور زنده‌ست ✅

🔧 حل مشکلات رایج

خطا علت راه حل
Connection timeout فایروال سرور بسته است پورت پنل رو در فایروال باز کن:
ufw allow 2083/tcp
Login failed نام کاربری یا رمز اشتباه از SSH: x-ui رو بزن و گزینه 6 رو انتخاب کن
SSL certificate error SSL ندارید پروتکل رو از https به http تغییر بدید
Service not running سرویس X-UI خاموش است systemctl start x-ui

✅ چک لیست قبل از وارد کردن اطلاعات

  • ☐ با مرورگر به پنل وصل شدم و لاگین کردم
  • ☐ آی پی سرور رو تایید کردم
  • ☐ پورت پنل رو تایید کردم
  • ☐ نام کاربری و رمز رو تست کردم
  • ☐ پروتکل (http یا https) رو تایید کردم
  • ☐ لیست Inbound ها رو در پنل دیدم
  • ☐ یه Inbound با پروتکل VLESS دارم

🚀 مرحله بعد

حالا که همه اطلاعات رو داری، وارد setup_server.php شو
و اطلاعات رو با دقت وارد کن تا اتصال برقرار بشه

⚙️ رفتن به setup_server.php

💡 نکته مهم

اگه هر جا مشکل داشتی، این مراحل رو دنبال کن:

  1. اول با مرورگر تست کن که پنل باز میشه یا نه
  2. مطمئن شو که لاگین می‌کنی و داشبورد رو می‌بینی
  3. فقط بعد از این، اطلاعات رو تو ربات وارد کن
  4. اگه خطا گرفتی، فایل xui_api_debug.log رو چک کن