Saltar al contenido principal

Requisitos del SDA Gateway

Sistemas operativos ​

Linux ​

El servicio SDA Glue para Linux está desarrollado sobre SoftEther VPN Client, utilizando la pila IP nativa de Linux e iptables para la gestión del firewall. Aunque el servicio puede funcionar en otras distribuciones de Linux, no se ha probado exhaustivamente en sistemas basados en nftables, como Red Hat Enterprise Linux. Para una compatibilidad y un soporte óptimos, recomendamos encarecidamente desplegar el Gateway en distribuciones basadas en Debian.

Requisitos del sistema:

  • Arquitectura: ARM, ARM64, i386 o AMD64
  • CPU y memoria: procesador de doble núcleo de 1 GHz como mínimo y 512 MB de RAM
  • Gestión de servicios: systemd
  • Versión del kernel: 5.6+
  • Distribución: distribuciones basadas en Debian o Ubuntu
  • Dependencias: SoftEther VPN Client (se instala automáticamente durante la configuración); OpenVPN (opcional, requiere instalación manual)

Windows ​

La implementación de SDA Glue para Windows utiliza el OpenVPN Community Client y depende de la traducción de direcciones de red de Windows (WinNAT/NetNat) para su funcionalidad de red. Tenga en cuenta que WinNAT puede no estar habilitado de forma predeterminada en todas las versiones de Windows y podría requerir una activación manual.

Requisitos del sistema:

  • Sistema operativo: Windows 10 Professional/Enterprise o Windows Server 2016 o posterior
  • Arquitectura: ARM, ARM64, i386 o AMD64
  • CPU y memoria: procesador de doble núcleo de 2 GHz como mínimo y 2 GB de RAM
  • Permisos: el servicio requiere permisos elevados para gestionar los recursos de red
  • Dependencias: OpenVPN Community Client (se instala automáticamente durante la configuración)
  • Funciones de red: WinNAT/NetNat (véanse las instrucciones de configuración a continuación)

Verificar WinNAT

Para comprobar si la función WinNAT está habilitada en su sistema:

  1. Abra PowerShell como Administrador
  2. Ejecute el siguiente comando:
Get-NetNat

Resultados esperados:

  • Función habilitada: el comando se ejecuta correctamente (puede devolver un resultado vacío si no existen configuraciones NAT)
  • Función deshabilitada: se muestra el mensaje de error "Get-NetNat : Invalid class"

Habilitar WinNAT

Si WinNAT no está habilitado, siga estos pasos para activarlo:

  1. Abra PowerShell como Administrador
  2. Ejecute los siguientes comandos:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
  1. Reinicie el equipo tras una ejecución correcta
  2. Verifique la activación ejecutando Get-NetNat de nuevo

Docker y Kubernetes ​

SDA Glue puede desplegarse en entornos de contenedores con requisitos de configuración específicos para habilitar la funcionalidad VPN. El servicio requiere acceso al dispositivo TUN del host y capacidades de administración de red para establecer túneles seguros.

Requisitos del sistema:

  • Arquitectura del host: ARM64 o AMD64
  • Acceso al dispositivo TUN: --device=/dev/net/tun — acceso a la interfaz de túnel de red virtual
  • Capacidades de red: --cap-add=NET_ADMIN — configuración de interfaces de red y gestión de enrutamiento

Dispositivo TUN (/dev/net/tun): la interfaz TUN es un dispositivo de red virtual que opera en la capa 3 (nivel IP) de la pila de red y que los clientes VPN utilizan habitualmente para establecer túneles seguros. Los clientes VPN emplean dispositivos TUN para cifrar los datos antes de reenviarlos a través del servidor VPN mediante el túnel. Sin acceso a este dispositivo, SDA Glue en contenedor no puede crear los túneles de red necesarios para la conectividad.

Capacidad NET_ADMIN: esta capacidad de Linux permite al contenedor realizar operaciones relacionadas con la red, incluidas la configuración de interfaces, la modificación de la tabla de enrutamiento y la gestión del firewall. Los contenedores VPN requieren la capacidad NET_ADMIN para gestionar los recursos de red y establecer un enrutamiento adecuado que permita comunicaciones seguras con los servicios de SDA Cloud.

 docker run -d \
   --name glue \
   --restart always \
   --device=/dev/net/tun \
   -p 8080:8080 \
   -v glue-data:/var/lib/sdaglue \
   --cap-add=NET_ADMIN \
   public.ecr.aws/t9c5s2d1/sdaglue:latest

Detalles completos del despliegue, ejemplos de configuración y guía para la resolución de problemas.