Um link neoserver://, um clique, e o NeoServer é automaticamente despertado, conecta-se ao servidor e abre o terminal exatamente onde você quer — pode ser em uma máquina específica, uma sessão tmux ou um diretório.

Salve-o nos favoritos do Safari, nas Notas, como ícone na área de trabalho, nos Atalhos da Siri, ou envie via AirDrop para um colega, todos vão funcionar.

I. Como escrever o link do terminal

Todos os links de terminal se parecem com isto:

neoserver://terminal?host=<servidor>&port=<porta>&user=<usuário>&tmuxName=<sessão tmux>&zellijName=<sessão zellij>&workdir=<diretório>

⚠️ tmuxName / zellijName / workdir só pode ser preenchido um. Se preencher vários, apenas tmuxName será considerado, depois zellijName, e por último workdir.

Basta copiar e alterar para os seus dados:

# O mais simples: apenas o host
neoserver://terminal?host=1.2.3.4

# Especificando porta e usuário
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# Conecta e entra direto na sessão tmux main
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# Conecta e entra direto na sessão zellij dev
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# Conecta e faz cd automático para o diretório de logs
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

II. Após conectar, onde o terminal vai parar

Esta é a parte mais útil do link do terminal — preenchendo parâmetros diferentes, o local onde o terminal abre após a conexão muda:

Por que dividir nestes três tipos?

• Sessões tmux / zellij: Se a internet cair, fechar o App ou trocar de celular e reconectar, a sessão continua lá, os processos não são perdidos. Compartilhar a sessão tmux de um servidor com um colega permite que vocês entrem na mesma tela para investigar juntos.
• Diretório: Em vez de ter que digitar cd /opt/app/logs toda vez que conectar, é melhor deixar o link levar você direto para lá.

III. Copiar o link no App (sem precisar escrever à mão)

Escrever links manualmente é propenso a erros. O NeoServer permite copiar com um clique em três lugares; basta copiar e colar em qualquer lugar.

1. Copiar o link de "este servidor"

Aba Servidores · Lista de servidores → Deslize para a esquerda em um servidor → Copy Scheme Link

O que é copiado será:

neoserver://terminal?host=...&port=...&user=...

2. Copiar no modo quick do terminal

Aba Terminal · Lista de servidores (modo quick) → Pressione e segure em um servidor → Copy Scheme Link

3. Copiar o link de "esta sessão" ⭐ O mais útil

Aba Terminal · Lista de sessões → Pressione e segure em uma sessão → Copy Scheme Link

Este link empacotará "a conexão com a sessão Y do servidor X":

• Se a sessão for tmux → inclui automaticamente &tmuxName=...
• Se a sessão for zellij → inclui automaticamente &zellijName=...
• Sessão comum → apenas host/port/user

Se copiado com sucesso, aparecerá Link Copied, e o link já estará na área de transferência.

💡 Pressione e segure para copiar uma sessão tmux em execução e envie a um colega; ao abrir com o NeoServer, ele fará attach diretamente na mesma sessão — vocês dois entrarão na mesma tela do terminal.

IV. Como abrir este link

neoserver:// é um protocolo de link para iOS, em qualquer lugar onde você possa clicar em um link, o NeoServer pode ser despertado:

• Safari: Cole na barra de endereços e dê Enter, ou salve nos favoritos e clique.
• Notas / Lembretes: Salve uma nota, clique uma vez para acessar diretamente.
• Atalhos: Preencha o link na ação "Abrir URL" → pode ser vinculado à voz da Siri, ícones da área de trabalho e automações.
• AirDrop: Envie um link entre dois iPhones, a pessoa basta clicar para conectar.
• E-mail: Envie o link como texto, o destinatário copia para o Safari para abrir.

📱 No primeiro clique em um link neoserver:// em um dispositivo real, o iOS exibirá um pop-up perguntando "Abrir no NeoServer?", basta confirmar e ele não perguntará mais.

V. Três cenários práticos

🏠 Cenário 1: Transformar "conectar ao tmux de produção" em um ícone na área de trabalho

Todos os dias você precisa se conectar à sessão tmux main da máquina de produção. Em vez de sempre abrir o App → encontrar o servidor → conectar → attach, é melhor transformar em um ícone:

1. No App, copie o link deste servidor e adicione manualmente &tmuxName=main;
2. Abra o app de "Atalhos" do iOS → crie um novo → adicione a ação "URL", cole este link;
3. Adicione a ação "Abrir URL";
4. Clique em compartilhar → Adicionar à Tela Inicial, dê o nome "Conectar Produção", escolha um ícone.

Agora, ao tocar nesse ícone na área de trabalho, o NeoServer conecta automaticamente e entra na sessão main, tudo sem nenhuma ação manual.

🎙️ Cenário 2: Conectar usando voz

Conecte o atalho acima à Siri e defina uma frase como "E aí Siri, conectar produção". Ao falar, o celular conecta automaticamente.

🤝 Cenário 3: Enviar uma sessão para um colega

1. Terminal · Lista de sessões → Pressione e segure nesta sessão → Copy Scheme Link;
2. Envie para o seu colega (via AirDrop / WeChat, qualquer um serve);
3. Ele abre com o NeoServer → faz attach automaticamente à mesma sessão tmux.

(Pré-requisito: a biblioteca de servidores do NeoServer no iPhone dele também deve conseguir se conectar ao mesmo host.)

VI. Perguntas frequentes sobre links de terminal

P: Cliquei no link e conectei ao servidor errado? R: O NeoServer encontra o servidor pelo host (+ port se preenchido + user se preenchido). Se você tiver dois servidores com o mesmo host em sua biblioteca, ele conectará ao primeiro que der match. Preencher a port ou user ajuda a diferenciar com precisão.

P: E se eu não tiver esse servidor na biblioteca, o que acontece ao clicar no link? R: Você será levado à página de "Novo Servidor", com host/port/user já preenchidos para você. Basta adicionar a senha ou chave privada → salvar → conectar automaticamente, e a sessão / diretório contidos no link original também funcionarão normalmente.

P: Posso incluir a senha diretamente no link para não ter que digitá-la toda vez? R: Não. Esta é uma restrição de segurança — links nunca contêm senhas. Mesmo que você adicione manualmente password=xxx, isso será ignorado. A senha só passa pelo chaveiro (keychain) dentro do App.

P: Posso colocar um diretório com caracteres chineses ou espaços no workdir? R: Pode. Escreva direto, por exemplo workdir=/home/me/my logs. O App lidará com os caracteres especiais automaticamente. A maneira mais segura é usar a cópia do App, em vez de escrever à mão.

P: Cliquei e não aconteceu nada? R: ① Confirme se começa com neoserver://; ② Na primeira vez aparecerá um pop-up de confirmação para "Abrir no NeoServer"; ③ Verifique se o host não foi deixado em branco; ④ Não tem problema se o App não estiver em primeiro plano, ele será despertado automaticamente.

P: Posso abrir no Android / Windows? R: Não. neoserver:// só é reconhecido por iPhones / iPads que tenham o NeoServer instalado.

VII. Anexo: Abrir a Central de Notificações

Além do terminal, há também um link para abrir a central de notificações:

neoserver://notifications

É isso que é executado quando você toca no widget de notificações na área de trabalho.