v2rayN 로그 확인 방법: 자주 발생하는 오류와 해결 순서

v2rayN 로그 형식과 오류 코드부터 연결 시간 초과, TLS 핸드셰이크 실패, 포트 충돌, 규칙 파일 누락까지 원인별 점검 방법을 안내합니다.

이 글의 핵심 내용

커널 시작 실패, 노드 테스트 시간 초과, 브라우저 무응답 문제를 겪는 v2rayN 사용자에게 적합합니다. 먼저 로컬 수신 대기가 시작됐는지 확인한 다음 주소 확인, 원격 연결, 핸드셰이크, 라우팅 순으로 원인을 좁혀 보세요. 한 번에 한 가지 설정만 변경하고, 매번 같은 요청으로 변경 사항을 확인하세요.

로그 레벨과 로그 형식

v2rayN 화면에 표시되는 메시지와 커널 로그는 서로 다른 단계의 정보입니다. 화면에 커널 시작 메시지가 표시되어도 클라이언트가 시작을 요청했다는 뜻일 뿐, 이후 설정을 해석하지 못해 커널이 종료될 수 있습니다. 구독 업데이트 오류는 클라이언트가 구독 정보를 가져오는 단계에서 발생할 수 있으므로 현재 노드의 핸드셰이크 오류로 단정하지 마세요.

항목확인 방법
시간 및 요청 ID테스트한 시각과 일치하는 로그를 찾으세요. 요청 ID가 있다면 같은 ID의 기록을 먼저 따라가 백그라운드 요청과 섞이지 않도록 합니다.
error / warning오류와 예외를 확인합니다. 경고가 있다고 커널이 종료된 것은 아니므로 이후에도 수신 대기나 요청 처리가 이어지는지 확인하세요.
info / debug상세 처리 과정을 확인할 때 사용합니다. 문제를 재현할 때만 잠시 켜고, 필요한 기록을 확보한 뒤 원래 레벨로 되돌려 불필요한 로그가 쌓이지 않게 하세요.
accepted액세스 로그에 이런 기록이 있으면 커널이 요청을 받았다는 뜻입니다. 원격 서버의 응답까지 도착했다는 의미는 아닙니다.

오류 메시지에서 >는 상위 작업과 내부 원인을 이어서 표시하는 경우가 많습니다. '연결 실패'에서 멈추지 말고 뒤에 나오는 lookup, dial tcp, x509 또는 파일 경로를 확인하세요. 같은 오류가 여러 구성 요소를 거쳐 반복 기록될 수 있으므로 구체적인 주소, 포트 또는 파일명이 포함된 부분부터 살펴보세요.

요청 한 번으로 로그 수집하기

  1. 현재 설정 기록하기

    선택한 노드, 실제 사용 중인 커널, 시스템 프록시 상태, TUN 상태를 기록하세요. 데스크톱에서는 '설정' → '매개변수 설정'에서 로컬 수신 관련 옵션을 확인할 수 있습니다. 버전에 따라 메뉴 이름이 다를 수 있으니 설정 화면의 포트와 시작 로그를 기준으로 확인하세요.

  2. 로그 레벨 확인하기

    '설정' → '매개변수 설정'에서 현재 버전의 로그 옵션을 확인하세요. 커널 로그 레벨을 설정할 수 있다면 우선 info로 잠시 변경합니다. 사용자 지정 Xray 설정에서는 관련 필드가 log.loglevel입니다. 다음 실행 때 클라이언트가 다시 생성하는 설정 파일을 직접 수정하지 마세요.

  3. 요청 한 번만 보내기

    커널이 계속 실행 중인지 확인한 뒤 브라우저에서 정상 작동이 확인된 테스트 페이지를 열고 시각을 기록하세요. 여러 연결이 한꺼번에 생성되지 않도록 일괄 속도 테스트는 잠시 중지합니다. 구독 업데이트 중에만 문제가 발생한다면 업데이트만 한 번 실행하고 웹페이지 테스트는 동시에 하지 마세요.

  4. 최초 원인 찾기

    시작 로그, 실패 로그와 앞뒤 오류 메시지를 함께 보관하세요. 외부에 공유하기 전에는 구독 주소, 노드 주소, 인증 정보, 접속 대상 등을 가리고 오류 키워드, 포트 종류와 발생 순서는 남겨 두세요. 설정을 바꾼 뒤 같은 작업을 다시 실행해 이전 오류가 사라지고 요청이 정상 처리되는지 확인합니다.

