Od stažení k prvnímu serveru.

1. Co potřebujete předem

Windows je vhodný pro začátek na vašem vlastním počítači. Pro trvale běžící server je automatický instalační program Debianu nejkratší cestou. Docker vyžaduje zkušenosti s kontejnery a existující MariaDB.

2. Rychlá instalace podle operačního systému

Windows používá spouštěcí zip. V Debianu skript Linux automaticky nainstaluje ACEvo a oficiální Dedicated Server.

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 "Název účtu Steam: " STEAM_LOGIN
  read -rp "Uživatel databáze H2: " DB_USER
  read -rsp "Heslo databáze H2: " DB_PASSWORD
  printf '\n'
  read -rsp "Heslo správce 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
)

3. Dokončete instalaci Windows

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

Které hodnoty potřebujete změnit?

4. Instalace a předkonfigurace správce Linux

V Debianu je doporučenou instalační cestou webový instalační program. Nastaví ACEvo a oficiální Dedicated Server. Soubor serveru je Windows-EXE; Wine a Xvfb běží na Linux bez pracovní plochy.

Hodnoty před instalací

Volitelnou cestu, port a uživatelské hodnoty můžete upravit v bloku rychlé instalace. Použijte absolutní cesty bez mezer. Skript uloží databázi a heslo správce /etc/acevo/install.env s omezenými právy; služba systemd je přečte.

Což skript dělá automaticky

1. Doplňuje zdroje balíčků Debian a instaluje Java 21, SteamCMD, Wine, Xvfb a nástroje.
2. SteamCMD stáhne oficiální Dedicated Server pomocí vašeho účtu Steam.
3. Skript vytvoří vlastního uživatele služby Linux, složky programu, konfigurace, dat a loga a předponu Wine.
4. Načte soubor ACEvo JAR z oficiálních stránek a vytvoří externí konfiguraci s portem, databází H2, cestou k hernímu serveru a záložním adminem.
5. Nastaví službu systemd, umožní automatické spouštění a spustí ACEvo.
6. Nakonec zkontroluje soubory herního serveru a místní webový port.

Nenastavuje MariaDB, neotevírá žádné porty brány firewall nebo směrovače ani nekonfiguruje žádnou instanci herního serveru. Stávající konfigurace nebo služba ACEvo způsobí z bezpečnostních důvodů přerušení instalačního programu. Pokud máte existující instalaci, nejprve zálohujte /opt/acevo/data a /etc/acevo.

Zkontrolujte instalaci a najděte chyby

Terminál by měl ohlásit službu jako aktivní a vrátit odpověď HTTP. Tyto příkazy můžete kdykoli znovu spustit:

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

Nahradit 8082, pokud jste zvolili jiný webový port. Pokud dojde k chybě, přečtěte si nejprve zprávy v protokolu služby. Mezi běžné příčiny patří chybějící přístup Steam, nesprávný postup Steam Guard, obsazené porty nebo nedostatek volné paměti.

Data administrátora a herního serveru po spuštění

Přihlaste se pomocí hesla správce ACEvo, které jste nastavili dříve. Pokud je to možné, změňte jej v konfiguraci ACEvo. Pokud nechcete trvale přijmout externí záložní řešení, odstraňte řádek acevo.security.gui-admin-password-fallback z /etc/acevo/application.properties a restartujte službu. Později můžete nastavit název herního serveru, heslo správce herního serveru, trasu a závodní relace pro každou instanci v ACEvo; instalační program Linux tyto hodnoty nepřijímá.

Pokud nepoužíváte Debian

Nespouštějte webový instalátor. Spouštěcí zip obsahuje program ACEvo a ukázkové konfigurace, ale nenastavuje automaticky SteamCMD, Wine, oprávnění a službu Systemd. Pro ostatní distribuce Linux musí správce nastavit příslušné balíčky a systemd spustit sami.

5. Instalace Docker

ZIP obsahuje předpřipravený soubor acevo-server.jar v hlavní složce. Soubor Docker na vás čeká na target/acevo-server-1.0.0-SNAPSHOT.jar. Před spuštěním to tam zkopírujte. V PowerShellu:

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

V bash, který používáte mkdir -p target a cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. Docker ZIP neobsahuje projekt Maven. Použijte na Windows scripts/docker-up.ps1 -NoBuild nebo spusťte přímo Docker Compose docker compose up -d --build.

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

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

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

Požadované vstupy

6. Vytvořte první server v ACEvo

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

7. Běžné problémy

8. Po instalaci

Před kopírováním databáze souborů H2 zastavte ACEvo. Zabezpečte data a konfiguraci samostatně:

• Windows: složka acevo.paths.data-dir a config\application.properties.
• Debian: /opt/acevo/data, /etc/acevo/application.properties a důvěrný soubor /etc/acevo/install.env.
• Docker: složka trvalých dat a skutečné konfigurační soubory. Neodstraňujte svazky databáze.