Arjan Panel (پنل مدیریت هوشمند و فوق‌امن ارژن)

پنل مدیریت مدرن، نسل جدید و فوق‌امنیتی پروکسی و VPN برای Railway و سرورهای لینوکس (VPS)
Next-generation, ultra-secure personal VPN & proxy management panel engineered for Railway.com and Linux VPS.

فارسی | English | نصب روی Railway | ویژگی‌ها

---

راهنمای فارسی

ارژن (Arjan) یک کنترل‌پنل کامل، سبک، فوق‌العاده زیبا و با بالاترین استانداردهای امنیتی است که به عنوان جایگزینی بسیار امن‌تر و حرفه‌ای‌تر برای پنل‌های سنتی مانند SpiderPanel طراحی شده است. ارژن دارای احراز هویت دو مرحله‌ای اجباری (2FA TOTP)، رمزنگاری قوی، پشتیبانی از هسته Xray، سابسکریپشن‌های چندگانه و راه‌اندازی با یک کلیک روی پلتفرم ابری Railway.com یا هر سرور ابری لینوکسی است.

ویژگی‌های کلیدی

1. امنیت بدون سازش (Military-Grade Security):

   • احراز هویت دو مرحله‌ای اجباری (Google Authenticator / 2FA TOTP) برای همه مدیران.
   • هش‌کردن پیشرفته رمز عبور با الگوریتم قدرتمند Bcrypt / Argon2.
   • ویزارد راه‌اندازی اولیه (First-Run Wizard) برای جلوگیری از پسوردهای پیش‌فرض ضعیف.
   • کوکی‌های محافظت‌شده HttpOnly, SameSite=Strict و توکن‌های نشست ضد سرقت (CSRF protection).
   • محدودکننده نرخ درخواست (Rate Limiting) هوشمند برای مقابله با حملات Brute-force.
   • هدرهای امنیتی سخت‌گیرانه (HSTS, CSP, X-Frame-Options, X-Content-Type-Options).

2. پشتیبانی کامل از پروتکل‌های نوین:

   • VLESS: Reality (با تولید خودکار کلیدهای x25519 و ShortID)، WebSocket (WS)، gRPC، TLS، XHTTP.
   • VMess: WebSocket + TLS و استریم مستقیم.
   • Trojan: TLS و WebSocket سازگار با کلودفلر.
   • Shadowsocks: الگوریتم‌های مدرن 2022-blake3 و chacha20-poly1305.
   • WireGuard: تولید کانفیگ کلاینت و سرور با تبادل کلید سریع.
   • Telegram MTProto Proxy: با Fake-TLS (ee secret) برای تلگرام بدون قطعی.

3. یکپارچه‌سازی ابری و کلودفلر (Cloudflare Workers):

   • اسکریپت آماده worker.js و _worker.js برای دور زدن فیلترینگ و توزیع چند مکانه ترافیک (Multi-location Proxy).
   • اسکنر داخلی IP تمیز کلودفلر با بررسی بلادرنگ پینگ و پکت‌لاست.

4. سیستم سابسکریپشن هوشمند:

   • لینک‌های رمزگذاری‌شده Base64 سازگار با تمامی کلاینت‌ها (v2rayNG, Streisand, FoXray, V2Box, Shadowrocket, Nekobox).
   • خروجی خودکار کانفیگ فرمت Clash / Clash Meta و Sing-box.
   • صفحه وضعیت اختصاصی سابسکریپشن با نمایش حجم مصرفی و روزهای باقی‌مانده.

5. مدیریت کامل و بکاپ امن:

   • مدیریت کاربران با محدودیت ترافیک، تاریخ انقضا و محدودیت تعداد اتصال همزمان (IP Limit).
   • دیتابیس فایل‌محور JSON در مسیر /data (کاملاً منطبق بر Railway Persistent Volume).
   • بکاپ‌گیری رمزگذاری‌شده با AES-GCM و امکان بازیابی آسان.

---

استقرار در Railway (ساده و سریع)

شما می‌توانید در کمتر از ۳ دقیقه ارژن را روی اکانت رایگان یا پولی Railway.com راه‌اندازی کنید:

