Solución de la comunidad

Cómo ejecutar un servidor de FiveM en CasaOS con Docker

A 2023 CasaOS user asked whether an old gaming PC could host a private FiveM server. Community replies confirmed that FiveM's FXServer can run in Docker and supplied a CasaOS-compatible Compose starting point.

Sí, un servidor de FiveM puede ejecutarse en un host CasaOS mediante Docker. Esa fue la respuesta a la que llegó el hilo de la comunidad de IceWhale en septiembre de 2023: la antigua PC para juegos del usuario ya tenía recursos suficientes para las cargas de trabajo de CasaOS, y los miembros de la comunidad señalaron que FXServer de FiveM tiene compilaciones para Linux y puede contenerizarse como una aplicación personalizada de CasaOS.

El hilo histórico utilizaba la imagen de terceros spritsail/fivem imagen y exponía tanto el puerto de juego de FiveM como txAdmin. Sigue siendo una arquitectura inicial útil, pero no debe confundirse con un paquete oficial de CasaOS de Cfx.re. La documentación actual de Cfx.re todavía admite FXServer en Linux, aunque advierte explícitamente que el servidor de Linux es una adaptación ofrecida como cortesía y que, por lo general, Windows recibe mejor compatibilidad y asistencia para el diagnóstico. En 2026, también han seguido apareciendo problemas específicos de FiveM en Linux y Docker, así que prueba exactamente el artefacto del servidor y la compilación del juego que planeas usar.

Lo que confirmó el hilo original de CasaOS

La publicación original preguntaba si se podía ejecutar un servidor privado de FiveM en una PC antigua para juegos que ya funcionaba como servidor de CasaOS. Dos respuestas proporcionaron la información útil:

  • FiveM/FXServer puede ejecutarse en Linux y Docker.
  • Una aplicación personalizada de CasaOS puede exponer los puertos necesarios y conservar la configuración y los datos.
  • El servidor todavía necesita una clave de licencia válida de Cfx.re.
  • El hardware debe ser suficiente para la cantidad de jugadores, recursos, scripts y carga de la base de datos.

El punto de partida de Docker Compose de la comunidad

La respuesta de 2023 propuso una definición de aplicación personalizada de CasaOS basada en la imagen de terceros 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 es una configuración histórica derivada de la fuente, no una definición de aplicación mantenida por IceWhale. Revisa la documentación actual de la imagen antes de importarla a un sistema CasaOS activo.

¿Qué puertos necesita FiveM?

La configuración de la comunidad exponía:

  • 30120/TCP — tráfico de juego principal de FXServer.
  • 30120/UDP — tráfico UDP principal de FXServer.
  • 40120/TCP — interfaz web de txAdmin en la configuración de origen.

La documentación actual de txAdmin de Cfx.re todavía indica el puerto 40120 como puerto HTTP predeterminado de txAdmin. Consulta la documentación de txAdmin actual.

Crear una clave de licencia de Cfx.re

La documentación actual de configuración del servidor de Cfx.re requiere una clave de licencia del servidor antes de iniciar FXServer. Registra el servidor mediante el flujo actual de Cfx.re/Cfx Portal y mantén la clave en privado.

Referencia oficial: Configurar un servidor.

No confirmes la clave en un repositorio Git público ni la pegues en capturas de pantalla. Las variables de entorno de CasaOS son prácticas, pero cualquier persona con acceso administrativo a la configuración de Docker podría leerlas.

Conserva la configuración y los datos de txAdmin

El Compose original montaba:

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

El principio es más importante que esas rutas exactas: la configuración del servidor y los perfiles de txAdmin deben residir en el almacenamiento persistente del host para que recrear el contenedor no borre el estado del servidor.

Antes de cambiar las imágenes del contenedor o los artefactos del servidor, haz una copia de seguridad de esos directorios.

La documentación actual de FiveM sigue considerando Linux un port de servidor secundario

La documentación actual de configuración vanilla de Cfx.re contiene una advertencia importante sobre Linux: la versión de FXServer para Linux se proporciona como un port no oficial, ya que la compatibilidad con las distribuciones de Linux y las herramientas de diagnóstico nativas pueden ser más complicadas. Indica que es más probable que los problemas reciban correcciones en Windows.

Esto no significa que los servidores Linux sean inutilizables. Significa que una implementación de Docker en CasaOS tiene una capa de compatibilidad adicional en comparación con un servidor Windows normal y compatible.

Los problemas específicos de FiveM en Docker aún existen en 2026

