Chisel

Chisel è un tunnel TCP/UDP veloce, trasportato su HTTP e protetto tramite SSH. Un singolo eseguibile che include sia client che server. Scritto in Go (golang). Chisel è utile principalmente per attraversare firewall, ma può anche essere utilizzato per fornire un endpoint sicuro verso la tua rete.

Indice dei contenuti

• Funzionalità
• Installazione
• Demo
• Utilizzo
• Contributi
• Changelog
• Licenza

Funzionalità

• Facile da usare
• Performante*
• Connessioni crittografate tramite il protocollo SSH (via crypto/ssh)
• Connessioni autenticate; connessioni client autenticate con un file di configurazione utenti, connessioni server autenticate tramite corrispondenza delle impronte digitali.
• Il client si riconnette automaticamente con backoff esponenziale (regolabile tramite --min/max-retry-interval); i ping keepalive scadono, quindi le connessioni morte silenziosamente (sleep/wake, timeout NAT, riavvii del server) vengono rilevate e ristabilite
• I client possono creare più endpoint tunnel su una singola connessione TCP
• I client possono opzionalmente passare attraverso proxy SOCKS o HTTP CONNECT
• Port forwarding inverso (le connessioni passano attraverso il server ed escono dal client)
• Il server funziona opzionalmente anche come reverse proxy
• Il server consente opzionalmente connessioni SOCKS5 (vedi guida sotto)
• I client consentono opzionalmente connessioni SOCKS5 da un port forward inverso
• Connessioni client su stdio che supportano ssh -o ProxyCommand fornendo SSH su HTTP

Installazione

Binari

Vedi l'ultima release oppure scaricala e installala subito con curl https://i.jpillora.com/chisel! | bash

I binari sono compilati con l'ultima versione di Go, che imposta le versioni minime dei sistemi operativi: Windows 10 / Server 2016, macOS 12, kernel Linux 3.2, FreeBSD 12.2. Per sistemi più vecchi (ad es. Windows 7), usa la release v1.8.1 o precedenti.

Docker

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

Le immagini sono multi-architettura e pubblicate sia su Docker Hub (`jpillora/chisel`) che su GitHub Container Registry (`ghcr.io/jpillora/chisel`).

### Fedora

Il pacchetto è mantenuto dalla community di Fedora. Se incontri problemi relativi all'uso dell'RPM, utilizza questo [issue tracker](https://bugzilla.redhat.com/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&component=chisel&list_id=11614537&product=Fedora&product=Fedora%20EPEL).```sh
sudo dnf -y install chisel

Source

Traduzione```sh

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

## Demo

Puoi eseguire il tuo server demo in pochi minuti (la vecchia demo su Heroku è sparita con il piano gratuito di Heroku). [`example/fly.toml`](https://github.com/jpillora/chisel/blob/master/example/fly.toml) distribuisce questo `chisel server` sull'allocazione gratuita di [fly.io](https://fly.io):```sh
$ chisel server --port $PORT --backend http://example.com
# listens on $PORT, proxies normal web requests to http://example.com

Distribuiscilo con fly launch --copy-config dalla directory example/, quindi crea un tunnel verso qualsiasi servizio in esecuzione accanto al server, ad esempio:```sh $ chisel client https://.fly.dev 3000

connects to your chisel server,

tunnels your localhost:3000 to the server's localhost:3000

Visitando l'URL della tua app in un browser si raggiunge il proxy backend predefinito del server e viene mostrata una copia di [example.com](http://example.com).

## Utilizzo

<!-- render these help texts by hand,
  or use https://github.com/jpillora/md-tmpl
    with $ md-tmpl -w README.md -->

<!--tmpl,code=plain:echo "$ chisel --help" && go run main.go --help | sed 's#0.0.0-src (go1\..*)#X.Y.Z#' -->``` plain 
$ chisel --help

  Usage: chisel [command] [--help]

  Version: X.Y.Z

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

  Read more:
    https://github.com/jpillora/chisel

``` plain

$ chisel server --help

Usage: chisel server [options]

Options:

--host, Defines the HTTP listening host – the network interface
(defaults the environment variable HOST and falls back to 0.0.0.0).

--port, -p, Defines the HTTP listening port (defaults to the environment
variable PORT and falls back to port 8080).

--key, (deprecated use --keygen and --keyfile instead)
An optional string to seed the generation of a ECDSA public
and private key pair. All communications will be secured using this
key pair. Share the subsequent fingerprint with clients to enable detection
of man-in-the-middle attacks (defaults to the CHISEL_KEY environment
variable, otherwise a new key is generate each run).

--keygen, A path to write a newly generated PEM-encoded SSH private key file.
If users depend on your --key fingerprint, you may also include your --key to
output your existing key. Use - (dash) to output the generated key to stdout.

--keyfile, An optional path to a PEM-encoded SSH private key. When
this flag is set, the --key option is ignored, and the provided private key
is used to secure all communications. (defaults to the CHISEL_KEY_FILE
environment variable). Since ECDSA keys are short, you may also set keyfile
to the inline key string itself, exactly as printed by --keygen (a base64
string with a "ck-" prefix); no extra base64 encoding is needed.