pyproxytools 0.4.1__tar.gz → 0.5.1__tar.gz

{pyproxytools-0.4.1 → pyproxytools-0.5.1}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 6C656C65
+Copyright (c) 2025 pyproxytools
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

pyproxytools-0.5.1/MANIFEST.in

@@ -0,0 +1,2 @@
+include pyproxy/monitoring/messages.pot
+recursive-include pyproxy/monitoring/translations *

{pyproxytools-0.4.1/pyproxytools.egg-info → pyproxytools-0.5.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: pyproxytools
-Version: 0.4.1
+Version: 0.5.1
 Summary: Lightweight and fast python web proxy
-Author: 6C656C65
+Author: pyproxytools
 License-Expression: MIT
-Project-URL: Documentation, https://github.com/6C656C65/pyproxy/wiki
-Project-URL: Issue tracker, https://github.com/6C656C65/pyproxy/issues
+Project-URL: Documentation, https://pyproxytools.github.io/pyproxy-docs/
+Project-URL: Issue tracker, https://github.com/pyproxytools/pyproxy/issues
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Internet
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -22,12 +23,13 @@ Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: rich-argparse>=1.7.0
-Requires-Dist: pyOpenSSL>=25.0.0
-Requires-Dist: requests>=2.31.0
-Requires-Dist: Flask>=3.1.0
+Requires-Dist: rich-argparse>=1.7.1
+Requires-Dist: pyOpenSSL>=25.3.0
+Requires-Dist: requests>=2.32.5
+Requires-Dist: Flask>=3.1.2
 Requires-Dist: Flask-HTTPAuth>=4.8.0
-Requires-Dist: psutil>=5.9.8
+Requires-Dist: Flask-Babel>=4.0.0
+Requires-Dist: psutil>=7.1.0
 Requires-Dist: colorlog>=6.9.0
 Dynamic: license-file
 
@@ -39,14 +41,14 @@ Dynamic: license-file
 **pyproxy** is a lightweight, fast, and customizable Python-based web proxy server designed to handle both HTTP and HTTPS traffic efficiently. It can be used for various purposes, including web scraping, traffic monitoring, and content filtering.
 
 <p align="center">
-  <img src="https://img.shields.io/github/license/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/issues/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/issues-closed/6C656C65/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/license/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/issues/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/issues-closed/pyproxytools/pyproxy?style=for-the-badge">
   <br>
-  <img src="https://img.shields.io/github/forks/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/stars/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/commit-activity/w/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/contributors/6C656C65/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/forks/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/stars/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/commit-activity/w/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/contributors/pyproxytools/pyproxy?style=for-the-badge">
   <br>
   <img src="https://img.shields.io/pypi/v/pyproxytools?style=for-the-badge">
   <img src="https://img.shields.io/pypi/pyversions/pyproxytools?style=for-the-badge">
@@ -81,18 +83,24 @@ pip install pyproxytools
 
 ### Install from source
 ```bash
-git clone https://github.com/6C656C65/pyproxy.git
+git clone https://github.com/pyproxytools/pyproxy.git
 cd pyproxy
 pip install -r requirements.txt
 ```
 
 ### Install with Docker
 ```bash
-docker pull ghcr.io/6c656c65/pyproxy:latest
-docker run -d ghcr.io/6c656c65/pyproxy:latest
+docker pull ghcr.io/pyproxytools/pyproxy:latest
+docker run -d ghcr.io/pyproxytools/pyproxy:latest
 ```
 You can use slim images by adding `-slim` to the end of the tags
 
+### Install with Compose
+```bash
+wget https://raw.githubusercontent.com/pyproxytools/pyproxy/main/docker-compose.yml
+docker-compose up -d
+```
+
 ## 🚀 **Usage**
 
 ### Start the proxy
@@ -103,7 +111,7 @@ The proxy will be available at: `0.0.0.0:8080`.
 The access log will be available at `./logs/access.log`.
 
 ## 📚 **Documentation**
-If you encounter any problems, or if you want to use the program in a particular way, I advise you to read the [documentation](https://github.com/6C656C65/pyproxy/wiki).
+If you encounter any problems, or if you want to use the program in a particular way, I advise you to read the [documentation](https://pyproxytools.github.io/pyproxy-docs/).
 
 ## 🔧 **To do**
 
@@ -112,7 +120,7 @@ If you encounter any problems, or if you want to use the program in a particular
 
 ## 🏎️ **Benchmark**
 
-If you're interested in benchmarking the performance of the proxy or comparing request times with and without a proxy, please refer to the [Benchmark README](benchmark/README.md) for detailed instructions on how to run the benchmarking tests and generate reports.
+If you're interested in benchmarking the performance of the proxy or comparing request times with and without a proxy, please refer to the [Benchmark repository](https://github.com/pyproxytools/pyproxy-benchmark) for detailed instructions on how to run the benchmarking tests and generate reports.
 
 ## 📄 **License**
 
@@ -124,12 +132,17 @@ Contributions are welcome and appreciated! If you'd like to improve this project
 
 ## 📦 Deployment with Ansible
 
-If you want to deploy **pyproxy** automatically to remote servers (via source or Docker), an official [Ansible role](https://github.com/6C656C65/pyproxy_ansible) is available:
+If you want to deploy **pyproxy** automatically to remote servers (via source or Docker), an official [Ansible role](https://github.com/pyproxytools/pyproxy-ansible) is available:
 
 * 🔧 Install from source or run as a Docker container
 * 📁 Supports customization of ports, versions, and paths
 * 🚀 Easily integrable into your infrastructure or CI/CD pipelines
 
-👉 Check out the [ansible-role-pyproxy](https://github.com/6C656C65/pyproxy_ansible) repository for more details and usage instructions.
+👉 Check out the [pyproxy-ansible](https://github.com/pyproxytools/pyproxy-ansible) repository for more details and usage instructions.
+
+## 🧩 **Python SDK for Administration and Monitoring**
+
+A dedicated Python SDK is available to interact programmatically with the **pyproxy** administration and monitoring interface: [**pyproxy-sdk-py**](https://github.com/pyproxytools/pyproxy-sdk-py).
+This SDK provides a simple and consistent API to manage your proxy configuration remotely — allowing you to add or delete domains, manage URLs, create and remove clients, and perform other administrative tasks. It is designed to integrate easily into automation scripts, dashboards, or backend systems that need to control and monitor pyproxy instances.
 
 ---

{pyproxytools-0.4.1 → pyproxytools-0.5.1}/README.md

@@ -6,14 +6,14 @@
 **pyproxy** is a lightweight, fast, and customizable Python-based web proxy server designed to handle both HTTP and HTTPS traffic efficiently. It can be used for various purposes, including web scraping, traffic monitoring, and content filtering.
 
 <p align="center">
-  <img src="https://img.shields.io/github/license/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/issues/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/issues-closed/6C656C65/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/license/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/issues/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/issues-closed/pyproxytools/pyproxy?style=for-the-badge">
   <br>
-  <img src="https://img.shields.io/github/forks/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/stars/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/commit-activity/w/6C656C65/pyproxy?style=for-the-badge">
-  <img src="https://img.shields.io/github/contributors/6C656C65/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/forks/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/stars/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/commit-activity/w/pyproxytools/pyproxy?style=for-the-badge">
+  <img src="https://img.shields.io/github/contributors/pyproxytools/pyproxy?style=for-the-badge">
   <br>
   <img src="https://img.shields.io/pypi/v/pyproxytools?style=for-the-badge">
   <img src="https://img.shields.io/pypi/pyversions/pyproxytools?style=for-the-badge">
@@ -48,18 +48,24 @@ pip install pyproxytools
 
 ### Install from source
 ```bash
-git clone https://github.com/6C656C65/pyproxy.git
+git clone https://github.com/pyproxytools/pyproxy.git
 cd pyproxy
 pip install -r requirements.txt
 ```
 
 ### Install with Docker
 ```bash
-docker pull ghcr.io/6c656c65/pyproxy:latest
-docker run -d ghcr.io/6c656c65/pyproxy:latest
+docker pull ghcr.io/pyproxytools/pyproxy:latest
+docker run -d ghcr.io/pyproxytools/pyproxy:latest
 ```
 You can use slim images by adding `-slim` to the end of the tags
 
+### Install with Compose
+```bash
+wget https://raw.githubusercontent.com/pyproxytools/pyproxy/main/docker-compose.yml
+docker-compose up -d
+```
+
 ## 🚀 **Usage**
 
 ### Start the proxy
@@ -70,7 +76,7 @@ The proxy will be available at: `0.0.0.0:8080`.
 The access log will be available at `./logs/access.log`.
 
 ## 📚 **Documentation**
-If you encounter any problems, or if you want to use the program in a particular way, I advise you to read the [documentation](https://github.com/6C656C65/pyproxy/wiki).
+If you encounter any problems, or if you want to use the program in a particular way, I advise you to read the [documentation](https://pyproxytools.github.io/pyproxy-docs/).
 
 ## 🔧 **To do**
 
@@ -79,7 +85,7 @@ If you encounter any problems, or if you want to use the program in a particular
 
 ## 🏎️ **Benchmark**
 
-If you're interested in benchmarking the performance of the proxy or comparing request times with and without a proxy, please refer to the [Benchmark README](benchmark/README.md) for detailed instructions on how to run the benchmarking tests and generate reports.
+If you're interested in benchmarking the performance of the proxy or comparing request times with and without a proxy, please refer to the [Benchmark repository](https://github.com/pyproxytools/pyproxy-benchmark) for detailed instructions on how to run the benchmarking tests and generate reports.
 
 ## 📄 **License**
 
@@ -91,12 +97,17 @@ Contributions are welcome and appreciated! If you'd like to improve this project
 
 ## 📦 Deployment with Ansible
 
-If you want to deploy **pyproxy** automatically to remote servers (via source or Docker), an official [Ansible role](https://github.com/6C656C65/pyproxy_ansible) is available:
+If you want to deploy **pyproxy** automatically to remote servers (via source or Docker), an official [Ansible role](https://github.com/pyproxytools/pyproxy-ansible) is available:
 
 * 🔧 Install from source or run as a Docker container
 * 📁 Supports customization of ports, versions, and paths
 * 🚀 Easily integrable into your infrastructure or CI/CD pipelines
 
-👉 Check out the [ansible-role-pyproxy](https://github.com/6C656C65/pyproxy_ansible) repository for more details and usage instructions.
+👉 Check out the [pyproxy-ansible](https://github.com/pyproxytools/pyproxy-ansible) repository for more details and usage instructions.
+
+## 🧩 **Python SDK for Administration and Monitoring**
+
+A dedicated Python SDK is available to interact programmatically with the **pyproxy** administration and monitoring interface: [**pyproxy-sdk-py**](https://github.com/pyproxytools/pyproxy-sdk-py).
+This SDK provides a simple and consistent API to manage your proxy configuration remotely — allowing you to add or delete domains, manage URLs, create and remove clients, and perform other administrative tasks. It is designed to integrate easily into automation scripts, dashboards, or backend systems that need to control and monitor pyproxy instances.
 
 ---

{pyproxytools-0.4.1 → pyproxytools-0.5.1}/pyproject.toml

@@ -6,7 +6,7 @@ license = "MIT"
 license-files = [
     "LICENSE",
 ]
-authors = [{name = "6C656C65"}]
+authors = [{name = "pyproxytools"}]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
@@ -17,6 +17,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Internet",
     "Topic :: Software Development :: Libraries",
     "Topic :: Software Development :: Libraries :: Python Modules",
@@ -26,8 +27,8 @@ classifiers = [
 dynamic = ["version", "dependencies"]
 
 [project.urls]
-Documentation = "https://github.com/6C656C65/pyproxy/wiki"
-"Issue tracker" = "https://github.com/6C656C65/pyproxy/issues"
+Documentation = "https://pyproxytools.github.io/pyproxy-docs/"
+"Issue tracker" = "https://github.com/pyproxytools/pyproxy/issues"
 
 [tool.setuptools.packages]
 find = {}
@@ -35,6 +36,27 @@ find = {}
 [tool.setuptools.dynamic]
 dependencies = { file = "requirements.txt" }
 
+[tool.ruff]
+line-length = 100
+src = ["pyproxy", "tests"]
+exclude = [
+    ".git",
+    "__pycache__",
+    "build",
+    "dist",
+    "venv",
+    "setup.py",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "S"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
+skip-magic-trailing-comma = false
+
 [project.scripts]
 pyproxy = "pyproxy.pyproxy:main"
 

{pyproxytools-0.4.1 → pyproxytools-0.5.1}/pyproxy/__init__.py

@@ -5,7 +5,7 @@ that holds the current version number of the application.
 
 import os
 
-__version__ = "0.4.1"
+__version__ = "0.5.1"
 
 if os.path.isdir("pyproxy/monitoring"):
     __slim__ = False

pyproxytools-0.5.1/pyproxy/handlers/client.py

@@ -0,0 +1,114 @@
+"""
+pyproxy.handlers.client.py
+
+This module defines the ProxyHandlers class used by the proxy server to process
+HTTP and HTTPS client connections. It handles request forwarding, blocking, shortcut
+redirection, custom headers, and optional SSL inspection.
+"""
+
+import threading
+
+from pyproxy.handlers.http import HttpHandler
+from pyproxy.handlers.https import HttpsHandler
+
+
+class ProxyHandlers:
+    """
+    ProxyHandlers manages client connections for a proxy server, handling both HTTP
+    and HTTPS requests. It processes request forwarding, blocking, SSL inspection,
+    and custom headers based on configuration settings. This class is responsible
+    for dispatching the correct handler for HTTP or HTTPS requests and managing
+    connection-related operations.
+    """
+
+    def __init__(
+        self,
+        html_403,
+        logger_config,
+        filter_config,
+        ssl_config,
+        filter_queue,
+        filter_result_queue,
+        shortcuts_queue,
+        shortcuts_result_queue,
+        cancel_inspect_queue,
+        cancel_inspect_result_queue,
+        custom_header_queue,
+        custom_header_result_queue,
+        console_logger,
+        shortcuts,
+        custom_header,
+        active_connections,
+        proxy_config,
+    ):
+        self.html_403 = html_403
+        self.logger_config = logger_config
+        self.filter_config = filter_config
+        self.ssl_config = ssl_config
+        self.filter_queue = filter_queue
+        self.filter_result_queue = filter_result_queue
+        self.shortcuts_queue = shortcuts_queue
+        self.shortcuts_result_queue = shortcuts_result_queue
+        self.cancel_inspect_queue = cancel_inspect_queue
+        self.cancel_inspect_result_queue = cancel_inspect_result_queue
+        self.custom_header_queue = custom_header_queue
+        self.custom_header_result_queue = custom_header_result_queue
+        self.console_logger = console_logger
+        self.config_shortcuts = shortcuts
+        self.config_custom_header = custom_header
+        self.proxy_config = proxy_config
+        self.active_connections = active_connections
+
+    def _create_handler(self, handler_class, **extra_kwargs):
+        """
+        Factory to create handler instance with shared common parameters.
+        """
+        params = dict(
+            html_403=self.html_403,
+            logger_config=self.logger_config,
+            filter_config=self.filter_config,
+            filter_queue=self.filter_queue,
+            filter_result_queue=self.filter_result_queue,
+            shortcuts_queue=self.shortcuts_queue,
+            shortcuts_result_queue=self.shortcuts_result_queue,
+            custom_header_queue=self.custom_header_queue,
+            custom_header_result_queue=self.custom_header_result_queue,
+            console_logger=self.console_logger,
+            shortcuts=self.config_shortcuts,
+            custom_header=self.config_custom_header,
+            proxy_config=self.proxy_config,
+            active_connections=self.active_connections,
+        )
+        params.update(extra_kwargs)
+        return handler_class(**params)
+
+    def handle_client(self, client_socket):
+        """
+        Handles an incoming client connection by processing the request and forwarding
+        it to the appropriate handler based on whether the request is HTTP or HTTPS.
+
+        Args:
+            client_socket (socket): The socket object for the client connection.
+        """
+        try:
+            client_socket.settimeout(10)
+            request = client_socket.recv(4096)
+
+            if not request:
+                return
+
+            first_line = request.decode(errors="ignore").split("\n")[0]
+            if first_line.startswith("CONNECT"):
+                https_handler = self._create_handler(
+                    HttpsHandler,
+                    ssl_config=self.ssl_config,
+                    cancel_inspect_queue=self.cancel_inspect_queue,
+                    cancel_inspect_result_queue=self.cancel_inspect_result_queue,
+                )
+                https_handler.handle_https_connection(client_socket, first_line)
+            else:
+                http_handler = self._create_handler(HttpHandler)
+                http_handler.handle_http_request(client_socket, request)
+        finally:
+            client_socket.close()
+            self.active_connections.pop(threading.get_ident(), None)

pyproxytools-0.5.1/pyproxy/handlers/http.py

@@ -0,0 +1,257 @@
+"""
+pyproxy.handlers.http.py
+
+This module defines the HttpHandler class used by the proxy server to process
+HTTP client connections. It handles request forwarding, blocking, and custom headers.
+"""
+
+import socket
+import os
+import threading
+from urllib.parse import urlparse
+
+from pyproxy.utils.http_req import extract_headers
+
+
+class HttpHandler:
+    """
+    HttpHandler manages client HTTP connections for a proxy server,
+    handling request forwarding, filtering, blocking, and custom header modification
+    based on configuration settings.
+    """
+
+    def __init__(
+        self,
+        html_403,
+        logger_config,
+        filter_config,
+        filter_queue,
+        filter_result_queue,
+        shortcuts_queue,
+        shortcuts_result_queue,
+        custom_header_queue,
+        custom_header_result_queue,
+        console_logger,
+        shortcuts,
+        custom_header,
+        active_connections,
+        proxy_config,
+    ):
+        self.html_403 = html_403
+        self.logger_config = logger_config
+        self.filter_config = filter_config
+        self.filter_queue = filter_queue
+        self.filter_result_queue = filter_result_queue
+        self.shortcuts_queue = shortcuts_queue
+        self.shortcuts_result_queue = shortcuts_result_queue
+        self.custom_header_queue = custom_header_queue
+        self.custom_header_result_queue = custom_header_result_queue
+        self.console_logger = console_logger
+        self.config_shortcuts = shortcuts
+        self.config_custom_header = custom_header
+        self.proxy_config = proxy_config
+        self.active_connections = active_connections
+
+    def _get_modified_headers(self, url, request_text):
+        """
+        Extract headers from a request
+        """
+        headers = extract_headers(request_text)
+        self.custom_header_queue.put(url)
+        try:
+            new_headers = self.custom_header_result_queue.get(timeout=5)
+            headers.update(new_headers)
+        except Exception:
+            self.console_logger.warning("Timeout while getting custom headers for %s", url)
+        return headers
+
+    def _rebuild_http_request(self, request_line, headers, body=""):
+        """
+        Reconstructs an HTTP request with the new headers.
+        """
+        header_lines = [f"{key}: {value}" for key, value in headers.items()]
+        reconstructed_headers = "\r\n".join(header_lines)
+        return f"{request_line}\r\n{reconstructed_headers}\r\n\r\n{body}".encode()
+
+    def _apply_shortcut(self, url: str) -> str | None:
+        """
+        Checks if a shortcut is defined for the given domain.
+        """
+        if self.config_shortcuts and os.path.isfile(self.config_shortcuts):
+            parsed_url = urlparse(url)
+            domain = parsed_url.hostname
+            self.shortcuts_queue.put(domain)
+            try:
+                return self.shortcuts_result_queue.get(timeout=5)
+            except Exception:
+                self.console_logger.warning("Timeout while getting shortcut for %s", url)
+        return None
+
+    def _is_blocked(self, url: str) -> bool:
+        """
+        Checks if a URL is blocked by the configuration filter.
+        """
+        if not self.filter_config.no_filter:
+            self.filter_queue.put(url)
+            try:
+                result = self.filter_result_queue.get(timeout=5)
+                return result[1] == "Blocked"
+            except Exception:
+                self.console_logger.warning("Timeout while filtering %s", url)
+        return False
+
+    def _send_403(self, client_socket, url, first_line):
+        """
+        Sends an HTTP 403 Forbidden response to the client.
+        """
+        if not self.logger_config.no_logging_block:
+            method, domain_port, protocol = first_line.split(" ")
+            domain, port = domain_port.split(":")
+            self.logger_config.block_logger.info(
+                "",
+                extra={
+                    "ip_src": client_socket.getpeername()[0],
+                    "url": url,
+                    "method": method,
+                    "domain": domain,
+                    "port": port,
+                    "protocol": protocol,
+                },
+            )
+        with open(self.html_403, "r", encoding="utf-8") as f:
+            custom_403_page = f.read()
+        response = (
+            f"HTTP/1.1 403 Forbidden\r\n"
+            f"Content-Length: {len(custom_403_page)}\r\n"
+            f"\r\n"
+            f"{custom_403_page}"
+        )
+        client_socket.sendall(response.encode())
+        client_socket.close()
+        self.active_connections.pop(threading.get_ident(), None)
+
+    def handle_http_request(self, client_socket, request):
+        """
+        Processes an HTTP request, checks for URL filtering, applies shortcuts,
+        and forwards the request to the target server if not blocked.
+
+        Args:
+            client_socket (socket): The socket object for the client connection.
+            request (bytes): The raw HTTP request sent by the client.
+        """
+        first_line = request.decode(errors="ignore").split("\n")[0]
+        url = first_line.split(" ")[1]
+
+        if self.config_shortcuts and os.path.isfile(self.config_shortcuts):
+            shortcut_url = self._apply_shortcut(url)
+            if shortcut_url:
+                response = (
+                    f"HTTP/1.1 302 Found\r\nLocation: {shortcut_url}\r\nContent-Length: 0\r\n\r\n"
+                )
+
+                client_socket.sendall(response.encode())
+                client_socket.close()
+                self.active_connections.pop(threading.get_ident(), None)
+                return
+
+        if self._is_blocked(url):
+            self._send_403(client_socket, url, first_line)
+            return
+
+        if self.config_custom_header and os.path.isfile(self.config_custom_header):
+            request_text = request.decode(errors="ignore")
+            request_lines = request_text.split("\r\n")
+            headers = self._get_modified_headers(url, request_text)
+            request_line = request_lines[0]
+            body = request_text.split("\r\n\r\n", 1)[1] if "\r\n\r\n" in request_text else ""
+            modified_request = self._rebuild_http_request(request_line, headers, body)
+
+            self.forward_request_to_server(client_socket, modified_request, url, first_line)
+
+        else:
+            self.forward_request_to_server(client_socket, request, url, first_line)
+
+    def forward_request_to_server(self, client_socket, request, url, first_line):
+        """
+        Forwards the HTTP request to the target server and sends the response back to the client.
+
+        Args:
+            client_socket (socket): The socket object for the client connection.
+            request (bytes): The raw HTTP request sent by the client.
+            url (str): The target URL from the HTTP request.
+            first_line (str): The first line of the HTTP request (e.g., "GET / HTTP/1.1").
+        """
+        if self.proxy_config.enable:
+            server_host, server_port = self.proxy_config.host, self.proxy_config.port
+        else:
+            parsed_url = urlparse(url)
+            server_host = parsed_url.hostname
+            server_port = parsed_url.port or (443 if parsed_url.scheme == "https" else 80)
+
+        try:
+            ip_address = socket.gethostbyname(server_host)
+        except socket.gaierror:
+            ip_address = server_host
+
+        thread_id = threading.get_ident()
+
+        if thread_id in self.active_connections:
+            self.active_connections[thread_id].update(
+                {
+                    "target_ip": ip_address,
+                    "target_domain": server_host,
+                    "target_port": server_port,
+                    "bytes_sent": 0,
+                    "bytes_received": 0,
+                }
+            )
+
+        try:
+            server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            server_socket.connect((server_host, server_port))
+            server_socket.sendall(request)
+            server_socket.settimeout(5)
+            self.active_connections[thread_id]["bytes_sent"] += len(request)
+
+            while True:
+                try:
+                    response = server_socket.recv(4096)
+                    if response:
+                        client_socket.send(response)
+                        self.active_connections[thread_id]["bytes_received"] += len(response)
+                    else:
+                        break
+                except socket.timeout:
+                    break
+        except (socket.timeout, socket.gaierror, ConnectionRefusedError, OSError) as e:
+            self.console_logger.error("Error connecting to the server %s : %s", server_host, e)
+            response = (
+                f"HTTP/1.1 502 Bad Gateway\r\n"
+                f"Content-Length: {len('Bad Gateway')} \r\n"
+                "\r\n"
+                f"Bad Gateway"
+            )
+            client_socket.sendall(response.encode())
+            client_socket.close()
+            self.active_connections.pop(thread_id, None)
+        finally:
+            if not self.logger_config.no_logging_access:
+                method, url, protocol = first_line.split(" ")
+
+                conn_data = self.active_connections.get(thread_id, {})
+                self.logger_config.access_logger.info(
+                    "",
+                    extra={
+                        "ip_src": client_socket.getpeername()[0],
+                        "url": f"http://{server_host}",
+                        "method": method,
+                        "domain": parsed_url.hostname,
+                        "port": parsed_url.port,
+                        "protocol": protocol,
+                        "bytes_sent": conn_data.get("bytes_sent", 0),
+                        "bytes_received": conn_data.get("bytes_received", 0),
+                    },
+                )
+            client_socket.close()
+            server_socket.close()
+            self.active_connections.pop(thread_id, None)