SSH, SFTP e ferramentas remotas

Você pode

• Busque com Buscar hosts…: ela procura no nome, no hostname e nas tags.
• Filtre com os chips de grupo: Todos e um chip por grupo e subgrupo (o chip de um grupo inclui seus subgrupos). Gerenciar grupos abre o gerenciador de grupos.
• Com um grupo selecionado, Conectar todos (N) conecta todos os hosts dele e dos seus subgrupos.
• Os hosts com estrela ficam em Favoritos e os demais em Todos os hosts.
• Toque em um host para conectar. O menu de cada cartão tem Conectar, Favoritar, Editar e Excluir.
• Adicionar host abre o formulário; Rápido abre Conexão rápida.
• No gerenciador de grupos, Novo grupo pede um Nome, um Grupo pai, um Tema (herdado pelos hosts) e Gravar sessões automaticamente: os hosts desse grupo e dos subgrupos iniciam o registro da sessão (o selo LOG) assim que conectam. Excluir grupo deixa os hosts dele sem grupo.

Você não pode, e por quê

• Salvar um segundo host no Grátis, por qualquer porta: Adicionar host, Conexão rápida, as importações (JSON, SSH config, CSV) e a importação de instâncias de nuvem param em 1 host salvo e mostram o aviso Terminal Pro. O limite é 1 host salvo.Pro
• Dar a um grupo inteiro um proxy, uma identidade padrão ou variáveis de ambiente: em um grupo só dá para definir o tema e Gravar sessões automaticamente.Ainda não

Você pode

• Conexão: um Rótulo opcional, o Hostname, a Porta (22 por padrão) e o Usuário.
• Autenticação → Método de autenticação: Senha, Par de chaves ou Teclado interativo. A senha é guardada criptografada; ao editar um host o campo mostra (inalterada).
• Com Par de chaves, escolha uma chave de Chaves SSH (as vinculadas ao dispositivo são marcadas), ou escolha Colar manualmente e cole a chave privada, com a Senha da chave se ela tiver uma. O campo da senha não aparece para chaves vinculadas ao dispositivo.
• Com Teclado interativo, o servidor pede o que precisar durante a conexão, por exemplo um código de uso único: Você será solicitado durante a conexão.
• Usar identidade preenche o usuário e a credencial a partir de uma identidade salva; Salvar como identidade salva os atuais. Uma identidade é um modelo copiado para o host, não um vínculo ativo: mudá-la depois não altera os hosts que já a usaram.
• Organização: escolha um Grupo e adicione Tags separadas por vírgulas.
• Avançado: Proxy / Jump host com um proxy SOCKS5 ou HTTP (host e porta); Host de salto, outro host salvo usado como bastião, até 3 saltos, que aparece quando você tem outro host salvo; e a chave Encaminhamento do agente.
• Escolha uma Cor e marque o host como favorito com a estrela.

Você não pode, e por quê

• Definir um comando de inicialização ou redirecionamentos de porta salvos em um host: o formulário não tem campos para isso, e salvar um host pelo formulário apaga os dois.Ainda não
• Usar o chip SSH Jump Host sozinho: ele é mantido por causa de dados antigos e não faz nada. O salto de verdade é a lista Host de salto.Ainda não

Você pode

• Digite user@host ou user@host:porta em String de conexão; um endereço IPv6 vai entre colchetes, user@[::1]:22. Uma prévia mostra o usuário, o host e a porta.
• Digite a senha em Senha (opcional) e toque em Conectar. O botão fica desativado até o texto conter um @.
• O host é salvo em Hosts antes de conectar, se o plano tiver espaço. No Grátis, com 1 host já salvo, ele conecta mesmo assim, mas o novo host não é salvo e o aviso Terminal Pro abre.

Você não pode, e por quê

• Conectar com uma chave ou com um código de uso único: a Conexão rápida sempre cria um host de Senha, e sem senha a aba mostra Error: No password stored for this host. Use Adicionar host para chaves e Teclado interativo.Ainda não

