Docs do Shellvana

Cobre a versão 1.0.0. Última atualização: 2026-10-05.

O Shellvana é um cliente SSH para celular. Ele se conecta aos seus próprios servidores por SSH padrão e mostra a saída como texto legível. Esta página cobre a configuração e o uso do dia a dia.

O que você precisa

• Um celular. Um iPhone com iOS 15 ou mais recente, ou um celular Android.
• Um host com sshd padrão. Qualquer máquina Linux, BSD ou macOS que você já consiga acessar com ssh serve. Não há nada para instalar no servidor: nenhum agente, nenhum daemon, nenhum plugin.
• Um caminho de rede até esse host. O Shellvana se conecta direto do seu celular ao endereço que você digita. Se o host só é acessível na sua rede doméstica, conecte antes por uma VPN sua (WireGuard, Tailscale ou parecida). O Shellvana não tem relay nem serviço em nuvem no meio do caminho.

Instalação

Baixe o Shellvana na App Store ou no Google Play. O app é grátis. Não há conta para criar nem nada em que entrar.

Adicionar um host

• Na lista de hosts, toque em + para abrir Adicionar host.
• Preencha Nome (qualquer rótulo), Host (um endereço ou nome de host), Porta (normalmente 22) e Usuário.
• Em Autenticação, escolha Senha ou uma das suas chaves SSH. Se você ainda não tem chaves, a lista oferece só Senha. Veja Chaves SSH.
• Em Grade, escolha o tamanho de terminal que o Shellvana pede ao servidor. Console tem 132 colunas por 40 linhas e serve para o trabalho comum no shell. Agente IA tem 60 colunas por 40 linhas e serve para assistentes de terminal em tela cheia que desenham uma barra lateral. Manual deixa você definir Colunas e Linhas por conta própria.
• Toque em Salvar e depois toque no host para conectar.

Primeira conexão e chaves de host

Na primeira vez que você conecta, o Shellvana mostra o algoritmo e a impressão digital da chave do host do servidor e pergunta Confiar neste host? Compare a impressão digital com a que está no servidor, por exemplo com ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub, e então toque em Confiar.

O Shellvana lembra dessa chave. Se o servidor um dia apresentar outra, você vê o aviso A CHAVE DO HOST MUDOU com a impressão digital anterior e a nova, e a sessão não abre a menos que você digite o nome do host para aceitar a nova chave. Se você não reinstalou nem trocou as chaves do servidor, não aceite.

Algoritmos de chave de host fracos ou antigos são recusados. Se aparecer "O algoritmo de chave de host ... não é permitido", ative no servidor uma chave de host moderna, como Ed25519.

Lendo uma sessão

• Modo leitura. Toda sessão abre no modo leitura. Texto corrido e Markdown são reorganizados em fonte proporcional, no tamanho certo para o celular. Tabelas, diffs, saída em árvore e tudo o que está alinhado em colunas ficam em fonte monoespaçada, com o espaçamento exato.
• Modo terminal. Toque no ícone de terminal na barra superior para ver a grade exata que o servidor enviou. Toque no ícone de leitura para voltar. Os dois modos mostram a mesma sessão, então você não perde nada ao alternar.
• Fonte e tamanho de leitura. Toque no ícone de Fonte de leitura na barra superior para mudar a fonte e o tamanho da leitura.
• Programas em tela cheia. Programas como vim, htop e tmux funcionam normalmente. Quando um deles ocupa a tela, o Shellvana avisa que o layout dele precisa da grade e oferece um botão Grade.
• Links. Um link na saída só abre depois que você confirma para onde ele vai, e abre no seu próprio navegador, fora do app.

Digitando comandos

• Digite no campo de entrada na parte de baixo (Digite um comando) e toque no botão de enviar.
• A fileira de teclas acima do campo envia teclas que o teclado do celular não tem, como Ctrl-C, Tab, Esc, as setas, Ctrl-D e Ctrl-Z.
• Quando a saída parece um pedido de senha, o Shellvana oferece Entrada segura. O texto digitado assim é enviado ao servidor, mas não é guardado nem entra na transcrição.

Chaves SSH

