Freetunnel

Create secure introspectable tunnels to your local device with a single command.

---

Overview ✯ Quickstart ✯ Usage ✯ Setup Your Own Freetunnel Server

---

Overview

Freetunnel is a tool for creating tunnels from your local development machine to a public and secure URL. This allows for easy webhook development, sharing of demo applications across networks, and using tools such as PageSpeed Insights which require public acess.

Freetunnel comes in two parts: a CLI client and a server. You use the CLI client to connect to a server host, making your local device publicly accessible, and the server can be ran if you want your own configurable instance of Freetunnel. While I host an instance at https://freetunnel.ryanchristian.dev, you may not want to use that URL and slots are limited; to ensure my infrastructure is never burdened, there can only be 3 sites using that instance at one time. Additionally, service may go down without warning.

Quickstart

To begin using Freetunnel immediately, run:

$ npx @rschristian/freetunnel

This will connect http://localhost:3000 on your local machine to https://my-app.freetunnel.ryanchristian.dev.

Usage

Usage
    $ freetunnel [options]

Options
    -s, --subdomain    Subdomain to use on remote  (default my-app)
    -r, --remote       Remote server to run on  (default freetunnel.ryanchristian.dev)
    -H, --host         Hostname to bind  (default localhost)
    -p, --port         Port to bind  (default 3000)
    -w, --web-port     Web Port to bind for introspection (default 4040)
    -v, --version      Displays current version
    -h, --help         Displays this message

Examples
    $ freetunnel -s rschristian -r freetunnel.example.com        # Connects localhost:3000 -> https://rschristian.freetunnel.example.com
    $ freetunnel -s foobar -p 6000                               # Connects localhost:6000 -> https://foobar.freetunnel.ryanchristian.dev

Setup Your Own Freetunnel Server

See Server

License

MIT