IPsec VPN Server auf Docker

Docker-Image zum Betrieb eines IPsec-VPN-Servers mit IPsec/L2TP, Cisco IPsec und IKEv2.

Basiert auf Alpine 3.23 oder Debian 12 mit Libreswan (IPsec-VPN-Software) und xl2tpd (L2TP-Daemon).

Ein IPsec-VPN verschlüsselt Ihren Netzwerkverkehr, sodass niemand zwischen Ihnen und dem VPN-Server Ihre Daten abhören kann, während sie über das Internet übertragen werden. Dies ist besonders nützlich bei der Nutzung ungesicherter Netzwerke, z. B. in Cafés, Flughäfen oder Hotelzimmern.

Funktionen:

Generiert beim ersten Start automatisch VPN-Zugangsdaten und IKEv2-Konfiguration
Unterstützt IKEv2 mit starken und schnellen Cipher-Suites (z. B. AES-GCM)
Generiert VPN-Profile zur automatischen Konfiguration von iOS-, macOS- und Android-Geräten
Unterstützt Windows, macOS, iOS, Android, Chrome OS und Linux als VPN-Clients
Enthält ein Hilfsskript zur Verwaltung von IKEv2-Benutzern und -Zertifikaten
Wird automatisch über GitHub Actions gebaut und veröffentlicht
Persistente Daten über ein Docker-Volume
Multi-Arch: linux/amd64, linux/arm64, linux/arm/v7

Ebenfalls verfügbar:

VPN: IPsec ohne Docker, WireGuard, OpenVPN, Headscale
KI: Self-Hosted AI Stack für lokale LLMs, Chat, RAG, Sprache und KI-Tools

📘 Interesse an selbst gehosteter KI? The Self-Hosted AI Builder’s Guide ist ein praktischer Leitfaden zum Aufbau, zur Absicherung und zum Betrieb Ihres eigenen privaten KI-Stacks.

Schnellstart

Verwenden Sie diesen Befehl, um einen IPsec-VPN-Server auf Docker einzurichten:

docker run \
    --name ipsec-vpn-server \
    --restart=always \
    -v ikev2-vpn-data:/etc/ipsec.d \
    -v /lib/modules:/lib/modules:ro \
    -p 500:500/udp \
    -p 4500:4500/udp \
    -d --privileged \
    hwdsl2/ipsec-vpn-server

Ihre VPN-Anmeldedaten werden zufällig generiert. Siehe VPN-Anmeldedaten abrufen.

Alternativ können Sie IPsec VPN ohne Docker einrichten. Um mehr über die Verwendung dieses Images zu erfahren, lesen Sie die folgenden Abschnitte.

Community

📬 Erhalten Sie Projekt-Updates und kostenlose Deployment-Anleitungen (1–2 E-Mails/Monat)
💬 Treten Sie der r/selfhostedstack-Community für Diskussionen bei
⭐ Geben Sie dem Repository einen Stern, wenn Sie es nützlich finden — das hilft anderen, es zu entdecken

Voraussetzungen

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 auch Podman verwenden, um dieses Image auszuführen, nachdem Sie einen Alias für docker erstellt haben

Hinweis: Fortgeschrittene Benutzer können dieses Image unter macOS mit Docker for Mac verwenden. Bevor Sie den IPsec/L2TP-Modus verwenden, müssen Sie möglicherweise den Container einmal mit docker restart ipsec-vpn-server neu starten. Dieses Image unterstützt Docker for Windows nicht.

Download

Holen Sie sich den vertrauenswürdigen Build aus der Docker Hub Registry:

docker pull hwdsl2/ipsec-vpn-server

Alternativ können Sie von Quay.io herunterladen:

docker pull quay.io/hwdsl2/ipsec-vpn-server
docker image tag quay.io/hwdsl2/ipsec-vpn-server hwdsl2/ipsec-vpn-server

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

Fortgeschrittene Benutzer können aus dem Quellcode erstellen auf GitHub.

Image-Vergleich

Zwei vorgefertigte Images sind verfügbar. Das standardmäßige Alpine-basierte Image ist nur ~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.1	5.4.1
IPsec/L2TP	✅	✅
Cisco IPsec	✅	✅
IKEv2	✅	✅

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

Ich möchte die ältere Libreswan-Version 4 verwenden.

Es wird allgemein empfohlen, die neueste Libreswan-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:

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 .

Verwendung dieses Images

Umgebungsvariablen

Hinweis: Alle Variablen für dieses Image sind optional, was bedeutet, dass Sie keine Variable eingeben müssen und Sie einen IPsec-VPN-Server direkt einsatzbereit haben! Erstellen Sie dazu eine leere env-Datei mit touch vpn.env und fahren Sie mit dem nächsten Abschnitt fort.

Dieses Docker-Image verwendet die folgenden Variablen, die in einer env-Datei deklariert werden können (siehe Beispiel):

VPN_IPSEC_PSK=your_ipsec_pre_shared_key
VPN_USER=your_vpn_username
VPN_PASSWORD=your_vpn_password

Docker IPsec VPN Server

Beliebteste