Instalar o agente

Requisitos

• Uma VPS ou máquina dedicada que você controla.
• Windows: Windows Server 2019 ou mais recente, ou Windows 10/11, com acesso de administrador.
• Linux: Debian 11+, Ubuntu 20.04+ ou RHEL/Fedora com apt ou dnf, com acesso root ou sudo.
• Acesso de saída à internet: o agente se comunica com o Servitium via HTTPS. Você não precisa abrir nenhuma porta de entrada para o painel.
• O e-mail e a senha da sua conta Servitium.

Instalar no Windows

1. Clique com o botão direito no menu Iniciar e escolha Windows PowerShell (Admin) ou Terminal (Admin).
2. Cole o comando abaixo. A página de instalação do Center o exibe já com o seu e-mail preenchido. Substitua o endereço de exemplo se copiar daqui.
3. O PowerShell pede a senha da sua conta Servitium. Digite-a e pressione Enter.

iwr -useb https://api.servitium.org/downloads/client/v1/setup.ps1 -OutFile $env:TEMP\setup.ps1; & $env:TEMP\setup.ps1 -Email your-email@example.com

O instalador baixa o agente (cerca de 76 MB) e leva de 3 a 5 minutos em uma máquina nova.

Instalar no Linux

1. Conecte-se à máquina via SSH e verifique se você pode usar sudo (ou entre como root).
2. Execute o comando abaixo.
3. O instalador pede seu e-mail e sua senha Servitium de forma interativa. É a mesma conta do Center.

curl -fsSL https://api.servitium.org/downloads/client/v1/setup.sh | sudo -E bash

Em uma máquina nova, isso leva de 2 a 4 minutos.

O que o instalador faz

No Windows, o instalador:

• Baixa o agente para uma pasta própria.
• Instala o runtime do Visual C++ e os componentes do runtime DirectX de que o Conan Exiles precisa, caso estejam faltando.
• Adiciona uma exclusão do Windows Defender para a pasta do agente.
• Registra a máquina na sua conta.
• Instala o serviço Windows Servitium Monitor. Ele inicia com o Windows e reinicia sozinho se parar.

No Linux, o instalador:

• Instala os pacotes de sistema de que o agente e o SteamCMD precisam (apt ou dnf).
• Baixa o agente e registra a máquina na sua conta.
• Se o firewall ufw estiver instalado, permite que o agente abra as portas do jogo automaticamente.
• Cria o serviço systemd servitium-monitor, ativado na inicialização.

O instalador pode ser executado novamente sem risco: ele atualiza o agente no lugar e mantém a identidade do seu host.

Verifique se o host aparece

No Center, abra Admin, Hosts. Sua máquina deve aparecer em cerca de 30 segundos. Na página de instalação, Procurar o meu host fica aguardando por cerca de dois minutos e confirma quando ela estiver conectada.

Se ela não aparecer, verifique o serviço na máquina:

Get-Service ServitiumMonitor

Get-Content C:\Servitium\logs\service-*.log -Tail 50

sudo systemctl status servitium-monitor

sudo journalctl -u servitium-monitor -f

Quando o host estiver online, escolha Adicionar servidor de jogo na página Hosts para vincular seu servidor. Mais soluções em FAQ e solução de problemas.

Atualizar o agente

Para atualizar o agente, execute o mesmo comando de instalação novamente. Ele substitui o programa, mantém suas configurações e a identidade do host e reinicia o serviço. Seus servidores de jogo e os arquivos deles não são alterados.

Desinstalar

No Windows, execute o desinstalador em um PowerShell de administrador. Ele remove o serviço, para os servidores de jogo que estava executando, apaga as pastas do agente e remove as regras de firewall que criou. Os arquivos do seu servidor de jogo são mantidos, a menos que você adicione -WipeServers (e -WipeSteam para remover também o SteamCMD).

iwr -useb https://api.servitium.org/downloads/client/v1/uninstall.ps1 -OutFile $env:TEMP\uninstall.ps1; & $env:TEMP\uninstall.ps1

No Linux, pare e remova o serviço e o programa do agente:

sudo systemctl disable --now servitium-monitor
sudo rm /etc/systemd/system/servitium-monitor.service /opt/servitium/servitium-monitor
sudo rm -f /etc/sudoers.d/servitium-monitor
sudo systemctl daemon-reload

Por fim, no Center, abra o host em Admin, Hosts e use Eliminar este host. Os servidores atribuídos a ele ficam sem atribuição, mas não são excluídos. Se o agente ainda estiver rodando em algum lugar, ele se registra de novo na próxima conexão.