Proxy no Telegram: como configurar SOCKS5 e MTProto

Você tem um proxy em mãos: endereço do servidor, porta, usuário e senha. Quer colocar esses dados no Telegram, mas a opção não fica onde a maioria das pessoas procura primeiro. Ela não está em Privacidade nem no menu de rede do celular: fica dentro de Dados e Armazenamento. Depois de encontrar a linha, aparecem duas opções, SOCKS5 e MTProto. Se você não sabe qual escolher, é fácil digitar os dados no formulário errado, e o resultado é um "Conectando..." no topo da tela que não some.

Neste artigo explicamos como o Telegram usa um proxy, a diferença entre SOCKS5 e MTProto, o passo a passo no Android, no iPhone e no desktop, o que verificar quando o aplicativo fica parado em "Conectando..." e como desativar o proxy. Os nomes dos menus estão escritos como aparecem na tradução oficial do Telegram para o português do Brasil. A configuração não exige código; o único exemplo de código, voltado a quem desenvolve bots, está na seção "nível avançado", no final.

Para que serve a configuração de proxy do Telegram?#

Um proxy é um servidor intermediário que fica entre você e o Telegram. Em vez de enviar suas mensagens direto ao Telegram, o aplicativo envia primeiro ao proxy, e o proxy repassa. Os servidores do Telegram enxergam o endereço IP do proxy, não o seu. A base do conceito está no nosso artigo O que é um servidor proxy e como ele funciona?.

O Telegram está disponível sem restrições na maioria dos países, como o Brasil e a Türkiye, então a maior parte dos usuários não precisa de proxy. Ele ajuda nestes casos:

• Rede de empresa, hotel ou campus. Algumas redes só liberam a saída para a internet por um proxy específico. Enquanto o Telegram não conhecer esse proxy, o aplicativo fica em "Conectando...".
• Privacidade do IP. Se você prefere que o IP de conexão não seja o da sua casa ou do seu escritório, pode passar o tráfego por um proxy que você controla.
• Desenvolvimento de bots e integrações. Talvez você queira que o bot do seu servidor chegue ao Telegram sempre pelo mesmo endereço IP. Explicamos a lógica em IP estático para acesso a API.

Essa configuração afeta só o Telegram; o navegador e os demais aplicativos continuam usando a própria conexão. O proxy das configurações de sistema do celular é outro assunto, tratado em Configurações de proxy no Android e Como configurar proxy no iPhone e no iPad. Já a diferença para a VPN, que criptografa todo o tráfego do aparelho, está em Diferença entre proxy e VPN.

Quais tipos de proxy o Telegram aceita?#

Segundo a documentação oficial de proxy do Telegram, os aplicativos aceitam dois tipos: SOCKS5 e MTProto. Alguns oferecem um tipo extra; a lista do Telegram Desktop, por exemplo, também traz HTTP. Nos aplicativos para celular há apenas SOCKS5 e MTProto.

SOCKS5 é um protocolo de proxy de uso geral. Ele consegue transportar o tráfego de qualquer aplicativo, do navegador ao jogo. O protocolo é definido na RFC 1928, e a autenticação com usuário e senha, na RFC 1929. O Telegram aceita essa autenticação diretamente: o formulário tem dois campos separados para usuário e senha. Alguns aplicativos só aceitam SOCKS5 sem credenciais, então esse detalhe facilita a sua vida. O protocolo em si está explicado em Proxies SOCKS5: como funcionam e no que diferem, e a diferença para o proxy HTTP em Diferença entre SOCKS e HTTP proxy.

O proxy MTProto (nome oficial: MTProxy) foi escrito só para o Telegram. MTProto é o nome do protocolo que os aplicativos do Telegram usam para falar com os servidores. Um proxy MTProto recebe esse tráfego, disfarça de um jeito que dificulta o reconhecimento e encaminha ao Telegram. Não dá para usá-lo em nenhum outro aplicativo. No lugar de usuário e senha, ele pede uma única chave chamada "secret"; na interface em português o campo se chama Segredo. O software do servidor é de código aberto e fica no repositório do Telegram no GitHub.

Qual é a diferença entre SOCKS5 e MTProto?#

Sendo claros sobre a última linha: a Proxynet não vende proxy MTProto. O Proxies SOCKS5 que oferecemos entra no formulário SOCKS5 do Telegram do jeito que está e funciona com os mesmos dados nos seus outros aplicativos.

