GitHub Release License GitHub Downloads (all assets, all releases)

FastAPI сервис для конвертации Telegram ссылок t.me в диплинки tg://.

Открывайте любые Telegram-ссылки напрямую в приложении, минуя браузер и обходя блокировки — без VPN.

В России Telegram заблокирован, и ссылки t.me не открываются в браузере без VPN. Но само приложение работает у многих через прокси. Этот сервис превращает обычные ссылки в диплинки tg://, которые сразу открываются в приложении Telegram на любом устройстве.

Вы заменяете домен в любой Telegram-ссылке:

Сервис перенаправляет на соответствующий tg:// диплинк, который открывается прямо в приложении.

Все типы ссылок реализованы в соответствии с официальной документацией Telegram:

• /{username} — публичные профили, каналы, группы
• /+{phone} — поиск по номеру телефона
• /{username}?profile — профиль пользователя
• /{username}?direct — монофорум (чат канала)

• /joinchat/{hash} — пригласительные ссылки (старый формат)
• /+{hash} — пригласительные ссылки (новый формат)
• /addlist/{slug} — папки с чатами

• /{username}/{message_id} — ссылка на сообщение в публичном чате
• /c/{channel_id}/{message_id} — ссылка на сообщение в приватном чате
• /{username}/{thread_id}/{message_id} — сообщение в треде

• /{bot}?start={param} — запуск бота с параметром
• /{bot}?startgroup — добавление бота в группу
• /{bot}/{app} — прямые мини-приложения
• /{bot}?startapp — главное мини-приложение

• /{username}/s/{story_id} — истории
• /{username}/a/{album_id} — альбомы историй
• /addstickers/{slug} — наборы стикеров
• /addemoji/{slug} — наборы эмодзи
• /addtheme/{name} — темы оформления

• /{username}?videochat — видеозвонки
• /{username}?livestream — прямые трансляции
• /call/{slug} — конференц-звонки

• /boost/{username} — буст канала
• /proxy — MTProxy/Socks5 прокси
• /login/{code} — код входа
• /invoice/{slug} — счета на оплату
• /setlanguage/{slug} — языковые пакеты
• /confirmphone — подтверждение номера
• /giftcode/{slug} — подарочные коды Premium
• /nft/{slug} — коллекционные подарки
• /m/{slug} — бизнес-чаты
• /bg/{params} — обои (все типы)
• /share — поделиться сообщением

docker run -d -p 1234:1234 ghcr.io/austnv/t-me:latest

git clone https://github.com/austnv/t-me.git
cd t-me
docker compose up -d

git clone https://github.com/austnv/t-me.git
cd t-me
uv sync
uv run fastapi run --port 1234

Рекомендуется использовать за reverse-прокси (Caddy, Nginx) с HTTPS.

t.domain.me {
 reverse_proxy localhost:1234
}

server {
 listen 80;
 server_name t.domain.me;
 location / {
 proxy_pass http://localhost:1234;
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header X-Forwarded-Proto $scheme;
 }
}

Сервис не имеет собственного API — он просто редиректит HTTP-запросы на соответствующие tg:// URI.

git clone https://github.com/austnv/t-me.git
cd t-me
uv sync
uv run fastapi dev

Сервер разработки с hot-reload будет доступен на http://localhost:8000.

• FastAPI — веб-фреймворк
• uv — пакетный менеджер
• Docker — контейнеризация
• Python 3.14 — язык программирования

Pull request'ы приветствуются. Для значительных изменений создавайте issue для обсуждения.

MIT

• Официальная документация Telegram по диплинкам
• Образ на GitHub Container Registry