Cómo configurar txAdmin en tu servidor FiveM

Tu servidor se despliega con txAdmin en ejecución y el servidor de juego retenido a propósito. Cinco pasos del asistente lo ponen en línea, y uno de ellos, la conexión a la base de datos, es donde casi todos se detienen, porque sus campos están ocultos tras un botón. El botón y los valores están en esta página.

Primero: un servidor desconectado es normal aquí

Un despliegue nuevo de FiveM inicia txAdmin y nada más. El puerto del juego permanece en silencio a propósito hasta que hayas reclamado la cuenta de administrador, aportado una clave de licencia y elegido una versión del servidor, porque un servidor FiveM sin nada de eso no puede arrancar. Así que durante los primeros minutos tras desplegar, que tu panel muestre el servidor como aún sin aceptar jugadores es el estado esperado y no un fallo.

El panel lo dice así: la tarjeta del servidor se pone ámbar con Acción necesaria: termina la configuración en txAdmin, y al abrirla tienes el enlace de txAdmin y el PIN que se describen abajo. Nada de esta página necesita un ticket de soporte.

Los cinco pasos

1. Abre txAdmin

No necesitas buscar ninguna dirección. En tu panel, el banner ámbar de la tarjeta del servidor abre un panel con un botón Abrir txAdmin, y el mismo botón aparece en la pestaña Jugadores cuando haces clic en Gestionar. Apunta al dominio txAdmin propio de tu servidor, que sigue funcionando tras una conmutación por error porque siempre resuelve a la instancia que sea la primaria en ese momento. Por eso enlazamos en lugar de mostrar la IP de un nodo: una IP es correcta hasta el día en que deja de serlo.

2. Reclama la cuenta de administrador con el PIN

En su primer arranque txAdmin pide un PIN que imprime solo en la consola del servidor, y luego te pide crear un usuario y una contraseña de administrador maestro para el propio panel. En un servidor gestionado esa consola no es algo que normalmente verías, así que el panel lee el PIN del registro del contenedor y lo muestra en el mismo panel que el botón de txAdmin, listo para copiar.

El inicio de sesión de administrador maestro no es tu cuenta de Flux, ni tu cuenta de Cfx.re, ni la contraseña de la base de datos. Es una tercera credencial, es la vía de vuelta a tu panel y nadie puede restablecerla por ti. Guárdala antes de continuar. Si el PIN ha caducado cuando lo uses, reinicia el servidor desde el panel y se imprime uno nuevo.

3. Elige una versión del servidor

A continuación el asistente ofrece una receta o un servidor existente. Una receta como qbcore, qbox o ESX descarga el framework, sus recursos y su esquema SQL, e importa el esquema en tu base de datos, que es la ruta más rápida hacia un servidor de roleplay funcional. Elige una y txAdmin la muestra en una pantalla llamada Step 1: Review Recipe. Continúa y llegas a Step 2: Input Parameters, donde ocurren los dos pasos siguientes.

4. Añade tu clave de licencia de cfx.re

El primer campo de Input Parameters es Server Registration Key. Genera una gratis en portal.cfx.re y pega el valor cfxk_. La clave se emite a tu cuenta y no a la nuestra, que es la razón de que el servidor sea tuyo para moverlo; el despliegue define NO_LICENSE_KEY=1 para que se aporte aquí y no quede incrustada en la app. Si alguna vez regeneras la clave, puedes cambiarla después sin repetir el asistente: es un campo de la pestaña Server Settings del panel de gestión.

5. Abre las opciones de base de datos y conecta la base de datos

Este es el paso que genera más tickets de soporte, porque los campos de la base de datos están ocultos. Justo bajo la clave hay un botón gris, Show/Hide Database options (advanced). Haz clic en él. Solo entonces aparecen los campos Database Host, Port, Username, Password y Name. Si te saltas el botón, la receta se ejecuta con los valores por defecto de txAdmin y la conexión a la base de datos falla.

Los campos vienen rellenados, con localhost como host y 3306 como puerto. Esos valores por defecto son incorrectos en este servidor. Sustituye lo que hay en cada campo por estos valores:

Campo	Valor	Por qué
Host	operator	El operador de sincronización, no el contenedor de la base de datos
Port	3307	En qué escucha el operador dentro de tu app
Username	root	Lo fija la especificación, no se puede editar
Password	MYSQL_ROOT_PASSWORD	La que elegiste al desplegar. Muéstrala en Ajustes de despliegue
Database	fivem	Se crea vacía para ti antes de que arranque el servidor

El host es el operador de sincronización y no el contenedor de la base de datos, la contraseña es la que elegiste al desplegar, y la propia base de datos se crea vacía por ti antes de que arranque el servidor.

La contraseña está en el panel de gestión, en Deployment Settings, como MYSQL_ROOT_PASSWORD, con un botón para mostrarla y otro para copiarla. El panel también imprime estos cuatro valores fijos en una tarjeta a su lado, para que puedas copiarlos directamente en txAdmin sin volver aquí.

Vale la pena nombrar dos suposiciones porque ambas son erróneas y ambas parecen correctas. El host no es localhost: txAdmin y la base de datos son contenedores separados. El host tampoco es mariadb, aunque haya un componente con ese nombre. Todo pasa por el operador, que es lo que replica cada escritura en las otras instancias; escribir directamente en una MariaDB desincronizaría tu ciudad y la perderías en una conmutación por error.

Después ejecuta la receta. txAdmin descarga el artifact de FiveM, importa el esquema, escribe server.cfg e inicia el servidor, y tu panel se pone en verde en pocos minutos. Si elegiste un servidor existente en lugar de una receta, no hay campos de base de datos que rellenar: define la conexión en tu server.cfg, como se muestra en las preguntas de abajo.

