프로토콜
HTTP, HTTPS(CONNECT), SOCKS5를 같은 호스트와 포트에서 지원합니다. 프로토콜별로 TLS와 DNS가 어떻게 처리되는지 설명합니다.
게이트웨이는 널리 쓰이는 프록시 프로토콜 세 가지를 호스트 하나, 포트 하나(icn-01.gw.scalardata.ai:7777)에서 모두 받습니다. 클라이언트가 보내는 첫 바이트로 어떤 프로토콜인지 판별하므로, 따로 고를 것도 없고 두 번째 엔드포인트를 기억할 필요도 없습니다.
| 프로토콜 | 동작 방식 | 인증 | 참고 |
|---|---|---|---|
| HTTP | 일반 포워드 프록시. 클라이언트가 요청 라인에 전체 URL을 보냅니다. | Proxy-Authorization 헤더 또는 화이트리스트 | http:// 목적지 전용이며 연결당 요청 하나만 처리합니다. 게이트웨이가 요청과 응답을 평문으로 봅니다. |
| HTTPS | CONNECT 터널. 클라이언트가 TCP 터널을 열고 그 안에서 목적지와 TLS 연결을 맺습니다. | CONNECT 요청의 Proxy-Authorization 헤더 또는 화이트리스트 | https:// 목적지용. TLS는 종단 간이며, 게이트웨이가 보는 것은 호스트명과 바이트 수뿐입니다. |
| SOCKS5 | 범용 TCP 프록시. 메일 발송을 제외한 모든 TCP 프로토콜에 쓸 수 있으며, 25, 465, 587, 2525번 포트는 거부됩니다. | 사용자명/비밀번호 방식(RFC 1929) 또는 화이트리스트 | CONNECT 명령만 지원. 호스트명을 로컬 장비에서 조회하지 않고 게이트웨이로 보내 게이트웨이가 해석하도록 socks5h 스킴을 쓰세요. |
HTTP
가장 오래된 방식입니다. 클라이언트가 게이트웨이에 연결한 뒤 절대 URL을 적은 요청(GET http://example.com/ HTTP/1.1)을 보내면, 게이트웨이가 출구 IP에서 그 URL을 가져와 응답을 되돌려 줍니다. 암호화가 없기 때문에 http:// 목적지에만 해당하고, 그런 사이트는 이제 드뭅니다. 게이트웨이는 연결 하나에 요청 하나만 처리하고 응답 뒤 연결을 닫으므로, http:// 목적지에는 게이트웨이와의 keep-alive가 적용되지 않습니다.
curl -x http://icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr:PASSWORD" http://example.com/CONNECT를 통한 HTTPS
https:// 목적지에서는 클라이언트가 CONNECT 요청으로 게이트웨이에 host:443까지 이어지는 TCP 터널을 열어 달라고 요청하고, 그 터널 안에서 목적지와 직접 TLS 핸드셰이크를 합니다. 게이트웨이는 양방향으로 바이트를 넘길 뿐 내용을 읽을 수 없습니다. 인증서를 설치할 필요도 없고, 게이트웨이가 트래픽을 중간에서 열어 보는 일도 없습니다. 클라이언트가 검증하는 인증서는 목적지 사이트의 인증서 그대로입니다.
# 클라이언트가 CONNECT example.com:443을 보낸 뒤, 터널 안에서 TLS로 통신합니다
curl -x http://icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr:PASSWORD" https://example.com/프록시 URL 스킴이 여전히 http://인 점에 유의하세요. 이 스킴은 목적지가 아니라 게이트웨이와 통신하는 방식을 나타냅니다. 대부분의 도구는 이 URL을 환경 변수로 받습니다.
export HTTPS_PROXY="http://k7f3q2-acme-country-kr:[email protected]:7777"
export HTTP_PROXY="http://k7f3q2-acme-country-kr:[email protected]:7777"SOCKS5
SOCKS5는 그 위로 어떤 프로토콜이 오가든 상관하지 않고 TCP 연결을 중계합니다. 그래서 HTTP가 아닌 트래픽이나 SOCKS만 지원하는 도구에는 SOCKS5를 쓰면 됩니다. 다른 프로토콜과 마찬가지로 메일 포트(25, 465, 587, 2525)는 거부됩니다. 인증은 사용자명/비밀번호 방식을 쓰고, 사용자명에 타게팅을 적는 방법은 HTTP와 같습니다. 게이트웨이는 CONNECT 명령을 지원하며, BIND와 UDP 연결은 지원하지 않습니다.
# socks5h: 호스트명을 게이트웨이로 보내 게이트웨이가 해석하고 검사합니다
curl -x socks5h://k7f3q2-acme-country-kr:[email protected]:7777 https://example.com/
# socks5(h 없음): 로컬 장비가 먼저 호스트명을 해석한 뒤 IP만 보냅니다h 한 글자 차이가 큽니다. socks5h://(다른 클라이언트에서는 보통 "원격 DNS" 옵션에 해당)를 쓰면 호스트명이 로컬 장비에서 조회되지 않고 게이트웨이로 전달되며, 게이트웨이가 이를 해석합니다. 일반 socks5://를 쓰면 로컬 장비가 DNS를 직접 조회하므로, 어떤 호스트에 접속하는지가 로컬 리졸버에 노출됩니다.
유휴 연결
인증을 마친 CONNECT 터널과 SOCKS5 연결은 어느 방향으로든 데이터가 오가는 동안 계속 유지됩니다. 양방향 모두 10분 동안 데이터가 없으면 게이트웨이가 연결을 닫으므로, 다음 요청은 새 연결로 보내야 합니다. 쓸 수 있는 트래픽(주거용 잔액이나 프록시 유저의 월 한도)이 바닥나거나, 프록시 유저·화이트리스트 항목·구독·IP 할당이 더 이상 유효하지 않거나, 사용 중인 출구 IP가 운영에서 빠질 때도 연결을 닫습니다.
TLS 참고 사항
- 종단 간 암호화. CONNECT와 SOCKS5에서 TLS 연결은 클라이언트와 목적지 사이에서 직접 맺어집니다. 게이트웨이는 TLS를 풀어 보지 않으며 응답을 바꿀 수도 없습니다.
- 핑거프린트는 클라이언트의 것. 핸드셰이크를 클라이언트가 수행하므로, 목적지가 보는 TLS 핑거프린트(암호 스위트 순서, 확장, HTTP/2 설정)는 게이트웨이가 아닌 클라이언트의 것입니다. TLS 핑거프린팅을 하는 사이트는 실제로 쓰는 클라이언트를 기준으로 판단하므로, 주거용 IP에서 브라우저급 클라이언트를 쓰면 브라우저로 인식됩니다.
- 게이트웨이까지의 구간은 평문.
Proxy-Authorization헤더의 프록시 자격 증명과 CONNECT 라인의 목적지 호스트명은 로컬 장비와 게이트웨이 사이를 암호화 없이 오갑니다. 통제할 수 없는 네트워크에 있거나 비밀번호 자체를 보내고 싶지 않다면 IP 화이트리스트를 쓰세요. - 인증서 오류는 목적지 쪽 문제. 클라이언트가 인증서 오류를 내면, 그 인증서는 목적지에서 왔거나, 출구 IP와 목적지 사이 구간 어딘가에서 온 것입니다. 일시적인 문제라면 새 IP로 재시도해 해소되는 경우가 대부분이고, 계속된다면 사이트 자체의 문제입니다.
- HTTP/2와 HTTP/3. CONNECT 터널 안에서는 평소처럼 목적지와 HTTP/2를 협상할 수 있습니다. HTTP/3은 UDP 위에서 동작하는데 게이트웨이는 UDP를 전달하지 않으므로, 클라이언트는 TCP 기반의 HTTP/2나 HTTP/1.1로 폴백합니다.