V2Ray 로그 보는 법: 주요 오류 메시지와 원인 확인 방법

로그 수준과 구조를 알아보고 connection refused, i/o timeout, tls handshake failure 등 자주 발생하는 오류의 의미와 점검 방법을 확인하세요.

이 글의 핵심

연결되지 않거나 웹페이지가 열리지 않는다면 먼저 요청을 한 번 재현한 뒤, 시간과 주소, 오류 앞뒤의 로그를 보고 어느 단계에서 실패했는지 확인하세요. 클라이언트는 실행되지만 로컬 프록시, 원격 연결, TLS 설정 중 무엇을 점검해야 할지 막막한 분을 위한 안내입니다. 로그를 보고 가장 먼저 확인할 설정을 찾을 수 있습니다.

로그 수준 설정 및 오류 재현

전체 과정을 한 번 확인하려면 info를 사용하고, 정보가 부족하면 debug로 바꾸세요. 평소에는 warning으로 충분한 경우가 많습니다. error는 오류 기록만 남기므로 앞서 발생한 단서를 놓칠 수 있습니다. 코어 로그 수준과 접속 로그는 서로 다른 설정이며, 상세 수준을 높여도 모든 접속 기록이 표시되는 것은 아닙니다.

  1. 코어 로그 찾기

    v2rayN 6.x의 일반적인 화면을 기준으로 설명합니다. 「설정」→「매개변수 설정」→「Core: 기본 설정」에서 「로그 수준」을 찾으세요. 저장한 뒤 코어를 다시 시작하거나 연결을 끊었다가 다시 연결하고, 메인 화면의 로그 영역을 확인합니다. v2rayNG에서는 왼쪽 위 메뉴에서 「로그」를 열어 확인할 수 있습니다. 버전에 따라 메뉴 이름이 다를 수 있으니 속도 측정 결과가 아니라 연결 로그를 보고 있는지 먼저 확인하세요.

  2. 한 번만 재현하기

    기기의 현재 시간을 기록하고 노드와 네트워크를 그대로 유지한 채 일괄 속도 측정을 중지하세요. 그런 다음 문제가 발생한 앱으로 같은 대상에 한 번 접속합니다. 브라우저에 여러 페이지가 열려 있었다면 관련 없는 탭을 닫아 백그라운드 요청이 이번 오류와 섞이지 않게 하세요.

  3. 오류 앞뒤 로그 보관하기

    요청을 시작한 시간을 기준으로 같은 요청의 인바운드, 선택된 아웃바운드, 오류 행을 함께 확인하세요. 공유하기 전에는 구독 주소, 계정 식별 정보, 접속 대상, 내부 주소를 가립니다. 기기와 원격 서버는 일관된 별칭으로 구분하되 오류 원문과 로그 순서는 유지하세요.

  4. 한 번에 하나씩 바꾸기

    오류가 발생한 단계에 맞춰 설정 하나만 바꾸고, 같은 앱과 대상으로 다시 확인하세요. 예를 들어 앱의 프록시 포트부터 바로잡고 노드, DNS, 전송 방식을 동시에 바꾸지 마세요. 결과를 확인한 뒤 로그 수준을 원래 설정으로 되돌립니다.

로그 구조: 시간, 주소, 아웃바운드 태그

먼저 로그에 나온 주소를 구분하세요. 앱은 로컬 프록시 인바운드에 연결하고, 요청에는 대상 웹사이트가 지정되며, 프록시 아웃바운드는 노드 서버에 연결합니다. 프록시를 거칠 때 이 세 주소는 서로 다를 수 있습니다. 같은 connection refused라도 발생한 단계에 따라 점검 대상이 달라집니다.

앱 요청로컬 인바운드라우팅 규칙 확인아웃바운드 연결전송 핸드셰이크

아래는 로그 필드를 설명하기 위한 예시이며 주소는 실제 주소가 아닙니다. 첫 번째 줄은 로컬 요청을 수신한 기록이고, 두 번째 줄은 코어가 원격 서버에 연결하다 시간 초과된 기록입니다. 두 줄의 시간이 같더라도 실제로 문제를 분석할 때는 연결 ID(있는 경우), 주소, 앞뒤 로그를 확인해 같은 요청에 해당하는지 살펴보세요.

2026/10/09 10:14:28 from tcp:127.0.0.1:53162 accepted tcp:example.org:443 [socks -> proxy]
2026/10/09 10:14:28 [Warning] dial tcp 203.0.113.10:443: i/o timeout
10808
로컬 프록시 포트 예시. 실제 설정을 확인하세요.
443
일반적인 HTTPS 대상 포트이며 노드 포트로도 사용될 수 있습니다.

자주 발생하는 오류와 우선 점검 항목

재시도 후 마지막 로그는 실패를 요약한 내용일 수 있습니다. failed to find an available destination가 나오면 같은 요청의 앞부분에서 lookup, dial, read, handshake를 찾아보세요. 이 요약 문구만으로 DNS 오류라고 단정할 수는 없습니다.

오류: connection refused

