O erro Failed to bind to port aparece quando Paper não consegue reservar o endereço de rede configurado. As causas mais comuns são outro processo usando a mesma porta ou um valor inválido em server-ip. Trocar para uma porta aleatória nem sempre resolve e pode criar divergência com painel, firewall, DNS ou proxy.

Investigue primeiro quem já está ouvindo e em qual interface. Faça testes em servidor que você administra e não encerre processos desconhecidos por tentativa. Em hospedagem compartilhada, o provedor controla alocações e precisa confirmar qual porta foi reservada para o serviço.

Leia a mensagem e encontre o endereço

Guarde a linha completa do console e identifique endereço e porta que Paper tentou usar. Diferencie IPv4, IPv6 e endereço local. O texto geralmente indica se o recurso está ocupado ou se endereço não pode ser associado. Confira em server.properties os valores atuais de server-port e server-ip.

Não trate server-ip como espaço para inserir IP público do domínio. Ele controla a interface local em que o processo escuta. A documentação do Paper explica que muitas vezes deve permanecer vazio para usar as interfaces apropriadas. Um IP de DNS externo pode não existir na máquina como endereço local.

Verifique se já há servidor rodando

Confira painel de hospedagem e lista de processos Java. Um processo antigo pode continuar em execução após uma aba fechar ou uma inicialização duplicada. Veja horário de início, pasta de trabalho, JAR e porta antes de encerrar. Certifique-se de que não existem dois serviços usando o mesmo mundo.

Se o processo pertence a outra instância ou usuário, não mate por conveniência. Confirme com a equipe e provedor. Interromper Paper durante gravação pode corromper mundo. Use parada normal pelo console ou painel e aguarde shutdown completo, depois tente novamente.

Confirme porta no painel

Em hosting, o número de porta costuma ser alocado pelo serviço. Confira a porta atribuída ao servidor e se o painel está iniciando instância correta. Não adicione uma porta TCP/UDP que não foi reservada nem altere a configuração do firewall para contornar uma alocação ocupada.

Se outra instância legítima usa a porta, solicite ao provedor uma alocação disponível. Atualize registro DNS, proxy e instruções de conexão somente após confirmar listener final. Java e Bedrock podem exigir transportes e portas distintas; não assuma que resolver bind num listener corrige o outro.

Teste server-ip vazio antes de mudar endereço

Se valor está preenchido e não corresponde a uma interface local, pare e faça backup da configuração. Numa instância de teste, deixe campo vazio e reinicie Paper conforme orientação da hospedagem. Observe log de bind e teste conexão na interface esperada.

Se precisa escutar só numa interface específica por motivo de rede, descubra IP local correto e valide como ele se mantém após reinício da máquina. IP dinâmico ou endereço removido pode fazer problema voltar. Use opção de rede do provedor se o painel recomenda interface ou container específica.

Distinga bind de bloqueio do firewall

Bind falha antes de o servidor aceitar conexões. Firewall normalmente deixa processo iniciado mas bloqueia pacotes que chegam depois. Se console diz que Paper iniciou listener corretamente, mas jogadores não conectam, prossiga para teste de porta, protocolo, roteador, proxy e firewall. Não trate todo “não conecta” como erro de bind.

Teste listener local e externo separadamente. Conexão Java usa TCP, enquanto Geyser para Bedrock usa UDP. O serviço precisa escutar no protocolo certo e o encaminhamento corresponder. Se porta está bindada mas inacessível, investigue camada de rede sem iniciar segunda instância.

Revise o proxy e o destino backend

Em rede Velocity, proxy e Paper backend precisam usar portas distintas ou interfaces planejadas. Verifique qual processo ocupa cada uma e em que endereço. Se Paper escuta somente em localhost, proxy na mesma máquina pode alcançar; em host separado, precisa de rede privada apropriada. Siga a política de firewall da sua arquitetura.

Não exponha backend ao público apenas para resolver bind. Mantenha regras que permitem somente o tráfego esperado e configure encaminhamento de identidade. Depois de mover serviço, valide proxy, Paper e portas externas individualmente.

Use argumentos e painel com precedência conhecida

Argumentos CLI podem substituir propriedades correspondentes do arquivo. Se mudar server-port mas comando ou painel define outra porta, resultado pode continuar igual. Revise script de início e tela de alocação, sem duplicar valores que entram em conflito.

Guarde comando e configuração antes de alterar. Faça mudança pequena e veja o valor de bind no console após restart. Não altere EULA, autenticação, senha de RCON ou outras opções para corrigir uma porta ocupada.

Se o problema persiste

Capture mensagem completa, hora, comando de início, versão Paper e Java, porta alocada e processo que usa a interface. Envie ao provedor com identificador de instância, removendo segredos. Se você controla host, faça diagnóstico de sockets segundo o sistema operacional sem encerrar processos que não identificou.

Consulte o guia do Paper para Failed to bind, a referência de server-ip e server-port e argumentos que substituem propriedades. Depois de corrigir, teste a conexão pública e confirme que só o listener planejado está ativo.

Verifique endereços e família de rede

Se processo tenta bindar IPv6 mas hospedagem só oferece IPv4, endereço explícito pode falhar. Da mesma forma, um endereço privado antigo pode ter sido trocado após migração de container. Compare listener mostrado no log com interfaces fornecidas pelo provedor e não copie o IP público para o campo local sem orientação.

Teste um valor vazio em homologação, reinicie e observe se servidor escolheu interface esperada. Registre porta reservada e protocolo. Se conflito continua, suporte pode verificar quem mantém socket aberto sem que você precise encerrar processos desconhecidos.

Teste com alocação já liberada

Antes de reiniciar, confira na interface do provedor que a porta está alocada à instância correta e no protocolo requerido. Se alterou apenas regra de firewall, a porta pode ainda não pertencer ao servidor. Registre ID de alocação e peça confirmação ao suporte em vez de criar listener extra sem reserva.

Não altere versão do mundo para esconder erro

Um erro de versão em chunk ou diretório do mundo não é falha de acesso ao JAR. Use o binário compatível com os dados e siga migração oficial. Não adicione flag não suportada ou copie pasta para caminho aleatório como tentativa de iniciar; isso pode produzir arquivos divergentes.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.