Instalación

De la descarga al primer servidor.

Elige tu sistema. Instala primero el servidor dedicado oficial mediante Steam. Los scripts de inicio están en el paquete ACEvo extraído.

Windows Linux Docker Primer servidor Después de la instalación

1. Qué necesitas de antemano

Windows es adecuado para comenzar en su propia PC. Para un servidor en funcionamiento permanente, el instalador automático de Debian es el camino más corto. Docker requiere experiencia con contenedores y un MariaDB existente.

WindowsRecomendado para comenzar de forma más sencilla en una PC o en un servidor Windows.

LinuxAdecuado para un servidor en funcionamiento permanente. El servidor de juegos oficial Windows requiere Wine y Xvfb.

DockerPara usuarios que ya conocen Docker o desean una implementación reproducible.

Requisito	¿Deber?	¿Por qué?
Assetto Corsa EVO Dedicated Server sobre Steam	Sí	ACEvo administra el servidor oficial, pero no proporciona sus archivos.
Java 21 o más reciente	Sí	ACEvo es una aplicación web Java.
Wine + Xvfb	Sólo Linux	Para que el Windows-EXE del Dedicated Server oficial pueda ejecutarse sin un escritorio.
MariaDB	No	De forma predeterminada, se utiliza una base de datos de archivos H2 incorporada.
Docker	Solo variante Docker	No es necesario para la instalación ZIP Windows o Linux.

Regla de seguridad: Abra ACEvo solo en la red local durante la primera prueba. No reenvíe puertos a Internet hasta que la contraseña de administrador, el firewall, HTTPS/Proxy inverso y las copias de seguridad estén configurados conscientemente.

2. Instalación rápida por sistema operativo

Windows utiliza el zip del iniciador. En Debian, el script Linux instala automáticamente ACEvo y el Dedicated Server oficial.

Windows: Lanzador ZIP

En Steam, abre Biblioteca → Herramientas e instala Assetto Corsa EVO Dedicated Server.
Instale un tiempo de ejecución Java-21. Esto es adecuado para Windows Temurin-21-JDK para Windows x64 como MSI. En el cuadro de diálogo de instalación, la opción para agregar Java al PATH dejar activado.
Descarga el ZIP del lanzador ACEvo y descomprimirlo completamente en una carpeta fija, por ejemplo C:\ACEvo.
Antes de comenzar por primera vez, configure las contraseñas de administrador y de base de datos (sección Instalación completa de Windows). Luego comience en la carpeta descomprimida. scripts\start-app-windows.cmd y abierto http://localhost:8082.

La instalación ZIP configura ACEvo. Los Dedicated Server y Java oficiales deben instalarse previamente.

Linux: Instalador web de Debian

La forma automática está destinada a Debian. Abra una terminal, descargue el script y ejecute el bloque. No aparece ningún carácter ni asterisco al escribir contraseñas; escriba de todos modos y presione enter. Luego, Sudo puede solicitar la contraseña de su cuenta Linux.

sudo apt update
sudo apt install -y curl
curl -fsSL https://acevo-server.com/linux/install.sh -o /tmp/acevo-install.sh
(
  set -e
  read -rp "Nombre de cuenta de Steam: " STEAM_LOGIN
  read -rp "Usuario de H2: " DB_USER
  read -rsp "Contraseña de la base de datos H2: " DB_PASSWORD
  printf '\n'
  read -rsp "Contraseña de administrador de ACEvo: " GUI_ADMIN_PASSWORD
  printf '\n'
  export STEAM_LOGIN DB_USER DB_PASSWORD GUI_ADMIN_PASSWORD
  export ACEVO_PORT=8082 ACEVO_HOME=/opt/acevo ACE_SERVER_HOME=/opt/ace-server
  export ACEVO_CONFIG_DIR=/etc/acevo ACEVO_SERVICE_USER=acevo
  sudo --preserve-env=STEAM_LOGIN,DB_USER,DB_PASSWORD,GUI_ADMIN_PASSWORD,ACEVO_PORT,ACEVO_HOME,ACE_SERVER_HOME,ACEVO_CONFIG_DIR,ACEVO_SERVICE_USER bash /tmp/acevo-install.sh
)