Há um ponto comum aos dois tipos. O tráfego do Telegram sai criptografado do aplicativo e chega criptografado ao proxy. A documentação do Telegram afirma que quem opera um proxy MTProto não consegue ler suas mensagens nem identificar sua conta, mas pode registrar seu endereço IP, já que você se conecta ao servidor dele. A mesma criptografia vale para o tráfego que passa por SOCKS5. Ou seja, escolher um proxy é menos uma questão de privacidade do conteúdo e mais a pergunta "para quem estou mostrando meu endereço IP?".

De quais dados você precisa antes de começar?#

Para SOCKS5 são quatro dados: endereço do servidor, porta, usuário e senha. Eles aparecem no painel do serviço em que você obteve o proxy. Os provedores costumam entregar os quatro em uma linha só, no formato servidor:porta:usuário:senha; no Telegram, cada parte vai no seu próprio campo. Explicamos o que é cada um em Endereço do servidor proxy: o que é e como encontrar.

Preste atenção em dois detalhes:

1. Use a porta de SOCKS5. Alguns planos trazem portas diferentes para HTTP e SOCKS5. Os aplicativos do Telegram para celular não aceitam proxy HTTP; com a porta HTTP a conexão não é estabelecida.
2. Escolha a autenticação por usuário e senha. Se o seu proxy funciona só com whitelist de IP, o endereço IP muda assim que o celular passa para os dados móveis, e o proxy deixa de reconhecer você. Comparamos os dois métodos em Autenticação de proxy: user:pass ou whitelist de IP.

Nos exemplos abaixo, o servidor é pr.proxynet.io, a porta é 8000, o usuário é user e a senha é pass. Você vai digitar os valores do seu próprio painel.

Como configurar o proxy do Telegram no Android?#

1. Abra o Telegram e entre em Configurações.
2. Toque em Dados e Armazenamento.
3. Nessa página, abra a linha Configurações de Proxy.
4. Toque em Adicionar Proxy.
5. Escolha Proxy SOCKS5 como tipo. A outra opção é Proxy MTProto; se aparecer um campo "Segredo" na tela, você está no tipo errado.
6. Digite o endereço em Servidor, a porta em Porta e as credenciais em Nome de Usuário e Senha.
7. Salve. De volta à lista, confira se a chave Usar Proxy está ligada.

Embaixo do proxy adicionado aparece primeiro "Verificando...", depois "Disponível" ou "Conectado". Se aparecer "Indisponível", o Telegram não está alcançando o servidor; siga para a lista de diagnóstico mais abaixo.

Na mesma tela há outra chave, chamada Usar Proxy Para Chamadas. Falamos dela na seção sobre chamadas.

Como configurar o proxy do Telegram no iPhone?#

1. Abra o Telegram e vá para a aba Configurações.
2. Entre em Dados e Armazenamento.
3. Nessa página, toque na linha Proxy. Se não houver proxy definido, aparece "Desativado" ao lado.
4. Toque em Adicionar Proxy.
5. No cabeçalho TIPO, escolha SOCKS5.
6. Preencha Servidor e Porta no cabeçalho CONEXÃO.
7. Digite Nome de Usuário e Senha no cabeçalho CREDENCIAIS (OPCIONAL).
8. Salve e confira se a chave Usar Proxy está ligada.

Embaixo do proxy salvo aparecem "conectado" e o tempo de ping em milissegundos. Se aparecer "indisponível", há algum problema nos dados ou na rede. Se você copiou os dados do proxy como um link t.me/socks, a opção Colar, na mesma tela, preenche os campos para você.

No aplicativo do Telegram para Mac, a configuração também fica em Configurações > Dados e Armazenamento, na seção Proxy; os campos de tipo, servidor, porta, usuário e senha têm os mesmos nomes do iPhone.

Como configurar o proxy no Telegram Desktop?#

No Telegram Desktop, que roda em Windows, Linux e macOS, o caminho é um pouco diferente:

1. Abra Configurações pelo menu do aplicativo.
2. Entre em Avançado.
3. Clique na linha Tipo de conexão. A janela "Configurações de proxy" se abre.
4. Clique em Adicionar proxy.
5. Marque SOCKS5 entre as opções de tipo. A lista também traz HTTP e MTPROTO.
6. Digite o endereço do servidor em Nome do host e a porta em Porta.
7. Preencha Usuário e Senha no cabeçalho Credenciais (opcional).
8. Clique em Salvar. Confira se a opção Proxy personalizado está marcada na janela.

