# Como ler um link vmess://, vless://, ss:// ou trojan://

HTML: https://v2rc.app/pt/learn/read-a-config-link/ · Última revisão: 2026-11-06

O que cada parte de um link de configuração V2Ray significa, com exemplos fictícios para VLESS, VMess, Shadowsocks e Trojan, e por que um link é uma credencial.

Um link de configuração reúne em uma única linha tudo de que um cliente precisa: o servidor, a chave e os ajustes de transporte. Saber lê-lo mostra o que você recebeu e por que uma configuração falha. Todos os exemplos abaixo usam valores fictícios, não servidores reais.

## 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 | Significado |
|---|---|
| `00000000-…` | O ID de usuário (UUID). É a chave: quem a tem pode usar o servidor. |
| `server.example:443` | Endereço e porta do servidor. |
| `encryption=none` | O VLESS não faz criptografia própria; a camada de segurança protege o tráfego. |
| `security` | `none`, `tls` ou `reality`. |
| `sni` | O nome do servidor apresentado no handshake TLS. Com o REALITY, é o site real que está sendo imitado. |
| `fp` | A impressão digital TLS que o cliente imita, como `chrome`. |
| `pbk`, `sid` | Chave pública e short ID do REALITY. Os dois precisam coincidir exatamente com os do servidor. |
| `type` | Transporte: `tcp`, `ws` (WebSocket), `grpc` e outros. |
| `flow` | `xtls-rprx-vision` é o flow Vision, usado com REALITY ou com TLS sobre TCP. |
| `path`, `host`, `serviceName` | Ajustes do transporte WebSocket ou gRPC, quando usados. |
| `#my-config` | O rótulo mostrado na sua lista. |

## VMess

Um link `vmess://` é o prefixo seguido do Base64 de um pequeno documento JSON. Decodificado, ele fica assim:

```
{"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` são o servidor, `id` é o UUID, `aid` é o alter ID legado (deve ser `0`), `net` é o transporte, `host` e `path` pertencem ao WebSocket, `tls` ativa o TLS e `ps` é o rótulo. Para decodificar um link à mão, pegue o texto depois de `vmess://` e passe-o por `base64 -d`.

## Shadowsocks

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

A parte antes do `@` é a cifra e a senha, codificadas em Base64. Use uma cifra AEAD. Cifras de fluxo mais antigas, como `rc4-md5` ou `aes-256-cfb`, são fracas. Alguns links mais antigos codificam em Base64, em vez disso, o `method:password@host:port` inteiro.

## Trojan

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

A parte antes do `@` é a senha. O Trojan precisa de TLS para proteger o tráfego, então `security=tls` deve estar presente.

## Assinaturas

Uma URL de assinatura retorna uma lista de links, geralmente codificada em Base64, um por linha. O app a baixa, a decodifica e adiciona cada link. Quando um provedor substitui servidores bloqueados, atualizar a assinatura traz os novos.

## Erros que quebram um link

O [decodificador de links](https://v2rc.app/pt/decoder/) verifica os mais comuns:

- um UUID ou uma porta inválidos;
- REALITY sem chave pública ou sem nome de servidor;
- VLESS ou Trojan sem TLS;
- `allowInsecure` ativado, o que desliga a verificação de certificado;
- uma cifra Shadowsocks desatualizada;
- um alter ID do VMess diferente de zero.

Um caractere errado em `pbk` ou `sid` faz uma configuração REALITY falhar sem nenhuma mensagem. Veja [por que uma conexão pode ser bem-sucedida e mesmo assim não carregar nada](https://v2rc.app/pt/learn/russia/).

## Um link é uma credencial

O UUID ou a senha dentro de um link é a chave do servidor. Qualquer pessoa que tenha o link pode usá-lo, e em um servidor compartilhado isso pode consumir a sua cota. Não publique links em chats públicos; um link público também é bloqueado mais cedo.

O decodificador deste site decodifica na própria página e não envia nada a lugar nenhum: a página não faz nenhuma requisição de rede ao decodificar um link. Mesmo assim, tenha cuidado com qualquer ferramenta online em que você cole um link. Você sempre pode decodificar um link offline com `base64 -d`, como mostrado acima.

## Fontes

- [Exemplos de configuração do Xray](https://github.com/XTLS/Xray-examples)
- [Documentação do REALITY](https://github.com/XTLS/REALITY)
- [Descrição do protocolo Trojan](https://trojan-gfw.github.io/trojan/protocol)
- [Shadowsocks SIP002](https://shadowsocks.org/doc/sip002.html), que define o formato do link