시스템 프록시가 작동하지 않을 때: 브라우저와 터미널별 점검 방법

브라우저에서는 프록시가 작동하지만 터미널에서는 작동하지 않거나 둘 다 연결되지 않나요? 브라우저 확장 프로그램, 시스템 설정, 환경 변수 순서로 원인을 확인하세요.

이 글의 핵심

v2rayN을 실행했지만 브라우저와 터미널의 연결 방식이 다른 경우에 적합한 안내입니다. 먼저 curl로 로컬 프록시에 직접 연결해 포트와 프로토콜이 작동하는지 확인한 다음, 브라우저의 프록시 설정 출처와 터미널 프로세스의 환경 변수를 각각 점검하세요. Windows에서는 포트 리스닝 확인 명령을 소개하며, macOS와 Linux에서도 curl 비교 테스트를 활용할 수 있습니다.

로컬 리스닝: 애플리케이션이 연결하는 포트 확인

애플리케이션 요청프록시 선택로컬 리스닝라우팅 규칙 매칭아웃바운드 연결

시스템 프록시는 시스템 설정을 참조하는 애플리케이션에 프록시 주소를 제공할 뿐, 모든 프로세스의 연결을 자동으로 가로채지는 않습니다. 애플리케이션은 시스템 설정을 읽을 수도 있고 자체 프록시 설정을 사용하거나 프록시 없이 직접 연결할 수도 있습니다. 요청이 v2rayN에 도달해야 코어가 라우팅 규칙에 따라 프록시를 통한 아웃바운드 연결 또는 직접 연결을 선택합니다. 따라서 ‘애플리케이션이 로컬 포트에 연결됨’과 ‘요청이 프록시를 통해 나감’은 서로 다른 의미입니다.

10808
예시 혼합 리스닝 포트
443
예시 HTTPS 대상 포트
15초
요청당 전체 제한 시간

v2rayN에서 ‘설정’ → ‘매개변수 설정’을 열어 로컬 리스닝 포트를 확인하세요. 사용 중인 버전에서 HTTP와 SOCKS 포트가 따로 표시된다면 프로토콜별로 기록합니다. 혼합 리스닝으로 명확히 설정된 경우에만 같은 포트로 두 프로토콜을 모두 테스트하세요. 아래 예시는 127.0.0.1:10808을 사용합니다. 실제 설정에 맞게 바꾸고, v2rayN을 실행 중인 것과 같은 시스템 환경에서 테스트하세요.

Windows PowerShell에서 리스닝 상태를 확인하세요. 결과에 ::1만 표시된다면 해당 리스닝 주소는 IPv6 루프백이며, 이것만으로 127.0.0.1이 작동한다고 판단할 수 없습니다. 프로세스가 여러 개 표시되거나 포트를 변경했다면 실제 포트와 프로세스 ID를 대조해 어떤 프로세스인지 확인하세요. 포트 번호만 보고 v2rayN 코어라고 단정하지 마세요.

Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

프록시 직접 지정: curl로 비교 테스트

아래 명령은 curl 8.x에서 흔히 사용하는 옵션을 기준으로 합니다. 먼저 curl --version을 실행해 실제 curl이 호출되는지 확인하세요. Windows에서는 명령 프롬프트에서 아래 세 줄을 실행하면 일부 PowerShell 환경에서 curl이 별칭으로 해석되거나 빈 문자열 인수가 누락되는 문제를 피할 수 있습니다. macOS와 Linux에서는 일반 터미널에서 바로 실행하면 됩니다.

curl --disable -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10808 https://example.com/
curl --disable -v --max-time 15 --noproxy "" --proxy socks5h://127.0.0.1:10808 https://example.com/
curl --disable -v --max-time 15 --noproxy "*" https://example.com/