Ao lado de um proxy que funciona aparece "online" ou "disponível" com um valor de ping; o proxy que não pode ser alcançado fica marcado como "não disponível". Na mesma janela há três opções: Desativar proxy, Configurações de proxy do sistema e Proxy personalizado. A do meio é exclusiva do Telegram Desktop e faz o aplicativo usar o proxy de sistema definido no Windows ou no macOS. Se no computador do trabalho o proxy já estiver definido nas configurações do sistema, essa opção pode bastar.

Configuração em um toque com o link de proxy#

O Telegram também aceita os dados do proxy em forma de link. Para SOCKS5 o formato é este:

https://t.me/socks?server=pr.proxynet.io&port=8000&user=user&pass=pass

Ao tocar nesse link em um aparelho com o Telegram instalado, o aplicativo mostra os dados e pergunta se você quer adicionar o proxy. Os links de MTProto têm o formato t.me/proxy?server=…&port=…&secret=….

O link é o jeito rápido de levar os dados para o seu segundo aparelho: envie para você mesmo em "Mensagens Salvas" e toque nele no outro aparelho. Só que a senha fica escrita no link em texto puro. Não compartilhe em grupos nem em canais; quem vir o link consegue usar o seu proxy.

Chamadas de voz e de vídeo passam pelo proxy?#

Por padrão, não. A configuração de proxy cobre mensagens, mídia e arquivos. As chamadas têm uma chave separada, que vem desligada nos três aplicativos: Usar Proxy Para Chamadas no Android, Usar para chamadas no iPhone e Usar proxy para chamadas no Desktop. No Android, essa chave não aparece na lista quando o proxy ativo é do tipo MTProto. O Telegram coloca o próprio aviso embaixo da chave: servidores proxy podem diminuir a qualidade de suas chamadas.

O motivo está no funcionamento das chamadas. Segundo a documentação de chamadas do Telegram, os pacotes de voz são enviados por UDP; direto para a outra parte quando possível e, quando não, para os servidores de retransmissão do Telegram. UDP é um transporte rápido, que envia o pacote sem esperar para saber se ele chegou. Nem todo proxy transporta UDP, e nos que transportam cada parada no caminho acrescenta atraso. O detalhe está na seção "Proxy e UDP" de Diferença entre TCP e UDP. Se as suas chamadas estão boas, deixe a chave desligada; se o som começar a cortar depois de ligá-la, desligue de novo.

Listas gratuitas de MTProto e canais de proxy são seguros?#

Quem pesquisa "Telegram proxy" encontra listas gratuitas de MTProto e canais que compartilham servidores novos todo dia. Neste artigo não publicamos nenhuma lista desse tipo, porque não se sabe quem opera esses servidores.

Quem opera o servidor não consegue ler suas mensagens, mas pode registrar seu endereço IP. Ao se conectar a um servidor desconhecido, você aceita o seguinte:

• Você mostra seu endereço IP e seus horários de conexão a um estranho. Quando e quanto você usa o Telegram fica nos registros daquele servidor.
• Um canal patrocinado entra na sua lista de conversas. Quem opera proxy MTProto pode fixar um canal no topo da sua lista para cobrir os custos. O canal some quando você desativa o proxy.
• A qualidade da conexão é incerta. Muita gente divide o mesmo servidor; um dia ele funciona, no outro pode ter saído do ar. Aí o aplicativo fica em "Conectando...".

O mesmo vale para as listas gratuitas de SOCKS5. Tratamos o tema em detalhes em Proxies gratuitos são seguros?. Se for usar o Telegram com proxy, escolha um serviço cujo operador você conhece, com contrato e canal de suporte.

Que tipo de proxy combina com o Telegram?#

A sessão do Telegram dura muito: o aplicativo fica aberto o dia inteiro e conversa com o servidor o tempo todo. Por isso, um endereço que permanece igual por bastante tempo combina mais do que um proxy cujo endereço muda com frequência.

• Uma conta só, uso pessoal ou um bot: um endereço do tipo Proxies ISP permanece o mesmo por meses e está registrado em nome de um provedor de internet real. Se você vai cadastrar o endereço de saída do bot em um firewall, é a opção mais tranquila.
• Trabalhos em que o tráfego precisa sair por um endereço de operadora móvel: um Proxies móveis sai por conexões reais de operadoras móveis. Serve para equipes que querem experimentar um aplicativo em condições de rede móvel.

