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
Use a lista de artifacts oficiais para Windows ou de artifacts oficiais para Linux. Siga o link da build recomendada; não presuma que a build com o maior número é a versão recomendada.
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 do txAdmin usado anteriormente. Verifique o diretório de trabalho e o caminho dos dados do servidor. Não sobrescreva a configuração existente com um exemplo nem trate um comando genérico git pull como atualização dos artifacts.
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.