Os seus dados de login da VPN serão gerados aleatoriamente. Consulte [Recuperar dados de login da VPN](#retrieve-vpn-login-details).

Em alternativa, pode [configurar uma VPN IPsec sem Docker](https://github.com/hwdsl2/setup-ipsec-vpn). Para saber mais sobre como utilizar esta imagem, leia as secções abaixo.

## Comunidade

- 📬 [Subscreva para receber atualizações do projeto](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1–2 e-mails/mês) — obtenha guias gratuitos de implantação de VPN e IA (PDF)
- 💬 Junte-se à comunidade [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) para discussões
- ⭐ Marque o repositório com uma estrela se o achar útil — isso ajuda outras pessoas a descobri-lo

## Requisitos

- Um servidor Linux com um endereço IP público ou nome DNS
- Docker instalado
- Portas VPN abertas no seu firewall (UDP 500 e 4500)
- Também pode utilizar [Podman](https://docs.podman.io) para executar esta imagem, após criar um alias para `docker`

**Nota:** Utilizadores avançados podem usar esta imagem em macOS com [Docker for Mac](https://docs.docker.com/desktop/setup/install/mac-install/). Antes de utilizar o modo IPsec/L2TP, poderá ser necessário reiniciar o contentor uma vez com `docker restart ipsec-vpn-server`. Esta imagem não suporta Docker for Windows.

## Download

Obtenha a compilação fiável a partir do [registo do Docker Hub](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/):```bash
docker pull hwdsl2/ipsec-vpn-server

Plataformas suportadas: `linux/amd64`, `linux/arm64` e `linux/arm/v7`.

Utilizadores avançados podem [compilar a partir do código-fonte](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#build-from-source-code) no GitHub.

### Comparação de imagens

Estão disponíveis duas imagens pré-construídas. A imagem padrão baseada em Alpine tem apenas ~19 MB.

|                   | Baseada em Alpine        | Baseada em Debian                |
| ----------------- | ------------------------ | -------------------------------- |
| Nome da imagem    | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian   |
| Tamanho compactado| ~ 19 MB                  | ~ 62 MB                          |
| Imagem base       | Alpine Linux 3.23        | Debian Linux 12                  |
| Plataformas       | amd64, arm64, arm/v7     | amd64, arm64, arm/v7             |
| Versão do Libreswan | 5.4                    | 5.4                              |
| IPsec/L2TP        | ✅                       | ✅                                |
| Cisco IPsec       | ✅                       | ✅                                |
| IKEv2             | ✅                       | ✅                                |

**Nota:** Para utilizar a imagem baseada em Debian, substitua todas as ocorrências de `hwdsl2/ipsec-vpn-server` por `hwdsl2/ipsec-vpn-server:debian` neste README. Estas imagens não são atualmente compatíveis com sistemas Synology NAS.

<details>
<summary>
Quero utilizar a versão mais antiga do Libreswan 4.
</summary>

Geralmente, recomenda-se utilizar a versão mais recente do [Libreswan](https://libreswan.org/) 5, que é a versão padrão neste projeto. No entanto, se pretender utilizar a versão mais antiga do Libreswan 4, pode compilar a imagem Docker a partir do código-fonte:```bash
git clone https://github.com/hwdsl2/docker-ipsec-vpn-server
cd docker-ipsec-vpn-server
# Specify Libreswan version 4
sed -i 's/SWAN_VER=5\..*/SWAN_VER=4.15/' Dockerfile Dockerfile.debian
# To build Alpine-based image
docker build -t hwdsl2/ipsec-vpn-server .
# To build Debian-based image
docker build -f Dockerfile.debian -t hwdsl2/ipsec-vpn-server:debian .

Isto criará uma conta de usuário para login de VPN, que pode ser usada pelos seus múltiplos dispositivos[\*](#notas-importantes). A PSK (chave pré-compartilhada) do IPsec é especificada pela variável de ambiente `VPN_IPSEC_PSK`. O nome de usuário da VPN é definido em `VPN_USER`, e a senha da VPN é especificada por `VPN_PASSWORD`.

Usuários adicionais de VPN são suportados e podem ser opcionalmente declarados no seu arquivo `env` desta forma. Nomes de usuário e senhas devem ser separados por espaços, e os nomes de usuário não podem conter duplicatas. Todos os usuários de VPN compartilharão a mesma PSK do IPsec.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

Neste comando, usamos a opção `-v` do `docker run` para criar um novo [volume Docker](https://docs.docker.com/storage/volumes/) chamado `ikev2-vpn-data` e montá-lo em `/etc/ipsec.d` no contêiner. Dados relacionados ao IKEv2, como certificados e chaves, serão persistidos no volume, e mais tarde, quando você precisar recriar o contêiner Docker, basta especificar o mesmo volume novamente.

É recomendado habilitar o IKEv2 ao usar esta imagem. No entanto, se você preferir não habilitar o IKEv2 e usar apenas os modos IPsec/L2TP e IPsec/XAuth ("Cisco IPsec") para se conectar à VPN, remova a primeira opção `-v` do comando `docker run` acima.

**Observação:** Usuários avançados também podem [executar sem o modo privilegiado](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#run-without-privileged-mode).

### Recuperar detalhes de login da VPN

Se você não especificou um arquivo `env` no comando `docker run` acima, `VPN_USER` terá como padrão `vpnuser` e tanto `VPN_IPSEC_PSK` quanto `VPN_PASSWORD` serão gerados aleatoriamente. Para recuperá-los, visualize os logs do contêiner:```bash
docker logs ipsec-vpn-server

A saída também incluirá detalhes para o modo IKEv2, se estiver habilitado.

(Opcional) Faça backup dos detalhes de login VPN gerados (se houver) para o diretório atual:```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

Example `docker-compose.yml` (já incluído):```yaml
volumes:
  ikev2-vpn-data:

services:
  vpn:
    image: hwdsl2/ipsec-vpn-server
    restart: always
    env_file:
      - ./vpn.env
    ports:
      - "500:500/udp"
      - "4500:4500/udp"
    privileged: true
    hostname: ipsec-vpn-server
    container_name: ipsec-vpn-server
    volumes:
      - ikev2-vpn-data:/etc/ipsec.d
      - /lib/modules:/lib/modules:ro

Se a imagem Docker já estiver atualizada, você deverá ver:```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**Nota:** Se não conseguir encontrar os detalhes do IKEv2, o IKEv2 pode não estar ativado no contêiner. Tente atualizar a imagem Docker e o contêiner usando as instruções da seção [Atualizar imagem Docker](#update-docker-image).

Durante a configuração do IKEv2, um cliente IKEv2 (com o nome padrão `vpnclient`) é criado, com sua configuração exportada para `/etc/ipsec.d` **dentro do contêiner**. Para copiar o(s) arquivo(s) de configuração para o host Docker:```bash
# Check contents of /etc/ipsec.d in the container
docker exec -it ipsec-vpn-server ls -l /etc/ipsec.d
# Example: Copy a client config file from the container
# to the current directory on the Docker host
docker cp ipsec-vpn-server:/etc/ipsec.d/vpnclient.p12 ./