Instalacao Linux

Instalação no Linux (Ubuntu ou Debian)

A instalação tem duas partes. Na primeira, você prepara a máquina pelo terminal, com poucos comandos. Na segunda, um assistente no navegador faz o trabalho pesado (baixa o Valheim, monta o site, cria o painel) enquanto você acompanha.

1. Prepare a máquina

Você vai precisar de uma máquina Ubuntu ou Debian x86-64, de preferência nova, com systemd, sudo, acesso à internet e espaço para o jogo, os mundos, os mods e os backups. Antes de tudo, confira se ela atende:

uname -m
. /etc/os-release && echo "$PRETTY_NAME"
df -h /

O uname -m precisa responder x86_64. O instalador também pede Python 3.10 ou mais novo. Se a sua VM só tem a conta root, rode os comandos como root e tire o sudo.

Agora instale os pacotes de sistema que a instalação usa:

sudo apt update
sudo apt install -y git ca-certificates curl tar unzip libc6-i386 lib32gcc-s1 \
  libatomic1 libpulse0 libpulse-dev nginx python3 python3-venv python3-pip rsync
python3 --version

Vai querer HTTPS automático? Instale também sudo apt install -y certbot python3-certbot-nginx.

O assistente instalaria esses pacotes sozinho, então repetir não faz mal. A vantagem de fazer antes é simples: se o APT der erro, você resolve agora, sem ter preenchido formulário nenhum. As bibliotecas libatomic1, libpulse-dev e libpulse0 são as que o guia oficial do Valheim pede no Linux.

O resto vem pelo assistente: SteamCMD, o servidor de Valheim, o BepInEx (se você quiser mods) e os arquivos do modpack. O painel roda num ambiente Python próprio, montado a partir de deploy/requirements-panel.txt. Você não precisa instalar Steam, Node.js, Docker nem pacotes Python globais.

Rede

A máquina precisa de DNS, HTTPS de saída, dos repositórios do APT e dos downloads da Steam. O link temporário do assistente passa pela Cloudflare, então a saída para ela também precisa estar liberada. Nenhuma porta de entrada é aberta para a instalação.

• Site público: aponte um domínio para o IP da máquina e libere TCP 80 e 443. O HTTPS automático só consegue emitir o certificado com DNS público e a porta 80 acessível.
• Jogo: escolha uma porta UDP (a padrão é 2456). Com o backend Steam, libere essa porta e a seguinte no firewall e no roteador. O guia oficial explica a rede e o crossplay em detalhe.

2. Baixe o repositório

git clone https://github.com/brkihel/Heimdall-Nexus.git
cd Heimdall-Nexus
./deploy/install.sh --check

O --check é um ensaio: confere o sistema, a arquitetura e se já existe uma instalação ou um serviço que entraria em conflito, sem mudar nada na máquina. Ele não testa a rede nem instala coisa alguma.

Pode clonar na sua pasta pessoal sem medo. Durante a instalação, o assistente copia o código que os serviços usam para /opt/heimdall-nexus, e a conta do serviço nunca precisa entrar na sua pasta. Só não coloque senhas, mundos, saves ou configurações locais no Git.

3. Abra o assistente

sudo ./deploy/install.sh

O terminal vai mostrar como abrir o assistente no navegador. Há três jeitos, e o certo depende de onde está a sua máquina:

• Link HTTPS temporário (o padrão). O instalador cria um link pela Cloudflare Quick Tunnel e só o mostra quando já confirmou que ele abre. Se o link cair, ele cria outro e mostra o novo. O assistente continua escutando apenas em 127.0.0.1:8765, então nada fica exposto.
• Link direto (--direct). Bom para uma máquina numa rede de confiança, como uma VM na sua casa. O assistente escuta no IP da máquina e mostra http://IP:8765/claim?token=…. Como é HTTP sem criptografia, evite em redes públicas. Se o firewall bloquear, libere a porta TCP 8765.
• Túnel SSH (--local-only). Nada de serviço externo nem porta aberta: você mesmo cria o túnel.

sudo ./deploy/install.sh --direct       # VM na sua rede
sudo ./deploy/install.sh --local-only   # e depois, no seu computador:
ssh -L 8765:127.0.0.1:8765 usuario@seu-servidor

Todo link leva um token que só vale uma vez, então não o compartilhe. Abra o link completo, com o token, no navegador do seu computador, e deixe o terminal e o navegador abertos até o fim.

4. Preencha as cinco telas

