SSHPortForwarder Support Doc.pt BR

🌐 English · العربية · Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Nederlands · Português (BR) · Русский · ภาษาไทย · Türkçe · 简体中文 · 繁體中文

---

Documento de Suporte do SSH Port Forwarder

Introdução

O SSH Port Forwarder (SSHPortForwarder) é um aplicativo para macOS que cria redirecionamentos de porta SSH e proxies SOCKS. Você configura hosts remotos, portas e autenticação (senha ou chave privada), então inicia um redirecionamento para obter uma porta local ou proxy SOCKS sem precisar sair do terminal ou alterar sua configuração SSH. O aplicativo pode ser executado na barra de menus para iniciar/parar rapidamente. Suas configurações, senhas (no Keychain) e acesso aos arquivos de chave permanecem no seu Mac; o aplicativo não faz upload dos seus dados.

Para começar a usar o SSH Port Forwarder

1. Baixe e instale o aplicativo (da App Store ou do seu canal de distribuição).
2. Inicie o aplicativo. Você pode usar a janela principal para gerenciar configurações ou o ícone da barra de menus para acesso rápido.
3. Adicione ou selecione uma configuração de redirecionamento:
   • Insira um nome, host remoto, porta SSH (padrão 22) e nome de usuário.
   • Escolha Senha ou Chave Privada para autenticação. Se usar chave privada, use o botão Procurar ao lado do caminho da chave para selecionar seu arquivo de chave (necessário para que o aplicativo acesse sob o sandbox).
   • Escolha Proxy SOCKS (proxy SOCKS local) ou Redirecionamento Local (encaminhar uma porta remota específica para uma porta local) e defina a porta local (e a porta remota para Redirecionamento Local).
4. Opcionalmente, use Testar para verificar a conexão SSH antes de iniciar.
5. Clique em Iniciar para começar o redirecionamento. Use o ícone da barra de menus para iniciar ou parar redirecionamentos rapidamente.
6. Salve sua configuração para que ela persista; se você usar uma senha, ela será armazenada no Keychain do sistema.

Importante: Arquivo de chave privada e re-seleção

Se você usar autenticação por Chave Privada e selecionar um arquivo de chave no aplicativo:

• O aplicativo lembra o acesso a esse arquivo por meio de um bookmark do sistema (caminho + identidade do arquivo).
• Se você excluir esse arquivo de chave e depois criar um novo arquivo com o mesmo nome (ou mesmo caminho), o aplicativo ainda apontará para o arquivo antigo. O bookmark pode se tornar inválido ou apontar para o arquivo errado.
• Você deve re-selecionar o arquivo de chave no cliente: abra a configuração, clique em Procurar ao lado do caminho da chave, escolha o novo arquivo de chave e depois Salvar. Caso contrário, o aplicativo pode falhar ao conectar ou mostrar erros de permissão.

Solução de Problemas

• Falha na conexão ou autenticação

  • Verifique o host remoto, a porta SSH e o nome de usuário.
  • Para autenticação por senha: certifique-se de que a senha está correta e salva (Keychain).
  • Para chave privada: certifique-se de que você selecionou a chave via Procurar, que o formato da chave é suportado (OpenSSH ou PEM) e, se a chave tiver uma frase secreta, insira-a quando solicitado. Se você substituiu o arquivo de chave (ex.: excluiu e recriou um com o mesmo nome), re-selecione o arquivo de chave no aplicativo e salve.

• “Sem permissão para ler o arquivo de chave” ou erros relacionados à chave

  • Use o botão Procurar para selecionar seu arquivo de chave privada novamente e depois salve. Isso também é necessário após substituir o arquivo de chave (ex.: nova chave com o mesmo caminho/nome).

• Porta local em uso

  • Escolha outra porta local na configuração ou pare o aplicativo que está usando a porta atual.

• Redirecionamento não inicia ou fica “conectando”

  • Execute Testar para verificar a conectividade SSH. Verifique o firewall e a rede. Certifique-se de que o host remoto permite SSH e, para Redirecionamento Local, que a porta remota está correta.

• Ícone da barra de menus ou janela principal

  • O aplicativo pode ser executado apenas com o ícone da barra de menus. Use o menu para abrir a janela completa para configuração ou para iniciar/parar redirecionamentos.

Feedback e Sugestões

Valorizamos seu feedback e sugestões para melhorar o SSH Port Forwarder. Se você tiver alguma ideia ou sugestão, envie para aidoge@yeah.net.

Obrigado por usar o SSH Port Forwarder!