Proxy pour API et Telegram depuis RU : proxyctl

Déploiement d'une stack proxy pour l'accès aux API depuis des réseaux isolés

Les développeurs qui créent des bots Telegram ou intègrent des API internationales rencontrent souvent des délais d'expiration et des connexions instables dans les régions où l'accès est restreint. Un serveur proxy achemine les requêtes de manière sélective, sans faire transiter l'intégralité du trafic par un VPN. Cette approche garantit des connexions HTTP, HTTPS, SOCKS et MTProto (Telegram) fiables, avec une latence minimale.

Vous pouvez soit acheter un proxy clé en main, soit déployer votre propre solution sur un VPS. Pour une configuration rapide, l'outil CLI proxyctl automatise l'installation d'une stack reposant sur 3proxy (HTTP/SOCKS5) et mtg (MTProto).

Proxy vs VPN : les différences clés

Un VPN redirige l'ensemble du trafic du serveur, ce qui est disproportionné pour des tâches spécifiques aux API. Un proxy fonctionne de manière sélective :

• Seules les requêtes ciblées transitent par l'intermédiaire.
• Le trafic est segmenté par application et par utilisateur.
• Une consommation de bande passante réduite et une latence optimisée.

Les proxies ne remplacent pas le chiffrement HTTPS : la sécurité des requêtes reste gérée au niveau du client et du serveur.

Les protocoles de la stack proxyctl

Proxy HTTP

Gère le HTTPS via la méthode CONNECT. Idéal pour :

• curl, fetch et axios.
• Les navigateurs web et les clients HTTP standards.
• Le trafic web général.

Proxy SOCKS5

Un relais TCP universel compatible avec :

• Les applications supportant le protocole SOCKS.
• Les protocoles personnalisés ou non standards.
• Toute connexion basée sur TCP.

Proxy MTProto

Conçu spécifiquement pour les clients Telegram. Il s'intègre parfaitement aux applications mobiles et de bureau.

La stack s'exécute en mode systemd pour les environnements VPS classiques, ou en mode processus pour les conteneurs dépourvus de systemd.

Déploiement rapide sur Ubuntu/Debian

Nécessite un VPS sous Ubuntu ou Debian. Installez l'interface CLI :

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

Vérifiez l'installation :

proxyctl status
proxyctl diagnose

L'outil de diagnostic vérifie l'exécution de 3proxy, la disponibilité des ports, exécute des tests locaux HTTP/HTTPS/SOCKS et valide la base de données des utilisateurs.

Préréglages d'installation disponibles :

• proxyctl install full — stack complète (HTTP + SOCKS5 + MTProto).
• proxyctl install api — HTTP + SOCKS5 pour l'accès aux API.
• proxyctl install mtproto — configuration dédiée à Telegram.
• proxyctl wizard — configuration interactive.

Combinez les préréglages : proxyctl install api mtproto.

Gestion des utilisateurs et contrôle d'accès

3proxy exige une authentification. Utilisez les commandes suivantes :

• proxyctl add-user alice — créer un nouvel utilisateur.
• proxyctl list-users — afficher tous les utilisateurs.
• proxyctl change-password alice newpass — modifier un mot de passe.
• proxyctl remove-user alice — supprimer un utilisateur.

Les modifications prennent effet après le redémarrage du service. Récupérez les détails de connexion :

• proxyctl show-connect — hôte, port et nom d'utilisateur pour HTTP/SOCKS5.
• proxyctl show-telegram-link — génère un lien tg:// pour Telegram.

Configuration du pare-feu et ports

Ports TCP essentiels :

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

Pour Google Cloud : proxyctl print-gcp-firewall génère des commandes gcloud prêtes à l'emploi. Les problèmes de connexion externe proviennent généralement des groupes de sécurité ou des règles de pare-feu de votre fournisseur.

Limites et cas d'utilisation

proxyctl est optimisé pour les systèmes Ubuntu/Debian utilisant apt. Il ne remplace pas une infrastructure réseau complète : vous devrez toujours configurer votre pare-feu manuellement.

Il est particulièrement adapté pour :

• Le développement de bots et l'intégration d'API tierces.
• Les tests dans des environnements réseau restreints ou isolés.
• Les développeurs intermédiaires à expérimentés recherchant un accès fiable sans surcharge inutile.

Points clés à retenir :

• Les proxies acheminent des requêtes spécifiques pour minimiser la latence.
• Stack : 3proxy + mtg gérés via une CLI unifiée.
• Préréglages prêts à l'emploi pour les API, Telegram ou les déploiements complets.
• Diagnostics et authentification intégrés.
• La configuration manuelle du pare-feu cloud reste nécessaire.

— Editorial Team