문제 해결 가이드 · 증상 8가지

V2Ray 문제 해결 가이드

먼저 문제가 한 앱, 한 노드, 기기 전체 중 어디에 영향을 주는지 확인하세요. 해당 구간만 점검하고 노드, 라우팅, DNS를 한꺼번에 변경하지 마세요.

처음 설치했거나 아직 구독을 가져오지 않았다면 빠른 시작에 따라 구독을 가져오고, 연결 방식을 선택한 다음 연결을 확인하세요. 문제가 재현된다면 아래에서 해당 증상을 선택하세요. 이 가이드는 오류가 발생한 구간별로 구성되어 있어, 해결 후 튜토리얼로 돌아가 연결을 확인할 수 있습니다.

01 · 기본 연결 확인

인터넷에 연결되지 않을 때: 직접 연결부터 확인

클라이언트를 켠 뒤 웹페이지가 열리지 않는다면 기기 자체가 인터넷에 연결되는지 먼저 확인하세요. 클라이언트의 트래픽 가로채기를 끄고 평소 직접 접속할 수 있는 사이트를 열어 보세요. 꺼도 연결되지 않으면 Wi-Fi, 게이트웨이 또는 시스템 설정을 점검하세요. 끄자마자 정상화되면 클라이언트 연결 경로를 확인하면 됩니다. 같은 기기와 네트워크에서 같은 주소로 전후를 비교하고, 서로 다른 기기의 결과를 대신 비교하지 마세요.

프로그램 종료와 트래픽 가로채기 해제를 따로 확인

데스크톱에서 v2rayN을 사용할 때 시스템 프록시가 켜져 있다면 먼저 클라이언트에서 시스템 프록시를 해제한 뒤 프로그램을 종료하세요. 가상 네트워크 어댑터도 사용 중이라면 별도로 비활성화해야 합니다. 그런 다음 운영체제의 네트워크 프록시 설정을 열어 종료한 클라이언트의 로컬 주소가 남아 있지 않은지 확인하세요. 회사에서 제공한 프록시나 자동 구성 스크립트를 원래 사용했다면 기록해 둔 설정대로 복원하세요. 무조건 끄면 안 됩니다. 모바일 기기에서는 시스템 네트워크 설정에서 VPN 세션이 실제로 종료됐는지 확인하세요.

직접 연결도 안 된다면 다른 앱에서 같은 사이트가 열리는지 확인한 뒤 같은 네트워크의 다른 기기에서도 접속해 보세요. 두 기기 모두 연결되지 않는다면 네트워크 로그인 절차가 필요한지 확인하거나 관리자에게 문의하세요. 현재 기기에서만 실패한다면 유선에서 무선으로 전환한 직후인지, 절전 모드에서 깨어난 직후인지, 예전 고정 네트워크 설정이 남아 있는지 살펴보세요. 테스트할 때는 브라우저에서 새 탭을 열어 요청하세요. 기존 페이지가 보이는 것은 콘텐츠가 로컬 캐시에 남아 있기 때문일 수 있습니다.

다시 연결할 때는 한 가지 방식만 사용

직접 연결이 복구되면 클라이언트를 실행하고 이전에 작동이 확인된 노드를 선택한 뒤 코어가 시작될 때까지 기다리세요. 시스템 프록시와 VPN 가로채기 중 하나만 사용해 먼저 테스트하고, 라우팅 프리셋은 동시에 변경하지 마세요. 데스크톱에서는 시스템 프록시를 따르는 브라우저로 대상 사이트에 접속한 뒤 평소 직접 연결하는 사이트와 비교할 수 있습니다. 둘 다 실패하면 코어가 정상적으로 포트를 열었는지 확인하세요. 한 사이트만 실패한다면 해당 주소의 로그를 기록해 라우팅 선택, 도메인 확인, 대상 사이트 응답 중 어느 단계의 문제인지 구분하세요.

로그를 확인할 때는 새 요청을 보내기 직전부터 기록하세요. 시작 로그는 프로세스가 해당 단계까지 진행했다는 뜻일 뿐, 브라우저가 요청을 전달했다는 의미는 아닙니다. 로그 수준이 접속 기록을 남기는 것으로 확인됐는데 요청 중 관련 로그가 없다면 앱의 연결 방식을 먼저 점검하세요. 원격 연결 시간 초과가 명확히 표시되면 노드 시간 초과로 이동하세요. 도메인 확인 오류가 표시되면 DNS 오류를 확인하세요. 같은 로그가 반복된다고 해서 서로 다른 고장으로 판단하지 마세요.

직접 연결과 프록시 연결 결과 비교

비교 결과우선 확인할 항목다음 단계
트래픽 가로채기를 해제해도 실패클라이언트 이전 단계의 문제일 수 있음시스템 프록시 설정 잔여 항목, 네트워크 인증, 기기 연결 상태를 확인하세요.
직접 연결은 정상이나 트래픽 가로채기를 켜면 여러 사이트에서 실패로컬 프록시 또는 노드 확인코어가 시작됐는지 확인한 뒤 작동이 확인된 노드로 다시 테스트하세요.
특정 앱 하나에서만 실패앱의 프록시 설정 또는 연결 재사용 문제앱을 다시 시작하고 실제로 사용하는 프록시와 DNS 설정을 확인하세요.
특정 도메인 하나에서만 실패대상 도메인 확인, 규칙 또는 사이트 문제해당 도메인에 새 요청을 보내 DNS, 아웃바운드 도메인, 응답 상태를 비교하세요.