Entradas: Nombre de cuenta Steam, usuario H2, contraseña personalizada H2 y contraseña de administrador personalizada ACEvo. SteamCMD consulta la contraseña Steam y, si es necesario, la propia Steam Guard. Nunca ingrese su contraseña Steam en el comando. Las credenciales H2 no son credenciales MariaDB y la contraseña H2 no cifra el archivo de base de datos.

Antes de ejecutar, puede cambiar el puerto web, la carpeta de instalación, la carpeta del servidor de juegos, la carpeta de configuración y el usuario del servicio en el bloque. Utilice rutas absolutas Linux sin espacios. El instalador agrega repositorios de Debian, instala Java, SteamCMD y Wine, descarga ACEvo y el servidor de juegos, y configura systemd. No abre ningún puerto del enrutador. No en Ubuntu u otros Utilice distribuciones. Si la configuración o el servicio ACEvo está presente, el script se cancela.

Después de una ejecución exitosa, el script verifica el servicio y el acceso web local. Abierto http://localhost:8082 en el servidor o http://SERVER-IP:8082 desde la red local. Reemplazar SERVER-IP por la dirección IP local. Cuando inicia sesión como administrador por primera vez, utiliza la contraseña que eligió anteriormente. No hay ningún nombre de usuario de administrador.

Ver el script de instalación Linux

http://localhost:8082 en el propio ordenador o http://SERVER-IP:8082 abierto en la red local. Más configuraciones están disponibles en las secciones Windows y Linux.

3. Complete la instalación de Windows

Prepare Steam y Dedicated Server

Instale Steam e inicie sesión con una cuenta que tenga acceso a Assetto Corsa EVO. Luego instale la herramienta Assetto Corsa EVO Dedicated Server.

La ruta típica Steam es sólo un ejemplo. Lo que importa es la carpeta en la que AssettoCorsaEVOServer.exe en realidad miente.

Extraiga ACEvo en una carpeta fija

Ejemplo: C:\ACEvo. Para un funcionamiento permanente, evite la descarga o las carpetas temporales.

Establecer acceso de administrador antes del primer inicio

En la carpeta ACEvo, cree la subcarpeta config. Abra el editor, copie la siguiente configuración y reemplace ambas contraseñas de ejemplo con sus propios valores. Guarde el archivo como C:\ACEvo\config\application.properties; Seleccione “Todos los archivos” en el cuadro de diálogo de guardar para que Windows no pase desapercibido .txt adjunto. El archivo contiene contraseñas y no puede compartirse ni cargarse públicamente.

server.port=8082
acevo.paths.data-dir=C:/ACEvo
spring.datasource.url=jdbc:h2:file:C:/ACEvo/data/acevo-db;MODE=MariaDB;DATABASE_TO_LOWER=TRUE;CASE_INSENSITIVE_IDENTIFIERS=TRUE
spring.datasource.username=acevo
spring.datasource.password=EIN_EIGENES_DB_KENNWORT
spring.datasource.driver-class-name=org.h2.Driver
logging.file.name=C:/ACEvo/logs/acevo-application.log
acevo.security.gui-admin-password-fallback=EIN_EIGENES_ADMIN_KENNWORT

La reserva se guarda como contraseña de administrador web en el primer inicio de sesión exitoso. El archivo contiene secretos. El inicio de sesión sólo solicita una contraseña, no un nombre de usuario.

primer comienzo

Doble clic scripts\start-app-windows.cmd. Si Windows muestra una consulta de firewall, inicialmente solo permita redes privadas.

Entonces ábrelo http://localhost:8082.

¿Qué valores necesitas cambiar?

