Risoluzione dei problemi — Accesso remoto

Questa guida illustra i problemi più comuni che possono verificarsi durante la configurazione o l'utilizzo dell'accesso remoto tramite Eziwan Gateway. Per ogni problema sono indicate le cause probabili e i passaggi necessari per risolverlo.

Problema 1: Il tunnel VPN OpenVPN/IPSec non si stabilisce​

Sintomo: Il gateway risulta offline nella dashboard di Eziwan, oppure lo stato del tunnel rimane su "Connecting" da più di 2 minuti.

Possibili cause​

CausaProbabilitàCome verificare
Scheda SIM senza dati attivi🔴 Molto frequenteLED SIM rosso sul gateway
APN dell'operatore errato🟠 FrequenteLog SIM nella console web
Firewall che blocca la porta UDP 1194🟠 FrequenteTest da un'altra rete
Gateway non alimentato correttamente🟡 OccasionaleLED PWR spento o lampeggiante
Account Eziwan Cloud scaduto🟡 OccasionaleVerificare lo stato dell’abbonamento
Conflitto di indirizzi IP OpenVPN🔵 RaroLog OpenVPN sul gateway

Risoluzione passo dopo passo​

Fase 1 — Verificare l'alimentazione

Verificare che il LED PWR sia acceso con luce verde fissa. Il gateway richiede un'alimentazione stabilizzata compresa tra 9 V CC e 36 V CC. Un'alimentazione sottodimensionata o soggetta a disturbi può causare riavvii indesiderati.

LED PWR : vert fixe     → Alimentation OK
LED PWR : orange        → Tension limite (< 10V ou > 34V)
LED PWR: spento → Nessuna alimentazione

Fase 2 — Verifica della connettività 4G

Controllare i LED SIM1 e SIM2:

LED SIM: verde fisso     → Connessa e dati attivi
LED SIM: verde lampeggiante → Registrata, nessun dato
LED SIM: rosso fisso    → SIM non riconosciuta o PIN richiesto
LED SIM: spento → Nessuna SIM inserita

Se il LED SIM lampeggia in verde: controllare l'APN nelle impostazioni di rete del gateway. Contattare il proprio operatore per ottenere l'APN corretto.

Fase 3 — Verifica del firewall di rete

OpenVPN utilizza la porta UDP 1194 in uscita. Verificate che nessun firewall aziendale o proxy blocchi questo traffico in uscita.

# Test effettuato da un PC collegato alla stessa rete del gateway
nc -zvu cloud.eziwan.com 1194
# Risultato atteso: "Connessione a cloud.eziwan.com sulla porta 1194 [udp] riuscita!"

Se questo test non va a buon fine, contattare il proprio responsabile IT per aprire la porta UDP 1194 in uscita verso cloud.eziwan.com.

Fase 4 — Verificare i log di OpenVPN