Si txAdmin dice que no puede conectarse

Comprueba primero el host y el puerto, porque localhost y mariadb son las suposiciones habituales y ninguna funciona. Si son correctos, es una discrepancia de contraseña. La base de datos se aprovisiona con MYSQL_ROOT_PASSWORD y el operador se autentica con DB_INIT_PASS, y ambas deben ser idénticas para que la base de datos se inicialice siquiera. El panel las mantiene vinculadas precisamente por eso: editar una reescribe la otra, y el campo está marcado como vinculado para que el comportamiento no parezca un formulario que rechaza lo que escribes. Lo que escribas en txAdmin tiene que ser ese mismo valor.

Volver a entrar más adelante

Tras el asistente, txAdmin es el panel del día a día: consola en vivo, recursos, bloqueos, el editor de CFG y reinicios programados. El mismo botón Open txAdmin te lleva allí, y entras con la cuenta de administrador maestro del paso 2. El panel conserva la capa inferior: reinicios y redespliegues, el explorador de archivos, el hardware, el estado de la base de datos entre nodos y las copias de seguridad.

¿Aún no has desplegado?

txAdmin en su propia dirección, la base de datos creada y conectada antes de que cargue el primer recurso, y ambos puertos publicados sin ningún cortafuegos que tocar. Primera semana gratis si tu cuenta de Flux es nueva.

Preguntas frecuentes

¿Qué introduzco en los ajustes de base de datos de txAdmin?

Primero haz clic en Show/Hide Database options (advanced) en la pantalla Input Parameters, bajo la clave de registro, porque los campos están ocultos hasta que lo haces. Luego sustituye los valores rellenados por host operator, puerto 3307, usuario root, base de datos fivem y la MYSQL_ROOT_PASSWORD que elegiste al desplegar. txAdmin no encuentra el operador por sí solo. La contraseña se muestra y se copia desde Deployment Settings en el panel de gestión.

¿Por qué mi servidor de FiveM está desconectado justo después de desplegar?

Porque aún no se ha configurado, y es a propósito. El despliegue se ejecuta sin configuración por defecto ni clave de licencia, así que txAdmin arranca en su propia dirección y el puerto del juego permanece en silencio hasta que reclamas la cuenta de administrador, añades tu clave de cfx.re y despliegas una versión del servidor. Se conecta unos minutos después de que termine el asistente.

¿Dónde encuentro el PIN de txAdmin?

En tu panel. txAdmin lo imprime solo en la consola del servidor, así que el panel lo lee del registro del contenedor y lo muestra, listo para copiar, junto al botón Open txAdmin. Si ha caducado, reinicia el servidor y se imprime uno nuevo.

¿Puedo conectarme directamente a MariaDB?

No, y conviene saber por qué. Cada escritura tiene que pasar por el operador en el puerto 3307, que la replica en tus otras instancias. Apuntar cualquier cosa directamente a un contenedor MariaDB escribe solo en una máquina, y esos datos son los que pierdes la próxima vez que cambie el primario.

¿Tengo que usar una receta como qbcore o ESX?

No. Una receta es el camino más rápido porque importa por ti el esquema SQL del framework en tu base de datos, pero la opción en blanco existe para quien trae una instalación ya hecha. Puedes subir recursos con el explorador de archivos e importar un volcado SQL después, en cualquiera de los dos casos.

Ningún recurso puede acceder a la base de datos: “mysql_connection_string structure was invalid”

La contraseña de tu base de datos contiene un carácter que debe codificarse con porcentaje en una URL, como @, % o ^, por lo que la cadena mysql:// que construye oxmysql no es un URI válido y nada se conecta. No tienes que cambiar la contraseña ni reconstruir nada: pon en su lugar la forma con punto y coma en server.cfg, porque se lee literalmente en lugar de analizarse como una URL. Usa set mysql_connection_string "server=operator;port=3307;user=root;password=YOUR_PASSWORD;database=fivem" con la contraseña de Ajustes de despliegue y reinicia. Los servidores desplegados desde aquí ahora reciben una contraseña segura en una URL, así que esto solo afecta a los más antiguos, y el panel los marca en la tarjeta del servidor con ambas soluciones: esta, y una regeneración y reconstrucción guiadas para una instalación sin datos que valga la pena conservar.

La receta no termina: “Duplicate entry ‘1’ for key ‘PRIMARY’”

La base de datos ya contiene datos de una instalación anterior, así que los datos iniciales de la receta chocan con lo que hay. “Delete Database” de txAdmin a menudo no la limpia, porque no toca el operador de sincronización. Abre el servidor en tu panel y usa el botón Reset database de la cabecera del panel: vacía la base de datos en todos tus nodos conservando los archivos de tu servidor y la configuración de txAdmin, para que puedas volver a ejecutar la receta sin problemas. Borra todos los datos de juego: normalmente se trata de una instalación que aún no ha guardado nada, pero si tienes datos, haz antes un volcado SQL (la copia de seguridad propia del operador de sincronización), porque la copia de seguridad del volumen no puede restaurar una base de datos en vivo.

He perdido la contraseña de administrador maestro de txAdmin. ¿Pueden restablecerla?

No por nuestra parte: esa cuenta vive dentro de txAdmin en tu servidor y no en nuestra facturación ni en el panel, así que no tenemos nada que restablecer. Se puede recuperar desde el propio servidor, y el panel de gestión te da la consola y el explorador de archivos que necesitas. Abre un ticket de soporte y te guiaremos, porque no es motivo para redesplegar y perder la ciudad.