Pular para o conteúdo principal

Requisitos do SDA Gateway

Sistemas Operacionais ​

Linux ​

O serviço SDA Glue para Linux é baseado no SoftEther VPN Client, utilizando a pilha IP nativa do Linux e o iptables para o gerenciamento de firewall. Embora o serviço possa funcionar em outras distribuições Linux, ele não foi amplamente testado em sistemas baseados em nftables, como o Red Hat Enterprise Linux. Para compatibilidade e suporte ideais, recomendamos fortemente a implantação do Gateway em distribuições baseadas em Debian.

Requisitos de Sistema:

  • Arquitetura: ARM, ARM64, i386 ou AMD64
  • CPU e Memória: Processador Dual-Core de no mínimo 1 GHz e 512 MB de RAM
  • Gerenciamento de Serviços: systemd
  • Versão do Kernel: 5.6+
  • Distribuição: distribuições baseadas em Debian ou Ubuntu
  • Dependências: SoftEther VPN Client (instalado automaticamente durante a configuração); OpenVPN (opcional, requer instalação manual)

Windows ​

A implementação do SDA Glue para Windows utiliza o OpenVPN Community Client e depende do Windows Network Address Translation (WinNAT/NetNat) para a funcionalidade de rede. Observe que o WinNAT pode não estar habilitado por padrão em todas as versões do Windows e pode exigir ativação manual.

Requisitos de Sistema:

  • Sistema Operacional: Windows 10 Professional/Enterprise ou Windows Server 2016 ou posterior
  • Arquitetura: ARM, ARM64, i386 ou AMD64
  • CPU e Memória: Processador Dual-Core de no mínimo 2 GHz e 2 GB de RAM
  • Permissões: o serviço requer permissões elevadas para gerenciar recursos de rede
  • Dependências: OpenVPN Community Client (instalado automaticamente durante a configuração)
  • Recursos de Rede: WinNAT/NetNat (consulte as instruções de configuração abaixo)

Verificar o WinNAT

Para verificar se o recurso WinNAT está habilitado em seu sistema:

  1. Abra o PowerShell como Administrador
  2. Execute o seguinte comando:
Get-NetNat

Resultados Esperados:

  • Recurso Habilitado: o comando é executado com sucesso (pode retornar um resultado vazio se não houver configurações de NAT)
  • Recurso Desabilitado: é exibida a mensagem de erro "Get-NetNat : Invalid class"

Habilitando o WinNAT

Se o WinNAT não estiver habilitado, siga estas etapas para ativá-lo:

  1. Abra o PowerShell como Administrador
  2. Execute os seguintes comandos:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
  1. Reinicie o computador após a execução bem-sucedida
  2. Verifique a ativação executando Get-NetNat novamente

Docker e Kubernetes ​

O SDA Glue pode ser implantado em ambientes conteinerizados com requisitos de configuração específicos para habilitar a funcionalidade de VPN. O serviço requer acesso ao dispositivo TUN do host e a capacidades de administração de rede para estabelecer túneis seguros.

Requisitos de Sistema:

  • Arquitetura do Host: ARM64 ou AMD64
  • Acesso ao Dispositivo TUN: --device=/dev/net/tun — acesso à interface de túnel de rede virtual
  • Capacidades de Rede: --cap-add=NET_ADMIN — configuração de interfaces de rede e gerenciamento de roteamento

Dispositivo TUN (/dev/net/tun): A interface TUN é um dispositivo de rede virtual que opera na camada 3 (nível IP) da pilha de rede, comumente utilizado por clientes VPN para estabelecer túneis seguros. Os clientes VPN usam dispositivos TUN para criptografar os dados antes de encaminhá-los pelo servidor VPN através do túnel. Sem acesso a esse dispositivo, o SDA Glue conteinerizado não consegue criar os túneis de rede necessários para a conectividade.

Capacidade NET_ADMIN: Essa capacidade do Linux permite que o contêiner realize operações relacionadas à rede, incluindo configuração de interfaces, modificação da tabela de roteamento e gerenciamento de firewall. Contêineres de VPN exigem a capacidade NET_ADMIN para gerenciar recursos de rede e estabelecer o roteamento adequado para comunicações seguras com os serviços do 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

Detalhes completos de implantação, exemplos de configuração e orientações para solução de problemas.