v2.4.0
π HTTP Proxy Server - Release Notes
Version 2.0.0 - Windows Executable
Release Date: January 15, 2026
π What is HTTP Proxy Server?
A standalone Windows executable that provides an HTTP proxy server with persistent session management, designed to act as a bridge between applications and external systems requiring authentication.
π― Key Features
- π’ Enterprise Ready: Designed for corporate environments with proxy support
- π Session Management: Automatic cookie and authentication handling
- π¦ Zero Dependencies: Single 11.4MB executable, no Python installation required
- π REST API: Complete FastAPI-based endpoints with Swagger documentation
- π Health Monitoring: Built-in connectivity and service health checks
- π Audit Logging: Comprehensive request/response logging for compliance
π‘οΈ Security & Reliability
- β SSL/TLS Support: Full HTTPS compatibility
- β Input Validation: Robust Pydantic V2 validation
- β Background Service: Runs silently without console window
- β Timeout Protection: Configurable timeouts prevent hanging requests
- β Error Handling: Graceful error management with detailed logging
π API Endpoints
| Endpoint | Method | Purpose |
|---|---|---|
/health |
GET | Service and connectivity health check |
/login |
POST | Authentication and session initialization |
/logout |
POST | Session termination and cleanup |
/forward |
POST | HTTP request proxy with session persistence |
/dowwnload |
POST | File download proxy (direct binary stream) |
/set-headers |
POST | Set custom headers for all session requests |
/get-headers |
POST | Get all current session headers |
/get-cookies |
POST | Get all current session cookies |
/get-session-info |
POST | Get detailed session information |
/docs |
GET | Interactive Swagger API documentation |
π§ Configuration Options
- Environment Variables:
SERVER_HOST,SERVER_PORT,LOG_LEVEL - Configuration File: Optional
.envfile support - Flexible Deployment: Can run on any port, any interface
- Production Ready: Optimized for Windows Server environments
π Quick Start
- Download
HttpProxyServer.exe - Run the executable (no installation required)
- Access documentation at
http://localhost:5003/docs - Use REST API for authentication and proxying
πΌ Use Cases
- Web Scraping: Maintain authenticated sessions across requests
- API Integration: Bridge between systems requiring different authentication
- Legacy System Access: Modern REST interface for older authentication systems
- Development & Testing: Local proxy for development environments
- Corporate Applications: Navigate through corporate proxy requirements
π What's New in v2.0.0
- Improved session management
- Enhanced error handling
- Better logging system
- Modern FastAPI framework
- Comprehensive input validation
- Windows service compatibility
- New endpoint
/dowwnload: Download files directly as binary streams, ideal for documents, images, and large files.
Example usage:
POST http://localhost:5003/dowwnload
Content-Type: application/json
{
"url": "https://files.company.com/download/file.zip",
"method": "GET"
}Returns the file as a direct download (streaming response).
π Support & Documentation
- Full Documentation: Available at
/docswhen server is running - Health Check: Monitor service status via
/healthendpoint - Logging: Automatic logs in
HttpProxyServer.log - Author: Raul Mauricio UΓ±ate Castro
π·οΈ Technical Specifications
- Framework: FastAPI 0.100+
- Platform: Windows 10/11, Windows Server 2016+
- Size: 11.4 MB (includes all dependencies)
- Memory: ~50MB runtime footprint
- Language: Python 3.12 (compiled to native executable)