Le tue credenziali di accesso VPN verranno generate casualmente. Vedi [Recupera le credenziali di accesso VPN](#retrieve-vpn-login-details).

In alternativa, puoi [configurare IPsec VPN senza Docker](https://github.com/hwdsl2/setup-ipsec-vpn). Per saperne di più su come usare questa immagine, leggi le sezioni seguenti.

## Comunità

- 📬 [Iscriviti per ricevere aggiornamenti sul progetto](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1–2 email/mese) — ricevi guide gratuite su distribuzione VPN e AI (PDF)
- 💬 Unisciti alla community [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) per discussioni
- ⭐ Metti una stella al repository se lo trovi utile — aiuta altri a scoprirlo

## Requisiti

- Un server Linux con un indirizzo IP pubblico o un nome DNS
- Docker installato
- Porte VPN aperte nel tuo firewall (UDP 500 e 4500)
- Puoi anche usare [Podman](https://docs.podman.io) per eseguire questa immagine, dopo aver creato un alias per `docker`

**Nota:** Gli utenti avanzati possono usare questa immagine su macOS con [Docker per Mac](https://docs.docker.com/desktop/setup/install/mac-install/). Prima di usare la modalità IPsec/L2TP, potrebbe essere necessario riavviare il contenitore una volta con `docker restart ipsec-vpn-server`. Questa immagine non supporta Docker per Windows.

## Download

Ottieni la build affidabile dal [registro Docker Hub](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/):```bash
docker pull hwdsl2/ipsec-vpn-server

Supported platforms: `linux/amd64`, `linux/arm64` and `linux/arm/v7`.

Advanced users can [build from source code](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md) on GitHub.

### Image comparison

Two pre-built images are available. The default Alpine-based image is only ~19 MB.

|                   | Basata su Alpine         | Basata su Debian                |
| ----------------- | ------------------------ | ------------------------------ |
| Nome immagine     | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian |
| Dimensioni compresse | ~ 19 MB               | ~ 62 MB                        |
| Immagine base     | Alpine Linux 3.23        | Debian Linux 12                |
| Piattaforme       | amd64, arm64, arm/v7     | amd64, arm64, arm/v7           |
| Versione Libreswan| 5.3.2                    | 5.3.2                          |
| IPsec/L2TP        | ✅                       | ✅                              |
| Cisco IPsec       | ✅                       | ✅                              |
| IKEv2             | ✅                       | ✅                              |

**Nota:** Per usare l'immagine basata su Debian, sostituisci ogni `hwdsl2/ipsec-vpn-server` con `hwdsl2/ipsec-vpn-server:debian` in questo README. Queste immagini non sono attualmente compatibili con i sistemi Synology NAS.

<details>
<summary>
Voglio usare la vecchia versione 4 di Libreswan.
</summary>

Generalmente si consiglia di usare la versione 5 più recente di [Libreswan](https://libreswan.org/), che è la versione predefinita di questo progetto. Tuttavia, se vuoi usare la vecchia versione 4 di Libreswan, puoi compilare l'immagine Docker dal codice sorgente:```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 .

Questo creerà un account utente per l'accesso VPN, che può essere utilizzato dai tuoi dispositivi multipli[\*](#important-notes). La PSK IPsec (chiave pre-condivisa) è specificata dalla variabile d'ambiente `VPN_IPSEC_PSK`. Il nome utente VPN è definito in `VPN_USER`, e la password VPN è specificata da `VPN_PASSWORD`.

Sono supportati utenti VPN aggiuntivi, che possono essere opzionalmente dichiarati nel tuo file `env` in questo modo. Nomi utente e password devono essere separati da spazi, e i nomi utente non possono contenere duplicati. Tutti gli utenti VPN condivideranno la stessa PSK IPsec.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

In questo comando, usiamo l'opzione `-v` di `docker run` per creare un nuovo [volume Docker](https://docs.docker.com/storage/volumes/) chiamato `ikev2-vpn-data` e montarlo in `/etc/ipsec.d` nel container. I dati relativi a IKEv2 come certificati e chiavi persisteranno nel volume e, in seguito, quando dovrai ricreare il container Docker, ti basterà specificare lo stesso volume.

È consigliato abilitare IKEv2 quando si utilizza questa immagine. Tuttavia, se preferisci non abilitare IKEv2 e utilizzare solo le modalità IPsec/L2TP e IPsec/XAuth ("Cisco IPsec") per connetterti alla VPN, rimuovi la prima opzione `-v` dal comando `docker run` sopra.

**Nota:** Gli utenti avanzati possono anche [eseguire senza modalità privilegiata](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md).

### Recuperare i dettagli di accesso VPN

Se non hai specificato un file `env` nel comando `docker run` sopra, `VPN_USER` avrà come predefinito `vpnuser` e sia `VPN_IPSEC_PSK` che `VPN_PASSWORD` verranno generati casualmente. Per recuperarli, visualizza i log del container:```bash
docker logs ipsec-vpn-server

L'output includerà anche i dettagli per la modalità IKEv2, se abilitata.

(Opzionale) Esegui il backup dei dettagli di accesso VPN generati (se presenti) nella directory corrente:```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

Esempio `docker-compose.yml` (già incluso):```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 l'immagine Docker è già aggiornata, dovresti vedere:```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**Nota:** Se non riesci a trovare i dettagli IKEv2, IKEv2 potrebbe non essere abilitato nel contenitore. Prova ad aggiornare l'immagine Docker e il contenitore utilizzando le istruzioni nella sezione [Aggiornare l'immagine Docker](#update-docker-image).

Durante la configurazione di IKEv2, viene creato un client IKEv2 (con nome predefinito `vpnclient`), con la sua configurazione esportata in `/etc/ipsec.d` **all'interno del contenitore**. Per copiare i file di configurazione sull'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 ./