v2rayN 로그 확인 방법: 오류 메시지별 원인과 문제 해결

화면 알림과 코어 로그 구분하기

v2rayN은 클라이언트를 관리하는 인터페이스이며, 실제로 로컬 연결을 받고 라우팅한 뒤 서버에 연결하는 것은 선택한 코어입니다. 구독 업데이트 실패, 속도 측정 실패, 코어 시작 실패는 서로 다른 작업의 결과입니다. 빨간색 알림 하나만 보고 노드를 사용할 수 없다고 단정하지 마세요. 이 글은 Xray 코어를 사용하는 설정을 기준으로 설명합니다. 다른 코어에서는 오류 문구와 로그 항목이 다를 수 있습니다.

메인 화면의 정보 또는 로그 영역에서는 시작 과정과 실시간 오류를 확인할 수 있습니다. 특정 요청이 어떤 인바운드를 거쳐 어떤 아웃바운드로 연결됐는지 추적하려면 잠시 info 레벨을 사용하세요. 더 자세한 맥락이 필요할 때만 debug로 설정하면 됩니다. 로그에 표시되는 warning은 경고이며, 코어가 종료됐다는 뜻은 아닙니다.

1. 현재 상태 기록하기

   v2rayN과 코어 버전, 현재 노드, 로컬 수신 포트, 라우팅 모드를 기록하세요. 버전 정보는 「도움말」→「정보」 또는 시작 로그에서 확인할 수 있습니다. 현재 설정은 보관하고, 일단 구독을 업데이트하거나 여러 노드를 한꺼번에 수정하지 마세요.

2. 로그 켜기

   일반적인 데스크톱 인터페이스에서 「설정」→「매개변수 설정」으로 이동해 로그 관련 옵션을 찾으세요. 로그 기록을 켜고 로그 레벨을 info로 설정한 다음 저장하고 코어를 다시 시작합니다. 버전에 따라 탭 이름이나 중국어 메뉴명이 다를 수 있으므로 실제 로그 스위치와 레벨 항목을 확인하세요.

3. 한 번만 재현하기

   현재 로그 표시 영역을 지우거나 시작 시간을 기록한 뒤, 정해 둔 주소 하나만 방문하세요. 한 번 성공하거나 실패하면 반복 새로고침을 멈추고 오류 전후 약 20줄을 보관합니다. 마지막 한 줄만 캡처하지 마세요.

4. 로그 레벨 되돌리기

   문제를 해결한 뒤에는 warning 또는 기존 로그 레벨로 복원하세요. 로그를 공유하기 전에는 구독 주소, 노드 인증 정보, UUID, 공인 IP 주소와 방문 기록을 가리고 설정 파일 전체를 그대로 공개하지 마세요.

사용자 지정 Xray 설정을 관리 중이라면 로그 부분을 다음과 같이 작성할 수 있습니다. 이 예시는 log 객체만 보여 주며 완전한 config.json이 아닙니다. 전체 설정을 이 내용으로 덮어쓰지 마세요. 일반 노드의 경우 v2rayN이 생성한 실행 설정은 노드를 바꾸면 다시 작성될 수 있으므로 클라이언트에서 제공하는 옵션을 우선 사용하세요.

{
  "log": {
    "loglevel": "info"
  }
}

인바운드·라우팅·아웃바운드 순서로 로그 읽기

문제를 확인할 때는 먼저 요청이 어느 단계까지 도달했는지 살펴보세요. 브라우저가 로컬 프록시에 연결하는 단계가 인바운드, 코어가 직접 연결·프록시·차단 여부를 판단하는 단계가 라우팅, 코어가 노드에 연결해 프로토콜을 협상하는 단계가 아웃바운드입니다. 노드 이름이 선택되어 있다는 것은 인터페이스에서 설정을 선택했다는 뜻일 뿐, 세 단계가 모두 정상이라는 의미는 아닙니다.

아래는 로그 형식을 단순화한 예시이며 모든 버전에서 문구가 똑같이 표시되는 것은 아닙니다. 대괄호 안의 태그는 설정에 따라 달라지므로 아웃바운드 이름이 항상 proxy라고 가정하지 마세요. accepted는 로컬 요청을 받아 처리 단계에 진입했다는 뜻이지, 원격 웹페이지가 성공적으로 응답했다는 뜻은 아닙니다.

from tcp:127.0.0.1:53124 accepted tcp:example.com:443 [socks-in -> proxy-out]

먼저 대상 주소 example.com:443을 확인하고, 라우팅 태그를 읽은 다음 비슷한 시각 또는 동일한 연결 식별자가 있는 후속 오류를 찾으세요. 오류에 노드 서버 주소가 표시되면 아웃바운드 연결을 중점적으로 확인합니다. 반대로 직접 연결 아웃바운드에서 웹사이트 주소를 대상으로 오류가 발생했다면 노드 비밀번호부터 바꿀 필요는 없습니다.

자주 발생하는 오류의 의미와 첫 점검 방법

상세 오류에는 여러 단계의 맥락이 포함됩니다. 예를 들어 바깥쪽에는 '연결 처리 실패'가 표시되고 안쪽에 구체적인 원인인 connection refused가 나올 수 있습니다. 오류 체인의 마지막에 있는 구체적인 원인부터 읽고, 상위 메시지로 돌아가 로컬·노드·대상 사이트 중 어디에서 실패했는지 확인하세요. 아래 문구는 자주 보이는 오류 예시이며 운영체제와 코어 버전에 따라 앞뒤 문구가 다를 수 있습니다.

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

