Termiyo

Documentação

Termiyo, de ponta a ponta

Páginas curtas, na ordem em que você vai precisar delas.

Primeiros passos

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.

Compartilhar um terminal

Criar um link

Abra o painel de compartilhamento em um terminal conectado e crie um link. Quem seguir espera até você deixar entrar e entra somente com leitura.

Deixar alguém digitar

Digitar fica desligado para a sessão inteira até você ligar, e depois é concedido pessoa por pessoa. Desligar de novo tira na hora de todos que já tinham.

O que vai por onde

O fluxo do terminal vai direto entre as duas máquinas. Nosso serviço apresenta vocês dois e depois não vê nada. O link para de funcionar depois de quatro horas ou quando você encerra o compartilhamento, o que vier primeiro.

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á usa

Procurar 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.

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. Agrupe-os em pacotes e limite um aos servidores com uma determinada etiqueta quando ele só faz sentido em um lugar.

Variáveis solicitadas

Um trecho pode ter variáveis. Ao rodar, ele pergunta cada uma primeiro, então um comando que você usa em vinte servidores continua sendo um trecho, e não vinte.