포트 충돌과 로컬 프록시 연결

127.0.0.1
IPv4 루프백 주소
10808
로컬 수신 포트 예시
443
원격 TLS 포트 예시

포트 번호만 보지 말고 오류에 나온 주소를 확인하세요

로그에 listen tcp 127.0.0.1:10808이 있다면 먼저 로컬 포트를 사용 중인 프로세스를 확인하세요. dial tcp 뒤에 원격 주소가 나온다면 노드 포트와 연결 상태를 점검해야 합니다. 로컬 프록시 포트를 바꿔도 원격 연결 문제는 해결되지 않습니다.

Windows PowerShell에서 지정한 포트를 수신 중인 프로세스를 확인합니다. 아래 포트는 예시이므로 실행하기 전에 로그에 표시된 로컬 포트로 바꾸세요.

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

작업 관리자의 '세부 정보' 탭에서 PID로 프로세스를 확인하세요. 클라이언트가 중복 실행 중이라면 불필요한 인스턴스를 정상 종료합니다. 계속 사용해야 하는 앱이 포트를 점유하고 있다면 v2rayN에서 사용 가능한 포트로 변경하고, 프록시 주소를 직접 설정한 앱의 포트도 함께 바꾸세요. 커널을 다시 시작한 뒤 새 포트가 수신 중인지, 앱이 같은 포트와 올바른 프록시 유형을 사용하는지 확인합니다.

연결 시간 초과, 핸드셰이크 실패, 규칙 파일 누락

아래 키워드는 전체 오류 메시지의 서로 다른 위치에 나타날 수 있으며, 앞부분과 문장 부호는 커널이나 플랫폼에 따라 달라집니다. 먼저 어떤 작업에서 오류가 났는지 확인한 다음 설정 변경을 검토하세요.

오류: i/o timeout

원인: 읽기, 쓰기 또는 연결 대기 시간이 초과된 상태입니다. 이 문구만으로는 문제가 발생한 위치를 알 수 없습니다.

해결 방법: 앞부분에 dial tcp가 있으면 원격 주소와 포트를 확인하세요. lookup이 있다면 도메인 확인과 DNS 경로를 먼저 점검합니다.

오류: connection refused

원인: 연결이 거부된 상태입니다. 대상 서버가 해당 포트에서 수신 대기 중이지 않은 경우가 흔하며, 중간 장비가 연결을 차단했을 수도 있습니다.

해결 방법: 대상 주소가 루프백 주소인지 노드 주소인지 먼저 확인한 뒤, 로컬 수신 상태를 점검하거나 서비스 제공자에게 원격 서비스 포트를 문의하세요.

오류: x509: certificate signed by unknown authority

원인: TLS 클라이언트가 상대방의 인증서 체인을 신뢰할 수 있는 루트 인증서까지 검증하지 못했습니다.

해결 방법: 연결 대상이 예상한 서버인지 확인하고 서비스 관리자가 인증서 체인을 점검하도록 요청하세요. 조직 내부 인증서를 사용하는 경우 관리자가 안내한 절차에 따라 신뢰 설정을 추가하세요. 인증서 검증을 끄지 마세요.

오류: address already in use

원인: 바인딩하려는 로컬 주소와 포트를 기존 수신 프로세스가 사용 중입니다.

해결 방법: 오류에 나온 포트의 사용 프로세스를 확인하고, 불필요한 인스턴스임을 확인한 경우 종료하세요. 또는 로컬 인바운드 포트를 변경하고 앱의 프록시 설정도 함께 업데이트합니다.

오류: failed to load geoip

원인: 커널이 설정에서 참조하는 IP 규칙 데이터를 불러오지 못했습니다. 파일을 열지 못했거나 지정한 분류를 데이터에서 찾지 못했을 수 있습니다.

