Instalação

Do download ao primeiro servidor.

Escolhe o teu sistema. Instala primeiro o servidor dedicado oficial através do Steam. Os scripts de arranque estão no pacote ACEvo extraído.

Windows Linux Docker Primeiro servidor Após a instalação

1. O que você precisa de antemão

Windows é adequado para começar em seu próprio PC. Para um servidor em execução permanente, o instalador automático do Debian é o caminho mais curto. Docker requer experiência com contêineres e um MariaDB existente.

WindowsRecomendado para a maneira mais fácil de começar em um PC ou servidor Windows.

LinuxAdequado para um servidor em execução permanente. O servidor de jogo oficial Windows requer Wine e Xvfb.

DockerPara usuários que já conhecem Docker ou desejam uma implantação reproduzível.

Exigência	Obrigação?	Por que?
Assetto Corsa EVO Dedicated Server sobre Steam	Sim	ACEvo gerencia o servidor oficial, mas não fornece seus arquivos.
Java 21 ou mais recente	Sim	ACEvo é um aplicativo da web Java.
Wine + Xvfb	Somente Linux	Para que o Windows-EXE do Dedicated Server oficial possa funcionar sem desktop.
MariaDB	Não	Por padrão, um banco de dados de arquivo H2 integrado é usado.
Docker	Somente variante Docker	Não é necessário para instalação ZIP Windows ou Linux.

Regra de segurança: Abra ACEvo apenas na rede local durante o primeiro teste. Não encaminhe portas para a Internet até que a senha do administrador, o firewall, o HTTPS/Proxy reverso e os backups sejam configurados conscientemente.

2. Instalação rápida por sistema operacional

Windows usa o zip do iniciador. No Debian, o script Linux instala automaticamente ACEvo e o Dedicated Server oficial.

Windows: ZIP do iniciador

No Steam, abra Biblioteca → Ferramentas e instale o Assetto Corsa EVO Dedicated Server.
Instale um tempo de execução Java-21. Isso é adequado para Windows Temurin-21-JDK para Windows x64 como MSI. Na caixa de diálogo de instalação, a opção de adicionar Java ao PATH deixe ativado.
Transfira o ZIP do launcher ACEvo e descompacte-o completamente em uma pasta fixa, por exemplo C:\ACEvo.
Antes de começar pela primeira vez, defina as senhas de administrador e do banco de dados (seção Instalação completa do Windows). Então comece na pasta descompactada scripts\start-app-windows.cmd e aberto http://localhost:8082.

A instalação ZIP configura ACEvo. O Dedicated Server e Java oficiais devem ser instalados previamente.

Linux: Instalador web Debian

A forma automática é destinada ao Debian. Abra um terminal, baixe o script e execute o bloco. Nenhum caractere ou asterisco aparece ao digitar senhas; digite mesmo assim e pressione enter. Sudo pode então solicitar a senha da sua conta 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 da conta Steam: " STEAM_LOGIN
  read -rp "Utilizador H2: " DB_USER
  read -rsp "Palavra-passe da base de dados H2: " DB_PASSWORD
  printf '\n'
  read -rsp "Palavra-passe de administrador 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: Nome da conta Steam, usuário H2, senha personalizada H2 e senha de administrador personalizada ACEvo. SteamCMD consulta a senha de Steam e, se necessário, o próprio Steam Guard. Nunca insira sua senha Steam no comando. As credenciais H2 não são credenciais MariaDB e a senha H2 não criptografa o arquivo de banco de dados.

Antes de iniciar, você pode alterar a porta web, a pasta de instalação, a pasta do servidor do jogo, a pasta de configuração e o usuário do serviço no bloco. Use caminhos Linux absolutos sem espaços. O instalador adiciona repositórios Debian, instala Java, SteamCMD e Wine, baixa ACEvo e o servidor de jogo e configura systemd. Não abre nenhuma porta do roteador. Não no Ubuntu ou outros Use distribuições. Se a configuração ou serviço ACEvo estiver presente, o script será interrompido.