의미: 연결 요청이 거부되었습니다. 해당 포트에서 프로그램이 수신 대기 중이지 않은 경우가 흔하며, 네트워크 장비가 연결을 거부했을 수도 있습니다. 먼저 확인할 항목: 주소가 127.0.0.1이면 앱의 프록시 포트와 클라이언트의 수신 포트를 비교하고 코어가 정상적으로 실행됐는지 확인하세요. 노드 주소라면 구독 정보의 포트를 확인하고, 직접 관리하는 서버라면 해당 포트에서 수신 대기 중인지 점검하세요.

오류: i/o timeout

의미: 네트워크 작업이 제한 시간 안에 완료되지 않았습니다. 이 메시지만으로 노드가 오프라인이라고 단정할 수는 없습니다. 먼저 확인할 항목: 앞에 dial tcp가 있으면 로그에 표시된 접속 주소와 포트를 확인한 뒤 같은 노드로 다른 네트워크에서도 테스트하세요. read tcp라면 읽기 단계에서 시간 초과가 발생한 것이므로, 그전에 핸드셰이크를 기다렸는지 응답을 기다렸는지 확인하세요.

오류: remote error: tls: handshake failure

의미: 원격에서 TLS 핸드셰이크 중 실패 알림을 보냈습니다. 이 메시지만으로 어떤 설정이 맞지 않는지는 알 수 없습니다. 먼저 확인할 항목: 노드 연결 오류가 맞는지 확인하고 노드 포트, 보안 유형, serverName(SNI)이 서비스 안내와 일치하는지 점검하세요. REALITY를 사용하는 설정은 원래 설정값과 대조해야 하며 일반 TLS 노드처럼 항목을 바꾸면 안 됩니다.

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

의미: 기기의 현재 시간을 기준으로 인증서가 유효 기간에 있지 않습니다. 먼저 확인할 항목: 시스템에서 시간 자동 설정을 켜고 날짜를 맞춘 다음 다시 테스트하세요. 시간이 정확한데도 오류가 계속되면 서버 운영자에게 해당 포트에서 제공하는 인증서를 확인해 달라고 요청하세요. 문제를 숨기려고 인증서 검증을 끄지 마세요.

오류: no such host

의미: 로그의 lookup에 표시된 이름을 주소로 변환하지 못했습니다. 먼저 확인할 항목: 오류가 노드 도메인 이름에서 발생했는지, 접속 대상 도메인에서 발생했는지 확인하고 이름의 철자와 해당 이름을 조회하는 DNS를 점검하세요. 도메인을 임의로 IP 주소로 바꾸지 마세요. 연결에 성공하더라도 이후 TLS 이름 검증이나 서비스 매칭이 달라질 수 있습니다.

재테스트 결과로 다음 단계 찾기

네트워크를 바꾸자 같은 노드가 작동한다면 두 네트워크의 DNS 조회 결과나 연결 상태를 우선 비교하세요. 같은 네트워크에서 특정 앱만 실패한다면 해당 앱이 사용하는 인바운드와 아웃바운드를 먼저 확인하세요. 한 번의 비교로 점검 범위를 좁힐 수는 있지만 서버 장애라고 단정할 수는 없습니다.

속도 측정은 성공했는데 웹페이지가 열리지 않는 이유는?

속도 측정 요청과 브라우저가 실제로 접속하는 대상은 다를 수 있습니다. 오류가 발생한 페이지를 다시 열고 해당 시간대의 접속 대상과 아웃바운드 태그를 확인하세요. 관련 로그가 없다면 브라우저의 프록시 설정부터 점검하고, 로그가 있는데 직접 연결로 나간다면 현재 라우팅 규칙을 확인하세요.

연결할 때마다 포트 사용 중 오류가 납니다. 노드 포트를 바꿔야 하나요?

먼저 bind: address already in use와 같은 시작 오류가 있는지 확인하세요. 로그에 로컬 수신 주소가 표시된다면 클라이언트가 중복 실행 중인지, 다른 프로그램이 해당 포트를 사용 중인지 살펴보세요. 로컬 수신 포트를 변경해야 한다면 해당 포트를 수동으로 설정한 앱도 함께 수정하세요. 노드 포트는 바꾸지 마세요.

EOF만 남았다면 어디부터 확인해야 하나요?

EOF는 스트림의 끝에 도달했다는 뜻이며, 이것만으로 원인을 알 수는 없습니다. 오류를 한 번 재현하고 같은 연결의 앞부분을 확인하세요. 매번 핸드셰이크 도중 연결이 끊긴다면 포트, 전송 방식, 같은 시각의 서버 로그를 비교하세요. 페이지를 닫을 때 가끔 나타나지만 접속은 정상이라면 우선 설정을 변경하지 않아도 됩니다.

안드로이드에서 백그라운드로 전환할 때만 연결이 끊기면 어디를 확인해야 하나요?

먼저 화면을 끄기 전후의 로그 시간을 비교하세요. 로그가 멈췄다가 코어 시작 또는 VPN 재연결 기록이 나타난다면 시스템의 「설정」→「앱」→「v2rayNG」에서 배터리 관리 및 백그라운드 실행 제한을 확인하세요. 메뉴 위치는 기기마다 다를 수 있습니다. 클라이언트가 계속 실행 중이라면 연결이 끊기기 직전에 Wi-Fi와 모바일 네트워크 간 전환이 있었는지 비교하고, 새 연결 시도에서 시간 초과가 발생했는지도 확인하세요.

설치 파일 보기