[AG]


Servidor Minecraft Java na internet mesmo com CGNAT

Colocar um servidor Minecraft para os amigos jogarem pela internet parece simples até você descobrir que sua conexão usa CGNAT — aquele tipo de provedor em que o roteador não tem IP público e port forwarding simplesmente não funciona.

Este é o resultado de fazer isso do zero no Windows 11, com tudo automatizado e documentado: um servidor Minecraft Java que roda atrás do CGNAT, sem whitelist, com clientes não oficiais, e sem abrir nenhuma porta na internet.

O problema: por que port forwarding não salva

Na maioria das conexões domésticas, o roteador tem um IP privado (192.168.x.x) e compartilha um IP público com outros clientes do provedor através do Carrier-Grade NAT. Como consequência, não existe porta pública para o seu servidor, e nenhuma regra no roteador resolve isso.

Descubra se você tem CGNAT olhando o IP WAN do roteador: se começar com 100.64. (ou se for igual ao seu IP local), você está nesse caso.

A solução: três camadas de segurança independentes

  • Rede — a porta do Minecraft só responde na interface do Tailscale. O firewall do Windows bloqueia a porta na interface da sua LAN, no WSL/Hyper-V e, por consequência, na internet.
  • Identidade — a ACL do Tailscale define que só contas convidadas chegam, e só na porta do Minecraft. Nenhuma outra porta do seu PC fica visível.
  • Jogo — online-mode=false, sem whitelist, sem verificação de conta Microsoft: qualquer launcher não oficial entra.

Download

O material completo está publicado no Codeberg:

O que vem no pacote

Um config.ps1 para você preencher, um README.md com o tutorial passo a passo, um CHECKLIST.md para ir marcando, e 13 scripts PowerShell que fazem todo o trabalho pesado:

  • 01-diagnostico.ps1 — levanta o estado do sistema e te diz o que preencher
  • 02-certificado.ps1 — corrige o certificado do painel (o Chrome bloqueia seu IP sem isso)
  • 03-importar-mundo.ps1 — importa e valida um mundo existente
  • 04-config-servidor.ps1 — EULA, server.properties, RAM, auto-start
  • 05-firewall-autostart.ps1 — regras de firewall e inicialização automática
  • 06-backup-agenda.ps1 — backup diário com cópia consistente
  • 07-validacao.ps1 — bateria de testes do servidor
  • 08-teste-backup.ps1 — backup ponta a ponta, com validação do zip
  • 09-reiniciar-crafty.ps1 — reinício seguro do painel e do servidor
  • mcping.ps1 — ping do protocolo Minecraft, sem precisar do cliente
  • crafty-token.py — gera um token de API para automação
  • start-crafty.vbs — sobe o painel destacado, imune a ser morto junto com o terminal

Como usar

  1. Baixe o zip, descompacte e abra o config.ps1 preenchendo os campos entre < e >.
  2. Rode o 01-diagnostico.ps1 para conferir os valores detectados.
  3. Siga o README.md na ordem, marcando o CHECKLIST.md.

Para jogar, os amigos instalam o Tailscale, entram com a conta que você convidou e adicionam o endereço do servidor no Minecraft. Só isso — sem conta Microsoft, sem whitelist, sem senha no servidor.

Detalhes que só aparecem fazendo

O tutorial documenta as armadilhas que quebraram tudo durante a montagem, e que ninguém adverte:

  • O Crafty Controller lê apenas a primeira linha do eula.txt e compara com a string exata eula=true. Qualquer quebra de linha final faz o auto-start falhar com “EULA being false”. O arquivo precisa ter exatamente 9 bytes.
  • O certificado autoassinado do painel não inclui o seu IP no SAN, e o Chrome bloqueia o acesso com chrome-error://. O script regenera o certificado e instala no trust store do Windows.
  • Matar o painel não mata o processo Java do servidor: ele fica órfão segurando a porta e o lock do mundo, e a próxima tentativa falha com World lock. Por isso existe um script de reinício seguro.
  • Se o painel for iniciado a partir de um terminal, ele herda o console e pode receber SIGINT e morrer horas depois. O launcher .vbs resolve.

Requisitos

  • Windows 10/11 com 8 GB de RAM (16 GB recomendado)
  • Java 21 ou superior — a versão 26.3 do Minecraft exige Java 25
  • Crafty Controller 4 (versão portable) e Tailscale
  • Python 3, apenas para o token da API

Sobre o modo offline

Com online-mode=false, o servidor não confere a identidade de quem entra: qualquer pessoa que alcance a porta entra com o nome que quiser. É por isso que a proteção aqui é feita na rede (firewall + ACL do Tailscale), e não no jogo. O guia também traz um aviso sobre as implicações do spoofing de nome e o que fazer a respeito.

O material é publicado sob a licença do repositório. Sinta-se à vontade para usar, adaptar e redistribuir — se encontrar algum problema, o issue tracker do repositório está ali para isso.


Voltar

Comentários (0)

Nenhum comentário ainda. Seja o primeiro!

Deixe um comentário