앞의 두 명령은 각각 HTTP와 SOCKS 연결을 확인하므로, 실제 리스닝 유형에 맞는 명령만 실행하세요. --disable을 맨 앞에 두면 curl의 기본 설정 파일을 건너뜁니다. --noproxy ""는 이번 요청에서 프록시 제외 목록을 비웁니다. 세 번째 명령은 애플리케이션 계층 프록시를 사용하지 않는 비교 테스트입니다. 시스템 차원에서 별도로 트래픽을 가로채는 경우 이 명령만으로 패킷이 최종적으로 직접 연결된다고 판단할 수는 없습니다.

HTTP 프록시가 HTTPS 대상에 연결할 때는 먼저 CONNECT example.com:443 요청을 보냅니다. 프록시가 200 Connection established를 반환했다는 것은 터널이 만들어졌다는 뜻일 뿐입니다. 이후 TLS 핸드셰이크와 대상 서버의 응답도 확인해야 합니다. socks5h는 대상 호스트 이름의 해석을 SOCKS 프록시에 맡기며, curl이 먼저 대상 이름을 해석하는 socks5와는 다릅니다. 두 방식의 결과가 다르면 포트, 라우팅, DNS를 한꺼번에 바꾸지 말고 차이를 기록하세요.

정리: 프록시를 직접 지정해 문제 범위 좁히기

프록시를 직접 지정한 명령으로 대상 응답을 받았지만 같은 터미널의 일반 명령은 실패한다면, 먼저 일반 명령이 프록시를 선택하는 방식을 확인하세요. 요청이 로컬 리스닝 포트에 연결되기 전부터 실패한다면 주소, 포트, 리스닝 프로세스를 먼저 점검하세요. 브라우저 설정은 그다음에 확인해도 됩니다.

브라우저: 확장 프로그램 설정과 시스템 설정 구분하기

  1. 프록시 확장 프로그램 사용 중지

    현재 브라우저 프로필의 확장 프로그램 관리 페이지에서 프록시를 제어하는 확장 프로그램을 잠시 사용 중지하세요. 확장 프로그램 아이콘만 확인해서는 안 됩니다. 도메인별 규칙에 따라 사이트마다 연결 방식이 달라질 수 있습니다. 조직 정책으로 관리되는 브라우저라면 먼저 잠금 설정이 있는지 확인하세요.

  2. 브라우저의 프록시 설정 출처 확인

    Firefox에서 ‘설정’ → ‘일반’ → ‘네트워크 설정’ → ‘설정…’을 열어 현재 프록시 설정을 확인하세요. 시스템 프록시를 테스트하려면 ‘시스템 프록시 설정 사용’을 선택하세요. 수동 설정을 테스트하려면 리스닝 유형에 맞는 주소와 포트를 입력합니다. SOCKS 포트를 HTTP 프록시 입력란에 넣지 마세요.

  3. 시스템 프록시 확인

    Windows에서 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 여세요. v2rayN 트레이 메뉴에서 ‘시스템 프록시’ → ‘시스템 프록시 자동 구성’을 선택했다면 시스템 설정에 실제로 적용된 프록시 주소, 포트, 예외 항목을 확인하세요. 설정 스크립트를 사용한다면 대상 도메인이 스크립트에서 직접 연결 대상으로 분류되는지도 확인하세요.

  4. 같은 주소로 다시 테스트

    같은 브라우저 프로필로 돌아가 curl 테스트에 사용한 주소를 다시 불러오고, v2rayN 로그에서 요청 시각과 대상 도메인을 확인하세요. 프록시 확장 프로그램을 다시 사용해야 한다면 한 번에 하나씩만 활성화하고 같은 대상에 테스트하세요. 시스템 설정과 확장 프로그램 규칙의 변화를 한꺼번에 확인하지 않도록 합니다.

브라우저에서 페이지가 열리지만 v2rayN 로그에 해당 요청이 없다면, 먼저 현재 로그 수준에서 연결이 기록되는지 확인한 다음 페이지 캐시와 기존 연결의 영향을 배제하세요. 페이지가 열린다고 브라우저가 시스템 프록시를 사용했다고 볼 수는 없습니다. 대상 서버에 직접 연결했거나 브라우저 자체의 수동 프록시 설정을 사용했을 수도 있습니다.