Abra o menu (três pontos) na lista de hosts e escolha Chaves SSH.

• Importar uma chave. Toque em Importar, cole uma chave privada OpenSSH e digite a frase secreta dela, se tiver. A chave é guardada criptografada no dispositivo.
• Gerar uma chave em hardware (Pro). Gerar chave segura cria uma chave dentro do hardware seguro do celular: o Secure Enclave no iPhone, ou o StrongBox ou o keystore apoiado em hardware no Android. A metade privada não sai do dispositivo. Essas chaves são ECDSA P-256, que aparece no servidor como ecdsa-sha2-nistp256.
• Instale a metade pública no servidor. Abra o menu da chave, escolha Copiar chave pública e adicione essa linha ao ~/.ssh/authorized_keys do seu usuário no servidor. Na primeira vez, conecte com senha para fazer isso.
• Use a chave. Edite o host e, em Autenticação, escolha a chave no lugar de Senha.

Mantendo o trabalho vivo após quedas de conexão

O celular derruba conexões: a tela bloqueia, a rede muda, o app vai para segundo plano. Quando o Shellvana reconecta, o servidor entrega um shell novo. Tudo o que rodava no shell antigo se perde, a menos que estivesse rodando sob um multiplexador de terminal.

Para qualquer coisa de longa duração, inicie dentro do tmux ou do screen no servidor. Por exemplo, rode tmux new -A -s main depois de conectar. Se a conexão cair, conecte de novo e rode o mesmo comando para continuar de onde parou.

Configurações de segurança por host

• Exigir desbloqueio para conectar. Desativado por padrão. Quando você ativa para um host, o Shellvana pede sua digital, seu rosto ou o bloqueio de tela antes de abrir uma sessão nele.
• Bloquear capturas de tela. Ativado por padrão. Capturas de tela e a prévia da sessão no alternador de apps ficam bloqueadas. Você pode desativar isso por host.
• Conectar (anônimo) (Pro). No menu de um host, abre uma sessão que não grava nenhuma transcrição.

Histórico e seus dados

• As transcrições das sessões ficam salvas só no celular, criptografadas com SQLCipher. Transcrições com mais de 30 dias se apagam sozinhas.
• Para remover as transcrições salvas de um host, abra o menu desse host e escolha Limpar o histórico deste host. Para remover tudo, abra o menu principal e escolha Limpar todo o histórico.
• Excluir um host o tira da lista, mas mantém as transcrições salvas dele e a chave de host confiável. Limpe o histórico antes se quiser apagar isso também.
• O Shellvana não tem conta, análise de uso nem relatório de falhas. A política de privacidade lista todas as conexões de rede que o app faz.

Grátis e Pro

• Grátis. Uma sessão ao vivo, autenticação por senha e por chave, perfis de host e a renderização legível completa. A leitura não é a parte paga.
• Pro. Uma única compra, sem assinatura. Ele adiciona até quatro sessões simultâneas, autenticação por chave em hardware, todas as fontes de leitura e sessões anônimas.
• Comprar ou restaurar. Abra o menu na lista de hosts e escolha Shellvana Pro. Em um celular novo, toque em Restaurar compra nessa folha.

Solução de problemas

• A conexão expira. Confira se o celular consegue alcançar o host. Se o host está numa rede privada, ligue antes a sua VPN e confira se a porta é a mesma em que o sshd escuta.
• A chave é rejeitada. Confirme que a chave pública de Copiar chave pública está numa única linha no ~/.ssh/authorized_keys do mesmo usuário que o perfil do host indica, e que o servidor aceita esse tipo de chave.
• O layout de um programa fica errado no modo leitura. Mude para o modo terminal. Programas em tela cheia são desenhados para uma grade, e a grade é sempre a saída exata.
• Um assistente em tela cheia aparece cortado. Edite o host, mude Grade para Agente IA e reconecte.
• "Nenhuma compra anterior encontrada." Confira se o celular está logado na mesma conta da App Store ou do Google Play que comprou o Pro e tente Restaurar compra de novo.

Como pedir ajuda

Escreva para [email protected] com o modelo do aparelho e a versão do iOS ou do Android, ou veja a página de suporte.