How jatixs/tgbotvpscp works
VPS Manager is a Telegram- and web-operated control plane for a master server and remote VPS nodes. Administrators configure nodes, then inspect live status and use Telegram or the dashboard to manage infrastructure; the node agent reports to the master. The graph also preserves documented service, backup/update, alerting, security, and VPN-management capabilities. Several feature modules are listed in the repository but were not excerpted, so their internal call paths are not inferred; dashed edges mark documented but unverified connections.
Main entry points: bot.py Telegram bot · app.py Web app · api_nodes.py Node API · streaming.py Live streams
Components 24
User interfaces
- Telegram bot
bot.py - Web app
core/web/app.py - Dashboard views
core/web/views.py - Dashboard client
core/static/js/dashboard.js
Control plane
- Node API
core/web/api_nodes.py - Live streams
core/web/streaming.py - Background tasks
core/tasks.py
Node operations
- Node management
modules/nodes.py - Service manager
modules/services.py - Traffic monitor
modules/traffic.py
Operations features
- Backup manager
modules/backups.py - Updates
modules/update.py - Alerts and notifications
modules/client_alerts.py - VLESS / Xray
modules/vless.py
State and security
- Web authentication
core/web/auth.py - Access control
core/rbac.py - Configuration
core/config.py - Node database
core/nodes_db.py - Database models
core/models.py - Shared runtime state
core/shared_state.py
Other components
- Administrator
- Telegram
- Web user
- Remote node agent
node/node.py
Connections 33
- Administrator → Telegram: uses
- Telegram → Telegram bot: sends commands
- Administrator → Web app: uses
- Web user → Web app: opens dashboard
- Telegram bot → Web app: starts
bot.py - Web app → Dashboard views: registers routes
core/web/app.py - Web app → Node API: registers routes
core/web/app.py - Web app → Live streams: registers routes
core/web/app.py - Web app → Background tasks: starts tasks
core/web/app.py - Dashboard views → Dashboard client: serves dashboard
- Dashboard client → Node API: requests node data
- Dashboard client → Live streams: receives SSE
- Remote node agent → Node API: reports node data
- Node API → Node database: uses node records
core/web/api_nodes.py - Node API → Service manager: uses service operations
core/web/api_nodes.py - Live streams → Node database: reads node state
core/web/streaming.py - Live streams → Service manager: reads service data
core/web/streaming.py - Live streams → Traffic monitor: reads traffic data
core/web/streaming.py - Telegram bot → Node management: dispatches management
modules/nodes.py - Telegram bot → Service manager: dispatches controls
modules/services.py - Telegram bot → Traffic monitor: dispatches monitoring
modules/traffic.py - Telegram bot → Backup manager: offers backups
- Telegram bot → Updates: offers updates
- Telegram bot → Alerts and notifications: delivers alerts
modules/client_alerts.py - Telegram bot → VLESS / Xray: manages VPN panels
- Web app → Web authentication: registers routes
core/web/app.py - Node API → Access control: checks permissions
core/web/api_nodes.py - Node API → Web authentication: uses authentication
core/web/api_nodes.py - Node database → Database models: persists records
core/nodes_db.py - Node database → Configuration: uses database config
core/nodes_db.py - Telegram bot → Configuration: loads settings
bot.py - Telegram bot → Shared runtime state: shares runtime state
bot.py - Background tasks → Shared runtime state: updates runtime state
core/tasks.py