Após uma execução bem-sucedida, o script verifica o serviço e o acesso à Web local. Abrir http://localhost:8082 no servidor ou http://SERVER-IP:8082 da rede local. Substituir SERVER-IP pelo endereço IP local. Ao fazer login como administrador pela primeira vez, você usa a senha escolhida anteriormente. Não há nome de usuário de administrador.

Ver script de instalação Linux

http://localhost:8082 no próprio computador ou http://SERVER-IP:8082 aberto na rede local. Outras configurações estão disponíveis nas seções Windows e Linux.

3. Conclua a instalação do Windows

Prepare Steam e Dedicated Server

Instale Steam e faça login com uma conta que tenha acesso a Assetto Corsa EVO. Em seguida, instale a ferramenta Assetto Corsa EVO Dedicated Server.

O caminho Steam típico é apenas um exemplo. O que importa é a pasta em que AssettoCorsaEVOServer.exe na verdade mente.

Extraia ACEvo para uma pasta fixa

Exemplo: C:\ACEvo. Para operação permanente, evite downloads ou pastas temporárias.

Defina o acesso de administrador antes da primeira inicialização

Na pasta ACEvo, crie a subpasta config. Abra o editor, copie a seguinte configuração nele e substitua as duas senhas de exemplo pelos seus próprios valores. Salve o arquivo como C:\ACEvo\config\application.properties; Selecione “Todos os arquivos” na caixa de diálogo salvar para que Windows não passe despercebido .txt apegado. O arquivo contém senhas e não pode ser compartilhado ou carregado publicamente.

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

O substituto é salvo como a senha do administrador da web no primeiro login bem-sucedido. O arquivo contém segredos. O login pede apenas uma senha, não um nome de usuário.

Primeiro começo

Clique duas vezes scripts\start-app-windows.cmd. Se Windows mostrar uma consulta de firewall, inicialmente permita apenas redes privadas.

Então abra-o http://localhost:8082.

Quais valores você precisa alterar?

Valor	entrada	Perceber
`server.port`	Normalmente `8082`	Altere apenas se a porta 8082 já estiver em uso.
`acevo.paths.data-dir`	Pasta gravável, por ex. b. `C:/ACEvo`	Barras evitam problemas de escape.
`spring.datasource.password`	Própria senha local	Não use um exemplo de senha publicamente conhecido.
Caminho do servidor dedicado	Na interface ACEvo, a pasta com `AssettoCorsaEVOServer.exe` escolher	Não o próprio EXE, mas selecione a pasta apropriada.

4. Instalação Linux e pré-configuração administrativa

No Debian, o instalador web é o caminho de instalação recomendado. Ele configura ACEvo e o Dedicated Server oficial. O arquivo do servidor é Windows-EXE; Wine e Xvfb são executados em Linux sem desktop.

Requisitos do sistema: Debian, acesso à Internet e um usuário que sudo pode usar. Não execute este script no Ubuntu ou em qualquer outra distribuição. Ele complementa explicitamente as fontes de pacotes Debian.

Valores antes da instalação

Valor	Obrigação	Padrão e propósito
`STEAM_LOGIN`	Sim	Nome da conta Steam com acesso ao Dedicated Server oficial. Você insere a senha Steam e Steam Guard diretamente em SteamCMD.
`DB_USER`	Sim	Usuários do banco de dados de arquivos H2 local, por exemplo `acevo`. Esta não é uma conta MariaDB.
`DB_PASSWORD`	Sim	Senha própria para acesso ao banco de dados H2. Ele não criptografa automaticamente o arquivo do banco de dados no disco.
`GUI_ADMIN_PASSWORD`	Sim	Senha própria para o primeiro login de administrador da web ACEvo. Um nome de usuário de administrador não é usado.
`ACEVO_PORT`	Não	Porta web, padrão `8082`.
`ACEVO_HOME`	Não	Pastas de aplicativos, dados e logotipo, padrão `/opt/acevo`.
`ACE_SERVER_HOME`	Não	Pasta do servidor do jogo, padrão `/opt/ace-server`.
`ACEVO_CONFIG_DIR`	Não	Pasta de configuração protegida, padrão `/etc/acevo`.
`ACEVO_SERVICE_USER`	Não	Conta do sistema Linux sob a qual ACEvo é executado; padrão `acevo`.
`DOWNLOAD_URL`	Não	Endereço de download do arquivo JAR ACEvo. Mantenha o valor padrão oficial.

