Installazione

Dal download al primo server.

Scegli il tuo sistema. Installa prima il server dedicato ufficiale tramite Steam. Gli script di avvio sono nel pacchetto ACEvo estratto.

Windows Linux Docker Primo server Dopo l’installazione

1. Cosa ti serve in anticipo

Windows è adatto per iniziare sul tuo PC. Per un server in esecuzione permanente, il programma di installazione Debian automatico è la via più breve. Docker richiede esperienza con i contenitori e un MariaDB esistente.

WindowsConsigliato per iniziare nel modo più semplice su un PC o un server Windows.

LinuxAdatto per un server in esecuzione permanente. Il server di gioco ufficiale Windows richiede Wine e Xvfb.

DockerPer gli utenti che già conoscono Docker o desiderano una distribuzione riproducibile.

Requisito	Dovere?	Perché?
Assetto Corsa EVO Dedicated Server su Steam	SÌ	ACEvo gestisce il server ufficiale, ma non fornisce i suoi file.
Java 21 o successivo	SÌ	ACEvo è un'applicazione web Java.
Wine+Xvfb	Solo Linux	In modo che il Windows-EXE del Dedicated Server ufficiale possa funzionare senza desktop.
MariaDB	NO	Per impostazione predefinita, viene utilizzato un database di file H2 incorporato.
Docker	Solo variante Docker	Non richiesto per l'installazione ZIP Windows o Linux.

Regola di sicurezza: Apri ACEvo solo nella rete locale durante il primo test. Non inoltrare porte a Internet finché la password dell'amministratore, il firewall, HTTPS/Reverse Proxy e i backup non sono stati configurati consapevolmente.

2. Installazione rapida per sistema operativo

Windows utilizza lo zip di avvio. Su Debian, lo script Linux installa automaticamente ACEvo e Dedicated Server ufficiale.

Windows: ZIP di avvio

In Steam, apri Libreria → Strumenti e installa Assetto Corsa EVO Dedicated Server.
Installare un runtime Java-21. Questo è adatto per Windows Temurin-21-JDK per Windows x64 come MSI. Nella finestra di dialogo di installazione, l'opzione per aggiungere Java al file PATH lasciare attivato.
Scarica il pacchetto ZIP del launcher ACEvo e decomprimerlo completamente, ad esempio, in una cartella fissa C:\ACEvo.
Prima di iniziare per la prima volta, impostare le password dell'amministratore e del database (sezione Completa l'installazione di Windows). Quindi iniziare dalla cartella decompressa scripts\start-app-windows.cmd e aperto http://localhost:8082.

L'installazione ZIP configura ACEvo. È necessario installare preventivamente i moduli Dedicated Server e Java ufficiali.

Linux: programma di installazione web Debian

Il modo automatico è destinato a Debian. Apri un terminale, scarica lo script ed esegui il blocco. Nessun carattere o asterisco viene visualizzato durante la digitazione delle password; digita comunque e premi invio. Sudo può quindi richiedere la password del tuo account 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 "Nome utente Steam: " STEAM_LOGIN
  read -rp "Utente H2: " DB_USER
  read -rsp "Password del database H2: " DB_PASSWORD
  printf '\n'
  read -rsp "Password amministratore 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
)

Ingressi: Nome account Steam, utente H2, password personalizzata H2 e password amministratore personalizzata ACEvo. SteamCMD interroga la password Steam e, se necessario, Steam Guard stesso. Non inserire mai la password Steam nel comando. Le credenziali H2 non sono credenziali MariaDB e la password H2 non crittografa il file del database.

Prima dell'esecuzione, puoi modificare la porta web, la cartella di installazione, la cartella del server di gioco, la cartella di configurazione e l'utente del servizio nel blocco. Utilizza percorsi Linux assoluti senza spazi. Il programma di installazione aggiunge i repository Debian, installa Java, SteamCMD e Wine, scarica ACEvo e il server di gioco e configura systemd. Non apre nessuna porta del router. Non su Ubuntu o altri Usa le distribuzioni. Se è presente la configurazione o il servizio ACEvo, lo script si interrompe.

