Instalacja

Od pobrania do pierwszego serwera.

Wybierz system. Najpierw zainstaluj oficjalny serwer dedykowany przez Steam. Skrypty startowe znajdują się w rozpakowanym pakiecie ACEvo.

Windows Linux Docker Pierwszy serwer Po instalacji

1. Czego potrzebujesz wcześniej

Windows nadaje się do rozpoczęcia pracy na własnym komputerze. W przypadku stale działającego serwera automatyczny instalator Debiana jest najkrótszą drogą. Docker wymaga doświadczenia z kontenerami i istniejącym MariaDB.

WindowsZalecane, aby ułatwić rozpoczęcie pracy na komputerze PC lub serwerze Windows.

LinuxNadaje się do stale działającego serwera. Oficjalny serwer gry Windows wymaga Wine i Xvfb.

DockerDla użytkowników, którzy już znają Docker lub chcą powtarzalnego wdrożenia.

Wymóg	Obowiązek?	Dlaczego?
Assetto Corsa EVO Dedicated Server zamiast Steam	Tak	ACEvo zarządza oficjalnym serwerem, ale nie udostępnia jego plików.
Java 21 lub nowszy	Tak	ACEvo to aplikacja internetowa Java.
Wine + Xvfb	Tylko Linux	Aby Windows-EXE oficjalnego Dedicated Server mógł działać bez pulpitu.
MariaDB	NIE	Domyślnie używana jest wbudowana baza danych plików H2.
Docker	Tylko wariant Docker	Niewymagane w przypadku instalacji Windows lub Linux ZIP.

Zasada bezpieczeństwa: Otwórz ACEvo tylko w sieci lokalnej podczas pierwszego testu. Nie przekazuj portów do Internetu, dopóki hasło administratora, zapora sieciowa, HTTPS/Reverse Proxy i kopie zapasowe nie zostaną świadomie skonfigurowane.

2. Szybka instalacja według systemu operacyjnego

Windows korzysta z zip programu uruchamiającego. W Debianie skrypt Linux automatycznie instaluje ACEvo i oficjalny Dedicated Server.

Windows: ZIP programu uruchamiającego

W Steam otwórz Biblioteka → Narzędzia i zainstaluj Assetto Corsa EVO Dedicated Server.
Zainstaluj środowisko wykonawcze Java-21. Jest to odpowiednie dla Windows Temurin-21-JDK dla Windows x64 jako MSI. W oknie dialogowym instalacji opcja dodania Java do pliku PATH pozostaw aktywowany.
Pobierz pakiet ZIP launchera ACEvo i całkowicie rozpakuj go, na przykład, do stałego folderu C:\ACEvo.
Przed pierwszym uruchomieniem należy ustawić hasła administratora i bazy danych (rozdz Zakończ instalację Windows). Następnie zacznij od rozpakowanego folderu scripts\start-app-windows.cmd i otwarte http://localhost:8082.

Instalacja ZIP konfiguruje ACEvo. Wcześniej należy zainstalować oficjalne Dedicated Server i Java.

Linux: Instalator sieciowy Debiana

Sposób automatyczny jest przeznaczony dla Debiana. Otwórz terminal, pobierz skrypt i uruchom blok. Podczas wpisywania haseł nie pojawia się żaden znak ani gwiazdka; wpisz mimo to i naciśnij Enter. Sudo może następnie poprosić o hasło do konta 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 "Nazwa konta Steam: " STEAM_LOGIN
  read -rp "Użytkownik bazy H2: " DB_USER
  read -rsp "Hasło bazy H2: " DB_PASSWORD
  printf '\n'
  read -rsp "Hasło administratora 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
)

Wejścia: Nazwa konta Steam, użytkownik H2, niestandardowe hasło H2 i niestandardowe hasło administratora ACEvo. SteamCMD odpytuje hasło Steam i, jeśli to konieczne, samo Steam Guard. Nigdy nie wpisuj w poleceniu hasła Steam. Poświadczenia H2 nie są poświadczeniami MariaDB, a hasło H2 nie szyfruje pliku bazy danych.

Przed uruchomieniem możesz w bloku zmienić port sieciowy, folder instalacyjny, folder serwera gry, folder konfiguracyjny i użytkownika usługi. Użyj bezwzględnych ścieżek Linux bez spacji. Instalator dodaje repozytoria Debiana, instaluje Java, SteamCMD i Wine, pobiera ACEvo i serwer gry oraz konfiguruje systemd. Nie otwiera żadnych portów routera. Ani na Ubuntu, ani na innych Użyj dystrybucji. Jeśli konfiguracja lub usługa ACEvo jest obecna, skrypt zostaje przerwany.

