richlegrand/bitbang-cliEstabeleça acesso remoto seguro a uma máquina com shell interativo, transferência de arquivos e proxy web sobre WebRTC peer-to-peer criptografado de ponta a ponta, usando um navegador ou CLI sem encaminhamento de portas ou contas.
bitbang é uma ferramenta multifuncional de acesso remoto em um único binário estático. A partir de qualquer navegador: acesso a um shell interativo e a um navegador de arquivos na máquina remota. Você também pode acessar aplicações web na rede dessa máquina. Além do navegador, ele faz encaminhamento de portas TCP, cópia de arquivos e compartilhamento de terminal. Não requer conta nem configuração -- simplesmente funciona.
Na máquina que você deseja acessar:
curl -sSfL bitba.ng/install | sh
bitbang serve
serve imprime uma URL. Abra-a em qualquer navegador e você obtém um terminal, um navegador de arquivos e um proxy para a rede daquela máquina -- ou alcance a mesma máquina a partir de outro terminal com bitbang connect <url>, que adiciona encaminhamento de portas (-L) e cópia de arquivos (bitbang cp). A conexão é criptografada de ponta a ponta e ponto a ponto; o servidor bitba.ng apresenta as duas pontas e depois sai de cena.
bitbang é um único binário Go estático. Ele faz parte do projeto BitBang; este whitepaper aborda o design em profundidade.
| ngrok | Tailscale | bitbang | |
|---|---|---|---|
| Configuração antes do primeiro uso | Conta + authtoken | Conta + login em cada dispositivo | Execute um comando |
| Para compartilhar algo, você executa | um servidor web, mais o ngrok | o cliente deles em ambas as máquinas | bitbang serve |
| O que um navegador na outra ponta recebe | o servidor web que você já estava executando | nada -- ele precisa do cliente deles | um terminal, um navegador de arquivos e aplicativos web na rede remota |
| Caminho dos dados | os servidores deles | P2P (fallback por relay) | P2P (fallback por relay) |
| Criptografado de ponta a ponta | Não por padrão | Sim | Sim |
Alcançar um serviço em casa
Acessar uma máquina
Compartilhar com outra pessoa
Compartilhar significa simplesmente dar a alguém uma URL única ou um código QR que lhe concede acesso. As permissões podem ser personalizadas e definidas para expirar em minutos, horas, etc.
Desenvolvimento e dispositivos
Técnicas
bitbangToda conexão tem duas pontas: um listener (bitbang serve, em execução na máquina que está sendo acessada) e um connector (um navegador, ou a CLI bitbang, na máquina que está acessando). Uma única URL de listener atende os dois tipos de connector.
bitbang servebitbang serve # everything: shell + proxy + files + forward
bitbang serve shell # just a terminal
bitbang serve files ~/share # just a directory (-files-upload to allow uploads)
bitbang serve proxy localhost:8080 # just one web app, straight at the URL
bitbang serve proxy a.lan:80,b.lan:80 # ...or several, chosen in the browser
bitbang serve forward 127.0.0.1:22 # just TCP, for `connect -L`
bitbang serve shell files ~/share proxy nas.lan:8096 # any combination
Cada um imprime um código QR, URL e um código de emparelhamento. O modo define o que o
listener pode fazer: serve shell não tem encaminhamento a conceder, e um
listener apenas de encaminhamento nunca inicia um shell, portanto não há nada a escalar.