Dopo un'esecuzione riuscita, lo script controlla il servizio e l'accesso al Web locale. Aprire http://localhost:8082 sul server o http://SERVER-IP:8082 dalla rete locale. Sostituire SERVER-IP dall'indirizzo IP locale. Quando accedi per la prima volta come amministratore, utilizzi la password che hai scelto in precedenza. Non esiste un nome utente amministratore.

Visualizza lo script di installazione Linux

http://localhost:8082 sul computer stesso o http://SERVER-IP:8082 aperto nella rete locale. Ulteriori impostazioni sono disponibili nelle sezioni Windows E Linux.

3. Completare l'installazione di Windows

Preparare Steam e Dedicated Server

Installa Steam e accedi con un account che ha accesso a Assetto Corsa EVO. Quindi installare lo strumento Assetto Corsa EVO Dedicated Server.

Il percorso tipico Steam è solo un esempio. Ciò che conta è la cartella in cui AssettoCorsaEVOServer.exe in realtà bugie.

Estrai ACEvo in una cartella fissa

Esempio: C:\ACEvo. Per il funzionamento permanente, evitare download o cartelle temporanee.

Imposta l'accesso amministratore prima del primo avvio

Nella cartella ACEvo creare la sottocartella config. Apri l'editor, copia la seguente configurazione e sostituisci entrambe le password di esempio con i tuoi valori. Salva il file con nome C:\ACEvo\config\application.properties; Seleziona "Tutti i file" nella finestra di dialogo di salvataggio in modo che Windows non passi inosservato .txt allegato. Il file contiene password e non può essere condiviso o caricato pubblicamente.

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

Il fallback viene salvato come password dell'amministratore web al primo accesso riuscito. Il file contiene segreti. Il login richiede solo una password, non un nome utente.

Primo avvio

Fare doppio clic scripts\start-app-windows.cmd. Se Windows mostra una query del firewall, inizialmente consenti solo le reti private.

Quindi aprilo http://localhost:8082.

Quali valori devi modificare?

Valore	ingresso	Avviso
`server.port`	Normalmente `8082`	Cambiare solo se la porta 8082 è già in uso.
`acevo.paths.data-dir`	Cartella scrivibile, ad es. B. `C:/ACEvo`	Le barre in avanti evitano problemi di fuga.
`spring.datasource.password`	Propria password locale	Non utilizzare una password di esempio pubblicamente nota.
Percorso del server dedicato	Nell'interfaccia ACEvo, la cartella con `AssettoCorsaEVOServer.exe` scegliere	Non il EXE stesso, ma seleziona la cartella appropriata.

4. Installazione di Linux e preconfigurazione dell'amministratore

Su Debian, il programma di installazione web è il percorso di installazione consigliato. Imposta ACEvo e Dedicated Server ufficiale. Il file del server è un Windows-EXE; Wine e Xvfb vengono eseguiti su Linux senza desktop.

Requisiti di sistema: Debian, accesso a Internet e un utente che sudo può utilizzare. Non eseguire questo script su Ubuntu o qualsiasi altra distribuzione. Integra esplicitamente i sorgenti dei pacchetti Debian.

Valori prima dell'installazione

Valore	Dovere	Norma e scopo
`STEAM_LOGIN`	SÌ	Nome dell'account Steam con accesso al Dedicated Server ufficiale. Immettere la password Steam e Steam Guard direttamente in SteamCMD.
`DB_USER`	SÌ	Ad esempio, gli utenti del database di file locale H2 `acevo`. Questo non è un account MariaDB.
`DB_PASSWORD`	SÌ	Propria password per l'accesso al database H2. Non crittografa automaticamente il file di database su disco.
`GUI_ADMIN_PASSWORD`	SÌ	Propria password per il primo accesso all'amministratore web ACEvo. Non viene utilizzato un nome utente amministratore.
`ACEVO_PORT`	NO	Porta Web, standard `8082`.
`ACEVO_HOME`	NO	App, cartelle dati e logo, standard `/opt/acevo`.
`ACE_SERVER_HOME`	NO	Cartella del server di gioco, predefinita `/opt/ace-server`.
`ACEVO_CONFIG_DIR`	NO	Cartella di configurazione protetta, predefinita `/etc/acevo`.
`ACEVO_SERVICE_USER`	NO	Account di sistema Linux sotto il quale viene eseguito ACEvo; standard `acevo`.
`DOWNLOAD_URL`	NO	Indirizzo di download del file JAR ACEvo. Mantieni il valore predefinito ufficiale.

