Como Atualizar Artefatos do Servidor FiveM com Segurança

Atualize o ambiente de execução do FXServer preservando seu diretório server-data, configuração, dados do txAdmin e banco de dados. Baixe o artefato recomendado para seu sistema operacional, teste-o e mantenha o ambiente de execução anterior até que a nova compilação tenha passado por uma sessão normal.

A configuração e os exemplos de código aqui são voltados ao FiveM para GTA V Legacy. O Enhanced tem regras diferentes de runtime e de compatibilidade; verifique as alterações de Legacy para Enhanced do Cfx.re antes de aplicá-las a um servidor Enhanced.

Prepare a atualização

Registre o artefato atual e o comando ou serviço de inicialização. Localize o ambiente de execução separadamente de server.cfg, resources/ e txData. Faça backup dos arquivos e do banco de dados e verifique como restaurá-los. Agende uma janela de manutenção e pare o processo do servidor gerenciado antes de substituir os arquivos de ambiente de execução.

Windows ou Linux: atualize apenas os arquivos de ambiente de execução

Consulte official Windows artifacts ou official Linux artifacts listing. Follow its recommended-build link; do not assume the highest build number is the recommended release.

Extraia o arquivo para um diretório separado e examine sua estrutura. Substitua o ambiente de execução conforme o procedimento documentado da sua instalação. Preserve o diretório antigo do ambiente de execução para poder reverter a alteração. No Linux, mantenha as permissões de execução necessárias. Não presuma que todo arquivo contém uma pasta chamada fx_server.

Reinicie com o mesmo launcher, serviço ou perfil txAdmin que você usou antes. Verifique o diretório de trabalho e o caminho dos dados do servidor. Não copie a configuração de exemplo sobre o seu servidor existente ou trate um genérico git pull como uma atualização de artefato.

Painéis de hospedagem gerenciada

Use a função de atualização de artefato documentada do provedor após verificar o backup e a compilação selecionada. Os nomes dos painéis diferem. Confirme quais arquivos ele substitui e quais opções de recuperação ele oferece antes de executar a atualização.

Verifique a inicialização e a jogabilidade

Confirme a versão do artefato em execução e inspecione os logs de inicialização. Teste uma nova conexão, carregamento de personagem, voz, inventário e seus recursos essenciais. Verifique se há novos erros durante uma sessão normal. Se a conexão falhar, inspecione o erro específico e a configuração do endpoint existente, em vez de alterar as regras do firewall sem evidências.

Se a atualização falhar

Preserve os logs de falha. Pare o processo e restaure o ambiente de execução anterior com o mesmo caminho server-data. Se você também alterou recursos ou estrutura do banco de dados, use o procedimento de recuperação separado; reverter apenas os arquivos de ambiente de execução não pode reverter uma migração de dados.

Registre o resultado e a compilação que você manteve. Remova o ambiente de execução antigo somente depois que você não precisar mais dele para recuperação.

Referências

Orientação de suporte a artefatos Cfx.re; configuração do txAdmin.