{"id":51038902,"url":"https://github.com/ipmartnetwork/veltrix","last_synced_at":"2026-06-22T09:01:17.576Z","repository":{"id":357687689,"uuid":"1238171201","full_name":"iPmartNetwork/Veltrix","owner":"iPmartNetwork","description":"Veltrix - Intelligent Network Control for x-ui, V2Ray outbound monitoring, server health, alerts, and commercial license management.","archived":false,"fork":false,"pushed_at":"2026-05-26T23:21:50.000Z","size":653,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-26T23:22:18.992Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iPmartNetwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-05-13T22:05:18.000Z","updated_at":"2026-05-26T23:21:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iPmartNetwork/Veltrix","commit_stats":null,"previous_names":["ipmartnetwork/veltrix"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iPmartNetwork/Veltrix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVeltrix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVeltrix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVeltrix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVeltrix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iPmartNetwork","download_url":"https://codeload.github.com/iPmartNetwork/Veltrix/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iPmartNetwork%2FVeltrix/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":[],"created_at":"2026-06-22T09:01:15.017Z","updated_at":"2026-06-22T09:01:17.569Z","avatar_url":"https://github.com/iPmartNetwork.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/Veltrix.svg\" alt=\"Veltrix\" width=\"280\" height=\"280\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eIntelligent Network Control — Professional x-ui/V2Ray Server Management Dashboard\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./CHANGELOG.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/version-0.4.0-00bfa6?style=for-the-badge\" alt=\"Version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Commercial-ef4444?style=for-the-badge\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.12+-3776ab?style=for-the-badge\u0026logo=python\u0026logoColor=white\" alt=\"Python\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/iPmartNetwork/Veltrix/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/iPmartNetwork/Veltrix?style=for-the-badge\u0026color=f59e0b\" alt=\"Stars\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/iPmartNetwork/Veltrix/network/members\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/iPmartNetwork/Veltrix?style=for-the-badge\u0026color=8b5cf6\" alt=\"Forks\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/iPmartNetwork/Veltrix/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/iPmartNetwork/Veltrix?style=for-the-badge\u0026color=ef4444\" alt=\"Issues\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/iPmartNetwork/Veltrix\"\u003e\u003cimg src=\"https://img.shields.io/github/repo-size/iPmartNetwork/Veltrix?style=for-the-badge\u0026color=06b6d4\" alt=\"Repo Size\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/iPmartNetwork/Veltrix/commits/master\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/iPmartNetwork/Veltrix?style=for-the-badge\u0026color=6366f1\" alt=\"Last Commit\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/iPmartNetwork/Veltrix/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/iPmartNetwork/Veltrix?style=for-the-badge\u0026color=ec4899\" alt=\"Contributors\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-quick-start\"\u003eQuick Start\u003c/a\u003e •\n  \u003ca href=\"#-features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#-architecture\"\u003eArchitecture\u003c/a\u003e •\n  \u003ca href=\"#%EF%B8%8F-tech-stack\"\u003eTech Stack\u003c/a\u003e •\n  \u003ca href=\"#-deployment\"\u003eDeployment\u003c/a\u003e •\n  \u003ca href=\"./README_FA.md\"\u003e🇮🇷 فارسی\u003c/a\u003e •\n  \u003ca href=\"./CHANGELOG.md\"\u003eChangelog\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 📋 Overview\n\n**Veltrix** is a self-hosted operational dashboard for outbound sellers, network operators, and teams managing multiple x-ui/V2Ray servers. It consolidates server monitoring, outbound health checks, incident management, notifications, reporting, and commercial licensing into a single professional interface.\n\nDesigned as **commercial software** with a private License Server for activation and validation.\n\n---\n\n## ⚡ Quick Start\n\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/Veltrix/master/scripts/install-linux.sh)\n```\n\nOr manually:\n\n```bash\ngit clone https://github.com/iPmartNetwork/Veltrix.git\ncd Veltrix\nsudo bash scripts/install-linux.sh\n```\n\nOr with Docker:\n\n```bash\ndocker compose up -d\n```\n\n---\n\n## ✨ Features\n\n### 🖥 Server Management\n\n| Feature | Description |\n|---------|-------------|\n| Multi-panel | x-ui, 3x-ui, and Marzban support |\n| Auth modes | Username/password or API Token |\n| Sync | Automatic inbound synchronization |\n| Health Score | 0–100 scoring with A–F grades |\n| Tags | Categorize servers with custom tags |\n| Bulk ops | Ping, sync, enable/disable multiple servers |\n\n### 📡 Monitoring \u0026 Alerts\n\n| Feature | Description |\n|---------|-------------|\n| TCP Ping | Per-outbound connectivity checks |\n| Resources | CPU, RAM, disk, Xray status |\n| Auto-disable | Outbounds disabled after N failures |\n| IP Rotation | Alert when server IP changes |\n| Traffic limits | Warning at 80%, alert at 100% |\n| Real-time | SSE push updates to dashboard |\n\n### 🔔 Incidents \u0026 Notifications\n\n| Feature | Description |\n|---------|-------------|\n| Lifecycle | open → acknowledged → recovered |\n| Telegram | Bot notifications + two-way commands |\n| Webhook | Events for Zapier, n8n, Make |\n| Browser | Push notifications for new alerts |\n| Scheduled | Weekly uptime reports auto-sent |\n\n### 📊 Reporting \u0026 Export\n\n| Feature | Description |\n|---------|-------------|\n| Uptime reports | Server availability over 7/30/90 days |\n| Performance | Per-outbound latency statistics |\n| CSV export | Servers, outbounds, incidents |\n| Uptime badge | Shields.io compatible public badge |\n| API docs | Auto-generated OpenAPI 3.0 |\n\n### 🔐 Security\n\n| Feature | Description |\n|---------|-------------|\n| Passwords | PBKDF2-SHA256 (260K iterations) |\n| Encryption | AES-256-CBC for stored credentials |\n| Rate limiting | Per-endpoint (login: 10/15min, API: 120/min) |\n| Sessions | HttpOnly cookies, 7-day expiry |\n| RBAC | Owner + 10 managers with permissions |\n| Audit | Full action logging |\n| License | Ed25519 signed token verification |\n\n### 🎨 Dashboard\n\n| Feature | Description |\n|---------|-------------|\n| Dark Mode | Full dark theme with system detection |\n| RTL | Persian interface with English support |\n| PWA | Installable on mobile devices |\n| Charts | CPU/RAM and ping history visualization |\n| Pagination | Search, filter, and page through data |\n| Branding | Custom logo, colors, product name |\n\n---\n\n## 🏗 Architecture\n\n```\nVeltrix/\n├── outpanel/              26 Python modules (backend)\n│   ├── app.py             HTTP server + router dispatch\n│   ├── routes.py          77 API endpoint handlers\n│   ├── worker.py          Background monitoring + automation\n│   ├── sse.py             Real-time Server-Sent Events\n│   ├── panels.py          Multi-panel adapter (x-ui/3x-ui/Marzban)\n│   ├── telegram_bot.py    Two-way Telegram bot\n│   ├── crypto.py          AES-256 credential encryption\n│   ├── reports.py         Reporting + CSV export\n│   └── ...                Auth, licensing, alerts, i18n, etc.\n├── web/                   Frontend (vanilla JS SPA)\n├── tests/                 Unit test suite (pytest)\n├── .github/workflows/     CI/CD pipeline\n├── scripts/               Auto-installer\n├── docker-compose.yml     Production deployment\n└── docs/                  Documentation\n```\n\n---\n\n## ⚙️ Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| Backend | Python 3.12+ (stdlib only — zero dependencies) |\n| Database | SQLite with WAL mode |\n| Frontend | Vanilla JavaScript SPA |\n| Styling | Custom CSS with Dark Mode |\n| Container | Docker + Docker Compose |\n| Deployment | systemd service on Linux |\n| CI/CD | GitHub Actions |\n| Testing | pytest |\n\n---\n\n## 🚀 Deployment\n\n### One-Line Install (Linux)\n\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/Veltrix/master/scripts/install-linux.sh)\n```\n\nThe installer provides:\n- 🔍 Auto OS detection (Ubuntu, Debian, CentOS, Fedora, Arch)\n- 🐍 Auto Python 3.12 installation if missing\n- 🔑 Auto-generated encryption key and API token\n- 🛡 systemd service with security hardening\n- 📋 Interactive menu (install, update, demo, uninstall)\n\n### Docker\n\n```bash\ndocker compose up -d\n```\n\n### Development\n\n```bash\npython -m outpanel.app --host 127.0.0.1 --port 8000\n```\n\n---\n\n## 🤖 Telegram Bot\n\nConfigure in `.env`:\n```env\nOUTPANEL_TELEGRAM_BOT_TOKEN=123456:ABC-DEF...\nOUTPANEL_TELEGRAM_ALLOWED_CHATS=-1001234567890\n```\n\nCommands:\n| Command | Description |\n|---------|-------------|\n| `/status` | Overview of all servers |\n| `/servers` | List servers with status |\n| `/server \u003cid\u003e` | Server detail + metrics |\n| `/ping \u003cid\u003e` | Ping server outbounds |\n| `/alerts` | Active alerts |\n| `/incidents` | Open incidents |\n| `/health` | Health scores |\n\n---\n\n## 📜 License\n\nVeltrix is **proprietary commercial software**.\n\nUse, installation, modification, distribution, resale, sublicensing, public hosting, or making this software available to third parties is not permitted without a valid commercial license issued by **iPmartNetwork**.\n\n| Plan | Limit | Duration |\n|------|-------|----------|\n| Pro | 20 servers | 6mo / 1yr / Lifetime |\n| Enterprise | 60 servers + 60 outbounds | 6mo / 1yr / Lifetime |\n\n---\n\n## 🤝 Support\n\nFor licensing, installation support, or commercial inquiries:\n\n- **GitHub:** [iPmartNetwork](https://github.com/iPmartNetwork)\n- **Issues:** [Report a bug](https://github.com/iPmartNetwork/Veltrix/issues)\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/Veltrix.png\" alt=\"Veltrix\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eBuilt with precision by \u003cstrong\u003eiPmartNetwork\u003c/strong\u003e\u003c/sub\u003e\u003cbr\u003e\n  \u003csub\u003e© 2026 iPmartNetwork — All rights reserved.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipmartnetwork%2Fveltrix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipmartnetwork%2Fveltrix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipmartnetwork%2Fveltrix/lists"}