È possibile personalizzare il percorso, la porta e i valori utente facoltativi nel blocco di installazione rapida. Utilizza percorsi assoluti senza spazi. Lo script salva il database e la password dell'amministratore in /etc/acevo/install.env con diritti limitati; il servizio systemd li legge.

Cosa che lo script fa automaticamente

Completa i sorgenti dei pacchetti Debian e installa Java 21, SteamCMD, Wine, Xvfb e utilità.
SteamCMD scaricherà il Dedicated Server ufficiale utilizzando il tuo account Steam.
Lo script crea il proprio utente del servizio Linux, le cartelle del programma, della configurazione, dei dati e del logo e il prefisso Wine.
Carica il file JAR ACEvo dal sito Web ufficiale e crea una configurazione esterna con porta, database H2, percorso del server di gioco e fallback dell'amministratore.
Configura il servizio systemd, abilita l'avvio automatico e avvia ACEvo.
Infine, controlla i file del server di gioco e la porta web locale.

Non configura MariaDB, non apre porte firewall o router né configura alcuna istanza del server di gioco. Una configurazione o un servizio ACEvo esistente causerà l'interruzione del programma di installazione per motivi di sicurezza. Se disponi di un'installazione esistente, esegui prima il backup /opt/acevo/data E /etc/acevo.

Controlla l'installazione e trova gli errori

Il terminale dovrebbe segnalare il servizio come attivo e restituire una risposta HTTP. Puoi eseguire nuovamente questi comandi in qualsiasi momento:

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

Sostituire 8082, se hai scelto una porta web diversa. Se si verifica un errore, leggere prima i messaggi nel registro del servizio. Le cause comuni includono la mancanza di accesso Steam, procedura Steam Guard errata, porte occupate o memoria libera insufficiente.

Dati dell'amministratore e del server di gioco dopo il lancio

Accedi con la password amministratore ACEvo impostata in precedenza. Se possibile, modificarlo nella configurazione ACEvo. Se non vuoi accettare permanentemente il fallback esterno, rimuovi la linea acevo.security.gui-admin-password-fallback fuori /etc/acevo/application.properties e riavviare il servizio. Successivamente potrai impostare il nome del server di gioco, la password dell'amministratore del server di gioco, il percorso e le sessioni di corsa per istanza in ACEvo; il programma di installazione Linux non accetta questi valori.

Se non usi Debian

Non avviare il programma di installazione web. Il file zip di avvio contiene il programma ACEvo e configurazioni di esempio, ma non configura automaticamente SteamCMD, Wine, le autorizzazioni e un servizio Systemd. Per le altre distribuzioni Linux, un amministratore deve impostare i pacchetti appropriati e systemd avviarsi autonomamente.

5. Installazione Docker

Importante: Lo ZIP del codice sorgente esaminato non contiene alcun file Compose o Docker. L'attuale sito Web descrive un pacchetto Docker separato per questo. Utilizzare questa sezione solo insieme alla versione pubblicata Docker, che compose.yaml, compose.local-mariadb.yaml, Dockerfile.local e contiene configurazioni di esempio.

Lo ZIP contiene il file precostruito acevo-server.jar nella cartella principale. Il file Docker ti aspetta su target/acevo-server-1.0.0-SNAPSHOT.jar. Copialo lì prima di iniziare. In PowerShell:

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

In bash usi mkdir -p target E cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. Lo ZIP Docker non contiene un progetto Maven. Utilizzare su Windows scripts/docker-up.ps1 -NoBuild oppure avviare direttamente Docker Componi docker compose up -d --build.

Decomprimere il pacchetto Docker

Controlla se sono presenti almeno questi file:

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

Copiare file di esempio

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

Tutti i valori inclusi CHANGE_ME sostituire.

Montare la cartella del server dedicato

Il dossier compose.local-mariadb.yaml contiene un percorso di esempio da un'installazione per sviluppatori. Sostituiscilo con la cartella host effettiva con AssettoCorsaEVOServer.exe. Il pacchetto Docker avvia solo l'app Web e non configura Dedicated Server.

Avvia contenitore

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