Po pomyślnym uruchomieniu skrypt sprawdza dostęp do usługi i lokalnego Internetu. Otwarte http://localhost:8082 na serwerze lub http://SERVER-IP:8082 z sieci lokalnej. Zastępować SERVER-IP poprzez lokalny adres IP. Logując się po raz pierwszy jako administrator, posługujesz się wybranym wcześniej hasłem. Brak nazwy użytkownika administratora.

Wyświetl skrypt instalacyjny Linux

http://localhost:8082 na samym komputerze lub http://SERVER-IP:8082 otwarty w sieci lokalnej. Dalsze ustawienia są dostępne w sekcjach Windows I Linux.

3. Zakończ instalację Windows

Przygotuj Steam i Dedicated Server

Zainstaluj Steam i zaloguj się na konto, które ma dostęp do Assetto Corsa EVO. Następnie zainstaluj narzędzie Assetto Corsa EVO Dedicated Server.

Typowa ścieżka Steam to tylko przykład. Liczy się folder, w którym AssettoCorsaEVOServer.exe faktycznie kłamie.

Wyodrębnij ACEvo do stałego folderu

Przykład: C:\ACEvo. Aby zapewnić trwałe działanie, unikaj folderów pobierania lub tymczasowych.

Ustaw dostęp administratora przed pierwszym uruchomieniem

W folderze ACEvo utwórz podfolder config. Otwórz edytor, skopiuj do niego poniższą konfigurację i zastąp oba przykładowe hasła własnymi wartościami. Zapisz plik jako C:\ACEvo\config\application.properties; Wybierz „Wszystkie pliki” w oknie dialogowym zapisywania, aby Windows nie pozostało niezauważone .txt przyłączony. Plik zawiera hasła i nie można go udostępniać ani przesyłać publicznie.

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

Wartość rezerwowa jest zapisywana jako hasło administratora sieciowego po pierwszym pomyślnym logowaniu. Plik zawiera sekrety. Logowanie wymaga jedynie podania hasła, a nie nazwy użytkownika.

Pierwszy start

Kliknij dwukrotnie scripts\start-app-windows.cmd. Jeśli Windows wyświetli zapytanie zapory sieciowej, początkowo zezwalaj tylko na sieci prywatne.

Następnie otwórz go http://localhost:8082.

Które wartości musisz zmienić?

Wartość	wejście	Ogłoszenie
`server.port`	Normalnie `8082`	Zmieniaj tylko wtedy, gdy port 8082 jest już używany.
`acevo.paths.data-dir`	Folder zapisywalny, np. B. `C:/ACEvo`	Ukośniki w przód pozwalają uniknąć problemów z ucieczką.
`spring.datasource.password`	Własne hasło lokalne	Nie używaj publicznie znanego przykładowego hasła.
Dedykowana ścieżka serwera	W interfejsie ACEvo folder z `AssettoCorsaEVOServer.exe` wybierać	Nie sam EXE, ale wybierz odpowiedni folder.

4. Instalacja Linux i wstępna konfiguracja administracyjna

W Debianie instalator sieciowy jest zalecaną ścieżką instalacji. Konfiguruje ACEvo i oficjalny Dedicated Server. Plik serwera to Windows-EXE; Wine i Xvfb działają na Linux bez pulpitu.

Wymagania systemowe: Debian, dostęp do Internetu i użytkownik, który sudo może użyć. Nie uruchamiaj tego skryptu na Ubuntu ani żadnej innej dystrybucji. Wyraźnie uzupełnia źródła pakietów Debiana.

Wartości przed instalacją

Wartość	Obowiązek	Standard i cel
`STEAM_LOGIN`	Tak	Nazwa konta Steam z dostępem do oficjalnego konta Dedicated Server. Hasło Steam i Steam Guard wprowadzasz bezpośrednio do SteamCMD.
`DB_USER`	Tak	Na przykład użytkownicy lokalnej bazy danych plików H2 `acevo`. To nie jest konto MariaDB.
`DB_PASSWORD`	Tak	Własne hasło dostępu do bazy danych H2. Nie szyfruje automatycznie pliku bazy danych na dysku.
`GUI_ADMIN_PASSWORD`	Tak	Własne hasło dla pierwszego logowania administratora sieciowego ACEvo. Nazwa użytkownika administratora nie jest używana.
`ACEVO_PORT`	NIE	Port internetowy, standardowy `8082`.
`ACEVO_HOME`	NIE	Foldery aplikacji, danych i logo, standard `/opt/acevo`.
`ACE_SERVER_HOME`	NIE	Folder serwera gry, domyślny `/opt/ace-server`.
`ACEVO_CONFIG_DIR`	NIE	Chroniony folder konfiguracji, domyślnie `/etc/acevo`.
`ACEVO_SERVICE_USER`	NIE	Konto systemowe Linux, na którym działa ACEvo; standard `acevo`.
`DOWNLOAD_URL`	NIE	Pobierz adres pliku JAR ACEvo. Zachowaj oficjalną wartość domyślną.