수정 후에는 먼저 이전에 실패했던 동작을 다시 수행하고, 정상적으로 접속되던 사이트도 테스트해 다른 트래픽 처리 방식에 영향이 없는지 확인하세요. 기기를 재시작해야만 복구된다면 다음에 문제가 발생했을 때 로그를 보존하고 트래픽 가로채기 해제, 앱 재시작, 네트워크 재연결을 각각 따로 테스트하세요. 어느 단계에서 처음 복구되는지 기록해야 시스템 설정 잔여 항목, 앱 연결 미갱신, 네트워크 자체의 문제를 구분할 수 있습니다. 한 번 재시작한 뒤 성공했다고 해서 원인을 찾은 것은 아닙니다.

02 · 노드 연결 경로

노드 시간 초과: 포트·핸드셰이크·대상 요청 구분

지연 시간 목록에 시간 초과가 표시돼도 노드가 중단됐다고 단정할 수는 없습니다. 포트 테스트, 프로토콜 연결, 웹페이지 확인은 서로 다른 구간을 점검하며 테스트 주소도 다를 수 있습니다. 먼저 어떤 테스트에서 실패했는지, 브라우저의 실제 요청도 실패하는지 기록하세요. 일괄 테스트에서만 오류가 난다면 노드 하나를 따로 테스트하세요. 그룹 전체를 바로 삭제하거나 같은 결과로 모든 노드를 판단하지 마세요.

시간 초과가 노드 하나에만 발생하는지 그룹 전체에 발생하는지 확인

같은 기기와 네트워크에서 이전에 정상 작동했던 노드 두 개로 같은 대상에 접속하세요. 하나만 실패하면 해당 노드에 적용된 설정과 서비스 상태를 먼저 확인하세요. 그룹 전체가 실패하지만 다른 그룹은 정상이라면 해당 노드들이 서버 주소, 포트 또는 서비스 진입점을 공유하는지 확인하세요. 모든 그룹에서 동시에 실패한다면 코어 시작 상태, 네트워크 전환, 도메인 확인을 점검하세요. 특히 연결 방식을 바꾼 직후 문제가 발생했는지 확인하세요.

노드 설정은 서비스 제공자가 안내한 값을 기준으로 확인하세요. 서버 주소, 포트, 프로토콜, 전송 방식, 보안 설정이 모두 서로 맞아야 합니다. TLS 서버 이름과 연결 주소가 다를 수 있습니다. 오류를 없애려고 추측으로 서버 이름을 바꾸거나 인증서 검증을 건너뛰지 마세요. 로그에 인증서 시간 오류가 표시되면 먼저 기기의 시각과 시간대를 확인한 뒤 서비스 제공자에게 인증서를 확인해 달라고 요청하세요. 구독 덮어쓰기 후 오류가 생겼다면 이름만 비교하지 말고 업데이트 전후의 프로토콜 필드를 비교하세요.

TCP 포트와 로컬 리스너를 따로 확인

시작 실패와 원격 서버 시간 초과는 서로 다른 문제입니다. 코어가 포트를 열지 못했다면 로컬 단계에서 먼저 실패합니다. 아래는 Windows PowerShell에서 대화형으로 확인하는 방법이며 TCP 기반 노드 포트에만 적용됩니다. 안내에 따라 클라이언트에 설정된 서버 주소와 포트를 입력하세요. 일반 TCP 연결만 시도하므로 프록시 프로토콜을 검증하지 않으며 브라우저의 시스템 프록시도 사용하지 않습니다. 구독 링크, 경로가 포함된 URL, 인증 정보는 입력하지 마세요.

$server = Read-Host '노드 서버 주소'
$port = [int](Read-Host '노드 TCP 포트')
Test-NetConnection -ComputerName $server -Port $port -InformationLevel Detailed

결과의 TcpTestSucceeded가 참이면 이번 TCP 연결이 성공했다는 뜻일 뿐입니다. 거짓이어도 DNS 결과, 현재 네트워크 경로, 서버의 수신 상태가 영향을 주므로 이것만으로 서비스 중단을 판단할 수 없습니다. 포트에 연결되지만 클라이언트에서 핸드셰이크가 실패하면 프로토콜, 보안 계층, 코어 지원 여부를 확인하세요. 핸드셰이크는 성공하지만 웹페이지 확인이 실패하면 테스트 주소에 접속할 수 있는지, 라우팅 규칙이 요청을 예상한 아웃바운드로 보내는지 확인하세요. 일반 ping 응답이 없다고 포트를 사용할 수 없는 것은 아닙니다.

비교할 수 있도록 재테스트 결과를 함께 보관

클라이언트의 테스트 주소에 접속할 수 없다면 상태를 확인할 수 있는 다른 테스트 대상을 사용해 실제 요청을 보내세요. 먼저 작은 페이지를 테스트한 뒤 처음 실패한 리소스를 여세요. 포트, 핸드셰이크, 페이지 중 어느 단계에서 가장 먼저 실패했는지 기록하세요. 실제 연결 테스트와 첫 연결 확인도 참고할 수 있습니다. 특정 네트워크에서만 실패한다면 사용 권한이 있는 경우 정상 작동이 확인된 다른 네트워크에서 같은 과정을 반복하세요. 결과는 네트워크 환경과 문제가 관련 있음을 보여줄 뿐, 이것만으로 구체적인 고장 원인을 확정할 수는 없습니다.

