MiVPN MiVPN.
Voltar às transferências

MiVPN Server para Linux sem ecrã

Ubuntu Server, Debian, Raspberry Pi e Orange Pi · amd64, arm64 e armhf · v3.1.3-10

Transforma um computador que fica ligado em casa —um VPS, um Ubuntu Server, um Raspberry Pi ou um Orange Pi— no teu servidor VPN. Não precisa de ecrã: instala-se e gere-se a partir do terminal, também por SSH, com o comando mivpn.

Antes de começar

SistemaUbuntu 22.04 ou posterior, Debian 12 ou posterior, Raspberry Pi OS 12 (Bookworm), ou Ubuntu/Debian em Orange Pi.
Arquiteturaamd64 (PCs e servidores Intel/AMD), arm64 (Raspberry Pi e Orange Pi de 64 bits) ou armhf (Raspberry Pi de 32 bits).
AcessoUm terminal, no próprio computador ou por SSH, com um utilizador que possa usar sudo.
ContaA tua conta mivpn.net com um servidor MiVPN.
LigaçãoUm router com UPnP, ou um plano com relay se a tua ligação não aceitar entradas (CGNAT, fibra partilhada, rede móvel).
O computador tem ambiente de trabalho? A app com janela será mais cómoda. MiVPN Server para Linux com ambiente de trabalho

1 Instalar

A partir do repositório da MiVPN (recomendado)

A primeira linha adiciona a chave com que assinamos os pacotes, a segunda o repositório e as duas últimas instalam o MiVPN Server. Só se faz uma vez: depois, as atualizações chegam com as do resto do sistema.

curl -fsSL https://mivpn.net/apt/mivpn.gpg | sudo tee /usr/share/keyrings/mivpn.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/mivpn.gpg] https://mivpn.net/apt stable main" | sudo tee /etc/apt/sources.list.d/mivpn.list
sudo apt update
sudo apt install mivpn-server

Ou com o pacote .deb

Transfere o pacote da tua arquitetura:

amd64PCs, servidores e VPS Intel/AMD arm64Raspberry Pi e Orange Pi com sistema de 64 bits armhfRaspberry Pi com sistema de 32 bits

Não sabes a tua arquitetura? Executa dpkg --print-architecture

E instala-o a partir da pasta onde o transferiste:

sudo apt install ./mivpn-server_*.deb
Instalado assim não receberás atualizações automáticas: terás de transferir e instalar cada versão nova.

2 Associa-o à tua conta

Escreve o email da tua conta mivpn.net; vai pedir a palavra-passe. A palavra-passe só serve para entrar desta vez: não fica guardada no computador.

sudo mivpn setup -e tu@exemplo.com

O que faz o mivpn setup

  1. Regista este computador como o servidor da tua conta.
  2. Cria o servidor WireGuard se o computador ainda não tiver um, com a sua rede e o reencaminhamento de tráfego preparados.
  3. Verifica se a tua ligação aceita entradas: se sim, abre a porta no router; se não, ativa o relay da MiVPN.
  4. Abre a porta na firewall do próprio computador.
  5. Prepara os clientes que já tens na tua conta.
Se o teu servidor já estiver a funcionar noutro computador, o setup avisa-te e pergunta se o queres transferir para este.
Este equipamento já está ligado a outra conta? O setup não o altera: primeiro desvincule-o com sudo mivpn unlink e depois volte a executar sudo mivpn setup -e com a conta nova.

3 Arranca-o

Arranca o servidor VPN e o agente que o mantém em contacto com a mivpn.net, e deixa os dois no arranque do sistema: depois de um reinício ou de um corte de luz, o servidor volta sozinho.

sudo mivpn enable

4 Verifica que funciona

mivpn status mostra o mesmo que a app de ambiente de trabalho. Assim se vê um servidor a funcionar:

$ sudo mivpn status
MiVPN Server  raspberrypi (aarch64)
  Account        you@example.com  ·  server "Home"
  Services       tunnel active  ·  upnp port open  ·  notify active  ·  start at boot: yes
  Server         running
  mivpn.net      connected (status and commands)
  Network        Ethernet 1000 Mbps
  Port           UDP 51820  ·  open on the router
  Public IP      203.0.113.25  ·  local 192.168.1.40
  Clients        1 of 2 connected
      phone      connected      10.8.0.2        now
      laptop     disconnected   10.8.0.3        2 h ago
  • Server«running» quando o servidor VPN e o agente funcionam.
  • mivpn.net«connected»: o painel da mivpn.net e a app veem o teu servidor e podem pedir-lhe configurações.
  • Portpor onde entram os teus clientes: «open on the router» numa ligação direta, ou a porta do relay da MiVPN.
  • Clientsos dispositivos que criaste, se estão ligados e quando se ligaram pela última vez.

Comandos

Tudo se faz com o comando mivpn. Os que mexem no servidor precisam de sudo.

Pôr a funcionar
sudo mivpn setup -e …

Associa o computador à tua conta e deixa o servidor preparado.

Quando: da primeira vez, ou para transferir para aqui um servidor que funcionava noutro computador.

sudo mivpn enable

Arranca o servidor e faz com que arranque sozinho sempre que o computador é ligado.

Quando: logo a seguir ao setup.

sudo mivpn disable

O servidor deixa de arrancar ao ligar o computador. Se estiver a funcionar, continua até o parares.

Quando: se preferires decidir tu quando o ligar.

Dia a dia
sudo mivpn status

