jpillora /chisel

A fast TCP/UDP tunnel over HTTP

★ 16,780⑂ 1,622👁 202⑃ 262● 359▤ 42
GoMITCreated 2015-02-25
Download: v1.12.0v1.12.0 ↓1.12.02026-08-29
+3
Daily
16,780
stars
1,622
forks
202
watchers
262
prs
359
issues
42
releases

README

Chisel

 

Chisel is a fast TCP/UDP tunnel, transported over HTTP, secured via SSH. Single executable including both client and server. Written in Go (golang). Chisel is mainly useful for passing through firewalls, though it can also be used to provide a secure endpoint into your network.

!overview

 Table of Contents

- Features
- Install
- Demo
- Usage
- Contributing
- Changelog
- License

 Features

- Easy to use
- Performant\
- Encrypted connections using the SSH protocol (via crypto/ssh)
- Authenticated connections; authenticated client connections with a users config file, authenticated server connections with fingerprint matching.
- Client auto-reconnects with exponential backoff (tunable via --min/max-retry-interval); keepalive pings time out, so silently dead connections (sleep/wake, NAT timeouts, server restarts) are detected and re-established
- Clients can create multiple tunnel endpoints over one TCP connection
- Clients can optionally pass through SOCKS or HTTP CONNECT proxies
- Reverse port forwarding (Connections go through the server and out the client)
- Server optionally doubles as a reverse proxy
- Server optionally allows SOCKS5 connections (See guide below)
- Clients optionally allow SOCKS5 connections from a reversed port forward
- Client connections over stdio which supports ssh -o ProxyCommand providing SSH over HTTP

 Install

 Binaries

 

See the latest release or download and install it now with curl https://i.jpillora.com/chisel! | bash

Binaries are built with the latest Go release, which sets the minimum OS versions: Windows 10 / Server 2016, macOS 12, Linux kernel 3.2, FreeBSD 12.2. For older systems (e.g. Windows 7), use release v1.8.1 or earlier.

 Docker

 

sh
docker run --rm -it jpillora/chisel --help


Images are multi-arch and published to both Docker Hub (jpillora/chisel) and GitHub Container Registry (ghcr.io/jpillora/chisel).

 Fedora

The package is maintained by the Fedora community. If you encounter issues related to the usage of the RPM, please use this issue tracker.

sh
sudo dnf -y install chisel


 Source

sh
$ go install github.com/jpillora/chisel@latest


 Demo

You can run your own demo server in minutes (the old Heroku demo went away with Heroku's free tier). example/fly.toml deploys this chisel server to fly.io's free allowance:

sh
$ chisel server --port $PORT --backend http://example.com
 listens on $PORT, proxies normal web requests to http://example.com


Deploy it with fly launch --copy-config from the example/ directory, then tunnel to any service running beside the server, e.g.:

sh
$ chisel client https://.fly.dev 3000
 connects to your chisel server,
 tunnels your localhost:3000 to the server's localhost:3000


Visiting your app's URL in a browser hits the server's default backend proxy and shows a copy of example.com.

 Usage




 plain 
$ chisel --help

  Usage: chisel [command] [--help]

  Version: X.Y.Z

  Commands:
    server - runs chisel in server mode
    client - runs chise

Top issues

Latest release

v1.12.0 v1.12.0 2026-08-29
Chisel 1.12.0 is a reliability and security release focused on recovering
cleanly from network and configuration changes, making failures visible, and
hardening unauthenticated surfaces.

This stable release follows three public release candidates. No 1.12-specific
runtime regressions were reported after rc3. The archive corruption reported
for rc1 was fixed in rc2; release CI now integrity-tests every .gz and
.zip before any asset or image is published.

 Highlights

- Fixes the high-CPU failure after disconnected SSH sessions by updating
  x/crypto/ssh, bounding keepalive requests, and closi

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON