SFTP (Secure File Transfer Protocol) permite que você se conecte ao seu servidor de jogos e transfira arquivos diretamente do seu computador — incluindo arquivos grandes, pastas completas de mods e backups. Se você precisa fazer upload de algo que o gerenciador de arquivos do GPanel não consegue lidar (como diretórios inteiros ou arquivos acima do limite do navegador), SFTP é a ferramenta certa.
Quando usar SFTP: Use SFTP quando precisar fazer upload de pastas, arquivos grandes (ex.: saves de mundo, pacotes de mods, backups) ou múltiplos arquivos de uma vez. Para edições rápidas de um único arquivo, o gerenciador de arquivos do GPanel pode ser suficiente.
Detalhes de Conexão
Sua conexão SFTP usa o endereço IP do seu servidor e as credenciais do GPanel.
Seus detalhes de conexão SFTP
| Host / Endereço | O endereço IP do seu servidor (mostrado no painel do GPanel ou na aba Console) |
|---|---|
| Port | 2022 |
| Protocolo | SFTP (SSH File Transfer Protocol) |
| Usuário | Seu nome de usuário do GPanel |
| Senha | Encontrada na aba Settings do GPanel |
Importante: Sempre use a porta 2022, não a porta SFTP padrão 22. Conexões na porta 22 não funcionarão.
Opção 1 — FileZilla (Recomendado)
FileZilla é um cliente FTP/SFTP gratuito e multiplataforma, disponível para Windows, macOS e Linux.
Passo 1 — Baixar e Instalar o FileZilla
- Acesse filezilla-project.org e baixe o FileZilla Client (não o FileZilla Server).
- Execute o instalador e siga as instruções na tela.
Passo 2 — Abrir o Gerenciador de Sites
- Abra o FileZilla.
- Clique em File → Site Manager (ou pressione Ctrl+S).
- Clique em New Site e dê um nome como Legion Hosting.
Passo 3 — Inserir as Configurações de Conexã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. - Insira seu Username e Password do GPanel (a senha está na aba Settings do GPanel).
- Clique em Connect.
Passo 4 — Aceitar a Chave do Host
- Na primeira conexão, o FileZilla mostrará um diálogo de Unknown host key.
- Marque Always trust this host e clique em OK.
Passo 5 — Fazer Upload de Arquivos
- O painel esquerdo mostra seu computador local. Navegue até os arquivos ou pastas que deseja enviar.
- O painel direito mostra o sistema de arquivos do seu servidor. Navegue até a pasta de destino (ex.:
/home/container/mods/). - Arraste e solte arquivos ou pastas do painel esquerdo para o painel direito, ou clique com o botão direito em um arquivo e escolha Upload.
- Acompanhe o progresso da transferência no painel de fila na parte inferior.
Opção 2 — WinSCP (Apenas Windows)
WinSCP é um cliente SFTP gratuito e popular para Windows com uma interface familiar de explorador de arquivos em dois painéis.
Passo 1 — Baixar e Instalar o WinSCP
- Acesse winscp.net e baixe o instalador.
- Execute o instalador. Quando perguntado sobre o estilo de interface, escolha Commander para uma visualização em dois painéis, ou Explorer se preferir uma visualização em painel único.
Passo 2 — Criar uma Nova Sessão
- Abra o WinSCP. O diálogo de Login abre automaticamente.
- Defina File protocol como
SFTP. - Insira o endereço IP do seu servidor no campo Host name (encontrado no painel do GPanel).
- Defina Port number como
2022. - Insira seu User name e Password do GPanel (a senha está na aba Settings do GPanel).
- Clique em Login.
Passo 3 — Aceitar a Chave do Host e Fazer Upload
- Aceite o aviso de chave do host do servidor na primeira conexão.
- Seus arquivos locais aparecem à esquerda; os arquivos do servidor à direita.
- Navegue até a pasta de destino no servidor, então arraste arquivos do painel esquerdo para o direito, ou use F5 para copiar os arquivos selecionados.
Tarefas Comuns de Upload
Fazendo Upload de um Arquivo de Configuração
Arquivos de configuração (ex.: servertest.ini, server.properties) geralmente estão localizados em uma 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é o caminho correto no seu cliente SFTP, então arraste o arquivo de configuração editado para o painel do servidor para substituir o arquivo existente.
Pare o servidor primeiro antes de substituir arquivos de configuração ativos. Fazer upload de uma configuração enquanto o servidor está rodando pode fazer com que o servidor sobrescreva seu arquivo ao desligar.
Fazendo Upload de Mods
- Pare seu servidor pelo GPanel.
- Conecte-se via SFTP e navegue até a pasta de mods do seu jogo (ex.:
/home/container/mods/ou o caminho específico do jogo). - Arraste a pasta inteira do mod ou o arquivo
.jar/.pakda sua máquina local para o diretório de mods do servidor. - Inicie o servidor pelo GPanel assim que o upload estiver concluído.
Fazendo Upload de um Save de Mundo ou Backup
- Pare seu servidor pelo GPanel.
- Conecte-se via SFTP e navegue até o diretório de saves do seu jogo.
- Faça upload da pasta de save inteira (arraste a pasta em si, não apenas seu conteúdo, a menos que esteja mesclando com um save existente).
- Confirme que a estrutura de pastas corresponde ao que estava lá antes.
- Inicie o servidor pelo GPanel.
Dica: Antes de sobrescrever um save, renomeie a pasta existente no servidor primeiro (ex.: adicione
_backup ao final) para que você possa restaurá-la se algo der errado.
Solução de Problemas
- Verifique novamente se a porta está definida como 2022, não 22.
- Confirme que o endereço IP corresponde ao mostrado no painel do GPanel.
- Certifique-se de que seu servidor está rodando — o acesso SFTP pode exigir que o processo do servidor de jogos esteja ativo em alguns planos.
- Verifique se seu firewall ou antivírus não está bloqueando conexões de saída na porta 2022.
- Use o mesmo nome de usuário e senha que você usa para fazer login em gpanel.legionhosting.net.
- Nomes de usuário diferenciam maiúsculas de minúsculas. Copie o nome de usuário diretamente do GPanel se não tiver certeza.
- Se você alterou sua senha do GPanel recentemente, atualize-a na sessão salva do seu cliente SFTP.
- Redefina sua senha do GPanel pela área do cliente se a esqueceu.
- Pacotes grandes de mods ou saves de mundo podem levar vários minutos. Deixe a transferência ser concluída.
- No FileZilla, você pode aumentar o número de transferências simultâneas: vá em Edit → Settings → Transfers e defina o máximo de transferências simultâneas para 3.
- Se a conexão cair no meio da transferência, o FileZilla pode retomar: clique com o botão direito no arquivo que falhou na fila e escolha Reset and requeue failed transfers.
- Seu diretório home é
/home/container/. Se o cliente te levar para um diretório diferente, digite manualmente este caminho na barra de caminho remoto. - Certifique-se de que está conectado com o nome de usuário correto — cada conta do GPanel só tem acesso aos arquivos 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á usando e uma descrição do erro.