Você pode

• Leia o Host, o Tipo de chave e o Fingerprint (no formato SHA256:) e compare com o que o seu servidor mostra.
• Um servidor novo mostra Verificar chave do host: Confiar e conectar salva a chave e continua; Rejeitar cancela.
• Se a chave salva e a do servidor forem diferentes, o diálogo se chama A chave do host mudou!, mostra a Impressão digital anterior e avisa de um possível ataque man-in-the-middle. Continue só se souber que o servidor foi reinstalado ou reconfigurado.
• Se você não responder em 60 segundos, a conexão é recusada.

Você não pode, e por quê

• Ver ou remover a lista de servidores confiáveis: não existe tela para isso. Você pode adicionar entradas importando um arquivo known_hosts.Ainda não

Você pode

• Responda a cada solicitação no campo Resposta N correspondente (o texto fica oculto ou visível conforme o servidor pedir) e toque em Enviar. Cancelar desiste da tentativa.
• Você tem 120 segundos para responder.

Você não pode, e por quê

• Salvar as respostas: toda conexão pergunta de novo.De propósito

Você pode

• Identifique as chaves vinculadas ao dispositivo pelo selo Vinculada ao dispositivo.
• Importar um arquivo de chave privada do celular com o seletor de arquivos do sistema; o nome do arquivo vira o rótulo.
• Gerar chave cria um novo par (próxima seção).
• Copiar chave pública coloca a chave pública na área de transferência.
• Implantar acrescenta a chave pública a ~/.ssh/authorized_keys no servidor da sessão em foco, criando a pasta com modo 700 e o arquivo com modo 600. O botão aparece enquanto uma sessão está aberta. A aba mostra [Key deployed to authorized_keys] depois que o comando é executado; o PocketCode não verifica o resultado dele, então teste a chave em seguida.
• Excluir remove a chave; no caso de uma chave vinculada ao dispositivo, também a apaga do Android Keystore.

Você não pode, e por quê

• Copiar ou implantar a chave pública de uma chave importada: o app não guarda chave pública para importações (o cartão mostra imported no lugar da impressão digital). Uma chave importada só assina conexões.Ainda não
• Exportar a chave privada de uma chave vinculada ao dispositivo: ela nunca sai do Android Keystore.De propósito

Você pode

• Preencha o Rótulo da chave e escolha um Tipo de chave com seu Tamanho em bits: RSA (2048 ou 4096, com 4096 pré-selecionado), ED25519 (256), ECDSA (256, 384 ou 521), DSA (1024) ou DEVICE-BOUND.
• Adicione uma Passphrase opcional à chave privada (não vale para DEVICE-BOUND).
• DEVICE-BOUND cria uma chave ECDSA P-256 dentro do Android Keystore. A chave privada não pode ser exportada, copiada nem sincronizada; só a chave pública sai do celular. Exigir biometria/PIN recente para assinar vem ativado por padrão: a chave só assina nos 30 segundos seguintes à sua autenticação com biometria ou PIN do dispositivo. O PocketCode não mostra um aviso próprio ao conectar.

Você não pode, e por quê

• Usar uma chave vinculada ao dispositivo em outro celular ou restaurá-la a partir de um backup.Dispositivo

Você pode

• Um toque longo em uma aba abre Renomear, Duplicar sessão (para abas que vieram de um host salvo) e Fechar outros separadores (quando há mais de uma).
• Fechar uma aba que ainda está conectada pergunta Fechar sessão ativa?: fechar desconecta e encerra os redirecionamentos de porta dela. Fechar outros separadores sempre pergunta.
• Quando a rede volta, o PocketCode reconecta sozinho as sessões que caíram. A opção fica em Configurações → Terminal → Reconexão automática do terminal, ativada por padrão. A aba mostra [Network connection lost] e depois [Network restored — reconnecting…].

Você não pode, e por quê

