Execute um servidor FiveM no CasaOS: Guia de configuração do Docker

Sim, é possível executar um servidor FiveM num anfitrião CasaOS através do Docker. Essa foi a resposta alcançada no tópico da Comunidade IceWhale de setembro de 2023: o antigo PC de jogos do utilizador já tinha recursos suficientes para as cargas de trabalho do CasaOS, e os membros da comunidade salientaram que o FXServer do FiveM tem versões para Linux e pode ser colocado em contentor como uma aplicação personalizada do CasaOS.

O tópico histórico utilizava o spritsail/fivem imagem e expunha tanto a porta de jogo do FiveM como o txAdmin. Continua a ser uma arquitetura inicial útil, mas não deve ser confundida com um pacote oficial Cfx.re para CasaOS. A documentação atual da Cfx.re continua a suportar o FXServer em Linux, embora avise explicitamente que o servidor Linux é uma versão disponibilizada como cortesia e que, em geral, o Windows recebe melhor compatibilidade e suporte de diagnóstico. Em 2026, continuaram também a surgir problemas específicos do FiveM em Linux/Docker, pelo que deve testar o artefacto exato do servidor e a compilação do jogo que pretende utilizar.

O que o tópico original do CasaOS confirmou

A publicação original perguntava se seria possível executar um servidor FiveM privado num antigo PC de jogos que já funcionava como servidor CasaOS. Duas respostas forneceram a informação útil:

O FiveM/FXServer pode ser executado em Linux e no Docker.
Uma aplicação personalizada do CasaOS pode expor as portas necessárias e manter a configuração/os dados.
O servidor continua a precisar de uma chave de licença Cfx.re válida.
O hardware deve ser suficiente para o número de jogadores, recursos, scripts e carga da base de dados.

O ponto de partida do Docker Compose da comunidade

A resposta de 2023 propôs uma definição de aplicação personalizada do CasaOS baseada na spritsail/fivem image:

services:
  fivem:
    image: spritsail/fivem
    restart: on-failure
    environment:
      LICENSE_KEY: YOUR_LICENSE_KEY
      NO_DEFAULT_CONFIG: 1
    ports:
      - "40120:40120"
      - "30120:30120"
      - "30120:30120/udp"
    volumes:
      - /DATA/AppData/fivem/config:/config
      - /DATA/AppData/fivem/data:/txData
    stdin_open: true
    tty: true

Esta é uma configuração histórica derivada da fonte, não uma definição de aplicação mantida pela IceWhale. Consulte a documentação atual da imagem antes de a importar para um sistema CasaOS em produção.

De que portas precisa o FiveM?

A configuração da comunidade expunha:

30120/TCP — tráfego de jogo principal do FXServer.
30120/UDP — tráfego UDP principal do FXServer.
40120/TCP — interface Web do txAdmin na configuração de origem.

A documentação atual do txAdmin da Cfx.re ainda indica a porta 40120 como a porta HTTP predefinida do txAdmin. Consulte a documentação do txAdmin atual.

Criar uma chave de licença Cfx.re

A documentação atual de configuração de servidores do Cfx.re exige uma chave de licença do servidor antes de iniciar o FXServer. Registe o servidor através do fluxo de trabalho atual do Cfx.re/Cfx Portal e mantenha a chave privada.

Referência oficial: Configurar um Servidor.

Não adicione a chave a um repositório Git público nem a cole em capturas de ecrã. As variáveis de ambiente do CasaOS são convenientes, mas qualquer pessoa com acesso administrativo à configuração do Docker poderá conseguir lê-las.

Persistir a Configuração e os Dados do txAdmin

O Compose original montava:

/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data   → /txData

O princípio é mais importante do que esses caminhos exatos: a configuração do servidor e os perfis do txAdmin devem estar em armazenamento persistente do anfitrião, para que a recriação do contentor não apague o estado do servidor.

Antes de alterar imagens de contentores ou artefactos do servidor, faça uma cópia de segurança desses diretórios.

A Documentação Atual do FiveM Continua a Tratar o Linux como uma Adaptação Secundária para Servidores

A documentação atual de configuração vanilla do Cfx.re contém um aviso importante sobre Linux: a versão Linux do FXServer é fornecida como uma adaptação não oficial, uma vez que a compatibilidade entre distribuições Linux e as ferramentas de diagnóstico nativas pode ser mais difícil. Indica que é mais provável que os problemas recebam correções no Windows.

Isto não significa que os servidores Linux sejam inutilizáveis. Significa que uma implementação Docker no CasaOS tem uma camada adicional de compatibilidade em comparação com um servidor Windows normal suportado.

