Resposta rápida: pare o FXServer, faça backup tanto dos dados de tempo de execução quanto do servidor, baixe o último recomendado artefato para o sistema operacional correto, substitua apenas os arquivos de tempo de execução, reinicie através do txAdmin ou do painel do host, em seguida, teste a inicialização, os recursos, a conexão direta e os logs antes de excluir a cópia de rollback.
- txAdmin: ele é empacotado com o FXServer; use o caminho de atualização normal do servidor e mantenha os diretórios existentes
Dados txe server-data. - Manual Windows/Linux: não copie
recursos/,servidor.cfg, bancos de dados ou segredos para o diretório do artefato. - Painel de hospedagem: os nomes dos botões variam conforme o provedor; confirme o build selecionado e o local do backup em vez de assumir que “Atualizar” preserva os dados personalizados.
Manter os artefatos FiveM atualizados é necessário para compatibilidade, segurança e evitar erros de inicialização. Este guia mostra como atualizar artefatos no Windows, Linux e painéis de hospedagem sem sobrescrever os recursos do seu servidor.
Antes de atualizar
Não sobrescreva sua recursos/ pasta ou servidor.cfg. Faça backup dos arquivos do servidor primeiro, depois substitua apenas os arquivos de artefato/runtime da nova compilação.
📹 Assista ao tutorial em vídeo
🖥️ Para servidores Windows
1. Faça backup dos dados do seu servidor
Antes de fazer qualquer alteração, proteja sua configuração existente:
- Faça backup do
dados do servidorpasta:Isso inclui seuservidor.cfge quaisquer recursos personalizados. - Ferramentas necessárias: Use ferramentas como o Explorador de Arquivos ou software de backup para criar uma cópia dos seus dados.
2. Baixe os últimos artefatos
- Visite a página FiveM Windows Server Artifacts: Artefatos FiveM
- Selecione o último build recomendado do Cfx.re: use o link da lista de artefatos Última versão recomendada a menos que um recurso documentado ou um requisito de rollback exija um build específico. Não infira suporte apenas do número mais alto.
3. Extraia os arquivos baixados
- Use uma ferramenta de arquivamento: Aplicações como 7-Zíper ou WinRAR são recomendados.
- Etapas de extração:
- Abra o arquivo
server.7zbaixado com o 7-Zip ou outra ferramenta compatível. - Selecione Extrair aqui ou seu método de extração preferido.
- Abra o arquivo
4. Substitua artefatos antigos por novos
- Navegue até o diretório do seu servidor: Localize onde seus artefatos de servidor atuais residem.
- Sobrescrever arquivos existentes: Arraste e solte os arquivos recém-extraídos no diretório do servidor. Confirme quaisquer prompts para sobrescrever.
5. Reinicie e teste seu servidor
- Inicie seu servidor: Correr
executar.cmdou seu arquivo de lote de inicialização designado. - Monitore o console: Certifique-se de que não haja erros durante a inicialização.
- Executar um teste: Conecte-se ao seu servidor e verifique se todas as funcionalidades estão funcionando conforme o esperado.
Precisa de um pacote de servidor FiveM pronto para uso? Navegue pelos pacotes de servidor testados após a conclusão da atualização do artefato.
🐧 Para servidores Linux
1. Faça backup dos dados do seu servidor
Proteja suas configurações e recursos personalizados:
- Faça backup do
dados do servidorDiretório: Especialmente oservidor.cfgarquivo. - Exemplo de comandos:
cp -r /caminho/para/dados-do-servidor /caminho/para/backup/dados-do-servidor-backup
2. Acesse a página de artefatos do servidor Linux FiveM
- Visita: Artefatos Linux FiveM
- Escolha o último build recomendado do Cfx.re: use a recomendação mostrada na lista oficial de artefatos do Linux e mantenha o tempo de execução anterior para rollback.
3. Baixe e descompacte os novos artefatos
- Usar
wgetouenrolar:wget [URL_DOWNLOAD_DO_ARTIFACT] # ou curl -O [URL_DOWNLOAD_DO_ARTIFACT] - Extrair com
alcatrão:tar -xvf fx.tar.xz
4. Atualize os artefatos no diretório do seu servidor
- Mover novos arquivos:
cp -r ./fx_server/* /caminho/para/seu/diretório/servidor/ - Sobrescrever quando solicitado: Confirme para substituir os arquivos existentes.
5. Reinicie e teste seu servidor
- Inicie seu servidor:
cd /caminho/para/seu/diretório/servidor ./run.sh - Verificar erros: Monitore a saída do terminal.
- Verificar Funcionalidade: Conecte-se ao seu servidor e certifique-se de que tudo esteja funcionando perfeitamente.
🛠️ Para painéis de hospedagem de servidores (por exemplo, Zaphosting)
1. Acesse o painel de hospedagem do seu servidor
- Conecte-se: Navegue até o provedor de hospedagem painel (por exemplo, Zaphosting) e faça login com suas credenciais.
2. Localize a opção de atualização
- Navegue até o seu servidor: Selecione o servidor FiveM que você deseja atualizar.
- Encontre o recurso de atualização: Procure um 'Atualizar' botão ou um Artefatos seção dentro do painel.
3. Execute a atualização
- Selecione a versão mais recente do artefato: Escolha a versão estável mais recente no menu suspenso ou nas opções de atualização.
- Confirme a atualização: Clique 'Atualizar' e permitir que o painel lide com o processo automaticamente.
4. Verifique a atualização
- Verifique o painel: Certifique-se de que o servidor reflita a versão atualizada.
- Registros de revisão: Procure por erros ou confirmações de uma atualização bem-sucedida.
5. Reinicie se necessário
Garantir estabilidade: Após reiniciar, conecte-se ao seu servidor para verificar se tudo está funcionando corretamente.
Reinicialização manual: Se o servidor não reiniciar automaticamente, use o recurso de reinicialização do painel.
Erros comuns após atualizar artefatos
- O servidor não inicia: Verifique o console em busca de arquivos de runtime ausentes e confirme se você copiou os arquivos de artefato para o diretório correto do servidor.
- Recursos estão faltando: Restaure seu backup se você acidentalmente sobrescreveu
recursos/ou alterouservidor.cfg. - Jogadores não conseguem conectar: Reinicie o txAdmin ou o processo do servidor e verifique as configurações de endpoint e firewall.
- Scripts gera erros: Atualize o framework ou recurso afetado após confirmar que a atualização do artefato foi bem-sucedida.
Se scripts quebrarem após a atualização, compare recursos mantidos antes de substituir arquivos aleatórios de backups antigos.
Perguntas frequentes
Com que frequência devo atualizar os artefatos do FiveM?
Atualize quando o Cfx.re recomendar uma build mais recente, quando o txAdmin avisar sobre artefatos desatualizados ou quando um recurso exigir uma build de servidor mais nova.
Devo excluir recursos ao atualizar artefatos?
Não. As atualizações de artefatos substituem os arquivos de execução do servidor, e não seus recursos personalizados, banco de dados ou servidor.cfg.
Posso atualizar artefatos a partir de um painel de hospedagem?
Sim, se seu host oferecer uma opção de artefato ou atualização. Ainda assim, faça um backup primeiro e verifique os logs após a reinicialização.
✅ Dicas Finais
- Backups regulares: Sempre mantenha backups recentes antes de realizar atualizações.
- Mantenha-se informado: Fique de olho nos canais oficiais do FiveM para anúncios e atualizações.
- Teste após atualizações: Após a atualização, teste cuidadosamente todas as funcionalidades do servidor para detectar quaisquer problemas antecipadamente.
- Comunidade Apoiar: Não hesite em entrar em contato com a comunidade FiveM ou com os fóruns de suporte se tiver problemas.
Após a atualização, mantenha o backup até que seu servidor tenha passado por uma sessão normal de jogadores sem erros no console. Se a atualização corrigiu problemas de inicialização ou compatibilidade, documente a build do artefato que você usou para facilitar sua próxima janela de manutenção.
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.
- Aviso de fim de vida útil do Cfx.re
- Configuração do txAdmin do Cfx.re
- Configuração vanilla do FXServer do Cfx.re
Guias FiveMX relacionados: