코어가 시작되지 않거나 프록시를 켜자마자 시간 초과가 발생하는 경우, 또는 특정 사이트만 열리지 않는 경우에 유용합니다. 실패한 요청의 로그를 한 번 기록한 뒤 로컬 리스닝, 라우팅 규칙, 노드 주소 확인, 원격 연결, 프로토콜 핸드셰이크 순으로 점검하세요. 한 번에 설정 하나만 바꾸고 같은 URL로 다시 확인해 우연히 해결된 상황을 실제 수정으로 착각하지 않도록 합니다.
클라이언트 로그를 열고 실패 상황 기록하기
클라이언트 로그와 코어 로그는 서로 다른 문제를 보여 줍니다. 클라이언트 로그에서는 구독 다운로드와 설정 불러오기가 성공했는지 확인할 수 있고, 코어 로그는 로컬 포트, 아웃바운드 연결, 핸드셰이크 문제를 파악하는 데 적합합니다. 구독 업데이트가 성공했더라도 해당 구독 URL에 접속할 수 있었다는 뜻일 뿐, 구독에 포함된 모든 노드가 연결된다는 의미는 아닙니다.
로그 열기
데스크톱에서는 v2rayN 7.x를 기준으로 메인 창을 열고 노드 목록 아래의 정보 영역을 확인합니다. Android에서 v2rayNG 또는 v2flyNG를 열고 왼쪽 위의 「☰」를 누른 다음 「로그」를 선택하세요. 일부 빌드에서는 「Logcat」으로 표시됩니다. 클라이언트 버전과 로그 시작 부분에 표시된 코어 버전을 기록해 두세요. v2rayNG는 Xray를, v2flyNG는 V2Fly 코어를 사용하므로 오류 문구가 다를 수 있습니다.
정보 수준으로 설정
v2rayN에서는 「설정」→「매개변수 설정」에서 Core 기본 설정을 열고 「로그 수준」을 찾으세요. Android에서는 「☰」→「설정」에서 로그 수준을 확인합니다. 메뉴 이름은 빌드에 따라 다를 수 있습니다. 먼저
info를 선택해 저장한 뒤 연결을 다시 시작하세요. 맥락 정보가 부족할 때만 잠시debug로 바꾸세요. 해당 옵션이 없다면 현재 기록된 로그로 먼저 점검합니다.오류 재현하기
연결 버튼을 누른 시간을 기록하고, 코어가 시작되면 같은 앱에서 실패했던 URL을 한 번 엽니다. 속도 테스트를 새로 실행하거나 구독을 업데이트하거나 노드를 바꾸는 작업을 동시에 하지 마세요. 웹페이지를 열기도 전에 오류가 발생했다면 시작 단계의 로그만 보관하고 추가 요청은 보내지 않아도 됩니다.
주변 로그도 함께 보관
오류가 발생한 줄의 앞뒤로 각각 약 5줄씩 복사하세요. 로그에 연결 ID가 있다면 같은 ID가 붙은 기록만 이어서 확인해 백그라운드 앱의 오류를 이번 테스트의 문제로 오해하지 않도록 합니다. 점검을 마치면 로그 수준을 원래대로 돌리고, 공유 전에 구독 URL, 계정 식별 정보, 노드 주소, 방문한 도메인을 가리세요.
오류가 발생한 단계 찾기
먼저 요청이 코어에 도달했는지 확인한 다음 어떤 아웃바운드로 전달됐는지 살펴보세요. 로그의 accepted는 보통 코어가 요청을 받았다는 뜻일 뿐입니다. 이후 직접 연결 아웃바운드로 전달됐다면 노드 핸드셰이크 기록이 나오지 않는 것이 정상입니다. 요청 기록 자체가 없다면 현재 로그 수준에서 연결을 기록하는지 확인하고, 시스템 프록시, TUN 또는 Android 앱별 라우팅 범위를 점검하세요.
- 시작 로그를 먼저 보고, 접속 로그를 확인하세요. 시작할 때
listen tcp와 바인딩 실패가 나타나면 로컬 포트부터 점검하세요. URL에 접속한 뒤dial tcp가 나타났다면 연결 대상 주소를 확인합니다. 둘 다 포트가 포함되지만 하나는 로컬에서 리스닝할 포트이고, 다른 하나는 연결할 상대의 포트입니다. - 노드 도메인과 접속 도메인을 구분하세요. 노드 도메인 확인에 실패했다면 코어가 노드에 연결하기 전일 수 있습니다. 웹사이트 도메인 확인에 실패했다면 우선 해당 요청이 직접 연결인지 프록시 연결인지, 어느 쪽에서 DNS 조회를 담당하는지 확인하세요.
no such host한 줄만 보고 전체 DNS 설정을 바꾸지 마세요. - 요약 오류보다 구체적인 원인을 먼저 확인하세요.
failed to find an available destination는 여러 연결 시도 후 표시되는 요약 오류인 경우가 많습니다. 같은 요청에서 발생한lookup,dial또는tls오류를 확인해야 DNS 조회, 연결, 핸드셰이크 중 어느 단계에서 문제가 생겼는지 구분할 수 있습니다.
자주 발생하는 오류 문구와 의미, 해결 방법
아래 문구는 검색에 활용할 수 있는 오류 일부이며 특정 버전의 전체 로그는 아닙니다. 운영체제, 코어 버전, 전송 방식에 따라 앞뒤 문구가 달라질 수 있습니다.
bind: address already in use
원인: 코어가 리스닝하려는 주소와 포트를 다른 프로그램이 이미 사용 중입니다. 해결: 포트를 사용 중인 프로그램을 확인하고 중복 실행된 인스턴스를 종료하거나, 현재 클라이언트에서 사용 가능한 다른 포트를 지정하세요. 프록시 포트를 직접 설정한 앱도 함께 업데이트해야 합니다.
connect: connection refused
원인: 연결이 명시적으로 거부됐습니다. 대상 포트에서 리스닝 중인 서비스가 없을 때 흔히 발생합니다. 해결: 대상이 127.0.0.1이면 코어가 실행 중인지, 앱에 입력한 포트가 맞는지 확인하세요. 대상이 노드 주소라면 구독에 표시된 노드 포트를 확인한 뒤 서비스 상태를 제공자에게 문의하세요.
i/o timeout
원인: 네트워크 읽기·쓰기 또는 연결 작업이 제한 시간 안에 완료되지 않았습니다. 이 문구만으로 노드에 연결할 수 없는 원인을 단정할 수는 없습니다. 해결: 같은 줄에 lookup, dial tcp 또는 읽기·쓰기 시간 초과 중 무엇이 표시됐는지 확인하세요. 노드는 그대로 둔 채 정상 작동이 확인된 다른 네트워크에서 다시 테스트합니다.
no such host
원인: 이번 도메인 조회에서 사용할 수 있는 레코드를 찾지 못했습니다. 해결: 조회에 실패한 도메인을 확인하세요. 노드 도메인이라면 구독에 표시된 원본과 철자를 대조합니다. 접속 도메인이라면 시스템, 코어, 원격 서버 중 어디에서 DNS를 처리하는지 확인하고 해당 DNS 설정을 점검하세요.
remote error: tls: handshake failure
원인: 상대 서버가 TLS 핸드셰이크를 거부했습니다. 이 로그만으로 거부 이유를 알 수는 없습니다. 해결: 구독에 표시된 원본 설정과 노드 포트, 전송 방식, TLS 사용 여부, 서버 이름이 일치하는지 확인하세요. 계속 실패하면 핸드셰이크 시각과 개인정보를 가린 로그를 노드 제공자에게 보내 확인을 요청하세요.
x509: certificate has expired or is not yet valid
원인: 로컬 시계 기준으로 인증서가 유효 기간을 벗어났습니다. 시스템 시간이 잘못됐거나 인증서가 실제로 만료됐을 수 있습니다. 해결: 먼저 시스템 시간을 동기화하세요. 시간이 정확한데도 문제가 계속되면 제공자에게 인증서 확인을 요청하고 인증서 검증은 끄지 마세요.
로컬 포트와 시스템 시간 확인
예를 들어 로그에 코어가 127.0.0.1:10808에서 리스닝하려다 바인딩에 실패했다고 표시된다고 가정해 보겠습니다. Windows PowerShell에서 해당 포트를 리스닝 중인 프로세스를 조회하세요. 여기서 10808은 예시이므로 실제 로그에 표시된 포트로 바꿔야 합니다. 오류가 UDP와 관련된 경우 이 TCP 조회만으로 포트 충돌 여부를 배제할 수는 없습니다.
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
작업 관리자의 「세부 정보」 탭에서 OwningProcess가 반환한 프로세스 ID로 프로그램을 찾으세요. 정체를 모르는 프로세스를 바로 종료하지 마세요. 포트를 변경하기로 했다면 사용 가능한 것으로 확인된 10818 등을 지정하고 저장한 뒤 코어를 다시 시작하세요. 앱에 입력한 프록시 유형과 포트도 확인해야 합니다. HTTP와 SOCKS 진입점이 분리되어 있다면 각각 올바르게 연결하세요. 포트가 리스닝 중이라고 두 진입점을 서로 바꿔 쓸 수 있는 것은 아닙니다.
문제 범위에 맞춰 다시 테스트하기
로그에 요청이 접수됐다고 나오는데 웹페이지가 열리지 않는 이유는 무엇인가요?
같은 요청의 로그를 더 살펴 아웃바운드 태그를 확인하세요. 직접 연결로 표시되지만 프록시를 사용해야 하는 상황이라면 현재 라우팅 모드와 적용된 규칙을 확인합니다. 프록시 연결이라면 해당 연결의 다이얼 또는 핸드셰이크 오류를 살펴보세요. 같은 URL로 테스트하고 라우팅 모드와 노드를 동시에 바꾸지 마세요.
노드 하나만 시간 초과가 발생하면 클라이언트를 다시 설치해야 하나요?
우선 재설치하지 마세요. 기기, 네트워크, URL, 라우팅 모드는 그대로 두고 같은 프로토콜을 사용하는 정상 노드 하나로 바꿔 보세요. 비교 노드는 정상이라면 문제가 있는 노드의 주소, 포트, 전송 설정을 먼저 확인합니다. 두 노드 모두 시간 초과가 발생하면 현재 네트워크와 로컬 설정을 점검하세요.
데스크톱에서는 되는데 휴대폰에서 연결을 눌러도 접속 로그가 없는 이유는 무엇인가요?
먼저 Android에서 현재 클라이언트의 VPN 연결을 허용했는지 확인하고 다른 VPN이 실행 중인지 살펴보세요. 앱별 프록시를 사용한다면 테스트용 브라우저가 제외됐거나 프록시 허용 목록에 추가되지 않았는지 확인합니다. 테스트할 때는 같은 노드를 유지해 앱 트래픽 처리 문제와 노드 문제를 혼동하지 않도록 하세요.
구독을 업데이트한 직후 오류가 발생하면 어떤 로그를 봐야 하나요?
먼저 구독 요청에서 다운로드 또는 파싱 실패가 명시됐는지 확인하세요. 업데이트가 성공했다면 새 그룹의 노드가 현재 활성화되어 있는지 확인한 뒤 연결을 끊었다가 다시 연결하고 코어 시작 로그를 살펴보세요. 코어는 시작되지만 새 노드에서만 핸드셰이크가 실패한다면 업데이트 전후의 전송 방식과 TLS 설정을 하나씩 비교하세요. 이전 설정을 통째로 되돌리지는 마세요.