• Ter mais de uma sessão aberta no Grátis: abrir outra aba, conectar um segundo host, Duplicar sessão e Shell multiplexado mostram o aviso Terminal Pro. O limite é 1 sessão SSH ativa; um shell local na tela Terminal é contado à parte.Pro
• Manter as sessões rodando em segundo plano sem ajuda do Android: ele pode pausar ou derrubar as sessões SSH e os redirecionamentos de porta quando você troca de app, a menos que o PocketCode fique fora da otimização de bateria. O app pergunta uma vez: Mantenha as sessões SSH ativas em segundo plano → Abrir configurações.Dispositivo

Você pode

• Shell multiplexado abre outro shell na mesma conexão SSH, em uma nova aba chamada <host> (mux).
• Broadcast envia cada comando que você digita para todas as abas conectadas ao mesmo tempo; as abas de shell local que estiverem conectadas também o recebem. Enquanto está ativo, o selo BROADCAST aparece; toque em Broadcast desativado para parar.

Você não pode, e por quê

• Usar o Broadcast no Grátis: ele mostra o aviso Terminal Pro.Pro
• Chegar ao Broadcast e ao Shell multiplexado pelo painel fixo em uma tela larga: eles existem só no menu de ferramentas, que o layout fixo esconde. Deixe a janela mais estreita que cerca de 660 dp, ou ative a divisão de tela (Pro), para o menu voltar.De propósito

Você pode

• Navegue pelo servidor: pastas primeiro, depois arquivos, cada linha com suas permissões e, nos arquivos, o tamanho. Toque em uma pasta para abri-la e use a seta de voltar para subir.
• Nova pasta e, no menu Mais opções de uma linha, Renomear ou Excluir.
• Segure uma linha para começar a selecionar, toque para adicionar mais e exclua todas juntas. O app pergunta Excluir N itens selecionados? Isso não pode ser desfeito. Cada item é excluído separadamente, então uma falha não interrompe os demais.
• Visualização de dois painéis muda para o layout de dois painéis.

Você não pode, e por quê

• Baixar, enviar ou abrir um arquivo por esta visualização: tocar em um arquivo não faz nada, só as pastas abrem.Ainda não
• Excluir uma pasta que ainda tem arquivos: as pastas são removidas com a chamada rmdir do SFTP, então esvazie-as antes.De propósito
• Ver por que uma operação falhou: os erros não são exibidos. Uma pasta que não pode ser lida parece vazia (Este diretório está vazio), e um renomear ou excluir que falha deixa a lista como estava.Ainda não

Você pode

• O painel Local começa na pasta que guarda seus projetos; o painel Remoto começa em /. Toque em uma pasta para abri-la e use a seta no alto de um painel para subir.
• Volte com Visualização de painel único.

Você não pode, e por quê

• Copiar um arquivo entre os painéis arrastando: a tela oferece isso, mas o soltar ainda não está ligado à transferência, então nada é copiado.Ainda não

Você pode

• Ver as transferências na fila (À espera, Concluída, Falhou), cancelar uma ou limpar as finalizadas com Limpar concluídas.

Você não pode, e por quê

• Adicionar uma transferência à fila: nada no app envia arquivos para ela por enquanto, então ela sempre mostra Nenhuma transferência ativa.Ainda não

Você pode

• Toque em Anexar arquivo e escolha um arquivo: ele é enviado por SFTP para /tmp/<file name> no servidor, e o caminho é digitado na barra de entrada, pronto para o próximo comando.

Você não pode, e por quê

• Escolher o destino ou manter um arquivo existente: o arquivo sempre vai para /tmp, e um com o mesmo nome é sobrescrito.De propósito

Você pode

