v2rayN이 시작되지 않거나 웹페이지가 열리지 않으면 먼저 코어가 설정을 불러왔는지, 로컬에서 포트를 열고 대기 중인지 확인한 다음 외부 연결을 점검하세요. 이 글에서는 Windows에서 Xray 코어를 사용하는 v2rayN을 기준으로 오류 로그를 확인하고, 주소와 포트 및 오류 전후 맥락을 이용해 원인을 좁히는 방법을 설명합니다.
v2rayN 로그 위치와 로그 수준 설정 방법
먼저 메인 창의 ‘정보’ 영역에서 노드를 전환하거나 코어를 시작할 때 출력되는 로그를 확인하세요. 로그 수준은 ‘설정’ → ‘매개변수 설정’에서 Core 기본 설정의 ‘로그 수준’ 항목을 찾아 바꿀 수 있습니다. 버전에 따라 메뉴 이름이나 분류가 조금 다를 수 있습니다. 사용자 지정 설정을 사용하는 경우 실제로 불러온 설정에서 로그 출력 위치와 수준을 별도로 지정했는지도 확인하세요.
현재 환경 기록하기
v2rayN 버전, 노드에서 사용하는 코어 종류, 로컬 프록시 포트를 기록하세요. 구독을 업데이트하고 노드를 바꾸고 포트까지 동시에 수정하지 마세요. 연결이 복구되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다.
info로 설정
코어 로그 수준을 임시로
info로 설정하고 저장한 뒤 현재 코어를 다시 시작하세요. Xray 설정에서 이에 해당하는 필드는log.loglevel입니다.warning과error는 기록 범위가 좁아 평소 사용하기에 적합하지만, 요청이 어떤 단계를 거쳤는지는 확인하기 어려울 수 있습니다.오류 재현하기
요청을 보낸 시각을 기록하고, 원래 오류가 발생한 앱에서 한 번 다시 시도하세요. 시작할 때 발생한 문제라면 코어만 재시작하면 됩니다. 웹페이지를 반복해서 새로고침할 필요는 없습니다. 실패한 줄과 앞뒤 로그를 함께 보관하고, 창의 마지막 줄만 복사하지 마세요.
필요하면 상세 기록 후 원래 설정 복구
info만으로 실패 단계를 파악하기 어렵다면debug로 임시 변경해 한 번 더 시도한 뒤 원래 수준으로 되돌리세요. 로그를 공유하기 전에 구독 주소, 인증 정보, 사설 도메인, 공인 IP 주소를 가리세요. 오류 키워드와 포트, 동일 요청을 식별하는 정보를 남겨 두세요.
로그 구조: 로컬 인바운드, 라우팅, 원격 아웃바운드 구분하기
로그에는 클라이언트 메시지, 코어 출력, 속도 측정 결과가 함께 표시될 수 있습니다. 코어 로그를 읽을 때는 먼저 시각을 기준으로 해당 작업의 로그를 찾고, 구성 요소 이름과 실패한 동작을 확인하세요. 일부 코어 로그는 >로 여러 단계의 오류를 연결합니다. 왼쪽에는 실패한 동작의 요약이, 오른쪽에는 더 구체적인 시스템 오류가 나오는 경우가 많습니다. 같은 오류 체인 안의 내용만 비교하고, 인접한 요청의 로그를 하나의 원인처럼 묶지 마세요.
| 로그 예시 | 확인할 수 있는 내용 | 다음으로 확인할 항목 |
|---|---|---|
listen tcp 127.0.0.1:10808 | 이 메시지는 로컬에서 포트를 열고 대기하는 동작을 가리킵니다. | 같은 줄에 바인딩 실패가 있는지 확인하세요. 서버 포트를 테스트하는 단계가 아닙니다. |
accepted | 코어가 해당 인바운드 요청을 받았습니다. | 뒤에 인바운드에서 아웃바운드로 이어지는 태그가 표시되면 의도한 라우팅 규칙이 적용됐는지 확인하세요. |
dial tcp | 구성 요소가 TCP 연결을 시도했습니다. | 로그에 표시된 대상 주소와 포트를 기준으로 노드, 직접 연결 대상, 로컬 서비스를 구분하세요. |
판단 기준: 같은 요청의 라우팅 확인
브라우저에서 오류가 발생한 시점에 해당하는 accepted가 이미 있고, 아웃바운드 태그가 직접 연결 규칙에 일치한다고 표시된다면 먼저 해당 라우팅 규칙과 적용 순서를 확인하세요. 이 경우 클라이언트를 재설치하거나 노드를 계속 바꿔도 해당 요청의 아웃바운드 경로는 달라지지 않습니다.
코어 시작 실패: 포트 충돌과 설정 파싱 오류
시작 단계에서 오류가 발생하면 브라우저의 프록시 오류는 대개 그에 따른 결과입니다. 먼저 코어가 설정을 정상적으로 불러왔는지 확인한 다음 로컬 포트에서 대기할 수 있는지 살펴보세요. 두 오류 모두 요청이 코어에 도달하지 못하게 할 수 있지만 해결 방법은 다릅니다.
오류: Only one usage of each socket address (protocol/network address/port) is normally permitted.
원인과 해결 방법: Windows에서 이 바인딩 오류가 발생하는 것은 해당 주소와 포트를 현재 프로세스가 사용할 수 없기 때문인 경우가 많습니다. 포트를 점유 중인 프로세스를 확인해 다른 클라이언트 인스턴스나 남아 있는 코어인지 살펴보세요. 충돌하는 프로그램을 정상 종료하거나 로컬 포트를 변경한 뒤 앱의 프록시 설정도 함께 수정하세요.
오류: invalid character '}' looking for beginning of object key string
원인과 해결 방법: 파서가 다음 객체 키를 기다리는 중 닫는 중괄호를 읽었습니다. 흔한 원인은 마지막 필드 뒤에 쉼표가 남아 있는 것입니다. 오류 메시지에 표시된 파일명과 줄·열 또는 오프셋을 기준으로 실제로 불러온 설정을 확인하세요. 먼저 문법을 바로잡은 다음 필드 유형과 코어의 지원 여부를 점검하세요.
오류에 표시된 수신 대기 포트가 10808이라면 Windows PowerShell에서 조회할 수 있습니다. 로그에 다른 포트가 표시되면 명령의 숫자를 해당 값으로 바꾸세요. 수신 대기 항목이 검색되지 않으면 먼저 오류가 발생한 시각을 다시 확인하세요. 충돌을 일으킨 프로세스가 이미 종료됐을 수 있습니다.
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
OwningProcess는 프로세스 ID이며, 작업 관리자의 ‘세부 정보’ 탭에서 확인할 수 있습니다. 로컬 프록시 포트를 바꿨다면 v2rayN의 시스템 프록시 설정을 다시 적용하고 프록시 주소를 직접 입력한 앱도 확인하세요. 자동 생성된 설정을 파싱하지 못한 경우에는 노드 편집 화면에서 원본 설정을 수정하는 것이 우선입니다. 임시 설정 파일을 직접 편집하면 다음 시작 때 변경 사항이 덮어써질 수 있습니다.
연결 시간 초과, 연결 거부, TLS 핸드셰이크 실패
코어가 요청을 받았다면 다음으로 연결 시도 자체가 실패했는지, TCP 연결 후 핸드셰이크 단계에서 실패했는지 확인하세요. 두 경우는 점검 대상이 다릅니다. 전자는 실제 연결 주소와 포트를, 후자는 보안 유형과 서비스 이름, 인증서 등의 설정을 살펴보세요.
오류: i/o timeout
원인과 해결 방법: 네트워크 작업이 제한 시간을 초과했지만, 이 메시지만으로는 어느 단계에서 시간 초과가 발생했는지 알 수 없습니다. 앞에 dial tcp가 있다면 로그에 표시된 대상 TCP 포트를 먼저 테스트하세요. 응답을 읽거나 핸드셰이크하는 중에 발생한 오류라면 같은 오류 체인의 앞뒤 내용을 확인하세요.
오류: connection refused
원인과 해결 방법: 연결 요청이 명시적으로 거부됐습니다. 대상 포트에서 서비스가 대기 중이지 않거나 중간 장비가 연결을 거부할 때 흔히 나타납니다. 주소가 이 컴퓨터를 가리키는지 확인하세요. 로컬 주소라면 포트를 사용하는 프로세스를 확인하고, 원격 주소라면 노드 포트가 맞는지 확인한 뒤 서비스 관리자에게 포트가 열려 있는지 문의하세요.
오류: x509: certificate signed by unknown authority
원인과 해결 방법: 일반 TLS 인증서 검증 과정에서 받은 인증서 체인을 신뢰할 수 있는 루트까지 연결하지 못했습니다. 먼저 올바른 서비스에 연결하고 있는지 확인한 뒤 서비스 관리자에게 인증서 체인을 점검해 달라고 요청하세요. 조직에서 관리하는 네트워크라면 관리자에게 신뢰 체인 요구 사항을 확인하세요. 검증을 건너뛰어 오류를 없애려 해서는 안 됩니다.
오류: remote error: tls: handshake failure
원인과 해결 방법: 원격 서버가 핸드셰이크 중 실패 알림을 반환했습니다. 이 한 줄만으로는 어떤 설정이 맞지 않는지 판단하기 어렵습니다. 노드의 보안 유형, 서비스 이름, 포트를 확인하세요. 설정에서 REALITY를 사용하는 경우 서버가 제공한 서비스 이름, 공개 키, 짧은 ID를 확인하고 일반 TLS 인증서 설정을 적용하지 마세요.
TCP를 사용하는 노드라면 PowerShell에서 서버 연결을 따로 테스트할 수 있습니다. 안내에 따라 노드 서버 주소와 원격 포트를 입력하세요. 구독 링크, TLS 서비스 이름, 로컬 프록시 포트는 입력하지 마세요.
$serverAddress = Read-Host '노드 서버 주소'
$serverPort = [int](Read-Host '노드 원격 포트')
Test-NetConnection -ComputerName $serverAddress -Port $serverPort
로그 문제 해결 FAQ
웹페이지가 열리지 않는데 정보 영역에 새 로그가 없나요?
로그 수준을 임시로 info로 바꾼 뒤 다시 시도하세요. 해당 인바운드 기록이 계속 보이지 않으면 코어가 포트에서 대기 중인지 확인한 다음 v2rayN의 시스템 프록시 상태와 Windows의 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 점검하세요. 앱에서 프록시를 직접 설정했다면 입력한 주소와 포트, 프록시 프로토콜이 실제 인바운드 설정과 일치하는지 확인하세요.
failed to find an available destination만 표시되는데 DNS 문제인가요?
꼭 그렇지는 않습니다. 이 메시지는 아웃바운드 연결을 설정하지 못했을 때의 요약이며, 도메인 이름 확인에 문제가 있다고 단정할 수는 없습니다. 뒤에 이어지는 구체적인 오류를 확인하세요. lookup과 no such host가 있으면 도메인 철자와 이름 확인을 점검하고, 대상 IP와 연결 시간 초과가 표시되면 해당 IP와 포트로 연결되는지 먼저 확인하세요.
노드는 연결되는데 구독 업데이트는 왜 시간 초과되나요?
구독 업데이트는 구독 서버에 접속합니다. 노드에 연결된다고 해서 구독 서버에도 연결할 수 있는 것은 아닙니다. 메인 화면의 ‘구독 그룹’에서 ‘프록시를 통하지 않음’과 ‘프록시를 통해 연결’ 업데이트 방식을 비교해 어떤 방식에서 실패하는지 확인하세요. 프록시를 통해 업데이트하기 전에 현재 노드로 웹페이지가 정상적으로 열리는지 테스트하세요. 업데이트 로그를 공유할 때는 구독 링크의 경로와 쿼리 매개변수를 삭제하세요.
로그에 가끔 EOF가 표시되는데 노드를 바꿔야 하나요?
먼저 웹 요청이 실제로 실패했는지 확인하세요. EOF는 스트림의 끝에 도달했다는 뜻이며, 이 메시지만으로는 누가 또는 왜 연결을 닫았는지 알 수 없습니다. 같은 작업에서 핸드셰이크 중 unexpected EOF가 반복된다면 원격 포트와 전송 설정을 확인하고 동일한 테스트 요청으로 다시 검증하세요.