A diferença entre endereço fixo e endereço variável está em IP estático e IP dinâmico: diferenças. O proxy não flexibiliza os termos de uso do Telegram. Criar contas em massa, enviar mensagens não solicitadas ou puxar membros para grupos de forma automática termina com a conta encerrada, seja qual for o endereço usado, e não é o assunto deste artigo.

O que fazer quando o Telegram fica em "Conectando..."?#

Se, com o proxy ligado, o texto "Conectando..." ou "Conectando ao proxy" no topo da tela some, está tudo certo. Se ele fica ali por minutos, siga esta ordem:

1. Desligue o proxy e teste. Se também não conecta sem proxy, o problema não está no proxy, e sim na sua conexão com a internet ou no próprio Telegram. O texto "Aguardando rede..." indica que o celular não está conseguindo acessar a internet.
2. Confira o tipo. O erro mais comum é digitar os dados de SOCKS5 no formulário do MTProto. Se o formulário tem um campo "Segredo", você está no MTProto; apague o proxy e adicione de novo como SOCKS5.
3. Confira a porta. Se o seu painel traz portas diferentes para HTTP e SOCKS5, veja se você digitou a de SOCKS5.
4. Digite usuário e senha de novo. Espaço no começo ou no fim ao copiar, o teclado do celular que põe a primeira letra em maiúscula e o corretor automático são causas frequentes.
5. Veja o método de autenticação. Se o seu proxy funciona com whitelist de IP e o celular passou do Wi-Fi para os dados móveis, o endereço IP mudou. Troque para usuário e senha no painel.
6. Confira a validade do plano. Um plano vencido ou com a franquia esgotada recusa a conexão. O status aparece no painel.
7. Teste o proxy fora do Telegram. Faça um teste com os mesmos dados no computador; mostramos o método passo a passo em Seu proxy está funcionando? Como testar um proxy. Se lá também não funcionar, o problema não é o Telegram.
8. Veja se a rede bloqueia a porta. Redes de empresas e hotéis fecham a saída para algumas portas. Se o mesmo proxy funciona nos dados móveis e não funciona no Wi-Fi, o motivo é esse; fale com quem administra a rede.

O texto de status na lista de proxies dá uma pista: se aparece um valor de ping, o servidor está sendo alcançado; se aparece "Indisponível", "indisponível" ou "não disponível", o Telegram não chega àquele endereço. As outras causas do erro geral "o servidor proxy não está respondendo" estão reunidas em O servidor proxy não está respondendo.

Como desativar o proxy no Telegram?#

• Android: na tela Configurações > Dados e Armazenamento > Configurações de Proxy, desligue a chave Usar Proxy. Para remover o registro de vez, entre nos detalhes do proxy e apague.
• iPhone: na tela Configurações > Dados e Armazenamento > Proxy, desligue a chave Usar Proxy.
• Telegram Desktop: na janela Configurações > Avançado > Tipo de conexão, marque a opção Desativar proxy.

Se na sua lista de conversas aparece um canal com a etiqueta "Patrocinador do Proxy", há um proxy MTProto ligado. Ao desativar o proxy, esse canal também sai da lista.

Nível avançado: proxy em um bot Python#

Esta seção é para quem desenvolve bots; quem só usa o aplicativo pode pular. Os bots não usam o aplicativo do Telegram, e sim a Bot API em api.telegram.org. Por isso a configuração de proxy do aplicativo não afeta o seu bot; o proxy é definido no código. Como a Bot API roda sobre HTTPS, dá para usar tanto proxy HTTP quanto SOCKS5.

Na biblioteca python-telegram-bot, o proxy é informado por dois métodos do ApplicationBuilder: proxy() cobre as chamadas normais à API, e get_updates_proxy() cobre a conexão longa que aguarda as atualizações. O suporte a SOCKS5 vem com um pacote extra: pip install "python-telegram-bot[socks]".

import asyncio
import os
import sys

from telegram.error import InvalidToken, NetworkError
from telegram.ext import ApplicationBuilder

TOKEN = os.environ["BOT_TOKEN"]
PROXY = "socks5://user:pass@pr.proxynet.io:8000"


