O SFTP (Secure File Transfer Protocol) permite-lhe ligar ao seu servidor de jogos e transferir ficheiros diretamente do seu computador — incluindo ficheiros grandes, pastas completas de mods e backups. Se precisar de enviar algo que o gestor de ficheiros do GPanel não consegue tratar (como diretórios inteiros ou ficheiros acima do limite de tamanho do navegador), o SFTP é a ferramenta certa.
Quando usar SFTP: Use SFTP quando precisar de enviar pastas, ficheiros grandes (ex.: saves de mundos, packs de mods, backups) ou múltiplos ficheiros de uma só vez. Para edições rápidas de ficheiros individuais, o gestor de ficheiros do GPanel pode ser suficiente.
Detalhes de Ligação
A sua ligação SFTP utiliza o endereço IP do seu servidor e as credenciais do GPanel.
Os seus detalhes de ligação SFTP
| Host / Endereço | O endereço IP do seu servidor (apresentado no painel do GPanel ou no separador Console) |
|---|---|
| Port | 2022 |
| Protocolo | SFTP (SSH File Transfer Protocol) |
| Nome de utilizador | O seu nome de utilizador do GPanel |
| Palavra-passe | Encontra-se no separador Settings no GPanel |
Importante: Use sempre a porta 2022, não a porta SFTP padrão 22. Ligações na porta 22 não irão funcionar.
Opção 1 — FileZilla (Recomendado)
O FileZilla é um cliente FTP/SFTP gratuito e multiplataforma, disponível para Windows, macOS e Linux.
Passo 1 — Descarregar e Instalar o FileZilla
- Aceda a filezilla-project.org e descarregue o FileZilla Client (não o FileZilla Server).
- Execute o instalador e siga as instruções no ecrã.
Passo 2 — Abrir o Gestor de Sites
- Abra o FileZilla.
- Clique em File → Site Manager (ou pressione Ctrl+S).
- Clique em New Site e dê-lhe um nome como Legion Hosting.
Passo 3 — Introduzir as Definições de Ligação
- Defina Protocol como
SFTP - SSH File Transfer Protocol. - Defina Host como o endereço IP do seu servidor (encontrado no painel do GPanel).
- Defina Port como
2022. - Defina Logon Type como
Normal. - Introduza o seu Username e Password do GPanel (a palavra-passe está no separador Settings do GPanel).
- Clique em Connect.
Passo 4 — Aceitar a Chave do Host
- Na primeira ligação, o FileZilla mostrará um diálogo Unknown host key.
- Marque Always trust this host e clique em OK.
Passo 5 — Enviar Ficheiros
- O painel esquerdo mostra o seu computador local. Navegue até aos ficheiros ou pastas que deseja enviar.
- O painel direito mostra o sistema de ficheiros do seu servidor. Navegue até à pasta de destino (ex.:
/home/container/mods/). - Arraste e largue ficheiros ou pastas do painel esquerdo para o painel direito, ou clique com o botão direito num ficheiro e escolha Upload.
- Monitorize o progresso da transferência no painel de fila na parte inferior.
Opção 2 — WinSCP (Apenas Windows)
O WinSCP é um cliente SFTP gratuito e popular para Windows com uma interface de explorador de ficheiros familiar com dois painéis.
Passo 1 — Descarregar e Instalar o WinSCP
- Aceda a winscp.net e descarregue o instalador.
- Execute o instalador. Quando lhe for pedido um estilo de interface, escolha Commander para uma vista de painel duplo, ou Explorer se preferir uma vista de painel único.
Passo 2 — Criar uma Nova Sessão
- Abra o WinSCP. O diálogo Login abre automaticamente.
- Defina File protocol como
SFTP. - Introduza o endereço IP do seu servidor no campo Host name (encontrado no painel do GPanel).
- Defina Port number como
2022. - Introduza o seu User name e Password do GPanel (a palavra-passe está no separador Settings do GPanel).
- Clique em Login.
Passo 3 — Aceitar a Chave do Host e Enviar
- Aceite o aviso da chave do host do servidor na primeira ligação.
- Os seus ficheiros locais aparecem à esquerda; os ficheiros do servidor à direita.
- Navegue até à pasta de destino no servidor, depois arraste ficheiros do painel esquerdo para o direito, ou use F5 para copiar os ficheiros selecionados.
Tarefas de Envio Comuns
Enviar um Ficheiro de Configuração
Ficheiros de configuração (ex.: servertest.ini, server.properties) estão normalmente localizados numa subpasta específica do diretório home do seu servidor. Caminhos comuns:
- Project Zomboid:
/home/container/.cache/server/ - ARK: Survival Ascended:
/home/container/ShooterGame/Saved/Config/WindowsServer/ - Minecraft:
/home/container/
Navegue até ao caminho correto no seu cliente SFTP, depois arraste o ficheiro de configuração editado para o painel do servidor para substituir o ficheiro existente.
Pare o servidor primeiro antes de substituir ficheiros de configuração ativos. Enviar uma configuração enquanto o servidor está em execução pode fazer com que o servidor sobrescreva o seu ficheiro ao encerrar.
Enviar Mods
- Pare o seu servidor a partir do GPanel.
- Ligue-se via SFTP e navegue até à pasta de mods do seu jogo (ex.:
/home/container/mods/ou o caminho específico do jogo). - Arraste a pasta completa do mod ou o ficheiro
.jar/.pakdo seu computador local para o diretório de mods do servidor. - Inicie o servidor a partir do GPanel assim que o envio estiver completo.
Enviar um Save de Mundo ou Backup
- Pare o seu servidor a partir do GPanel.
- Ligue-se via SFTP e navegue até ao diretório de saves do seu jogo.
- Envie a pasta de save completa (arraste a pasta em si, não apenas o seu conteúdo, a menos que esteja a fundir com um save existente).
- Confirme que a estrutura de pastas corresponde ao que estava lá anteriormente.
- Inicie o servidor a partir do GPanel.
Dica: Antes de sobrescrever um save, renomeie primeiro a pasta existente no servidor (ex.: adicione
_backup ao final) para que possa restaurá-la se algo correr mal.
Resolução de Problemas
- Verifique novamente se a porta está definida como 2022, não 22.
- Confirme que o endereço IP corresponde ao apresentado no painel do seu GPanel.
- Certifique-se de que o seu servidor está em execução — o acesso SFTP pode requerer que o processo do servidor de jogos esteja ativo em alguns planos.
- Verifique se a sua firewall ou antivírus não está a bloquear ligações de saída na porta 2022.
- Use o mesmo nome de utilizador e palavra-passe que usa para iniciar sessão em gpanel.legionhosting.net.
- Os nomes de utilizador são sensíveis a maiúsculas e minúsculas. Copie o nome de utilizador diretamente do GPanel se não tiver a certeza.
- Se alterou recentemente a sua palavra-passe do GPanel, atualize-a na sessão guardada do seu cliente SFTP.
- Reponha a sua palavra-passe do GPanel a partir da área de cliente se a tiver esquecido.
- Packs de mods grandes ou saves de mundos podem demorar vários minutos. Deixe a transferência concluir.
- No FileZilla, pode aumentar o número de transferências simultâneas: vá a Edit → Settings → Transfers e defina o máximo de transferências simultâneas para 3.
- Se a ligação cair a meio da transferência, o FileZilla pode retomar: clique com o botão direito no ficheiro falhado na fila e escolha Reset and requeue failed transfers.
- O seu diretório home é
/home/container/. Se o cliente o colocar num diretório diferente, escreva manualmente este caminho na barra de caminho remoto. - Certifique-se de que está ligado com o nome de utilizador correto — cada conta do GPanel só tem acesso aos ficheiros do seu próprio servidor.
Ainda precisa de ajuda? Abra um ticket de suporte e inclua o endereço IP do seu servidor, o cliente SFTP que está a utilizar e uma descrição do erro.
