Skip to content
@portsicle

Portsicle

Expose local servers to public network (the internet)

banner

Portsicle is a reverse tunneling service that creates a public ingress endpoint for local servers, allowing developers to showcase their locally running applications to clients, stakeholders or to test APIs without deploying.

Repository overview

1. Portsicle Server

A free and open-source ngrok alternative to expose local servers online with Minimal setup & high performance.

2. Portsicle Client

Portsicle client allows you to use the Portsicle Server via CLI:

  • Direct connection to local services running on your machine.
  • Routing and forwarding of HTTP traffic to Portsicle Server.

3. Portsicle Proxy

A lightweight and flexible HTTP/HTTPS forward proxy server that allows Site access management and advanced network logging at local level.


How Portsicle works:

  1. Portsicle operates by establishing a secure wss tunnel between your local server and a remote Portsicle server.

  2. When you run the Portsicle client on your local machine, it connects to the Portsicle server over a wss connection.

  3. Incoming requests to the Portsicle server are then securely forwarded through this tunnel to your local server, and responses are sent back through the same tunnel to the requester.

  4. This method ensures that your local server remains protected behind your firewall, while still being accessible via a public URL provided by the Portsicle server.

NOTE that Portsicle is currently designed to work with production‑build assets where the files are served statically. There’s no mechanism in the current code to dynamically adjust headers based on the HMR requirements. Hence HMR remains a future scope / enhancement for this project.

Contribution

We welcome contributions! Feel free to open a pull request or an issue.


Buy Me A Coffee

Pinned Loading

  1. portsicle-server portsicle-server Public

    Portsicle Tunneling Server

    Go 5

  2. portsicle-client portsicle-client Public

    Portsicle client-side implementation

    Go 1

  3. portsicle-proxy portsicle-proxy Public

    A Transparent Forward Proxy that runs locally.

    Go 1

Repositories

Showing 5 of 5 repositories

Top languages

Loading…

Most used topics

Loading…