1. Site. O domínio ou IP do site e o endereço que os jogadores usam para entrar no servidor. Só ligue o HTTPS se tiver um domínio com DNS público, e informe o e-mail que vai no certificado.
2. Servidor. Nome, mundo, porta UDP, senha do jogo (opcional), se aparece na lista pública e se aceita crossplay. Em Modificadores de mundo você escolhe combate, morte, recursos, invasões e portais, ou mantém o padrão do jogo. Tudo isso pode ser mudado depois em Jarl → Server Config.
3. Recursos. Marque o BepInEx se o servidor vai ter mods; deixe desmarcado para jogar vanilla. O modpack do Hexium preenche a lista de mods do site. Há uma opção separada para também instalar o modpack no servidor: ela baixa as dependências nas versões fixadas e pula os pacotes marcados como só de cliente. Aqui você também escolhe quais dados ao vivo o site vai mostrar.
4. Administrador. Você escolhe dois nomes diferentes: a conta Linux que roda o painel (padrão heimdall) e o login que você usa no navegador (padrão jarl). Depois define a senha do painel, que é guardada só como hash. O jogo roda numa terceira conta, valheim, separada das outras.
5. Revisão. Decide se o Valheim liga no fim da instalação e a cada boot da máquina. Vem desmarcado, para você ligar quando estiver pronto.

A tela de progresso mostra cada etapa: pacotes do sistema, SteamCMD, o Valheim (App 896660), o BepInEx, o site e o painel, e o HTTPS. Se alguma falhar, corrija a causa e clique para tentar de novo no mesmo assistente. Não precisa recomeçar.

5. Comece a usar

No fim, o assistente mostra os links do site e do painel. Entre no painel e abra Aparência → Layout Editor para trocar os textos e o layout do site. Se você deixou o jogo desligado, ligue pelo Console quando quiser.

A extensão Sagas (mapa, histórias, Armaria) é opcional e fica fora da instalação básica. Se quiser, siga o guia das Sagas.

Onde cada coisa fica:

Pasta	O que tem
/opt/heimdall-nexus	O código que os serviços usam.
/srv/valheim/current	O jogo instalado.
/srv/valheim/saves	Os mundos. Nunca apague ao atualizar o jogo.
/var/lib/heimdall-nexus/site	As páginas editáveis do site.
/etc/heimdall-nexus/heimdall.env	Os dados da máquina (site, painel, coletores).
/etc/heimdall-panel/config.json	A conta do painel.

Problemas comuns

• O assistente não abre. Veja se o instalador ainda está rodando. Quando o link da Cloudflare falha, ele tenta de novo e mostra outro. Numa VM da sua rede, rode de novo com --direct; se nada der certo, use --local-only com túnel SSH.
• Aparece a página padrão do Nginx, ou /jarl/entrar dá 404. Provavelmente o Nginx ainda está com a configuração de antes da instalação. Rode sudo nginx -t && sudo systemctl reload nginx e confira o painel com sudo systemctl status heimdall-panel --no-pager. As instalações atuais já recarregam o Nginx e testam as duas rotas antes de dizer que deu certo.
• /jarl/entrar dá 502 e o log do painel mostra status=200/CHDIR. Isso acontece em instalações antigas, que deixavam o código numa pasta pessoal que o serviço não conseguia abrir. As atuais usam /opt/heimdall-nexus e não têm esse problema. Para consertar uma antiga sem reinstalar, entre na pasta do repositório e rode sudo apt install -y acl, sudo setfacl -m u:painel:--x "$HOME" "$PWD" "$PWD/servicos" e sudo systemctl restart heimdall-panel. Isso só deixa o serviço atravessar essas pastas, sem conseguir listar o que tem nelas.
• O HTTPS falhou. Confirme o DNS e a porta TCP 80, corrija e tente de novo no mesmo assistente.
• O servidor não aparece no jogo. Confira as portas UDP e se o jogo foi ligado. Os logs estão em sudo journalctl -u heimdall-valheim -n 100.
• O servidor continua vanilla. Marque o BepInEx e a instalação do modpack no servidor. O progresso lista os pacotes de cliente que foram pulados; veja se algum mod precisa de configuração.
• Já existe um serviço de jogo. O assistente não substitui um serviço que ele não criou. Use uma máquina nova ou migre o antigo à mão antes.

Os testes automáticos conferem a lógica sem ligar um jogo de verdade, então ainda não substituem uma instalação completa numa máquina nova.