Resposta rápida: comece com o exemplo oficial Cfx.re, altere apenas o endpoint, os campos do projeto, o limite de slots, a chave de registro do servidor e a lista explícita de recursos, depois valide no txAdmin e teste uma conexão direta. Mantenha uma cópia conhecida como boa antes de cada edição.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sets sv_projectName "Meu Servidor"
sets sv_projectDesc "Uma descrição clara em uma frase"
sv_hostname "Meu Servidor"
set onesync on
sv_maxclients 48
sv_licenseKey "substituir_com_a_chave_do_portal"
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcapLimite de segurança: sv_endpointPrivacidade oculta os IPs dos jogadores de relatórios públicos; não fornece mitigação de DDoS ou esconde a origem do servidor. Deixe o RCon desativado a menos que seja explicitamente necessário, e nunca publique licenças reais, banco de dados, Steam, Tebex ou segredos de webhook.
O servidor.cfg O arquivo é o coração de cada servidor FiveM. Ele define como seu servidor funciona: slots, rede, criação de jogos, OneSync, registro e visibilidade na lista de servidores. Este guia é para proprietários e desenvolvedores de servidores que desejam padrões seguros, reforço de produção e melhores práticas de desempenho. Sempre mantenha backups e use o controle de versão. Se você é novo, comece com nosso Como criar um servidor FiveM. Para otimizações mais profundas, consulte nosso Centro de desempenho.
TL;DR: Linha de base pronta para produção (anotada)
Uma limpeza servidor.cfg é a base da estabilidade. Abaixo estão dois exemplos: um mínimo configuração de desenvolvimento e um configuração de produção reforçada.
Configuração mínima de desenvolvimento
# server.cfg (desenvolvimento) # Configuração básica para testes locais # Rede endpoint_add_tcp "0.0.0.0:30120" # vinculação de porta TCP endpoint_add_udp "0.0.0.0:30120" # vinculação de porta UDP # Informações do servidor sv_hostname "My Dev Server" sv_maxclients 8 # OneSync set onesync on # Recursos (exemplo básico) ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure hardcap ensure baseevents # Permissões (ACL padrão) exec permissions.cfg
Configuração de produção reforçada
# server.cfg (produção) # Rede endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" # Segurança sv_endpointPrivacy true # Oculta endereços IP dos jogadores de relatórios públicos do servidor; não oculta a origem do servidor sv_scriptHook 0 # Desabilita mods de cliente # Deixe rcon_password não definido a menos que o RCon legado seja explicitamente necessário # Slots sv_maxclients 64 # Ajuste para a capacidade do host # Build do jogo (use a versão recomendada mais recente) # Opcional: fixe um build do jogo documentado apenas quando seus recursos exigirem # Informações do projeto sv_hostname "FIVEMX Roleplay | Serious RP" sets sv_projectName "FIVEMX RP Server" sets sv_projectDesc "Realistic RP com QBCore & scripts personalizados" sets tags "roleplay, seriousrp, qbcore" sets locale "en-US" load_server_icon mylogo.png sets banner_detail "https://cdn.example.com/banner.png" sets banner_connecting "https://cdn.example.com/loading.png" # OneSync set onesync on # Recursos (use a lista de recursos) exec resources.cfg # Registro & ACL set sv_logLevel 2 exec permissions.cfg # Integração txAdmin # Carregue a configuração do framework/banco de dados de um config separado com permissões; não publique credenciais reais
Dica: Sempre valide sua configuração após edições com verificações de integridade do txAdmin e logs do console. Veja registros do txAdmin.
Informações e listagem do servidor
As seguintes convars controlam como seu servidor aparece no navegador do servidor e API:
| Convar | Propósito | Exemplo | Quando mudar | Advertências |
|---|---|---|---|---|
sv_nome_do_host | Nome público na lista de servidores | sv_hostname "Meu Servidor RP [EN]" | Sempre definido | Evite caracteres especiais, mantenha-se afastado |
define sv_projectName | Nome de exibição do projeto interno | define sv_projectName "MyCommunityRP" | Configuração de marca e multi-servidor | Visível somente na lista da IU |
define sv_projectDesc | Descrição mostrada na lista | define sv_projectDesc "Servidor QBCore RP" | Adicionar regras, idioma, recursos | Mantenha < 100 caracteres |
define tags | Tags da lista de servidores | define as tags "roleplay, carros, qbcore" | Melhore a capacidade de descoberta | Use apenas tags oficiais |
define localidade | Idioma padrão | define a localidade "en-US" | Idioma do servidor de correspondência | Localidade errada pode ocultar o servidor |
sv_endpointPrivacidade | Ocultar IP público no navegador | sv_endpointPrivacy verdadeiro | Recomendado para produção | Os jogadores se conectam via relé Cfx |
ícone_do_servidor_de_carga | Ícone PNG 96×96 | load_server_icon mylogo.png | Para branding | Deve ser quadrado, <96×96 pixels |
define banner_detail | Banner grande na lista de servidores | define banner_detail "url" | Opcional, mas recomendado | Deve ser URL HTTPS |
define banner_connecting | Banner exibido na conexão | define banner_connecting "url" | Bom para branding/carregamento | Use CDN para evitar atrasos |
Veja o Referência oficial de comando e convar do servidor Cfx.re para a sintaxe e comportamento atuais.
Redes e slots
Os servidores FiveM usam Pontos finais TCP/UDP. Por padrão, a porta 30120 é usado.
endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" sv_maxclients 64
- Execute vários servidores em uma máquina com deslocamentos de porta: por exemplo
30121,30122. - Combine regras de firewall para abrir portas TCP/UDP.
sv_maxclientsafeta diretamente o uso da CPU e da RAM — não defina um valor maior do que seu hardware pode suportar. Veja provedores de hospedagem de servidores
Aviso: Não exponha portas MySQL ou RCON à internet.
Construção e artefatos do jogo
Uma versão de artefato FXServer e uma compilação de jogo GTA são escolhas separadas. Atualize os artefatos através do caminho de compilação recomendado pelo Cfx.re; defina sv_enforceGameBuild apenas quando os recursos do servidor exigirem uma construção de conteúdo GTA documentada, e verifique o valor em relação ao comando de referência Cfx.re atual.
# Configuração opcional apenas no início; escolha um valor da referência atual Cfx.re # sv_enforceGameBuild
- [Documento oficial do convars][1] lista números de compilação válidos.
- Definir construção em
servidor.cfgou em txAdmin → Configurações → FXServer → Argumentos adicionais:
+definir sv_enforceGameBuild 2944
- Baixe a última versão artefatos de [runtime.fivem.net][4] (Windows) ou da página de compilação do Linux.
- Nunca misture compilações de cliente e servidor.
Configuração OneSync
O OneSync permite sincronização de entidade do lado do servidor: mais jogadores, estados precisos, melhor streaming. Use sempre OneSync ativado para estruturas modernas (QBCore, ESX).
| Contexto | Efeito | Valor típico | Impacto na CPU/memória | Documentos |
sincronização única | Habilita o OneSync | sobre | Maior uso da CPU | [Documentação OneSync][3] |
população_onesync | Controla NPCs/tráfego local | sobre (opcional) | Adiciona carga de CPU | [Documentação OneSync][3] |
onesync_distanceCullVehicles | Transmita veículos com eficiência | verdadeiro | Melhor desempenho, economiza largura de banda | [Documentação OneSync][3] |
Dica: Escala
sv_maxclientscom hardware. Usar Guia Resmon para medir o impacto dos recursos.
Ordem de início dos recursos e dependências
Os recursos são carregados na ordem definida por garantir. Sempre inicie as dependências primeiro.
# resources.cfg (arquivo dividido) garantir oxmysql garantir qb-core garantir qb-adminmenu garantir qb-inventory garantir qb-policejob garantir my-custom-scripts
Em servidor.cfg:
recursos exec.cfg
- Mantenha as estruturas e os conectores de banco de dados em primeiro lugar.
- Recursos relacionados ao grupo.
- Evitar
garantir *na produção; causa ordem não determinística.
Reforço da segurança e do abuso
Um seguro servidor.cfg evita vazamentos e abusos.
Lista de verificação:
sv_endpointPrivacy verdadeirosv_scriptHook 0(bloquear mods do cliente)- Forte ou incapacitado
rcon_senha - Usar
adicionar_principaleadicionar_acepara ACLs - Mantenha segredos fora de repositórios públicos e arquivos de recursos compartilhados/cliente; restrinja o acesso à configuração exclusiva do servidor que os contém
- Atualize artefatos regularmente
- Monitor registros do txAdmin
- Usar Guia Resmon para pegar scripts pesados
Exemplo de ACL:
comando add_ace group.admin permite identificador add_principal.steam:110000112345678 group.admin
CDN e streaming de ativos (quando usar)
Para grandes MLOs, carros personalizados e texturas, use um CDN para reduzir tempos de junção.
- Hospedar arquivos em um CDN como Cloudflare R2 (definir [cabeçalhos CORS][6]).
- Para alto desempenho, BunnyCDN suporta [solicitações de intervalo][7] (necessário para
.rpftransmissão). - Adicione URLs versionadas para evitar conflitos de cache.
Veja nosso Otimize os tempos de carregamento guia.
Mitos e sinalizadores obsoletos
Muitas configurações on-line ainda mostram cvars do mecanismo de origem como:
sv_maxrate 0 sv_minrate 30000 sv_maxupdaterate 60
Não utilizar. Eles não são suportados no FiveM e não têm efeito. Veja [convars oficiais][1].
Convars obsoletos/legados:
sv_mestre1→ não é mais necessário.sv_useDirectListing→ substituído porsv_endpointPrivacidade.
Validação e solução de problemas
Verificações de chave após a edição servidor.cfg:
| Sintoma | Causa provável | Consertar | Tempo |
| Servidor não inicia | Erro de sintaxe na configuração | Verifique o console e remova as linhas inválidas | 5m |
| Não está na lista de servidores | Ausente sv_nome_do_host/etiquetas | Adicione nome de host/tags, verifique o firewall, sv_mestre1 | 10m |
| Os jogadores não conseguem se conectar | Portas fechadas / IP errado | Abra 30120 TCP+UDP, verifique endpoint_add_* | 15m |
| Alto uso da CPU | Muitos slots / scripts ruins | Mais baixo sv_maxclients, usar Ajuste de desempenho | 20m |
| Longos tempos de carregamento | Grandes ativos não otimizados | Usar Otimize os tempos de carregamento + CDN | 20m |
| Travamentos após atualização | Incompatibilidade de construção | Alfinete sv_enforceGameBuild, atualizar [artefatos][4] | 15m |
Explore produtos de servidor completos para lançamentos e reformulações.
Recursos internos e próximos passos
Perguntas frequentes
1. O que é servidor.cfg no FiveM?
É o arquivo de configuração principal que define o nome do servidor, slots, recursos, rede, segurança e visibilidade.
2. Onde devo colocar servidor.cfg?
Dentro da pasta raiz do seu servidor (ao lado de servidor.exe ou Servidor FX ponto de entrada). O txAdmin o carrega automaticamente.
3. Qual é a diferença entre definir, conjuntos, e conjunto?
definir: variável somente do servidor.conjuntos: aparece na lista de servidores (informações públicas).conjunto: sincronizado com clientes.
4. Meu servidor não aparece na lista. Por quê?
Verificar sv_nome_do_host, define tags, define localidade, e sv_endpointPrivacidade. Certifique-se também de que suas portas estejam abertas.
5. Como posso aumentar os slots de jogadores?
Mudar sv_maxclients. Escale gradualmente e monitore com Guia Resmon. Certifique-se de que seu hardware e rede podem suportar isso.
6. O que é sv_enforceGameBuild?
Uma convar que força os clientes a usar uma versão específica do jogo GTA V. Evita travamentos causados por versões incompatíveis. Consulte [documentação Convars][1].
7. Devo usar números de compilação ou aliases?
Qualquer um funciona. Numérico (2944) é explícito; alias (mp2024_02) é mais fácil de rastrear. Ambos são suportados.
8. Onde eu coloco sv_enforceGameBuild no txAdmin?
Em txAdmin → Configurações → FXServer → Argumentos adicionais. Exemplo: +definir sv_enforceGameBuild 2944.
9. O que é OneSync?
Um sistema que permite mais jogadores, streaming preciso de entidades e autoridade de servidor. Necessário para frameworks modernos. Consulte [documentação do OneSync][3].
10. Infinity ou OneSync antigo?
Legado = até 64 slots. Infinito = suporta mais de 128, sincronização avançada de entidades. Sempre use onesync ativado (Infinito por padrão).
11. Como organizo os recursos?
Usar recursos exec.cfg. Inicie os conectores do banco de dados primeiro, depois os frameworks e, por fim, os jobs/scripts. Evite garantir *.
12. Meus banners não aparecem na lista de servidores.
Certifique-se de que as URLs sejam HTTPS, públicas e apontem para os tamanhos de imagem corretos. Use uma CDN para maior confiabilidade.
13. Para que servem os logs do txAdmin?
Eles mostram erros, travamentos, problemas de recursos. Veja registros do txAdmin.
14. Como posso verificar problemas de desempenho?
Usar resposta 1 no console. Veja nosso Guia Resmon para mais detalhes.
15. Os sinalizadores de taxa do mecanismo de origem são necessários?
Não. sv_maxrate, sv_minrate, sv_maxupdaterate não faça nada no FiveM. Use [Convars doc][1] em vez disso.
Créditos:
- [Convars – Documentação Cfx.re][1]
- [Comandos do servidor – Documentação Cfx.re][2]
- [OneSync – Documentação do Cfx.re][3]
- [Artefatos (compilações do Windows) – runtime.fivem.net
Recursos relacionados ao FiveMX
Use estas seções para comparar categorias relacionadas do FiveM e configurar recursos antes de alterar um servidor em produção.
Verificações de configuração antes de adicionar recursos
Quando novos recursos alteram jobs, workflows EMS ou ordem de inicialização do servidor, revise Notas de configuração do FiveM Jobs Creator, compare scripts médicos, e mantenha o correção de erro de inflação falhou disponível para problemas de carregamento de recursos.
Para os campos específicos da lista e atuais sv_mestre1 comportamento, continue com o Guia de configuração da lista de servidores FiveM.
