VpnHood!

Instale o VpnHood! SERVER com Docker

Execute o servidor como contêiner em qualquer máquina Linux com Docker. Um único comando o instala, como servidor gerenciado ou independente, e o contêiner mantém o servidor em execução e atualizado.

Antes de começar

  • Uma máquina Linux com endereço IP público (x64 ou arm64). A imagem suporta ambas as arquiteturas. Requisitos do sistema lista os sistemas em que o servidor funciona.
  • Acesso root.
  • Docker com o plugin compose. O instalador pode configurá-lo automaticamente no Ubuntu, Debian e distribuições derivadas.
  • Porta TCP 443 liberada, tanto no firewall da máquina quanto no do provedor de hospedagem. O contêiner usa a rede do host diretamente, ouvindo nessa porta.

Instalar um servidor independente

Execute este comando. Ele perguntará se deseja instalar o Docker, baixará o arquivo compose e iniciará o contêiner do servidor.

sudo bash -c 'u=https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer.docker.sh; bash <(wget -qO- $u 2>/dev/null || curl -fsSL $u)'

Para instalar via script sem perguntas de confirmação, consulte Opções do instalador.

O servidor armazena configurações, chaves e logs em /opt/VpnHoodServer/storage no host, preservando todos os dados mesmo ao recriar o contêiner.

Criar uma chave de acesso

Execute este comando na máquina. A chave é gerada dentro do contêiner do servidor, usando diretamente as configurações dele.

sudo docker exec VpnHoodServer /app/vhsupervisor gen

Por exemplo, uma chave para um celular

sudo docker exec VpnHoodServer /app/vhsupervisor gen -name Phone -maxClient 1

A saída e as opções são as mesmas de um servidor independente instalado sem Docker: copie a linha abaixo de --- AccessKey --- e consulte Crie sua primeira chave de acesso para ver as opções que limitam uma chave.

Conectar

Instale o VpnHood! CLIENT em cada dispositivo, adicione a chave e conecte-se.

Iniciar, parar e verificar o servidor

O contêiner se chama VpnHoodServer. O Docker o reinicia se a máquina reiniciar, e o servidor é reiniciado automaticamente dentro dele em caso de falha.

sudo docker logs VpnHoodServer
sudo docker stop VpnHoodServer
sudo docker start VpnHoodServer

O mesmo registro de log é gravado em /opt/VpnHoodServer/storage/logs/server.log no host.

Alterar as configurações

O servidor lê as configurações de /opt/VpnHoodServer/storage/appsettings.json. Edite o arquivo e reinicie o contêiner com sudo docker restart VpnHoodServer.

Se não for possível editar o arquivo, insira todo o conteúdo de appsettings.json na variável de ambiente VH_APPSETTINGS. O servidor a usará no lugar do arquivo.

Defina os endereços IP do seu servidor e Use um nome de domínio e um certificado confiável para conferir as configurações mais comuns.

Atualizações

O servidor se atualiza sozinho dentro do contêiner. Ele verifica se há novas versões ao iniciar e a cada 12 horas, reiniciando já na versão mais recente.

Para fixar uma versão específica, defina VH_AUTO_UPDATE=0 no ambiente do contêiner.

Ocasionalmente, uma versão exige uma imagem mais nova. Nesses casos, o servidor mantém a versão atual e o log exibe Pull the latest image!. Execute o comando de instalação novamente: ele baixa a imagem mais recente e recria o contêiner, preservando todas as configurações e chaves.

Se você instalou usando uma versão anterior do script, execute o comando de instalação novamente. Ele atualizará o servidor para a nova imagem e removerá o contêiner antigo VpnHoodUpdater.

Desinstalar

Para remover o servidor, exclua seu contêiner e sua imagem. As configurações, chaves de acesso e certificados permanecem salvos em /opt/VpnHoodServer/storage para uma futura reinstalação.

sudo docker rm -f VpnHoodServer && sudo docker rmi vpnhood/vpnhoodserver

Excluir também configurações e chaves: os dispositivos que usam essas chaves não poderão mais se conectar, mesmo após uma nova instalação

sudo rm -rf /opt/VpnHoodServer

Criar o contêiner manualmente

Se você prefere gerenciar contêineres manualmente, este é o contêiner criado pelo instalador. Execute-o na rede do host, assim como faz o instalador.

sudo docker run -d --name VpnHoodServer --network host --restart always --stop-timeout 30 -v /opt/VpnHoodServer/storage:/app/storage vpnhood/vpnhoodserver

Para atualizar para uma imagem mais recente, baixe vpnhood/vpnhoodserver e recrie o contêiner.

Próximas etapas