Consulta [Cómo recuperar los datos de inicio de sesión de VPN](#retrieve-vpn-login-details).

Como alternativa, puedes [configurar IPsec VPN sin Docker](https://github.com/hwdsl2/setup-ipsec-vpn). Para obtener más información sobre cómo usar esta imagen, lee las secciones siguientes.

## Comunidad

- 📬 [Suscríbete para recibir actualizaciones del proyecto](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1–2 correos electrónicos al mes) — obtén guías gratuitas de implementación de VPN e IA (PDF)
- 💬 Únete a la comunidad de [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) para discusiones
- ⭐ Marca el repositorio con una estrella si te resulta útil — ayuda a que otros lo descubran

## Requisitos

- Un servidor Linux con una dirección IP pública o un nombre DNS
- Docker instalado
- Puertos VPN abiertos en tu firewall (UDP 500 y 4500)
- También puedes usar [Podman](https://docs.podman.io) para ejecutar esta imagen, después de crear un alias para `docker`

**Nota:** Los usuarios avanzados pueden usar esta imagen en macOS con [Docker for Mac](https://docs.docker.com/desktop/setup/install/mac-install/). Antes de usar el modo IPsec/L2TP, es posible que debas reiniciar el contenedor una vez con `docker restart ipsec-vpn-server`. Esta imagen no es compatible con Docker for Windows.

## Descarga

Obtén la compilación confiable del [registro de 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.

### Comparación de imágenes

Hay dos imágenes precompiladas disponibles. La imagen predeterminada basada en Alpine tiene solo ~19 MB.

|                   | Basada en Alpine         | Basada en Debian               |
| ----------------- | ------------------------ | ------------------------------ |
| Nombre de la imagen | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian |
| Tamaño comprimido | ~ 19 MB                  | ~ 62 MB                        |
| Imagen base       | Alpine Linux 3.23        | Debian Linux 12                |
| Plataformas       | amd64, arm64, arm/v7     | amd64, arm64, arm/v7           |
| Versión de Libreswan | 5.3.2                    | 5.3.2                          |
| IPsec/L2TP        | ✅                       | ✅                              |
| Cisco IPsec       | ✅                       | ✅                              |
| IKEv2             | ✅                       | ✅                              |

**Nota:** Para usar la imagen basada en Debian, reemplace cada `hwdsl2/ipsec-vpn-server` por `hwdsl2/ipsec-vpn-server:debian` en este README. Estas imágenes no son actualmente compatibles con los sistemas Synology NAS.

<details>
<summary>
Quiero usar la versión anterior de Libreswan 4.
</summary>

Generalmente se recomienda usar la última versión 5 de [Libreswan](https://libreswan.org/), que es la versión predeterminada en este proyecto. Sin embargo, si desea usar la versión anterior de Libreswan 4, puede compilar la imagen de Docker desde el código fuente:```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 .

Esto creará una cuenta de usuario para el inicio de sesión en la VPN, que podrá ser utilizada por tus múltiples dispositivos[\*](#important-notes). La PSK de IPsec (clave precompartida) se especifica mediante la variable de entorno `VPN_IPSEC_PSK`. El nombre de usuario de la VPN se define en `VPN_USER`, y la contraseña de la VPN se especifica mediante `VPN_PASSWORD`.

Se admiten usuarios adicionales de VPN, que pueden declararse opcionalmente en tu archivo `env` de esta manera. Los nombres de usuario y las contraseñas deben estar separados por espacios, y los nombres de usuario no pueden contener duplicados. Todos los usuarios de VPN compartirán la misma PSK de IPsec.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

En este comando, usamos la opción `-v` de `docker run` para crear un nuevo [volumen de Docker](https://docs.docker.com/storage/volumes/) llamado `ikev2-vpn-data` y montarlo en `/etc/ipsec.d` dentro del contenedor. Los datos relacionados con IKEv2, como certificados y claves, se conservarán en el volumen, y más adelante, cuando necesite recrear el contenedor de Docker, solo especifique el mismo volumen nuevamente.

Se recomienda habilitar IKEv2 al usar esta imagen. Sin embargo, si prefiere no habilitar IKEv2 y usar solo los modos IPsec/L2TP e IPsec/XAuth ("Cisco IPsec") para conectarse a la VPN, elimine la primera opción `-v` del comando `docker run` anterior.

**Nota:** Los usuarios avanzados también pueden [ejecutar sin modo privilegiado](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md).

### Obtener los detalles de acceso a la VPN

Si no especificó un archivo `env` en el comando `docker run` anterior, `VPN_USER` tendrá como valor predeterminado `vpnuser` y tanto `VPN_IPSEC_PSK` como `VPN_PASSWORD` se generarán aleatoriamente. Para obtenerlos, revise los registros del contenedor:```bash
docker logs ipsec-vpn-server

La salida también incluirá detalles para el modo IKEv2, si está habilitado.

(Opcional) Realiza una copia de seguridad de los detalles de inicio de sesión de VPN generados (si los hay) en el directorio actual:```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

Ejemplo `docker-compose.yml` (ya incluido):```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 la imagen de Docker ya está actualizada, deberías ver:```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**Nota:** Si no puede encontrar los detalles de IKEv2, es posible que IKEv2 no esté habilitado en el contenedor. Intente actualizar la imagen y el contenedor de Docker siguiendo las instrucciones de la sección [Actualizar imagen de Docker](#update-docker-image).

Durante la configuración de IKEv2, se crea un cliente IKEv2 (con el nombre predeterminado `vpnclient`), cuya configuración se exporta a `/etc/ipsec.d` **dentro del contenedor**. Para copiar el/los archivo(s) de configuración al host de 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 ./