Vos identifiants de connexion VPN seront générés aléatoirement. Voir [Récupérer les identifiants de connexion VPN](#retrieve-vpn-login-details).

Vous pouvez également [configurer un VPN IPsec sans Docker](https://github.com/hwdsl2/setup-ipsec-vpn). Pour en savoir plus sur l’utilisation de cette image, lisez les sections ci-dessous.

## Communauté

- 📬 [Abonnez-vous aux mises à jour du projet](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1 à 2 e-mails/mois) — obtenez des guides gratuits de déploiement VPN et IA (PDF)
- 💬 Rejoignez la communauté [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) pour des discussions
- ⭐ Mettez une étoile au dépôt si vous le trouvez utile — cela aide d’autres à le découvrir

## Prérequis

- Un serveur Linux avec une adresse IP publique ou un nom DNS
- Docker installé
- Ports VPN ouverts dans votre pare-feu (UDP 500 et 4500)
- Vous pouvez également utiliser [Podman](https://docs.podman.io) pour exécuter cette image, après avoir créé un alias pour `docker`

**Remarque :** Les utilisateurs avancés peuvent utiliser cette image sur macOS avec [Docker for Mac](https://docs.docker.com/desktop/setup/install/mac-install/). Avant d’utiliser le mode IPsec/L2TP, vous devrez peut-être redémarrer le conteneur une fois avec `docker restart ipsec-vpn-server`. Cette image ne prend pas en charge Docker for Windows.

## Téléchargement

Obtenez la version fiable depuis le [registre Docker Hub](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/) :```bash
docker pull hwdsl2/ipsec-vpn-server

Plateformes prises en charge : `linux/amd64`, `linux/arm64` et `linux/arm/v7`.

Les utilisateurs avancés peuvent [compiler à partir du code source](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#build-from-source-code) sur GitHub.

### Comparaison des images

Deux images pré-construites sont disponibles. L'image par défaut basée sur Alpine ne fait qu'environ 19 Mo.

|                   | Basée sur Alpine             | Basée sur Debian                   |
| ----------------- | ------------------------ | ------------------------------ |
| Nom de l'image    | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian |
| Taille compressée | ~ 19 Mo                  | ~ 62 Mo                        |
| Image de base     | Alpine Linux 3.23        | Debian Linux 12                |
| Plateformes       | amd64, arm64, arm/v7     | amd64, arm64, arm/v7           |
| Version Libreswan | 5.4                      | 5.4                            |
| IPsec/L2TP        | ✅                       | ✅                              |
| Cisco IPsec       | ✅                       | ✅                              |
| IKEv2             | ✅                       | ✅                              |

**Remarque :** Pour utiliser l'image basée sur Debian, remplacez chaque `hwdsl2/ipsec-vpn-server` par `hwdsl2/ipsec-vpn-server:debian` dans ce README. Ces images ne sont actuellement pas compatibles avec les systèmes Synology NAS.

<details>
<summary>
Je souhaite utiliser l'ancienne version 4 de Libreswan.
</summary>

Il est généralement recommandé d'utiliser la dernière [Libreswan](https://libreswan.org/) version 5, qui est la version par défaut de ce projet. Cependant, si vous souhaitez utiliser l'ancienne version 4 de Libreswan, vous pouvez compiler l'image Docker à partir du code source :```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 .

Cela créera un compte utilisateur pour la connexion VPN, qui pourra être utilisé par vos multiples appareils[\*](#important-notes). La clé PSK IPsec (clé pré-partagée) est spécifiée par la variable d'environnement `VPN_IPSEC_PSK`. Le nom d'utilisateur VPN est défini dans `VPN_USER`, et le mot de passe VPN est spécifié par `VPN_PASSWORD`.

Des utilisateurs VPN supplémentaires sont pris en charge et peuvent être éventuellement déclarés dans votre fichier `env` comme ceci. Les noms d'utilisateur et mots de passe doivent être séparés par des espaces, et les noms d'utilisateur ne peuvent pas contenir de doublons. Tous les utilisateurs VPN partageront la même clé PSK IPsec.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

Dans cette commande, nous utilisons l'option `-v` de `docker run` pour créer un nouveau [volume Docker](https://docs.docker.com/storage/volumes/) nommé `ikev2-vpn-data`, et le monter dans `/etc/ipsec.d` dans le conteneur. Les données liées à IKEv2 telles que les certificats et les clés seront conservées dans le volume, et plus tard, lorsque vous aurez besoin de recréer le conteneur Docker, il suffira de spécifier à nouveau le même volume.

Il est recommandé d'activer IKEv2 lors de l'utilisation de cette image. Cependant, si vous préférez ne pas activer IKEv2 et utiliser uniquement les modes IPsec/L2TP et IPsec/XAuth (« Cisco IPsec ») pour vous connecter au VPN, supprimez la première option `-v` de la commande `docker run` ci-dessus.

**Remarque :** Les utilisateurs avancés peuvent également [exécuter sans mode privilégié](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#run-without-privileged-mode).

### Récupérer les informations de connexion VPN

Si vous n'avez pas spécifié de fichier `env` dans la commande `docker run` ci-dessus, `VPN_USER` prendra par défaut la valeur `vpnuser` et `VPN_IPSEC_PSK` ainsi que `VPN_PASSWORD` seront générés aléatoirement. Pour les récupérer, consultez les journaux du conteneur :```bash
docker logs ipsec-vpn-server

La sortie inclura également les détails pour le mode IKEv2, s'il est activé.

(Facultatif) Sauvegardez les identifiants de connexion VPN générés (le cas échéant) dans le répertoire courant :```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

Exemple de `docker-compose.yml` (déjà inclus) :```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

Si l’image Docker est déjà à jour, vous devriez voir :```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**Remarque :** Si vous ne trouvez pas les détails IKEv2, il se peut que IKEv2 ne soit pas activé dans le conteneur. Essayez de mettre à jour l'image Docker et le conteneur en suivant les instructions de la section [Mise à jour de l'image Docker](#update-docker-image).

Lors de la configuration IKEv2, un client IKEv2 (avec le nom par défaut `vpnclient`) est créé, et sa configuration est exportée vers `/etc/ipsec.d` **à l'intérieur du conteneur**. Pour copier le(s) fichier(s) de configuration vers l'hôte 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 ./