# Come leggere un link vmess://, vless://, ss:// o trojan://

HTML: https://v2rc.app/it/learn/read-a-config-link/ · Ultima revisione: 2026-11-06

Cosa significa ogni parte di un link di configurazione V2Ray, con esempi segnaposto per VLESS, VMess, Shadowsocks e Trojan, e perché un link è una credenziale.

Un link di configurazione racchiude in una sola riga tutto ciò che serve a un client: il server, la chiave e le impostazioni di trasporto. Saperlo leggere ti dice cosa ti è stato dato e perché una configurazione non funziona. Tutti gli esempi qui sotto usano segnaposto, non server reali.

## VLESS

```
vless://00000000-0000-0000-0000-000000000000@server.example:443?encryption=none&security=reality&sni=site.example&fp=chrome&pbk=PUBLIC_KEY&sid=SHORT_ID&type=tcp&flow=xtls-rprx-vision#my-config
```

| Parte | Significato |
|---|---|
| `00000000-…` | L’ID utente (UUID). È la chiave: chiunque lo abbia può usare il server. |
| `server.example:443` | Indirizzo e porta del server. |
| `encryption=none` | VLESS non cifra nulla da sé; è il livello di sicurezza a proteggere il traffico. |
| `security` | `none`, `tls` o `reality`. |
| `sni` | Il nome del server presentato nell’handshake TLS. Con REALITY è il sito reale che viene imitato. |
| `fp` | L’impronta TLS che il client imita, come `chrome`. |
| `pbk`, `sid` | Chiave pubblica e short ID di REALITY. Devono corrispondere esattamente al server. |
| `type` | Trasporto: `tcp`, `ws` (WebSocket), `grpc` e altri. |
| `flow` | `xtls-rprx-vision` è il flow Vision, usato con REALITY o TLS su TCP. |
| `path`, `host`, `serviceName` | Impostazioni del trasporto WebSocket o gRPC, quando viene usato. |
| `#my-config` | L’etichetta mostrata nella tua lista. |

## VMess

Un link `vmess://` è il prefisso seguito dal Base64 di un piccolo documento JSON. Decodificato, appare così:

```
{"v":"2","ps":"my-config","add":"server.example","port":"443","id":"00000000-0000-0000-0000-000000000000","aid":"0","scy":"auto","net":"ws","type":"none","host":"server.example","path":"/path","tls":"tls","sni":"server.example"}
```

`add` e `port` sono il server, `id` è l’UUID, `aid` è l’alter ID legacy (dovrebbe essere `0`), `net` è il trasporto, `host` e `path` riguardano WebSocket, `tls` attiva TLS e `ps` è l’etichetta. Per decodificarne uno a mano, prendi il testo dopo `vmess://` e passalo a `base64 -d`.

## Shadowsocks

```
ss://BASE64(method:password)@server.example:8388#my-config
```

La parte prima di `@` è il cifrario e la password, codificati in Base64. Usa un cifrario AEAD. I cifrari a flusso più vecchi come `rc4-md5` o `aes-256-cfb` sono deboli. Alcuni link più vecchi codificano in Base64 l’intera stringa `method:password@host:port`.

## Trojan

```
trojan://PASSWORD@server.example:443?security=tls&sni=server.example&type=tcp#my-config
```

La parte prima di `@` è la password. Trojan ha bisogno di TLS per proteggere il traffico, quindi `security=tls` dovrebbe esserci.

## Abbonamenti

L’URL di un abbonamento restituisce un elenco di link, di solito codificati in Base64, uno per riga. L’app lo scarica, lo decodifica e aggiunge ogni link. Quando un provider sostituisce i server bloccati, aggiornare l’abbonamento porta quelli nuovi.

## Errori che rompono un link

Il [decoder di link](https://v2rc.app/it/decoder/) controlla quelli più comuni:

- un UUID o una porta non validi;
- REALITY senza chiave pubblica o senza nome del server;
- VLESS o Trojan senza TLS;
- `allowInsecure` attivo, che disattiva i controlli del certificato;
- un cifrario Shadowsocks obsoleto;
- un alter ID VMess diverso da zero.

Un solo carattere sbagliato in `pbk` o `sid` fa fallire una configurazione REALITY senza alcun messaggio. Vedi [perché una connessione può riuscire e non caricare comunque nulla](https://v2rc.app/it/learn/russia/).

## Un link è una credenziale

L’UUID o la password dentro un link è la chiave del server. Chiunque abbia il link può usarlo, e su un server condiviso questo può consumare la tua quota. Non pubblicare i link in chat pubbliche; un link pubblico viene anche bloccato prima.

Il decoder di questo sito decodifica nella pagina e non invia nulla da nessuna parte: la pagina non effettua richieste di rete quando decodifica un link. Anche così, fai attenzione a qualsiasi strumento online in cui incolli un link. Puoi sempre decodificarne uno offline con `base64 -d`, come sopra.

## Fonti

- [Esempi di configurazione di Xray](https://github.com/XTLS/Xray-examples)
- [Documentazione di REALITY](https://github.com/XTLS/REALITY)
- [Descrizione del protocollo Trojan](https://trojan-gfw.github.io/trojan/protocol)
- [Shadowsocks SIP002](https://shadowsocks.org/doc/sip002.html), che definisce il formato dei link