VERTLINK · ANALIZZATORE DI RETE
===============================

Contenuto della cartella
------------------------
vertlink.html              La dashboard. Si apre con un doppio clic in Chrome, Edge o Firefox.
                           Con il selettore IT / EN in alto cambi lingua.
agent/                     L'agente locale, un file per ogni sistema:
  vertlink-agent-windows-amd64.exe     Windows (quasi tutti i PC)
  vertlink-agent-windows-arm64.exe     Windows su processore ARM (es. alcuni Surface)
  vertlink-agent-mac-apple-silicon     Mac con chip M1, M2, M3, M4
  vertlink-agent-mac-intel             Mac con processore Intel
  vertlink-agent-linux-amd64           Linux su PC
  vertlink-agent-linux-arm64           Linux su ARM (es. Raspberry Pi 4 e 5)
source/                    Il codice dell'agente (Go), per controllarlo o ricompilarlo.
README.txt                 Queste istruzioni in inglese.

VERTLINK funziona anche senza agente. L'agente aggiunge: traffico reale della
scheda di rete, connessioni e dispositivi aggiornati da soli, segnale Wi-Fi nel
tempo e misure di latenza che continuano anche a pagina chiusa.


Avviare l'agente
----------------
WINDOWS
  1. Doppio clic su vertlink-agent-windows-amd64.exe.
  2. Se compare "Windows ha protetto il PC": Ulteriori informazioni > Esegui comunque.
  3. Si apre una finestra con il TOKEN. Lasciala aperta.
  Per vedere i nomi di tutti i programmi: clic destro > Esegui come amministratore.

MACOS
  1. Apri il Terminale e spostati nella cartella "agent"
     (scrivi "cd ", trascina la cartella nella finestra, premi Invio).
  2. Mac con chip Apple:
       chmod +x vertlink-agent-mac-apple-silicon
       xattr -d com.apple.quarantine vertlink-agent-mac-apple-silicon
       ./vertlink-agent-mac-apple-silicon
     Mac Intel: stessi comandi con vertlink-agent-mac-intel.
  Il comando xattr toglie il blocco che macOS applica ai file scaricati e non firmati.

LINUX
       chmod +x vertlink-agent-linux-amd64
       ./vertlink-agent-linux-amd64
  Con sudo vedi anche i processi degli altri utenti.

I messaggi dell'agente seguono la lingua del sistema (italiano o inglese).


Collegare VERTLINK
------------------
Apri vertlink.html: nella Panoramica, riquadro "Agente locale", incolla il token
e premi Collega. Il token si inserisce una volta sola. Se il browser chiede il
permesso di accedere ad altri servizi su questo dispositivo, concedilo.


Sicurezza e dati
----------------
- L'agente ascolta solo su questo computer (http://127.0.0.1:8765) e risponde
  soltanto a chi conosce il token. Dagli altri dispositivi non è raggiungibile.
- Legge soltanto: non modifica impostazioni e non invia dati a nessun server.
  Per misurare la latenza apre brevi connessioni verso 1.1.1.1 e 8.8.8.8.
- Token e storico (ultimi 7 giorni) stanno nella cartella "vertlink-agent" dentro
  la cartella delle impostazioni utente, mostrata nella finestra dell'agente.
- Per fermarlo basta chiudere la sua finestra.

Usa la scansione della rete e le catture solo sulla tua rete, o con il permesso
di chi la gestisce.


Verificare i file
-----------------
SHA256SUMS.txt contiene l'impronta SHA-256 di ogni agente. Scarica gli agenti
solo da https://draxarden.github.io/vertlink/ e confronta:
  Windows (PowerShell):  Get-FileHash .\agent\vertlink-agent-windows-amd64.exe
  macOS:                 shasum -a 256 agent/vertlink-agent-mac-apple-silicon
  Linux:                 cd agent && sha256sum -c ../SHA256SUMS.txt

Licenza: MIT (LICENSE.txt). VERTLINK è fornito così com'è, senza garanzie.
