Network Testing & Proxy Management, In One Gateway.
A FastAPI-based gateway service with web panel interface for network testing and proxy management.
Launch Web PanelWhat SpiderTest Does
SpiderTest is a Python web application that provides a gateway service with an integrated web panel. The application focuses on network connectivity testing and proxy management, featuring MTProxy integration and real-time monitoring capabilities. It also includes built-in QR code generation for easy configuration sharing and a Cloudflare Worker for additional proxy functionality.
Built on FastAPI with Uvicorn ASGI server, SpiderTest uses Python 3.13 with async/await support, HTTPX with HTTP/2 for outbound requests, WebSockets for live communication, and PIL/Pillow for QR code generation — all containerized with Docker for consistent deployment.
# Main application structure app = FastAPI(title="Spider Gateway") # Panel runs on fixed port 8080 PANEL_PORT = 8080
Key Features
Everything you need for network testing, proxy management, and real-time observability — all behind a clean web panel.
Web Panel Interface
Static HTML pages for login, subscription management, and monitoring — all served directly from the gateway on port 8080.
MTProxy Integration
Native MTProtocol support for proxy management. Builds and integrates Telegram MTProxy for secure, encrypted connections.
Real-Time Monitoring
WebSocket support for live updates and monitoring. Track connections, gateway status, and network activity as it happens.
The Web Panel
Access the full gateway interface at http://localhost:8080 after starting the service. The panel exposes port 8080 for the web interface and port 443 for secure proxy connections.
- Backend: FastAPI with Uvicorn ASGI server
- Python 3.13 with async/await support
- HTTP Client: HTTPX with HTTP/2 support
- Real-time: WebSockets for live communication
- Image Processing: PIL/Pillow for QR code generation
- Container: Docker with multi-stage build
data/cf_subnets.txt— Cloudflare subnet rangesdata/endpoint.txt— Service endpointsdata/sni-list.txt&sni_reality.txt— SNI configurations for testing
$ docker run -p 8080:8080 -p 443:443 spidertest
$ uvicorn main:app --host 0.0.0.0 --port 8080
● Application startup complete.
Ready to route your traffic?
Deploy the gateway, fire up the web panel, and start monitoring your network — all in minutes.
Launch Web PanelSpiderTest