---
title: "Como migrar um servidor FiveM para uma VPS"
description: "Leve a cidade FiveM para uma VPS: arquivos, banco com mysqldump, oxmysql, chave do Cfx.re no IP novo, txAdmin, firewall e DNS sem perder personagens."
url: "https://streethosting.com.br/guias/vps/migrar-servidor-fivem-para-vps"
category: "vps"
slug: "migrar-servidor-fivem-para-vps"
datePublished: "2026-09-28"
dateModified: "2026-09-28"
author: "Equipe StreetHosting"
difficulty: "avancado"
language: "pt-BR"
keywords:
  - "migrar servidor fivem para vps"
  - "transferir servidor fivem"
  - "fivem mysqldump banco"
  - "oxmysql string de conexao"
  - "chave fivem novo ip"
  - "migrar txdata txadmin"
---

# Migrar a cidade FiveM para a VPS sem perder nenhum personagem

Uma cidade de roleplay é feita de arquivos, banco de dados, dados do txAdmin e uma chave presa a um IP. Este guia mostra como levar cada peça para a VPS, testar antes e virar o endereço sem que os jogadores percam progresso.

> **Resposta rápida**
>
> Para **migrar um servidor FiveM para uma VPS**, instale o artefato Linux do FXServer, copie a pasta da cidade e a pasta txData, exporte o banco com mysqldump e importe no MariaDB da VPS, ajuste a string de conexão do oxmysql e revincule a chave do Cfx.re ao IP novo. Libere a 30120 em TCP e UDP, restrinja a 40120 do txAdmin ao IP da staff e só troque o DNS depois de testar a cidade pelo IP da VPS.

## O que compõe uma cidade FiveM

Uma cidade de roleplay não é uma pasta só. São várias peças que moram em lugares diferentes, e esquecer qualquer uma delas custa caro. Sem o banco, todo personagem volta ao zero. Sem a txData, a staff perde o acesso ao painel e o histórico de banimentos desaparece. Sem a chave revinculada, o servidor não se registra no Cfx.re. Antes de copiar qualquer arquivo, faça o inventário abaixo.

| Peça | Onde fica | Como levar |
| --- | --- | --- |
| Artefatos do FXServer | Pasta com run.sh no Linux ou FXServer.exe no Windows | Não copie: baixe o artefato Linux na mesma build ou na recomendada |
| Pasta da cidade | resources, server.cfg, arquivos de stream e configs dos scripts | Compactar e enviar por rsync ou SFTP |
| Banco de dados | MySQL ou MariaDB do servidor antigo | Dump com mysqldump e importação no MariaDB da VPS |
| txData | Pasta do txAdmin com admins, agendamentos e histórico de jogadores | Copiar inteira, com o servidor parado |
| Chave do Cfx.re | Linha sv_licenseKey do server.cfg | Revincular ao IP novo no Cfx.re Portal |
| Endereço | IP, domínio e link de conexão divulgados no Discord | Registro A com TTL baixo e teste antes da virada |

Se a cidade roda hoje em Windows, a ida para uma VPS Linux traz três cuidados extras que costumam aparecer só no primeiro boot:

- **Maiúsculas e minúsculas:** no Linux, `Client/main.lua` e `client/main.lua` são arquivos diferentes. Um caminho no fxmanifest.lua que o Windows aceitava pode quebrar o resource inteiro.
- **Caminhos absolutos:** linhas como `exec C:\FXServer\server-data\config.cfg` precisam virar caminhos relativos à pasta da cidade.
- **Binários de Windows:** resources que trazem arquivos .dll ou .exe não rodam no Linux. Peça ao autor a versão para Linux ou substitua o script antes da migração, e não durante.

## Preparar a VPS

