Primeiros passos · 6 min de leitura

Conectar o painel ao WipeControl

O WipeControl fala com o seu painel pela API de cliente — a mesma que a interface web usa. Nada é instalado dentro do servidor de Rust, e nenhum plugin é necessário.

Gerar a API key

No Pterodactyl (o mesmo vale para o Pelican):

1. Clique no seu avatar, no canto superior direito, e vá em Account.
2. Abra a aba API Credentials.
3. Em *Create API Key*, escreva uma descrição, por exemplo WipeControl.
4. Deixe *Allowed IPs* em branco, a menos que você saiba o IP de saída fixo.
5. Clique em Create.

A chave começa com ptlc_ e aparece uma única vez. Copie agora.

Atenção: use a chave de cliente (ptlc_), da sua conta, não a de aplicação (ptla_, em Admin → Application API). A de aplicação administra o painel inteiro; a de cliente só alcança os servidores da sua conta. O WipeControl precisa da de cliente, e dar a de aplicação entrega muito mais acesso do que o necessário.

No WISP o caminho é equivalente: *Account → API Credentials*.

Cadastrar a conexão

No WipeControl, dentro da organização, vá em Conexões:

1. URL do painel — o endereço completo, com https:// e sem barra no fim. Exemplo: https://painel.seudominio.com.
2. API key — a chave que você acabou de copiar.
3. Salve.

O WipeControl testa a conexão na hora, buscando a lista de servidores da sua conta. Se a chave estiver certa, os servidores aparecem para você escolher.

Vincular o servidor

Cadastre o servidor na organização e escolha, na lista, qual servidor do painel ele representa. O identificador é aquele código curto que aparece na URL do painel (/server/1a2b3c4d).

Verificação

Uma conexão só é considerada verificada depois que o WipeControl conseguir de fato falar com o painel. Isso não é decoração:

Importante: enquanto a conexão não estiver verificada, os wipes rodam em modo sombra — o WipeControl percorre todos os passos e registra tudo, mas não executa nenhuma ação destrutiva no servidor. É proposital. Melhor um wipe que não aconteceu do que um wipe que apagou os arquivos errados por causa de uma credencial ruim.

Na tela do servidor e no Command Center do administrador, uma conexão nunca verificada aparece em destaque. Se seus wipes "rodam com sucesso" mas nada muda no servidor, é quase sempre isso.

Testando antes do primeiro wipe

Vale gastar dois minutos:

1. Abra o servidor no WipeControl e veja se o status aparece (Rodando/Parado) e se o uptime faz sentido. Isso prova leitura.
2. Agende um wipe do tipo restart_only para dali a alguns minutos, sem grupo de arquivos. Isso prova escrita — parar e iniciar — sem apagar nada.
3. Acompanhe pela aba de execuções. Você deve ver os passos aparecendo em tempo real.

Se o passo de desligar falhar com erro de conexão, o problema está entre o WipeControl e o painel, não no Rust.

Erros comuns

O 504 merece atenção: significa que a sua credencial está boa e o painel está no ar. Quem está inacessível é o Wings. Veja Instalar o Wings.

Próximo: Seu primeiro wipe agendado