Valor	aporte	Aviso
`server.port`	Normalmente `8082`	Cambie únicamente si el puerto 8082 ya está en uso.
`acevo.paths.data-dir`	Carpeta grabable, p. b. `C:/ACEvo`	Las barras diagonales evitan problemas de escape.
`spring.datasource.password`	Propia contraseña local	No utilice una contraseña de ejemplo conocida públicamente.
Ruta del servidor dedicado	En la interfaz ACEvo, la carpeta con `AssettoCorsaEVOServer.exe` elegir	No el EXE en sí, sino seleccione la carpeta adecuada.

4. Instalación Linux y preconfiguración de administrador

En Debian, el instalador web es la ruta de instalación recomendada. Configura ACEvo y el Dedicated Server oficial. El archivo del servidor es Windows-EXE; Wine y Xvfb se ejecutan en Linux sin un escritorio.

Requisitos del sistema: Debian, acceso a Internet y un usuario que sudo puede utilizar. No ejecute este script en Ubuntu ni en ninguna otra distribución. Complementa explícitamente las fuentes de los paquetes Debian.

Valores antes de la instalación

Valor	Deber	Estándar y propósito
`STEAM_LOGIN`	Sí	Nombre de cuenta Steam con acceso al Dedicated Server oficial. Ingresa la contraseña Steam y Steam Guard directamente en SteamCMD.
`DB_USER`	Sí	Usuarios de la base de datos de archivos local H2, por ejemplo `acevo`. Esta no es una cuenta MariaDB.
`DB_PASSWORD`	Sí	Contraseña propia para acceso a la base de datos H2. No cifra automáticamente el archivo de base de datos en el disco.
`GUI_ADMIN_PASSWORD`	Sí	Contraseña propia para el primer inicio de sesión de administrador web ACEvo. No se utiliza un nombre de usuario de administrador.
`ACEVO_PORT`	No	Puerto web, estándar `8082`.
`ACEVO_HOME`	No	Carpetas de aplicaciones, datos y logotipos, estándar `/opt/acevo`.
`ACE_SERVER_HOME`	No	Carpeta del servidor de juegos, predeterminada `/opt/ace-server`.
`ACEVO_CONFIG_DIR`	No	Carpeta de configuración protegida, predeterminada `/etc/acevo`.
`ACEVO_SERVICE_USER`	No	Cuenta del sistema Linux bajo la cual se ejecuta ACEvo; estándar `acevo`.
`DOWNLOAD_URL`	No	Dirección de descarga del archivo JAR ACEvo. Mantenga el valor predeterminado oficial.

Puede personalizar la ruta, el puerto y los valores de usuario opcionales en el bloque de instalación rápida. Utilice rutas absolutas sin espacios. El script guarda la base de datos y la contraseña de administrador en /etc/acevo/install.env con derechos limitados; el servicio systemd los lee.

Lo que el script hace automáticamente

Complementa las fuentes de paquetes de Debian e instala Java 21, SteamCMD, Wine, Xvfb y utilidades.
SteamCMD descargará el Dedicated Server oficial usando su cuenta Steam.
El script crea su propio usuario de servicio Linux, las carpetas de programa, configuración, datos y logotipo, y el prefijo Wine.
Carga el archivo JAR ACEvo desde el sitio web oficial y crea una configuración externa con el puerto, la base de datos H2, la ruta del servidor de juegos y el respaldo de administrador.
Configura el servicio systemd, habilita el inicio automático e inicia ACEvo.
Finalmente, verifica los archivos del servidor del juego y el puerto web local.

No configura MariaDB, no abre ningún firewall o puerto de enrutador, ni configura ninguna instancia de servidor de juegos. Una configuración o servicio ACEvo existente hará que el instalador se cancele por razones de seguridad. Si tiene una instalación existente, haga una copia de seguridad primero /opt/acevo/data y /etc/acevo.

Verifique la instalación y encuentre errores