Use Ubuntu 24.04 LTS, entre por SSH com chave e crie um usuário próprio para o FiveM. O processo do jogo nunca deve rodar como root: se um resource comprometido ganhar poder total, a VPS inteira vai junto. A instalação detalhada do banco, com ajustes de segurança, está em [instalar MariaDB ou MySQL numa VPS Ubuntu](https://streethosting.com.br/guias/vps/instalar-mariadb-mysql-vps-ubuntu).

```
sudo apt update && sudo apt upgrade -y
sudo apt install -y xz-utils mariadb-server rsync unzip
sudo mariadb-secure-installation
sudo adduser --disabled-password --gecos "" fivem
sudo -iu fivem
mkdir -p ~/fxserver ~/cidade && cd ~/fxserver
wget -O fx.tar.xz "URL_DO_ARTEFATO_LINUX"
tar xf fx.tar.xz && rm fx.tar.xz
```

A URL do artefato vem da página oficial de artefatos Linux do Cfx.re. Instale a mesma build que roda no servidor antigo, que aparece no console e na tela inicial do txAdmin, ou a build recomendada no momento. Trocar de build junto com a troca de máquina mistura duas mudanças e deixa impossível saber qual delas causou um erro.

> **Dica**
>
> Anote a build atual, a versão do banco e a lista de resources ativos antes de desligar qualquer coisa. Esse bilhete de três linhas resolve metade das dúvidas que aparecem na noite da virada.

## Exportar e importar o banco

O banco guarda personagens, inventários, veículos, casas, dinheiro e empregos. É a peça que mais dói perder e a que mais sofre com cópia malfeita. No servidor antigo, com a cidade parada, gere o dump:

```
mysqldump -u root -p --single-transaction --routines --triggers \
  --default-character-set=utf8mb4 nome_do_banco > cidade.sql
gzip cidade.sql
```

A opção de transação única gera uma foto consistente das tabelas, e o utf8mb4 preserva acentos e emojis em nome de personagem. Se o servidor antigo é um plano com painel e sem SSH, exporte pelo phpMyAdmin em formato SQL, que chega ao mesmo resultado.

Na VPS, crie o banco e um usuário exclusivo para a cidade:

```
sudo mariadb
CREATE DATABASE cidade CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'SENHA_FORTE';
GRANT ALL PRIVILEGES ON cidade.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

gunzip cidade.sql.gz
mariadb -u fivem -p cidade < cidade.sql
```

Confira a importação comparando a contagem de linhas das tabelas principais nos dois lados, por exemplo `SELECT COUNT(*) FROM users;` em bases ESX ou a tabela `players` em bases QBCore. Número igual é o mínimo para seguir.

Por fim, aponte o oxmysql para o banco novo no server.cfg. O `ensure oxmysql` precisa vir antes dos resources que usam o banco.

```
set mysql_connection_string "mysql://fivem:SENHA_FORTE@127.0.0.1:3306/cidade?charset=utf8mb4"
```

> **Atenção**
>
> Use sempre **set** nessa linha, nunca setr. O setr replica a variável para os clientes, e qualquer jogador conectado poderia ler a senha do banco. Evite também os caracteres `; , / ? : @ & = + $ #` na senha, porque eles quebram a leitura da string de conexão.

## Copiar a cidade e a txData

Pare a cidade pelo txAdmin antes de copiar, para que nenhum arquivo seja gravado no meio da transferência. Se o servidor antigo também é Linux com SSH, o rsync leva tudo e permite repetir a cópia depois enviando só o que mudou:

```
rsync -aHz --info=progress2 usuario@IP_ANTIGO:/caminho/da/cidade/ /home/fivem/cidade/
rsync -aHz --info=progress2 usuario@IP_ANTIGO:/caminho/do/txData/ /home/fivem/txData/
```

Vindo de Windows, compacte a pasta da cidade e a txData em zip e envie por SFTP ou scp. As duas formas estão explicadas em [transferir arquivos para a VPS com SCP e rsync](https://streethosting.com.br/guias/vps/transferir-arquivos-vps-scp-rsync). Em instalações feitas por receita do txAdmin, a pasta da cidade costuma ficar dentro da própria txData, com nome terminado em .base.

A txData guarda as contas de admin, os agendamentos de reinício, as configurações do txAdmin e o banco de jogadores com advertências e banimentos. No Linux, por padrão, ela fica ao lado do run.sh. Para não depender disso, fixe o caminho com a variável `TXHOST_DATA_PATH` no serviço do systemd, em `/etc/systemd/system/fivem.service`:

```
[Unit]
Description=FXServer com txAdmin
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
User=fivem
WorkingDirectory=/home/fivem/fxserver
Environment=TXHOST_DATA_PATH=/home/fivem/txData
ExecStart=/home/fivem/fxserver/run.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
```

Ative com `sudo systemctl daemon-reload && sudo systemctl enable --now fivem` e acompanhe o boot com `journalctl -u fivem -f`. No primeiro acesso ao txAdmin, as configurações do FXServer ainda apontam para os caminhos da máquina antiga. Corrija a pasta de dados do servidor para `/home/fivem/cidade` e o caminho do server.cfg, e revise o arquivo antes de iniciar:

- [ ] endpoint_add_tcp e endpoint_add_udp escutando em 0.0.0.0:30120
- [ ] sv_licenseKey com a chave já revinculada ao IP da VPS
- [ ] mysql_connection_string apontando para 127.0.0.1 e o banco novo
- [ ] Nenhum caminho absoluto herdado do Windows nas linhas exec
- [ ] Webhooks, APIs e lojas que liberam acesso por IP atualizados

## A chave de licença do Cfx.re

Todo servidor público de FiveM precisa de uma chave de registro do Cfx.re na linha `sv_licenseKey`. A chave fica amarrada ao IP público que a usou pela primeira vez. Levar o server.cfg para a VPS sem mexer nela é o motivo mais comum de cidade migrada que liga, mas não se registra direito.

O gerenciamento das chaves saiu do antigo Keymaster e hoje fica no Cfx.re Portal, em portal.cfx.re. Lá você encontra o servidor e tem dois caminhos: revincular a chave atual ao novo IP, que passa a valer no próximo boot, ou gerar uma chave nova e trocar a linha no server.cfg. A interface do portal muda com alguma frequência, então, se o botão não estiver onde você espera, a central de suporte do Cfx.re descreve o passo atual.

> **Atenção**
>
> A chave é credencial. Se ela apareceu em print, em conversa aberta ou em repositório público, gere uma nova durante a migração. E nunca envie o server.cfg completo para um repositório público: ele carrega a chave e a senha do banco.

Se a comunidade entra pelo link curto do Cfx.re, teste esse link depois da virada antes de repostar no Discord. Ele está ligado ao registro do servidor, e trocar a chave pode gerar um endereço novo.

## Firewall: o que abrir e o que fechar

Na VPS nova você decide o que fica exposto. A regra é simples: só a porta do jogo aberta para todo mundo, o painel restrito à staff e o banco invisível para a internet.

| Porta | Protocolo | Serviço | Regra |
| --- | --- | --- | --- |
| 22 | TCP | SSH | Aberta, com login só por chave |
| 30120 | TCP e UDP | FXServer, entrada dos jogadores | Aberta para todos |
| 40120 | TCP | Painel do txAdmin | Só para o IP da staff ou por túnel SSH |
| 3306 | TCP | MariaDB | Fechada, com o banco escutando em localhost |

```
sudo ufw default deny incoming
sudo ufw allow OpenSSH
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from IP_DA_STAFF to any port 40120 proto tcp
sudo ufw enable
```

Se a staff não tem IP fixo, deixe a 40120 fechada e use um túnel SSH: rode `ssh -L 40120:127.0.0.1:40120 usuario@IP_DA_VPS` no seu computador e abra http://localhost:40120 no navegador. O AntiDDoS da borda segura ataques volumétricos, mas quem define o que está exposto é o firewall da própria VPS. Os detalhes de regras estão em [firewall UFW na VPS Ubuntu](https://streethosting.com.br/guias/vps/firewall-ufw-vps-ubuntu).

## Teste, virada e DNS

A cidade nova precisa passar por um teste de verdade antes de receber qualquer jogador. Com tudo no lugar, siga esta ordem:

1. Suba a cidade na VPS e entre com a staff pelo console F8 usando `connect IP_DA_VPS:30120`.
2. Teste o que envolve banco: logar com um personagem antigo, abrir o inventário, tirar um veículo da garagem, sacar dinheiro, bater ponto no emprego e entrar em uma casa comprada.
3. Pelo menos 24 horas antes da virada, baixe o TTL do registro A do domínio para 300 segundos.
4. Na janela marcada, pare a cidade antiga, gere o dump final, importe na VPS e rode o rsync de novo para trazer o que mudou na pasta da cidade e na txData.
5. Aponte o registro A para o IP da VPS. Quem entra por `connect cidade.seudominio.com.br` passa a cair na máquina nova assim que o TTL expira.
6. Acompanhe o primeiro horário de pico no txAdmin, olhando tick, memória e erros no console.
7. Mantenha o servidor antigo desligado, mas intacto, por alguns dias. Ele é o seu plano de volta.

Quem ainda divulga o IP numérico precisa avisar o endereço novo com antecedência, porque só o domínio muda de destino sozinho. A parte humana da migração, com cronograma de avisos no Discord, escolha da janela e critérios para voltar atrás, está em [como migrar um servidor de jogo sem perder jogadores](https://streethosting.com.br/guias/infraestrutura/migrar-servidor-jogo-sem-perder-jogadores).

> **Dica**
>
> Não aproveite a migração para atualizar a base, trocar o framework ou limpar resources. Migre igual, estabilize por uma semana e só então comece as mudanças. Assim cada problema tem uma causa só.

## Qual VPS escolher para a cidade

O FiveM concentra a lógica dos resources em uma thread principal, então desempenho por núcleo pesa mais do que quantidade de núcleos. Por isso a linha [VPS Ryzen](https://streethosting.com.br/vps/ryzen), com Ryzen 9 9950X de até 5,7 GHz, memória DDR5 e NVMe, é a indicada. A memória depende de scripts, MLOs e veículos adicionados, e na VPS ela é dividida entre o FXServer, o MariaDB e o sistema.

- **4 vCPU, 8 GB DDR5 e 80 GB NVMe, R$ 114,00 por mês:** cidade de até 32 jogadores com o banco na mesma máquina.
- **6 vCPU, 16 GB DDR5 e 160 GB NVMe, R$ 214,00 por mês:** cidade cheia no horário nobre, com muitos MLOs e carros adicionados.
- **10 vCPU, 32 GB DDR5 e 320 GB NVMe, R$ 414,00 por mês:** cidade grande mais servidor de testes, site e bot na mesma VPS.

Todas ficam em São Paulo, com AntiDDoS incluso, acesso root e ativação em até 60 segundos, o que permite subir a VPS nova dias antes e ensaiar com calma. Se a cidade crescer, o upgrade é feito pelo painel, cobra só a diferença proporcional ao ciclo e exige um reinício da VM. A conta de memória por perfil de cidade está em [quanto de RAM um servidor FiveM precisa](https://streethosting.com.br/guias/vps/quanto-ram-servidor-fivem).

Se a equipe não precisa de root e prefere não cuidar de sistema, os planos prontos da [hospedagem FiveM](https://streethosting.com.br/fivem) vão de R$ 80,00 por mês, com 2 GB e até 20 jogadores, a R$ 370,00, com 13 GB e de 150 a 200 jogadores. E quando nem a maior VPS dá conta, os sinais de que é hora de hardware exclusivo estão em [VPS ou dedicado para FiveM](https://streethosting.com.br/guias/vps/servidor-dedicado-ou-vps-fivem-brasil).

## Perguntas frequentes

### Preciso gerar uma nova chave do FiveM ao trocar de servidor?

A chave fica vinculada ao IP público que a usou primeiro. Ao mudar para a VPS, revincule a chave ao novo IP no Cfx.re Portal ou gere outra e troque a linha sv_licenseKey no server.cfg. Se a chave antiga já apareceu em print ou repositório, gere uma nova de qualquer forma.

### Como levar o banco de dados da cidade FiveM para a VPS?

Exporte o banco com mysqldump, com a cidade parada e usando utf8mb4, e importe no MariaDB da VPS em um banco criado com o mesmo conjunto de caracteres. Depois ajuste a mysql_connection_string do oxmysql para o usuário, a senha e o banco novos.

### Perco os admins e os banimentos do txAdmin na migração?

Não, desde que você copie a pasta txData inteira com o servidor parado. Ela guarda as contas de admin, os agendamentos de reinício e o banco de jogadores com o histórico de punições. Na VPS, aponte o txAdmin para essa pasta e corrija o caminho da cidade nas configurações.

### Quais portas abrir para o FiveM na VPS?

A 30120 em TCP e UDP, que é por onde os jogadores entram. A 40120 do txAdmin deve ficar liberada só para o IP da staff ou ser acessada por túnel SSH. A 3306 do banco fica fechada, com o MariaDB escutando apenas em localhost.

### Dá para migrar um servidor FiveM de Windows para uma VPS Linux?

Dá, e é o caminho mais comum. Baixe o artefato Linux do FXServer, troque caminhos absolutos do Windows por caminhos relativos e confira maiúsculas e minúsculas nos nomes de arquivos, porque o Linux diferencia. Resources que dependem de arquivos .dll precisam de uma versão para Linux.

## Guias relacionados

- [Como instalar um servidor FiveM com txAdmin numa VPS](https://streethosting.com.br/guias/vps/instalar-servidor-fivem-txadmin-vps.md)
- [Como instalar MariaDB ou MySQL numa VPS Ubuntu](https://streethosting.com.br/guias/vps/instalar-mariadb-mysql-vps-ubuntu.md)
- [Migrar servidor de jogo sem perder jogadores](https://streethosting.com.br/guias/infraestrutura/migrar-servidor-jogo-sem-perder-jogadores.md)
- [Quanto de RAM um servidor FiveM precisa?](https://streethosting.com.br/guias/vps/quanto-ram-servidor-fivem.md)
- [FiveM: hora de sair da VPS para um dedicado?](https://streethosting.com.br/guias/vps/servidor-dedicado-ou-vps-fivem-brasil.md)

## Produtos citados

- https://streethosting.com.br/vps/ryzen
- https://streethosting.com.br/fivem

## Dados estruturados

```json
[
  {
    "@context": "https://schema.org",
    "@type": [
      "Article",
      "TechArticle"
    ],
    "headline": "Migrar a cidade FiveM para a VPS sem perder nenhum personagem",
    "name": "Como migrar um servidor FiveM para uma VPS",
    "abstract": "Uma cidade de roleplay é feita de arquivos, banco de dados, dados do txAdmin e uma chave presa a um IP. Este guia mostra como levar cada peça para a VPS, testar antes e virar o endereço sem que os jogadores percam progresso.",
    "description": "Leve a cidade FiveM para uma VPS: arquivos, banco com mysqldump, oxmysql, chave do Cfx.re no IP novo, txAdmin, firewall e DNS sem perder personagens.",
    "datePublished": "2026-09-28",
    "dateModified": "2026-09-28",
    "author": {
      "@type": "Organization",
      "name": "Equipe StreetHosting"
    },
    "publisher": {
      "@type": "Organization",
      "name": "StreetHosting",
      "url": "https://streethosting.com.br"
    },
    "inLanguage": "pt-BR",
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://streethosting.com.br/guias/vps/migrar-servidor-fivem-para-vps"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Preciso gerar uma nova chave do FiveM ao trocar de servidor?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "A chave fica vinculada ao IP público que a usou primeiro. Ao mudar para a VPS, revincule a chave ao novo IP no Cfx.re Portal ou gere outra e troque a linha sv_licenseKey no server.cfg. Se a chave antiga já apareceu em print ou repositório, gere uma nova de qualquer forma."
        }
      },
      {
        "@type": "Question",
        "name": "Como levar o banco de dados da cidade FiveM para a VPS?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Exporte o banco com mysqldump, com a cidade parada e usando utf8mb4, e importe no MariaDB da VPS em um banco criado com o mesmo conjunto de caracteres. Depois ajuste a mysql_connection_string do oxmysql para o usuário, a senha e o banco novos."
        }
      },
      {
        "@type": "Question",
        "name": "Perco os admins e os banimentos do txAdmin na migração?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Não, desde que você copie a pasta txData inteira com o servidor parado. Ela guarda as contas de admin, os agendamentos de reinício e o banco de jogadores com o histórico de punições. Na VPS, aponte o txAdmin para essa pasta e corrija o caminho da cidade nas configurações."
        }
      },
      {
        "@type": "Question",
        "name": "Quais portas abrir para o FiveM na VPS?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "A 30120 em TCP e UDP, que é por onde os jogadores entram. A 40120 do txAdmin deve ficar liberada só para o IP da staff ou ser acessada por túnel SSH. A 3306 do banco fica fechada, com o MariaDB escutando apenas em localhost."
        }
      },
      {
        "@type": "Question",
        "name": "Dá para migrar um servidor FiveM de Windows para uma VPS Linux?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Dá, e é o caminho mais comum. Baixe o artefato Linux do FXServer, troque caminhos absolutos do Windows por caminhos relativos e confira maiúsculas e minúsculas nos nomes de arquivos, porque o Linux diferencia. Resources que dependem de arquivos .dll precisam de uma versão para Linux."
        }
      }
    ]
  }
]
```