Shell In A Box – Acesso SSH via Navegador no Debian

Repositório de Conhecimentos – Programação e Servidores – DevData

Precisa de um terminal acessível por navegador, direto e funcional? O shellinabox entrega exatamente isso. Sem interface gráfica, sem plugins, sem exageros. Apenas terminal, por HTTPS.


O que é o Shell In A Box

Shell In A Box (ou shellinabox) é um pequeno servidor que fornece acesso SSH via navegador. Ele cria uma interface web baseada em JavaScript que simula um terminal UNIX real, acessível remotamente através do navegador.

Ideal para cenários como:

  • Ambientes de laboratório
  • Painéis internos de gerenciamento
  • Acesso remoto simplificado
  • Soluções embarcadas que não contam com um terminal físico

Instalação no Debian

sudo apt update
sudo apt install shellinabox

Isso instala o serviço padrão, que já inicia automaticamente.


Configuração

O arquivo principal de configuração é:

/etc/default/shellinabox

Edite com seu editor preferido:

sudo vi /etc/default/shellinabox

Parâmetros recomendados:

SHELLINABOX_PORT=4200
SHELLINABOX_ARGS="--no-beep --disable-ssl-menu -s /:LOGIN"

Significado:

  • SHELLINABOX_PORT: define a porta de escuta
  • --no-beep: desativa sons
  • --disable-ssl-menu: remove o menu de segurança do navegador
  • -s /:LOGIN: mapeia a raiz / para o login do sistema

Acesso via Navegador

Após a instalação, acesse:

https://SEU_IP:4200

Um certificado autoassinado será usado por padrão. Para ambiente de produção, recomenda-se usar certificados válidos.


Alterando Porta e Certificado SSL

Caso deseje trocar a porta ou usar certificados próprios (por exemplo, do Let’s Encrypt), adicione os parâmetros:

--cert=/etc/letsencrypt/live/seudominio/fullchain.pem
--key=/etc/letsencrypt/live/seudominio/privkey.pem

Exemplo completo:

SHELLINABOX_PORT=8443
SHELLINABOX_ARGS="--no-beep --disable-ssl-menu --cert=/caminho/cert.pem --key=/caminho/key.pem -s /:LOGIN"

Reiniciando e Verificando o Serviço

sudo systemctl restart shellinabox
sudo systemctl status shellinabox

Segurança e Firewall

Evite expor a porta diretamente na internet. Recomendado uso restrito via VPN ou firewall.

Exemplo com UFW para restringir à rede local:

ufw allow from 192.168.0.0/24 to any port 4200 proto tcp

Casos de Uso

  • Terminal web para administração local
  • Consoles de recuperação remota
  • Painéis personalizados com acesso terminal
  • Ambientes educacionais e treinamento

Testado em

  • Debian 10, 11, 12
  • Ubuntu 20.04, 22.04
  • Browsers compatíveis: Firefox, Chromium, Brave, Safari

Conclusão

Shell In A Box é uma solução estável, leve e objetiva para acesso SSH via navegador. Sua simplicidade o torna ideal para ambientes controlados e tarefas administrativas específicas.

Rolar para cima