1. این ریپازیتوری را در اکانت گیت‌هاب خود Fork یا Push کنید.
2. وارد پنل Railway شوید و روی دکمه New Project کلیک کنید.
3. گزینه Deploy from GitHub repo را انتخاب کرده و ریپازیتوری Arjan را انتخاب کنید.
4. (اختیاری ولی توصیه شده) در تنظیمات سرویس در تب Volumes، یک ولوم جدید با نام دایرکتوری /data اضافه کنید تا با ریستارت شدن کانتینر اطلاعات کاربران حفظ شود.
5. در تب Settings > Networking، پورت را روی 8080 بگذارید و دامنه عمومی Railway را فعال کنید (Generate Domain).
6. آدرس عمومی را باز کنید: https://YOUR_DOMAIN.up.railway.app/arjan
7. در اولین ورود، صفحه ویزارد راه‌اندازی امنیتی باز می‌شود: رمز قوی خود را تعیین کنید، کد QR مربوط به 2FA را با نرم‌افزار Google Authenticator اسکن کنید و وارد پنل شوید!

---

نصب دستی روی لینوکس (VPS / Ubuntu / Debian)

# کلون کردن پروژه
git clone https://github.com/yourusername/Arjan.git /opt/arjan
cd /opt/arjan

# راه‌اندازی با داکر کامپوز (ساده‌ترین روش)
docker compose up -d

# یا اجرای مستقیم با پایتون:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
chmod +x run.sh
./run.sh

پنل به صورت پیش‌فرض روی آدرس http://YOUR_SERVER_IP:8080/arjan در دسترس خواهد بود.

---

English Guide

Arjan is a cutting-edge, resilient, and beautiful VPN/proxy management system engineered from the ground up for high-security environments, personal censorship bypass, and frictionless zero-downtime deployment on Railway.com or VPS.

Architecture Highlights

• Backend: Python 3.12+ / FastAPI with async concurrency, high throughput Uvicorn server.
• Frontend: Responsive Single Page App, Deep Teal/Indigo aesthetic, dark/light theme, full Persian (RTL) and English (LTR) localization.
• Security: Mandatory 2FA TOTP setup on first boot, Bcrypt password hashing, secure cookies, brute-force rate limiter, secure HTTP headers.
• Protocols: VLESS (Reality, WS, TLS, XHTTP), VMess, Trojan, Shadowsocks-2022, WireGuard, and MTProto Telegram proxy.
• Cloudflare Integration: Built-in Worker proxy script generation, clean IP scanner.
• Storage: Clean JSON file persistence under /data designed for Railway Volume mounts and containerized environments.

Environment Variables

Variable	Default	Description
PORT	8080	Listening port for the application
PANEL_PATH	/arjan	Secure base path for admin panel access
DATA_DIR	/data	Path to persistent storage volume
SECRET_KEY	(Auto-generated)	64-character entropy key for session signing
XRAY_BIN_PATH	/usr/local/bin/xray	Path to executable Xray binary

---

ساختار فایل‌های پروژه (Repository File Structure)

├── main.py              # برنامه اصلی FastAPI و روترهای API و احراز هویت
├── shared.py            # توابع دیتابیس JSON، امنیت، هش، کلیدهای Reality و تمپلیت‌ها
├── pages.py             # صفحات HTML احراز هویت، ویزارد، سابسکریپشن و سورس پنل
├── requirements.txt     # کتابخانه‌های مورد نیاز پایتون
├── Dockerfile           # ایمیج چندمرحله‌ای بهینه‌سازی شده داکر
├── railway.toml         # تنظیمات استقرار بومی Railway
├── docker-compose.yml   # راه‌اندازی سریع روی سرور لینوکس
├── README.md            # مستندات دوزبانه جامع
├── start.sh             # اسکریپت استارت و بررسی هسته Xray
├── run.sh               # اسکریپت اجرای محلی
├── data/
│   └── .gitkeep         # دایرکتوری ذخیره اطلاعات کاربران و تنظیمات
├── static/              # استاتیک و آیکون‌ها
├── worker/
│   └── worker.js        # ورکر کلودفلر برای پروکسی چند مکانه
└── _worker.js           # ورکر کلودفلر Pages

---

طراحی شده با دقت و امنیت بالا برای آزادی اینترنت و احترام به حریم خصوصی.
Crafted with precision for internet freedom and uncompromising digital privacy.