Os Problemas Específicos do FiveM no Docker Ainda Existem em 2026

Relatórios recentes de problemas do CitizenFX mostram que um FXServer Linux pode funcionar corretamente dentro do Docker, enquanto determinadas versões de jogo impostas ou artefactos Enhanced continuam a causar falhas específicas do contentor. Por exemplo, um problema reproduzido em 2026 provocou uma falha do cliente com sv_enforceGameBuild 3751 no Linux/Docker, enquanto o mesmo contentor vanilla funcionava sem essa definição.

É por isso que o arranque bem-sucedido de um contentor e uma página txAdmin acessível não garantem que todas as combinações de artefactos/recursos do FiveM sejam estáveis.

De Quanto Hardware Precisa?

A resposta original de 2023 citava requisitos mínimos antigos para computadores de secretária do FiveM. Esses valores não constituem uma fórmula fiável para dimensionar um servidor moderno. As necessidades de um servidor dedicado dependem fortemente de:

número de jogadores;
quantidade de frameworks e recursos;
qualidade dos scripts Lua/JavaScript/C#;
carga de trabalho da base de dados;
configuração do OneSync;
serviços adicionais, como MariaDB/MySQL.

Para um servidor privado pequeno, um PC antigo para jogos pode ser suficiente, mas o desempenho de um único núcleo do CPU e a margem disponível de RAM são mais importantes do que simplesmente corresponder a uma lista histórica de requisitos mínimos.

As frameworks do FiveM podem precisar de uma base de dados separada

Se instalar ESX, QBCore ou outra framework, o contentor do FiveM poderá precisar de aceder a um contentor MariaDB/MySQL. Coloque ambos os serviços numa rede Docker definida pelo utilizador para que possam comunicar através de um nome de serviço estável, em vez de endereços IP de contentor que mudam.

Mantenha os dados da base de dados no seu próprio diretório persistente AppData do CasaOS e faça uma cópia de segurança independente dos ficheiros do FXServer.

Teste na LAN antes de abrir o servidor à Internet

Comece por um teste local:

Confirme que o contentor do FiveM continua em execução.
Abra o txAdmin em http://CASAOS_IP:40120 se a imagem utilizar a porta predefinida.
Conclua a configuração do txAdmin.
Confirme 30120/TCP e 30120/UDP estão mapeadas.
Entre a partir de outro dispositivo na LAN.
Só depois dos testes locais configure as regras do router/firewall, caso os jogadores precisem de acesso através da Internet.

Alojamento na Internet implica responsabilidades de segurança

Um servidor de jogos público recebe tráfego não solicitado da Internet. Mantenha o próprio CasaOS, o SSH, a API do Docker e as portas da base de dados privadas. Exponha apenas as portas necessárias ao FXServer/txAdmin e considere restringir o acesso ao txAdmin, em vez de deixar a sua interface de gestão amplamente aberta.

Não exponha diretamente a MariaDB/MySQL à Internet apenas porque o FiveM precisa de uma base de dados.

Lista de verificação do servidor FiveM no CasaOS

Confirme que o anfitrião tem CPU, RAM e armazenamento suficientes.
Crie uma chave de licença de servidor do Cfx.re.
Escolha uma imagem Docker de FiveM/FXServer mantida ativamente ou crie a imagem por sua conta a partir dos artefactos atuais.
Mantenha a configuração e os dados de txData fora do contentor.
Exponha 30120/TCP e 30120/UDP.
Exponha o txAdmin apenas quando necessário.
Teste localmente antes de configurar regras públicas de firewall/NAT.
Faça uma cópia de segurança de txData, dos recursos, de server.cfg e de qualquer base de dados externa.
Conte com diferenças de compatibilidade entre Linux/Docker e o FXServer para Windows.

Perguntas frequentes sobre o FiveM no CasaOS

O FiveM pode ser executado no CasaOS?

Sim. O tópico de origem fornecia uma arquitetura Docker funcional para uma aplicação CasaOS personalizada. A própria imagem do contentor era de terceiros, não um pacote oficial do CasaOS.

A spritsail/fivem é uma imagem oficial do Cfx.re?

Não. É uma imagem Docker de terceiros referenciada pela comunidade. Verifique o seu estado atual de manutenção antes de a utilizar.

Que portas devo mapear?

Foi utilizada a configuração de origem 30120/TCP, 30120/UDP, e 40120/TCP para o txAdmin.

O Linux/Docker tem o mesmo nível de suporte que o Windows?

Não exatamente. A documentação atual do Cfx.re descreve explicitamente o FXServer para Linux como uma adaptação disponibilizada a título de cortesia e afirma que é mais provável que o Windows receba correções para problemas de compatibilidade.