Test: docker compose -p acevo_local ps mostra i contenitori in esecuzione. Quindi aprilo http://localhost:8082.

Ingressi richiesti

Valore	Senso
MariaDB nome del database	Per esempio `acevo`; deve essere lo stesso nella configurazione dell'app e del DB.
Utente MariaDB	Proprio utente, non cieco `root` utilizzo.
Parola d'ordine MariaDB	Password lunga e univoca; identico in entrambe le configurazioni.
Password amministratore	Propria password per l'accesso amministratore ACEvo.
Percorso host Dedicated Server	Percorso assoluto alla cartella con `AssettoCorsaEVOServer.exe`.
Porta web	Per impostazione predefinita `8082`, a meno che non venga mappato diversamente.

6. Creare il primo server in ACEvo

Accesso amministratore sicuro

L'amministratore web utilizza solo una password. È possibile modificarlo nella configurazione ACEvo. Rimane valido anche un fallback esterno impostato: rimuoverlo solo dopo aver salvato una nuova password e quindi riavviare ACEvo.

Modificare immediatamente una password predefinita o di fallback esistente. Non utilizzare una password da una configurazione di esempio.

Seleziona la cartella del server dedicato

Seleziona la cartella in cui AssettoCorsaEVOServer.exe, cars.json, events_practice.json E events_race_weekend.json posizione.

Inserisci i porti

In prima istanza, nel modello sono previste le seguenti aree:

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

Per ogni istanza successiva, le porte del server di gioco devono essere uniche, ad es. Per esempio. 9701/9701/8092.

La porta web ACEvo 8082 è separato da esso. Il programma di installazione non apre il firewall o il router. Per i giochi pubblici, rilasciare solo le porte del server di gioco mostrate in ACEvo incluso il protocollo TCP o UDP. Non inoltrare la porta Web direttamente a Internet; utilizzare HTTPS con proxy inverso.

Seleziona Configurazione

Configura percorso, modalità, sessioni, veicoli, numero di giocatori e meteo. Secondo l'aiuto integrato, nessuna selezione del veicolo significa: sono ammessi tutti i veicoli.

Avvia e controlla

Avvia l'istanza in ACEvo e controlla lo stato e il registro.

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

7. Problemi comuni

Il sito web non si apre

Controllare la console di avvio per eventuali errori e se la porta è corretta. Lo standard qui è coerente 8082. Test http://localhost:8082.

"java" non è stato trovato

Java 21 non è installato o non è nel PERCORSO. Dopo l'installazione, avvia un nuovo terminale e controlla java -version.

Il Dedicated Server non si avvia

Controlla la cartella e i file. Sotto Linux sono inoltre presenti Wine, Xvfb, i diritti e la cartella del logo ACEvo.

Porto già occupato

O cambiare server.port per ACEvo o le porte dell'istanza del server di gioco interessata. Ogni istanza richiede porte univoche.

Il server è aperto localmente ma non visibile nel gioco

Se TCP/UDP sono in ascolto localmente, la causa potrebbe essere esterna a ACEvo, come firewall, condivisione del router o connessione al backend del gioco. Non aprire le porte in modo generalizzato, ma solo in modo specifico.

8. Dopo l'installazione

Arrestare ACEvo prima di copiare il database dei file H2. Proteggi dati e configurazione separatamente:

Windows: la cartella acevo.paths.data-dir E config\application.properties.
Debian: /opt/acevo/data, /etc/acevo/application.properties e il fascicolo riservato /etc/acevo/install.env.
Docker: la cartella dei dati persistenti e i file di configurazione reali. Non rimuovere i volumi del database.

BackupProteggi le cartelle dei dati, la configurazione e – con MariaDB – il database regolarmente.

AggiornamentiEsegui il backup prima degli aggiornamenti, leggi le note di rilascio e rivedi le modifiche alla configurazione.

Operazione pubblicaHTTPS, imposta un proxy inverso, un firewall, password complesse e un'adeguata politica sulla privacy.

Scarica ACEvo Alla pagina di destinazione

Se qualcosa non si avvia

Controlla Java, log di avvio, percorso del server e porta configurata. Se la porta è occupata, modifica server.port e usa la stessa porta nel browser. Il database H2 integrato basta per iniziare.

Scarica gratis ?Scrivi un'e-mail