sish

Tunelamento SSH de código aberto para HTTP(S), WS(S), TCP, aliases e SNI.

Se você gosta da simplicidade do compartilhamento estilo serveo/ngrok, mas quer usar SSH puro e executar sua própria infraestrutura, o sish foi criado para isso.

• Nenhum cliente personalizado necessário para usuários finais
• Fluxos de trabalho de túneis públicos e privados
• Lançamentos Docker e binários
• Projetado para auto-hospedagem em nível de produção

Documentação | Serviço Gerenciado | Lançamentos | Imagens Docker | Patrocinado por pico.sh

Por que sish

O sish executa um servidor SSH focado em encaminhamento e multiplexação. Os usuários se conectam com comandos que já conhecem, e o sish lida com o roteamento.

Casos de uso típicos

• Compartilhe um aplicativo web local instantaneamente via HTTPS
• Exponha um serviço TCP a uma porta externa fixa ou aleatória
• Crie aliases TCP privados que só podem ser acessados através de SSH autenticado
• Roteie tráfego TLS por SNI para vários backends sem encerrar o TLS

Início Rápido

1) Experimente o serviço gerenciado

A maneira mais rápida de validar seu fluxo de trabalho:

ssh -R 80:localhost:8080 tuns.sh

Isso cria uma URL pública para seu aplicativo local rodando na porta 8080.

2) Auto-hospede com Docker

Puxe a imagem:

docker pull antoniomika/sish:latest

Prepare os diretórios:

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

Execute:

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

Em seguida, conecte-se:

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

Exemplos de Encaminhamento

Túnel HTTP

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

Seu aplicativo em localhost:8080 fica disponível em https://myapp.tuns.sh.

Túnel TCP

ssh -R 2222:localhost:22 tuns.sh

localhost:22 está disponível em tuns.sh:2222

Alias TCP privado

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

Acesse de outro cliente:

ssh -J tuns.sh mylaptop

Destaques de Recursos

• Encaminhamento e multiplexação HTTP(S), WS(S), TCP
• Aliases TCP para padrões de acesso interno privado
• Suporte a proxy SNI para roteamento de backend baseado em TLS
• Modos opcionais de balanceamento de carga para aliases HTTP/TCP/SNI
• Suporte a console de serviço para inspecionar requisições encaminhadas
• Autenticação por chave e senha com recarregamento dinâmico de chaves
• Políticas de vinculação restritivas para configurações multi-inquilino mais seguras

Desenvolvimento Local

Clone:

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

Inicie localmente:

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

Ou use:

make dev

Teste um túnel:

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

testing.ssi.sh está configurado para apontar para localhost durante o desenvolvimento.

Saiba Mais

• Primeiros Passos
• Tipos de Encaminhamento
• Referência da CLI
• FAQ

Comunidade

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