# sadeghhayeri/greentunnel architecture

> Architecture diagram of the GitHub repository sadeghhayeri/greentunnel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sadeghhayeri/greentunnel
- Repository: https://github.com/sadeghhayeri/greentunnel

## Overview

##### Main Components

a. Client Layer:
- GUI Application (Electron-based)
- CLI Interface
- Docker Container

b. Core Proxy Components:
- HTTP/HTTPS Proxy Server
- DNS Resolution System
- DPI Bypass Mechanisms

c. External Services:
- DNS over HTTPS/TLS Providers
- Target Websites/Services

**[User Interface Layer]**

- GUI (Electron)
- CLI
- Docker Container

**[Core Proxy Layer]**

- Proxy Server
- HTTP Handler
- HTTPS Handler
- Request Handler

- DNS Resolution System
- HTTPS DNS
- TLS DNS
- Unencrypted DNS

- System Proxy Manager

**[External Services Layer]**

- DNS Providers (CloudFlare, etc.)
- Target Websites

##### Key Interactions to Highlight

a. Traffic Flow:
- How client requests flow through the proxy
- DPI bypass mechanism for HTTP/HTTPS
- Demonstrate DNS resolution path

b. System Integration:
- System proxy configuration
- DNS server communication
- TCP packet manipulation

##### Implementation Details

- src/proxy.js as the central component
- src/handlers/* for request handling
- src/dns/* for DNS resolution
- src/utils/* for supporting functions

##### Additional Elements

- Packet splitting mechanism
- DNS resolution methods
- System proxy integration
- Configuration options

- Keep the focus on the DPI bypass mechanisms
- Security aspects of DNS resolution
- Flexibility of different DNS providers
- Demonstrate the multi-platform support

Remember to include configuration options and system requirements as supplementary information, as these are crucial for deployment and maintenance considerations.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        GUI["GUI Application"]
        CLI["CLI Interface"]
        Docker["Docker Container"]
    end

    subgraph Core["Core Proxy Layer"]
        ProxyServer["Proxy Server"]
        
        subgraph Handlers["Request Handlers"]
            HTTPHandler["HTTP Handler"]
            HTTPSHandler["HTTPS Handler"]
            ReqHandler["Request Handler"]
        end
        
        subgraph DNS["DNS Resolution System"]
            HTTPSDNS["HTTPS DNS"]
            TLSDNS["TLS DNS"]
            UnencryptedDNS["Unencrypted DNS"]
        end
        
        subgraph Utils["Utility Components"]
            SysProxy["System Proxy Manager"]
            HTTPUtils["HTTP Utils"]
            SocketMgmt["Socket Management"]
            BufferMgmt["Buffer Management"]
            Analytics["Analytics"]
        end
        
        Config["Configuration"]
    end

    subgraph External["External Services"]
        DNSProviders["DNS Providers"]
        Websites["Target Websites"]
    end

    %% Relationships
    GUI --> ProxyServer
    CLI --> ProxyServer
    Docker --> ProxyServer
    
    ProxyServer --> HTTPHandler
    ProxyServer --> HTTPSHandler
    ProxyServer --> ReqHandler
    
    ProxyServer --> DNS
    DNS --> HTTPSDNS
    DNS --> TLSDNS
    DNS --> UnencryptedDNS
    
    DNS --> DNSProviders
    ProxyServer --> Websites
    
    ProxyServer --> SysProxy
    ProxyServer --> HTTPUtils
    ProxyServer --> SocketMgmt
    ProxyServer --> BufferMgmt
    ProxyServer --> Analytics
    
    Config --> ProxyServer

    %% Click Events
    click GUI "https://github.com/SadeghHayeri/GreenTunnel/blob/master/gui/main.js"
    click CLI "https://github.com/SadeghHayeri/GreenTunnel/blob/master/bin/gt.js"
    click Docker "https://github.com/SadeghHayeri/GreenTunnel/tree/master/Dockerfile"
    click ProxyServer "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/proxy.js"
    click HTTPHandler "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/handlers/http.js"
    click HTTPSHandler "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/handlers/https.js"
    click ReqHandler "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/handlers/request.js"
    click DNS "https://github.com/SadeghHayeri/GreenTunnel/tree/master/src/dns/"
    click HTTPSDNS "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/dns/https.js"
    click TLSDNS "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/dns/tls.js"
    click UnencryptedDNS "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/dns/unencrypted.js"
    click SysProxy "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/utils/system-proxy.js"
    click HTTPUtils "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/http/utils.js"
    click SocketMgmt "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/utils/socket.js"
    click BufferMgmt "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/utils/buffer.js"
    click Analytics "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/utils/analytics.js"
    click Config "https://github.com/SadeghHayeri/GreenTunnel/blob/master/src/config.js"

    %% Styling
    classDef client fill:#a8d1ff,stroke:#333,stroke-width:1px
    classDef core fill:#90EE90,stroke:#333,stroke-width:1px
    classDef external fill:#FFB6C1,stroke:#333,stroke-width:1px
    classDef handler fill:#98FB98,stroke:#333,stroke-width:1px
    classDef dns fill:#DDA0DD,stroke:#333,stroke-width:1px
    classDef util fill:#F0E68C,stroke:#333,stroke-width:1px

    class GUI,CLI,Docker client
    class ProxyServer,Config core
    class HTTPHandler,HTTPSHandler,ReqHandler handler
    class HTTPSDNS,TLSDNS,UnencryptedDNS dns
    class SysProxy,HTTPUtils,SocketMgmt,BufferMgmt,Analytics util
    class DNSProviders,Websites external
```
