Quando o seu FXServer apresenta erros de "não está respondendo", você normalmente está lidando com um dos cinco problemas principais. Este guia fornece etapas sistemáticas de solução de problemas para administradores de servidores FiveM que enfrentam falhas de conectividade entre o txAdmin e o FXServer.
Causa principal: incompatibilidade de configuração de porta
Emitir: txAdmin não consegue se conectar ao FXServer devido à configuração incorreta da porta em server.cfg
Consertar: Verifique se o seu server.cfg contém pontos de extremidade TCP/UDP correspondentes:
endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30121"
Substitua os números das portas pelas portas alocadas. Se os números das portas não corresponderem à sua porta de alocação primária, ocorrerão erros de conexão.
Etapas de validação:
- Verifique as configurações do txAdmin → FXServer para portas configuradas
- Compare com as declarações de endpoint server.cfg
- Reinicie o servidor via console após as correções
Causa secundária: Conectividade do monitor txAdmin
Emitir: txAdmin:Monitor não consegue se conectar ao FXServer, causando mensagens “FXServer não está respondendo!”
Causas raiz:
- FXServer não está respondendo ao ponto de extremidade TCP (recurso travado)
- FXServer e txAdmin compartilhando a mesma porta TCP
- FXServer não escuta a interface local
Consertar: Inicie o FXServer no modo monitor:
# Windows .\FXServer.exe # Linux .\run.sh
Crítico: Não use argumentos +exec ao iniciar o txAdmin. O txAdmin requer que o FXServer seja executado no modo monitor.
Interferência de antivírus (Windows)
Emitir: A verificação do diretório FXServer pelo antivírus Microsoft Defender causa inicializações lentas e tempos limite de conectividade
Consertar: Adicionar diretório FXServer à lista de exclusão:
# Executar como administrador Add-MpPreference -ExclusionPath "C:FXServer""
Substitua o caminho pelo local real do seu diretório FXServer.
Problemas de configuração de rede
Emitir: NAT/gateway mascarando portas de origem UDP ou encaminhamento de porta impróprio
Lista de verificação de correção:
- Encaminhar portas TCP e UDP no roteador/firewall
- Verifique se o Firewall do Windows permite FXServer.exe
- Verifique a configuração do NAT para preservação da porta UDP
- Teste a conectividade local:
telnet localhost 30120
Bloqueio de recursos na inicialização
Emitir: Recursos travados impedem que o FXServer responda às verificações de integridade
Abordagem diagnóstica:
- Inicie o servidor com recursos mínimos
- Adicione recursos incrementalmente para identificar o culpado
- Verifique o console em busca de mensagens de erro de recursos
- Remover ou corrigir recursos problemáticos
Configuração de teste do server.cfg:
# Inicialização mínima para teste garantir gerenciador de mapas garantir chat garantir gerenciador de spawn # Adicionar outros recursos um por um
Solução de problemas avançada
Falhas na verificação de integridade: O monitor mostra “Erro de solicitação HealthCheck: conexão ECONNREFUSED”, indicando perda completa de conectividade.
Etapas de verificação:
- Confirme o processo FXServer em execução:
lista de tarefas | findstr FXServer - Verifique a ligação da porta:
netstat -an | findstr :30120 - Revisar logs do txAdmin para padrões de erro específicos
- Teste com server.cfg novo usando configuração padrão do FiveM
Nota de incerteza:Alguns problemas de conectividade podem surgir de configurações de rede do provedor de hospedagem ou de políticas regionais de firewall que não são imediatamente aparentes nos logs do servidor.
Validação de configuração
Elementos server.cfg necessários:
# Essencial para listagem do servidor sets sv_projectName "Nome do Seu Servidor" sets sv_projectDesc "Descrição do Seu Servidor" # Configuração correta de endpoint endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30121" # Habilitar integração com txAdmin start txAdmin
Os servidores exibem erros se sv_projectName e sv_projectDesc não estiverem definidos.
Prioridade de resolução
- Primeiro: Verifique a configuração da porta em server.cfg
- Segundo: Inicie o FXServer sem argumentos +exec
- Terceiro: Adicionar exclusões de antivírus
- Quarto: Verifique as configurações de rede/firewall
- Quinto: Isolar recursos problemáticos
A maioria dos erros “FXServer não está respondendo” são resolvidos por meio da correção de incompatibilidades de porta entre os endpoints server.cfg e a configuração do txAdmin, seguido pela garantia de procedimentos adequados de inicialização do modo monitor.
Lista de verificação prática
Use este guia como uma lista de verificação antes de alterar um servidor FiveM em produção. Confirme a versão atual do artefato do servidor, a versão do framework, as dependências de recursos, as alterações no banco de dados e quaisquer arquivos do lado do cliente antes de aplicar a alteração.
- Faça backup dos arquivos de configuração e tabelas do banco de dados afetados.
- Aplique a alteração primeiro em um servidor de teste.
- Observe o console do servidor e o console F8 do cliente em busca de erros.
- Verifique se a alteração afeta empregos, inventário, veículos, mapas, voz, permissões ou dados do jogador.
- Documente o arquivo, comando ou configuração exata que você alterou para que possa ser revertida rapidamente.
Testes antes da produção
Após o primeiro teste, entre com uma conta de jogador normal e repita o fluxo da perspectiva do jogador. Se o tópico envolver desempenho, meça o antes e o depois com a mesma quantidade de jogadores, rota e conjunto de recursos. Se envolver ferramentas ou permissões de administrador, verifique os usuários permitidos e os bloqueados.
Erros comuns
A maioria dos problemas do FiveM decorre de dependências ausentes, cache desatualizado, nomes de pastas incorretos, incompatibilidade de frameworks ou configurações copiadas de outro servidor. Evite alterar vários sistemas ao mesmo tempo; faça uma alteração por vez, teste-a e só então continue.
Recursos relacionados
Para ativos prontos para produção, compare os recursos pagos no Loja FiveMX. Para recursos gratuitos, navegue. Scripts gratuitos para FiveM e testar cada recurso antes de utilizá-lo publicamente.
Notas sobre o lançamento da produção
Antes de usar este guia em um servidor FiveM em produção, defina o resultado exato que você espera da alteração. Para a seção "Solução de problemas: FXServer não está respondendo! (Como corrigir)", isso significa verificar qual recurso, configuração, comando ou fluxo de trabalho é afetado e confirmar se a alteração é compatível com sua estrutura atual, versão do artefato e regras do servidor. Mantenha a implementação em pequena escala para que você possa revertê-la rapidamente caso os jogadores relatem erros.
Utilize um servidor de testes com a mesma estrutura, esquema de banco de dados, ordem de recursos e principais dependências do servidor de produção. Se o tópico alterar a jogabilidade, permissões, visuais, voz, veículos, mapas, inventário ou comportamento da economia, teste com pelo menos uma conta de administrador e uma conta de jogador normal. Observe a saída do console do servidor, os logs do cliente (F8) e o tempo de uso dos recursos enquanto repete o fluxo exato de jogadores que ocorrerá no servidor de produção.
Lista de verificação de reversão
- Salve o arquivo de configuração anterior, a pasta de recursos e o estado do banco de dados antes de fazer qualquer alteração.
- Registre a versão do recurso, o commit, a página de download ou o valor da configuração que você testou.
- Reinicie primeiro apenas o recurso afetado, se possível, e só reinicie o servidor completo se as dependências assim o exigirem.
- Caso ocorram erros, reverta a alteração feita no recurso ou na configuração antes de testar outra correção.
Guia de manutenção
Revise esta configuração novamente após atualizações de artefatos do FiveM, atualizações do framework ou alterações importantes nos recursos. Uma configuração que funciona hoje pode parar de funcionar após atualizações de dependências, renomeação de exportações, alteração de eventos ou migrações de banco de dados. Mantenha anotações junto com a documentação do seu servidor para que os futuros administradores entendam o que foi alterado, por que foi alterado e como verificar novamente.
Revisão em andamento
Verifique novamente a solução de problemas: o FXServer não está respondendo! (Como corrigir) após grandes atualizações de artefatos do FiveM, alterações na estrutura ou migrações de recursos. Confirme se as instruções ainda correspondem ao comportamento atual do servidor, se qualquer código-fonte vinculado permanece disponível e se as etapas de instalação ainda correspondem aos arquivos que um proprietário de servidor realmente baixará ou configurará.
Para servidores públicos, mantenha um breve registro de alterações junto à documentação do servidor. Anote o que foi testado, o que foi alterado, quais contas foram usadas para verificação e como reverter as alterações. Isso agiliza a manutenção futura e evita que anotações antigas de configuração se tornem confusas ou inseguras para os jogadores.
Referências oficiais e próximos passos
Use estas referências oficiais para verificar as etapas técnicas antes de alterar um servidor FiveM ativo.
- Configuração vanilla do FXServer do Cfx.re
- Cfx.re aviso de atualização de artefato
- Cfx.re monitoramento do txAdmin
Guias FiveMX relacionados: