Skip to content

Releases: rmunate/HTTP-Proxy-Server

v3.0.0

Choose a tag to compare

@rmunate rmunate released this 21 Jan 03:05
HTTP Proxy Logo

HTTP Proxy Server

Your secure, flexible and professional gateway for managing HTTP/HTTPS traffic!

πŸ“‹ Overview

HTTP Proxy Server is an advanced solution to manage, audit, and control HTTP/HTTPS traffic, ideal for companies and developers. You can run it as a Windows service or as a Python script.

Main features:

  • πŸ”’ Persistent and isolated sessions for each client
  • ⚑ Full RESTful API: login, proxy, session management, headers and cookies
  • πŸ› οΈ Flexible configuration via .env file or environment variables
  • πŸ“‘ Detailed activity logs
  • 🧩 Interactive documentation (Swagger UI)

πŸš€ How to run the server?

πŸ–₯️ As an executable (Windows)

  1. Place HttpProxyServer.exe in the desired folder and run:
    HttpProxyServer.exe
    The process runs in the background, with no visible console.

🐍 As a Python script (development)

  1. Clone the repository and enter the folder:
    git clone <repo_url>
    cd http-proxy-server
  2. Create a virtual environment and install dependencies:
    python -m venv venv
    venv\Scripts\activate
    pip install -r requirements.txt
  3. Run the server:
    python main.py

βš™οΈ Configuration

Configuration is flexible and follows this priority:

  1. .env file (in the same folder as the executable/script)
  2. Environment variables
  3. Default values

Example .env:

SERVER_HOST=0.0.0.0
SERVER_PORT=8000
LOG_LEVEL=info
ACCESS_LOG=false
RELOAD=false
WORKERS=1
SESSION_TIMEOUT=600
CLEANUP_INTERVAL=300

Equivalent environment variables:

set SERVER_HOST=0.0.0.0
set SERVER_PORT=9000
set LOG_LEVEL=debug
set SESSION_TIMEOUT=1200
set CLEANUP_INTERVAL=600
set ACCESS_LOG=true

🌐 Main endpoints and use cases

Note: After creating a session, you must send the X-Session-ID header in all requests.

Health Check

GET /health-check β€” Checks server and connectivity status.

Create session

POST /subscribe β€” Creates a unique session for the client.
Response:

{
  "status": "OK",
  "session": { "session_id": "..." }
}

Delete session

POST /unsubscribe β€” Deletes the session and clears cookies/headers.

Set custom headers

POST /set-headers β€” Defines HTTP headers for the session.

{
  "Authorization": "Bearer token123",
  "X-Custom-Header": "CustomValue"
}

Get current headers

POST /get-headers β€” Returns the configured headers.

Get current cookies

POST /get-cookies β€” Returns the session's active cookies.

Full session info

POST /get-session-info

HTTP/HTTPS proxy requests

POST /forward β€” Forwards any HTTP/HTTPS request using the active session.

{
  "url": "https://api.company.com/data",
  "method": "GET",
  "headers": { "Accept": "application/json", "X-Session-ID": "abc123" }
}

File download

POST /dowwnload β€” Downloads binary files while maintaining session and authentication.

{
  "url": "https://files.company.com/download/file.zip",
  "method": "GET"
}

πŸ“ Logs

  • All events are logged in HttpProxyServer.log.
  • Levels: debug, info, warning, error.
  • Example:
    2026-01-15 20:49:00,123 [INFO] __main__ - Application initialized successfully
    2026-01-15 20:49:01,456 [INFO] __main__ - Starting service health check
    

πŸ›‘ How to stop the server?

  • Task Manager: Ctrl+Shift+Esc β†’ find HttpProxyServer.exe β†’ end process
  • Command line: taskkill /f /im HttpProxyServer.exe
  • PowerShell: Get-Process -Name "HttpProxyServer" | Stop-Process -Force

πŸŒ€ Typical workflow example

  1. Create session: POST /subscribe
  2. Login to external system using /forward:
    curl -X POST "http://localhost:8000/forward" \
      -H "Content-Type: application/json" \
      -d '{
        "url": "https://system.company.com/login",
        "method": "POST",
        "data": {
          "username": "my_user",
          "password": "my_password"
        },
        "headers": { "Content-Type": "application/x-www-form-urlencoded" }
      }'
  3. Make authenticated requests: POST /forward
  4. Download files: POST /dowwnload
  5. Set custom headers: POST /set-headers
  6. Logout: POST /unsubscribe

πŸ› οΈ Troubleshooting

  • Port in use: Change the port in .env or stop the existing process.
  • Permissions: Run as administrator or use ports >1024.
  • No internet: Check network, corporate proxy, or firewall.

πŸ” Security

  • HTTPS support, robust validation, audit logging, security headers, configurable timeouts, and more.

πŸ“š Interactive documentation


Developer: Raul Mauricio UΓ±ate Castro
Version: 3.0.0
Date: January 20, 2026

v2.4.0

