v2rayN 로그 보는 법: 자주 발생하는 오류와 원인 확인

로그 수준 설정부터 connection refused, i/o timeout, TLS 핸드셰이크 실패까지 주요 오류의 의미와 점검 순서를 정리합니다.

이 글의 핵심

Windows용 v2rayN을 사용하다 코어 실행에 실패하거나 웹페이지가 시간 초과되는 경우에 적합한 안내입니다. 요청을 한 번 보내 로그와 증상을 대조한 뒤, 오류가 로컬 리스너, 노드 연결, 도메인 이름 확인, TLS 인증 중 어디를 가리키는지 살펴보세요. 한 번에 설정 하나만 바꾸고 같은 요청으로 효과를 확인합니다.

로그 수준 설정: 오류는 한 번만 재현하기

v2rayN 화면에 표시되는 메시지는 클라이언트나 실행 중인 코어에서 발생할 수 있습니다. 구독 다운로드, 설정 생성, 코어를 통한 연결은 서로 다른 단계입니다. 구독 업데이트 중 시간 초과가 발생했다고 해서 이미 가져온 노드로 연결할 수 없는 것은 아닙니다. 아래 예시는 Windows에서 v2rayN 7.x와 Xray를 사용하는 경우입니다. 빌드에 따라 옵션 위치가 다를 수 있으니, 먼저 실행 중인 코어를 확인한 뒤 로그 수준 설정이 해당 코어에 적용되는지 살펴보세요.

  1. 진단 로그 켜기

    「설정」→「매개변수 설정」→「Core: 기본 설정」으로 이동해 「로그 수준」을 찾아 잠시 info로 설정합니다. 같은 화면에 로그 활성화 옵션이 있다면 함께 켭니다. 저장한 뒤 새로운 코어 시작 메시지가 표시되는지 확인하세요. 현재 정보만으로 판단하기 어려울 때만 잠깐 debug로 바꿉니다.

  2. 테스트 조건 고정하기

    현재 노드와 라우팅 모드는 그대로 두고 테스트 시간을 기록합니다. Windows 시스템 프록시를 점검하려면 트레이 메뉴의 「시스템 프록시」에서 「시스템 프록시 자동 설정」을 선택한 뒤, 시스템 프록시 설정을 따르는 브라우저로 이전에 실패했던 주소를 엽니다. 문제가 TUN 모드에서 발생했다면 먼저 같은 모드로 재현하고, 프록시 연결 방식을 동시에 바꾸지 마세요.

  3. 첫 오류 기록하기

    메인 창의 메시지 영역에서 테스트 시간 전후의 기록을 찾습니다. 먼저 시작 결과를 저장하고, 이번 요청에서 처음 발생한 구체적인 오류와 앞뒤 몇 줄도 함께 남깁니다. 오류가 어느 주소와 포트, 어떤 작업을 가리키는지 기록하세요. 마지막 재시도 실패 문구만 복사해서는 원인을 파악하기 어렵습니다.

  4. 로그 수준 되돌리기

    테스트가 끝나면 로그 수준을 원래대로 되돌려 접속 대상이 계속 기록되지 않도록 합니다. 로그를 공유할 때는 구독 주소, 사용자 ID, 토큰, 노드 주소, 실제 접속 도메인을 가리세요. 어떤 구간에서 연결이 실패했는지 파악할 수 있도록 포트 종류와 오류 문구 전체는 남겨야 합니다.

로컬 포트: 요청이 코어에 전달됐는지 확인하기

클라이언트 창이 열려 있다고 해서 로컬 프록시가 연결을 수신 중인 것은 아닙니다. 먼저 「설정」→「매개변수 설정」에서 「로컬 리스닝 포트」를 확인한 다음, Windows 시스템 프록시에 입력된 주소와 포트를 대조하세요. 아래 숫자는 로그를 읽는 방법을 설명하기 위한 예시이며, 모든 PC에서 동일하게 사용하는 값은 아닙니다.

127.0.0.1
IPv4 루프백 주소: 요청이 이 PC 안에서 처리됨
10808
로컬 리스닝 포트 예시: 매개변수 설정에 표시된 값 확인
443
원격 TLS 포트 예시: 노드 설정에 표시된 값 확인

