Conectando via SFTP: FileZilla, Cyberduck e linha de comando

SFTP (Secure File Transfer Protocol) oferece-lhe acesso direto aos ficheiros do seu site no servidor. Este guia cobre tudo o que precisa para se conectar com sucesso, desde encontrar as suas credenciais até resolver erros.

O que é SFTP e Quando Utilizá-lo

O gestor de ficheiros integrado no KPanel é conveniente para edições rápidas: renomear um ficheiro, visualizar uma configuração ou carregar um único ficheiro. SFTP é a ferramenta certa quando precisa de mais:

• Carregar ou descarregar um grande número de ficheiros de uma só vez (migrar um site, carregar imagens em massa).
• Transferir ficheiros grandes que causariam timeout num carregamento baseado em navegador.
• Trabalhar como parte de um fluxo de trabalho de desenvolvimento onde edita ficheiros localmente e envia alterações.
• Utilizar um cliente de GUI que permite manter uma pasta local e remota sincronizadas.
• Aceder a registos ou ficheiros de configuração que não são expostos através do gestor de ficheiros do KPanel.

SFTP encripta todos os dados em trânsito, o que o torna mais seguro do que FTP simples. KapsuleHost não oferece ligações FTP não encriptadas.

Pré-requisitos

Antes de se poder conectar, precisa de duas coisas preparadas.

1. Uma chave SSH adicionada ao seu site no KPanel.

SFTP no KapsuleHost utiliza autenticação por chave SSH. A autenticação por palavra-passe está desativada por motivos de segurança. Se ainda não adicionou a sua chave pública SSH, siga primeiro o guia Adicionar Chaves SSH ao Seu Site e depois regressar aqui.

2. O nome de utilizador do seu site.

Cada site no KapsuleHost tem um utilizador de sistema dedicado. Este não é o seu endereço de email do KPanel. É um nome de utilizador curto ligado especificamente a esse site.

Para encontrá-lo:

1. Inicie sessão no KPanel em kpanel.kapsulehost.com.
2. Clique em Websites na barra lateral esquerda.
3. Clique no site a que deseja conectar-se.
4. Aceda à página SSH / SFTP.
5. O nome de utilizador do seu site é apresentado no topo deste separador. Normalmente parece mysite_com ou myexamplesite_net.

Detalhes de ligação num relance:

---

Conectar com FileZilla

FileZilla é um cliente SFTP gratuito, multiplataforma, disponível para Windows, macOS e Linux. Descarregue-o de filezilla-project.org se ainda não o tem.

Configuração Passo a Passo

1. Abra FileZilla.

2. Vá a File > Site Manager (ou prima Ctrl+S no Windows / Cmd+S no Mac).

3. Clique em Add Website e atribua-lhe um nome (por exemplo, "O Meu Site Kapsule").

4. No separador General, configure os seguintes campos:

   Campo	Valor
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	O nome de utilizador do seu site (por exemplo, mysite_com)
   Key file	Clique em Browse e navegue até ao seu ficheiro de chave privada

5. Para o ficheiro de chave, selecione a chave privada que corresponde à chave pública que adicionou no KPanel. Em macOS e Linux, as chaves privadas são normalmente armazenadas em ~/.ssh/ (por exemplo, ~/.ssh/id_ed25519 ou ~/.ssh/id_rsa). No Windows, estão frequentemente em C:\Users\YourName\.ssh\.

1. Clique em Connect para testar a ligação, ou clique em OK para guardar e conectar depois.

Guardar e Reconectar

Uma vez guardado no Site Manager, pode reconectar-se a qualquer momento indo a File > Site Manager e clicando em Connect. FileZilla também mostra os seus sites guardados no menu suspenso da barra de ferramentas para acesso rápido.

---

Conectar com Cyberduck

Cyberduck é um cliente SFTP gratuito para macOS e Windows. Descarregue-o de cyberduck.io.

Configuração Passo a Passo

1. Abra Cyberduck.

2. Clique em Open Connection (o ícone do globo na barra de ferramentas).

3. Do menu suspenso de protocolo no topo da caixa de diálogo, selecione SFTP (SSH File Transfer Protocol).

4. Preencha os campos de ligação:

   Campo	Valor
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	O nome de utilizador do seu site (por exemplo, mysite_com)
   Password	Deixe em branco
   SSH Private Key	Clique em Choose e selecione o seu ficheiro de chave privada

5. Clique em Connect.

Na primeira ligação, Cyberduck irá pedir-lhe para verificar a impressão digital da chave de host do servidor. Clique em Allow para prosseguir. Se vir este prompt numa ligação subsequente com uma impressão digital diferente, não a aceite e contacte o suporte, pois pode indicar uma alteração de configuração.