• Adicionar regra abre um formulário: Tipo (Local (L), Remoto (R) ou Dinâmico), Rótulo, Porta local, Host remoto (pré-definido como localhost), Porta remota e Iniciar automaticamente.
• Local (L) escuta em uma porta do seu celular e envia o tráfego pelo servidor até a Porta remota do Host remoto, como o servidor o enxerga. Por exemplo, acessar um banco de dados do servidor por localhost:5432.
• Remoto (R) escuta na Porta remota do servidor e envia o tráfego para a Porta local do Host remoto, alcançada a partir do celular (localhost por padrão). Por exemplo, expor um servidor de desenvolvimento que roda no celular.
• Cada regra mostra Ativo ou Parado; inicie, pare ou exclua.
• Fechar a aba ou desconectar encerra os redirecionamentos da sessão.

Você não pode, e por quê

• Ter mais de 1 regra por vez no Grátis (contada na sessão em foco).Pro
• Usar Dinâmico como proxy SOCKS: a regra aparece como Proxy SOCKS e registra SOCKS5 proxy on localhost:N, mas o app a implementa como um simples redirecionamento dessa porta para localhost no mesmo número de porta, não como um proxy SOCKS5.Ainda não
• Manter as regras entre sessões: elas não são salvas com o host, então Iniciar automaticamente não tem o que iniciar na próxima conexão.Ainda não

Você pode

• Nova conexão: protocolo VNC (porta 5900) ou RDP (3389), um rótulo, host, porta, um usuário (RDP) e uma senha, um nível de qualidade e Somente visualização.
• Conectar abre uma conexão direta com aquele host e porta (sem passar pelo SSH), faz o handshake VNC (sem autenticação ou com uma senha VNC) e mostra Connected: com o nome do servidor e o tamanho da tela em uma nova aba, além de qualquer sinal sonoro ou texto de área de transferência que o servidor enviar.

Você não pode, e por quê

• Ver ou controlar a tela remota: a conexão lê as atualizações de tela e as descarta, e não há visualização nem entrada de mouse ou teclado.Ainda não
• Usar RDP: escolher RDP executa o mesmo código de VNC e não existe cliente RDP.Ainda não

Você pode

• Veja os Dispositivos detectados, os dispositivos USB que o Android informa.
• Adicionar configuração: Dispositivo (vazio = auto), Baud (115200 por padrão), Bits (8), Stop (1) e um menu de paridade chamado Paridad (Ninguna, Impar, Par, Mark, Space). Esse menu e os botões Guardar e Cancelar estão em espanhol, seja qual for o idioma do app.
• O botão de reproduzir de uma configuração salva conecta: ele localiza o dispositivo pela API de host USB do Android, abre a interface de dados serial dele e define a codificação da linha; a aba mostra Connected to … quando dá certo.
• Na primeira vez, o próprio diálogo do Android pede permissão para usar o dispositivo USB (a aba mostra Requesting USB permission for <device>…). Permita e a conexão segue; o PocketCode espera sua resposta por até 60 segundos.

Você não pode, e por quê

• Conectar depois de recusar a permissão de USB, ou depois de 60 segundos sem responder ao diálogo: a aba mostra USB permission not granted for <device> e a sessão termina em erro. Toque em reproduzir de novo para tentar outra vez.Dispositivo
• Usar um adaptador que não expõe uma interface de dados CDC ou específica do fabricante com endpoints bulk: a aba mostra USB device does not have expected CDC serial endpoints.Dispositivo

Você pode

• Toque em um chip para executar a CLI desse provedor no servidor da sessão em foco (aws ec2 describe-instances, gcloud compute instances list, az vm list, doctl compute droplet list, kubectl get pods, docker ps). A CLI precisa estar instalada no servidor. A aba mostra [Cloud discovery (AWS): N bytes received].
• Importar instâncias (JSON): cole um array JSON como [{"provider":"AWS","name":"…","publicIp":"…"}]. Toda instância com endereço IP é salva como host (usuário root, porta 22, com a tag do provedor) e aparece em Instâncias (N) com Conectar. No Grátis, só viram hosts as que cabem no limite de 1 host, mas toda instância continua aparecendo em Instâncias (N); para as demais o aviso Terminal Pro abre.

