Drag & drop files here
or click to select files
Recent Uploads
No recent uploads
Server Stats
🚀 Gateway API
⚪Total Files: 0
Storage Used: 0 MB
Downloads Served: 0
🌸 Blossom Server
⚪Blobs Stored: 0
Blob Storage: 0 MB
Requests Today: 0
🕸️ DHT Node
⚪Network Peers: 0
Torrents Seeding: 0
Announces Today: 0
📡 BitTorrent Tracker
⚪Active Torrents: 0
Connected Peers: 0
Seeders/Leechers: 0/0
System Information
My Files Dashboard
No files uploaded yet.
⚡ BitTorrent Gateway
Comprehensive Unified Content Distribution System
What This Platform Does
The BitTorrent Gateway is a comprehensive unified content distribution system that seamlessly integrates BitTorrent protocol, WebSeed technology, DHT peer discovery, and Nostr announcements. It provides intelligent content distribution by automatically selecting the optimal delivery method:
Stored as blobs for instant access and immediate availability
Automatically chunked into 2MB pieces with torrent + DHT distribution
How It Works
📡 P2P Coordination
The system features a sophisticated P2P coordinator that manages all networking components, providing unified peer discovery, smart peer ranking, load balancing, and health monitoring across tracker, DHT, and WebSeed sources.
🎯 Built-in BitTorrent Tracker
Includes a full BitTorrent tracker with advanced features:
- Client Compatibility: Optimized for qBittorrent, Transmission, WebTorrent, Deluge, uTorrent
- Abuse Prevention: Advanced detection and rate limiting systems
- Geographic Optimization: Proximity-based peer selection for faster transfers
🔄 WebSeed Implementation (BEP-19)
Advanced WebSeed features for guaranteed availability:
- LRU Caching: Intelligent piece caching with configurable size limits
- Concurrent Optimization: Prevents duplicate loads, manages request limits
- Standards Compliant: Full BEP-19 specification support
🌊 File Processing Pipeline
File received, SHA-256 hash calculated, size analysis determines storage strategy
Small files stored as blobs, large files chunked and torrents created
Content announced to DHT network and Nostr relays for discovery
Content immediately available via WebSeed, P2P peers join over time
Key Features
Intelligent Content Distribution
Automatic selection between blob storage and BitTorrent based on file size, with WebSeed fallback ensuring 100% availability
Multi-Protocol Support
Full BitTorrent protocol, WebSeed (BEP-19), DHT, and Nostr integration for comprehensive P2P networking
Production-Ready Security
Multi-layer rate limiting, advanced abuse detection, input sanitization, and comprehensive security headers
Comprehensive Monitoring
Real-time P2P health monitoring with 0-100 scoring system, performance metrics, and automatic alerting
BitTorrent Client Compatibility
Optimized for popular clients with client-specific adjustments and proper announce intervals
Smart Caching & Optimization
LRU caching system, concurrent processing, geographic peer selection, and connection pooling
System Architecture
🚀 Gateway Server (Port 9877)
Main API server with WebSeed implementation, smart proxy for chunked content reassembly, advanced LRU caching system, and comprehensive security middleware.
🌸 Blossom Server (Port 8082)
Content-addressed blob storage with Nostr protocol compatibility, SHA-256 addressing, and direct storage for files under 100MB.
🕸️ DHT Node (Port 6883)
Full Kademlia DHT implementation with bootstrap connectivity to major networks, automatic torrent announcement, and peer discovery.
📡 Built-in BitTorrent Tracker
Full announce/scrape protocol support, client compatibility optimizations, abuse detection, and peer management with geographic proximity selection.
🎯 P2P Coordinator
Unified management of all P2P components, smart peer ranking algorithm, load balancing across sources, and comprehensive health monitoring.
API Reference
Core API Endpoints
/api/upload
Upload files with intelligent storage routing
/api/download/{hash}
Download files by hash (range requests supported)
/api/torrent/{hash}
Get .torrent file for BitTorrent clients
/api/stats
Overall system statistics
/api/p2p/stats
Detailed P2P statistics
/api/health
Component health status
WebSeed & P2P Endpoints
/api/webseed/{hash}
WebSeed endpoint for BitTorrent clients (BEP-19)
/api/webseed/health
WebSeed health check and cache statistics
/api/diagnostics
Comprehensive system diagnostics
WebSeed Features:
- ✅ BEP-19 compliant WebSeed implementation
- ✅ Advanced LRU piece caching
- ✅ Concurrent request optimization
- ✅ Client-specific optimizations
- ✅ Range request support
Blossom Protocol Endpoints
/upload
Upload blob to Blossom server
/{hash}
Download blob by SHA-256 hash
/info
Server information and capabilities
BitTorrent Tracker Endpoints
/announce
BitTorrent announce endpoint for peer discovery
/scrape
BitTorrent scrape endpoint for torrent statistics
Tracker Features:
- ✅ Built-in tracker eliminates external dependencies
- ✅ Always includes gateway as WebSeed peer
- ✅ Supports both compact and dictionary peer formats
- ✅ Automatic peer cleanup after 45 minutes
- ✅ Full BitTorrent protocol compliance
Technical Implementation
Intelligent Storage Strategy
Files under 100MB stored as blobs for immediate access. Larger files automatically chunked into 2MB pieces with BitTorrent-compatible structure for parallel transfers.
Advanced P2P Coordination
Sophisticated peer ranking algorithm considering geographic proximity (30%), source reliability (25%), and historical performance (20%) for optimal peer selection.
Production-Grade Performance
LRU piece caching, concurrent request handling, connection pooling, and comprehensive health monitoring with automatic alerting systems.
Multi-Client Optimization
Built-in tracker with client detection and specific optimizations for qBittorrent, Transmission, WebTorrent, and other popular BitTorrent clients.