Repolode
butlerx

butlerx/wetty

Emulador de terminal acessado pelo navegador, servido por HTTP/HTTPS e construído com xterm.js e WebSockets.

Estrelas
5,479
Forks
771
Issues abertas
15
Último commit
ontem

O que é?

O WeTTY oferece um shell no navegador. Ele executa um servidor Node.js que disponibiliza uma página de terminal xterm.js e encaminha a entrada e a saída para um shell local ou servidor SSH por WebSockets. Em comparação com terminais antigos de navegador, como Ajaxterm e Anyterm, ele usa WebSockets em vez de consultas periódicas via Ajax, mantendo baixo o tempo de resposta às teclas.

Quando executado como root, o WeTTY inicia /bin/login para que os usuários informem um nome de usuário. Caso contrário, inicia o ssh e se conecta ao localhost por padrão; também é possível configurá-lo para se conectar a um host remoto usando as opções de host, porta e usuário do SSH. A autenticação pode ser feita por senha ou chave pública, e o servidor exige uma lista explícita de origens de navegador permitidas. Ele pode ser executado via npm, a partir de uma imagem Docker ou atrás de um proxy reverso, como nginx ou traefik, para oferecer HTTPS.

Recursos principais

  • 01Executa um emulador de terminal completo no navegador via xterm.js.
  • 02Usa WebSockets (Socket.IO) para transmitir entradas e saídas com baixa latência.
  • 03Conecta-se a um shell de login local ou a um servidor SSH remoto.
  • 04Oferece suporte à autenticação SSH por senha e chave pública.
  • 05Exige uma lista de origens permitidas e oferece um caminho base configurável.
  • 06Disponível como pacote npm e imagem Docker.

Casos de uso

  • Dar aos membros da equipe acesso a um shell em um servidor pelo navegador, sem precisar de um cliente SSH nativo.
  • Disponibilizar um terminal web em uma máquina interna atrás de um proxy reverso.
  • Acessar um servidor doméstico ou máquina de laboratório usando um dispositivo sem aplicativo de terminal.

Início rápido

  1. 1

    Instale o WeTTY globalmente com npm

    npm -g i wetty
  2. 2

    Inicie o WeTTY com uma origem de navegador permitida

    wetty --allowed-origin http://yourserver:3000
  3. 3

    Abra o endereço do servidor no navegador e faça login

Antes de usar

  • Requer node 20 ou mais recente e ferramentas de compilação como make, python e build-essential.
  • Requer a configuração explícita de --allowed-origin antes de aceitar conexões.
  • Oferece acesso completo ao terminal, portanto deve ser protegido com HTTPS e um proxy reverso.

Em coleções

Tópicos

Perguntas frequentes

O que é wetty?
Emulador de terminal acessado pelo navegador, servido por HTTP/HTTPS e construído com xterm.js e WebSockets. O WeTTY oferece um shell no navegador. Ele executa um servidor Node.js que disponibiliza uma página de terminal xterm.js e encaminha a entrada e a saída para um shell local ou servidor SSH por WebSockets. Em comparação com terminais antigos de navegador, como Ajaxterm e Anyterm, ele usa WebSockets em vez de consultas periódicas via Ajax, mantendo baixo o tempo de resposta às teclas.
wetty é gratuito? Qual é a licença?
wetty é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
wetty ainda é mantido?
Manutenção ativa. O último commit de wetty foi em 6 de nov. de 2026.
Para que posso usar wetty?
Dar aos membros da equipe acesso a um shell em um servidor pelo navegador, sem precisar de um cliente SSH nativo. Disponibilizar um terminal web em uma máquina interna atrás de um proxy reverso. Acessar um servidor doméstico ou máquina de laboratório usando um dispositivo sem aplicativo de terminal.
Como instalar wetty?
Instale o WeTTY globalmente com npm: npm -g i wetty Inicie o WeTTY com uma origem de navegador permitida: wetty --allowed-origin http://yourserver:3000 Abra o endereço do servidor no navegador e faça login
Onde consigo wetty?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/butlerx/wetty

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados