[PR #1142] optional Bot API tunnel for bots without VPN #94

Open
opened 2026-07-24 19:31:57 +03:00 by mirror-bot · 0 comments

📋 Pull Request Information

Original PR: https://github.com/Flowseal/tg-ws-proxy/pull/1142
Author: @Sweetyexe19
Created: 7/23/2026
Status: 🔄 Open

Base: mainHead: tg-ws-proxy-TgBotApi


📝 Commits (1)

  • bbd328e optional Bot API tunnel for bots without VPN

📊 Changes

16 files changed (+539 additions, -3 deletions)

View changed files

📝 Dockerfile (+4 -2)
docs/BotApi.md (+45 -0)
📝 docs/CfWorker.md (+2 -0)
📝 docs/README.docker.md (+4 -0)
📝 docs/README.md (+1 -0)
📝 docs/TrayConfig.md (+3 -0)
📝 macos.py (+10 -0)
📝 proxy/__init__.py (+1 -1)
proxy/bot_api_proxy.py (+403 -0)
📝 proxy/config.py (+3 -0)
📝 proxy/tg_ws_proxy.py (+37 -0)
📝 ui/ctk_tray_ui.py (+16 -0)
📝 ui/i18n/en.json (+4 -0)
📝 ui/i18n/ru.json (+4 -0)
📝 utils/default_config.py (+1 -0)
📝 utils/tray_common.py (+1 -0)

📄 Description

Что это

Добавил опциональный туннель для Bot API (api.telegram.org).

Идея простая: включил галку — боты (aiogram и т.п.) ходят в телегу без VPN и без правок кода. Выключено по умолчанию, обычным юзерам Desktop вообще всё равно.

Как работает: hosts кидает api.telegram.org на 127.0.0.2:443, дальше сырой TCP через уже существующий CF Worker /apiws?dst=.... TLS не трогаем. При выходе hosts откатывается.

Доки: docs/BotApi.md

Насчёт Worker

Домен Worker пока как и раньше — юзер сам указывает (как для MTProto fallback).
Если потом захотите zero-config «скачал и боты работают» — можно зашить пул доменов по аналогии с CF Proxy. Клиентская часть под это уже есть, останется только список.

Как проверить

  • По дефолту выкл, hosts не трогает, MTProto живой
  • Вкл + Worker + админ — бот / curl на api.telegram.org без VPN
  • Без Worker / без админа — понятный лог, MTProto не падает
  • После стопа hosts чистый
  • С галкой выкл — как обычный Desktop-прокси

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/Flowseal/tg-ws-proxy/pull/1142 **Author:** [@Sweetyexe19](https://github.com/Sweetyexe19) **Created:** 7/23/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `tg-ws-proxy-TgBotApi` --- ### 📝 Commits (1) - [`bbd328e`](https://github.com/Flowseal/tg-ws-proxy/commit/bbd328e06af4eb7f899a8abd6c722880d677c14e) optional Bot API tunnel for bots without VPN ### 📊 Changes **16 files changed** (+539 additions, -3 deletions) <details> <summary>View changed files</summary> 📝 `Dockerfile` (+4 -2) ➕ `docs/BotApi.md` (+45 -0) 📝 `docs/CfWorker.md` (+2 -0) 📝 `docs/README.docker.md` (+4 -0) 📝 `docs/README.md` (+1 -0) 📝 `docs/TrayConfig.md` (+3 -0) 📝 `macos.py` (+10 -0) 📝 `proxy/__init__.py` (+1 -1) ➕ `proxy/bot_api_proxy.py` (+403 -0) 📝 `proxy/config.py` (+3 -0) 📝 `proxy/tg_ws_proxy.py` (+37 -0) 📝 `ui/ctk_tray_ui.py` (+16 -0) 📝 `ui/i18n/en.json` (+4 -0) 📝 `ui/i18n/ru.json` (+4 -0) 📝 `utils/default_config.py` (+1 -0) 📝 `utils/tray_common.py` (+1 -0) </details> ### 📄 Description ## Что это Добавил опциональный туннель для Bot API (`api.telegram.org`). Идея простая: включил галку — боты (aiogram и т.п.) ходят в телегу без VPN и без правок кода. Выключено по умолчанию, обычным юзерам Desktop вообще всё равно. Как работает: hosts кидает `api.telegram.org` на `127.0.0.2:443`, дальше сырой TCP через уже существующий CF Worker `/apiws?dst=...`. TLS не трогаем. При выходе hosts откатывается. Доки: `docs/BotApi.md` ## Насчёт Worker Домен Worker пока как и раньше — юзер сам указывает (как для MTProto fallback). Если потом захотите zero-config «скачал и боты работают» — можно зашить пул доменов по аналогии с CF Proxy. Клиентская часть под это уже есть, останется только список. ## Как проверить - [ ] По дефолту выкл, hosts не трогает, MTProto живой - [ ] Вкл + Worker + админ — бот / curl на api.telegram.org без VPN - [ ] Без Worker / без админа — понятный лог, MTProto не падает - [ ] После стопа hosts чистый - [ ] С галкой выкл — как обычный Desktop-прокси --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
mirror-bot added the pull-request label 2026-07-24 19:31:57 +03:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Utilities/tg-ws-proxy#94