Choose a tag to compare

@rmunate rmunate released this 17 Jan 00:50

πŸš€ 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 .env file support
  • Flexible Deployment: Can run on any port, any interface
  • Production Ready: Optimized for Windows Server environments

πŸš€ Quick Start

  1. Download HttpProxyServer.exe
  2. Run the executable (no installation required)
  3. Access documentation at http://localhost:5003/docs
  4. 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 /docs when server is running
  • Health Check: Monitor service status via /health endpoint
  • 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)

v2.3.1

Choose a tag to compare

@rmunate rmunate released this 16 Jan 14:33

πŸš€ 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
/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 .env file support
  • Flexible Deployment: Can run on any port, any interface
  • Production Ready: Optimized for Windows Server environments

πŸš€ Quick Start

  1. Download HttpProxyServer.exe
  2. Run the executable (no installation required)
  3. Access documentation at http://localhost:5003/docs
  4. 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

πŸ”„ Migration from v1.x

This is a complete rewrite with:

  • Improved session management
  • Enhanced error handling
  • Better logging system
  • Modern FastAPI framework
  • Comprehensive input validation
  • Windows service compatibility

πŸ“ž Support & Documentation

  • Full Documentation: Available at /docs when server is running
  • Health Check: Monitor service status via /health endpoint
  • 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)

v2.3.0

Choose a tag to compare

@rmunate rmunate released this 16 Jan 14:09

πŸš€ 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
/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 .env file support
  • Flexible Deployment: Can run on any port, any interface
  • Production Ready: Optimized for Windows Server environments

πŸš€ Quick Start

  1. Download HttpProxyServer.exe
  2. Run the executable (no installation required)
  3. Access documentation at http://localhost:5003/docs
  4. 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

πŸ”„ Migration from v1.x

This is a complete rewrite with:

  • Improved session management
  • Enhanced error handling
  • Better logging system
  • Modern FastAPI framework
  • Comprehensive input validation
  • Windows service compatibility

πŸ“ž Support & Documentation

  • Full Documentation: Available at /docs when server is running
  • Health Check: Monitor service status via /health endpoint
  • 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)

πŸ†• New: Set Custom Headers

v2.2.0

Choose a tag to compare

@rmunate rmunate released this 16 Jan 13:18

πŸš€ 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
/set-headers POST Set custom headers for all session requests
/docs GET Interactive Swagger API documentation

πŸ”§ Configuration Options

  • Environment Variables: SERVER_HOST, SERVER_PORT, LOG_LEVEL
  • Configuration File: Optional .env file support
  • Flexible Deployment: Can run on any port, any interface
  • Production Ready: Optimized for Windows Server environments

πŸš€ Quick Start

  1. Download HttpProxyServer.exe
  2. Run the executable (no installation required)
  3. Access documentation at http://localhost:5003/docs
  4. 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

πŸ”„ Migration from v1.x

This is a complete rewrite with:

  • Improved session management
  • Enhanced error handling
  • Better logging system
  • Modern FastAPI framework
  • Comprehensive input validation
  • Windows service compatibility

πŸ“ž Support & Documentation

  • Full Documentation: Available at /docs when server is running
  • Health Check: Monitor service status via /health endpoint
  • 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)

πŸ†• New: Set Custom Headers

  • Endpoint: /set-headers
  • Purpose: Define custom HTTP headers for all future requests in the session.
  • Example:
    POST /set-headers
    {
      "Authorization": "Bearer token123",
      "X-Custom-Header": "CustomValue"
    }
  • Use Case: Add authentication tokens or corporate headers globally.

Perfect for: Enterprise integration, API bridging, authenticated web scraping, development proxying, and legacy system modernization.

v2.1.0

Choose a tag to compare

@rmunate rmunate released this 16 Jan 12:01

πŸš€ 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
/docs GET Interactive Swagger API documentation

πŸ”§ Configuration Options

  • Environment Variables: SERVER_HOST, SERVER_PORT, LOG_LEVEL
  • Configuration File: Optional .env file support
  • Flexible Deployment: Can run on any port, any interface
  • Production Ready: Optimized for Windows Server environments

πŸš€ Quick Start

  1. Download HttpProxyServer.exe
  2. Run the executable (no installation required)
  3. Access documentation at http://localhost:5003/docs
  4. 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

πŸ”„ Migration from v1.x

This is a complete rewrite with:

  • Improved session management
  • Enhanced error handling
  • Better logging system
  • Modern FastAPI framework
  • Comprehensive input validation
  • Windows service compatibility

πŸ“ž Support & Documentation

  • Full Documentation: Available at /docs when server is running
  • Health Check: Monitor service status via /health endpoint
  • 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)

Perfect for: Enterprise integration, API bridging, authenticated web scraping, development proxying, and legacy system modernization.

v2.0.0

Choose a tag to compare

@rmunate rmunate released this 16 Jan 11:04

HTTP Proxy Server - Windows Executable

πŸ“‹ Description