터미널: 프로세스가 읽는 환경 변수 확인

브라우저가 시스템 설정을 읽더라도 명령줄 도구는 자체 설정이나 환경 변수만 사용할 수 있습니다. curl은 보통 HTTPS 대상에 https_proxy를 확인하고, 해당 프로토콜에 맞는 변수가 없으면 all_proxy를 사용할 수 있습니다. no_proxy는 프록시를 거치지 않을 대상을 지정합니다. curl에서 HTTP 대상의 프록시 변수는 소문자로 http_proxy라고 써야 합니다. 이 규칙이 모든 도구에 똑같이 적용되는 것은 아닙니다.

오류가 발생한 터미널에서 변수를 확인하세요. 다른 창에서 확인하면 실제 요청 프로세스의 환경과 다를 수 있습니다. 아래 두 명령은 변수 이름만 표시하므로 인증 정보가 포함될 수 있는 프록시 주소를 이슈에 그대로 복사할 위험을 줄입니다.

# Windows PowerShell
Get-ChildItem Env: | Where-Object {
  $_.Name -match '^(http_proxy|https_proxy|all_proxy|no_proxy)$'
} | Select-Object -ExpandProperty Name
# macOS 또는 Linux: 일반적인 POSIX 호환 셸에서 실행
env | cut -d= -f1 | grep -Ei '^(http_proxy|https_proxy|all_proxy|no_proxy)$'

자주 발생하는 오류: 실패 단계별 점검

오류: curl: (7) Failed to connect to 127.0.0.1 port 10808

원인:curl이 예시 로컬 포트에 TCP 연결을 설정하지 못했습니다. 해결:같은 주소와 포트의 리스닝 정보를 조회하고, v2rayN 코어가 실행 중인지와 명령을 같은 시스템 환경에서 실행했는지 확인하세요.

오류: curl: (56) CONNECT tunnel failed, response 407

원인:응답을 보낸 HTTP 프록시에서 인증을 요구합니다. 해결:curl이 의도한 프록시에 연결됐는지 확인하세요. 오래된 프록시 주소에 연결됐다면 프록시 설정을 수정하고, 인증이 필요한 프록시라면 해당 프록시의 인증 방식에 맞게 설정하세요.

오류: curl: (6) Could not resolve host: example.com

원인:이번 요청에서 curl이 대상 도메인을 해석하는 단계에 실패했습니다. 해결:먼저 상세 출력을 확인해 예외 규칙으로 인해 직접 연결했는지, 또는 curl이 대상 이름을 해석하는 SOCKS 모드를 사용했는지 확인하세요.

브라우저와 프록시를 직접 지정한 curl이 모두 로컬 포트에 연결됐는데도 같은 대상에 접속할 수 없다면, v2rayN 로그에서 테스트 시각을 기준으로 대상 도메인을 찾으세요. 로컬 인바운드 연결, 라우팅 규칙 매칭, 아웃바운드 연결을 구분한 다음 적용된 규칙이나 오류를 확인하세요. 이 단계의 아웃바운드 연결 실패는 브라우저 확장 프로그램을 바꿔도 대개 해결되지 않습니다.

다시 테스트할 때는 세 가지를 기록하세요. 프록시를 직접 지정한 요청이 대상 응답을 받았는지, 브라우저가 어떤 프록시 설정을 사용했는지, 기존 터미널에서도 같은 문제가 재현되는지입니다. 한 번에 하나씩만 바꾸세요. 문제가 해결되면 임시로 사용 중지한 확장 프로그램이나 테스트 중 변경한 설정을 복원한 다음, 처음 실패했던 작업을 다시 실행해 확인하세요.

v2rayN 다운로드