{"id":51038905,"url":"https://github.com/ipmartnetwork/vortexui","last_synced_at":"2026-06-22T09:01:17.488Z","repository":{"id":365958030,"uuid":"1270387124","full_name":"iPmartNetwork/VortexUI","owner":"iPmartNetwork","description":"Next-generation, core-agnostic proxy management panel (Xray + sing-box) — user-centric, real-time, multi-node, with auto-HTTPS, GeoIP/Iran rules, and a 3x-ui-style installer.","archived":false,"fork":false,"pushed_at":"2026-06-19T17:06:30.000Z","size":9771,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-19T17:25:57.718Z","etag":null,"topics":["go","hysteria2","proxy-panel","react","reality","reverse-proxy","self-hosted","sing-box","trojan","tuic","vless","vmess","vpn","xray"],"latest_commit_sha":null,"homepage":"https://ipmartnetwork.github.io/VortexUI/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iPmartNetwork.png","metadata":{"files":{"readme":"README.fa.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-15T16:59:55.000Z","updated_at":"2026-06-19T17:06:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iPmartNetwork/VortexUI","commit_stats":null,"previous_names":["ipmartnetwork/vortexui"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/iPmartNetwork/VortexUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVortexUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVortexUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVortexUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVortexUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iPmartNetwork","download_url":"https://codeload.github.com/iPmartNetwork/VortexUI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVortexUI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34641636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","hysteria2","proxy-panel","react","reality","reverse-proxy","self-hosted","sing-box","trojan","tuic","vless","vmess","vpn","xray"],"created_at":"2026-06-22T09:01:15.628Z","updated_at":"2026-06-22T09:01:17.464Z","avatar_url":"https://github.com/iPmartNetwork.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\" dir=\"rtl\"\u003e\n  \u003cimg src=\"img/Logo.svg\" alt=\"VortexUI\" width=\"300\" /\u003e\n  \u003cp\u003e\u003cstrong\u003eپنل مدیریت پروکسی نسل جدید\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003eمستقل از هسته · کاربر‌محور · بلادرنگ\u003c/p\u003e\n\n  [![Release](https://img.shields.io/github/v/release/iPmartNetwork/VortexUI?style=flat-square\u0026color=blue)](https://github.com/iPmartNetwork/VortexUI/releases)\n  [![License](https://img.shields.io/github/license/iPmartNetwork/VortexUI?style=flat-square)](LICENSE)\n  [![CI](https://img.shields.io/github/actions/workflow/status/iPmartNetwork/VortexUI/ci.yml?style=flat-square\u0026label=CI)](https://github.com/iPmartNetwork/VortexUI/actions)\n  [![GHCR](https://img.shields.io/badge/ghcr.io-images-2496ED?style=flat-square\u0026logo=docker\u0026logoColor=white)](https://github.com/iPmartNetwork/VortexUI/pkgs/container/vortexui-panel)\n  [![Go](https://img.shields.io/badge/Go-1.26-00ADD8?style=flat-square\u0026logo=go)](https://go.dev)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-5.6-3178C6?style=flat-square\u0026logo=typescript)](https://www.typescriptlang.org)\n  [![Telegram](https://img.shields.io/badge/Telegram-@vortex__ui-26A5E4?style=flat-square\u0026logo=telegram\u0026logoColor=white)](https://t.me/vortex_ui)\n\n  \u003cbr /\u003e\n\n  \u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e · \u003cstrong\u003eفارسی\u003c/strong\u003e\n\n  \u003cbr /\u003e\n\n  [امکانات](#-امکانات) · [مقایسه](#-مقایسه) · [نصب سریع](#-نصب-سریع) · [پروتکل‌ها](#-پروتکل‌های-پشتیبانی‌شده) · [عملیات](#-عملیات) · [نقشه‌راه](#-نقشه‌راه)\n\u003c/div\u003e\n\n---\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## ✨ امکانات\n\n### 🔧 هسته‌ی پروکسی\n- **Xray-core** و **sing-box** — برای هر نود جداگانه قابل انتخاب\n- نود محلی درون‌پردازه‌ای (بدون نیاز به ایجنت جدا)\n- بارگذاری مجدد پیکربندی بدون قطعی، افزودن/حذف کاربر در لحظه\n- تولید کلید REALITY به‌صورت داخلی\n\n### 👥 مدیریت کاربران\n- مدل کاربر‌محور (یک هویت → چند پروتکل)\n- اشتراک (Subscription): تشخیص خودکار Clash/sing-box/base64\n- کد QR و لینک برای هر فرمت\n- حساب‌داری ترافیک: مبتنی بر دلتا و مقاوم در برابر ری‌استارت\n- اعمال محدودیت سهمیه + ریست زمان‌بندی‌شده\n- محدودیت تعداد دستگاه + لیست مجاز HWID\n- عملیات گروهی (انتخاب چندتایی) و **Add Bulk**\n- ورود کاربران از **3x-ui / Marzban**\n\n### 🌐 سیاست شبکه\n- خروجی‌ها (Outbounds): freedom/blackhole/dns + زنجیره‌ی پروکسی\n- ویرایشگر JSON خروجی/ورودی + ایمپورت لینک اشتراک\n- قوانین مسیریابی: تطبیق دامنه/IP/پورت/پروتکل\n- به‌روزرسان **GeoIP/Geosite** با قوانین ایران\n- متعادل‌کننده‌ی بار: random/roundRobin/leastPing/leastLoad\n- Observatory با بررسی سلامت\n\n### 🖥 ناوگان نودها\n- اتصال mTLS بین پنل و نود\n- فِیل‌اوور خودکار + بازگشت پس از بازیابی\n- پایش زنده‌ی منابع (CPU/RAM/Disk)\n- ری‌استارت/توقف هسته از راه دور\n- به‌روزرسانی GeoIP/Geosite با یک کلیک (قوانین ایران)\n- استریم زنده‌ی لاگ هر نود\n\n### 🔔 اعلان‌ها\n- گذرگاه رویداد: user.limited، user.expired، node.down و …\n- Webhook (امضای HMAC-SHA256)\n- اعلان تلگرام\n\n### 🔐 امنیت\n- JWT + احراز هویت دومرحله‌ای TOTP\n- توکن‌های API (Personal Access Tokens)\n- RBAC با دسترسی‌های دانه‌ریز\n- محافظت در برابر حمله‌ی brute-force روی ورود\n- کنترل اشتراک‌گذاری اکانت (تشخیص IP آنلاین)\n- لاگ ممیزی (همه‌ی تغییرات ادمین‌ها)\n\n### 🎨 رابط کاربری\n- React 18 + TypeScript + Tailwind\n- ۸ زبان (EN/FA/TR/AR/RU/ZH/JA/ES) + پشتیبانی RTL\n- تم تیره (Navy Blue) و روشن (Pastel)\n- واکنش‌گرا (کشوی موبایل)\n- داشبورد بلادرنگ + به‌روزرسانی زنده (SSE)\n- HTTPS خودکار با Caddy / Let's Encrypt\n\n---\n\n## 📸 تصاویر\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cstrong\u003e☀️ حالت روشن\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr /\u003e\n\n| داشبورد | نودها | کاربران |\n|:-------:|:-----:|:-------:|\n| ![Overview Light](img/panel/overview_light.png) | ![Nodes Light](img/panel/Node_light.png) | ![Users Light](img/panel/User_light.png) |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🌙 حالت تیره\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr /\u003e\n\n| داشبورد | نودها | کاربران |\n|:-------:|:-----:|:-------:|\n| ![Overview Dark](img/panel/overview_dark.png) | ![Nodes Dark](img/panel/Node_dark.png) | ![Users Dark](img/panel/User_dark.png) |\n\n\u003c/details\u003e\n\n---\n\n## ⚖️ مقایسه\n\n| | VortexUI | 3x-ui | Marzban | Hiddify |\n|:--|:--:|:--:|:--:|:--:|\n| **هسته‌ی پروکسی** | Xray + sing-box | Xray | Xray | Xray + sing-box |\n| **مدل داده** | کاربر‌محور | inbound‌محور | کاربر‌محور | کاربر‌محور |\n| **روش ترافیک** | دلتای push ✨ | polling | polling | polling |\n| **چند‌نودی** | ✅ mTLS + failover | ✅ | ✅ | ✅ |\n| **متعادل‌کننده** | ✅ | ❌ | ❌ | ❌ |\n| **CRUD خروجی** | ✅ | جزئی | ❌ | ❌ |\n| **قوانین مسیریابی** | ✅ | ❌ | ❌ | ❌ |\n| **توکن API** | ✅ | ❌ | ❌ | ❌ |\n| **لاگ ممیزی** | ✅ | ❌ | ❌ | ❌ |\n| **ضد‌اشتراک‌گذاری** | ✅ اعمال IP | محدودیت IP | ❌ | ❌ |\n| **HTTPS خودکار** | ✅ Caddy/ACME | ❌ | ❌ | ✅ |\n| **به‌روزرسان Geo (ایران)** | ✅ | ❌ | ❌ | جزئی |\n| **بک‌اند** | Go | Go | Python | Python |\n| **پایگاه‌داده** | PG + TimescaleDB | SQLite/PG | SQLite/Maria | SQLite |\n\n---\n\n## 📡 پروتکل‌های پشتیبانی‌شده\n\n| پروتکل | ورودی | خروجی | ترنسپورت |\n|--------|:-----:|:-----:|:---------:|\n| **VLESS** | ✅ | ✅ | TCP, WS, gRPC, HTTPUpgrade |\n| **VMess** | ✅ | ✅ | TCP, WS, gRPC |\n| **Trojan** | ✅ | ✅ | TCP, WS, gRPC |\n| **Shadowsocks** | ✅ | ✅ | TCP |\n| **SOCKS** | — | ✅ | TCP |\n| **HTTP** | — | ✅ | TCP |\n| **Hysteria2 / TUIC / WireGuard** | 🔜 | — | UDP |\n\n**لایه‌های امنیت:** None، TLS، REALITY\n\n---\n\n## 🚀 نصب سریع\n\n### نصب یک‌خطی\n\n```bash\nbash \u003c(curl -Ls https://raw.githubusercontent.com/iPmartNetwork/VortexUI/master/install.sh)\n```\n\nنصب‌کننده تعاملی است و دو چیز می‌پرسد:\n\n۱. **روش نصب**\n   - **Docker Compose** *(پیشنهادی)* — کل استک (وب · پنل · نود · PostgreSQL/TimescaleDB · Redis) در کانتینر اجرا می‌شود.\n   - **Native (systemd)** — باینری‌های Go به‌صورت سرویس سیستمی اجرا می‌شوند، SPA با Caddy سرو می‌شود و فقط PostgreSQL + Redis در داکر هستند.\n\n۲. **روش دسترسی به پنل**\n   - **دامنه + HTTPS خودکار** — یک دامنه (و ایمیل اختیاری) وارد می‌کنی؛ Caddy یک گواهی **Let's Encrypt** می‌گیرد و **خودکار تمدید** می‌کند (نیازمند باز بودن پورت‌های **۸۰ و ۴۴۳** و اشاره‌ی رکورد DNS به سرور).\n   - **IP + HTTP** — یک پورت ساده‌ی HTTP انتخاب می‌کنی.\n\nسپس کلیدها و گواهی‌های mTLS را می‌سازد، استک را بالا می‌آورد، اولین ادمین را می‌سازد، آدرس/اطلاعات ورود را چاپ می‌کند و دستور `vortexui` را نصب می‌کند.\n\nاجرای غیرتعاملی (برای اسکریپت):\n\n```bash\nVORTEXUI_METHOD=docker VORTEXUI_NONINTERACTIVE=1 \\\n  VORTEXUI_ADMIN_USER=admin VORTEXUI_ADMIN_PASS='s3cret' \\\n  bash install.sh\n```\n\n### کنسول مدیریت (`vortexui`)\n\nبعد از نصب، کافیست **`vortexui`** را تایپ کنی تا منوی تعاملی (مثل x-ui) بیاید:\n\n```text\n   1) Start            2) Stop\n   3) Restart          4) Status\n   5) Logs             6) Update\n   7) Create admin     8) Change web port\n   9) Domain / SSL     10) Settings / URL\n   11) Uninstall       0) Exit\n```\n\nیا به‌صورت ساب‌کامند: `vortexui start|stop|restart|status|logs|update|admin|settings|uninstall`.\n\n### نصب دستی\n\n```bash\ngit clone https://github.com/iPmartNetwork/VortexUI \u0026\u0026 cd VortexUI\ndocker compose up -d           # PostgreSQL + TimescaleDB + Redis\ncp .env.example .env           # VORTEX_JWT_SECRET را با openssl rand -hex 32 ست کن\nmake build \u0026\u0026 make certs \u0026\u0026 make run-panel\n./bin/panel admin create --username admin --password 'your-password' --sudo\n```\n\n---\n\n## 🔒 عملیات\n\n### HTTPS خودکار\nلایه‌ی وب **Caddy** است. کافیست یک دامنه ست کنی (`SITE_ADDRESS` در `deploy/.env` یا هنگام نصب) تا Caddy خودکار گواهی **Let's Encrypt** بگیرد و تمدید کند — بدون certbot و بدون cron. برای HTTP ساده مقدار را `:80` بگذار. هر زمان با `vortexui` → *Domain / SSL* قابل تغییر است. گواهی‌ها در volume به نام `caddy-data` پایدار می‌مانند. نیازمند باز بودن پورت‌های **۸۰** و **۴۴۳**.\n\n### به‌روزرسانی زنده (SSE)\nپنل رویدادهای دامنه را با **Server-Sent Events** به مرورگر می‌فرستد (`GET /api/events/stream`). رابط کاربری یک‌بار subscribe می‌کند و به‌محض هر تغییر (قطع شدن نود، رسیدن کاربر به سقف، تشخیص اشتراک‌گذاری) همان بخش را تازه می‌کند — بدون polling. توکن از `?access_token=` می‌رود چون `EventSource` نمی‌تواند هدر بفرستد.\n\n### GeoIP / Geosite (قوانین ایران)\nهر نود با `geoip.dat` / `geosite.dat` می‌آید. از مسیر **Nodes → Update Geo** آخرین دیتابیس **[Iran-v2ray-rules](https://github.com/chocolate4u/Iran-v2ray-rules)** دانلود می‌شود (شامل `geoip:ir`، `geosite:ir`، `category-ir`، دسته‌های تبلیغات/بدافزار و …) و هسته reload می‌شود؛ پس قوانین مسیریابی می‌توانند IP و دامنه‌های ایرانی را هدف بگیرند (مثلاً *ایران مستقیم، بقیه از پروکسی*). URL سفارشی هم از طریق API (`POST /api/nodes/:id/geo-update`) پذیرفته می‌شود.\n\n### محافظ اشتراک‌گذاری اکانت\nیک حلقه‌ی پس‌زمینه تعداد **IPهای آنلاین متمایز** هر کاربر (Xray `GetStatsOnlineIpList`) را با محدودیت دستگاهش مقایسه می‌کند. تخلف یک هشدار `user.ip_limit` (webhook/تلگرام) می‌سازد و با `VORTEX_SHARE_AUTOLIMIT=true` کاربر متخلف را خودکار limit می‌کند (قابل بازگشت).\n\n---\n\n## 📖 مستندات\n\n| موضوع | لینک |\n|-------|------|\n| **سایت مستندات (MkDocs)** | **[ipmartnetwork.github.io/VortexUI](https://ipmartnetwork.github.io/VortexUI/)** — FA · EN · AR · TR |\n| **کانال تلگرام** | [**@vortex_ui**](https://t.me/vortex_ui) — اخبار، release، جامعه کاربران |\n| **GitHub Discussions** | [سؤال و پشتیبانی](https://github.com/iPmartNetwork/VortexUI/discussions) |\n| **ویکی (منبع Markdown)** | [`docs/WIKI-HUB.md`](docs/WIKI-HUB.md) · [فارسی](docs/wiki/fa/README.md) · [English](docs/wiki/en/README.md) · [العربية](docs/wiki/ar/README.md) · [Türkçe](docs/wiki/tr/README.md) |\n| مرجع API (OpenAPI 3.0) | [`docs/openapi.yaml`](docs/openapi.yaml) |\n| پروتکل‌ها و مثال پیکربندی | [`docs/protocols.md`](docs/protocols.md) |\n| متغیرهای محیطی | [`.env.example`](.env.example) |\n| استقرار با Docker | [`deploy/`](deploy/) |\n| CI/CD | [`.github/workflows/`](.github/workflows/) |\n| تغییرات نسخه‌ها | [`CHANGELOG.md`](CHANGELOG.md) |\n| راهنمای مشارکت | [`CONTRIBUTING.md`](CONTRIBUTING.md) |\n\n---\n\n## 🗺 نقشه‌راه\n\n- [x] هسته‌ی مستقل (Xray + sing-box)\n- [x] حساب‌داری ترافیک مبتنی بر دلتا\n- [x] فِیل‌اوور خودکار + بازگشت\n- [x] مدیریت Outbound/Routing/Balancer\n- [x] لاگ ممیزی · توکن API · محافظ اشتراک‌گذاری\n- [x] ورود از 3x-ui / Marzban\n- [x] رابط ۸ زبانه + RTL\n- [x] داشبورد بلادرنگ + به‌روزرسانی زنده (SSE)\n- [x] HTTPS خودکار (Caddy + Let's Encrypt)\n- [x] به‌روزرسان GeoIP/Geosite با قوانین ایران\n- [x] نصب‌کننده‌ی یک‌خطی + کنسول مدیریت `vortexui`\n- [ ] پروتکل‌های Hysteria2 / TUIC / WireGuard\n- [ ] مدیریت DNS\n- [ ] بات تلگرام کاربران\n- [ ] زیرپنل‌های نمایندگی (Reseller)\n\n---\n\n## 💝 حمایت\n\nاگر VortexUI برایت مفید بود:\n\n- ⭐ به مخزن **ستاره** بده\n- 🍴 **Fork** کن و مشارکت کن\n- 📢 با دیگران **به اشتراک** بگذار\n- 💬 در **کانال تلگرام** عضو شو: [@vortex_ui](https://t.me/vortex_ui)\n- 💰 برای حمایت از توسعه، **کریپتو اهدا** کن\n\n| شبکه | آدرس |\n|:----:|------|\n| **USDT (TRC20)** | `TRLnjZ7YDSwjh3oay28qigEYNieGPMs6ew` |\n| **BTC** | `bc1qszt4g7jdv7ev2t3pexctc07ults8nfflht3nj5` |\n| **TON** | `UQAYSSSirtQ9_67ZHYUgLVLMx9Ir9vvh3vpcq2qbpit_8-Db` |\n\n---\n\n## 🤝 مشارکت\n\nمشارکت‌ها استقبال می‌شوند! لطفاً:\n\n۱. مخزن را Fork کن\n۲. یک شاخه‌ی ویژگی بساز (`git checkout -b feat/amazing`)\n۳. کامیت کن (`git commit -m 'feat: add amazing feature'`)\n۴. push کن (`git push origin feat/amazing`)\n۵. یک Pull Request باز کن\n\nبرای راهنمای کامل [CONTRIBUTING.md](CONTRIBUTING.md) را ببین.\n\n---\n\n## 🌐 چندزبانگی\n\n| 🇺🇸 English | 🇮🇷 فارسی | 🇹🇷 Türkçe | 🇸🇦 العربية |\n|:-----------:|:---------:|:----------:|:-----------:|\n| 🇷🇺 Русский | 🇨🇳 中文 | 🇯🇵 日本語 | 🇪🇸 Español |\n\nپشتیبانی کامل RTL برای فارسی و عربی.\n\n---\n\n## 📄 لایسنس\n\nاین پروژه تحت لایسنس **GPL-3.0** منتشر شده است — فایل [LICENSE](LICENSE) را ببین.\n\n---\n\n\u003cdiv align=\"center\" dir=\"ltr\"\u003e\n  \u003csub\u003e© 2026 iPmart Network. All rights reserved.\u003c/sub\u003e\n  \u003cbr /\u003e\n  \u003cstrong\u003eساخته‌شده با ❤️ توسط \u003ca href=\"https://github.com/iPmartNetwork\"\u003eiPmart Network\u003c/a\u003e\u003c/strong\u003e\n  \u003cbr /\u003e\n  \u003ca href=\"https://t.me/vortex_ui\"\u003eتلگرام @vortex_ui\u003c/a\u003e · \u003ca href=\"https://ipmartnetwork.github.io/VortexUI/fa/\"\u003eمستندات\u003c/a\u003e\n\u003c/div\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipmartnetwork%2Fvortexui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipmartnetwork%2Fvortexui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipmartnetwork%2Fvortexui/lists"}