+3
日增长
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 chiseTop issues
#86How to use in Android?34 comments · 2019-03-13#279Today Microsoft Security Essentials started to flag all chisel versions as a hacking tool19 comments · 2021-05-21#158UDP15 comments · 2020-05-03#203Issue reconnect on Android10 comments · 2020-10-18#149chisel do not support ntlm proxy authentication9 comments · 2020-04-09#3[Feature Request] TUN interface support (Simple VPN solution)9 comments · 2015-08-18#336Virus Total and Avast think chisel.exe is a virus8 comments · 2022-02-16#229Resolve Anti-virus false positive8 comments · 2020-12-24
Latest release
v1.12.0 v1.12.0 2026-08-29Chisel 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