Documentação
Termiyo, de ponta a ponta
Páginas curtas, na ordem em que você vai precisar delas.
Primeiros passos
Instale o Termiyo
Pegue na página de download a versão para a sua máquina: o .dmg Universal no Mac, o instalador no Windows e o pacote da sua distribuição no Linux. A página explica como conferir e instalar em cada sistema.
Crie o seu cofre
Na primeira vez que você abre o Termiyo, ele pede uma senha mestra. É a única coisa protegendo tudo o que o aplicativo guarda, ela não é enviada a lugar nenhum e não há recuperação — use uma frase com várias palavras sem relação entre si.
Adicione uma identidade
Uma identidade é um usuário mais a forma de autenticar: uma senha, uma chave privada ou um agente. Identidades ficam separadas dos servidores, então o mesmo acesso vale para toda a frota sem ser redigitado.
Adicione um servidor
Dê um endereço e escolha uma identidade. Clique duas vezes para conectar. A primeira conexão mostra a impressão digital da chave do servidor; aceitá-la fixa a chave para todas as reconexões seguintes.
Hosts de salto
Chegar a um servidor privado
Abra o servidor, expanda Advanced e escolha um host de salto. O Termiyo conecta primeiro ao bastião e abre por ele um canal até o destino — o destino nunca precisa ser alcançável da sua máquina.
Cadeias
Um host de salto pode ter o seu próprio. O Termiyo achata o caminho inteiro antes de discar, recusa uma cadeia com laço e diz qual salto falhou quando algum falha.
Encaminhamento de portas
Local
Escuta na sua máquina, entrega do lado do servidor. O caso comum é alcançar um banco de dados que no servidor só escuta em localhost.
Remoto
O inverso: o servidor escuta e as conexões voltam para uma porta da sua máquina. Útil para mostrar uma build local a algo que só alcança o servidor.
Dinâmico (SOCKS5)
O Termiyo roda um proxy SOCKS5 local e manda cada conexão pela sessão, com o destino resolvido na outra ponta. Aponte um navegador para ele e você está navegando a partir do servidor.
Sincronização
Entrar
Settings, Sync. Use a senha que já abre o seu cofre — o Termiyo deriva dela duas chaves separadas, uma que fica aqui e outra que o servidor pode conferir sem nunca aprender a senha.
Uma segunda máquina
Instale o Termiyo, crie um cofre com a mesma senha e entre. Seus servidores, chaves e trechos chegam na primeira sincronização. Nada é decifrado em nenhum lugar além das suas próprias máquinas.
Sair
Remove o token, não os seus dados. O que está na máquina fica nela, ainda cifrado sob a senha do seu cofre.
Pedir um comando
Configurar
Settings, AI e uma chave da API da Anthropic. A chave fica no seu cofre, cifrada como qualquer outra credencial.
Perguntar
Descreva o que você quer. A sugestão cai na sua linha de comando para você ler; o Termiyo nunca executa por você. Tudo que apaga, sobrescreve ou para um serviço vem sinalizado.
O que é enviado
Sua pergunta e o sistema operacional, se o banner de login disse qual é. Comandos recentes são enviados só se você ligar isso. Nomes de host, usuários, senhas e chaves nunca são enviados.
Telnet e serial
Consoles seriais
Escolha Serial ao adicionar um servidor e o Termiyo lista as portas que ele vê. A maioria das portas de console usa 8-N-1 a 9600; uma velocidade errada não dá erro, produz lixo — então confira isso primeiro se a saída parecer errada.
Enviar um break
O sinal de break é como se interrompe um bootloader travado ou se coloca um equipamento no monitor de recuperação. Não há outra forma de produzi-lo a partir de um terminal.
Telnet
É suportado porque equipamento de rede muitas vezes não fala mais nada. Ele não é cifrado — tudo, inclusive uma senha, viaja em texto aberto. Use numa rede de gerência, não pela internet.
Importar de outro cliente SSH
Importe do cliente que você já usaProcurar neste computador
O menu de importação é o botão de nuvem acima da lista de servidores, e a primeira entrada dele é «Procurar neste computador». O Termiyo vai sozinho aos lugares onde as ferramentas que você já tem guardam seus servidores — ssh_config, known_hosts, PuTTY, FileZilla, WinSCP, MobaXterm, as IDEs da JetBrains, Remmina, Tabby, SecureCRT, Cyberduck e os perfis do iTerm2 que na verdade são comandos ssh — e lista o que encontrou, com uma contagem, em vez de pedir que você vá atrás de um arquivo.
O que vem junto
Nomes, endereços, portas, usuários, saltos e encaminhamentos de porta. As senhas salvas também, do FileZilla, WinSCP, JuiceSSH e Remmina, para o cofre, onde ficam criptografadas. JetBrains e Cyberduck guardam as suas no keychain do sistema, o MobaXterm sob DPAPI e o SecureCRT atrás da própria frase secreta: esses servidores chegam do mesmo jeito e perguntam uma vez na primeira conexão. O que não deu para interpretar é listado com o motivo, em vez de sumir calado.
Termius, JuiceSSH e PuTTY precisam de um arquivo
O Termius criptografa campo a campo o que guarda na máquina, então não há nada ali para ler, e ele removeu a própria exportação: o arquivo precisa vir de um exportador da comunidade que você mesmo execute; o Termiyo lê o JSON e o CSV dele, chaves incluídas. O JuiceSSH é um aplicativo de celular, copie o backup dele para cá. O PuTTY no Windows guarda as sessões no registro, então exporte antes com o regedit; no macOS e no Linux, ~/.putty/sessions é lido direto. Deixe qualquer um desses arquivos em Downloads e o Termiyo oferece ele pelo nome quando você voltar.
Nada é escrito antes de você ler
A prévia diz o que seria criado, o que você já tem e o que não pôde ser trazido, antes de encostar no cofre. Importar o mesmo arquivo de novo atualiza os servidores que você já tem em vez de adicionar uma segunda cópia.
Certificados SSH
Cole o certificado
Abra Configurações, Chaves SSH, escolha a chave e cole em Certificado a linha -cert.pub que sua autoridade certificadora assinou. O Termiyo mostra quem ele deixa entrar, até quando e qual comando força, e a lista de chaves mostra quando ele expira. Ele recusa um certificado de host antes de salvá-lo, e um assinado para outra chave sempre que consegue saber qual é a chave: sempre para uma chave que ele guarda, e para uma chave no agente depois que você informa a parte pública dela.
Certificados no seu agente
Um certificado que o seu agente SSH guarda é oferecido sozinho; não há nada para colar. O Termiyo pergunta ao agente o que ele tem antes de conectar.
As importações os trazem
Importar um ssh_config traz o CertificateFile de cada chave e o -cert.pub ao lado dela, e o mesmo vale ao escolher um arquivo de chave. Um certificado assinado para outra chave, de host ou expirado não é associado, e a prévia diz por quê. Um certificado para uma chave que você já tem só é adicionado se você marcar a caixa que diz isso.
Mosh também
Um host Mosh faz login com o seu certificado como um host SSH faz. Se o certificado força um comando, o host o executa no lugar do mosh-server e o Mosh não consegue iniciar; o Termiyo aponta isso como a causa provável. Certificados de chave de segurança ficam de fora de um login do Mosh, porque ele não consegue esperar um toque — use SSH para esses.
Importar da AWS
O que é preciso
Uma chave de acesso com ec2:DescribeInstances, e nada mais. As credenciais são usadas para essa única chamada e não são guardadas.
O que você recebe
Cada instância em execução nas regiões que você escolher, inclusive as sem endereço público — são justamente essas que você alcança por um bastião. Marque as que quiser.
Rodar de novo
Reimportar atualiza os servidores que você já tem em vez de adicionar uma segunda cópia, e não mexe na identidade que você deu a eles.
Trechos
Salvar um comando
Trechos são comandos que você guarda, agrupados em pastas. Executar um digita-o no terminal que está à sua frente.
Valores em um trecho
Escreva ${name} onde vai um valor e escolha no editor como cada um é preenchido: “Perguntar sempre” (com uma resposta padrão ou uma lista de respostas permitidas), “Preencher pelo host” (o endereço, a porta ou o nome de login dele) ou “Deixar para o shell”, para um valor que o shell já tem, como ${PATH}. Um trecho nunca roda com um valor faltando: “Executar snippet” fica desativado até cada um ter resposta. O aplicativo de desktop oferece suas últimas respostas na próxima vez; um segredo nunca é guardado.
Link para um servidor
Copie um link
Na página Servidores, abra o menu de um servidor e escolha Copiar link. A página do próprio servidor e o editor do host têm a mesma ação, e a paleta de comandos a encontra quando você digita “copiar link”. O link tem esta forma: termiyo://connect/prod-db. Ele dá o nome do servidor e não leva endereço, login nem senha.
O que um clique faz
O app de desktop vem para a frente e pergunta antes de conectar, mostrando o endereço para o qual esse nome aponta naquele computador. Um link só abre um servidor já salvo com esse nome; caso contrário, o Termiyo avisa e não abre nada. Se o cofre estiver bloqueado, o link espera até cinco minutos você desbloqueá-lo.
Dois servidores com o mesmo nome
O app de desktop lista os dois com login, endereço e cofre e pergunta qual você quis dizer; Cancelar não abre nada. Se nada os diferencia, ele avisa e não abre nada. O app do celular não pergunta: lá, um nome que dois servidores compartilham não abre nada.
AppImage no Linux
Um AppImage não fica registrado no sistema, então os links não fazem nada até você configurá-los uma vez: Configurações, Ajuda, Linha de comando, Links termiyo://, Configurar. Os pacotes .deb e .rpm e o macOS não precisam de configuração; no Windows, os links funcionam depois que o Termiyo foi aberto uma vez.
Sem um link clicável
Alguns apps não transformam termiyo:// em link. Nesse caso, rode termiyo ssh prod-db em um terminal; Configurações, Ajuda instala o comando no macOS e nos pacotes de Linux.