Como está tudo: servidor, ligação à mivpn.net, rede, porta, IP e clientes.

Quando: sempre que quiseres saber se o servidor está a funcionar.

sudo mivpn logs -f

O registo do servidor, em direto. Sem -f, as últimas linhas.

Quando: se algo não funciona e queres ver o que se passa.

sudo mivpn stop

Para o servidor por completo: o servidor VPN, o agente e o relay.

Quando: se não quiseres que ninguém se ligue durante algum tempo.

sudo mivpn start

Volta a arrancar um servidor parado.

Quando: depois do stop.

sudo mivpn restart

Para e volta a arrancar o servidor.

Quando: se mudaste alguma coisa na rede ou no router.

Deixar o computador
sudo mivpn unlink

Desassocia o computador da tua conta e deixa-o limpo: para o servidor, liberta a porta do router e do relay, e apaga credenciais e clientes. Pede a tua palavra-passe.

Quando: quando este equipamento deixa de ser o seu servidor (antes de o desinstalar ou vender) ou para o usar com outra conta.

Informação
mivpn --version

A versão do MiVPN Server instalada.

mivpn status -h

A ajuda de qualquer comando: troca status pelo que quiseres.

Opções do mivpn setup

-e, --email

O email da tua conta mivpn.net.

--password-stdin

Lê a palavra-passe da entrada padrão, para scripts.

--replace

Transfere o servidor para aqui a partir de outro computador sem perguntar.

-y, --yes

Não pede confirmações.

--port 51820

Porta UDP do servidor. Se não a indicares, 51820.

--no-relay

Não verifica a rede nem ativa o relay.

Instalação automática

Para instalar em vários computadores ou a partir de um script (Ansible, cloud-init…), passa a palavra-passe pela entrada padrão e salta as confirmações:

printf '%s\n' "$MIVPN_PASSWORD" | sudo mivpn setup -e tu@exemplo.com --password-stdin -y
sudo mivpn enable
Não escrevas a palavra-passe no próprio comando com -p: ficaria no histórico e qualquer utilizador do computador a veria.

Transferir o servidor para outro computador

Instala o MiVPN Server no computador novo e associa-o com --replace. O computador antigo deixa de servir sozinho assim que a mivpn.net o avisa. Os teus clientes terão de transferir a configuração de novo; a app da MiVPN fá-lo sozinha.

sudo mivpn setup -e tu@exemplo.com --replace
sudo mivpn enable

Atualizar

As versões novas chegam pelo repositório. Este comando atualiza apenas o MiVPN Server, sem mexer no resto do sistema; no fim, o servidor reinicia sozinho com a versão nova.

sudo apt update
sudo apt install --only-upgrade mivpn-server

Para verificar que versão tens. A última publicada é a que aparece junto ao título desta página:

mivpn --version

Desinstalar

Primeiro desassocia o computador da tua conta; depois, desinstala o pacote.

sudo mivpn unlink
sudo apt remove mivpn-server

Ao desinstalar, tudo é parado e são apagadas as credenciais, os clientes e o servidor WireGuard criado pela MiVPN. Se saltares o unlink, o computador continuará a constar na tua conta até transferires o servidor para outro.

Problemas frequentes

status diz «Root is required to read the status»

As chaves e o estado do servidor só podem ser lidos pelo administrador. Usa sudo mivpn status.

Port: «no UPnP on the router»

O teu router não abre portas automaticamente. Ativa o UPnP nas definições e executa sudo mivpn restart. Se a tua ligação não aceitar entradas (CGNAT), precisas de um plano com relay: o servidor sai pelo relay da MiVPN sem mexer no router.

mivpn.net: «not connected»

O agente não chega à mivpn.net. Verifica se o computador tem Internet e vê o que se passa com sudo mivpn logs -f.

o setup diz que outro computador está a usar o servidor

O teu servidor MiVPN já está a funcionar noutro computador. Transfere-o para este com sudo mivpn setup -e … --replace, ou desassocia primeiro o outro com sudo mivpn unlink.

Depois de mudar de computador, os meus clientes não se ligam

Ao mudar de computador mudam as chaves do servidor: cada cliente tem de transferir a configuração de novo a partir da mivpn.net ou da app da MiVPN.

Posso instalá-lo junto com a app de ambiente de trabalho?

Não: um computador só pode ser servidor uma vez. O mivpn-server e o mivpn-server-desktop excluem-se; o apt remove um se instalares o outro.

Aparece «This machine is already linked to…» ao executar o setup

Este equipamento já é o servidor de outra conta. Para não misturar as duas, o setup não o altera: desvincule-o primeiro e volte a ligá-lo com a conta nova. Os utilizadores da conta anterior deixam de poder ligar-se a este equipamento.

sudo mivpn unlink
sudo mivpn setup -e tu@exemplo.com
Atualizo, mas continuo com a versão antiga

Vê que versão tens instalada (Installed) e qual o repositório oferece (Candidate):

apt-cache policy mivpn-server

Se mivpn.net/apt não aparecer na lista, o repositório não está adicionado (por exemplo, se instalaste o .deb à mão): adiciona-o com os comandos do passo Instalar.

Se aparecer, instala a versão nova indicando-a:

sudo apt update
sudo apt install mivpn-server=3.1.3-10

Depois, mivpn --version deve mostrar a versão nova.

Continua sem funcionar? Escreve-nos pelo chat de suporte e cola o que mostra o sudo mivpn status.