VodiWalker

A FastAPI-based proxy and relay service with Telegram bot integration, designed for Railway deployment.

Key Features

• Multi-protocol support: VLESS relay, HTTP proxy, WebSocket connections
• Telegram bot integration: User management and notifications
• Railway ready: Configured for easy cloud deployment
• Sales system: Optional billing and user management (configurable)
• Speed limiting: Traffic control and bandwidth management
• Persistent state: JSON-based data storage with volume mounting
• CORS enabled: Cross-origin request support

Tech Stack

• Backend: FastAPI 0.104.1, uvicorn
• Networking: httpx with HTTP/2 support, websockets
• Deployment: Railway (with volume persistence)
• Bot: Telegram Bot API
• Security: Cryptography for secure operations

Quick Start

1. Environment Setup:

   cp env.example .env
   # Configure your environment variables
   

2. Install Dependencies:

   pip install -r requirements.txt
   

3. Run Locally:

   python main.py
   

4. Deploy to Railway:

   • Use the included railway.json configuration
   • Set required environment variables
   • Deploy using Railway CLI or GitHub integration

Configuration

• VODIWALKER_SALES_ENABLED: Enable/disable sales system (default: "0")
• PORT: Server port (default: 8000)
• RAILWAY_VOLUME_MOUNT_PATH: Data persistence path
• Additional Telegram and proxy configuration in environment

Project Structure

• main.py: Core FastAPI application (VodiWalker 15.0.0)
• telegram_bot.py: Telegram bot functionality
• relay_vless.py: VLESS protocol relay
• tcp_relay.py: TCP relay implementation
• speed_limit.py: Traffic control
• sales.py: Optional billing system
• data/: Persistent storage directory