¿Qué es exactamente txAdmin?
txAdmin viene incluido por defecto en FXServer desde 2020: no hay nada que comprar ni instalar por separado. Al primer arranque de FXServer, txAdmin se inicia automáticamente y expone una interfaz web (puerto 40120 por defecto). Es el estándar de la comunidad FiveM, open-source y mantenido por el equipo de Cfx.re.
- Consola en vivo: logs del servidor en tiempo real, comandos, historial
- Recipes: despliegue automático de una base completa (QBCore, ESX Legacy, vanilla)
- Planificador: reinicios programados con anuncios en el juego
- Gestión de jugadores: bans, warns, whitelist, notas
- Monitorización: detección de crashes con reinicio automático
Requisitos
- Un VPS con al menos 4 GB de RAM — 8 GB recomendados para una base QBCore/ESX con jugadores. En Linux, Debian y Ubuntu son las distribuciones mejor documentadas: vea nuestras páginas VPS Debian y VPS Ubuntu. En Windows, necesita un VPS Windows con acceso RDP.
- Una clave de licencia gratuita creada en portal.cfx.re (obligatoria para cualquier servidor FiveM), que se indica en
server.cfg con sv_licenseKey
- Los puertos 30120 en TCP y en UDP (juego) y 40120 en TCP (panel txAdmin) abiertos en el firewall
- Una base MariaDB o MySQL si despliega un framework roleplay: tanto QBCore como ESX guardan allí los personajes, el inventario y la economía
Instalación en un VPS Linux
Descargue la última build de FXServer desde runtime.fivem.net, descomprímala en una carpeta (p. ej. ~/fxserver) y ejecute ./run.sh. txAdmin arranca automáticamente y muestra en el terminal un PIN de 4 dígitos válido unos minutos. Abra http://IP-DEL-VPS:40120, introduzca el PIN y vincule su cuenta Cfx.re: será su identificador de administrador. Para que el servidor sobreviva a una desconexión SSH, ejecútelo en tmux, screen o como servicio systemd — la sección siguiente da la unidad completa.
Ejecutar FXServer como servicio systemd
Un servidor lanzado a mano en un terminal muere con la sesión SSH y no vuelve si el VPS se reinicia. Un servicio systemd resuelve ambas cosas. Cree /etc/systemd/system/fxserver.service con el contenido siguiente, sustituyendo el usuario y las rutas por los suyos:
[Unit] — Description=FXServer FiveM y After=network.target mariadb.service: el servidor no arranca antes de que la red y la base estén listas[Service] — User=fivem, WorkingDirectory=/home/fivem/fxserver, ExecStart=/home/fivem/fxserver/run.sh, Restart=always, RestartSec=10[Install] — WantedBy=multi-user.target- Después
systemctl daemon-reload, systemctl enable --now fxserver y journalctl -u fxserver -f para leer los logs de arranque — ahí aparece el PIN en el primer inicio
Use una cuenta dedicada para el servidor
No ejecute FXServer como root. Cree un usuario de sistema dedicado (adduser --system --group fivem), coloque allí la carpeta del servidor y déle la propiedad de txData. Un recurso de terceros mal escrito — y circulan muchos en el ecosistema roleplay — solo alcanzará los archivos del juego, no el resto de la máquina. En un VPS que además aloja un sitio o una base de datos, esa separación es lo mínimo.
Instalar txAdmin en un VPS Windows
FXServer también se distribuye en build para Windows, y muchas comunidades roleplay se quedan ahí porque sus herramientas de desarrollo funcionan en ese sistema. El principio es idéntico: descargue server.zip desde runtime.fivem.net, descomprímalo y ejecute FXServer.exe. txAdmin arranca, muestra el PIN en la ventana de consola y el panel responde en http://IP-DEL-VPS:40120. Algunas diferencias conviene conocerlas:
- El firewall de Windows bloquea por defecto: cree dos reglas de entrada, una para el puerto 30120 en TCP y UDP y otra para el puerto 40120 en TCP (Firewall de Windows Defender con seguridad avanzada, o
New-NetFirewallRule en PowerShell)
- La ventana de consola se cierra con la sesión RDP: para que el servidor funcione permanentemente, registre
FXServer.exe como servicio de Windows (NSSM y WinSW son las dos herramientas habituales) o use una tarea programada activada «al iniciar el equipo»
- Prevea más memoria que en Linux: el propio sistema consume más. En nuestros VPS Windows, la entrada de gama parte de 8 GB, margen suficiente para una base QBCore o ESX
- La licencia de Microsoft no se suministra: es un gasto adicional a prever, a diferencia de un VPS Linux
Desplegar una base con recipes
En el primer acceso, el asistente de txAdmin propone desplegar una recipe: una base de servidor completa instalada automáticamente (framework, base de datos, recursos iniciales). Elija QBCore o ESX Legacy para roleplay, o una base vanilla para empezar de cero. En un VPS, instale antes MariaDB y cree una base de datos dedicada.
Qué puertos abrir, y por qué
Solo tres puertos, pero un error clásico consiste en abrir el 30120 únicamente en TCP. FiveM usa el mismo número de puerto en TCP y en UDP: el TCP sirve para el descubrimiento y la lista de servidores, el UDP para el tráfico de juego. Un servidor que aparece en la lista pero al que nadie logra conectarse es, casi siempre, el UDP olvidado.
- 30120/tcp y 30120/udp: el juego. Abiertos a todos. En Debian o Ubuntu,
ufw allow 30120 abre ambos protocolos de una vez
- 40120/tcp: el panel txAdmin. Restrínjalo a su dirección IP, vea más abajo
- 3306/tcp (MariaDB): no lo abra al exterior. La base corre en la misma máquina que FXServer y se alcanza en
127.0.0.1. Un puerto MySQL expuesto a Internet es una de las maneras más rápidas de perder una base de personajes
- El puerto del juego se puede cambiar (
endpoint_add_tcp y endpoint_add_udp en server.cfg): útil para tener un servidor de producción y otro de pruebas en la misma máquina
Cuántos recursos según el número de jugadores
El motor RAGE depende mucho de un solo núcleo: la frecuencia del procesador cuenta más que el número de vCore. Un VPS con 8 núcleos lentos aguantará menos jugadores que uno con 4 rápidos. En memoria, mandan los recursos de terceros — un servidor roleplay completo carga fácilmente un centenar de scripts.
- Base vanilla, unos pocos jugadores: 4 GB de RAM bastan, es el mínimo para arrancar FXServer
- QBCore o ESX, de 20 a 40 jugadores: 8 GB. La cincuentena de scripts de un servidor roleplay inicial consume ya de 2 a 4 GB, y MariaDB pide alrededor de 1 más
- Servidor consolidado, 64 slots o más, scripts propios: 16 GB y almacenamiento SSD — los accesos a la base son constantes durante las sesiones
- Disco: cuente el peso de sus recursos más la base, y deje sitio para las copias. Los servidores roleplay crecen con el tiempo, nunca al revés
La consola de txAdmin en el día a día
La pestaña Live Console muestra los logs del servidor en tiempo real y acepta todos los comandos de FXServer (refresh, ensure mi-recurso, restart es_extended...). Las acciones sensibles quedan registradas por cuenta de administrador: cada kick, ban o reinicio queda trazado, útil cuando varios moderadores gestionan el servidor.
- Scheduler: programe 1 o 2 reinicios al día con anuncios automáticos — la memoria de un servidor FiveM se fragmenta con el tiempo
- Backups: copie con regularidad su carpeta de datos y la base MySQL (txAdmin no copia la base por usted)
- Permisos: cree una cuenta de administrador por moderador con derechos limitados, en vez de compartir la cuenta principal
Actualizar FXServer y txAdmin
txAdmin no tiene actualización propia: va embebido en el artifact de FXServer, así que actualizar el servidor actualiza el panel. La operación es sencilla pero debe seguir el orden, o se pierde alguna configuración.
- Tome un snapshot del VPS desde el área de cliente, o como mínimo una copia de la carpeta del servidor y una exportación de la base
- Pare el servidor limpiamente (
systemctl stop fxserver, o el botón Stop de txAdmin)
- Sustituya únicamente los archivos del artifact — no toque
txData/, ni su carpeta resources/, ni server.cfg: son sus datos, no los del servidor
- Reinicie y compruebe en la consola que todos los recursos cargan. Un recurso incompatible con la nueva build se ve enseguida en los logs
- Conserve el artifact anterior unos días: volver atrás consiste entonces en reponer la carpeta antigua
Copiar lo que de verdad importa
Una observación repetida en soporte: «txAdmin hace backups, ¿no?». Los hace, pero no de lo que usted cree. txAdmin no copia la base de datos. Y es ella la que contiene los personajes, los vehículos, las cuentas bancarias y los inventarios — todo lo que su comunidad ha construido y que nadie le perdonará perder.
- La base: un
mysqldump diario en una tarea cron, enviado fuera del propio VPS
- La carpeta
txData/: contiene admins.json, la configuración del panel y el historial de sanciones
- Su carpeta
resources/ y server.cfg: sobre todo si ha modificado scripts comprados, esos cambios no existen en ningún otro sitio
- Los snapshots del VPS cubren la máquina entera y se restauran con un clic desde el área de cliente. Complementan las exportaciones de base, no las sustituyen: un snapshot también restaura el error que quería deshacer
Asegurar el acceso al panel
Un panel de administración expuesto en una IP pública es un objetivo evidente. Bastan tres medidas:
- Restringir el puerto 40120 a su IP:
ufw allow from SU_IP to any port 40120 y después ufw deny 40120 — solo sus coadministradores acceden al panel, el puerto del juego (30120) sigue abierto
- No desactivar nunca la autenticación, ni «solo para probar»: el modo sin contraseña de txAdmin es para desarrollo local, jamás en un VPS público
- Reverse-proxy HTTPS en producción (opcional): Nginx o Caddy delante, con un subdominio y un certificado Let's Encrypt, en lugar de exponer
ip:40120 en claro — transmita bien las cabeceras WebSocket (Upgrade/Connection), la consola en vivo depende de ellas
- Una cuenta de administrador por persona, con los mínimos derechos: txAdmin registra las acciones por cuenta, algo inútil si todos comparten el mismo acceso
Problemas frecuentes y soluciones
- Página 40120 inaccesible: el puerto está cerrado — ábralo en el firewall (
ufw allow 40120/tcp) o compruebe que txAdmin escucha (logs de arranque)
- El servidor aparece en la lista pero nadie puede entrar: el puerto 30120 solo está abierto en TCP. Ábralo también en UDP
- PIN caducado: reinicie FXServer, aparece un PIN nuevo en el terminal
- Acceso de administrador perdido: pare el servidor y borre
txData/admins.json — txAdmin relanza el asistente inicial
- «Invalid license key»: la clave Cfx.re está ligada a una IP. Si ha cambiado de servidor, regenérela en portal.cfx.re y sustituya la línea
sv_licenseKey de server.cfg
- La consola en vivo se queda vacía tras un reverse-proxy: no se transmiten las cabeceras WebSocket. Añada
Upgrade y Connection a la configuración de Nginx
- El servidor se reinicia en bucle: lea los logs justo antes del crash. Nueve de cada diez veces es un recurso de terceros añadido la víspera — quítelo de
server.cfg y reinicie para confirmarlo
- Servidor lento: vigile la pestaña de monitorización; si la RAM se satura con su base y sus jugadores, pase a un plan de VPS superior. El cambio se hace desde el área de cliente, sin reinstalar
- Ataques repetidos durante las sesiones: los servidores roleplay concurridos son atacados con regularidad. El filtrado a nivel de red es el único remedio; vea nuestra guía Entender el Anti-DDoS