Guardar como Marcador

Para guardar a ligação para uso futuro:

1. Após conectar com sucesso, vá a Marcador > Novo Marcador (ou prima Cmd+Shift+B no Mac).
2. Dê um nome ao marcador e feche a caixa de diálogo. O marcador aparece na sua lista de marcadores do Cyberduck.

---

Conectar a partir do Terminal (Mac, Linux ou WSL)

Se preferir a linha de comando, o comando sftp está disponível em macOS, Linux e Windows Subsystem for Linux (WSL).

Ligação Básica

sftp mysite_com@cp1-kapsule.kapsulehost.com

Substitua mysite_com pelo nome de utilizador do seu site. Se a sua chave privada não estiver na localização padrão (~/.ssh/id_rsa ou ~/.ssh/id_ed25519), especifique-a com a flag -i:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

Na primeira ligação, será-lhe pedido para confirmar a impressão digital da chave do servidor. Digite yes e prima Enter. Isto acontece apenas uma vez por chave e por dispositivo.

Comandos SFTP Úteis

Após conectar, verá um prompt sftp>. Use estes comandos para navegar e transferir ficheiros:

Exemplo: descarregar um ficheiro

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

Exemplo: enviar um ficheiro

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

Onde Estão os Seus Ficheiros

Após conectar, chegará ao diretório de início do utilizador do seu site: /home/[siteuser]/.

A estrutura de diretórios fica assim:

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

A raiz web onde o seu WordPress (ou outra aplicação) reside é htdocs/. Este é o diretório onde passará a maior parte do seu tempo. Em algumas configurações de site pode ser nomeado public_html/. Se conectar e ver public_html/ em vez de htdocs/, use esse.

---

Resolução de Problemas de Ligação

"Ligação recusada"

A ligação foi ativamente rejeitada antes de ser estabelecida.

Verifique: Confirme que está a usar o anfitrião cp1-kapsule.kapsulehost.com e a porta 22. Um erro comum é introduzir a porta 21 (que é FTP, não SFTP) ou um erro de digitação no nome de anfitrião.

"Permissão negada (chave pública)"

O servidor aceitou a tentativa de ligação mas rejeitou a sua autenticação.

Verifique cada um dos seguintes:

• A sua chave pública SSH é adicionada em KPanel > Websites > [site] > SSH / SFTP. Se não estiver listada lá, o servidor não tem registo dela.
• Selecionou a chave privada correta em FileZilla/Cyberduck, especificamente a chave privada que corresponde à chave pública que adicionou ao KPanel.
• Se a sua chave tiver uma frase-passe, certifique-se de que a está a introduzir corretamente.
• Se tiver múltiplas chaves, confirme que não está acidentalmente a selecionar a errada.

"Verificação de chave de anfitrião falhou"

O seu cliente SFTP viu uma chave de anfitrião diferente para este nome de anfitrião anteriormente e está a avisá-lo de uma incompatibilidade.

Na primeira ligação: Será-lhe pedido para aceitar a impressão digital. Isto é normal. Clique Aceitar ou digite yes.

Numa ligação subsequente com uma nova impressão digital: Isto pode indicar uma alteração de configuração no servidor. Contacte o suporte em support@kapsulehost.com antes de aceitar, e mencione o que viu.

Para limpar uma chave de anfitrião antiga no terminal, edite ~/.ssh/known_hosts e remova a linha para cp1-kapsule.kapsulehost.com.

"Não foi possível ler do repositório remoto" ou Diretório Errado

Pode ter usado o seu endereço de email do KPanel como nome de utilizador em vez do nome de utilizador do seu site.

Verifique: O nome de utilizador tem de ser o nome de utilizador do seu site (por exemplo, mysite_com), não o seu endereço de email. Encontre o nome de utilizador correto em KPanel > Websites > [site] > SSH / SFTP.

Ligação Expira o Tempo Limite

A tentativa de ligação fica suspensa e depois expira o tempo limite sem nenhum erro.

Possíveis causas:

• O seu endereço IP pode estar temporariamente bloqueado pela firewall da Kapsule devido a tentativas de login falhadas repetidas. Contacte o suporte em support@kapsulehost.com e peça-lhes para verificarem o registo da firewall.
• Uma firewall local ou VPN na sua rede pode estar a bloquear ligações de saída na porta 22. Tente a partir de uma rede diferente (por exemplo, hotspot móvel) para descartar isto.

---

Artigos Relacionados

• Adicionar Chaves SSH ao Seu Site
• Utilizar o Gestor de Ficheiros no KPanel
• Conectar à Sua Base de Dados através do Túnel SSH