Home How To chisel – Fast TCP tunnel over HTTP

chisel – Fast TCP tunnel over HTTP

by Unallocated Author

Chisel is a fast TCP tunnel, transported over HTTP. 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. Chisel is very similar to crowbar though achieves much higher performance.




Download & Install

Enter the following command to download chisel

git clone https://github.com/jpillora/chisel.git

Note: Download and install it withc curl https://i.jpillora.com/chisel! | bash

Now to run chisel type


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


go get -v github.com/jpillora/chisel



Encryption is always enabled. When you start up a chisel server, it will generate an in-memory ECDSA public/private key pair. The public key fingerprint will be displayed as the server starts. Instead of generating a random key, the server may optionally specify a key seed, using the –key option, which will be used to seed the key generation. When clients connect, they will also display the server’s public key fingerprint. The client can force a particular fingerprint using the –fingerprint option. See the –help above for more information.


Using the –authfile option, the server may optionally provide a user.json configuration file to create a list of accepted users. The client then authenticates using the –auth option. See users.json for an example authentication configuration file. See the –help above for more information.
Internally, this is done using the Password authentication method provided by SSH.



With crowbar , a connection is tunnelled by repeatedly querying the server with updates. This results in a large amount of HTTP and TCP connection overhead. Chisel overcomes this using WebSockets combined with crypto/ssh to create hundreds of logical connections, resulting in one TCP connection per client.


Known Issues

  • WebSockets support is required
    • IaaS providers all will support WebSockets
      • Unless an unsupporting HTTP proxy has been forced in front of you, in which case I’d argue that you’ve been downgraded to PaaS.
    • PaaS providers vary in their support for WebSockets
      • Heroku has full support
      • Openshift has full support though connections are only accepted on ports 8443 and 8080
      • Google App Engine has no support


Download now – Chisel

You may also like