Você não pode, e por quê

• Importar instâncias automaticamente: a descoberta só mostra quantos bytes a CLI devolveu e não transforma a saída em instâncias. O JSON precisa ser colado.Ainda não
• Conectar a uma instância importada sem adicionar credenciais antes: os hosts importados são hosts de Senha sem senha salva. Edite o host para informar uma senha ou escolher uma chave.Ainda não

Você pode

• Adicionar watchdog: Rótulo, Comando (pré-definido como systemctl is-active nginx), Saída esperada (pré-definida como active) e Intervalo (segundos) (pré-definido em 60).
• Inicie ou pare um monitor com a chave dele, ou exclua-o. A primeira verificação roda depois de um intervalo.
• Cada verificação executa o comando na sessão que estava em foco quando você iniciou o monitor. Se a saída não contiver o texto esperado (maiúsculas e minúsculas são ignoradas), a aba mostra ⚠ Watchdog alert: <command> → <output> e o monitor é marcado como falho.

Você não pode, e por quê

• Criar um watchdog no Grátis.Pro
• Receber uma notificação do sistema: os alertas são linhas na aba do terminal, e os monitores só funcionam enquanto o app está em execução.De propósito
• Vincular um monitor a um único host: ele roda na sessão que estiver em foco quando você o inicia.De propósito

Você pode

• Criar webhook: Nome, Selecionar host e Comando. Cada webhook mostra seu link, pocketcode://terminal/webhook/<id>?secret=<secret>, mascarado na tela e com um botão de copiar, além de uma chave Ativo / Inativo, N execuções e Excluir.
• Quando algo abre o link, o PocketCode confere o id e o segredo. Só se o webhook estiver ativo e os dois conferirem ele pergunta Executar a automatização? (Um link pediu para executar a regra «X» em HOST.). Executar conecta ao host e envia o comando; Cancelar não faz nada. Um segredo errado não recebe resposta nenhuma.

Você não pode, e por quê

• Criar um webhook no Grátis.Pro
• Executar um webhook sem supervisão: todo acionamento pede sua confirmação antes.De propósito
• Acionar um webhook pela web: existe apenas o link pocketcode://. O app não abre uma porta de escuta no seu celular para executar comandos nos seus servidores.De propósito

Você pode

• Liste os pacotes instalados no host (ele lê pkg list-installed e, se falhar, dpkg -l, mantendo os instalados), busque com Buscar pacotes… e atualize.
• Atualizar todos (apt update && apt upgrade -y), Listar todos, Limpar (apt autoclean) e Instalar (pergunta Digite o nome do pacote: e executa apt install <name> -y).
• Em um pacote: as informações dele (apt show) e a remoção (apt remove <name> -y).

Você não pode, e por quê

• Usar outro gerenciador de pacotes (yum, dnf, apk…): os comandos são fixos em apt.Ainda não
• Executar comandos com sudo automaticamente: eles rodam como o seu usuário SSH, exatamente como digitados, então em um servidor onde esse usuário não é root podem falhar com erro de permissão.De propósito

Você pode

• Sincronizar gera um backup dos seus hosts, dos seus snippets e de algumas configurações do terminal; as chaves em Dados a sincronizar escolhem o que entra. Última sincronização mostra quando ele rodou.
• Conexões na sua conta (um caminho separado deste backup): com Ativar sincronização ligado no diálogo Sincronização de ajustes das Configurações (Cloud Sync, um recurso Pro) e Conexões (SSH/DB) marcada, salvar, editar, favoritar ou excluir um host envia os dados dele para a sua conta do PocketCode: nome, endereço, porta, usuário, tipo de autenticação, tags, favorito, grupo, proxy e a configuração de encaminhamento de agente. Senhas, chaves, senhas de chave e o comando de inicialização ficam no celular. Hosts que chegam pelas importações de JSON, SSH config ou CSV não são enviados. A mesma caixa também leva as conexões do módulo de Banco de Dados, mas só com o seu próprio conjunto, mais curto, de dados (nome, host, porta, motor e grupo): nunca usuário nem senha. Com o Cloud Sync desligado, ou essa caixa desmarcada, nada é enviado.
• Criptografia end-to-end → Ativar criptografia pede uma Senha mestre e criptografa o backup com AES-256-GCM, com uma chave derivada da senha (PBKDF2, 100.000 rodadas). Não pode ser recuperada se esquecida.