Você pode personalizar o caminho opcional, a porta e os valores do usuário no bloco de instalação rápida. Use caminhos absolutos sem espaços. O script salva o banco de dados e a senha do administrador em /etc/acevo/install.env com direitos limitados; o serviço systemd os lê.

O que o script faz automaticamente

Ele complementa as fontes de pacotes Debian e instala Java 21, SteamCMD, Wine, Xvfb e utilitários.
SteamCMD fará o download do Dedicated Server oficial usando sua conta Steam.
O script cria seu próprio usuário de serviço Linux, as pastas de programa, configuração, dados e logotipo e o prefixo Wine.
Ele carrega o arquivo JAR ACEvo do site oficial e cria uma configuração externa com porta, banco de dados H2, caminho do servidor de jogo e substituto de administrador.
Ele configura o serviço systemd, permite a inicialização automática e inicia ACEvo.
Finalmente, ele verifica os arquivos do servidor do jogo e a porta web local.

Ele não configura MariaDB, não abre nenhum firewall ou porta de roteador, nem configura nenhuma instância de servidor de jogo. Uma configuração ou serviço ACEvo existente fará com que o instalador seja abortado por motivos de segurança. Se você tiver uma instalação existente, faça backup primeiro /opt/acevo/data e /etc/acevo.

Verifique a instalação e encontre erros

O terminal deve reportar o serviço como ativo e retornar uma resposta HTTP. Você pode executar estes comandos novamente a qualquer momento:

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

Substituir 8082, se você escolheu uma porta da web diferente. Se ocorrer um erro, primeiro leia as mensagens no log de serviço. As causas comuns incluem falta de acesso Steam, procedimento Steam Guard incorreto, portas ocupadas ou memória livre insuficiente.

Dados do administrador e do servidor de jogo após o lançamento

Faça login com a senha de administrador ACEvo que você definiu anteriormente. Se possível, altere-o na configuração ACEvo. Se você não quiser aceitar permanentemente o substituto externo, remova a linha acevo.security.gui-admin-password-fallback fora de /etc/acevo/application.properties e reinicie o serviço. Posteriormente, você pode definir o nome do servidor de jogo, a senha de administrador do servidor de jogo, a rota e as sessões de corrida por instância em ACEvo; o instalador Linux não aceita esses valores.

Se você não usa Debian

Não inicie o instalador da web. O zip do inicializador contém o programa ACEvo e configurações de amostra, mas não configura automaticamente SteamCMD, Wine, permissões e um serviço Systemd. Para outras distribuições Linux, um administrador deve configurar os pacotes apropriados e systemd iniciar-se.

5. Instalação Docker

Importante: O ZIP do código-fonte examinado não contém nenhum arquivo Compose ou Docker. O site atual descreve um pacote Docker separado para isso. Use esta seção somente em conjunto com a versão Docker publicada, que compose.yaml, compose.local-mariadb.yaml, Dockerfile.local e contém exemplos de configurações.

O ZIP contém o arquivo pré-construído acevo-server.jar na pasta principal. O arquivo Docker espera por você em target/acevo-server-1.0.0-SNAPSHOT.jar. Copie-o lá antes de começar. No PowerShell:

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

No bash você usa mkdir -p target e cp acevo-server.jar target/acevo-server-1.0.0-SNAPSHOT.jar. O ZIP Docker não contém um projeto Maven. Usar em Windows scripts/docker-up.ps1 -NoBuild ou inicie Docker Compose diretamente docker compose up -d --build.

Descompacte o pacote Docker

Verifique se pelo menos estes arquivos estão 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

Copie arquivos de amostra

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 os valores incluídos CHANGE_ME substituir.

Montar pasta de servidor dedicado

O arquivo compose.local-mariadb.yaml contém um exemplo de caminho de uma instalação de desenvolvedor. Substitua-o pela pasta host real com AssettoCorsaEVOServer.exe. O pacote Docker inicia apenas o aplicativo da web e não configura Dedicated Server.