요점: 먼저 주소를 확인한 뒤 오류를 읽기

connection refused가 표시되면 먼저 오류 행에 나온 주소를 확인합니다. 대상이 127.0.0.1:10808이면 로컬 리스너부터 점검하세요. 노드 주소와 포트가 대상이라면 Windows 시스템 프록시 포트를 바꿔도 원격 연결 거부는 해결되지 않습니다.

PowerShell에서 이 PC의 리스닝 상태를 확인할 수 있습니다. 명령의 10808을 실제 포트로 바꾸세요. 이 확인은 원격 연결을 시도하지 않습니다.

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

자주 발생하는 오류: 연결 거부·시간 초과·TLS 인증 구분하기

같은 오류 문구도 발생 단계는 다를 수 있습니다. 오류 행 주변의 작업과 주소를 기준으로 판단하세요. 바깥쪽 실패 메시지만 보인다면 프로토콜부터 바꾸지 말고 같은 요청의 내부 오류를 더 확인합니다.

오류: bind: address already in use

원인: 이 PC에서 포트를 바인딩할 수 없습니다. 다른 프로세스나 별도로 실행된 인스턴스가 이미 해당 포트를 사용 중일 때 자주 발생합니다. Windows에서는 운영체제의 소켓 오류 문구가 표시될 수도 있습니다.

해결 방법: 포트에 연결된 PID를 확인하고, 더 이상 사용하지 않는 중복 인스턴스가 확실하면 종료하세요. 또는 사용 중이지 않은 포트로 바꾸고 수동 설정한 프록시 연결 지점도 함께 수정합니다.

오류: connection refused

원인: 이번 연결에서 거부 응답을 받았습니다. 대상에서 리스닝 중이 아닐 수도 있고, 연결 경로의 장비가 거부했을 수도 있습니다.

해결 방법: 로컬 주소라면 리스닝 프로세스를 확인하세요. 노드 주소라면 가져온 포트가 맞는지 확인하고, 서비스 운영자에게 해당 인바운드가 리스닝 중인지 문의합니다.

오류: i/o timeout

원인: 작업이 제한 시간 안에 끝나지 않았습니다. dial tcp 뒤에 표시되는 연결 시간 초과와 연결이 성립된 뒤 발생하는 read tcp 시간 초과는 서로 다른 단계의 문제입니다.

해결 방법: 연결 시간 초과라면 먼저 노드 주소와 포트를 확인하세요. 읽기 시간 초과라면 핸드셰이크와 첫 읽기 오류를 함께 기록하고, 같은 네트워크에서 정상 작동이 확인된 다른 노드와 비교합니다.

오류: no such host

원인: 현재 조회 경로에서 필요한 호스트 이름을 확인하지 못했습니다. 노드 도메인이나 접속하려는 도메인 중 하나가 원인일 수 있습니다.

해결 방법: 먼저 lookup이 가리키는 이름을 기록하고 철자를 확인하세요. 그다음 시스템 DNS 조회와 코어 DNS 조회를 구분합니다. 시스템에서 이름을 확인할 수 있어도 코어가 사용하는 DNS 리졸버에서 확인된다는 뜻은 아닙니다.

오류: x509: certificate has expired or is not yet valid

원인: 일반 TLS 인증서 검증에서 인증서의 유효 기간이 현재 시각과 맞지 않는다고 판단했습니다. 이 PC의 시계가 잘못되어도 같은 오류가 발생할 수 있습니다.

해결 방법: Windows 「설정」→「시간 및 언어」→「날짜 및 시간」에서 시계를 동기화하세요. 다시 테스트해도 실패하면 운영자에게 인증서와 인증서 체인의 유효 기간을 확인해 달라고 요청합니다.

핸드셰이크와 라우팅: TCP 연결만으로 웹페이지가 열린다고 볼 수 없음