서비스 제공자가 기존 진입점을 중단했다고 확인했다면 구독을 업데이트하거나 정확한 설정을 다시 가져오세요. 코어가 프로토콜 필드를 인식하지 못한다면 클라이언트 지원 범위에 맞는 설정을 사용하세요. 새 설정으로 웹페이지 테스트를 마칠 때까지 기존 설정을 보관한 뒤 중복 항목을 정리하세요. 같은 필드에서 매번 오류가 발생하는데 시간 제한만 늘려 문제를 가리지 마세요. 연결이 간헐적으로 성공하고 로그에 고정된 설정 오류가 없을 때만 시간 제한 설정을 비교해 볼 만합니다.

03 · 구독 업데이트

구독 실패: 가져오기·파싱·저장 단계 구분

구독 업데이트에 실패해도 기존 그룹을 삭제하지 마세요. 업데이트는 구독 주소로 요청 보내기, 응답 파싱, 그룹에 결과 저장하기의 세 단계로 진행됩니다. 다운로드가 완료돼도 응답을 파싱할 수 있다는 뜻은 아니며, 목록에 항목이 늘어도 선택한 노드가 교체됐다는 뜻은 아닙니다. 현재 그룹, 마지막으로 성공한 업데이트 시간, 사용 가능한 노드를 먼저 기록한 뒤 문제가 있는 그룹만 업데이트하세요. 다른 그룹의 결과가 로그에 섞이지 않도록 주의하세요.

가져오기 실패: 업데이트 요청이 실제로 어떤 경로를 사용하는지 확인

구독 주소가 현재 유효한 서비스 진입점에서 발급됐는지 확인하고, 복사하는 과정에서 따옴표, 줄바꿈, 뒤쪽 공백이 섞이지 않았는지 살펴보세요. 클라이언트 오류가 도메인 확인 실패인지, 연결 시간 초과인지, 서버가 상태 코드를 반환했는지 확인하세요. 인증되지 않았거나 접근이 금지됐다는 응답을 받으면 서비스 제공자의 관리 페이지에서 이용 권한과 링크 변경 여부를 확인하세요. 서버가 리디렉션했다면 최종 응답이 로그인 페이지가 아니라 구독 데이터인지도 확인해야 합니다. 주소 매개변수를 반복해서 직접 수정하지 마세요.

v2rayN에서 현재 버전이 직접 업데이트와 프록시를 통한 업데이트를 구분한다면 기존 설정을 보존한 채 각각 한 번씩 비교하세요. 직접 연결이 안 되지만 사용할 수 있는 노드가 있다면 해당 노드로 프록시 업데이트를 테스트할 수 있습니다. 현재 노드 자체가 작동하지 않는다면 이를 이용해 대체 노드를 가져오려 하지 마세요. 이 경우 권한이 있는 네트워크에서 구독 주소에 접속할 수 있는지 확인하거나 서비스 제공자에게 사용 가능한 설정을 요청하세요. 브라우저에서 페이지가 열린다고 클라이언트 업데이트 요청도 같은 프록시 설정과 인증 상태를 사용한다는 뜻은 아닙니다.

가져오기는 성공했지만 결과가 비어 있음: 응답 내용과 그룹 확인

서버가 정상 상태 코드를 반환하더라도 로그인 페이지, 오류 안내 또는 다른 클라이언트 전용 설정을 응답 본문으로 보낼 수 있습니다. 먼저 클라이언트가 표시한 인식 결과를 확인하고 서비스 제공자에게 구독 형식과 지원 클라이언트를 문의하세요. 구독 전체 내용을 온라인 변환·디코딩 사이트에 제출하지 마세요. 바로 사용할 수 있는 인증 정보가 포함돼 있을 수 있습니다. 클라이언트에서 분리 테스트할 수 있다면 기존 그룹을 보존하고 임시 그룹을 만들어 같은 링크를 확인하세요. 빈 응답이 사용 가능한 목록을 덮어쓰는 일을 막을 수 있습니다.

목록에 항목이 있지만 화면에 보이지 않는다면 검색어를 지우고 방금 업데이트한 그룹으로 전환한 뒤 숨김 항목 필터가 있는지 확인하세요. 일부 노드만 가져와졌다면 성공한 항목과 실패한 항목의 프로토콜, 전송 설정, 클라이언트 인식 메시지를 비교하세요. 서비스 제공자가 현재 코어에서 인식하지 못하는 필드를 추가했다고 해서 구독 전체가 유효하지 않은 것은 아닙니다. 모바일에서는 서비스 제공자의 지원 안내를 기준으로 v2rayNG 또는 v2flyNG를 선택하세요. 세 클라이언트가 구독을 가져오는 방식이 모두 같다고 볼 수는 없습니다.

수동 업데이트부터 해결한 뒤 자동 업데이트를 다시 설정

수동 업데이트가 안정적으로 작동한 다음 자동 업데이트 간격과 업데이트 시 사용할 프록시 방식을 확인하세요. 자동 작업이 실행될 때 컴퓨터가 절전 상태이거나 클라이언트가 종료돼 있을 수 있고, 이전에 선택한 노드가 작동하지 않을 수도 있습니다. 간격 설정을 확인하려면 설정을 저장한 시간과 다음 작업이 실제 실행된 시간을 기록해 로그와 비교하세요. 수동 업데이트는 정상인데 자동 작업이 전혀 없다면 실행 상태와 해당 그룹의 자동 업데이트 설정을 확인하세요. 작업은 실행됐지만 오류가 반환됐다면 가져오기 또는 파싱 단계부터 계속 점검하세요. 자세한 방법은 v2rayN 구독 업데이트 실패 해결을 참고하세요.

최종 확인은 ‘업데이트 성공’ 메시지만으로 끝나지 않습니다. 대상 그룹을 열어 항목이 실제로 저장됐는지 확인한 뒤 새 설정을 선택해 연결을 테스트하세요. 현재 선택 항목이 이전 설정이라면 다시 선택하고 요청을 보내야 합니다. 자동 작업을 복구한 뒤에는 같은 그룹을 업데이트하는지, 직접 보관한 항목을 덮어쓰지 않는지도 확인하세요. 그룹 생성 방법을 모르겠다면 구독 가져오기 단계를 다시 확인하세요.

04 · 속도 비교

속도 저하: 첫 응답과 지속 전송을 따로 측정

웹페이지 로딩 지연, 파일 다운로드 지연, 동영상 버퍼링이 모두 같은 성능 문제인 것은 아닙니다. 페이지가 한참 비어 있다가 갑자기 로드된다면 DNS, 연결, 핸드셰이크부터 확인해 보세요. 다운로드가 시작된 뒤에도 전송 속도가 낮다면 네트워크 처리량, 동시 연결 수, 양쪽 장비의 부하를 먼저 살펴보세요. 안정적으로 재현되는 작업을 선택하고, 한 번의 빠른 지연 시간 테스트로 대용량 파일 전송 중의 지속적인 끊김을 반박하지 마세요.

대상은 그대로 두고 조건 하나만 바꿔 비교

같은 기기로 권한이 있는 동일한 테스트 대상에 접속하고 가능한 한 비슷한 시간대에 테스트하세요. 먼저 시스템 업데이트, 클라우드 동기화, 기타 대용량 작업을 일시 중지한 뒤 직접 연결 또는 현재 설정의 결과를 기록하세요. 대상에 직접 접속할 수 없다면 직접 연결 실패를 속도 0으로 기록하지 말고, 양쪽에서 확인할 수 있는 대상으로 일반 경로를 비교하세요. 다운로드는 같은 리소스를 사용해 시작 대기 시간과 안정화된 뒤의 속도를 기록하세요. 단위도 통일해 초당 바이트와 초당 비트를 같은 값으로 취급하지 않도록 주의하세요.

유선에서는 정상인데 같은 노드가 무선에서 느리다면 Wi-Fi 신호, 거리, 같은 네트워크를 사용하는 다른 기기의 부하를 먼저 확인하세요. 한 네트워크에서 특정 노드만 느리다면 해당 노드에서 대상까지의 경로, 서비스 상태, 혼잡 시간대의 성능을 점검하세요. 여러 노드에서 같은 리소스가 느리지만 다른 출처는 정상이라면 리소스 제공 서버의 속도 제한이나 응답 문제를 먼저 의심해 보세요. 한 번의 테스트에서 노드와 리소스를 동시에 바꾸면 개선의 원인을 파악할 수 없습니다.

시간 측정값으로 지연 구간 찾기

데스크톱에 curl이 설치돼 있고 로컬 HTTP 프록시를 사용하도록 설정했다면 아래 명령으로 HTTPS 요청을 테스트할 수 있습니다. 예시의 공개 테스트 도메인은 구간별 시간을 확인하는 용도이며 전송 처리량 측정에는 적합하지 않습니다. 로컬 포트가 10809가 아니라면 클라이언트에 표시된 HTTP 프록시 포트로 바꾸세요. Windows PowerShell에서는 명령어를 curl.exe로 입력하고 출력 대상 /dev/null을 NUL로 바꾸면 됩니다.

curl --proxy http://127.0.0.1:10809 --max-time 20 --silent --show-error --output /dev/null --write-out 'connect=%{time_connect}s tls=%{time_appconnect}s first_byte=%{time_starttransfer}s total=%{time_total}s http=%{http_code}\n' https://example.com/

수치는 명령 실행 시점부터 누적된 시간이며 네 구간의 소요 시간으로 각각 나눠 바로 더할 수 있는 값이 아닙니다. 로컬 프록시를 명시한 경우 연결 시간은 주로 curl이 로컬 프록시에 연결하는 데 걸린 시간을 나타냅니다. 이 값만으로 프록시가 원격 서버에 연결한 시점을 알 수는 없습니다. TLS 완료 시간에는 프록시 터널 연결 시간이 포함될 수 있고 첫 바이트 시간에는 대상 서버의 처리 시간도 포함됩니다. 브라우저는 연결을 재사용하거나 캐시를 활용할 수 있으므로 두 측정 결과가 매번 같을 필요는 없습니다. 명령에 오류가 발생하면 0으로 표시된 수치를 해석하지 말고 오류 메시지와 응답 상태를 확인하세요.

재테스트 결과를 바탕으로 설정 변경 여부 결정

첫 응답이 느리고 로그에 DNS 재시도가 반복된다면 DNS 장을 확인하세요. 지속 전송이 느리다면 같은 작업을 수행하면서 기기 CPU 사용률, 네트워크 사용량, 코어 로그를 살펴보세요. 오류 로그가 반복된다면 먼저 오류를 해결하세요. 상세 로그를 계속 켜 두는 것은 성능 개선 방법이 아닙니다. 여러 작업을 동시에 할 때만 문제가 발생한다면 동시 작업 수를 줄여 비교하고, 단일 연결 제한인지 모든 작업이 네트워크를 함께 사용하는 문제인지 확인하세요. 개선되는 설정만 유지하고 효과가 없다면 원래대로 되돌리세요.