Dalla console web del gateway (http://192.168.1.1 per impostazione predefinita):

Menu : Diagnostics → Logs → OpenVPN

Errori frequenti nei log:

Messaggio di logSignificatoAzione
Invalid handshakeChiavi OpenVPN danneggiateReimpostare le chiavi dal cloud
No route to hostRisoluzione DNS non riuscitaVerificare il DNS primario (8.8.8.8)
Handshake timeoutIl firewall blocca la porta UDP 1194Aprire la porta UDP 1194 in uscita
peer is unreachableCloud Eziwan non accessibileVerificare lo stato di cloud.eziwan.com

Problema 2: Elevata latenza nel tunnel VPN​

Sintomo: Le connessioni tramite il tunnel funzionano, ma sono lente (latenza > 500 ms, velocità < 1 Mbps).

Cause e soluzioni​

Causa 1: Segnale 4G debole

Misurare l'RSRP dalla console web:

Menu: Rete → Stato cellulare → Segnale

Valori di riferimento:

RSRP (dBm)Qualità del segnaleAzione
> -80EccellenteNessuna azione
da -80 a -95BuonaVerificare l'orientamento dell'antenna
da -95 a -105DiscretaSi consiglia un'antenna esterna
< -105ScarsaRiposizionare o utilizzare un'antenna esterna

Causa 2: MTU troppo alto

OpenVPN incapsula i pacchetti. Se l'MTU dell'interfaccia OpenVPN è troppo grande, la frammentazione IP causa latenza. Valore consigliato:

MTU OpenVPN : 1380 bytes (vs 1500 bytes Ethernet standard)

Modificare nella configurazione OpenVPN del gateway:

# file .ovpn del gateway
tun-mtu 1380
mssfix 1340

Causa 3: Sovraccarico della larghezza di banda 4G

Se sono attivi contemporaneamente più flussi MQTT + VPN + monitoraggio, assegnare la priorità al traffico VPN tramite QoS:

Menu: Rete → QoS → Priorità VPN: Alta

Problema 3: Frequenti interruzioni della connessione al tunnel​

Sintomo: Il tunnel VPN si interrompe ogni X minuti o ore e si ristabilisce automaticamente.

Verifica del keepalive di OpenVPN​

Per impostazione predefinita, OpenVPN invia un ping di keepalive a intervalli regolari per mantenere attive le tabelle NAT. Alcuni operatori 4G hanno timeout NAT più ristretti (< 20 s). Soluzione: ridurre l'intervallo nella configurazione .ovpn:

# ping ogni 10 secondi, riavvio del tunnel dopo 60 secondi senza risposta
keepalive 10 60

Ridurre il ping di keepalive a 10 s risolve il 95% delle disconnessioni legate alle tabelle NAT dell'operatore.

Verifica del watchdog​

Il gateway Eziwan è dotato di un watchdog hardware e software. Se il gateway si riavvia ogni X minuti:

Menu: Diagnostica → Log di sistema → Filtra "watchdog"

Un riavvio del watchdog può indicare un surriscaldamento o un picco di carico della CPU. Verificare che la temperatura dell'armadio elettrico non superi i 65 °C (temperatura massima di esercizio: +75 °C).

Problema 4: Impossibile raggiungere il controllore tramite il tunnel​

Sintomo: Il tunnel VPN è attivo (gateway "online"), ma le connessioni ai dispositivi OT (controllori logici, HMI) non vanno a buon fine.

Lista di controllo diagnostica​

1. Verificare gli indirizzi IP

Dal proprio PC, con il client OpenVPN connesso, verificare che il percorso verso la rete OT sia effettivamente presente:

# Windows
route print | findstr 192.168.
# Linux/Mac
ip route show

Il percorso verso la rete OT (ad es.: 192.168.100.0/24) deve puntare all'interfaccia OpenVPN (tun0).

2. Verificare che non vi siano conflitti tra gli indirizzi IP

Se la vostra rete locale (ufficio, telelavoro) utilizza la stessa sottorete della rete OT remota, si verificherà un conflitto di routing.

Rete locale (PC)Rete OT remotaConflitto
192.168.1.0/24192.168.100.0/24❌ No
192.168.1.0/24192.168.1.0/24✅ Sì — rinominare uno dei due

3. Verificare il firewall locale del controllore

Alcuni controllori (in particolare i modelli Siemens S7-1200/1500) dispongono di un firewall integrato. Verificare in TIA Portal:

TIA Portal → PLC Properties → Protection & Security → Connection Mechanisms

Consentire le connessioni dall'indirizzo IP dell'interfaccia VPN del gateway (in genere 10.10.0.x).

4. Verificare con un ping

Dal proprio PC, tramite il tunnel VPN attivo:

ping 192.168.100.1  # IP del PLC
ping 192.168.100.1 -l 64  # Ping avec payload 64 bytes

Se il ping risponde ma un'applicazione (TIA Portal, Step 7) non funziona, il problema è dovuto a una porta specifica dell'applicazione (Siemens S7Comm: TCP 102; Modbus TCP: TCP 502).

Problema 5: L'autenticazione 2FA non va a buon fine​

Sintomo: Il codice TOTP (Google Authenticator, Authy) viene rifiutato al momento dell'accesso.

Cause e soluzioni​

CausaSoluzione
Orologio del PC sfasato di > 30 sSincronizzare l'ora NTP del PC
Codice TOTP scaduto (validità 30 s)Inserirlo immediatamente dopo la generazione
Account 2FA erratoVerificare che nell'app sia selezionato l'account corretto
Applicazione 2FA reimpostataEseguire nuovamente la scansione del codice QR dal portale Eziwan

Per risincronizzare l'ora NTP su Windows:

w32tm /resync /force

Per riconfigurare l'autenticazione a due fattori (2FA) di un utente (è richiesta l'autorizzazione di amministratore):

Portale Eziwan → Utenti → [Nome tecnico] → Sicurezza → Reimposta 2FA

Lista di controllo completa per la diagnosi (10 passaggi)​

Segui questi passaggi nell'ordine indicato prima di contattare l'assistenza:

  • 1. LED PWR verde fisso — alimentazione corretta
  • 2. LED SIM1 o SIM2 verde fisso — dati 4G attivi
  • 3. RSRP > -105 dBm — segnale sufficiente
  • 4. Porta UDP 1194 in uscita non bloccata dalla rete del gateway
  • 5. Il DNS risolve cloud.eziwan.com dalla rete del gateway
  • 6. Nessun conflitto di indirizzi IP tra rete locale e rete OT
  • 7. Percorsi VPN presenti sul PC client
  • 8. Il firewall del PLC autorizza le connessioni dall'IP VPN
  • 9. Orologio del PC sincronizzato (< 30 s di scostamento)
  • 10. Account Eziwan Cloud attivo, abbonamento aggiornato

Contatta l'assistenza Eziwan​

Se il problema persiste dopo aver seguito questa lista di controllo:

  1. Esportare i log di diagnostica: Menu → Diagnostica → Esporta log (file .tar.gz)
  2. Aprire un ticket su support.eziwan.com allegando il file dei log
  3. Specificare: modello del gateway, versione del firmware, operatore SIM, descrizione esatta del problema

L'assistenza tecnica di Eziwan risponde entro < 4 ore lavorative per i partner e entro < 24 ore per gli altri clienti.

Domande frequenti​

Il tunnel VPN non si stabilizza, da dove comincio?​

Verificate innanzitutto la connettività del gateway (stato 4G/Ethernet nella console), poi l'orologio dell'apparecchiatura (uno scostamento significativo invalida i certificati) e infine che il firewall del sito consenta il traffico in uscita su UDP 1194 o TCP 443.

Vedo che il gateway è online, ma non il PLC collegato?​

Si tratta quasi sempre di un problema di routing locale: il PLC deve avere il gateway Eziwan come gateway predefinito (o una rotta statica verso la sottorete VPN), e il suo indirizzo IP deve appartenere alla sottorete specificata nella console.

La sessione remota è lenta: cosa controllare?​

Prima il segnale 4G (RSRP < -110 dBm = connessione compromessa), poi il carico della connessione (è in corso un trasferimento di grandi dimensioni?). Le console del produttore caricate (TIA Portal) traggono vantaggio dall'attivazione della compressione nel profilo VPN.

Un certificato scaduto blocca la connessione: come rinnovarlo?​

Dalla console: la rotazione dei certificati avviene da remoto senza bisogno di spostarsi, e il rinnovo automatico prima della scadenza si attiva nelle impostazioni della flotta per evitare il ripetersi del problema.

Risorse correlate​