노드 포트에 연결할 수 있다는 것은 전송 계층의 연결이 성립했을 가능성만 보여줍니다. 일반 TLS 노드는 이후에도 서버 이름과 인증서를 확인해야 합니다. 핸드셰이크가 통과한 뒤에는 요청이 의도한 아웃바운드로 전달됐는지도 확인해야 합니다. 오류를 없애려고 인증서 검증을 끄지 말고, 일반 TLS의 인증서 점검 방법을 REALITY 설정에 그대로 적용하지 마세요.

  1. 먼저 보안 유형을 확인합니다. 현재 노드의 편집 창을 열고 신뢰할 수 있는 원본 설정과 전송 방식 및 보안 유형을 대조하세요. 일반 TLS에서 인증서의 유효 도메인과 요청 이름이 다르다는 오류가 표시되면 서버 이름(SNI)과 인증서에 포함된 도메인을 확인합니다. 연결 주소가 확인된다고 해서 그 주소를 서버 이름으로 입력해야 하는 것은 아닙니다.
  2. 그다음 실제 아웃바운드를 확인합니다. 같은 요청의 로그에서 라우팅 또는 아웃바운드 정보를 찾습니다. 해당 도메인이 실제로 직접 연결됐다면 프록시 노드를 계속 바꾸기보다 v2rayN에서 선택한 「라우팅」 규칙과 적용 순서를 먼저 확인하세요. accepted가 표시된 것은 코어가 요청을 받았다는 뜻일 뿐, 대상 웹사이트가 응답했다는 뜻은 아닙니다.
  3. 마지막으로 비교 테스트로 범위를 좁힙니다. 같은 대상이 두 노드에서 모두 실패한다면 다른 테스트 대상을 사용해 보세요. 도메인 하나에서만 실패한다면 DNS 조회와 분기 규칙을 먼저 확인합니다. 노드는 그대로 두고 네트워크만 바꿔 테스트할 때는 주소를 유지하고 결과를 기록하세요. 그래야 네트워크 변경을 설정 수정 효과로 잘못 판단하지 않습니다.

로그 문제 해결 FAQ

속도 측정 결과는 나오는데 브라우저에서 페이지가 열리지 않는 이유는 무엇인가요?

속도 측정과 브라우저가 같은 연결 지점을 사용하거나 같은 대상에 접속한다고 볼 수 없습니다. 브라우저에서 새로고침한 시간을 기록하고 코어가 해당 요청을 받았는지 확인한 뒤 아웃바운드 결과를 살펴보세요. 인바운드 기록이 없다면 시스템 프록시와 브라우저의 프록시 설정부터 점검합니다.

마지막 줄에 사용 가능한 대상이 없다고 나오면 어느 줄을 확인해야 하나요?

failed to find an available destination은 여러 번 연결을 시도한 뒤 표시되는 요약인 경우가 많으며, 도메인 조회 실패만을 뜻하지는 않습니다. 같은 요청의 앞쪽에서 lookup, dial, 인증서 오류를 찾아보세요. 여러 로그가 뒤섞인다면 다른 테스트 페이지를 닫고 한 번만 재현합니다.

디버그 로그를 켰는데도 웹 요청이 보이지 않는 이유는 무엇인가요?

로그 수준을 변경한 뒤 코어가 정상적으로 시작됐는지 먼저 확인하고, 시스템 프록시를 따르는 앱 하나로 테스트합니다. 시스템 프록시 모드에서는 요청이 보이는데 기존 TUN 모드에서는 보이지 않는다면 두 연결 방식의 설정을 각각 확인하세요. 두 모드의 로그를 한 번의 테스트 결과로 섞어 판단하지 마세요.

운영자에게 로그를 보낼 때 어떤 정보를 남겨야 하나요?

v2rayN의 버전 정보에서 클라이언트 전체 버전 번호를 기록하고, 시작 메시지에서 코어 이름과 버전을 확인합니다. 여기에 실행 모드, 재현 시간, 민감 정보를 가린 첫 구체 오류를 첨부하세요. 같은 노드에서 네트워크를 바꾼 결과와 같은 네트워크에서 노드를 바꾼 결과도 설명합니다. 비교 테스트를 하지 않았다면 테스트하지 않았다고 적습니다.

V2Ray 클라이언트 다운로드