v3-st

A high-performance HTTP proxy server built with FastAPI that provides tunneling and relay capabilities.

Overview

v3-st (OXNET v2.0) is an asynchronous proxy server that handles HTTP requests, WebSocket tunneling, and session management. The system is designed for high concurrency with connection pooling and speed limiting capabilities.

Key Features

• HTTP Proxy & Tunneling: Core proxy functionality with WebSocket relay support
• Session Management: Token-based authentication with configurable TTL
• Speed Limiting: Built-in traffic throttling mechanisms
• High Concurrency: Async architecture with connection pooling (500+ connections)
• CORS Support: Configurable cross-origin resource sharing
• Modular Design: Separated concerns across protocols, state, and routing

Tech Stack

• Framework: FastAPI with Uvicorn ASGI server
• Async Runtime: uvloop for enhanced performance
• HTTP Client: httpx for outbound requests
• WebSockets: Native FastAPI WebSocket support

Architecture

main.py          # Main application entry point
relay_ws.py      # WebSocket tunneling logic
xhttp_oxnet.py   # HTTP routing and proxy handlers
protocols.py     # Protocol definitions
state.py         # Global state management
speed_limit.py   # Traffic throttling
pages.py         # Web interface components

Quick Start

# Install dependencies
pip install -r requirements.txt

# Run the server
python main.py

The server provides both API endpoints and a web dashboard for administration, with session-based authentication protecting admin functions while keeping public endpoints open.