sish

Tunneling SSH open source per HTTP(S), WS(S), TCP, alias e SNI.

Se ti piace la semplicità della condivisione in stile serveo/ngrok ma vuoi usare SSH semplice e gestire la tua infrastruttura, sish è costruito per questo.

• Nessun client personalizzato richiesto per gli utenti finali
• Flussi di lavoro per tunnel pubblici e privati
• Rilasci Docker e binari
• Progettato per l'auto-ospitalità di livello produttivo

Documentazione | Servizio Gestito | Rilasci | Immagini Docker | Sponsorizzato da pico.sh

Perché sish

sish esegue un server SSH focalizzato sul forwarding e multiplexing. Gli utenti si connettono con comandi che già conoscono e sish gestisce il routing.

Casi d'uso tipici

• Condividi istantaneamente un'app web locale tramite HTTPS
• Esponi un servizio TCP su una porta esterna fissa o casuale
• Crea alias TCP privati raggiungibili solo tramite SSH autenticato
• Instrada il traffico TLS per SNI verso più backend senza terminare TLS

Avvio rapido

1) Prova il servizio gestito

Il modo più veloce per convalidare il tuo flusso di lavoro:

ssh -R 80:localhost:8080 tuns.sh

Questo crea un URL pubblico per la tua app locale in esecuzione sulla porta 8080.

2) Auto-ospitalità con Docker

Scarica l'immagine:

docker pull antoniomika/sish:latest

Prepara le directory:

mkdir -p ~/sish/ssl ~/sish/keys ~/sish/pubkeys
cp ~/.ssh/id_ed25519.pub ~/sish/pubkeys

Esegui:

docker run -itd --name sish \
	-v ~/sish/ssl:/ssl \
	-v ~/sish/keys:/keys \
	-v ~/sish/pubkeys:/pubkeys \
	--net=host antoniomika/sish:latest \
	--ssh-address=:2222 \
	--http-address=:80 \
	--https-address=:443 \
	--https=true \
	--https-certificate-directory=/ssl \
	--authentication-keys-directory=/pubkeys \
	--private-keys-directory=/keys \
	--bind-random-ports=false \
	--domain=example.com

Poi connettiti:

ssh -p 2222 -R 80:localhost:8080 example.com

Esempi di Forwarding

Tunnel HTTP

ssh -R myapp:80:localhost:8080 tuns.sh

La tua app su localhost:8080 diventa disponibile su https://myapp.tuns.sh.

Tunnel TCP

ssh -R 2222:localhost:22 tuns.sh

localhost:22 è disponibile su tuns.sh:2222

Alias TCP privato

ssh -R mylaptop:22:localhost:22 tuns.sh

Accesso da un altro client:

ssh -J tuns.sh mylaptop

Caratteristiche principali

• Forwarding HTTP(S), WS(S), TCP e multiplexing
• Alias TCP per modelli di accesso interno privati
• Supporto proxy SNI per routing backend basato su TLS
• Modalità di bilanciamento del carico opzionali per alias HTTP/TCP/SNI
• Supporto console di servizio per ispezionare le richieste inoltrate
• Autenticazione tramite chiave e password con ricarica dinamica delle chiavi
• Politiche di binding restrittive per configurazioni multi-tenant più sicure

Sviluppo locale

Clona:

git clone [email protected]:antoniomika/sish.git
cd sish

Avvia localmente:

go run main.go --http-address localhost:3000 --domain testing.ssi.sh

Oppure usa:

make dev

Testa un tunnel:

ssh -p 2222 -R 80:localhost:8080 testing.ssi.sh

testing.ssi.sh è configurato per puntare a localhost per lo sviluppo.

Per saperne di più

• Guida introduttiva
• Tipi di forwarding
• Riferimento CLI
• FAQ

Comunità

• IRC: #sish su libera / #pico.sh su libera
• Email: [email protected]