## معرفی پروژه **X-NET** پنلی برای ساخت و مدیریت سرویس‌های **VPN/Proxy** و **اکانت‌های SSH** است؛ از طریق آن کاربران (اشتراک‌ها) را می‌سازید، ترافیک و انقضای هرکدام را کنترل می‌کنید و لینک اشتراک ارائه می‌دهید. - پردازش ترافیک با هستهٔ **Sing-box** - امکان ساخت **اکانت SSH** با پروتکل‌های متنوع: SSH-over-WebSocket، Stunnel/TLS، SlowDNS، Dropbear و BadVPN/UDPGW - **ایزوله‌سازی دسترسی:** هر اکانت SSH فقط به پورت/پروتکل خودش دسترسی دارد - مدیریت **چند سرور** از یک رابط واحد: یک سرور «پنل» و بقیه «نود» --- ## نصب ### پیش‌نیازها - سرور لینوکس (Ubuntu / Debian توصیه می‌شود)، معماری `amd64` - دسترسی `root` ### نصب پنل ```bash apt update bash <(curl -fsSL https://raw.githubusercontent.com/xpanel-cp/x-net/main/install/xnet.sh) ``` نصب‌کننده ۳ نسخهٔ آخر را در یک منو نشان می‌دهد؛ برای نصب مستقیم یک نسخهٔ مشخص: ```bash bash <(curl -fsSL https://raw.githubusercontent.com/xpanel-cp/x-net/main/install/xnet.sh) v1.2.3 ``` در نصب اولیه، پورت پنل و اطلاعات ادمین پرسیده می‌شود، سرویس systemd ساخته می‌شود، هستهٔ sing-box و زیرسیستم‌های SSH نصب می‌شوند و پورت در فایروال باز می‌شود. در اجرای مجدد (بروزرسانی)، فایل `.env` و دیتابیس حفظ می‌شوند. ### نصب نود (Agent) همان دستور نصب را روی سرور نود اجرا کنید و در پرسش نقش، گزینهٔ `agent` را انتخاب کنید. سپس در پنل وارد **سرورها و نودها → Register Node** شوید؛ کلیدهای تولیدشده را در `/opt/xnet/.env` نود قرار دهید و سرویس را restart کنید: ```bash nano /opt/xnet/.env # NODE_ROLE=agent # NODE_API_KEY=xnetnode_... # NODE_SECRET_KEY=... systemctl restart xnet ``` ### مدیریت سرویس ```bash systemctl status xnet # وضعیت سرویس journalctl -u xnet -f # لاگ زنده systemctl restart xnet # راه‌اندازی مجدد ``` > **امنیت:** آدرس `http://IP:PORT` رمزنگاری‌شده نیست؛ برای محیط واقعی پنل را پشت دامنه + HTTPS قرار دهید. --- ## پروتکل‌ها ### پروتکل‌های هسته (Sing-box) `VLESS` · `VMess` · `Trojan` · `Shadowsocks` · `SOCKS` · `HTTP` · `TUIC` · `Hysteria` · `Hysteria2` · `AnyTLS` · `WireGuard` · `Mixed` · `ShadowTLS` · `NaiveProxy` ### ترابری‌ها (Transports) `TCP` · `WebSocket` · `gRPC` · `HTTP/2` · `HTTPUpgrade` · `QUIC` ### امنیت / TLS `Plain` · `TLS` · `Reality` ### SSH `SSH (direct TCP)` · `SSH-over-WebSocket` · `SSH WS + TLS` · `Stunnel/TLS` · `SlowDNS` · `Dropbear` · `BadVPN/UDPGW` ## امکانات ### مدیریت اینباندها ساخت، ویرایش، کلون، فعال/غیرفعال‌سازی و استقرار روی چند نود ### مدیریت اشتراک‌ها لینک اشتراک، QR Code، سقف حجم، تاریخ انقضا، سقف تعداد دستگاه‌های همزمان، تمدید و ریست ترافیک ### اکانت‌های SSH ساخت کاربر سیستمی، محدودسازی ترافیک و تعداد ورود همزمان ### چندنودی نقش‌های panel/agent، همگام‌سازی خودکار، و **تک‌نود فعال (Follow-Me)** با تغییر نود از طریق لینک اشتراک ### امنیت ورود با JWT، احراز هویت دومرحله‌ای (TOTP)، نقش‌های دسترسی (ادمین/اپراتور/نماینده) و امضای HMAC بین پنل و نود ### دامنه و گواهی بررسی واقعی DNS، صدور/تمدید گواهی TLS (Let's Encrypt) ### مسیریابی و شبکه قوانین Routing (GeoSite/GeoIP، AdBlock)، پیکربندی DNS و کنترل تراکم TCP BBR ### مانیتورینگ داشبورد، تحلیل ترافیک، لاگ زنده، پشتیبان‌گیری/بازیابی دیتابیس ### API توکن Bearer، مستندات و playground، و فایروال با لیست سفید IP ### رابط کاربری چندزبانه (فارسی/انگلیسی/روسی/چینی)، تم روشن و تاریک، بروزرسانی خودکار صفحات ## مجوز این پروژه تحت **X-NET Software License (Version 1.0)** — یک مجوز اختصاصی — منتشر شده است. متن کامل در فایل [`LICENSE`](../LICENSE). | وضعیت | توضیح | |---|---| | ✅ مجاز | استفاده از توزیع رسمی کامپایل‌شده برای مقاصد شخصی و تجاری، نصب روی هر تعداد سرور | | 🔒 اختصاصی | سورس‌کد — بدون حق دسترسی، تغییر، انتشار یا مهندسی معکوس | | ❌ ممنوع | حذف/تغییر کپی‌رایت، توزیع نسخهٔ تغییریافته، استفاده از نام X-NET بدون اجازهٔ کتبی | | ⚠️ بدون ضمانت | نرم‌افزار «همان‌گونه که هست» ارائه می‌شود؛ مسئولیت رعایت قوانین بر عهدهٔ کاربر است | > **Copyright (c) 2026 X-NET. All Rights Reserved.**