특정 시간대에만 속도가 느려진다면 해당 시간대와 정상 시간대의 결과를 각각 기록하고 같은 노드, 대상, 라우팅을 사용했는지 확인하세요. 서비스 제공자는 이 자료로 서버 부하를 확인할 수 있습니다. 기기에서는 예약 업데이트나 백업 작업이 실행되는지 점검하세요. 재현되지 않는다면 기존 설정과 관찰 기록을 보존하세요. 한 번의 속도 테스트 결과만 개선하려고 전송 매개변수를 바꾸거나 여러 최적화 옵션을 무작정 켜거나 정상 작동하던 설정을 덮어쓰지 않는 것이 좋습니다.

05 · 도메인 확인

DNS 오류: 어떤 도메인을 어디서 확인했는지 파악

다른 서비스는 정상인데 특정 도메인만 열리지 않는다고 바로 DNS 문제로 단정할 수는 없습니다. 오류가 도메인 없음인지, DNS 확인 시간 초과인지, 도메인은 확인됐지만 이후 연결에 실패한 것인지 살펴보세요. 문제가 발생한 대상이 노드 서버 도메인인지 웹사이트 도메인인지도 확인해야 합니다. 전자는 노드 연결 자체를 막을 수 있고 후자는 특정 사이트나 특정 아웃바운드 요청에만 영향을 줄 수 있습니다. 두 도메인은 오류가 발생하는 단계가 다르므로 하나의 설정을 무작정 적용하지 마세요.

시스템·앱·코어의 DNS 경로를 각각 확인

시스템 프록시를 사용한다고 모든 도메인을 코어가 확인하는 것은 아닙니다. 브라우저에서 별도의 보안 DNS를 사용할 수 있고, 앱이 직접 도메인을 확인할 수도 있습니다. 트래픽 가로채기 방식, 프록시 프로토콜, 라우팅 설정에 따라 도메인을 기기에서 확인할지 원격에서 확인할지도 달라집니다. 먼저 실패한 요청의 로그에 도메인이 남아 있는지, 대상 주소가 기록됐는지, 앱·코어·시스템 중 어느 쪽이 DNS 요청을 보냈는지 확인하세요. 관련 로그가 없다면 현재 로그 수준과 연결 방식을 먼저 확인하세요. 로그에 빈칸이 있다고 해서 ‘DNS 요청을 보내지 않음’으로 기록해서는 안 됩니다.

데스크톱에서는 아래 명령으로 시스템 환경의 일반 DNS 조회를 확인할 수 있습니다. 예시 도메인을 문제가 발생한 테스트 가능한 도메인으로 바꾸세요. DNS 서버, 반환된 주소, 오류 유형을 기록한 뒤 클라이언트 로그와 비교하세요. 이 명령은 브라우저의 보안 DNS를 확인하지 않으며 코어가 같은 DNS 확인 서버를 사용한다는 뜻도 아닙니다. 서버 이름을 확인할 수 없다는 표시가 있어도 도메인 주소가 정상적으로 반환됐다면 이번 조회 결과를 기준으로 판단하세요. 이름 표시가 없는 것 자체를 오류로 보지 마세요.

nslookup -type=A example.com
nslookup -type=AAAA example.com

DNS 조회 실패와 IP 주소 연결 불가를 나눠 처리

DNS 조회가 시간 초과되면 현재 네트워크에서 사용 중인 DNS 서버에 접속할 수 있는지, DNS 서버로 향하는 연결을 클라이언트가 아직 연결되지 않은 노드에 다시 보내고 있지는 않은지 확인하세요. 도메인이 없다는 응답을 받았다면 전체 도메인 이름을 다시 확인하고, 사설 도메인에 회사 네트워크나 특정 DNS 서버가 필요한지 살펴보세요. 한 종류의 주소 레코드만 없는 것은 이상 현상이 아닐 수 있습니다. 일부 사이트는 한 종류의 주소만 게시합니다. 주소가 반환됐는데 연결에 실패한다면 해당 주소의 네트워크 경로, 인증서, 라우팅을 계속 점검하세요. DNS 서버를 반복해서 바꾸지 마세요.

주소 체계 차이로 문제가 발생했다면 두 DNS 조회 결과와 실제 연결에 사용된 주소를 각각 기록하세요. 듀얼 스택 기기에서 IPv6 주소가 반환돼도 안정적인 IPv6 경로가 있다는 뜻은 아닙니다. 브라우저가 다른 주소 체계로 자동 전환하더라도 코어나 대상 앱이 같은 방식으로 동작한다고 볼 수 없습니다. 먼저 클라이언트의 기존 옵션으로 범위를 좁혀 비교하고 실제 요청이 나아지는지 확인한 다음 유지 여부를 결정하세요. 기기 전체에서 IPv6를 끄는 것을 기본 해결책으로 삼지 마세요. 정상적으로 작동하는 다른 서비스까지 영향을 받을 수 있습니다.

라우팅이 도메인 정보에 의존하는지와 DNS 확인 순서 점검

일부 규칙은 도메인으로, 다른 규칙은 IP 주소로 매칭됩니다. 앱이 이미 확인된 주소만 코어에 전달한다면 도메인 규칙이 적용되는지는 코어가 도메인 정보를 얻었는지와 실제 설정에 따라 달라집니다. 라우팅에 주소 확인이 필요한 경우 DNS 확인 단계의 실패가 라우팅 오류처럼 보일 수도 있습니다. 먼저 규칙 매칭 결과나 실제 아웃바운드를 확인한 뒤 요청의 어느 단계에서 달라졌는지 판단하세요. 용어 간 관계는 개념 빠른 참조에서, 설정 변경 순서는 시스템 프록시 및 라우팅에서 확인할 수 있습니다.