다음은 Windows에서 확인하는 예시입니다. SOCKS 수신 포트가 10808이고 노드 서버 포트가 443이라고 가정합니다. 이 숫자는 설명을 위한 예시일 뿐 모든 설치의 기본값이 아닙니다. 실행 전에 인터페이스나 실행 설정에서 실제로 사용 중인 포트로 바꾸세요.

PowerShell에서 먼저 수신 포트를 확인한 뒤 프록시를 명시해 요청을 보냅니다. 두 번째 명령은 도메인 조회를 SOCKS 프록시에 맡겨 브라우저가 시스템 프록시를 올바르게 사용하는지 여부를 변수에서 제외합니다. 테스트 URL은 문제 재현용이며 모든 사이트의 접속 가능성을 판단하는 기준은 아닙니다.

Get-NetTCPConnection -State Listen -LocalPort 10808

curl.exe --noproxy "" --proxy socks5h://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/

• 수신 대기 기록이 없음: 코어 시작 오류를 확인하세요. 포트 충돌 메시지가 나오면 netstat -ano | findstr :10808로 PID를 확인한 다음 작업 관리자에서 어떤 프로세스인지 살펴보세요. 정체를 모르는 시스템 프로세스를 바로 종료하지 마세요.
• 로컬 프록시 연결이 거부됨: 수신 주소와 포트를 확인하세요. 루프백 주소만 수신하도록 설정했다면 같은 기기에서 테스트해야 합니다. 다른 기기의 연결 결과로 노드 상태를 판단하지 마세요.
• 명령은 성공하지만 브라우저에서는 연결되지 않음: 시스템 프록시, 브라우저별 설정, 확장 프로그램을 먼저 확인하세요. 일반적인 v2rayN 인터페이스에서는 트레이 메뉴의 「시스템 프록시」→「시스템 프록시 자동 설정」에서 구성할 수 있습니다. 프록시를 명시한 명령은 이 옵션과 무관하게 실행됩니다.
• 명령도 실패함: 명령 실행 시간과 코어 로그를 대조해 라우팅과 아웃바운드를 계속 추적하세요. 명령의 15초 시간 초과는 이번 테스트에만 적용되는 제한이며 코어나 서버의 고정 시간 초과 값이 아닙니다.

라우팅·DNS·핸드셰이크 설정을 하나씩 확인하기

로컬 포트에서 요청을 받았다면 다음으로 라우팅이 예상대로 작동하는지 확인하세요. Xray 라우팅 규칙은 일반적으로 순서대로 적용되며, 앞쪽의 포괄적인 규칙이 뒤쪽의 구체적인 규칙보다 먼저 일치할 수 있습니다. 현재 생성된 설정의 실제 태그를 확인하고 인터페이스에 표시된 노드 이름만으로 아웃바운드를 판단하지 마세요.

1. 아웃바운드 태그 확인: 규칙의 outboundTag는 대상 아웃바운드의 tag와 일치해야 합니다. 로그에서 차단 아웃바운드로 연결된 것으로 나오면 TLS를 바꾸기보다 라우팅 규칙부터 확인하세요.
2. 두 종류의 도메인 조회 구분: 노드 도메인 조회에 실패하면 서버 연결이 차단됩니다. 대상 도메인 조회에 실패하면 직접 연결이나 IP 일치 규칙에 영향을 줄 수 있습니다. Resolve-DnsName example.com은 시스템 DNS 확인에만 사용할 수 있으며 코어의 DNS 조회 테스트를 대신하지 않습니다.
3. 시간 확인: Windows의 「설정」→「시간 및 언어」→「날짜 및 시간」에서 자동 시간 설정을 켜고 동기화를 실행하세요. 시간 오차는 인증서 유효 기간 확인에 영향을 주며 시간에 민감한 인증에도 문제를 일으킬 수 있습니다.
4. 전송 설정 확인: WebSocket 경로와 Host, TLS 서버 이름, 노드 포트, 암호화 설정이 서버 측 설정과 일치해야 합니다. 같은 IP에 연결한다고 해서 같은 가상 호스트에 연결되는 것은 아닙니다.
5. 코어 지원 여부 확인: v2rayN은 관리 프로그램이며 프로토콜 지원 여부는 실제 사용하는 코어에 따라 달라집니다. 특히 REALITY와 XTLS Vision은 공유 링크를 가져오는 데 성공했다는 이유만으로 실행 설정까지 호환된다고 볼 수 없습니다.

클라이언트에서 제공하는 전역 프록시 라우팅을 잠시 적용해 비교할 수 있습니다. 먼저 기존 모드를 기록하고 테스트가 끝나면 바로 복원하세요. 전역 모드에서는 성공하고 기존 분할 라우팅에서는 실패한다면 규칙과 DNS 정책을 집중적으로 비교합니다. 단, 두 요청이 서로 다른 DNS 조회 경로를 사용했을 수도 있으므로 모든 오류가 라우팅 때문이라고 단정할 수는 없습니다.

로그 문제 해결 FAQ

문제 해결의 목표는 로그에서 경고를 완전히 없애는 것이 아니라 동일한 요청이 안정적으로 성공하고, 원래 어느 단계에서 실패했는지 설명할 수 있는 상태를 만드는 것입니다. 해결을 확인한 후에는 일반 로그 레벨과 기존 분할 라우팅 모드로 복원하세요. 임시 테스트 설정이 남지 않도록 원래 직접 연결되어야 하는 대상 하나와 프록시를 거쳐야 하는 대상 하나를 각각 테스트합니다.