Możesz dostosować opcjonalną ścieżkę, port i wartości użytkownika w bloku szybkiej instalacji. Używaj ścieżek bezwzględnych bez spacji. Skrypt zapisuje bazę danych i hasło administratora w /etc/acevo/install.env z ograniczonymi prawami; czyta je usługa systemd.

Co skrypt robi automatycznie

Uzupełnia źródła pakietów Debiana i instaluje Java 21, SteamCMD, Wine, Xvfb i narzędzia.
SteamCMD pobierze oficjalny Dedicated Server przy użyciu Twojego konta Steam.
Skrypt tworzy własnego użytkownika usługi Linux, foldery programu, konfiguracji, danych i logo oraz prefiks Wine.
Ładuje plik JAR ACEvo z oficjalnej strony internetowej i tworzy zewnętrzną konfigurację z portem, bazą danych H2, ścieżką serwera gry i rezerwowym administratorem.
Konfiguruje usługę systemd, umożliwia automatyczne uruchomienie i uruchamia ACEvo.
Na koniec sprawdza pliki serwera gry i lokalny port internetowy.

Nie konfiguruje MariaDB, nie otwiera żadnych portów zapory sieciowej ani routera, ani nie konfiguruje żadnej instancji serwera gier. Istniejąca konfiguracja lub usługa ACEvo spowoduje przerwanie instalacji ze względów bezpieczeństwa. Jeśli masz istniejącą instalację, najpierw wykonaj kopię zapasową /opt/acevo/data I /etc/acevo.

Sprawdź instalację i znajdź błędy

Terminal powinien zgłosić usługę jako aktywną i zwrócić odpowiedź HTTP. W dowolnym momencie możesz ponownie uruchomić te polecenia:

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

Zastępować 8082, jeśli wybrałeś inny port internetowy. Jeśli wystąpi błąd, najpierw przeczytaj komunikaty w dzienniku serwisowym. Typowe przyczyny to brak dostępu Steam, nieprawidłowa procedura Steam Guard, zajęte porty lub niewystarczająca ilość wolnej pamięci.

Dane administratora i serwera gry po uruchomieniu

Zaloguj się przy użyciu ustawionego wcześniej hasła administratora ACEvo. Jeśli to możliwe zmień to w konfiguracji ACEvo. Jeśli nie chcesz trwale akceptować zewnętrznego powrotu, usuń tę linię acevo.security.gui-admin-password-fallback z /etc/acevo/application.properties i uruchom ponownie usługę. Możesz później ustawić nazwę serwera gry, hasło administratora serwera gry, trasę i sesje wyścigów dla każdej instancji w ACEvo; instalator Linux nie akceptuje tych wartości.

Jeśli nie używasz Debiana

Nie uruchamiaj instalatora internetowego. Plik zip programu uruchamiającego zawiera program ACEvo i przykładowe konfiguracje, ale nie konfiguruje automatycznie SteamCMD, Wine, uprawnień ani usługi Systemd. W przypadku innych dystrybucji Linux administrator musi skonfigurować odpowiednie pakiety i samodzielnie uruchomić systemd.

5. Instalacja Docker

Ważny: Badany kod źródłowy ZIP nie zawiera żadnych plików Compose ani Docker. Obecna strona internetowa opisuje do tego osobny pakiet Docker. Z tej sekcji należy korzystać wyłącznie w połączeniu z opublikowaną wersją Docker, która compose.yaml, compose.local-mariadb.yaml, Dockerfile.local i zawiera przykładowe konfiguracje.

ZIP zawiera wstępnie skompilowany plik acevo-server.jar w głównym folderze. Plik Docker czeka na Ciebie pod adresem target/acevo-server-1.0.0-SNAPSHOT.jar. Skopiuj go tam przed rozpoczęciem. W PowerShellu:

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

W bashu używasz mkdir -p target I cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. Docker ZIP nie zawiera projektu Maven. Użyj na Windows scripts/docker-up.ps1 -NoBuild lub uruchom Docker Utwórz bezpośrednio docker compose up -d --build.

Rozpakuj pakiet Docker

Sprawdź, czy obecne są przynajmniej te pliki:

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

Skopiuj przykładowe pliki

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

Wszystkie wartości uwzględnione CHANGE_ME zastąpić.

Zamontuj dedykowany folder serwera

Plik compose.local-mariadb.yaml zawiera przykładową ścieżkę z instalacji deweloperskiej. Zastąp go rzeczywistym folderem hosta za pomocą AssettoCorsaEVOServer.exe. Pakiet Docker uruchamia jedynie aplikację internetową i nie konfiguruje Dedicated Server.

Uruchom kontener

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