재테스트할 때는 기존 탭을 닫고 영향을 받은 앱을 다시 시작하세요. 필요한 경우 캐시가 만료될 때까지 기다린 뒤 처음 실패한 도메인과 원래 정상적으로 열리던 도메인을 테스트하세요. 회사 사설 서비스라면 복구 후 내부 도메인이 정해진 DNS 경로를 계속 사용하는지도 확인해야 합니다. DNS 설정은 한 번에 하나씩 변경하고 변경 전 예상 결과와 변경 후 실제 결과를 기록하세요. 되돌릴 때는 목록에 추가한 주소만 삭제하지 말고 원래 DNS 서버와 연결 방식까지 복구하세요.

06 · 트래픽 처리와 아웃바운드

시스템 프록시가 작동하지 않을 때: 연결 방식과 라우팅을 나눠 점검

시스템 프록시는 일부 앱이 요청을 클라이언트에 전달할지 결정하고, 라우팅 규칙은 코어가 받은 요청을 어떤 아웃바운드로 보낼지 결정합니다. 시스템 프록시를 켜도 모든 앱이 이를 사용하는 것은 아니며, 라우팅 규칙을 선택해도 코어에 전달되지 않은 트래픽이 자동으로 들어오지는 않습니다. 먼저 요청이 코어에 도달했는지 확인한 다음 예상한 아웃바운드로 나갔는지 확인하세요. 두 설정을 동시에 바꾸면 ‘페이지는 열리지만 이유는 모르는’ 상황이 생길 수 있습니다.

로컬 프록시 진입점과 앱 설정 확인

데스크톱에서는 먼저 v2rayN을 확인하세요. 클라이언트의 리스닝 주소, 포트, 프록시 유형을 확인한 뒤 시스템 프록시 설정과 비교하세요. 앱에 별도의 프록시 옵션이 있다면 시스템 설정을 따르도록 명시돼 있는지, 이전 포트가 남아 있지는 않은지 확인하세요. 시스템 프록시가 적용된 뒤에는 앱을 다시 시작하거나 새 연결을 만들어 테스트하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 페이지 새로 고침만으로는 이 영향을 배제할 수 없습니다.

로컬 리스닝 포트를 정확히 입력했더라도 HTTP와 SOCKS 포트가 구분돼 있는지 확인하세요. 앱은 HTTP 프록시를 사용하지만 SOCKS 전용 포트를 입력하면 로컬 프로세스에는 연결되더라도 요청이 완료되지 않을 수 있습니다. 신뢰할 수 있는 테스트 대상으로 로컬 프록시를 명시한 요청과 앱 자체 요청을 비교하세요. 전자는 정상이지만 후자가 코어를 거치지 않는다면 노드를 바꾸기보다 앱 설정이나 프로세스 환경을 먼저 확인하세요. 프록시가 로컬 기기에서만 사용되는 경우 연결 문제를 해결하려고 모든 네트워크 인터페이스에서 접근할 수 있도록 리스닝 주소를 변경하지 마세요.

코어에 도달했다면 규칙 순서와 아웃바운드 태그 확인

라우팅 규칙은 일반적으로 목록 순서대로 적용됩니다. 범위가 넓은 규칙이 앞에 있으면 뒤쪽 예외 규칙이 적용되지 않을 수 있습니다. 한 규칙에 조건을 여러 개 넣었다고 해서 그중 하나만 만족해도 매칭되는 것은 아닙니다. 실패한 요청이 실제로 어떤 아웃바운드를 사용했는지 확인한 뒤 범위가 더 넓은 규칙이 먼저 적용됐는지 살펴보세요. 클라이언트 프리셋을 수정했다면 저장 후에도 수정한 설정이 선택돼 있는지 확인하세요. 일부 변경은 코어를 다시 불러와야 적용됩니다.

아래는 예시 도메인을 정확히 매칭하는 방법을 보여 주는 코어 설정용 라우팅 조각입니다. 완전한 시작 설정은 아닙니다. 기존 아웃바운드의 태그가 direct이고 네트워크 규칙상 해당 대상에 직접 연결할 수 있을 때만 사용하세요. full:은 도메인 전체와 일치하며 하위 도메인까지 함께 매칭하지 않습니다. 여기서 AsIs는 라우팅 매칭 단계에서 주소 규칙에 맞추려고 도메인을 직접 확인하지 않는다는 뜻이지, 앱에서 DNS 확인이 전혀 필요 없다는 뜻은 아닙니다.

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

현재 설정에서 테스트할 때는 필요한 규칙만 추가하세요. 전체 조각으로 기존 routing을 덮어쓰거나 운영 중인 도메인 정책을 함께 변경하지 마세요. 규칙의 아웃바운드 태그는 정의된 태그와 정확히 일치해야 합니다. 확인할 때는 예시 규칙 대상, 원래 노드로 처리되던 대상, 원래 직접 연결돼야 하는 대상을 각각 요청해 예상대로 처리되는지 살펴보세요. 특정 도메인 규칙만 적용되지 않는다면 코어가 도메인과 IP 주소 중 무엇을 받았는지 먼저 확인하세요.

문제가 발생한 범위에 따라 해결 방법 선택