Você não pode, e por quê

• Recuperar em outro dispositivo os hosts sincronizados: o app guarda a lista que baixa, mas nada a transforma em hosts.Ainda não
• Enviar este backup a outro dispositivo ou a uma nuvem: o backup é gravado em um arquivo dentro do app (terminal_sync_backup.json) e nada é enviado; o app não tem como restaurar a partir dele.Ainda não
• Incluir chaves SSH: a chave Chaves SSH existe, mas o backup nunca contém chaves.Ainda não

Você pode

• Hospedar sala: dê a ela um Nome da sala e compartilhe o Código de 6 dígitos que ela mostra.
• Entrar em uma sala: as salas próximas são encontradas na rede local, ou você digita o Código de 6 dígitos. Quem hospeda vê Nova solicitação (N quer entrar) e toca em Aceitar ou Rejeitar.
• A lista de membros mostra o papel de cada um: Somente leitura, Leitura e escrita ou Admin. Quem hospeda pode mudar papéis e remover membros; qualquer pessoa pode Sair da sala e quem hospeda pode Encerrar sala.
• O tráfego entre os dispositivos é criptografado (acordo de chaves ECDH e AES-GCM). No Android 13 e posteriores, na primeira vez que você hospeda uma sala, procura salas ou entra em uma, o Android pede a permissão de dispositivos próximos (rede local); até você concedê-la, essas três ações ficam bloqueadas.

Você não pode, e por quê

• Compartilhar hosts ou snippets em uma sala: a dica diz para hospedar ou entrar em uma sala para compartilhá-los ao vivo, mas hoje só funcionam membros e papéis.Ainda não
• Usar uma sala fora da sua rede local: a descoberta e a conexão são só pela LAN.Precisa de rede
• Manter uma sala depois que o app reinicia: a sala existe só enquanto está ativa.De propósito

Você pode

• O JSON contém seus hosts (nome, endereço, porta, usuário, tipo de autenticação, tags, cor, favorito e comando de inicialização), seus grupos (nome, cor, ícone) e seus próprios snippets, não os predefinidos.

Você não pode, e por quê

• Exportar senhas, chaves ou configurações: elas nunca estão no JSON. Importá-lo de volta recria os grupos, mas não coloca os hosts de volta neles.Ainda não
• Criptografar a exportação com uma senha, salvá-la como arquivo ou mostrá-la como QR code: o texto é puro e copiar e colar é o único caminho de entrada e saída.Ainda não

Você pode

• JSON: a exportação acima. Hosts já salvos (mesmo hostname, porta e usuário) são ignorados.
• SSH config: cada bloco Host vira um host; blocos com padrão curinga, como Host *, são ignorados. Um bloco com IdentityFile vira um host de Par de chaves sem a chave, e ProxyJump vira um Host de salto quando aponta para um host que existe.
• known_hosts: entradas em texto simples viram servidores confiáveis; entradas com hash (o padrão do OpenSSH) não podem ser recuperadas e são ignoradas.
• CSV: precisa de uma linha de cabeçalho. Colunas reconhecidas: label (ou name), hostname (ou host, address), port, username (ou user) e group (ou folder); só o hostname é obrigatório. Um grupo é encontrado pelo nome ou criado.

Você não pode, e por quê

• Importar de um arquivo ou de um QR code: a tela aceita apenas texto colado.Ainda não
• Importar senhas ou chaves: nenhum formato as carrega, então os hosts importados precisam de credenciais adicionadas em Editar host.De propósito