v2rayN 로그 오류 해결: 오류 메시지별 원인과 점검 순서

마지막 줄만 보지 말고 오류 전체 흐름을 확인하세요

v2rayN은 설정, 구독, 프록시 옵션을 관리하는 클라이언트이며 실제 연결은 선택한 커널이 처리합니다. 메인 창의 안내와 커널 로그는 서로 다른 단계에서 나온 내용일 수 있습니다. 구독 업데이트 성공은 설정을 가져왔다는 뜻일 뿐이며, 커널이 정상적으로 시작됐다고 해서 원격 서버까지 연결된 것은 아닙니다.

메인 창 아래쪽의 로그 또는 정보 영역에서 실패가 발생한 시각을 확인하고, 같은 오류의 앞뒤 내용을 펼쳐 보세요. 버전에 따라 메뉴 위치나 표현이 다를 수 있습니다. 이 글은 Windows 데스크톱 환경을 기준으로 설명합니다. 설정을 확인할 때는 화면 위치를 추측하지 말고 「설정」→「매개변수 설정」에서 실제 구성을 확인하세요.

1. 테스트 조건 고정하기

   서버 하나와 테스트할 웹페이지 하나를 정하고, 다른 앱의 반복 재시도는 잠시 중단하세요. 시스템 프록시와 TUN의 현재 상태를 기록하고, 점검하는 동안 두 설정을 동시에 바꾸지 마세요.

2. 처음 실패한 지점 찾기

   현재 시각을 기록한 뒤 대상 웹페이지를 한 번 새로 여세요. 이번 시도 전후의 오류만 확인해 시작 전의 오래된 로그를 새 문제로 착각하지 않도록 합니다.

3. 오류 앞뒤 내용 보존하기

   오류 전후의 몇 줄을 함께 보관하고, 대상 주소와 포트, 가장 안쪽에 표시된 원인을 확인하세요. 내용을 공유하기 전에는 구독 주소, 사용자 식별 정보, 인증 정보를 가리세요.

4. 한 번에 하나씩 변경하기

   포트, DNS, 서버, 전송 설정 중 한 번에 하나만 변경하세요. 저장한 뒤 커널을 다시 시작하고 같은 대상으로 재시험해 오류가 달라졌는지 기록합니다.

로컬 수신 대기 실패: 프록시 포트부터 확인하기

커널이 시작하자마자 종료된다면 먼저 노드를 바꾸지 마세요. 앱은 원격 서버에 접속하기 전에 로컬 프록시 포트에 연결할 수 있어야 합니다. 로그의 127.0.0.1은 로컬 루프백 주소입니다. 같은 연결 거부 오류라도 로컬 포트에서 발생했는지 서버에서 발생했는지에 따라 점검 방향은 완전히 달라집니다.

PowerShell에서 아래 읽기 전용 명령을 실행하세요. 예시는 10808 포트를 확인합니다. 로컬 포트가 다르면 숫자를 먼저 바꾸세요. 첫 번째 명령에서 출력이 없으면 해당 시점에 TCP 수신 항목을 찾지 못했다는 뜻입니다. UDP 상태나 원격 연결 여부를 확인하는 명령은 아닙니다.

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

Get-NetTCPConnection -LocalPort 10808 -State Listen -ErrorAction SilentlyContinue |
  ForEach-Object { Get-Process -Id $_.OwningProcess }

연결 거부와 시간 초과: 즉시 거부와 무응답 구분하기

로컬 수신 대기가 정상이라면 로그에서 연결을 시도한 원격 주소와 포트를 확인하세요. 연결 거부는 거부 응답을 받은 경우가 많고, 시간 초과는 제한 시간 안에 작업을 마치지 못했다는 뜻입니다. 이 두 오류만으로 계정이 만료됐다고 볼 수 없으며, 모든 시간 초과를 DNS 문제로 돌려서도 안 됩니다.

도메인 조회 실패: 어떤 도메인에서 실패했는지 확인하기

DNS는 도메인 이름을 IP 주소로 변환합니다. 로그에서 조회에 실패한 대상은 노드 서버일 수도, 접속하려는 웹사이트일 수도, DNS 서버 자체의 도메인일 수도 있습니다. 먼저 어떤 도메인인지 확인해야 웹페이지가 열리지 않는다는 이유만으로 DNS 설정을 전부 바꾸는 일을 피할 수 있습니다.

• 시스템 측 점검: PowerShell에서 Resolve-DnsName -Name example.com을 실행해 시스템 DNS 조회가 정상인지 확인하세요. 노드 문제를 점검할 때는 해당 노드에서 실제 사용하는 호스트 이름을 조회해야 합니다.
• 커널 측 점검: 현재 DNS 및 라우팅 설정을 확인하세요. 시스템에서 도메인이 조회되더라도 커널에 지정된 원격 DNS 서버에 연결할 수 있다는 뜻은 아닙니다.
• 주소를 임의로 바꾸지 마세요: 조회된 IP 주소를 TLS 노드의 여러 항목에 무작정 입력하지 마세요. 서버 주소, SNI, HTTP Host는 각기 다른 역할을 할 수 있으므로 서비스 측 설정에 따라야 합니다.