Test: docker compose -p acevo_local ps pokazuje działające kontenery. Następnie otwórz go http://localhost:8082.

Wymagane dane wejściowe

Wartość	Oznaczający
Nazwa bazy danych MariaDB	Na przykład `acevo`; muszą być takie same w konfiguracji aplikacji i bazy danych.
Użytkownik MariaDB	Własny użytkownik, nie ślepy `root` używać.
Hasło MariaDB	Długie, unikalne hasło; identyczne w obu konfiguracjach.
Hasło administratora	Własne hasło dostępu administratora ACEvo.
Ścieżka hosta Dedicated Server	Bezwzględna ścieżka do folderu z `AssettoCorsaEVOServer.exe`.
Port internetowy	Domyślnie `8082`, chyba że zaznaczono inaczej.

6. Utwórz pierwszy serwer w ACEvo

Bezpieczny dostęp administratora

Administrator sieci używa tylko jednego hasła. Można to zmienić w konfiguracji ACEvo. Ustawiona zewnętrzna funkcja rezerwowa również pozostaje ważna: usuń ją dopiero po zapisaniu nowego hasła, a następnie uruchom ponownie ACEvo.

Natychmiast zmień istniejące hasło domyślne lub zapasowe. Nie używaj hasła z przykładowej konfiguracji.

Wybierz folder serwera dedykowanego

Wybierz folder, w którym AssettoCorsaEVOServer.exe, cars.json, events_practice.json I events_race_weekend.json położyć.

Wprowadź porty

W pierwszej kolejności w szablonie przewidziano następujące obszary:

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

Dla każdej kolejnej instancji porty serwera gry muszą być unikalne, np.: Np. 9701/9701/8092.

Port sieciowy ACEvo 8082 jest od niego oddzielony. Instalator nie otwiera zapory ogniowej ani routera. W przypadku gier publicznych zwalniaj tylko porty serwera gier pokazane w ACEvo, w tym protokół TCP lub UDP. Nie przekazuj portu internetowego bezpośrednio do Internetu; użyj HTTPS z odwrotnym proxy.

Wybierz opcję Konfiguracja

Skonfiguruj trasę, tryb, sesje, pojazdy, liczbę graczy i pogodę. Według zintegrowanej pomocy brak wyboru pojazdu oznacza: wszystkie pojazdy są dozwolone.

Uruchom i sprawdź

Uruchom instancję w ACEvo i sprawdź status oraz dziennik.

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

7. Typowe problemy

Strona nie otwiera się

Sprawdź konsolę startową pod kątem błędów i poprawności portu. Standard jest tutaj spójny 8082. Test http://localhost:8082.

Nie znaleziono „java”.

Java 21 nie jest zainstalowany lub nie znajduje się w ścieżce PATH. Po instalacji uruchom nowy terminal i sprawdź java -version.

Dedicated Server nie uruchamia się

Sprawdź folder i pliki. Pod Linux dodatkowo Wine, Xvfb, prawa oraz folder z logo ACEvo.

Port już zajęty

Albo zmienić server.port dla ACEvo lub portów instancji serwera gier, której dotyczy problem. Każda instancja wymaga unikalnych portów.

Serwer jest otwarty lokalnie, ale nie jest widoczny w grze

Jeśli TCP/UDP nasłuchuje lokalnie, przyczyna może być zewnętrzna względem ACEvo, na przykład zapora sieciowa, współdzielenie routera lub połączenie z backendem gry. Nie otwieraj portów we wszystkich obszarach, ale tylko konkretnie.

8. Po instalacji

Zatrzymaj ACEvo przed skopiowaniem bazy danych plików H2. Zabezpiecz dane i konfigurację osobno:

Windows: folder acevo.paths.data-dir I config\application.properties.
Debiana: /opt/acevo/data, /etc/acevo/application.properties i poufny plik /etc/acevo/install.env.
Docker: folder danych trwałych i rzeczywiste pliki konfiguracyjne. Nie usuwaj woluminów bazy danych.

Kopia zapasowaRegularnie zabezpiecz foldery danych, konfigurację i – dzięki MariaDB – bazę danych.

AktualizacjeUtwórz kopię zapasową przed aktualizacjami, przeczytaj uwagi do wydania i przejrzyj zmiany w konfiguracji.

Operacja publicznaHTTPS, skonfiguruj odwrotne proxy, zaporę sieciową, silne hasła i odpowiednią politykę prywatności.

Pobierz ACEvo Do strony docelowej

Gdy coś nie startuje

Sprawdź Javę, log startowy, ścieżkę serwera i port. Jeśli port jest zajęty, zmień server.port i użyj tego samego portu w przeglądarce. Wbudowana baza H2 wystarcza na początek.

Pobierz bezpłatnie ?Napisz e-mail