Iniciar contêiner

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

Teste: docker compose -p acevo_local ps mostra contêineres em execução. Então abra-o http://localhost:8082.

Entradas necessárias

Valor	Significado
Nome do banco de dados MariaDB	Por exemplo `acevo`; deve ser o mesmo na configuração do aplicativo e do banco de dados.
Usuário MariaDB	Próprio usuário, não cego `root` usar.
Senha MariaDB	Senha longa e exclusiva; idêntico em ambas as configurações.
Senha de administrador	Senha própria para acesso de administrador ACEvo.
Caminho do host Dedicated Server	Caminho absoluto para a pasta com `AssettoCorsaEVOServer.exe`.
Porta web	Por padrão `8082`, a menos que mapeado de outra forma.

6. Crie o primeiro servidor em ACEvo

Acesso de administrador seguro

O administrador da web usa apenas uma senha. Você pode alterá-lo na configuração ACEvo. Um fallback externo configurado também permanece válido: remova-o somente após salvar uma nova senha e reinicie ACEvo.

Altere imediatamente uma senha padrão ou alternativa existente. Não use uma senha de uma configuração de exemplo.

Selecione a pasta do servidor dedicado

Selecione a pasta na qual AssettoCorsaEVOServer.exe, cars.json, events_practice.json e events_race_weekend.json deitar.

Insira as portas

Para a primeira instância, as seguintes áreas são fornecidas no modelo:

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

Para cada instância subsequente, as portas do servidor de jogo devem ser exclusivas, por exemplo. Por exemplo 9701/9701/8092.

A porta da web ACEvo 8082 está separado dele. O instalador não abre o firewall ou roteador. Para jogos públicos, libere apenas as portas do servidor de jogos mostradas em ACEvo, incluindo o protocolo TCP ou UDP. Não encaminhe a porta web diretamente para a Internet; use HTTPS com proxy reverso.

Selecione Configuração

Configure rota, modo, sessões, veículos, número de jogadores e clima. De acordo com a ajuda integrada, nenhuma seleção de veículo significa: todos os veículos são permitidos.

Comece e verifique

Inicie a instância em ACEvo e verifique o status e o log.

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

7. Problemas comuns

O site não abre

Verifique se há erros no console de inicialização e se a porta está correta. O padrão aqui é consistente 8082. Teste http://localhost:8082.

“java” não foi encontrado

Java 21 não está instalado ou não está no PATH. Após a instalação, inicie um novo terminal e verifique java -version.

O Dedicated Server não inicia

Verifique a pasta e os arquivos. Sob Linux, adicionalmente Wine, Xvfb, direitos e a pasta do logotipo ACEvo.

Porto já ocupado

Qualquer mudança server.port para ACEvo ou as portas da instância do servidor de jogo afetada. Cada instância requer portas exclusivas.

O servidor está aberto localmente, mas não é visível no jogo

Se TCP/UDP estiverem escutando localmente, a causa pode ser externa a ACEvo, como firewall, compartilhamento de roteador ou conexão com o back-end do jogo. Não abra portas de maneira geral, mas apenas especificamente.

8. Após a instalação

Pare ACEvo antes de copiar o banco de dados do arquivo H2. Proteja os dados e a configuração separadamente:

Windows: a pasta acevo.paths.data-dir e config\application.properties.
Debian: /opt/acevo/data, /etc/acevo/application.properties e o arquivo confidencial /etc/acevo/install.env.
Docker: a pasta de dados persistentes e os arquivos de configuração reais. Não remova volumes de banco de dados.

BackupProteja pastas de dados, configuração e – com MariaDB – o banco de dados regularmente.

AtualizaçõesFaça backup antes das atualizações, leia as notas de versão e revise as alterações de configuração.

Operação públicaHTTPS, configure um proxy reverso, firewall, senhas fortes e uma política de privacidade apropriada.

Baixar ACEvo Para a página de destino

Se algo não arrancar

Verifica o Java, o registo de arranque, o caminho do servidor e a porta. Se estiver ocupada, altera server.port e usa a mesma porta no navegador. A base H2 integrada é suficiente para começar.

Descarregar gratuitamente ?Enviar e-mail