El terminal debe informar que el servicio está activo y devolver una respuesta HTTP. Puede ejecutar estos comandos nuevamente en cualquier momento:

sudo systemctl status acevo --no-pager
sudo journalctl -u acevo -n 100 --no-pager
curl -I http://127.0.0.1:8082/

Reemplazar 8082, si ha elegido un puerto web diferente. Si se produce un error, primero lea los mensajes en el registro de servicio. Las causas comunes incluyen falta de acceso a Steam, procedimiento Steam Guard incorrecto, puertos ocupados o memoria libre insuficiente.

Datos del administrador y del servidor de juegos después del lanzamiento

Inicie sesión con la contraseña de administrador ACEvo que configuró anteriormente. Si es posible, cámbielo en la configuración ACEvo. Si no desea aceptar permanentemente el respaldo externo, elimine la línea acevo.security.gui-admin-password-fallback fuera de /etc/acevo/application.properties y reinicie el servicio. Más adelante podrás configurar el nombre del servidor del juego, la contraseña del administrador del servidor del juego, la ruta y las sesiones de carrera por instancia en ACEvo; el instalador Linux no acepta estos valores.

Si no usas Debian

No inicie el instalador web. El archivo zip del iniciador contiene el programa ACEvo y configuraciones de muestra, pero no configura automáticamente SteamCMD, Wine, permisos ni un servicio Systemd. Para otras distribuciones Linux, un administrador debe configurar los paquetes apropiados y systemd iniciarse.

5. Instalación Docker

Importante: El código fuente ZIP examinado no contiene ningún archivo Compose o Docker. El sitio web actual describe un paquete Docker separado para esto. Utilice esta sección sólo junto con la versión publicada Docker, que compose.yaml, compose.local-mariadb.yaml, Dockerfile.local y contiene configuraciones de ejemplo.

El ZIP contiene el archivo prediseñado. acevo-server.jar en la carpeta principal. El archivo Docker le espera en target/acevo-server-1.0.0-SNAPSHOT.jar. Cópialo allí antes de comenzar. En PowerShell:

New-Item -ItemType Directory -Force target
Copy-Item acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar

En bash usas mkdir -p target y cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. El ZIP Docker no contiene un proyecto Maven. Usar en Windows scripts/docker-up.ps1 -NoBuild o inicie Docker Redactar directamente docker compose up -d --build.

Descomprima el paquete Docker

Compruebe si al menos estos archivos están presentes:

compose.yaml
compose.local-mariadb.yaml
Dockerfile.local
config/application-docker.properties.sample
config/acevo-docker.env.sample
config/acevo-local-mariadb.env.sample

Copiar archivos de muestra

cp config/application-docker.properties.sample config/application-docker.properties
cp config/acevo-docker.env.sample config/acevo-docker.env
cp config/acevo-local-mariadb.env.sample config/acevo-local-mariadb.env

Todos los valores incluidos CHANGE_ME sustituto.

Montar la carpeta del servidor dedicado

el archivo compose.local-mariadb.yaml contiene una ruta de ejemplo de una instalación de desarrollador. Reemplácelo con la carpeta host real con AssettoCorsaEVOServer.exe. El paquete Docker solo inicia la aplicación web y no configura Dedicated Server.

Contenedor de inicio

docker compose -f compose.yaml -f compose.local-mariadb.yaml -p acevo_local up -d --build

Prueba: docker compose -p acevo_local ps muestra contenedores en ejecución. Entonces ábrelo http://localhost:8082.

Entradas requeridas

Valor	Significado
MariaDB nombre de la base de datos	Por ejemplo `acevo`; debe ser el mismo en la configuración de la aplicación y la base de datos.
Usuario MariaDB	Usuario propio, no ciego `root` usar.
MariaDB contraseña	Contraseña larga y única; idéntico en ambas configuraciones.
Contraseña de administrador	Contraseña propia para el acceso de administrador ACEvo.
Ruta del host Dedicated Server	Ruta absoluta a la carpeta con `AssettoCorsaEVOServer.exe`.
Puerto web	Por defecto `8082`, a menos que se mapee lo contrario.