해결 방법: 내부 오류에 표시된 경로와 분류명을 확인하세요. 파일을 찾을 수 없다는 메시지가 나오면 실제 리소스 디렉터리를 확인하고 규칙 설정에 맞는 데이터 파일을 복원합니다. 분류를 찾을 수 없다는 메시지가 나오면 규칙 참조를 점검하세요.

geoip.dat는 IP 분류에, geosite.dat는 도메인 분류에 사용됩니다. 사용자 지정 설정에서 다른 데이터 파일을 참조할 수도 있습니다. 클라이언트 디렉터리에 같은 이름의 파일이 있어도 실행 중인 커널이 그 디렉터리에서 파일을 읽는다는 보장은 없습니다. 오류 메시지에 표시된 경로를 기준으로 확인하세요. 권한 오류가 있다면 파일을 다시 다운로드하지 말고 실행 계정에 읽기 권한이 있는지 확인합니다. 규칙 로딩 중 커널이 종료됐다면 먼저 시작 오류를 해결한 뒤 노드를 테스트하세요.

TCP 연결은 성공했지만 TLS 핸드셰이크에 실패했다면 노드 설정의 전송 보안 유형, serverName, 서버 요구 사항이 서로 일치하는지 확인하세요. 인증서 유효 기간 오류가 있다면 시스템 날짜와 시간 동기화도 점검합니다. 포트 연결 성공은 TCP 연결이 가능하다는 뜻일 뿐, TLS, 노드 인증 또는 앱 요청이 성공했다는 의미는 아닙니다. 포트 검사 한 번으로 실제 접속 테스트를 대신하지 마세요.

자주 묻는 로그 질문

노드 테스트에 지연이 있는데 웹페이지는 왜 열리지 않나요?

테스트에 사용한 노드와 현재 활성 노드가 같은지 먼저 확인하세요. 그런 다음 페이지를 열고 같은 시각의 커널 액세스 로그를 찾습니다. 기록이 있으면 라우팅과 아웃바운드 오류를 확인하세요. 기록이 없다면 액세스 로그가 활성화되어 있는지 확인한 뒤 브라우저가 시스템 프록시를 따르는지, 이전 수동 프록시 포트를 계속 사용하는지 점검합니다.

구독을 업데이트할 때만 시간 초과가 발생하면 노드를 확인해야 하나요?

시간 초과가 구독 요청과 노드 연결 중 어느 쪽에서 발생했는지 먼저 확인하세요. 수동 업데이트를 한 번 실행한 시각을 기록하고 구독 그룹의 주소, 업데이트에 선택된 연결 방식, 해당 방식의 현재 작동 여부를 점검합니다. 기존 노드가 계속 작동한다면 업데이트 문제를 해결하려고 구독 그룹 전체를 먼저 삭제하지 마세요.

로그에 accepted가 표시되는데 잘못된 아웃바운드를 사용했는지 어떻게 확인하나요?

같은 요청의 뒤쪽 로그에서 아웃바운드 태그를 확인하세요. 현재 로그에 태그가 표시되지 않는다면 로그 레벨을 잠시 높입니다. 실제 적용된 설정에서 규칙의 우선순위를 확인하고 routing.rules의 outboundTag가 예상한 outbounds 태그를 가리키는지 점검하세요. 요청 수신 기록만으로 트래픽이 올바르게 분기됐다고 판단하지 마세요.

TUN을 켰을 때만 문제가 생기면 어떤 로그부터 봐야 하나요?

먼저 오류가 발생한 상태의 로그를 저장한 뒤 TUN을 끄고, 같은 노드와 시스템 프록시로 같은 페이지를 테스트하세요. TUN에서만 실패한다면 TUN을 켤 때 처음 나타난 가상 네트워크 어댑터, 권한, 라우팅 또는 DNS 오류를 확인합니다. 가상 네트워크 어댑터가 생성되지 않은 경우와 생성됐지만 요청이 제대로 전달되지 않는 경우를 구분한 뒤 관련 설정을 점검하세요.

v2rayN 다운로드Windows / macOS / Android / Linux