Skip to content
View arjanpanel's full-sized avatar

Block or report arjanpanel

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
arjanpanel/README.md

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

Arjan Panel FastAPI Railway Protocols

پنل مدیریت مدرن، نسل جدید و فوق‌امنیتی پروکسی و 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.

Popular repositories Loading

  1. arjanpanel arjanpanel Public

    TypeScript 3