2 unstable releases

0.1.0 May 4, 2023
0.0.1 May 1, 2023

#57 in #tunnel

Download history 11/week @ 2024-02-23 9/week @ 2024-03-01 5/week @ 2024-03-08 2/week @ 2024-03-15 26/week @ 2024-03-29 10/week @ 2024-04-05 61/week @ 2024-04-12

97 downloads per month

MIT license

10KB
221 lines

tinytun

Generate public URLs for your locally running web servers. Simple clone of ngrok.

sequenceDiagram

participant Local WEB service
participant TinytunClient as Tinytun Client
participant TinytunServer as Tinytun Server
participant User as User outside<br/>of local network

box transparent Internal Network
    participant Local WEB service
    participant TinytunClient
end

box transparent External Network
    participant TinytunServer
    participant User
end

TinytunClient->>TinytunServer: Create tunnel via an HTTP request
TinytunServer->>TinytunClient: Tunnel created and the<br/>HTTP connection is "downgraded"<br/>to a simple TCP tunnel
note over TinytunClient,TinytunServer: Tinytun Client starts an HTTP 2 server<br/>over the downgraded connection

par For each concurrent HTTP request
    User->>+TinytunServer: HTTP request
    TinytunServer->>TinytunClient: Multiplexes HTTP request<br/>via an HTTP2 stream
    TinytunClient->>Local WEB service: HTTP request
    Local WEB service->>TinytunClient: HTTP response
    TinytunClient->>TinytunServer: HTTP response
    TinytunServer->>-User: HTTP response
end

Dependencies

~13–23MB
~405K SLoC