Tus datos de acceso a la VPN se generarán aleatoriamente. Consulta [Recuperar datos de acceso a la VPN](#retrieve-vpn-login-details).

Alternativamente, 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 a continuación.

## Comunidad

- 📬 [Suscríbete para recibir actualizaciones del proyecto](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (1–2 correos al mes) — obtén guías gratuitas de despliegue de VPN e IA (PDF)
- 💬 Únete a la comunidad [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) para debates
- ⭐ 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 de VPN abiertos en tu cortafuegos (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 para 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 para Windows.

## Descarga

Obtén la compilación confiable desde el [registro de Docker Hub](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/):```bash
docker pull hwdsl2/ipsec-vpn-server

Plataformas compatibles: `linux/amd64`, `linux/arm64` y `linux/arm/v7`.

Los usuarios avanzados pueden [compilar desde el código fuente](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#build-from-source-code) en 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.4                      | 5.4                            |
| 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 de [Libreswan](https://libreswan.org/) 5, 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 de VPN, que puede ser utilizada por tus múltiples dispositivos[\*](#notas-importantes). La PSK de IPsec (clave precompartida) se especifica mediante la variable de entorno `VPN_IPSEC_PSK`. El nombre de usuario de VPN se define en `VPN_USER`, y la contraseña de VPN se especifica mediante `VPN_PASSWORD`.

Se admiten usuarios de VPN adicionales, y 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 necesites volver a crear el contenedor de Docker, solo especifica el mismo volumen nuevamente.

Se recomienda habilitar IKEv2 al usar esta imagen. Sin embargo, si prefieres no habilitar IKEv2 y usar solo los modos IPsec/L2TP e IPsec/XAuth ("Cisco IPsec") para conectarte a la VPN, elimina 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#run-without-privileged-mode).

### Obtener los detalles de inicio de sesión de la VPN

Si no especificaste 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, consulta 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 de `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 puedes encontrar los detalles de IKEv2, es posible que IKEv2 no esté habilitado en el contenedor. Intenta actualizar la imagen de Docker y el contenedor usando 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 los archivos 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 ./