sish

Tunneling SSH open source pour HTTP(S), WS(S), TCP, alias et SNI.

Si vous aimez la simplicité du partage à la serveo/ngrok mais que vous voulez utiliser du SSH simple et gérer votre propre infrastructure, sish a été conçu pour cela.

• Aucun client personnalisé requis pour les utilisateurs finaux
• Flux de travail de tunnel public et privé
• Versions Docker et binaires
• Conçu pour l'auto-hébergement de qualité production

Docs | Service géré | Versions | Images Docker | Sponsorisé par pico.sh

Pourquoi sish

sish exécute un serveur SSH axé sur le forwarding et le multiplexage. Les utilisateurs se connectent avec des commandes qu'ils connaissent déjà, et sish gère le routage.

Cas d'utilisation typiques

• Partager une application web locale instantanément via HTTPS
• Exposer un service TCP sur un port externe fixe ou aléatoire
• Créer des alias TCP privés accessibles uniquement via SSH authentifié
• Router le trafic TLS par SNI vers plusieurs backends sans terminer TLS

Démarrage rapide

1) Essayer le service géré

Le moyen le plus rapide de valider votre flux de travail :

ssh -R 80:localhost:8080 tuns.sh

Ceci crée une URL publique pour votre application locale tournant sur le port 8080.

2) Auto-héberger avec Docker

Tirer l'image :

docker pull antoniomika/sish:latest

Préparer les répertoires :

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

Exécuter :

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

Puis se connecter :

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

Exemples de forwarding

Tunnel HTTP

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

Votre application à localhost:8080 devient disponible à https://myapp.tuns.sh.

Tunnel TCP

ssh -R 2222:localhost:22 tuns.sh

localhost:22 est disponible sur tuns.sh:2222

Alias TCP privé

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

Accès depuis un autre client :

ssh -J tuns.sh mylaptop

Points forts des fonctionnalités

• Forwarding HTTP(S), WS(S), TCP et multiplexage
• Alias TCP pour des motifs d'accès internes privés
• Support du proxy SNI pour le routage backend basé sur TLS
• Modes d'équilibrage de charge optionnels pour les alias HTTP/TCP/SNI
• Support de console de service pour inspecter les requêtes transférées
• Authentification par clé et mot de passe avec rechargement dynamique des clés
• Politiques de liaison restrictives pour des configurations multi-locataires plus sûres

Développement local

Cloner :

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

Démarrer localement :

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

Ou utiliser :

make dev

Tester un tunnel :

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

testing.ssi.sh est configuré pour pointer vers localhost pour le développement.

En savoir plus

• Démarrer
• Types de forwarding
• Référence CLI
• FAQ

Communauté

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