richlegrand/bitbang-cliEstablece acceso remoto seguro a una máquina con shell interactivo, transferencia de archivos y proxy web a través de WebRTC peer-to-peer cifrado de extremo a extremo, usando un navegador o CLI sin reenvío de puertos ni cuentas.
bitbang es una multitool de acceso remoto de un único binario estático. Desde cualquier navegador: una shell interactiva y un explorador de archivos para acceder a la máquina remota. También puedes acceder a aplicaciones web en la red de esa máquina. Más allá del navegador, ofrece reenvío de puertos TCP, copia de archivos y uso compartido de terminal. No requiere cuenta ni configuración: simplemente funciona.
En la máquina a la que quieres acceder:``` curl -sSfL bitba.ng/install | sh bitbang serve
`serve` imprime una URL. Ábrela en cualquier navegador y obtienes una terminal, un explorador de archivos y un proxy a la red de esa máquina — o accede a la misma máquina desde otro terminal con `bitbang connect <url>`, que añade reenvío de puertos (`-L`) y copia de archivos (`bitbang cp`). La conexión está cifrada de extremo a extremo y es peer-to-peer; el servidor `bitba.ng` presenta los dos extremos y luego se aparta.
`bitbang` es un único binario estático de Go. Forma parte del [proyecto BitBang](https://github.com/richlegrand/bitbang); este [whitepaper](https://github.com/richlegrand/bitbang/blob/main/whitepaper.md) cubre el diseño en profundidad.
## Cómo se compara
| | ngrok | Tailscale | `bitbang` |
| ------------------------------ | ---------------------- | ------------------------------ | ------------------- |
| Configuración antes del primer uso | Cuenta + authtoken | Cuenta + inicio de sesión en cada dispositivo | **Ejecuta un comando** |
| Para compartir algo, ejecutas | un servidor web, más ngrok | su cliente en ambas máquinas | **`bitbang serve`** |
| Lo que un navegador en el otro extremo obtiene | el servidor web que ya estabas ejecutando | nada — necesita su cliente | **una terminal, un explorador de archivos y aplicaciones web en la red remota** |
| Ruta de datos | sus servidores | P2P (respaldo por relevo) | **P2P (respaldo por relevo)** |
| Cifrado de extremo a extremo | No por defecto | Sí | **Sí** |
## Recetas rápidas
**Accede a un servicio en casa**
- [Monta tu NAS doméstico desde cualquier lugar (SMB)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#mount-your-home-nas-from-anywhere-smb)
- [Mira tu biblioteca multimedia desde cualquier lugar (Jellyfin)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#watch-your-media-library-from-anywhere-jellyfin)
- [Usa tu propio LLM desde cualquier lugar (Ollama, Open WebUI)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#use-your-own-llm-from-anywhere-ollama-open-webui)
- [Revisa tus cámaras de seguridad (Frigate)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#check-your-security-cameras-frigate)
- [Accede a tu automatización del hogar sin exponerla (Home Assistant)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-your-home-automation-without-exposing-it-home-assistant)
- [Imprime en tu impresora doméstica (IPP, CUPS)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#print-to-your-home-printer-ipp-cups)
**Entra en una máquina**
- [Obtén un shell en una máquina detrás de NAT](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#get-a-shell-on-a-machine-behind-nat)
- [Obtén un shell desde tu teléfono](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#get-a-shell-from-your-phone)
- [Escritorio remoto en una máquina Windows (RDP)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#remote-desktop-into-a-windows-machine-rdp)
- [Accede a un escritorio Linux o Mac (VNC)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-a-linux-or-mac-desktop-vnc)
- [SSH a una máquina sin puerto abierto (OpenSSH)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#ssh-to-a-machine-with-no-open-port-openssh)
- [Configura una Raspberry Pi sin cabeza](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#set-up-a-headless-raspberry-pi)
**Comparte con otra persona**
Compartir simplemente implica darle a alguien una URL única o un código QR que le otorgue acceso. Los permisos se pueden personalizar y configurar para que caduquen en minutos, horas, etc.
- [Comparte archivos sin subirlos a ningún lugar](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#share-files-without-uploading-them-anywhere)
- [Muéstrale tu proyecto a alguien](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#show-someone-your-project)
- [Dale a alguien un acceso que caduque](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#give-someone-access-that-expires)
- [Revisa tu sesión de agente desde tu teléfono (Claude Code, tmux)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#check-your-agent-session-from-your-phone-claude-code-tmux)
- [Arregla el router de otra persona](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#fix-someone-elses-router)
**Desarrollo y dispositivos**
- [Accede a una base de datos desde tu máquina de desarrollo (Postgres, MySQL)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#reach-a-database-from-your-dev-machine-postgres-mysql)
- [Sincroniza dispositivos que no pueden encontrarse entre sí (Syncthing)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#sync-devices-that-cannot-find-each-other-syncthing)
- [Observa un robot desde un navegador (ROS, Foxglove)](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#watch-a-robot-from-a-browser-ros-foxglove)
**Técnicas**
- [Lo que expone un listener de reenvío](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#what-a-forwarding-listener-exposes)
- [Permite que otras máquinas de tu LAN usen un reenvío](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#let-other-machines-on-your-lan-use-a-forward)
- [Se sabe que no funciona](https://github.com/richlegrand/bitbang/blob/main/cookbook.md#known-not-to-work)
## Usar `bitbang`
Cada conexión tiene dos extremos: un **listener** (`bitbang serve`, que se ejecuta en la máquina a la que se accede) y un **connector** (un navegador, o la CLI de `bitbang`, en la máquina que realiza el acceso). Una URL de listener sirve para ambos tipos de connector.
### El listener: `bitbang serve````
bitbang 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 uno imprime un código QR, una URL y un código de emparejamiento. El modo determina qué puede hacer el oyente en absoluto: serve shell no tiene reenvío que conceder, y un oyente solo de reenvío nunca inicia un shell, por lo que no hay nada que escalar.