Transmita seu terminal
Termbridge executa um servidor local, cria um túnel por Cloudflare e transmite sua sessão tmux para qualquer navegador.
npx termbridgeVersão mais recente 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claudeNa prática
Inicie no computador e abra o terminal em outro dispositivo.
Do laptop ao celular
npx termbridge inicia um servidor local, uma sessão tmux e um túnel Cloudflare, depois exibe um código QR com um link de login de uso único.
Ao escanear o código, o token é resgatado e convertido em uma sessão de cookie. Adicione --proxy 5173 para mostrar seu servidor de desenvolvimento em uma visualização Preview ao lado do terminal.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173Pronto para dispositivos móveis
Escaneie o código QR e abra o terminal no navegador do celular.
Terminal de verdade
tmux + node-pty fornecem um PTY real ao xterm.js com cores e TUIs.
Túnel Cloudflare
O Quick Tunnel expõe seu servidor local sem encaminhamento de portas.
Login com token
O link QR contém um token de uso único válido por 90 segundos. Ao resgatá-lo, um cookie de sessão HttpOnly e Secure é definido, com verificações de CSRF e 5 resgates por minuto. As sessões não expiram.
Várias sessões
Um servidor pode hospedar várias sessões tmux com alternância no aplicativo.
Um comando
npx termbridge inicia o servidor, o túnel Cloudflare e o código QR. Requer Node 20+, tmux e cloudflared em macOS ou Linux; Windows não é compatível.
Terminal CLI primeiro
Desenvolvido para priorizar o terminal, com status TTY e saída QR.
Acesso com QR
Cada execução exibe um código QR com um link de login de uso único. Escaneie-o no dispositivo que deseja usar.
Pré-visualização do servidor de desenvolvimento
Use um proxy para seu aplicativo local Vite e visualize-o ao lado do terminal.
Encaminhamento de HMR
O proxy de WebSocket mantém o Hot Module Replacement do Vite funcionando.
Alternância de visualização
Alterne entre Terminal e Visualização pela folha Views na barra inferior.
Fluxo de trabalho full-stack
Execute comandos no terminal e acompanhe a atualização do seu aplicativo em tempo real.
Por que Termbridge
Sem encaminhamento de portas ou VPN
Um Quick Tunnel Cloudflare sem conta dá ao seu servidor local um HTTPS URL público. O dispositivo usado para se conectar só precisa de um navegador.
Programas em tela cheia funcionam
node-pty se conecta ao tmux e informa um terminal de 256 cores, para que TUIs como htop e vim se comportem como localmente.
As sessões continuam após a conexão
Ctrl+C fecha o túnel e o servidor, mas mantém suas sessões tmux em execução. Inicie novamente com --session para se conectar a uma sessão existente.
Executa na sua máquina
O servidor, o WebSocket e o registro de terminais ficam no seu computador e, por padrão, escutam em 127.0.0.1. Termbridge não opera nenhum back-end próprio.
Comparação com
Outras formas de acessar um terminal de outro dispositivo e como Termbridge se diferencia.
| Ferramenta | Ideal para | Diferenças em relação a Termbridge |
|---|---|---|
| ttyd | Ideal parattyd compartilha qualquer comando pela Web com entrada CJK e IME, transferência de arquivos ZMODEM e trzsz, imagens Sixel, SSL e autenticação básica, e funciona em macOS, Linux, nos BSDs, no OpenWrt e em Windows. | Diferenças em relação a TermbridgeTermbridge adiciona o túnel, um link de login QR de uso único e uma barra de controle para celular, além de manter o shell em tmux para que ele sobreviva a uma reinicialização. Foi desenvolvido para macOS e Linux. |
| sshx | Ideal parasshx compartilha um terminal com qualquer pessoa usando um único comando, em uma tela infinita na qual colaboradores veem os cursores uns dos outros, com criptografia de ponta a ponta e binários para Linux, macOS e Windows. | Diferenças em relação a TermbridgeTermbridge serve para acessar seu próprio terminal: cada execução emite um link de login que funciona uma vez, e o tráfego passa por um túnel Cloudflare até o servidor na sua máquina. |
| Tailscale SSH | Ideal paraTailscale SSH deixa a Tailscale gerenciar a autenticação e a autorização de conexões SSH na sua tailnet, criptografadas com WireGuard e chaves de nó, a partir de qualquer dispositivo com Tailscale. | Diferenças em relação a TermbridgeTermbridge não exige cliente nem rede privada no outro dispositivo. Ele fornece um URL público e um código QR, e o terminal abre no navegador. |
Fontes, marcado
Perguntas e respostas
Respostas curtas da documentação do Termbridge.
No modo padrão, ele passa por um Quick Tunnel Cloudflare a caminho do servidor Termbridge no seu computador. Termbridge não opera nenhum back-end próprio. No modo sandbox de Daytona, o terminal é executado em uma sandbox na sua conta Daytona; no modo direto, o servidor também é executado nela e você se conecta pelo link de visualização Daytona.
O link QR contém um token de uso único, válido por 90 segundos. Ao resgatá-lo, um cookie de sessão HttpOnly é definido, e as conexões WebSocket do terminal também precisam de um token CSRF. Não compartilhe o código QR nem o URL com pessoas em quem não confia.
Sim. Defina TERMBRIDGE_SESSIONS=3 para iniciar três sessões tmux e depois alterne entre elas usando o seletor de terminais no aplicativo.
Não oficialmente. Termbridge foi desenvolvido para macOS e Linux. Talvez funcione com WSL, mas isso não foi testado.
Ainda não. Cloudflare é o único provedor de túnel. Você pode usar um túnel nomeado Cloudflare no seu próprio nome de host, desativar o túnel e fornecer seu próprio URL público ou usar o modo direto Daytona.
No modo local, a conexão dura enquanto Termbridge estiver em execução e é encerrada quando o computador entra em suspensão ou Termbridge sai. Suas sessões tmux continuam ativas, então você pode iniciar Termbridge novamente, escanear o novo código QR e se conectar com --session. No modo direto Daytona, o servidor é executado dentro da sandbox.
Instale Node 20+, tmux e cloudflared, execute npx termbridge e escaneie o código QR para abrir o terminal no navegador do celular.