특정 앱 하나만 시스템 프록시를 따르지 않는다면 해당 앱에서 지원하는 연결 설정을 우선 사용하세요. 여러 앱에서 코어에 트래픽이 들어가지 않는다면 시스템 프록시 진입점, 클라이언트 실행 상태를 확인하거나 회사 관리 정책에 따라 기기 단위 가로채기를 설정하세요. 트래픽은 들어오지만 아웃바운드가 잘못된 경우에만 라우팅 규칙을 수정하세요. 프리셋 이름은 용도를 구분하는 데 참고할 수 있지만 실제 규칙과 로그를 대신할 수는 없습니다. 관련 내용은 시스템 프록시와 라우팅 모드의 차이를 참고하세요.

07 · 시작 및 프로세스

클라이언트 충돌: UI 종료와 코어 종료 구분

아이콘을 두 번 눌러도 창이 열리지 않는 경우, 화면이 잠깐 나타났다가 사라지는 경우, 창은 남아 있지만 연결되지 않는 경우는 서로 다른 상황입니다. UI 프로세스와 코어 프로세스가 실행 중인지 확인하고 프로그램 실행, 설정 불러오기, 연결 버튼 클릭 중 어느 시점에 문제가 발생하는지 기록하세요. 충돌로 네트워크가 끊겼다면 이후 테스트 전에 기존 시스템 연결 설정부터 복구하세요. 프로그램을 연달아 다시 실행하면 이전 로그가 사라질 수 있으므로 먼저 확인 가능한 첫 오류를 저장하세요.

플랫폼·아키텍처·설치 방식 확인

데스크톱에서는 먼저 v2rayN을 사용하세요. 설치 패키지 아키텍처가 기기와 시스템 환경에 맞아야 합니다. Windows는 Windows 다운로드에서 데스크톱 버전과 클래식 WPF 버전을 구분하세요. macOS는 macOS 다운로드에서 칩에 맞는 패키지를 선택하세요. Linux는 Linux 다운로드에서 프로세서 아키텍처와 배포판에 맞는 패키지 형식을 함께 확인하세요. 실행 환경이 없다는 메시지가 나타나면 실제 배포 패키지 안내를 따르세요. 다른 프로그램 폴더에서 런타임 파일을 가져와 조합하지 마세요.

압축을 풀어야 하는 패키지는 권한이 있고 경로가 안정적인 폴더에 전체 압축을 푼 뒤 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요. 프로그램이 설정 파일 일부만 저장할 수 있으면 시작 후 종료되거나 다음 실행 때 설정이 사라질 수 있습니다. 먼저 폴더 권한, 디스크 여유 공간, 보안 소프트웨어의 실제 차단 기록을 확인하세요. 관리되는 기기에서 시스템이 실행을 차단하면 관리자가 확인해야 합니다. 시험 삼아 기기 전체의 보안 정책을 변경하지 마세요.

UI는 열려 있지만 코어가 종료됨: 첫 번째 오류부터 확인

코어 시작에 실패하면 마지막 로그는 일반적인 종료 안내인 경우가 많고 실제 원인은 그보다 앞에 있습니다. 주소가 이미 사용 중이라는 오류가 나오면 로컬 리스닝 주소와 포트를 확인하고 클라이언트가 중복 실행 중인지, 다른 서비스가 포트를 사용 중인지 살펴보세요. 정확히 확인됐고 중지해도 되는 프로세스만 종료하거나 비어 있는 포트로 변경한 뒤 관련 앱 설정도 함께 바꾸세요. 설정 파싱 오류라면 표시된 필드나 규칙 위치부터 확인하세요. 먼저 시스템 프록시를 바꾸지 마세요.

특정 노드를 선택할 때만 종료된다면 일시적으로 트래픽 가로채기를 끄고 이전에 작동했던 노드로 다시 테스트하세요. 전자는 실패하고 후자는 성공한다면 전송 매개변수, 프로토콜 필드, 관련 규칙을 비교하세요. 모든 노드에서 실패한다면 공통 설정, 파일 읽기·쓰기 권한, 현재 클라이언트에서 코어를 호출할 수 있는지 확인하세요. 시작과 첫 연결은 정상이지만 절전 모드 해제나 네트워크 전환 후에만 종료된다면 해당 시점 전후의 로그를 저장하고 프로세스 종료 전에 네트워크가 바뀌었는지 기록하세요.

깨끗한 환경에서 테스트하고 설정을 단계적으로 복원

초기화하기 전에 설정과 작동 가능한 노드를 백업하고 UI 설정과 기존 시스템 연결 방식을 기록하세요. 클라이언트가 지원하는 방법으로 기존 설정을 분리한 뒤 새 환경에 작동이 확인된 노드 하나만 가져와 시작, 중지, 재시작을 테스트하세요. 안정적으로 작동하면 구독과 기존 설정 기반 규칙을 나눠 복원하고 단계마다 다시 테스트하세요. 특정 항목을 복원한 뒤 문제가 재발하면 해당 항목을 더 좁혀 확인하세요. 기존 설정 전체를 덮어쓴 뒤 같은 문제를 다시 반복하지 마세요.

새 환경에서도 문제가 재발한다면 UI만 실행하고 연결하지 않는 테스트를 한 번 더 수행한 뒤 연결 직후 직접 종료하는 테스트도 해 보세요. UI가 시작되자마자 종료되면 UI 실행 환경과 앱 데이터를 확인하세요. 네트워크 가로채기를 사용할 때만 실패하면 관련 권한, 코어 로그, 시스템 네트워크 구성요소를 살펴보세요. 기존 환경에서만 실패한다면 진단에 필요한 재현 설정 일부를 보존하세요. 기기 전체를 초기화하거나 정상 설정까지 삭제할 필요는 없습니다. 설치 패키지를 바꾼 뒤에는 앱 재시작과 전체 연결 확인을 최소 한 번씩 수행하세요.