특정 웹사이트만 접속되지 않고 노드 서버에는 연결할 수 있다면 해당 웹사이트의 DNS 조회 결과, 적용된 라우팅 규칙, 대상 서비스 쪽을 점검하세요. 라우팅 규칙은 연결을 어느 출구로 보낼지 정하는 기능이지, 모든 도메인이 자동으로 조회되게 하는 기능은 아닙니다.

TLS 핸드셰이크 실패: 시간, 서버 이름, 전송 설정 확인하기

TCP 연결에 성공한 뒤에도 TLS 핸드셰이크는 실패할 수 있습니다. TLS는 보안 연결을 설정하며, VMess와 VLESS 같은 프록시 프로토콜에는 별도의 설정 조건이 있습니다. 포트에 연결할 수 있다고 해서 TLS, 전송 계층, 프록시 인증까지 모두 성공한 것은 아닙니다.

EOF와 connection reset by peer는 연결이 종료됐다는 결과를 나타내는 경우가 많으며, 특정 인증 오류를 뜻하지는 않습니다. 전송 유형 불일치, WebSocket 경로 오류, 리버스 프록시 설정 문제, 대상 서비스의 연결 종료 등 여러 원인이 비슷한 오류를 일으킬 수 있습니다. EOF가 보인다는 이유만으로 클라이언트를 다시 설치하지 말고 어느 단계에서 발생했는지 함께 확인하세요.

• WebSocket을 사용하는 경우 서버 설정과 경로 및 Host를 대조하세요. 경로의 대소문자와 문자를 임의로 바꾸면 안 됩니다.
• gRPC를 사용하는 경우 서비스 이름과 서버 설정을 확인하세요. WebSocket 경로를 그대로 가져다 쓸 수 없습니다.
• VLESS 또는 VMess를 사용하는 경우 프로토콜 유형, 사용자 식별 정보, 관련 설정이 서로 일치하는지 확인하세요. 구독을 업데이트하기 전에 필요한 사용자 지정 설정을 저장해 두세요.
• 현재 설정을 선택한 커널이 지원하는지 확인하세요. v2rayN 인터페이스, 커널 프로그램, 구독 내용은 서로 다른 구성 요소입니다. 한 항목을 업데이트해도 나머지 항목이 함께 바뀌지는 않습니다.

요청이 로그에 보이지 않을 때: 시스템 프록시와 라우팅 진입점 확인하기

웹페이지를 열어도 커널에 해당 요청이 나타나지 않는다면 앱에서 트래픽을 클라이언트로 보내지 않았을 수 있습니다. 현재 로그 수준에서 접속 세부 정보가 기록되지 않는 경우도 있습니다. 따라서 로그가 보이지 않는다고 노드가 정상이라고 단정하거나 트래픽이 프록시를 우회한다고 결론 내릴 수는 없습니다.

1. 프록시 진입점 확인하기

   v2rayN 메인 창이나 트레이 메뉴의 「시스템 프록시」에서 현재 상태를 확인하세요. 시스템 프록시가 필요하면 「시스템 프록시 자동 설정」을 선택한 뒤 Windows에 등록된 주소와 포트가 로컬 수신 설정과 일치하는지 확인합니다.

2. 앱 설정 확인하기

   브라우저나 대상 앱에 직접 연결, 다른 프록시 포트, 프록시 확장 프로그램이 별도로 설정되어 있는지 확인하세요. 앱 자체 설정은 시스템 프록시를 따르지 않을 수 있습니다.

3. 라우팅 경로 확인하기

   요청이 커널에 들어온 뒤 해당 아웃바운드 태그와 현재 라우팅 규칙을 확인하세요. 직접 연결로 설정된 대상은 특정 서버를 선택했다고 자동으로 프록시를 거치지 않습니다.

4. 잠시 상세 로그 사용하기

   「설정」→「매개변수 설정」에서 로그 수준 관련 항목을 찾으세요. 필요한 경우 잠시 debug로 설정해 한 번 재현한 뒤 원래 수준으로 되돌리세요. 대상 주소 같은 민감한 정보가 장기간 쌓이지 않도록 주의해야 합니다.

자주 묻는 질문과 문제 정보 제출 방법

문의를 제출하기 전에 마지막으로 순서대로 확인하세요. 로컬 포트에서 수신 대기 중인지, 앱 요청이 실제로 프록시에 들어오는지, 서버 도메인이 예상대로 조회되는지, 원격 포트에 연결할 수 있는지 확인한 다음 TLS와 프록시 프로토콜 설정을 살펴봅니다. 서버를 직접 관리한다면 같은 시각의 수신 대기 상태, 방화벽, 인증서, 서버 오류 로그도 확인하세요. 구독 서비스를 이용한다면 확인을 마친 내용을 서비스 제공자에게 전달하는 편이 단순히 “시간 초과가 발생했다”고 알리는 것보다 정확한 답변을 받기 쉽습니다.