async def main() -> None:
    app = (
        ApplicationBuilder()
        .token(TOKEN)
        .proxy(PROXY)              # getMe, sendMessage e as demais chamadas
        .get_updates_proxy(PROXY)  # a conexão de getUpdates (long polling)
        .build()
    )
    try:
        async with app:
            me = await app.bot.get_me()
            print("Conexão OK:", me.username)
    except InvalidToken:
        print("O proxy funciona, mas o token do bot é inválido.")
    except NetworkError as exc:
        print("Não foi possível alcançar o proxy ou o Telegram:", exc)
        sys.exit(1)


asyncio.run(main())

Testamos o código por meio de um proxy local de teste. Com a senha errada, a biblioteca lança NetworkError com a mensagem httpx.ProxyError: Invalid username/password; com a porta fechada, retorna httpx.ConnectError. Os dois pertencem à camada do proxy; capture-os separadamente do erro de token. Para usar um proxy HTTP, basta escrever o endereço como http://user:pass@pr.proxynet.io:8000, sem pacote extra. Não deixe o token fixo no código; leia de uma variável de ambiente, como no exemplo.

Erros comuns#

• Procurar a configuração no menu de Wi-Fi do celular. O proxy do menu de Wi-Fi é para tráfego web e não aceita SOCKS5. Os aplicativos do Telegram para celular usam o proxy definido dentro do próprio aplicativo.
• Digitar os dados de SOCKS5 no formulário do MTProto. O campo "Segredo" não é campo de usuário nem de senha.
• Compartilhar um link de proxy com senha. No link t.me/socks a senha fica em texto puro; quem receber o link usa o seu proxy.
• Adicionar um servidor gratuito fora do ar atrás do outro. Apague os registros que você não usa; quanto maior a lista, mais difícil saber qual está ligado.
• Esquecer o proxy ligado. Quando o plano vence, o Telegram fica em "Conectando..." e a culpa recai sobre o Telegram.

Guia de decisão#

Perguntas frequentes#

O que é um servidor proxy do Telegram?#

É um servidor intermediário que fica entre você e o Telegram. O Telegram aceita dois tipos: SOCKS5, que funciona em qualquer aplicativo, e MTProto, escrito só para o Telegram. No aplicativo, a configuração se chama simplesmente "Proxy" e fica dentro de Dados e Armazenamento.

O que é MTProto?#

MTProto é o protocolo que os aplicativos do Telegram usam para falar com os servidores do Telegram. Já o proxy MTProto é um software de servidor específico, escrito para transportar esse tráfego. No lugar de usuário e senha, ele funciona com uma única chave, digitada no campo "Segredo", e não pode ser usado em outros aplicativos.

O provedor do proxy consegue ler minhas mensagens?#

Segundo a documentação oficial do Telegram, não: o tráfego chega criptografado ao proxy, e quem o opera não consegue ler as mensagens nem identificar a sua conta. O que ele consegue ver é o seu endereço IP, os horários de conexão e a quantidade de dados transferidos.

O Telegram usa o proxy de sistema do celular?#

Nos aplicativos para celular essa opção não existe; o proxy é definido nas configurações do próprio aplicativo. O Telegram Desktop, por sua vez, tem a opção "Configurações de proxy do sistema" e pode assumir o proxy definido no sistema operacional.

Usar proxy no Telegram pode levar ao encerramento da minha conta?#

A configuração de proxy é um recurso que o próprio aplicativo oferece; a conta não é encerrada só porque você usa um proxy. O que coloca contas em risco é o comportamento: mensagens em massa não solicitadas, adição automática de membros e conteúdo que recebe denúncias. Isso tem a mesma consequência seja qual for o endereço IP de origem.

Posso usar o mesmo proxy em mais de um aparelho?#

Do lado do Telegram não há impedimento; você pode digitar os mesmos dados de SOCKS5 no celular e no computador. O limite é definido pelo seu plano de proxy: alguns planos restringem o número de conexões simultâneas.

Em resumo#

A configuração de proxy do Telegram fica dentro do aplicativo: no celular, em Configurações > Dados e Armazenamento; no Telegram Desktop, na linha Configurações > Avançado > Tipo de conexão. Se você tem um proxy com usuário e senha, o tipo é SOCKS5; o MTProto é um tipo à parte, exclusivo do Telegram, que funciona com um "Segredo", e vale manter distância das listas gratuitas de origem desconhecida. Por padrão, as chamadas não passam pelo proxy. Se o aplicativo ficar em "Conectando...", teste primeiro sem proxy e depois confira tipo, porta, senha e validade do plano. Para endereços fixos que você pode digitar direto no formulário SOCKS5 do Telegram, conheça os nossos serviços de proxy.