6. Cree el primer servidor en ACEvo.

Acceso de administrador seguro

El administrador web sólo utiliza una contraseña. Puede cambiarlo en la configuración ACEvo. Un respaldo externo que se ha configurado también sigue siendo válido: solo elimínelo después de guardar una nueva contraseña y luego reinicie ACEvo.

Cambie inmediatamente una contraseña predeterminada o alternativa existente. No utilice una contraseña de una configuración de ejemplo.

Seleccione la carpeta del servidor dedicado

Seleccione la carpeta en la que AssettoCorsaEVOServer.exe, cars.json, events_practice.json y events_race_weekend.json poner.

Introducir puertos

En primer lugar, en la plantilla se proporcionan las siguientes áreas:

ACE TCP: 9700
ACE UDP: 9700
ACE HTTP: 8091
ACEvo Web UI: 8082

Para cada instancia posterior, los puertos del servidor de juegos deben ser únicos, p. P.ej. 9701/9701/8092.

El puerto web ACEvo 8082 está separado de él. El instalador no abre el firewall ni el enrutador. Para juegos públicos, libere únicamente los puertos del servidor de juegos que se muestran en ACEvo, incluido el protocolo TCP o UDP. No reenvíe el puerto web directamente a Internet; utilice HTTPS con proxy inverso.

Seleccione Configuración

Configura ruta, modo, sesiones, vehículos, número de jugadores y clima. Según la ayuda integrada, ninguna selección de vehículo significa: todos los vehículos están permitidos.

Iniciar y comprobar

Inicie la instancia en ACEvo y verifique el estado y el registro.

Examen Linux: ss -tulpn | grep -E "9700|8091"

7. Problemas comunes

El sitio web no abre

Verifique la consola de inicio en busca de errores y si el puerto es correcto. El estándar aquí es consistente 8082. Prueba http://localhost:8082.

No se encontró “java”

Java 21 no está instalado o no está en la RUTA. Después de la instalación, inicie una nueva terminal y verifique java -version.

El Dedicated Server no arranca

Verifique la carpeta y los archivos. En Linux, además, Wine, Xvfb, derechos y la carpeta del logotipo ACEvo.

Puerto ya ocupado

Cualquier cambio server.port para ACEvo o los puertos de la instancia del servidor de juegos afectada. Cada instancia requiere puertos únicos.

El servidor está abierto localmente pero no es visible en el juego.

Si TCP/UDP están escuchando localmente, la causa puede ser externa a ACEvo, como un firewall, un enrutador compartido o una conexión al backend del juego. No abra puertos en todos los ámbitos, sino solo específicamente.

8. Después de la instalación

Detenga ACEvo antes de copiar la base de datos del archivo H2. Datos seguros y configuración por separado:

Windows: la carpeta acevo.paths.data-dir y config\application.properties.
Debian: /opt/acevo/data, /etc/acevo/application.properties y el expediente confidencial /etc/acevo/install.env.
Docker: la carpeta de datos persistentes y los archivos de configuración reales. No elimine los volúmenes de la base de datos.

RespaldoProteja las carpetas de datos, la configuración y, con MariaDB, la base de datos con regularidad.

ActualizacionesHaga una copia de seguridad antes de las actualizaciones, lea las notas de la versión y revise los cambios de configuración.

Operación públicaHTTPS, configure un proxy inverso, un firewall, contraseñas seguras y una política de privacidad adecuada.

Descargar ACEvo A la página de destino

Si algo no arranca

Comprueba Java, el registro de inicio, la ruta del servidor y el puerto. Si está ocupado, cambia server.port y usa el mismo puerto en el navegador. La base H2 integrada basta para empezar.

Descargar gratis ?Enviar un correo