https://github.com/ipmartnetwork/veltrix
Veltrix - Intelligent Network Control for x-ui, V2Ray outbound monitoring, server health, alerts, and commercial license management.
https://github.com/ipmartnetwork/veltrix
Last synced: about 2 months ago
JSON representation
Veltrix - Intelligent Network Control for x-ui, V2Ray outbound monitoring, server health, alerts, and commercial license management.
- Host: GitHub
- URL: https://github.com/ipmartnetwork/veltrix
- Owner: iPmartNetwork
- License: other
- Created: 2026-05-13T22:05:18.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-05-26T23:21:50.000Z (3 months ago)
- Last Synced: 2026-05-26T23:22:18.992Z (3 months ago)
- Language: Python
- Size: 638 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Intelligent Network Control — Professional x-ui/V2Ray Server Management Dashboard
Quick Start •
Features •
Architecture •
Tech Stack •
Deployment •
🇮🇷 فارسی •
Changelog
---
## 📋 Overview
**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.
Designed as **commercial software** with a private License Server for activation and validation.
---
## ⚡ Quick Start
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/Veltrix/master/scripts/install-linux.sh)
```
Or manually:
```bash
git clone https://github.com/iPmartNetwork/Veltrix.git
cd Veltrix
sudo bash scripts/install-linux.sh
```
Or with Docker:
```bash
docker compose up -d
```
---
## ✨ Features
### 🖥 Server Management
| Feature | Description |
|---------|-------------|
| Multi-panel | x-ui, 3x-ui, and Marzban support |
| Auth modes | Username/password or API Token |
| Sync | Automatic inbound synchronization |
| Health Score | 0–100 scoring with A–F grades |
| Tags | Categorize servers with custom tags |
| Bulk ops | Ping, sync, enable/disable multiple servers |
### 📡 Monitoring & Alerts
| Feature | Description |
|---------|-------------|
| TCP Ping | Per-outbound connectivity checks |
| Resources | CPU, RAM, disk, Xray status |
| Auto-disable | Outbounds disabled after N failures |
| IP Rotation | Alert when server IP changes |
| Traffic limits | Warning at 80%, alert at 100% |
| Real-time | SSE push updates to dashboard |
### 🔔 Incidents & Notifications
| Feature | Description |
|---------|-------------|
| Lifecycle | open → acknowledged → recovered |
| Telegram | Bot notifications + two-way commands |
| Webhook | Events for Zapier, n8n, Make |
| Browser | Push notifications for new alerts |
| Scheduled | Weekly uptime reports auto-sent |
### 📊 Reporting & Export
| Feature | Description |
|---------|-------------|
| Uptime reports | Server availability over 7/30/90 days |
| Performance | Per-outbound latency statistics |
| CSV export | Servers, outbounds, incidents |
| Uptime badge | Shields.io compatible public badge |
| API docs | Auto-generated OpenAPI 3.0 |
### 🔐 Security
| Feature | Description |
|---------|-------------|
| Passwords | PBKDF2-SHA256 (260K iterations) |
| Encryption | AES-256-CBC for stored credentials |
| Rate limiting | Per-endpoint (login: 10/15min, API: 120/min) |
| Sessions | HttpOnly cookies, 7-day expiry |
| RBAC | Owner + 10 managers with permissions |
| Audit | Full action logging |
| License | Ed25519 signed token verification |
### 🎨 Dashboard
| Feature | Description |
|---------|-------------|
| Dark Mode | Full dark theme with system detection |
| RTL | Persian interface with English support |
| PWA | Installable on mobile devices |
| Charts | CPU/RAM and ping history visualization |
| Pagination | Search, filter, and page through data |
| Branding | Custom logo, colors, product name |
---
## 🏗 Architecture
```
Veltrix/
├── outpanel/ 26 Python modules (backend)
│ ├── app.py HTTP server + router dispatch
│ ├── routes.py 77 API endpoint handlers
│ ├── worker.py Background monitoring + automation
│ ├── sse.py Real-time Server-Sent Events
│ ├── panels.py Multi-panel adapter (x-ui/3x-ui/Marzban)
│ ├── telegram_bot.py Two-way Telegram bot
│ ├── crypto.py AES-256 credential encryption
│ ├── reports.py Reporting + CSV export
│ └── ... Auth, licensing, alerts, i18n, etc.
├── web/ Frontend (vanilla JS SPA)
├── tests/ Unit test suite (pytest)
├── .github/workflows/ CI/CD pipeline
├── scripts/ Auto-installer
├── docker-compose.yml Production deployment
└── docs/ Documentation
```
---
## ⚙️ Tech Stack
| Layer | Technology |
|-------|-----------|
| Backend | Python 3.12+ (stdlib only — zero dependencies) |
| Database | SQLite with WAL mode |
| Frontend | Vanilla JavaScript SPA |
| Styling | Custom CSS with Dark Mode |
| Container | Docker + Docker Compose |
| Deployment | systemd service on Linux |
| CI/CD | GitHub Actions |
| Testing | pytest |
---
## 🚀 Deployment
### One-Line Install (Linux)
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/Veltrix/master/scripts/install-linux.sh)
```
The installer provides:
- 🔍 Auto OS detection (Ubuntu, Debian, CentOS, Fedora, Arch)
- 🐍 Auto Python 3.12 installation if missing
- 🔑 Auto-generated encryption key and API token
- 🛡 systemd service with security hardening
- 📋 Interactive menu (install, update, demo, uninstall)
### Docker
```bash
docker compose up -d
```
### Development
```bash
python -m outpanel.app --host 127.0.0.1 --port 8000
```
---
## 🤖 Telegram Bot
Configure in `.env`:
```env
OUTPANEL_TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
OUTPANEL_TELEGRAM_ALLOWED_CHATS=-1001234567890
```
Commands:
| Command | Description |
|---------|-------------|
| `/status` | Overview of all servers |
| `/servers` | List servers with status |
| `/server ` | Server detail + metrics |
| `/ping ` | Ping server outbounds |
| `/alerts` | Active alerts |
| `/incidents` | Open incidents |
| `/health` | Health scores |
---
## 📜 License
Veltrix is **proprietary commercial software**.
Use, 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**.
| Plan | Limit | Duration |
|------|-------|----------|
| Pro | 20 servers | 6mo / 1yr / Lifetime |
| Enterprise | 60 servers + 60 outbounds | 6mo / 1yr / Lifetime |
---
## 🤝 Support
For licensing, installation support, or commercial inquiries:
- **GitHub:** [iPmartNetwork](https://github.com/iPmartNetwork)
- **Issues:** [Report a bug](https://github.com/iPmartNetwork/Veltrix/issues)
---
Built with precision by iPmartNetwork
© 2026 iPmartNetwork — All rights reserved.