sish

Open-Source-SSH-Tunneling für HTTP(S), WS(S), TCP, Aliase und SNI.

Wenn Ihnen die Einfachheit des Serveo/ngrok-ähnlichen Sharings gefällt, Sie aber einfaches SSH verwenden und Ihre eigene Infrastruktur betreiben möchten, ist sish genau dafür gemacht.

• Kein benutzerdefinierter Client für Endbenutzer erforderlich
• Öffentliche und private Tunnel-Workflows
• Docker- und Binär-Releases
• Konzipiert für produktionsreifes Selbsthosting

Dokumentation | Managed Service | Releases | Docker-Images | Gesponsert von pico.sh

Warum sish

sish betreibt einen SSH-Server, der auf Weiterleitung (Forwarding) und Multiplexing spezialisiert ist. Die Benutzer verbinden sich mit vertrauten Befehlen, und sish übernimmt das Routing.

Typische Anwendungsfälle

• Sofort eine lokale Web-App über HTTPS teilen
• Einen TCP-Dienst über einen festen oder zufälligen externen Port verfügbar machen
• Private TCP-Aliase erstellen, die nur über authentifiziertes SSH erreichbar sind
• TLS-Verkehr per SNI an mehrere Backends weiterleiten, ohne TLS zu terminieren

Schnellstart

1) Managed Service ausprobieren

Der schnellste Weg, Ihren Workflow zu validieren:

ssh -R 80:localhost:8080 tuns.sh

Dies erstellt eine öffentliche URL für Ihre lokale App, die auf Port 8080 läuft.

2) Selbsthosten mit Docker

Image pullen:

docker pull antoniomika/sish:latest

Verzeichnisse vorbereiten:

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

Ausführen:

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

Dann verbinden:

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

Beispiele für Weiterleitung

HTTP-Tunnel

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

Ihre App unter localhost:8080 wird unter https://myapp.tuns.sh verfügbar.

TCP-Tunnel

ssh -R 2222:localhost:22 tuns.sh

localhost:22 ist unter tuns.sh:2222 verfügbar

Privater TCP-Alias

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

Zugriff von einem anderen Client:

ssh -J tuns.sh mylaptop

Funktionshighlights

• HTTP(S), WS(S), TCP-Weiterleitung und Multiplexing
• TCP-Aliase für private, nur intern zugängliche Zugriffsmuster
• SNI-Proxy-Unterstützung für TLS-basiertes Backend-Routing
• Optionale Lastausgleichsmodi für HTTP/TCP/SNI-Aliase
• Service-Konsolenunterstützung zur Inspektion weitergeleiteter Anfragen
• Schlüssel- und Passwortauthentifizierung mit dynamischem Schlüssel-Neuladen
• Restriktive Bindungsrichtlinien für sicherere Multi-Tenant-Umgebungen

Lokale Entwicklung

Klonen:

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

Lokal starten:

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

Oder verwenden:

make dev

Testen Sie einen Tunnel:

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

testing.ssi.sh ist so konfiguriert, dass es für die Entwicklung auf localhost verweist.

Mehr erfahren

• Erste Schritte
• Weiterleitungstypen
• CLI-Referenz
• FAQ

Community

• IRC: #sish auf libera / #pico.sh auf libera
• E-Mail: [email protected]