Docs
Entrar
Capítulos

Infraestrutura · 10 min de leitura

Instalar o Wings (daemon)

O Wings é o processo que realmente sobe o servidor de Rust. O painel dá as ordens; o Wings executa, criando e gerenciando containers Docker. Sem ele, o painel mostra servidores que não ligam.

Ele pode ficar na mesma máquina do painel ou em outra — inclusive na sua casa, com o painel numa VPS. É comum e funciona, desde que a porta esteja acessível.

Antes de começar

  • Um Linux com acesso real ao kernel. Virtualização KVM ou máquina dedicada funcionam. OpenVZ e LXC normalmente não funcionam, porque o Docker não consegue os recursos de que precisa.
  • Root na máquina.
  • Espaço em disco de verdade: um servidor de Rust ocupa de 10 a 20 GB, e os mapas e saves crescem entre wipes.

Dimensionamento aproximado para um servidor de Rust: 4 vCPU, 8 GB de RAM e 40 GB de disco. Mapas 4500+ e muitos jogadores pedem mais memória.

Instalação

bash
curl -fsSLo install-wings.sh https://wipecontrol.xyz/scripts/install-wings.sh
sudo bash install-wings.sh

O script instala o Docker (se ainda não houver), baixa o binário correto para a arquitetura da máquina — amd64 ou arm64, detectado automaticamente — e cria o serviço systemd.

Se você já tem Docker configurado do seu jeito e não quer que o script mexa nisso:

bash
sudo bash install-wings.sh --skip-docker

Depois de baixar, o script executa wings --version. Parece detalhe, mas é o que separa "o download veio corrompido" de "o serviço não sobe e ninguém sabe por quê" — se o binário não executar, a instalação para ali mesmo.

Criar o nó no painel

O Wings ainda não sabe a que painel pertence. Essa ligação vem de um arquivo de configuração que o painel gera:

  1. No painel, vá em Admin → Nodes → Create New.
  2. Preencha:
  • Name — um apelido, por exemplo casa ou ovh-01.
  • FQDN — o domínio que aponta para a máquina do Wings. Precisa ser diferente do domínio do painel se forem máquinas diferentes.
  • Communicate Over SSL — ligado, se o FQDN tiver certificado.
  • Memory e Disk — o total que esse nó pode distribuir entre servidores. Deixe uma folga para o sistema.
  1. Salve e abra o nó criado.
  2. Vá na aba Configuration. O painel mostra um comando de auto-deploy pronto.
  3. Cole esse comando no servidor do Wings. Ele escreve /etc/pterodactyl/config.yml.
  4. Suba o serviço:
bash
systemctl enable --now wings

Para acompanhar:

bash
journalctl -u wings -f

Quando aparecer algo como sending ping to panel sem erro em seguida, painel e daemon estão conversando.

Firewall

O Wings precisa de portas abertas para funcionar:

PortaProtocoloPara quê
8080TCPComunicação painel ↔ Wings
2022TCPSFTP dos arquivos do servidor
28015UDPPorta do jogo (padrão do Rust)
28016TCPRCON / console
28082TCPRust+ (opcional)

Com UFW:

bash
ufw allow 8080/tcp
ufw allow 2022/tcp
ufw allow 28015/udp
ufw allow 28016/tcp

Atenção: se o Wings estiver na sua casa, o roteador precisa encaminhar essas portas para a máquina. É aqui que a maior parte dos "o painel não conecta no nó" começa.

Contabilidade de swap

Em kernels anteriores ao 6.1, o Docker só respeita limites de memória por container se a contabilidade de swap estiver ligada. O script avisa quando detecta isso. Para ligar:

  1. Edite /etc/default/grub.
  2. Na linha GRUB_CMDLINE_LINUX_DEFAULT, acrescente swapaccount=1.
  3. Rode update-grub e reinicie.

O Wings funciona sem isso — os limites de memória é que ficam menos precisos.

Conferindo

No painel, em Admin → Nodes, o nó deve aparecer com o coração verde. Se estiver vermelho, o painel não está alcançando o Wings. Verifique nesta ordem:

bash
systemctl status wings
journalctl -u wings -n 100 --no-pager
curl -sk https://SEU-FQDN-DO-WINGS:8080/api/system

Os erros mais comuns:

  • certificado inválido — o FQDN do nó não tem certificado, mas *Communicate Over SSL* está ligado. Ou emita o certificado, ou desligue a opção.
  • conexão recusada — porta 8080 fechada no firewall ou não encaminhada no roteador.
  • token inválido — o config.yml foi copiado de outro nó. Gere de novo pela aba Configuration.

Próximo: Criar o servidor Rust no painel