코어 시작 실패, 노드 연결 시간 초과, 웹페이지 열림 오류를 겪는 v2rayN 사용자를 위한 안내입니다. Windows에서 Xray 코어를 사용하는 경우를 예로 들어, 먼저 실패 당시의 로그를 확인합니다. 오류에 표시된 주소와 작업을 기준으로 로컬 리슨, 도메인 이름 확인, 원격 연결, TLS 핸드셰이크를 구분한 뒤 한 번에 한 항목씩만 변경하고 다시 테스트하세요.
실행 로그를 열고 오류 재현하기
먼저 v2rayN 메인 창의 로그 영역을 확인하세요. 클라이언트 작업 메시지와 코어 출력이 함께 표시될 수 있습니다. 구독 업데이트 실패는 구독 URL을 가져오는 과정의 오류이고, 코어 다이얼 실패는 특정 네트워크 연결의 오류입니다. 두 메시지가 연달아 표시되어도 같은 요청에서 발생한 오류라고 단정할 수는 없습니다.
테스트 조건 고정하기
현재 노드, 라우팅 설정, 연결 방식을 그대로 유지하고 시스템 프록시나 TUN의 상태를 기록하세요. 시작 실패라면 시작만 다시 시도하고, 웹페이지가 열리지 않는다면 원래 접속할 수 있던 페이지 하나만 새로고침하세요. 여러 노드를 한꺼번에 테스트하거나 구독을 업데이트하지 마세요.
로그 수준 확인하기
「설정」→「매개변수 설정」을 열고 코어 기본 설정에서 로그 수준을 찾으세요. Xray를 예로 들면
warning은 기록된 경고와 오류를 먼저 확인할 때 적합합니다. 연결 처리 과정을 살펴보려면info로 변경하세요. 클라이언트 버전에 따라 설정 위치가 다를 수 있으므로 현재 연결에서 사용하는 코어부터 확인하세요.설정 적용 후 오류 재현하기
설정을 저장하고 코어에 새 설정이 다시 적용되었는지 확인하세요. 작업 시간을 기록한 다음 오류를 한 번 더 재현합니다. 요청과 실패 원인이 함께 담긴 같은 시간대의 로그 몇 줄을 확인하세요. 로그에 요청 ID가 있다면 같은 ID의 항목끼리 비교해 백그라운드 요청 오류를 이번 문제와 혼동하지 않도록 하세요.
핵심 필드 기록하기
실패가
listen,lookup,dial, 인증서 검증 중 어느 단계에서 발생했는지 기록하세요. 로그를 다른 사람과 공유하기 전에는 구독 URL, 사용자 식별 정보, 실제 도메인과 공인 IP 주소를 가리세요. 단, 포트, 오류 문구, 주소가 로컬인지 원격인지는 확인할 수 있도록 남겨 두세요.
자주 발생하는 오류: 시간 초과, 연결 거부, 핸드셰이크 실패
아래는 검색할 때 유용한 오류 문구이며, 모든 코어가 같은 문장을 그대로 출력하는 것은 아닙니다. 한 줄에 여러 단계의 오류가 이어진다면 구체적인 주소나 실패한 작업이 포함된 안쪽 오류부터 확인한 다음, 바깥쪽 오류가 어떤 인바운드, 아웃바운드 또는 요청에서 발생했는지 살펴보세요.
오류: i/o timeout
원인: 네트워크 작업이 제한 시간 안에 완료되지 않았습니다. 원격 서버에 연결하는 중일 수도 있고, 데이터를 읽거나 DNS 응답을 기다리는 중일 수도 있습니다.
해결: 같은 줄에 dial tcp가 있다면 해당 주소를 기준으로 노드의 원격 호스트와 포트를 확인하고 TCP 연결을 테스트하세요. lookup이 표시되면 먼저 DNS 확인 경로를 점검하세요.
오류: no such host
원인: 조회를 요청한 쪽에서 해당 호스트 이름의 유효한 DNS 응답을 받지 못했습니다. 오류가 난 이름이 브라우저에서 접속하려는 웹사이트의 도메인이라고 단정할 수는 없습니다.
해결: 먼저 lookup 뒤에 표시된 전체 호스트 이름과 노드 설정을 확인하세요. 그런 다음 시스템 DNS와 코어가 사용하는 DNS 경로를 비교하세요. 시스템에서 조회가 성공했다는 이유만으로 코어의 DNS 문제를 배제하지 마세요.
오류: connection refused
원인: 연결이 거부되었습니다. 대상 포트에서 리슨 중인 프로세스가 없을 때 흔히 발생하며, 중간 장치가 연결을 직접 거부했을 수도 있습니다.
해결: 대상이 127.0.0.1이라면 애플리케이션에서 사용하는 포트와 코어의 리슨 포트를 확인하세요. 원격 주소라면 구독에 설정된 포트를 확인하고 서비스 제공자에게 해당 포트의 리슨 상태를 문의하세요.
오류: x509: certificate signed by unknown authority
원인: TLS 인증서 검증 단계까지 연결이 진행됐지만, 신뢰 체인으로 상대방 인증서를 검증할 수 없습니다.
해결: 먼저 로그에 표시된 TLS 상대가 노드인지 대상 웹사이트인지 확인하세요. 그런 다음 인증서 체인과 로컬 신뢰 설정을 점검하세요. 검증을 건너뛰어 오류를 없애려 하지 마세요.
오류: remote error: tls: handshake failure
원인: TLS 핸드셰이크 중 원격 서버가 실패 알림을 반환했습니다. 이 일반적인 오류 문구만으로는 어떤 설정이 일치하지 않는지 알 수 없습니다.
해결: TLS를 사용하는 노드라면 서버에서 제공한 설정을 기준으로 전송 방식, TLS 사용 여부, 서버 이름(SNI)을 하나씩 대조하세요. 필요한 경우 서비스 제공자에게 같은 시간대의 서버 로그를 확인해 달라고 요청하세요.
로컬 포트 충돌: 리슨 프로세스를 확인한 뒤 포트 변경
코어를 시작할 때 address already in use 또는 Windows의 Only one usage of each socket address가 표시되면, 먼저 바인딩에 실패한 주소와 포트를 기록하세요. 아래 두 포트는 로그에서 각 항목이 어떻게 표시되는지 설명하기 위한 예시입니다. 실제 점검은 현재 설정과 오류 내용을 기준으로 진행하세요.
판단 기준: 오류가 난 쪽만 변경하기
오류가 listen tcp 127.0.0.1:10808이라면 로컬에서 해당 포트를 사용하는 프로세스를 확인하세요. 구독의 원격 포트는 변경하지 마세요. 원격 443으로 향하는 dial tcp 연결이 시간 초과된 경우에는 로컬 포트를 바꿔도 원격 연결이 복구되지 않습니다.
Windows PowerShell에서 TCP 리슨 프로세스를 조회하세요. 첫 번째 줄의 숫자를 로그에서 바인딩에 실패한 포트로 바꾸면 됩니다. 로그에 UDP라고 명시되어 있다면 Get-NetUDPEndpoint -LocalPort $port로 해당 엔드포인트를 조회하세요.
$port = 10808
Get-NetTCPConnection -LocalPort $port -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
OwningProcess값을 작업 관리자의 「세부 정보」 탭에 표시된 PID와 대조하세요. 리슨 주소가0.0.0.0이라면 코어가 바인딩하려는 로컬 주소와 충돌하는지도 확인하세요.- 클라이언트가 중복 실행된 것이 확인되면 시스템 트레이에서 불필요한 인스턴스를 정상 종료하세요. 계속 실행해야 하는 프로그램이 포트를 사용 중이라면 v2rayN의 「설정」→「매개변수 설정」에서 해당 로컬 리슨 포트를 변경하고, 그 포트를 직접 지정한 애플리케이션의 설정도 함께 업데이트하세요.
- 코어를 다시 시작한 뒤 리슨 상태를 확인해 프로세스가 예상한 포트에 바인딩되었는지 확인하고 웹페이지를 다시 열어 보세요. 포트가 이미 리슨 중인데도 페이지가 열리지 않는다면 새 요청의 인바운드와 아웃바운드 로그를 확인하세요. 포트를 계속 바꾸지는 마세요.
코어가 시작된 후: 트래픽 전달, 라우팅, 원격 연결 구분하기
코어가 정상적으로 시작되었다는 것은 프로세스가 실행될 수 있다는 뜻일 뿐입니다. 브라우저 요청이 코어로 전달되었거나 노드와 대상 웹사이트에 연결할 수 있다는 의미는 아닙니다. 로그 수준을 잠시 info로 바꾸고 같은 URL과 같은 연결 방식으로 다시 시도한 뒤 다음 세 부분을 확인하세요.
- 인바운드를 확인하세요. 이번 작업에 해당하는 연결 기록이 없다면 애플리케이션이 시스템 프록시를 사용하는지, 또는 로컬 포트를 올바르게 지정했는지 확인하세요. TUN을 사용한다면 TUN이 정상적으로 시작되었는지, 해당 트래픽이 TUN을 통과하는지도 점검하세요. 먼저 현재 연결 방식부터 확인하고 두 모드를 동시에 전환하지 마세요.
- 아웃바운드를 확인하세요. 인바운드 기록이 있고 로그에 아웃바운드 태그가 표시된다면 현재 라우팅 규칙과 태그를 대조하세요. 노드를 통해 전달되어야 할 도메인이 직결 규칙에 일치한다면 노드의 인증서 설정을 변경하기 전에 규칙의 일치 여부와 순서를 확인하세요.
- 원격 연결을 확인하세요. 요청이 예상한 아웃바운드를 선택했고 TCP 노드에 연결하는 단계에서 실패한 것이 확인되면 PowerShell의
Test-NetConnection으로 해당 노드의 호스트와 실제 포트를 테스트하세요. 이 테스트는 현재 환경에서 TCP 연결을 설정할 수 있는지만 확인합니다. TLS, 프로토콜 인증, 대상 웹페이지의 정상 여부를 검증하지 않으며 UDP 전송 가능 여부를 판단하는 데도 사용할 수 없습니다.
변경 후에는 기존 노드와 URL을 사용해 다시 테스트하고 같은 단계의 로그를 비교하세요. 기존 다이얼 시간 초과가 인증서 오류로 바뀌었다면 다음 단계까지 점검이 진행된 것이지, 연결 문제가 해결된 것은 아닙니다. 웹페이지가 다시 열리는 것을 확인한 뒤 임시로 높였던 로그 수준을 원래 값으로 되돌리세요.
로그 문제 해결 FAQ
로그가 너무 빨리 쌓입니다. 어떤 줄이 현재 요청에 해당하나요?
속도 테스트와 구독 업데이트를 멈추고 오류를 한 번만 재현한 다음 작업 시작 시간을 기록하세요. 먼저 시간으로 로그 범위를 좁히고, 대상 주소나 요청 ID로 관련 줄을 찾으세요. info만으로 핵심 정보를 확인하기 어려울 때만 debug를 잠시 사용하고, 로그를 수집한 뒤에는 원래 수준으로 되돌리세요.
웹페이지는 열리는데 구독 업데이트는 왜 시간 초과되나요?
구독 업데이트는 구독 서버에 접속하므로 브라우저와 다른 연결 방식을 사용할 수 있습니다. 오류가 난 그룹만 업데이트하고 안내 메시지를 기록하세요. 그런 다음 구독 URL이 여전히 유효한지, 업데이트가 프록시를 통하는지, 같은 시간에 노드가 정상 작동하는지 확인하세요. 기존 그룹은 삭제하지 마세요.
인증서 만료 오류가 표시되면 노드를 반드시 바꿔야 하나요?
먼저 Windows의 「설정」→「시간 및 언어」→「날짜 및 시간」에서 시스템 시간을 확인하고 동기화한 뒤 다시 테스트하세요. 시간이 정확한데도 인증서 만료 오류가 계속되면 로그에 표시된 TLS 상대가 누구인지 확인하고, 해당 상대를 관리하는 쪽에 인증서 유효 기간과 배포 상태를 점검해 달라고 요청하세요.
속도 테스트에는 수치가 나오는데 특정 웹사이트는 왜 열리지 않나요?
속도 테스트 요청과 해당 웹사이트 요청은 서로 다른 연결입니다. 속도 테스트를 중지하고 웹사이트에만 접속한 다음 새 로그에서 선택된 아웃바운드와 실패 단계가 DNS 확인, 다이얼, 핸드셰이크 중 어디인지 확인하세요. 특정 도메인만 실패한다면 먼저 해당 도메인에 적용된 라우팅 규칙과 DNS 응답을 점검하세요.