08 · 모바일 기기 점검

모바일 연결 끊김: VPN 처리와 백그라운드 상태 확인

Android에서 자주 발생하는 문제는 연결을 눌러도 시스템 세션이 만들어지지 않는 경우, 백그라운드 전환이나 화면 잠금 후 연결이 끊기는 경우, Wi-Fi와 모바일 데이터 간 전환 후 복구되지 않는 경우입니다. 한 번에 하나씩 테스트하고 화면을 잠그면서 네트워크를 전환하지 마세요. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 설치 패키지와 지원 아키텍처는 Android 다운로드에서 확인하세요. 클라이언트를 바꾸기 전에 문제가 시스템 세션 관리에서 비롯된 것인지 먼저 확인하세요.

연결할 수 없음: 권한·기존 세션·앱 범위 확인

Android에서 처음 VPN 트래픽 가로채기를 시작하면 시스템에서 권한을 요청합니다. 화면에는 연결 중이라고 표시되지만 시스템 설정에 해당 세션이 없다면 권한 요청과 클라이언트 로그를 확인한 다음 현재 사용자에서 다른 VPN이 연결 위치를 사용 중인지 확인하세요. 관리되는 기기에서는 상시 사용 VPN이나 업무 프로필 연결 정책을 관리자가 제어할 수 있습니다. 관리 대상 설정을 강제로 끄지 마세요. 먼저 앱이 현재 사용자와 업무 프로필 중 어디에서 실행 중인지 확인한 뒤 시스템 정책에 따라 충돌을 해결하세요.

시스템 세션은 연결됐지만 일부 앱만 열리지 않거나 예상한 경로를 사용하지 않는다면 클라이언트의 앱별 트래픽 처리 목록을 확인하세요. 목록이 ‘선택한 앱만 처리’하는지 ‘선택한 앱은 제외’하는지 구분해야 합니다. 변경 후 다시 연결하고 영향을 받은 앱을 재시작한 뒤 동일한 사용자 환경에서 테스트하세요. 상태 표시줄에 VPN 아이콘이 보인다는 것은 세션이 있다는 뜻일 뿐입니다. 앱이 대상에 포함됐는지, 코어가 노드에 연결됐는지, 라우팅이 올바른지는 실제 요청으로 확인해야 합니다.

화면 잠금 후 연결 끊김: 프로세스 종료와 노드 연결 끊김 구분

먼저 화면을 켠 상태로 유지하면서 페이지를 연속으로 열고 클라이언트 상태를 기록하세요. 그런 다음 같은 네트워크에서 재현 가능한 시간 동안 화면을 잠그세요. 잠금을 해제한 뒤 원래 대상을 열기 전에 시스템 세션과 클라이언트 로그를 확인하세요. 세션이 사라졌거나 프로세스가 다시 시작됐거나 시작 로그가 새로 나타났다면 시스템의 백그라운드 제한부터 확인하세요. 세션은 유지되지만 요청 시간이 초과된다면 네트워크 전환, 유휴 시간 제한, 노드 상태를 살펴보세요. 알림이 계속 표시된다는 이유만으로 연결이 정상이라고 판단하지 마세요.

백그라운드 제한이 원인이라면 시스템에서 허용하는 범위 내에서 해당 클라이언트의 배터리 사용 또는 백그라운드 활동 설정만 조정하세요. 기기마다 설정 이름은 다를 수 있습니다. 변경 전 기존 값을 기록하고 관련 없는 앱이나 기기 전체 절전 설정은 건드리지 마세요. 데이터 절약 설정도 켜져 있다면 앱이 화면을 켠 상태와 백그라운드 상태에서 모바일 데이터를 사용하는지 따로 비교하세요. 배터리 제한과 데이터 제한을 한 번에 변경하지 마세요. 효과가 없다면 원래 값으로 복원하고 일정한 시간에 클라이언트가 재시작되는지, 네트워크가 바뀌는지 확인하세요.

네트워크 전환 실패: 새 네트워크의 기본 연결부터 확인

Wi-Fi에서 모바일 데이터로 전환하면 기존 연결이 끊길 수 있으며, 새 연결은 시스템이 사용 가능한 네트워크 경로를 확보한 뒤에야 만들어집니다. 먼저 개인 클라이언트의 트래픽 가로채기를 끄고 새 네트워크에서 원래 접속할 수 있던 대상에 연결해 보세요. 새 네트워크 자체가 작동하지 않으면 네트워크 인증이나 모바일 데이터 설정을 확인하세요. 직접 연결은 정상이면 같은 노드로 다시 연결해 테스트하세요. 특정 방향으로 전환할 때만 실패한다면 전환 전후의 네트워크 유형, 재연결 시간, 첫 오류를 기록해 모바일 네트워크 경로 문제와 클라이언트 연결 재구성 실패를 구분하세요.

마지막으로 같은 앱에서 화면을 켠 상태의 연결, 잠금 해제 후 복구, 네트워크 전환 후 복구를 각각 테스트한 다음 두 번째 앱으로 문제가 특정 앱에만 국한되는지 확인하세요. 연결이 자동 복구되지만 매번 시간이 걸린다면 네트워크가 사용 가능해진 시점부터 요청이 성공할 때까지 걸린 시간을 기록하세요. 대기 시간을 계속된 연결 끊김으로 기록하지 마세요. 네트워크 전환 후 도메인 요청만 실패한다면 DNS 장으로 돌아가 앱, 시스템, 코어가 실제로 사용하는 DNS 경로를 확인하세요.

증상 목차로 돌아가기 ↑