VodiWalker Panel - FastAPI Proxy & Telegram Bot Management

Overview

VodiWalker Panel is a comprehensive proxy management system that combines web administration, Telegram bot controls, and sales capabilities into a unified platform. Built for Railway deployment with persistent storage support.

From traffic control and bandwidth management to real-time system monitoring, every feature is designed with reliability and developer experience in mind. The entire stack runs on FastAPI with async I/O, ensuring high performance under load.

Built for Railway deployment — mount a volume, set your environment variables, and you're live in minutes.

Key Features

Web Panel

FastAPI-based administration interface with a clean, responsive design for managing all proxy operations from your browser.

Telegram Bot Integration

Remote management via Telegram — control proxies, check status, and manage users directly from your messaging app.

Proxy Services

Multiple relay types including TCP, VLESS, and HTTP — flexible routing for diverse network topologies.

Sales System

Optional sales functionality with user plans, billing, and automated provisioning — monetize your proxy service.

Speed Limiting

Traffic control and bandwidth management — set per-user limits and ensure fair resource distribution across your network.

Railway Ready

Optimized for Railway platform deployment with zero-config Docker support and environment-based configuration.

Persistent Storage

Data persistence with volume mounting — your state and plans survive restarts and redeployments.

Real-time Monitoring

System resource monitoring with psutil — track CPU, memory, and network usage at a glance.

Tech Stack & Architecture

Modern, async-first stack built for performance and reliability on Railway.

FastAPI 0.104.1 Uvicorn HTTPX + HTTP/2 WebSockets aiofiles Cryptography psutil Docker Railway

Project Architecture

├── main.py           # FastAPI application core
├── pages.py          # Web interface pages
├── telegram_bot.py   # Telegram bot handlers
├── sales.py          # Sales and billing system
├── speed_limit.py    # Traffic control
├── relay_*.py        # Proxy relay services
└── data/             # Persistent storage
    ├── vodiwalker_state.tmp
    └── vodiwalker_plans.json

Quick Start

Copy env.example to configure environment variables
Install dependencies: pip install -r requirements.txt
Run: python main.py
Access web panel on configured port (default: 8000)

Configuration

Set VODIWALKER_SALES_ENABLED=1 to enable sales features
Configure Railway volume mounting via RAILWAY_VOLUME_MOUNT_PATH
Telegram bot token and other settings via environment variables

One‑click deploy on Railway

VodiWalker Panel is optimized for Railway with persistent storage support via volume mounting. Set your environment variables, attach a volume, and you're ready to go.

Deploy on Railway