## ¿Por qué OpenVPN?

OpenVPN era el estándar de facto para VPNs de código abierto cuando se creó este script. WireGuard llegó después y es más simple y rápido para la mayoría de los casos de uso. Echa un vistazo a [wireguard-install](https://github.com/angristan/wireguard-install).

Dicho esto, OpenVPN sigue teniendo sentido cuando necesitas:

- **Soporte TCP**: funciona en entornos restrictivos donde UDP está bloqueado (redes corporativas, aeropuertos, hoteles, etc.)
- **Claves privadas protegidas por contraseña**: las configuraciones de WireGuard almacenan la clave privada en texto plano
- **Compatibilidad heredada**: existen clientes para casi todas las plataformas, incluidos sistemas antiguos

## Características

- Instala y configura un servidor OpenVPN listo para usar
- Interfaz CLI para automatización y scripting (modo no interactivo con salida JSON)
- Renovación de certificados tanto para certificados de cliente como de servidor
- Listar y monitorear clientes conectados
- Desconexión inmediata del cliente al revocar el certificado (a través de la interfaz de gestión)
- Utiliza los [repositorios oficiales de OpenVPN](https://community.openvpn.net/openvpn/wiki/OpenvpnSoftwareRepos) cuando es posible para las últimas versiones estables
- Reglas de firewall y reenvío gestionados sin problemas (soporte nativo de firewalld y nftables, con iptables como respaldo)
- Subredes VPN configurables (IPv4: por defecto `10.8.0.0/24`, IPv6: por defecto `fd42:42:42:42::/112`)
- MTU de túnel configurable (por defecto: `1500`)
- Si es necesario, el script puede eliminar OpenVPN limpiamente, incluida la configuración y las reglas de firewall
- Ajustes de cifrado personalizables, configuraciones predeterminadas mejoradas (ver [Seguridad y cifrado](#security-and-encryption) más abajo)
- Utiliza las últimas funciones de OpenVPN cuando están disponibles (ver [Seguridad y cifrado](#security-and-encryption) más abajo)
- Variedad de resolutores DNS para enviar a los clientes
- Opción de usar un resolutor autoalojado con Unbound (compatible con instalaciones de Unbound ya existentes)
- Opción entre TCP y UDP
- Soporte flexible de IPv4/IPv6:
  - Extremo de servidor IPv4 o IPv6 (cómo se conectan los clientes)
  - Clientes solo IPv4, solo IPv6 o de doble pila (direccionamiento VPN y acceso a internet)
  - Todas las combinaciones compatibles: 4→4, 4→4/6, 4→6, 6→4, 6→6, 6→4/6
  - Prevención automática de fugas: bloquea el protocolo no deseado en modos de pila única
- Modo sin privilegios: ejecutar como `nobody`/`nogroup`
- Bloquear fugas de DNS en Windows 10
- Nombre de certificado de servidor aleatorizado
- Opción de proteger a los clientes con una contraseña (cifrado de clave privada)
- Opción para permitir que varios dispositivos usen el mismo perfil de cliente simultáneamente (desactiva las direcciones IP persistentes)
- **Autenticación por huella digital de pares** (OpenVPN 2.6+): autenticación simplificada similar a WireGuard sin CA
- ¡Muchas otras pequeñas cosas!

## Compatibilidad

El script es compatible con estas distribuciones de Linux:

|                     | Soporte |
| ------------------- | ------- |
| AlmaLinux >= 8      | ✅ 🤖   |
| Amazon Linux 2023   | ✅ 🤖   |
| Arch Linux          | ✅ 🤖   |
| CentOS Stream >= 8  | ✅ 🤖   |
| Debian >= 11        | ✅ 🤖   |
| Fedora >= 40        | ✅ 🤖   |
| openSUSE Leap >= 16 | ✅ 🤖   |
| openSUSE Tumbleweed | ✅ 🤖   |
| Oracle Linux >= 8   | ✅ 🤖   |
| Rocky Linux >= 8    | ✅ 🤖   |
| Ubuntu >= 18.04     | ✅ 🤖   |

A tener en cuenta:

- El script se prueba regularmente solo contra las distribuciones marcadas con 🤖.
  - Solo se prueba en arquitectura `amd64`.
- El script requiere `systemd`.

### Proveedores recomendados

- [Vultr](https://umami.stanislas.cloud/q/1HH9Thp8i): Ubicaciones en todo el mundo, soporte IPv6, desde \$2.5/mes
- [Hetzner](https://umami.stanislas.cloud/q/HdzaOJWq7): Ubicaciones en todo el mundo, IPv6, 20 TB de tráfico, desde €3.59/mes
- [Digital Ocean](https://umami.stanislas.cloud/q/sEVh1l79B): Ubicaciones en todo el mundo, soporte IPv6, desde \$4/mes

## Uso

Primero, descarga el script en tu servidor y hazlo ejecutable:```bash
curl -O https://raw.githubusercontent.com/angristan/openvpn-install/master/openvpn-install.sh
chmod +x openvpn-install.sh

Esto te guiará a través de la instalación y la gestión de clientes.

En tu directorio personal, tendrás archivos `.ovpn`. Estos son los archivos de configuración del cliente. Descárgalos desde tu servidor (usando `scp`, por ejemplo) y conéctate usando tu cliente OpenVPN favorito.

Si tienes alguna pregunta, dirígete primero a las [FAQ](#faq). Y si necesitas ayuda, puedes abrir una [discusión](https://github.com/angristan/openvpn-install/discussions). Por favor, busca primero en los issues y discusiones existentes.

### Modo CLI

> [!WARNING]
> No se garantiza la compatibilidad de la API. Pueden ocurrir cambios que rompan la compatibilidad entre versiones. Si usas este script programáticamente (p. ej., en automatización o CI/CD), fija un commit específico en lugar de usar la rama master.

Para automatización y scripting, usa la interfaz CLI:```bash
# Install with defaults
./openvpn-install.sh install

# Add a client
./openvpn-install.sh client add alice

# List clients
./openvpn-install.sh client list

# Revoke a client (immediately disconnects if connected)
./openvpn-install.sh client revoke alice

Ejecuta `./openvpn-install.sh <command> --help` para conocer las opciones específicas de cada comando.

#### Gestión de clientes```bash
# Add a new client
./openvpn-install.sh client add alice

# Add a password-protected client
./openvpn-install.sh client add bob --password

# Revoke a client
./openvpn-install.sh client revoke alice

# Renew a client certificate
./openvpn-install.sh client renew bob --cert-days 365

Salida JSON para scripting:```text
$ ./openvpn-install.sh client list --format json | jq
{
  "clients": [
    {
      "name": "alice",
      "status": "valid",
      "expiry": "2035-01-15",
      "days_remaining": 3650
    },
    {
      "name": "bob",
      "status": "valid",
      "expiry": "2035-01-15",
      "days_remaining": 3650
    },
    {
      "name": "charlie",
      "status": "revoked",
      "expiry": "2035-01-15",
      "days_remaining": null
    }
  ]
}

Mostrar clientes conectados (los datos se actualizan cada 60 segundos):```text
$ ./openvpn-install.sh server status
══ Connected Clients ══
[INFO] Found 2 connected client(s)

   Name    Real Address          VPN IP      Connected Since   Transfer
   ----    ------------          ------      ---------------   --------
   alice   203.0.113.45:52341    10.8.0.2    2025-01-15 14:32  ↓1.2M ↑500K
   bob     198.51.100.22:41892   10.8.0.3    2025-01-15 09:15  ↓800K ↑200K

[INFO] Note: Data refreshes every 60 seconds.

**Opciones de red:**

- `--endpoint <host>` - IP pública o nombre de host para clientes (por defecto: auto-detectado)
- `--endpoint-type <4|6>` - Versión de IP del endpoint (por defecto: `4`)
- `--ip <addr>` - IP de escucha del servidor (por defecto: auto-detectada)
- `--client-ipv4` - Habilitar IPv4 para clientes VPN (por defecto: habilitado)
- `--no-client-ipv4` - Deshabilitar IPv4 para clientes VPN
- `--client-ipv6` - Habilitar IPv6 para clientes VPN (por defecto: deshabilitado)
- `--no-client-ipv6` - Deshabilitar IPv6 para clientes VPN
- `--subnet-ipv4 <x.x.x.0>` - Subred VPN IPv4 (por defecto: `10.8.0.0`)
- `--subnet-ipv6 <prefix>` - Subred VPN IPv6 (por defecto: `fd42:42:42:42::`)
- `--port <num>` - Puerto OpenVPN (por defecto: `1194`)
- `--port-random` - Usar puerto aleatorio (49152-65535)
- `--protocol <udp|tcp>` - Protocolo (por defecto: `udp`)
- `--mtu <size>` - MTU del túnel (por defecto: `1500`)

**Opciones de DNS:**

- `--dns <provider>` - Proveedor de DNS (por defecto: `cloudflare`). Opciones: `system`, `unbound`, `cloudflare`, `quad9`, `quad9-uncensored`, `fdn`, `dnswatch`, `opendns`, `google`, `yandex`, `adguard`, `nextdns`, `custom`
- `--dns-primary <ip>` - DNS primario personalizado (requiere `--dns custom`)
- `--dns-secondary <ip>` - DNS secundario personalizado (requiere `--dns custom`)

**Opciones de seguridad:**

- `--cipher <cipher>` - Cifrado de datos (por defecto: `AES-128-GCM`). Opciones: `AES-128-GCM`, `AES-192-GCM`, `AES-256-GCM`, `AES-128-CBC`, `AES-192-CBC`, `AES-256-CBC`, `CHACHA20-POLY1305`
- `--cert-type <ecdsa|rsa>` - Tipo de certificado (por defecto: `ecdsa`)
- `--cert-curve <curve>` - Curva ECDSA (por defecto: `prime256v1`). Opciones: `prime256v1`, `secp384r1`, `secp521r1`
- `--rsa-bits <2048|3072|4096>` - Tamaño de clave RSA (por defecto: `2048`)
- `--hmac <alg>` - Algoritmo HMAC (por defecto: `SHA256`). Opciones: `SHA256`, `SHA384`, `SHA512`
- `--tls-sig <mode>` - Modo TLS (por defecto: `crypt-v2`). Opciones: `crypt-v2`, `crypt`, `auth`
- `--auth-mode <mode>` - Modo de autenticación (por defecto: `pki`). Opciones: `pki` (basado en CA), `fingerprint` (peer-fingerprint, requiere OpenVPN 2.6+)
- `--tls-version-min <1.2|1.3>` - Versión mínima de TLS (por defecto: `1.2`)
- `--tls-ciphersuites <list>` - Suites de cifrado TLS 1.3, separadas por dos puntos (por defecto: `TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256:TLS_CHACHA20_POLY1305_SHA256`)
- `--tls-groups <list>` - Grupos de intercambio de claves, separados por dos puntos (por defecto: `X25519:prime256v1:secp384r1:secp521r1`)
- `--server-cert-days <n>` - Validez del certificado del servidor en días (por defecto: `3650`)

**Opciones de cliente:**

- `--client <name>` - Nombre inicial del cliente (por defecto: `client`)
- `--client-password [pass]` - Proteger con contraseña la clave del cliente (por defecto: sin contraseña)
- `--client-cert-days <n>` - Validez del certificado del cliente en días (por defecto: `3650`)
- `--no-client` - Omitir la creación inicial del cliente

**Otras opciones:**

- `--multi-client` - Permitir el mismo certificado en varios dispositivos (por defecto: deshabilitado)

#### Ejemplos de automatización

**Creación de clientes en lote:**```bash
#!/bin/bash
for user in alice bob charlie; do
  ./openvpn-install.sh client add "$user"
done

**Salida JSON para scripting:**```bash
# Get client list as JSON
./openvpn-install.sh client list --format json | jq '.clients[] | select(.status == "valid")'

# Get connected clients as JSON
./openvpn-install.sh server status --format json

Ventajas:

- Configuración más simple: no se necesita infraestructura de CA
- Más fácil de entender: similar al modelo `known_hosts` de SSH
- Ideal para configuraciones pequeñas: redes domésticas, laboratorios, equipos pequeños

Cómo funciona:

1. El servidor genera un certificado autofirmado y almacena su huella digital
2. Cada cliente genera un certificado autofirmado
3. Las huellas digitales de los clientes se añaden al bloque `<peer-fingerprint>` del servidor
4. Los clientes verifican el servidor mediante la huella digital del servidor
5. La revocación elimina la huella digital de la configuración del servidor (no se necesita CRL)

Compromiso: revocar un cliente requiere recargar OpenVPN (las huellas digitales están en server.conf). En modo PKI, el archivo CRL se vuelve a leer automáticamente en cada nueva conexión.

### Canal de datos

> [!NOTE]
> El cifrado predeterminado del canal de datos cambió en OpenVPN 2.5. Las versiones anteriores usaban `BF-CBC` por defecto, mientras que OpenVPN 2.5+ usa `AES-256-GCM:AES-128-GCM` por defecto. OpenVPN 2.6+ también incluye `CHACHA20-POLY1305` en la lista de cifrados predeterminados cuando está disponible.

Por defecto, OpenVPN 2.4 y anteriores usaban `BF-CBC` como cifrado del canal de datos. Blowfish es un algoritmo antiguo (1993) y débil. Incluso la documentación oficial de OpenVPN lo admite.

> El valor predeterminado es BF-CBC, una abreviatura de Blowfish en modo Cipher Block Chaining.
>
> Ya no se recomienda usar BF-CBC, debido a su tamaño de bloque de 64 bits. Este pequeño tamaño de bloque permite ataques basados en colisiones, como lo demuestra SWEET32. Consulta <https://community.openvpn.net/openvpn/wiki/SWEET32> para más detalles.
> Investigadores de seguridad del INRIA publicaron un ataque contra cifrados de bloque de 64 bits, como 3DES y Blowfish. Demuestran que pueden recuperar texto plano cuando los mismos datos se envían con suficiente frecuencia, y muestran cómo pueden usar vulnerabilidades de cross-site scripting para enviar los datos de interés con la frecuencia necesaria. Esto funciona sobre HTTPS, pero también funciona para HTTP sobre OpenVPN. Consulta <https://sweet32.info/> para una explicación mucho mejor y más detallada.
>
> El cifrado predeterminado de OpenVPN, BF-CBC, se ve afectado por este ataque.

De hecho, AES es el estándar actual. Es el cifrado más rápido y seguro disponible hoy en día. [SEED](https://en.wikipedia.org/wiki/SEED) y [Camellia](https://github.com/angristan/openvpn-install/blob/master/%3Chttps%3A/en.wikipedia.org/wiki/Camellia_%28cipher)>) no son vulnerables hasta la fecha, pero son más lentos que AES y gozan de menos confianza.

> De los cifrados actualmente soportados, OpenVPN recomienda actualmente usar AES-256-CBC o AES-128-CBC. OpenVPN 2.4 y versiones posteriores también admiten GCM. Para 2.4+, recomendamos usar AES-256-GCM o AES-128-GCM.

AES-256 es un 40% más lento que AES-128, y no hay ninguna razón real para usar una clave de 256 bits en lugar de una de 128 bits con AES. (Fuente: [1](http://security.stackexchange.com/questions/14068/why-most-people-use-256-bit-encryption-instead-of-128-bit),[2](http://security.stackexchange.com/questions/6141/amount-of-simple-operations-that-is-safely-out-of-reach-for-all-humanity/6149#6149)). Además, AES-256 es más vulnerable a los [ataques de temporización](https://en.wikipedia.org/wiki/Timing_attack).

AES-GCM es un [cifrado AEAD](https://en.wikipedia.org/wiki/Authenticated_encryption), lo que significa que proporciona simultáneamente garantías de confidencialidad, integridad y autenticidad sobre los datos.

ChaCha20-Poly1305 es otro cifrado AEAD que proporciona una seguridad similar a AES-GCM. Es especialmente útil en dispositivos sin aceleración AES por hardware (AES-NI), como CPUs antiguas y muchos dispositivos basados en ARM, donde puede ser significativamente más rápido que AES.

El script admite los siguientes cifrados:

- `AES-128-GCM`
- `AES-192-GCM`
- `AES-256-GCM`
- `AES-128-CBC`
- `AES-192-CBC`
- `AES-256-CBC`
- `CHACHA20-POLY1305` (requiere OpenVPN 2.5+)

Y usa `AES-128-GCM` por defecto.

OpenVPN 2.4 añadió una función llamada "NCP": _Negotiable Crypto Parameters_. Significa que puedes proporcionar un conjunto de cifrados como con HTTPS. Está configurado en `AES-256-GCM:AES-128-GCM` por defecto y anula el parámetro `--cipher` cuando se usa con un cliente OpenVPN 2.4. Por simplicidad, el script establece `--cipher` (respaldo para clientes sin NCP), `--data-ciphers` (nomenclatura moderna de OpenVPN 2.5+) y `--ncp-ciphers` (alias heredado para compatibilidad con OpenVPN 2.4) al cifrado elegido anteriormente.

### Canal de control

OpenVPN 2.4 negociará el mejor cifrado disponible por defecto (p. ej. ECDHE+AES-256-GCM)

#### Cifrados TLS 1.2 (`--tls-cipher`)

El script propone las siguientes opciones, dependiendo del certificado:

- ECDSA:
  - `TLS-ECDHE-ECDSA-WITH-AES-128-GCM-SHA256`
  - `TLS-ECDHE-ECDSA-WITH-AES-256-GCM-SHA384`
  - `TLS-ECDHE-ECDSA-WITH-CHACHA20-POLY1305-SHA256` (requiere OpenVPN 2.5+)
- RSA:
  - `TLS-ECDHE-RSA-WITH-AES-128-GCM-SHA256`
  - `TLS-ECDHE-RSA-WITH-AES-256-GCM-SHA384`
  - `TLS-ECDHE-RSA-WITH-CHACHA20-POLY1305-SHA256` (requiere OpenVPN 2.5+)

Por defecto usa `TLS-ECDHE-*-WITH-AES-128-GCM-SHA256`.

#### Cifrados TLS 1.3 (`--tls-ciphersuites`)

Cuando se negocia TLS 1.3, se utiliza un conjunto separado de suites de cifrado. Estas se configuran mediante `--tls-ciphersuites` y usan las convenciones de nomenclatura de OpenSSL:

- `TLS_AES_256_GCM_SHA384`
- `TLS_AES_128_GCM_SHA256`
- `TLS_CHACHA20_POLY1305_SHA256`

Por defecto, las tres suites de cifrado están habilitadas. Las suites de cifrado TLS 1.3 son más simples porque no incluyen el algoritmo de intercambio de claves (que se negocia por separado mediante key shares).

### Intercambio de claves

OpenVPN usaba históricamente parámetros DH de 2048 bits para el intercambio de claves. Este script solía ofrecer tanto DH (con tamaños de clave configurables) como ECDH como alternativas.

OpenVPN 2.4 añadió soporte para ECDH, y OpenVPN 2.7 hizo de `dh none` (ECDH) el valor predeterminado, ya que el DH de campo finito está en desuso. Dado que ECDH ahora es universalmente compatible y preferido, este script ya no ofrece DH tradicional.

El script configura `tls-groups` con la siguiente lista de preferencia:```
X25519:prime256v1:secp384r1:secp521r1