bore

Rust CLI that forwards local TCP ports to a remote server, bypassing NAT firewalls. Includes a self-hostable server and a public instance at bore.pub.

install

bore is a TCP tunneling tool written in Rust. It exposes a port on your local machine through a remote server, bypassing NAT firewalls. Running bore local 8000 --to bore.pub makes localhost:8000 reachable at bore.pub:<PORT>, with the remote port assigned randomly unless you pick one with --port. It is comparable to localtunnel and ngrok, but it only forwards raw TCP traffic. The README puts the codebase at about 400 lines of async Rust, built on Tokio.

The same binary has two subcommands. bore local is the client. It takes the local port, a required --to server address, and optional --local-host to expose a host on your LAN other than localhost, --port and --secret. bore server runs your own relay. It accepts --min-port and --max-port to limit assignable ports, --bind-addr, and --bind-tunnels, so the control server and the tunnel listeners can bind to different IP addresses. Options can also be set through the environment variables BORE_SERVER, BORE_SECRET, BORE_LOCAL_PORT, BORE_MIN_PORT and BORE_MAX_PORT.

The protocol uses a control port at 7835. The client sends a "Hello" message to request a remote port. For each incoming connection the server generates a UUID and sends it to the client. The client opens a new TCP stream and sends an "Accept" message with that UUID, and the server then proxies the two streams. The server discards connections the client has not accepted within 10 seconds. A self-hosted server can require a shared secret, which clients prove they hold by answering random HMAC challenges. This is only used for the handshake, and tunnel traffic is not encrypted by default.

It is aimed at developers who need to expose a local dev server or other TCP service to the internet, or who want a small relay they can host themselves. The README lists prebuilt binaries for macOS, Windows and Linux, plus Homebrew, AUR, Gentoo, Cargo and Docker packages.

Installation

# via Homebrew
brew install bore-cli
# via Cargo
cargo install bore-cli

Alternatives & related tools

add a badge to your README

Maintain bore? Show that it's featured on trmn. The badge links back to this page.

Featured on trmn
Markdown
[![Featured on trmn](https://www.trmn.sh/badge/bore.svg)](https://www.trmn.sh/tools/bore?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/bore?utm_source=badge"><img src="https://www.trmn.sh/badge/bore.svg" alt="Featured on trmn" height="20"></a>