Proxy pro API a Telegram z RU: proxyctl

Nasazení proxy stacku pro přístup k API z izolovaných sítí

Vývojáři pracující s Telegram boty nebo zahraničními API se v ruských regionech často potýkají s časovými limity a nestabilním připojením. Proxy server cíleně přesměrovává požadavky bez nutnosti směrovat veškerý provoz přes VPN. Tím zajišťuje stabilitu HTTP/HTTPS/SOCKS požadavků i MTProto pro Telegram s minimální latencí.

K dispozici jsou dva přístupy: nákup hotového proxy řešení nebo vlastní nasazení na VPS. Pro rychlý start slouží nástroj proxyctl v příkazové řádce, který automatizuje instalaci stacku založeného na 3proxy (HTTP/SOCKS5) a mtg (MTProto).

Rozdíly mezi proxy a VPN řešeními

VPN přesměrovává veškerý provoz serveru, což je pro úlohy pracující s API zbytečné. Proxy funguje selektivně:

• Pouze cílené požadavky procházejí přes zprostředkovatele.
• Provoz je segmentován podle aplikací a uživatelů.
• Nižší zatížení linky a menší latence.

Proxy nenahrazuje HTTPS šifrování – bezpečnost požadavků zůstává zajištěna na úrovni klienta i serveru.

Protokoly v proxyctl stacku

HTTP proxy

Zajišťuje metodu CONNECT pro HTTPS. Využití:

• curl, fetch, axios.
• Prohlížeče a HTTP klienty.
• Běžný webový provoz.

SOCKS5 proxy

Univerzální TCP zprostředkovatel pro:

• Aplikace s podporou SOCKS.
• Nestandardní protokoly.
• Jakékoli TCP připojení.

MTProto proxy

Je specifický pro klienty Telegramu. Integruje se s mobilními i desktopovými aplikacemi.

Stack běží v režimu systemd pro VPS nebo v režimu procesu pro kontejnery bez systemd.

Rychlé nasazení na Ubuntu/Debian

Vyžaduje se VPS s Ubuntu nebo Debianem. Instalace CLI:

curl -fsSL "https://raw.githubusercontent.com/Kotelnikovekb/proxyctl/main/install.sh" | sudo bash

Ověření po instalaci:

proxyctl status
proxyctl diagnose

Diagnostika ověřuje spuštění 3proxy, dostupnost portů, lokální testy HTTP/HTTPS/SOCKS a databázi uživatelů.

Nasazení předvoleb:

• proxyctl install full — kompletní stack (HTTP + SOCKS5 + MTProto).
• proxyctl install api — HTTP + SOCKS5 pro API.
• proxyctl install mtproto — pouze pro Telegram.
• proxyctl wizard — interaktivní nastavení.

Kombinované nasazení: proxyctl install api mtproto.

Správa uživatelů a přístupů

Pro 3proxy je vyžadována autentizace. Příkazy:

• proxyctl add-user alice — přidání uživatele.
• proxyctl list-users — výpis seznamu.
• proxyctl change-password alice newpass — změna hesla.
• proxyctl remove-user alice — odstranění.

Změny se projeví po restartu služby. Získání připojovacích údajů:

• proxyctl show-connect — host, port, username pro HTTP/SOCKS5.
• proxyctl show-telegram-link — tg:// odkaz pro Telegram.

Nastavení firewallu a porty

Klíčové TCP porty:

• 3128 — HTTP.
• 1080 — SOCKS5.
• 443 — MTProto.

Pro Google Cloud: proxyctl print-gcp-firewall vygeneruje příkazy pro gcloud. Problémy s připojením zvenčí obvykle pramení z bezpečnostních skupin poskytovatele.

Omezení a scénáře použití

Proxyctl je optimalizován pro Ubuntu/Debian s apt. Nenahrazuje plnohodnotnou síťovou infrastrukturu – firewall je třeba nastavit ručně.

Vhodné pro:

• Vývoj botů a integrací s API.
• Testování v izolovaných sítích.
• Vývojáře na úrovni middle/senior, kteří potřebují stabilní přístup bez zbytečné režie.

Na co si dát pozor:

• Proxy cíleně přesměrovává požadavky a minimalizuje latenci.
• Stack: 3proxy + mtg s ovládáním přes CLI.
• Předvolby pro API, Telegram nebo kompletní sadu.
• Diagnostika a autentizace přímo v základu.
• Ruční nastavení cloud firewallu je povinné.

— Editorial Team