Ihre VPN-Anmeldedaten werden zufällig generiert. Siehe [VPN-Anmeldedaten abrufen](#retrieve-vpn-login-details).

Alternativ können Sie [IPsec-VPN ohne Docker einrichten](https://github.com/hwdsl2/setup-ipsec-vpn). Um mehr über die Verwendung dieses Images zu erfahren, lesen Sie die folgenden Abschnitte.

## Community

- 📬 [Projektupdates abonnieren](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1–2 E-Mails/Monat) — erhalten Sie kostenlose VPN- und KI-Bereitstellungsanleitungen (PDF)
- 💬 Treten Sie der [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/)-Community für Diskussionen bei
- ⭐ Markieren Sie das Repository mit einem Stern, wenn Sie es nützlich finden — das hilft anderen, es zu entdecken

## Anforderungen

- Ein Linux-Server mit einer öffentlichen IP-Adresse oder einem DNS-Namen
- Docker installiert
- VPN-Ports in Ihrer Firewall geöffnet (UDP 500 und 4500)
- Sie können dieses Image auch mit [Podman](https://docs.podman.io) ausführen, nachdem Sie einen Alias für `docker` erstellt haben

**Hinweis:** Fortgeschrittene Benutzer können dieses Image auf macOS mit [Docker für Mac](https://docs.docker.com/desktop/setup/install/mac-install/) verwenden. Vor der Verwendung des IPsec/L2TP-Modus müssen Sie den Container möglicherweise einmal mit `docker restart ipsec-vpn-server` neu starten. Dieses Image unterstützt Docker für Windows nicht.

## Download

Holen Sie sich den vertrauenswürdigen Build aus der [Docker-Hub-Registry](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/):```bash
docker pull hwdsl2/ipsec-vpn-server

Unterstützte Plattformen: `linux/amd64`, `linux/arm64` und `linux/arm/v7`.

Fortgeschrittene Benutzer können den [Quellcode auf GitHub erstellen](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#build-from-source-code).

### Bildvergleich

Zwei vorgefertigte Images sind verfügbar. Das standardmäßige Alpine-basierte Image ist nur etwa 19 MB groß.

|                   | Alpine-basiert           | Debian-basiert                   |
| ----------------- | ------------------------ | ------------------------------ |
| Image-Name        | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian |
| Komprimierte Größe | ~ 19 MB                  | ~ 62 MB                        |
| Basis-Image       | Alpine Linux 3.23        | Debian Linux 12                |
| Plattformen       | amd64, arm64, arm/v7     | amd64, arm64, arm/v7           |
| Libreswan-Version | 5.4                      | 5.4                            |
| IPsec/L2TP        | ✅                       | ✅                              |
| Cisco IPsec       | ✅                       | ✅                              |
| IKEv2             | ✅                       | ✅                              |

**Hinweis:** Um das Debian-basierte Image zu verwenden, ersetzen Sie in dieser README jedes `hwdsl2/ipsec-vpn-server` durch `hwdsl2/ipsec-vpn-server:debian`. Diese Images sind derzeit nicht mit Synology-NAS-Systemen kompatibel.

<details>
<summary>
Ich möchte die ältere Libreswan-Version 4 verwenden.
</summary>

Es wird generell empfohlen, die neueste [Libreswan](https://libreswan.org/)-Version 5 zu verwenden, die die Standardversion in diesem Projekt ist. Wenn Sie jedoch die ältere Libreswan-Version 4 verwenden möchten, können Sie das Docker-Image aus dem Quellcode erstellen:```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 .

Dies erstellt ein Benutzerkonto für den VPN-Login, das von mehreren Ihrer Geräte genutzt werden kann[\*](#important-notes). Der IPsec-PSK (Pre-Shared Key) wird über die Umgebungsvariable `VPN_IPSEC_PSK` festgelegt. Der VPN-Benutzername wird in `VPN_USER` definiert, und das VPN-Passwort wird über `VPN_PASSWORD` angegeben.

Zusätzliche VPN-Benutzer werden unterstützt und können optional in Ihrer `env`-Datei wie folgt deklariert werden. Benutzernamen und Passwörter müssen durch Leerzeichen getrennt sein, und Benutzernamen dürfen keine Duplikate enthalten. Alle VPN-Benutzer teilen sich denselben IPsec-PSK.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

In diesem Befehl verwenden wir die Option `-v` von `docker run`, um ein neues [Docker-Volume](https://docs.docker.com/storage/volumes/) mit dem Namen `ikev2-vpn-data` zu erstellen und es im Container in `/etc/ipsec.d` einzuhängen. IKEv2-bezogene Daten wie Zertifikate und Schlüssel bleiben im Volume erhalten. Wenn Sie später den Docker-Container neu erstellen müssen, geben Sie einfach dasselbe Volume erneut an.

Es wird empfohlen, IKEv2 bei Verwendung dieses Images zu aktivieren. Wenn Sie IKEv2 jedoch nicht aktivieren möchten und nur die IPsec/L2TP- und IPsec/XAuth-Modi („Cisco IPsec") zur Verbindung mit dem VPN verwenden möchten, entfernen Sie die erste Option `-v` aus dem obigen Befehl `docker run`.

**Hinweis:** Fortgeschrittene Benutzer können auch [ohne privilegierten Modus ausführen](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#run-without-privileged-mode).

### VPN-Anmeldedaten abrufen

Wenn Sie im obigen Befehl `docker run` keine `env`-Datei angegeben haben, wird `VPN_USER` standardmäßig auf `vpnuser` gesetzt und sowohl `VPN_IPSEC_PSK` als auch `VPN_PASSWORD` werden zufällig generiert. Um sie abzurufen, sehen Sie sich die Container-Logs an:```bash
docker logs ipsec-vpn-server

Die Ausgabe enthält auch Details für den IKEv2-Modus, sofern dieser aktiviert ist.

(Optional) Sichern Sie die generierten VPN-Anmeldedaten (falls vorhanden) im aktuellen Verzeichnis:```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

Beispiel `docker-compose.yml` (bereits enthalten):```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

Wenn das Docker-Image bereits auf dem neuesten Stand ist, sollten Sie Folgendes sehen:```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**Hinweis:** Wenn Sie keine IKEv2-Details finden, ist IKEv2 möglicherweise nicht im Container aktiviert. Versuchen Sie, das Docker-Image und den Container mithilfe der Anweisungen im Abschnitt [Docker-Image aktualisieren](#update-docker-image) zu aktualisieren.

Während der IKEv2-Einrichtung wird ein IKEv2-Client (mit dem Standardnamen `vpnclient`) erstellt, dessen Konfiguration nach `/etc/ipsec.d` **innerhalb des Containers** exportiert wird. Um die Konfigurationsdatei(en) auf den Docker-Host zu kopieren:```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 ./