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 <(curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/Veltrix/master/scripts/install-linux.sh)

Or manually:

git clone https://github.com/iPmartNetwork/Veltrix.git
cd Veltrix
sudo bash scripts/install-linux.sh

Or with Docker:

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 <(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

docker compose up -d

Development

python -m outpanel.app --host 127.0.0.1 --port 8000

---

🤖 Telegram Bot

Configure in .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 <id>	Server detail + metrics
/ping <id>	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
• Issues: Report a bug

---

_{Built with precision by iPmartNetwork
© 2026 iPmartNetwork — All rights reserved.}