Passa al contenuto principale

Requisiti del Gateway SDA

Sistemi operativi ​

Linux ​

Il servizio SDA Glue per Linux è basato su SoftEther VPN Client e utilizza lo stack IP nativo di Linux e iptables per la gestione del firewall. Sebbene il servizio possa funzionare su altre distribuzioni Linux, non è stato testato in modo approfondito su sistemi basati su nftables come Red Hat Enterprise Linux. Per garantire compatibilità e supporto ottimali, raccomandiamo vivamente di installare il Gateway su distribuzioni basate su Debian.

Requisiti di sistema:

  • Architettura: ARM, ARM64, i386 o AMD64
  • CPU e memoria: processore Dual-Core da almeno 1 GHz e 512 MB di RAM
  • Gestione dei servizi: systemd
  • Versione del kernel: 5.6+
  • Distribuzione: distribuzioni basate su Debian o Ubuntu
  • Dipendenze: SoftEther VPN Client (installato automaticamente durante la configurazione); OpenVPN (opzionale, richiede installazione manuale)

Windows ​

L'implementazione Windows di SDA Glue utilizza OpenVPN Community Client e dipende da Windows Network Address Translation (WinNAT/NetNat) per le funzionalità di rete. Si noti che WinNAT potrebbe non essere abilitato per impostazione predefinita su tutte le versioni di Windows e potrebbe richiedere un'attivazione manuale.

Requisiti di sistema:

  • Sistema operativo: Windows 10 Professional/Enterprise o Windows Server 2016 o versioni successive
  • Architettura: ARM, ARM64, i386 o AMD64
  • CPU e memoria: processore Dual-Core da almeno 2 GHz e 2 GB di RAM
  • Autorizzazioni: il servizio richiede autorizzazioni elevate per gestire le risorse di rete
  • Dipendenze: OpenVPN Community Client (installato automaticamente durante la configurazione)
  • Funzionalità di rete: WinNAT/NetNat (vedere le istruzioni di configurazione seguenti)

Verifica di WinNAT

Per verificare se la funzionalità WinNAT è abilitata sul sistema:

  1. Aprire PowerShell come amministratore
  2. Eseguire il comando seguente:
Get-NetNat

Risultati previsti:

  • Funzionalità abilitata: il comando viene eseguito correttamente (può restituire un risultato vuoto se non esistono configurazioni NAT)
  • Funzionalità disabilitata: viene visualizzato il messaggio di errore "Get-NetNat : Invalid class"

Abilitazione di WinNAT

Se WinNAT non è abilitato, seguire questi passaggi per attivarlo:

  1. Aprire PowerShell come amministratore
  2. Eseguire i comandi seguenti:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
  1. Riavviare il computer dopo l'esecuzione completata con successo
  2. Verificare l'attivazione eseguendo di nuovo Get-NetNat

Docker e Kubernetes ​

SDA Glue può essere distribuito in ambienti containerizzati con requisiti di configurazione specifici per abilitare le funzionalità VPN. Il servizio richiede l'accesso al dispositivo TUN dell'host e alle funzionalità di amministrazione di rete per stabilire tunnel sicuri.

Requisiti di sistema:

  • Architettura dell'host: ARM64 o AMD64
  • Accesso al dispositivo TUN: --device=/dev/net/tun — accesso all'interfaccia del tunnel di rete virtuale
  • Funzionalità di rete: --cap-add=NET_ADMIN — configurazione dell'interfaccia di rete e gestione del routing

Dispositivo TUN (/dev/net/tun): l'interfaccia TUN è un dispositivo di rete virtuale che opera al livello 3 (livello IP) dello stack di rete, comunemente utilizzato dai client VPN per stabilire tunnel sicuri. I client VPN utilizzano i dispositivi TUN per cifrare i dati prima di inoltrarli attraverso il server VPN tramite il tunnel. Senza l'accesso a questo dispositivo, SDA Glue containerizzato non può creare i tunnel di rete necessari per la connettività.

Funzionalità NET_ADMIN: questa capability di Linux consente al container di eseguire operazioni relative alla rete, tra cui la configurazione delle interfacce, la modifica della tabella di routing e la gestione del firewall. I container VPN richiedono la capability NET_ADMIN per gestire le risorse di rete e stabilire un routing corretto per comunicazioni sicure con i servizi 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

Dettagli completi sulla distribuzione, esempi di configurazione e guida alla risoluzione dei problemi.