Proxy dla API i Telegram z RU: proxyctl

Wdrażanie stosu proxy do dostępu do API z sieci izolowanych

Programiści pracujący z botami Telegram lub zagranicznymi API często zmagają się z timeoutami i niestabilnym połączeniem w regionach objętych ograniczeniami. Serwer proxy kieruje ruch wybiórczo, bez konieczności tunelowania całego ruchu przez VPN. Gwarantuje to stabilność zapytań HTTP/HTTPS/SOCKS oraz protokołu MTProto dla Telegramu przy minimalnych opóźnieniach.

Dostępne są dwa podejścia: zakup gotowego rozwiązania proxy lub samodzielne wdrożenie na VPS. Do szybkiego startu służy narzędzie CLI proxyctl, które automatyzuje instalację stosu opartego na 3proxy (HTTP/SOCKS5) oraz mtg (MTProto).

Różnice między proxy a rozwiązaniami VPN

VPN przekierowuje cały ruch serwera, co jest zbędne w przypadku integracji z API. Proxy działa selektywnie:

• Tylko docelowe zapytania przechodzą przez pośrednika.
• Ruch jest segmentowany według aplikacji i użytkowników.
• Niższe obciążenie łącza i mniejsze opóźnienia.

Proxy nie zastępuje szyfrowania HTTPS — bezpieczeństwo zapytań pozostaje zapewnione na poziomie klienta i serwera.

Protokoły w stosie proxyctl

Proxy HTTP

Obsługuje metodę CONNECT dla HTTPS. Zastosowanie:

• curl, fetch, axios.
• Przeglądarki i klienty HTTP.
• Standardowy ruch internetowy.

Proxy SOCKS5

Uniwersalny pośrednik TCP dla:

• Aplikacji obsługujących SOCKS.
• Niestandardowych protokołów.
• Dowolnych połączeń TCP.

Proxy MTProto

Dedykowany klientom Telegram. Bezproblemowo integruje się z aplikacjami mobilnymi i desktopowymi.

Stos uruchamiany jest w trybie systemd (dla VPS) lub process (dla kontenerów bez systemd).

Szybkie wdrożenie na Ubuntu/Debian

Wymagany serwer VPS z systemem Ubuntu lub Debian. Instalacja CLI:

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

Weryfikacja po instalacji:

proxyctl status
proxyctl diagnose

Diagnostyka sprawdza działanie 3proxy, dostępność portów, lokalne testy HTTP/HTTPS/SOCKS oraz bazę użytkowników.

Wdrażanie presetów:

• proxyctl install full — pełny stos (HTTP + SOCKS5 + MTProto).
• proxyctl install api — HTTP + SOCKS5 dla API.
• proxyctl install mtproto — wyłącznie Telegram.
• proxyctl wizard — konfiguracja interaktywna.

Uruchomienie wielu komponentów: proxyctl install api mtproto.

Zarządzanie użytkownikami i dostępem

W przypadku 3proxy uwierzytelnianie jest obowiązkowe. Dostępne polecenia:

• proxyctl add-user alice — dodanie użytkownika.
• proxyctl list-users — wyświetlenie listy.
• proxyctl change-password alice newpass — zmiana hasła.
• proxyctl remove-user alice — usunięcie konta.

Zmiany są stosowane po ponownym uruchomieniu usługi. Pobranie danych połączenia:

• proxyctl show-connect — host, port, nazwa użytkownika dla HTTP/SOCKS5.
• proxyctl show-telegram-link — link tg:// dla Telegramu.

Konfiguracja zapory sieciowej i porty

Kluczowe porty TCP:

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

Dla Google Cloud: polecenie proxyctl print-gcp-firewall generuje gotowe komendy gcloud. Problemy z połączeniem z zewnątrz zwykle wynikają z reguł grup zabezpieczeń (security groups) u dostawcy chmury.

Ograniczenia i scenariusze użycia

Proxyctl jest zoptymalizowany pod Ubuntu/Debian z menedżerem apt. Nie zastępuje pełnej infrastruktury sieciowej — firewall musi być skonfigurowany ręcznie.

Nadaje się do:

• Tworzenia botów i integracji z API.
• Testowania w sieciach izolowanych.
• Programistów na poziomie middle/senior, którzy potrzebują stabilnego dostępu bez zbędnego obciążenia.

Co warto wiedzieć:

• Proxy kieruje ruch wybiórczo, minimalizując opóźnienia.
• Stos: 3proxy + mtg z zarządzaniem przez CLI.
• Presety dla API, Telegramu lub pełnego zestawu.
• Diagnostyka i uwierzytelnianie dostępne od razu po instalacji.
• Ręczna konfiguracja zapory w chmurze jest obowiązkowa.

— Editorial Team