Informes recientes de problemas de CitizenFX muestran que un FXServer de Linux puede ejecutarse correctamente dentro de Docker, mientras que determinadas versiones de juego forzadas o artefactos Enhanced siguen provocando fallos específicos del contenedor. Por ejemplo, un problema de 2026 reprodujo un bloqueo del cliente con sv_enforceGameBuild 3751 en Linux/Docker, mientras que el mismo contenedor vanilla funcionó sin ese ajuste.

Por eso, que un contenedor se inicie correctamente y que la página de txAdmin sea accesible no garantiza que todas las combinaciones de artefactos y recursos de FiveM sean estables.

¿Cuánto hardware necesitas?

La respuesta original de 2023 citaba requisitos mínimos de escritorio antiguos para FiveM. Esos valores no son una fórmula fiable para dimensionar un servidor moderno. La demanda del servidor dedicado depende en gran medida de:

  • cantidad de jugadores;
  • cantidad de frameworks y recursos;
  • calidad de los scripts de Lua/JavaScript/C#;
  • carga de trabajo de la base de datos;
  • Configuración de OneSync;
  • servicios adicionales, como MariaDB/MySQL.

Para un servidor privado pequeño, un PC antiguo para juegos puede ser suficiente, pero el rendimiento de un solo núcleo de la CPU y la memoria RAM disponible importan más que limitarse a cumplir una lista de requisitos mínimos histórica.

Los frameworks de FiveM pueden necesitar una base de datos independiente

Si instalas ESX, QBCore u otro framework, es posible que el contenedor de FiveM deba conectarse a un contenedor de MariaDB/MySQL. Coloca ambos servicios en una red de Docker definida por el usuario para que puedan comunicarse mediante un nombre de servicio estable en lugar de direcciones IP de contenedor cambiantes.

Mantén los datos de la base de datos en su propio directorio persistente de AppData de CasaOS y haz copias de seguridad independientes de los archivos de FXServer.

Prueba en la LAN antes de abrir el servidor a internet

Empieza con una prueba local:

  1. Confirma que el contenedor de FiveM siga ejecutándose.
  2. Abre txAdmin en http://CASAOS_IP:40120 si la imagen utiliza el puerto predeterminado.
  3. Termina la configuración de txAdmin.
  4. Confirma 30120/TCP y 30120/UDP estén asignados.
  5. Conéctate desde otro dispositivo de la LAN.
  6. Solo después de realizar pruebas locales, configura las reglas del router/firewall si los jugadores necesitan acceso desde internet.

Alojarlo en internet implica responsabilidades de seguridad adicionales

Un servidor de juegos público recibe tráfico de internet no solicitado. Mantén CasaOS, SSH, la API de Docker y los puertos de la base de datos en privado. Expón únicamente los puertos necesarios para FXServer/txAdmin y considera restringir el acceso a txAdmin en lugar de dejar su interfaz de administración ampliamente abierta.

No expongas MariaDB/MySQL directamente a internet simplemente porque FiveM necesite una base de datos.

Lista de comprobación del servidor FiveM en CasaOS

  1. Confirma que el host tenga suficiente CPU, RAM y almacenamiento.
  2. Crea una clave de licencia de servidor de Cfx.re.
  3. Elige una imagen de Docker de FiveM/FXServer con mantenimiento activo o crea tú mismo la imagen a partir de artefactos actuales.
  4. Conserva la configuración y txData fuera del contenedor.
  5. Expón 30120/TCP y 30120/UDP.
  6. Expón txAdmin solo cuando sea necesario.
  7. Haz pruebas localmente antes de configurar reglas públicas de firewall/NAT.
  8. Haz copias de seguridad de txData, los recursos, server.cfg y cualquier base de datos externa.
  9. Espera diferencias de compatibilidad entre Linux/Docker y FXServer para Windows.

Preguntas frecuentes sobre FiveM en CasaOS

¿Puede FiveM ejecutarse en CasaOS?

Sí. El hilo de origen proporcionaba una arquitectura de Docker funcional para una aplicación personalizada de CasaOS. La imagen del contenedor era de terceros, no un paquete oficial de CasaOS.

¿spritsail/fivem es una imagen oficial de Cfx.re?

No. Es una imagen de Docker de terceros mencionada por la comunidad. Comprueba su estado actual de mantenimiento antes de usarla.

¿Qué puertos debo asignar?

La configuración de origen utilizada 30120/TCP, 30120/UDP, y 40120/TCP para txAdmin.

¿Linux/Docker tiene el mismo nivel de compatibilidad que Windows?

No exactamente. La documentación actual de Cfx.re describe explícitamente FXServer para Linux como un port ofrecido «como cortesía» y señala que es más probable que Windows reciba correcciones para problemas de compatibilidad.