RU에서 API 및 Telegram용 프록시: proxyctl

격리된 네트워크에서 API 접근을 위한 프록시 스택 배포하기

텔레그램 봇 개발이나 해외 API 연동 시 제한된 지역에서 타임아웃이나 불안정한 연결 문제로 고생하는 개발자들이 많습니다. 프록시 서버는 VPN처럼 모든 트래픽을 우회시키지 않고, 필요한 요청만 선별적으로 라우팅합니다. 이를 통해 HTTP, HTTPS, SOCKS, 텔레그램 MTProto 연결을 최소한의 지연 시간으로 안정적으로 유지할 수 있습니다.

기성 프록시를 구매하거나 VPS에 직접 구축할 수 있습니다. 빠른 구축을 원한다면 proxyctl CLI 도구를 활용하세요. 이 도구는 3proxy(HTTP/SOCKS5)와 mtg(MTProto) 기반의 스택 설치를 자동화합니다.

프록시 vs VPN: 핵심 차이점

VPN은 서버의 모든 트래픽을 우회시키므로 API 전용 작업에는 과한 설정입니다. 프록시는 선택적으로 작동합니다:

• 대상이 지정된 요청만 중개 서버를 통해 라우팅됩니다.
• 애플리케이션 및 사용자별로 트래픽이 분리됩니다.
• 대역폭 오버헤드가 낮고 지연 시간이 줄어듭니다.

프록시가 HTTPS 암호화를 대체하는 것은 아닙니다. 요청 보안은 여전히 클라이언트와 서버 수준에서 처리됩니다.

proxyctl 스택의 프로토콜

HTTP 프록시

CONNECT 메서드를 통해 HTTPS를 처리합니다. 다음에 적합합니다:

• curl, fetch, axios
• 웹 브라우저 및 표준 HTTP 클라이언트
• 일반 웹 트래픽

SOCKS5 프록시

TCP 기반의 범용 릴레이로 다음을 지원합니다:

• SOCKS 호환 애플리케이션
• 커스텀 또는 비표준 프로토콜
• 모든 TCP 기반 연결

MTProto 프록시

텔레그램 클라이언트 전용으로 설계되었습니다. 모바일 및 데스크톱 앱과 원활하게 통합됩니다.

이 스택은 표준 VPS 환경에서는 systemd 모드로, systemd가 없는 컨테이너 환경에서는 프로세스 모드로 실행됩니다.

Ubuntu/Debian에서 빠른 배포

Ubuntu 또는 Debian VPS가 필요합니다. CLI 설치:

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

설치 확인:

proxyctl status
proxyctl diagnose

진단 도구는 3proxy 실행 여부, 포트 가용성, 로컬 HTTP/HTTPS/SOCKS 테스트, 사용자 데이터베이스 유효성을 검사합니다.

사용 가능한 설치 프리셋:

• proxyctl install full — 전체 스택 (HTTP + SOCKS5 + MTProto)
• proxyctl install api — API 접근용 HTTP + SOCKS5
• proxyctl install mtproto — 텔레그램 전용 설정
• proxyctl wizard — 대화형 구성

프리셋 조합: proxyctl install api mtproto

사용자 관리 및 접근 제어

3proxy는 인증이 필요합니다. 다음 명령어를 사용하세요:

• proxyctl add-user alice — 새 사용자 생성
• proxyctl list-users — 전체 사용자 목록 조회
• proxyctl change-password alice newpass — 비밀번호 변경
• proxyctl remove-user alice — 사용자 삭제

변경 사항은 서비스 재시작 후 적용됩니다. 연결 정보 확인:

• proxyctl show-connect — HTTP/SOCKS5용 호스트, 포트, 사용자명
• proxyctl show-telegram-link — 텔레그램용 tg:// 링크 생성

방화벽 구성 및 포트

필수 TCP 포트:

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

Google Cloud 환경: proxyctl print-gcp-firewall 명령어로 바로 사용 가능한 gcloud 명령어를 출력합니다. 외부 연결 문제는 대부분 제공업체의 보안 그룹이나 방화벽 규칙에서 발생합니다.

제한 사항 및 활용 사례

proxyctl은 apt를 사용하는 Ubuntu/Debian 시스템에 최적화되어 있습니다. 완전한 네트워크 인프라를 대체하지는 않으므로 방화벽은 수동으로 구성해야 합니다.

다음에 가장 적합합니다:

• 봇 개발 및 서드파티 API 연동
• 제한되거나 격리된 네트워크 환경에서의 테스트
• 불필요한 오버헤드 없이 안정적인 접근이 필요한 중급~고급 개발자

핵심 요약:

• 프록시는 지연 시간을 최소화하기 위해 특정 요청만 라우팅합니다.
• 스택: 통합 CLI로 관리되는 3proxy + mtg
• API, 텔레그램, 전체 스택 배포를 위한 기성 프리셋 제공
• 내장 진단 도구 및 인증 기능
• 클라우드 방화벽 수동 구성 필요

— Editorial Team