This project provides an HTTP proxy server compiled as a Windows executable that runs completely in the background with no visible console.

✨ Features

  • βœ… Standalone executable: No Python installation required
  • βœ… No visible console: Runs as a background service
  • βœ… Persistent sessions: Automatically maintains cookies and authentication
  • βœ… Full REST API: Endpoints for login, proxy, and health check
  • βœ… Integrated documentation: Swagger UI available at /docs
  • βœ… Detailed logging: Automatic logs in .log file
  • βœ… Optimized size: Only 11.4 MB including all dependencies

πŸš€ Quick Start

Option 1: Run directly

# Run the server (no console)
HttpProxyServer.exe

🌐 Available Endpoints

πŸ“Š Health Check

GET http://localhost:5003/health

πŸ” Login / Authentication

POST http://localhost:5003/login
Content-Type: application/json

{
  "url": "https://sistema.empresa.com/login",
  "method": "POST",
  "data": {
    "username": "user",
    "password": "password"
  },
  "headers": {
    "Content-Type": "application/x-www-form-urlencoded"
  }
}

πŸ”„ Proxy / Request Forwarding

POST http://localhost:5003/forward
Content-Type: application/json

{
  "url": "https://api.empresa.com/datos",
  "method": "GET",
  "headers": {
    "Accept": "application/json"
  }
}

πŸ“š Interactive Documentation

Once the server is running, access:

πŸ”§ Advanced Configuration

Environment Variables

You can configure the server using environment variables:

# Set host and port
set SERVER_HOST=0.0.0.0
set SERVER_PORT=8080

# Set logging level
set LOG_LEVEL=debug

# Enable HTTP access logs
set ACCESS_LOG=true

# Run server
HttpProxyServer.exe

Configuration File

Create a .env file in the same folder as the executable:

SERVER_HOST=0.0.0.0
SERVER_PORT=5003
LOG_LEVEL=info
ACCESS_LOG=false
RELOAD=false
WORKERS=1

πŸ“ Logs and Debugging

Log Location

  • Log file: HttpProxyServer.log (same folder as the .exe)

Log Levels

  • debug: Very detailed information
  • info: General information (default)
  • warning: Only warnings and errors
  • error: Errors only

Log Example

2026-01-15 20:49:00,123 [INFO] __main__ - FastAPI application initialized successfully
2026-01-15 20:49:00,124 [INFO] __main__ - HTTP session configured with User-Agent: Mozilla/5.0...
2026-01-15 20:49:01,456 [INFO] __main__ - Starting service health check
2026-01-15 20:49:01,789 [INFO] __main__ - Health check successful - Internet available

Stopping the Server

  1. Task Manager:

    • Ctrl + Shift + Esc
    • Find "HttpProxyServer.exe"
    • End process
  2. Command line:

    taskkill /f /im HttpProxyServer.exe
  3. PowerShell:

    Get-Process -Name "HttpProxyServer" | Stop-Process -Force

Check if Running

# Check process
tasklist | findstr HttpProxyServer

# Check connectivity
curl http://localhost:5003/health

πŸ”„ Typical Workflow

1. Authentication

curl -X POST "http://localhost:5003/login" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://sistema.empresa.com/login",
    "method": "POST",
    "data": {
      "username": "my_user",
      "password": "my_password"
    }
  }'

2. Make Authenticated Requests

curl -X POST "http://localhost:5003/forward" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://sistema.empresa.com/api/datos",
    "method": "GET"
  }'

🚨 Troubleshooting

Port Already in Use

System error when starting server: [WinError 10048]
Only one usage of each socket address (protocol/network address/port) is normally permitted

Solution:

  1. Change the port: set SERVER_PORT=8080
  2. Or terminate the existing process: taskkill /f /im HttpProxyServer.exe

Permission Error

System error when starting server: [WinError 5] Access is denied

Solution:

  1. Run as Administrator
  2. Or use a port above 1024

No Internet Connectivity

{
  "status": "Service Unavailable",
  "internet": false,
  "detail": "Timeout connecting to google.com"
}

Solution:

  1. Check your internet connection
  2. Check corporate proxy configuration
  3. Check firewall

πŸ” Security

  • βœ… SSL/TLS: Full HTTPS support
  • βœ… Input validation: Robust validation with Pydantic V2
  • βœ… Audit logging: Complete record of all operations
  • βœ… Security headers: User-Agent and corporate headers
  • βœ… Timeouts: Configurable to prevent DoS attacks

πŸ“ž Support

For issues or questions:

  1. Check the logs in HttpProxyServer.log
  2. Review the documentation at /docs
  3. Contact the developer: Raul Mauricio UΓ±ate Castro

πŸ“ Developing New Features

  1. Clone the repository
git clone .....
cd http-proxy-server
  1. Create a virtual environment and install dependencies
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
  1. Modify the code in server.py

Version: 2.0.0
Date: January 15, 2026
Compatible with: Windows 10/11, Server 2016+