v2rayN 사용 설명서 · 증상별 안내

v2rayN 문제 해결

먼저 기기 전체의 인터넷이 끊겼는지, 특정 노드만 실패하는지, 특정 앱만 프록시를 사용하지 않는지 확인한 뒤 해당 항목을 살펴보세요.

처음 설치했거나 아직 구독을 가져오지 않았다면 빠른 시작 가이드를 먼저 따라 해 보세요. 이미 설정을 마쳤는데 문제가 생겼다면 이 페이지에서 증상에 맞는 항목을 확인하세요. 문제가 해결된 뒤에는 가이드로 돌아가 가져오기, 노드 선택, 연결 확인 절차를 점검할 수 있습니다.

01 / 연결 기본 점검

인터넷에 연결되지 않음

먼저 직접 연결을 복구한 다음 로컬 프록시 포트와 현재 노드를 확인하세요. 직접 연결도 되지 않는다면 기본 네트워크부터 점검해야 합니다.

프록시 해제 후 직접 연결 확인

인터넷이 끊기기 전에 마지막으로 한 작업을 먼저 떠올려 보세요. 노드를 바꿨는지, 절전 모드에서 깨어났는지, 클라이언트를 방금 업데이트했는지 확인합니다. 데스크톱에서는 v2rayN 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭하고 ‘시스템 프록시’에서 ‘시스템 프록시 해제’를 선택하세요. TUN 모드도 사용 중이었다면 먼저 끕니다. 브라우저를 완전히 종료했다가 다시 열고, 원래 직접 접속할 수 있었던 사이트 두 곳을 방문해 보세요. 두 곳을 확인하면 특정 사이트의 문제를 기기 전체의 인터넷 장애로 오인하는 일을 줄일 수 있습니다. 모바일에서는 먼저 클라이언트 VPN 연결을 끊고 브라우저에서 똑같이 확인하세요.

직접 연결도 되지 않는다면 시스템이 네트워크 주소를 받았는지, 연결된 네트워크에 먼저 로그인해야 하는지 확인하세요. 공용 Wi-Fi는 연결된 것으로 표시되더라도 웹 인증을 마쳐야 인터넷을 쓸 수 있습니다. 사무실 네트워크에는 원래 필요한 시스템 프록시가 설정되어 있을 수도 있습니다. 프록시를 해제했다면 관리자에게 받은 설정으로 복구해야 하며, ‘프록시 끄기’가 언제나 정답은 아닙니다. 시스템에서 원래 직접 연결이 가능하고 기기 한 대에서만 문제가 발생한다면, 같은 네트워크의 다른 기기에서도 같은 사이트를 열어 보세요. 두 기기 모두 실패하면 게이트웨이나 네트워크 연결을 확인하고, 한 기기만 실패하면 해당 기기의 기존 네트워크 설정을 점검하세요.

직접 연결이 되면 로컬 리스너 확인

v2rayN 기본 창으로 돌아가 사용할 수 있는 설정 하나를 선택하고 활성 서버로 지정하세요. 목록에서 강조 표시된 항목은 선택된 행일 뿐입니다. 창의 상태 영역에서 현재 활성 항목이 실제로 바뀌었는지 확인하세요. 그런 다음 메시지 영역에 방금 기록된 시작 로그를 살펴보세요. 포트 충돌, 설정 읽기 실패, 코어 실행 실패가 표시되면 먼저 해당 오류를 해결해야 합니다. 창이 열렸다는 것은 그래픽 인터페이스가 실행된다는 뜻일 뿐입니다. 프록시 연결이 가능한지는 코어 프로세스가 시작되어 현재 설정된 포트에서 대기 중인지 확인해야 합니다.

우선 TUN은 켜지 말고 수동 프록시를 지원하는 테스트 앱에 클라이언트가 표시하는 로컬 주소와 포트를 입력하세요. 프록시 유형도 확인해야 합니다. 앱이 HTTP 프록시를 요구하면 클라이언트에서 제공하는 HTTP 또는 호환 혼합 포트를 사용하고, SOCKS만 지원하는 프로그램에는 해당 포트를 입력하세요. 원격 서버 주소를 시스템 프록시 설정에 입력하면 안 됩니다. 앱이 여전히 실패하면 연결 거부, 응답 대기 시간 초과, 대상 서버 오류 중 어떤 메시지가 표시되는지 기록하세요. 연결 거부는 로컬 리스너부터 확인하고, 시간 초과는 현재 노드와 네트워크를 살펴보세요. 대상 서버 오류라면 응답을 프록시와 대상 서버 중 어디에서 보냈는지 확인해야 합니다.

영향 범위에 따라 다음 단계 선택

수동 프록시는 작동하지만 ‘시스템 프록시 자동 설정’ 후에도 브라우저에서 접속할 수 없다면 시스템 프록시 미작동 항목으로 이동하세요. 특정 노드 하나만 실패하면 사용할 수 있는 노드는 그대로 두고 노드 시간 초과 항목에서 포트, 핸드셰이크, 대상 접속을 구분해 확인하세요. 도메인 오류만 발생하면 DNS 조회 오류 항목에서 어느 구성 요소가 이름을 조회하는지 살펴보세요. 문제를 확인하는 동안 새 구독을 가져와 현재 상태를 덮어쓰지 마세요. 오류 발생 시각, 현재 활성 항목의 사용자 메모, 문제가 발생한 앱을 기록한 다음 한 번만 다시 시도하고 해당 요청과 같은 시각에 생성된 로그를 확인하세요.

복구 후에는 역방향으로도 확인하세요. 프록시가 필요한 앱에서 접속되는지 확인한 다음 시스템 프록시를 해제하고, 원래 직접 접속해야 하는 서비스도 계속 작동하는지 살펴보세요. 클라이언트가 실행 중일 때만 네트워크가 정상이고 종료하면 다시 끊긴다면, 시스템 프록시가 꺼진 로컬 포트를 계속 가리키는지 확인하고 TUN도 해제되었는지 점검하세요. 재부팅으로 문제가 잠시 사라져도 원인은 알 수 없습니다. ‘남은 프록시 설정을 해제해 직접 연결을 복구했다’ 또는 ‘코어 리스너를 복구해 프록시를 되살렸다’처럼 해결된 단계를 기록해 두면 다음에는 해당 부분부터 확인할 수 있습니다.

02 / 포트와 핸드셰이크

노드 시간 초과

먼저 어떤 방식으로 테스트했는지 확인하세요. 포트에 연결된다고 프로토콜 핸드셰이크까지 성공한 것은 아니며, 테스트가 시간 초과됐다고 모든 대상에 접속할 수 없는 것도 아닙니다.

단일 노드, 같은 그룹, 전체 노드 중 어디서 시간 초과가 발생하는지 확인

v2rayN 서버 목록에서 두 항목을 골라 비교하세요. 하나는 방금 오류가 난 노드, 다른 하나는 같은 기기에서 최근 실제로 사용한 노드로 선택합니다. 같은 접속 지점에 메모만 다르게 붙인 항목은 비교 대상으로 적합하지 않습니다. 두 항목만 테스트하면 그룹 전체를 동시에 점검해 로컬 네트워크를 과부하시키거나 서버 연결 제한을 유발하는 일을 피할 수 있습니다. 목록에 표시된 지연 시간은 이전 테스트 결과일 수 있으므로 별도로 다시 측정하고 테스트 방식과 시각을 기록하세요. 과거 결과로 현재 연결 상태를 판단하지 마세요.

같은 그룹의 여러 항목이 동시에 시간 초과된다면 접속 도메인, 계정, 전송 매개변수를 공유할 수 있으므로 각각 독립된 장애라고 볼 수 없습니다. 서로 다른 그룹과 접속 지점까지 모두 실패하면 메시지 영역의 코어 시작 로그를 확인하고 기기 시각과 현재 네트워크 상태를 살펴보세요. 접속 지점 하나만 계속 실패하지만 같은 라우팅 모드를 사용하는 다른 설정으로 같은 웹 페이지를 열 수 있다면, 전체 설정을 바꾸기보다 실패한 항목의 서버 상태와 구성을 확인하세요. 어떤 항목으로도 접속한 적이 없다면 가져오기 및 노드 선택 절차로 기본 설정을 확인한 뒤 새 설정의 호환성 문제인지 네트워크 경로 문제인지 판단하세요.

테스트 결과를 계층별로 해석

테스트별로 확인할 수 있는 범위
테스트 방식확인할 수 있는 내용실패 시 먼저 확인할 항목
시스템 Ping대상이 네트워크 계층 탐색에 응답하는지 확인합니다. 프록시 포트는 확인하지 않습니다.대상이 응답을 허용하는지 확인한 다음 해당 전송 방식으로 테스트하세요.
TCP 연결 테스트현재 기기에서 지정한 TCP 포트로 연결을 설정할 수 있는지 확인합니다.접속 도메인, 원격 포트, 네트워크 경로
실제 연결 테스트프록시를 통해 테스트 대상 주소에 접속할 수 있는지 확인합니다.코어 로그, 핸드셰이크 매개변수, 테스트 주소

TCP 테스트는 TCP 연결을 설정해야 하는 접속 지점에만 사용할 수 있으며, UDP 전송을 사용하는 실제 서비스 테스트를 대신할 수 없습니다. 실제 연결 테스트는 원격 포트뿐 아니라 프로토콜 핸드셰이크, 아웃바운드 전달, 테스트 대상의 응답까지 확인합니다. 테스트 주소가 작동하지 않거나 응답 방식이 바뀌었거나 요청에 자체 제한을 둔 경우, 앱에서 실제 대상에 정상적으로 접속되더라도 인터페이스에는 시간 초과가 표시될 수 있습니다. 이때는 동일한 활성 설정으로 평소 실제 사용하는 대상 두 곳에 접속해 보세요. 두 곳 모두 정상이라면 테스트 대상 단계의 문제로 기록하세요.

로그로 연결 실패와 핸드셰이크 실패 구분

노드를 활성 상태로 둔 채 실제 접속을 한 번 시도하고 테스트 시각 직전과 직후의 오류를 확인하세요. 로그에 서버 주소를 확인할 수 없다고 먼저 표시된다면 원격 포트 연결을 시도하기도 전일 수 있습니다. DNS 항목으로 이동해 접속 도메인을 먼저 확인하세요. 연결 시간 초과라면 포트 입력이 잘못되지 않았는지, 서버가 대기 중인지, 같은 기기에서 사용 가능한 다른 네트워크로 바꿔도 증상이 같은지 확인하세요. 연결 거부는 연결 시도가 명시적으로 거절됐다는 뜻이므로 시간 초과 값을 무작정 늘리지 말고 포트에서 실행 중인 서비스와 접속 주소를 먼저 살펴보세요.

포트 연결은 되지만 핸드셰이크가 실패하면 프로토콜, 전송 방식, TLS 상태, 서버 이름, 전송 경로를 설정 출처의 정보와 하나씩 대조하세요. 연결 주소와 TLS 서버 이름은 서로 다를 수 있으므로 두 값이 다르다는 이유만으로 같게 바꾸지 마세요. 인증서 유효 기간 오류라면 시스템 날짜, 시간, 시간대를 먼저 동기화하세요. 오류를 숨기려고 인증서 검증을 끄지 마세요. 같은 설정으로 다른 기기에서는 핸드셰이크가 성공하더라도 양쪽이 같은 접속 지점, 같은 코어, 동일한 전송 설정을 사용하는지 확인하세요. 이름만 같은 다른 항목일 수도 있습니다.

원래 연결 경로가 복구됐는지 확인

원인을 찾았다면 원래 활성 노드로 실제 접속을 다시 시도하고 메시지 영역에 같은 오류가 반복되지 않는지 확인한 뒤 지연 시간을 다시 측정하세요. 서버가 이전되어 주소가 바뀌었다면 신뢰할 수 있는 출처에서 영향을 받은 그룹을 업데이트하고 새 접속 지점을 확인한 뒤 활성 항목을 바꾸세요. 새 설정 버전에서 만료된 포트가 실제로 교체된 경우에만 구독 업데이트로 문제가 해결된 것입니다. 업데이트 전후 오류가 완전히 같다면 목록을 반복해서 갱신하지 말고 로그를 바탕으로 접속 또는 핸드셰이크 단계를 계속 점검하세요.

03 / 요청과 가져오기

구독 업데이트 실패

입력한 값이 구독 주소인지 먼저 확인한 뒤 요청 성공 여부와 응답 내용의 가져오기 가능 여부를 따로 살펴보세요.

그룹과 주소를 확인하고 기존 설정은 보존

데스크톱에서 ‘구독 그룹’을 열고 ‘구독 그룹 설정’으로 이동해 오류가 발생한 그룹을 선택하세요. ‘이름’과 ‘주소(url)’가 서로 맞는지 확인하고 업데이트가 활성화되어 있는지도 살펴보세요. 이름이 같아도 주소가 다를 수 있어 여러 그룹을 정리하다가 잘못 선택하기 쉽습니다. ‘주소(url)’는 끝부분의 쿼리 매개변수와 복사 과정에서 포함된 줄바꿈까지 확인해 빠짐없이 붙여넣어야 합니다. 주소에 접속 정보가 포함되어 있다면 클라이언트 안에서만 확인하고 온라인 분석 도구, 검색창, 공개 게시물에 붙여넣지 마세요.

vmess:// 또는 vless://로 시작하는 공유 링크는 보통 서버 설정 하나에 해당하므로 구독 주소 입력란이 아니라 클립보드에서 가져와야 합니다. 제공업체의 로그인 페이지나 구독 관리 페이지도 구독 응답 주소가 아닙니다. 브라우저에서 관리 페이지가 열린다고 해서 웹 페이지 접속만 확인된 것입니다. v2rayNG에서는 사이드 메뉴의 ‘구독 그룹’에서 저장된 주소를 확인한 뒤 기본 목록으로 돌아가 구독을 업데이트하세요. 메뉴 이름은 언어와 버전에 따라 조금 다를 수 있으므로 두 클라이언트의 구독 가져오기 안내를 참고하세요. 업데이트 전에 작동 중인 설정을 보존해 비교할 노드를 잃지 않도록 하세요.

현재 그룹을 수동으로 한 번 업데이트해 요청 실패 확인

v2rayN의 ‘구독 그룹’ 메뉴에서 현재 구독 업데이트를 선택하세요. ‘프록시 사용’과 ‘프록시 미사용’ 방식이 모두 있다면 현재 연결 상태에 맞게 선택합니다. 구독 서버에 직접 연결할 수 있다면 우선 프록시를 사용하지 않고 업데이트하세요. 프록시 경로로만 접속할 수 있다면 먼저 활성 노드가 작동하는지 확인한 뒤 프록시를 사용해 업데이트하세요. 유일한 활성 노드가 이미 작동하지 않는다면 해당 노드를 통한 구독 업데이트는 순환 의존을 일으킵니다. 이때는 구독 서버에 접속할 수 있는 네트워크를 사용하거나 이미 있는 다른 유효한 설정을 이용하세요. 모든 그룹의 업데이트 방식을 같은 방식으로 바꿀 필요는 없습니다.

업데이트를 한 번 실행한 뒤 바로 해당 요청의 로그를 확인하세요. 연결이 설정되지 않았다면 구독 도메인의 DNS 조회와 접속 경로를 살펴보세요. 상태 코드가 표시되면 응답에 따라 처리하세요. 인증 실패나 접근 거부가 발생하면 기존 주소가 바뀌었거나 권한이 만료됐는지 확인한 다음 구독 제공처에 문의하세요. 쿼리 매개변수를 계속 바꿔 가며 반복 시도하지 마세요. 주소를 찾을 수 없다는 오류라면 접속 경로가 바뀌었는지 확인하세요. 요청 제한이라면 연속 재시도를 멈추고 서버 안내에 따라 기다리세요. 서버 오류가 발생하면 기존 목록을 보존하고 잠시 후 같은 경로로 다시 확인하세요. 반복해서 클릭하면 첫 요청의 중요한 로그가 덮일 수 있습니다.

응답은 성공했지만 노드가 없다면 형식과 필터 확인

응답이 성공했다는 것은 클라이언트가 내용을 받았다는 뜻일 뿐, 가져올 수 있는 설정이라는 뜻은 아닙니다. 서버가 로그인 페이지, 네트워크 인증 페이지, 일반 텍스트 안내 또는 다른 종류의 클라이언트용 설정 파일을 반환했을 수 있습니다. 구독 제공처에 표시된 출력 형식이 현재 클라이언트와 맞는지 확인한 뒤, 인코딩된 링크 모음이나 줄마다 하나씩 된 공유 링크를 반환해야 하는지 문의하세요. 형식을 확인하려고 전체 응답을 외부 도구에 업로드하지 마세요. 대부분은 로그에 표시된 파싱 메시지와 제공업체의 구독 유형 안내만으로 충분합니다.

로그에는 가져오기가 완료됐다고 표시되지만 현재 화면에 새 노드가 없다면 해당 구독 그룹으로 돌아가 기본 목록의 검색어를 지운 뒤 ‘구독 그룹 설정’에 ‘필터’가 입력되어 있는지 확인하세요. 기존 필터 값을 기록하고 해당 조건 하나만 잠시 제거한 다음 다시 시도하세요. 필터를 제거한 뒤 노드가 나타난다면 주소가 만료된 것이 아니라 필터 범위가 문제일 가능성이 큽니다. 필터를 복구할 때 필요한 항목이 남는지 먼저 확인하세요. 새 노드는 표시되지만 활성 항목이 기존 설정을 계속 가리킨다면 새 항목을 직접 선택해 연결을 따로 확인하세요.

04 / 지연 시간과 전송 속도

속도 저하

첫 화면이 늦게 뜨는지, 전송 내내 느린지, 간헐적으로 끊기는지 먼저 구분하세요. 각 증상은 서로 다른 연결 구간에서 발생할 수 있습니다.

같은 조건에서 짝을 지어 테스트

접근 권한이 있고 크기가 일정한 파일이나 평소 사용하는 페이지를 테스트 대상으로 선택하세요. 네트워크 유형, 테스트 시각, 활성 노드를 기록합니다. 백그라운드 동기화와 진행 중인 대용량 다운로드를 잠시 멈추고 같은 기기, 앱, 라우팅 방식을 유지한 채 노드만 바꾸어 두 번 테스트하세요. 한 번 측정하고 가장 높은 값을 택하는 것보다 같은 증상이 반복되는지 확인하는 편이 유용합니다. 예를 들어 처음 로딩만 오래 걸리는지, 전송이 시작된 뒤 안정적인지, 처음에는 빠르다가 곧 느려지는지 살펴보세요. 브라우저 캐시 때문에 두 번째 페이지 로딩이 더 빠를 수 있습니다. 새 세션에서 첫 접속을 비교하고 캐시된 결과는 따로 기록하세요.

대상에 직접 연결할 수 있을 때는 직접 연결 결과도 함께 비교하세요. 직접 연결과 프록시 모두 같은 시간대에 느리다면 Wi-Fi 신호, 같은 네트워크의 다른 기기 사용량, 대상 서버 상태, 게이트웨이의 업로드 상태부터 확인하세요. 프록시 연결만 느리다면 재현되는 시각을 기록하고 사용할 수 있는 다른 노드와 비교하세요. 직접 연결한 사이트와 프록시로 접속한 다른 사이트의 전송 속도를 비교하지 마세요. 두 대상은 리소스 크기, 캐시 위치, 속도 제한이 다를 수 있습니다. 마찬가지로 오전의 핫스팟과 저녁의 Wi-Fi 결과만으로 어느 설정이 더 빠른지 판단할 수도 없습니다.

연결 대기와 지속 전송을 구분

지연 시간 테스트에서 나온 밀리초 수치는 다운로드 속도와 같지 않습니다. 페이지가 처음에는 느리지만 이후 원활하게 로딩된다면 DNS 조회, 연결 설정, 핸드셰이크, 대상 서버의 응답 준비 단계에서 지연이 발생했을 수 있습니다. 브라우저 개발자 도구의 ‘네트워크’ 패널에서 요청 시간을 확인할 수 있습니다. 기본 문서를 선택하고 첫 바이트를 기다린 시간과 콘텐츠를 다운로드한 시간을 구분하세요. 프록시를 사용할 때 브라우저가 클라이언트나 원격 측에서 수행한 DNS 조회를 직접 표시하지 않을 수도 있습니다. 따라서 패널에 DNS 시간이 표시되지 않는다는 이유만으로 DNS 문제를 배제할 수 없습니다. 같은 시각의 클라이언트 로그로 이 정보를 보완하세요.

파일 전송 초반은 빠르지만 시간이 지나며 눈에 띄게 느려진다면 다른 노드와 다른 대상에서도 비교하세요. 한 대상에서만 발생하면 해당 사이트나 다운로드 서버의 속도 제한을 살펴보세요. 같은 노드로 여러 대상에 접속할 때 모두 느려진다면 프록시 경로, 동시 연결 수, 기기 부하를 확인하세요. 연결 중 시스템 모니터에서 코어 프로세스나 보안 검사 프로세스가 CPU를 계속 많이 사용한다면 동시 요청을 줄이고 부하와 속도가 함께 변하는지 확인하세요. 한 번 낮게 나온 속도 측정 결과만으로 시스템 보호 기능을 끄지 마세요. 멀티플렉싱, 전송 방식, 코어를 한꺼번에 바꾸어 속도를 높이려 하지 마세요.

잘못된 경로의 트래픽과 네트워크 전환 확인

느린 것이 앱 전체인지 특정 리소스만인지 확인하세요. 웹 페이지의 기본 문서와 동영상, 이미지는 서로 다른 도메인에서 제공될 수 있습니다. 기본 사이트가 특정 라우팅 규칙에 일치하더라도 뒤이어 요청하는 리소스가 같은 경로를 이용한다고 볼 수는 없습니다. 현재 라우팅 설정을 확인한 뒤 연결 로그에서 느린 리소스의 아웃바운드를 비교하세요. 프록시 모드를 바꾼 뒤 로딩이 정상으로 돌아왔다면 어떤 도메인 유형이 다른 규칙에 일치했는지 추가로 확인하세요. 속도 테스트 결과만으로 장기간 전역 프록시를 사용하지 마세요. 원래 직접 연결해야 하는 트래픽까지 불필요한 경로를 거칠 수 있습니다.

Wi-Fi 전환, 절전 모드 해제, 유선에서 무선으로 전환한 뒤에만 끊긴다면 새 요청을 다시 보내고 아직 끝나지 않은 이전 연결과 비교하세요. 이전 연결은 전환 전 네트워크 경로에 묶여 있을 수 있습니다. 시간 초과가 발생해도 새 연결까지 문제가 있다는 뜻은 아닙니다. 화상 회의나 실시간 서비스에서만 끊기고 일반 파일 다운로드는 대체로 정상이라면 해당 앱의 전송 방식이 현재 연결 모드에 포함되는지 확인하세요. 웹 페이지 다운로드만 테스트해서 실시간 서비스 성능까지 판단할 수는 없습니다. 네트워크 변동이 원인이라면 전체 노드 설정을 바꾸기보다 접속 환경을 먼저 개선하세요.

05 / 도메인 조회

DNS 조회 오류

프록시 접속 도메인과 대상 도메인을 구분하세요. DNS 레코드를 확인한 뒤에는 어떤 구성 요소가 그 결과를 사용하는지도 확인해야 합니다.

어떤 DNS 조회에서 실패했는지 확인

브라우저에 표시된 전체 오류 유형을 기록하고 같은 시각의 v2rayN 메시지 영역과 비교하세요. 로그에 서버 접속 도메인이 표시된다면 프록시 연결이 아직 설정되지 않았을 수 있습니다. 접속하려는 사이트나 라우팅 규칙에 지정된 도메인이 표시된다면 앱, 시스템, 프록시 아웃바운드 중 어느 쪽이 이름을 조회하는지 확인해야 합니다. 브라우저 주소창에 도메인 대신 숫자 주소를 입력해 판단하지 마세요. 많은 사이트는 TLS 서버 이름과 HTTP 호스트 이름에 의존하며 하나의 주소에서 여러 웹사이트를 제공하기도 합니다. 숫자 주소로 연결되지 않는다고 DNS 문제가 입증되는 것은 아닙니다.

한 브라우저에서만 DNS 오류가 발생한다면 다른 브라우저나 같은 브라우저의 새 세션으로 먼저 비교한 다음 ‘보안 DNS’와 브라우저 자체 프록시 설정을 확인하세요. 앱에서 별도의 DNS 조회를 사용하면 시스템 조회는 정상이더라도 앱은 다른 DNS 서버를 사용할 수 있습니다. TUN을 사용 중이라면 DNS 조회도 가로채질 수 있으므로 켜고 끈 상태의 결과를 각각 기록하세요. 사내 도메인은 내부 DNS 서버에서 조회해야 할 수 있습니다. 이를 공용 DNS 서버에 보내도 기존 설정을 대신할 수 없으며 내부 이름을 전달해서는 안 되는 곳에 노출할 수 있습니다.

시스템 경로를 조회해 DNS 레코드와 실제 연결 구분

Windows PowerShell에서 아래 두 명령을 실행해 공개 테스트 도메인의 IPv4와 IPv6 레코드를 각각 조회하세요. 실제 문제를 확인할 때는 기기에서 테스트 도메인을 오류가 발생한 도메인으로 바꾸면 됩니다. 구독 주소의 경로나 매개변수는 조회에 넣지 마세요. 실행 전에 VPN, TUN, 네트워크 상태를 기록하세요. 이는 해당 상태에서 시스템 도구로 보낸 조회일 뿐이며 브라우저, 프록시 코어, 대상 서버가 같은 DNS 서버를 사용한다는 뜻은 아닙니다.

Resolve-DnsName -Name example.com -Type A -DnsOnly
Resolve-DnsName -Name example.com -Type AAAA -DnsOnly

도메인이 존재하지 않는다는 응답이 나오면 철자, 네트워크 범위, 현재 네트워크에서 해당 도메인을 조회할 수 있는지 먼저 확인하세요. 조회 시간 초과라면 현재 DNS 서버에 연결할 수 있는지부터 살펴봐야 합니다. DNS 서버가 도메인이 없다고 명확히 응답한 경우와는 다릅니다. 한 종류의 주소 레코드만 반환되는 경우도 정상일 수 있습니다. IPv4와 IPv6 레코드가 모두 반환되더라도 앱에서 시간 초과가 발생한다면 레코드가 있다는 사실만으로 해당 네트워크에 연결할 수 있다고 단정할 수 없습니다. 앱에서 실제로 시도한 주소 유형과 오류 시각을 기록하고 같은 네트워크에서 확인하세요. 첫 단계부터 IPv6를 전역으로 비활성화하지 마세요.

해당 구간을 담당하는 DNS 설정만 변경

데스크톱 클라이언트 설정에서 ‘DNS 설정’을 열고 현재 활성 설정에서 어떤 코어를 사용하는지, 이 페이지의 설정이 해당 코어에 적용되는지 먼저 확인하세요. 설정을 변경하기 전에 기존 값을 보존하세요. 프록시 연결을 시작하기 전에 접속 도메인을 조회해야 하므로 아직 설정되지 않은 동일 연결에 의존할 수 없습니다. 연결이 설정된 뒤의 대상 도메인 조회는 현재 라우팅과 프록시 전송 방식에 따라 달라집니다. DoH를 사용한다면 DNS 서버의 도메인을 먼저 조회할 수 있는지, 연결이 설정되는지, 시스템 시각이 올바른지도 확인하세요. ‘암호화된 DNS 조회 사용’과 ‘모든 DNS 조회를 프록시로 전송’을 같은 의미로 보지 마세요.

특정 도메인 라우팅 규칙에서만 오류가 발생한다면 확인된 도메인 하나로 범위를 좁혀 테스트하세요. 규칙이 일치시키는 이름, 규칙 순서, 아웃바운드를 확인한 뒤 내부 도메인에 영향을 주지 않는지 검증하세요. 관련 설정은 DNS 분할 조회 안내를 참고하세요. 용어가 헷갈린다면 용어집을 확인할 수 있습니다. 수정 후 앱을 다시 열어 새 연결을 설정하세요. 캐시가 의심되면 기기에서 다시 조회할 수 있지만, 시스템 캐시를 지워도 브라우저나 프록시 코어 자체의 캐시까지 삭제된다는 보장은 없습니다.

06 / 트래픽 가로채기와 라우팅

시스템 프록시 미작동

먼저 시스템 설정이 적용됐는지, 다음으로 앱에서 해당 설정을 읽는지 확인하세요. 라우팅 규칙은 이미 클라이언트로 전달된 트래픽에 적용됩니다.

트레이 모드와 시스템에 실제 적용된 값 확인

v2rayN 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭하고 ‘시스템 프록시’를 여세요. ‘시스템 프록시 자동 설정’을 선택한 직후 운영체제의 프록시 설정 페이지에서 실제 적용된 값을 확인하세요. Windows에서는 ‘설정 → 네트워크 및 인터넷 → 프록시’에서 확인할 수 있습니다. macOS에서는 현재 사용 중인 네트워크 서비스의 세부 정보에서 ‘프록시’를 확인하세요. Linux에서는 데스크톱 환경과 앱이 같은 프록시 설정을 읽는지 살펴보세요. 시스템에 표시된 포트가 v2rayN에서 제공하는 현재 로컬 포트와 일치해야 합니다. 포트가 바뀌었는데 시스템에 이전 값이 남아 있다면 해당 모드를 다시 적용하고 새 포트에서 코어가 정상적으로 실행되는지 확인하세요.

‘시스템 프록시 해제’는 이 모드에서 설정한 시스템 프록시를 정리하는 기능이며, 각 앱에 자체적으로 설정된 프록시까지 모두 끄지는 않습니다. ‘시스템 프록시 변경 안 함’은 현재 시스템 설정을 직접 수정하지 않는다는 뜻입니다. 시스템이 직접 연결 상태라는 뜻도 아니며 다른 도구가 남긴 값을 기본값으로 되돌리지도 않습니다. 회사 기기에서 관리 정책이나 자동 설정 스크립트로 프록시를 적용한다면 원래 설정을 기록하고 허용된 범위에서만 테스트하세요. 정책을 바꾸거나 스크립트를 삭제하지 마세요. 시스템 프록시를 바꿔도 계속 이전 값으로 돌아온다면 트레이 메뉴를 반복해서 클릭하지 말고 다른 도구나 관리 정책이 설정을 덮어쓰는지 확인하세요.

시스템 설정을 실제로 읽는 앱 하나로 확인

시스템 프록시를 사용하도록 명확하게 설정된 브라우저를 선택하세요. 완전히 종료했다가 다시 열고 평소 사용하는 대상에 접속하면서 v2rayN에 새 연결이 들어오는지 확인하세요. 메시지 영역에서 연결 로그를 기록하지 않는다면 클라이언트의 로그 옵션을 잠시 켜고 재현한 뒤 원래 수준으로 되돌리세요. 웹 페이지가 열렸다는 사실만으로 직접 연결인지 프록시 연결인지 판단할 수 없습니다. 시스템 값이 제대로 설정되어 있는데도 브라우저에 해당 요청 기록이 없다면 브라우저 확장 기능, 독립 프록시, 관리 정책, 시스템 우회 목록에 대상이 포함되어 있는지 확인하세요.

일부 도구에서만 작동하지 않는다면 자체 네트워크 설정이 있는지 확인하세요. 명령줄 도구는 환경 변수나 실행 인자만 읽을 수 있으며, 일부 데스크톱 앱은 실행할 때 프록시를 읽고 실행 중에는 시스템 설정 변경을 반영하지 않습니다. HTTP 포트와 SOCKS 포트는 임의로 바꿔 쓸 수 없으며 프록시 환경 변수에 원격 서버 주소를 입력해서도 안 됩니다. 앱 안에서 수동 프록시가 작동한다면 로컬 포트는 이미 사용할 수 있다는 뜻인 경우가 많습니다. 구독을 바꾸거나 클라이언트를 다시 설치하기보다 앱이 프록시 설정을 읽는 방식을 확인하세요.

요청이 들어온 뒤 일치한 라우팅 확인

로그에서 앱 요청은 확인되지만 예상과 다른 아웃바운드를 사용한다면 클라이언트의 ‘라우팅 설정’을 열어 현재 활성 구성을 확인하세요. 테스트 요청 하나로 ‘전역’과 현재 분할 라우팅 설정의 아웃바운드 결과를 잠시 비교한 뒤 평소 설정으로 되돌리세요. 특정 대상이 프록시를 거치지 않는다면 직접 연결 규칙의 결과일 수 있습니다. 반대로 프록시를 사용한다고 해서 원격 대상에 접속된다는 보장은 없습니다. 테스트 요청이 보이지 않는다면 클라이언트에 트래픽이 도달하지 않은 것이므로 라우팅 규칙을 바꿔도 소용없습니다.

앱 자체 프록시를 설정할 수 없고 시스템 프록시도 적용되지 않을 때만 TUN 모드와 필요한 권한을 검토하세요. 켜기 전에 현재 시스템 프록시 상태, 네트워크, 테스트 앱을 기록하세요. 어떤 방식이 적용되는지 헷갈리지 않도록 한 번에 하나의 트래픽 가로채기 방식만 테스트하세요. 종료할 때는 테스트에서 사용한 방식으로 가로채기를 먼저 해제한 다음 원래 직접 연결되던 앱을 다시 확인하세요. 꺼진 리스너를 가리키는 프록시 설정이 남아 있다면 시스템 프록시 페이지에서 방금 추가한 항목을 지우거나 기록해 둔 원래 설정으로 복구하세요.

07 / 실행과 복구

클라이언트 충돌

창이 갑자기 닫히는지, 트레이로 최소화되는지, 코어 프로세스가 종료되는지 먼저 구분한 뒤 프로그램, 실행 환경, 설정 중 무엇을 점검할지 결정하세요.

처음 나타난 오류를 기록한 뒤 설치 환경 확인

아이콘을 두 번 클릭해도 창이 나타나지 않는다면 시스템 트레이, 메뉴 막대, 프로세스 목록을 확인하세요. 창을 닫아도 인터페이스만 숨겨졌을 수 있고, 이미 실행 중인 인스턴스가 새 실행 요청을 처리했을 수도 있습니다. 그래픽 인터페이스는 남아 있지만 연결할 수 없다면 코어 프로세스에만 문제가 있을 수 있습니다. 인터페이스와 코어가 모두 사라진 경우에는 시작 후 종료까지 어떤 단계가 있었는지 기록하세요. Windows에서는 같은 시각의 프로그램 오류를 ‘이벤트 뷰어 → Windows 로그 → 응용 프로그램’에서 확인할 수 있습니다. 다른 데스크톱 운영체제에서는 시스템 로그나 클라이언트 로그에서 해당 시각의 오류를 찾으세요. 먼저 관련된 첫 기록을 확인하고 종료 과정에서 연쇄적으로 발생한 오류를 원인으로 착각하지 마세요.

새로 설치한 뒤 첫 실행부터 종료된다면 클라이언트 다운로드 페이지에서 운영체제와 설치 파일을 확인하세요. Windows 데스크톱 버전과 클래식 WPF 버전은 각각 안내에 따라 설치해야 하며 필요한 환경이 완전히 같다고 가정하면 안 됩니다. macOS에서는 실제 칩 아키텍처에 맞는 패키지를 선택하고, Linux에서는 패키지 형식과 시스템 아키텍처를 모두 확인하세요. 필요한 실행 환경이 없다고 시스템에서 명확히 안내하면 현재 설치 방식에 맞는 설명에 따라 의존성을 설치하세요. 출처를 알 수 없는 페이지에서 누락된 라이브러리 파일만 따로 다운로드하지 마세요. 시스템이 실행을 명시적으로 차단한다면 안내와 설치 출처부터 확인하고 전역 보안 설정을 낮춰 해결하려 하지 마세요.

기존 데이터는 보존하고 최소 설정으로 재현

이전까지 정상 작동하다가 업데이트 후 충돌하기 시작했다면 현재 설정과 로그를 본인만 접근할 수 있는 위치에 백업하세요. 설정에 구독 주소와 연결 정보가 포함될 수 있습니다. 설치 폴더와 사용자 설정 폴더는 서로 다를 수 있으므로 설치 폴더만 바꿔도 새 설정을 사용한다는 보장은 없습니다. 플랫폼과 설치 방식에 맞는 설정 위치를 확인하고 클라이언트를 완전히 종료한 뒤, 해당 클라이언트의 폴더임을 확인한 설정 디렉터리를 임시로 옮기되 이전 폴더는 복구할 수 있도록 보존하세요. 재설치하면서 설정, 구독, 로그를 모두 지우지 마세요. 복구가 어려워지고 프로그램 업데이트와 특정 데이터 중 어느 쪽이 원인인지 판단할 수 없습니다.

새 설정으로 실행한 뒤에는 TUN을 켜거나 라우팅 규칙을 복구하지 말고 작동이 확인된 노드 하나만 가져오세요. 인터페이스가 열리고 코어가 실행되면 구독 그룹, 라우팅, DNS 설정을 한 번에 하나씩 복구하고 매번 종료 후 다시 열어 확인하세요. 특정 그룹을 가져오자마자 종료된다면 해당 그룹의 가져오기 동작과 자동 업데이트를 나눠 테스트하세요. 데이터 형식, 특정 항목의 필드, 규칙 파일에 문제가 있을 수 있습니다. 새 설정에서도 계속 종료된다면 구독을 더 바꾸지 말고 실행 환경, 폴더 권한, 그래픽 인터페이스 오류를 먼저 확인하세요.

로그가 지목한 항목만 처리

창은 열려 있는데 코어 프로세스만 종료된다면 로그에 표시된 파일, 포트, 설정 항목을 집중적으로 확인하세요. 포트 충돌이 발생하면 v2rayN의 다른 인스턴스나 다른 정상 프로그램이 사용 중인지 먼저 확인하세요. 더 이상 필요하지 않은 인스턴스임을 확인한 뒤 종료하거나 클라이언트에서 사용 가능한 다른 포트를 선택하고 해당 포트에 의존하는 로컬 앱도 함께 수정하세요. ‘액세스 거부’ 오류라면 현재 사용자가 코어 파일을 읽고 해당 설정 폴더에 쓸 수 있는지 확인하세요. TUN을 켤 때만 실패한다면 먼저 TUN을 끄고 일반 프록시가 작동하는지 확인한 뒤 시스템 안내에 따라 해당 기능에 필요한 권한을 살펴보세요. 클라이언트 전체를 계속 관리자 권한으로 실행해 문제를 피하지 마세요.

문제를 제보할 때는 운영체제, 칩 아키텍처, 다운로드 페이지에 표시된 설치 유형, 실제 사용 버전, 재현에 필요한 최소 단계를 기록하세요. 오류 유형과 발생 시각은 남기되 전체 구독 주소, 계정 정보, 불필요한 기기 경로는 제거하세요. 복구할 때는 테스트로 추가한 프록시 설정을 먼저 지우고 문제가 있는 새 인스턴스를 종료한 뒤 백업에서 원래 설정을 복원하세요. 같은 노드로 다시 연결을 확인하고 클라이언트를 정상 종료한 뒤 시스템에서 직접 연결할 수 있는지도 점검하세요. 창만 복구되고 코어는 여전히 실패한다면 처음 발생한 코어 오류를 기준으로 계속 확인하세요.

08 / Android

Android 집중 점검

먼저 VPN 권한과 충돌 여부를 확인한 다음 앱별 목록, 네트워크 전환, 화면이 잠긴 동안의 백그라운드 상태를 점검하세요.

연결을 눌러도 반응이 없음: VPN 세션 확인

Android에서 v2rayNG의 VPN 모드를 처음 시작하면 시스템에 연결 권한을 요청하는 창이 표시됩니다. 이전에 취소했다면 앱으로 돌아가 연결을 다시 눌러 시스템 안내가 나타나는지 확인하세요. 안내가 다시 표시되지 않는다면 시스템 ‘설정’의 VPN 페이지를 검색으로 찾아 다른 앱이나 업무 프로필이 세션을 사용 중인지 확인하세요. 허용된 범위에서 충돌하는 세션을 끊은 뒤 v2rayNG로 돌아가세요. 회사에서 관리하는 기기의 설정을 임의로 삭제하지 말고 다른 VPN을 사용해도 되는지 관리자에게 문의하세요.

연결 아이콘이 나타나는 것은 시스템에서 VPN 세션을 설정했다는 뜻일 뿐, 노드 핸드셰이크가 성공했거나 모든 앱이 같은 아웃바운드를 이용한다는 뜻은 아닙니다. v2rayNG를 화면에 표시한 상태로 두고 작동이 확인된 설정을 선택한 다음 트래픽 가로채기 대상에 포함된 브라우저에서 새 요청을 보내세요. 계속 실패하면 클라이언트로 돌아와 로그 시각을 비교하고 노드 시간 초과 항목에서 접속 지점과 핸드셰이크를 확인하세요. 클라이언트가 실행되지 않거나 설치 중 아키텍처가 맞지 않는다는 메시지가 표시되면 Android 다운로드 페이지에서 arm64와 범용 설치 파일을 비교하세요. V2Fly 코어를 사용해야 하는 경우에만 설정에 맞춰 v2flyNG를 선택하세요. 클라이언트를 바꿔도 시스템 VPN 권한 문제는 해결되지 않습니다.

일부 앱만 연결되지 않음: 앱별 목록 비교

v2rayNG 설정에서 ‘앱별 프록시’가 활성화되어 있는지 확인하고 앱 목록과 ‘우회 모드’ 상태도 함께 살펴보세요. 앱 목록 제한을 켜면 선택한 앱만 VPN을 사용하거나, 반대로 선택한 앱이 VPN을 우회하도록 설정할 수 있습니다. 목록은 같아도 모드에 따라 결과가 정반대가 됩니다. 기존 설정을 기록한 뒤 테스트 앱 하나만 선택해 비교하고 현재 세션을 중지한 다음 다시 연결하세요. 해당 앱도 완전히 종료했다가 다시 열어 새 연결을 확인하세요. 이미 열려 있는 페이지나 백그라운드에서 진행 중인 다운로드만으로 설정이 적용됐는지 판단하지 마세요.

개인 프로필과 업무 프로필에 설치된 동명의 앱은 서로 다른 앱일 수 있습니다. 이번 설정이 적용되는 앱 인스턴스에서 테스트하는지 확인하세요. 시스템 VPN 페이지에서 ‘항상 켜기 VPN’과 ‘VPN을 사용하지 않는 연결 차단’이 활성화되어 있는지도 살펴보세요. 차단 설정이 켜져 있으면 VPN에 포함되지 않은 앱은 인터넷에 연결되지 않을 수 있습니다. 이때는 노드 문제가 아니라 우회 목록과 시스템 정책의 충돌일 수 있습니다. 허가 없이 시스템 정책을 바꾸지 마세요. 기기를 직접 관리하는 경우에도 원하는 동작을 먼저 정한 뒤 목록을 바꿀지 강제 연결을 유지할지 결정하세요.

화면 잠금 후 끊김, 네트워크 전환 후 끊김, 배터리 소모를 각각 점검

짧게 비교 테스트를 해 보세요. 같은 네트워크와 노드를 사용해 앱을 화면에 표시한 상태에서 정상 작동하는지 확인한 다음 잠시 화면을 잠그고, 잠금 해제 후 VPN과 클라이언트 상태를 살펴본 뒤 새 요청을 보냅니다. 세션이 종료되고 화면을 잠근 뒤마다 같은 문제가 재현된다면 시스템 앱 세부 정보에서 배터리 최적화, 백그라운드 사용 제한, 제조업체의 백그라운드 실행 설정을 확인하세요. 우선 v2rayNG에 대한 제한 하나만 완화하고 같은 테스트를 반복하세요. 백그라운드 실행을 허용하면 배터리 소모가 늘 수 있으므로 복구 여부를 확인한 뒤 필요한 설정만 유지하세요. 자세한 확인 방법은 배터리 최적화 및 백그라운드 문제 해결을 참고하세요.

세션은 유지되는데 Wi-Fi에서 모바일 데이터로 바꿀 때 이전 요청만 시간 초과된다면 새 네트워크 연결이 완료될 때까지 기다린 뒤 새 요청을 보내세요. 새 요청도 실패하면 두 네트워크에서 각각 수동으로 다시 연결하고 같은 대상을 테스트해 새 네트워크의 접속 지점 접근성, DNS 조회, 인증 문제인지 확인하세요. 끊김보다 배터리 소모가 주요 문제라면 시스템 배터리 사용량 페이지에서 같은 시간 구간을 기준으로 화면이 켜져 있을 때와 잠겨 있을 때를 비교하세요. 클라이언트가 반복해서 재연결하거나 구독을 업데이트하는지, 앱이 계속 데이터를 전송하는지도 살펴보세요. VPN 상시 알림만으로 배터리 소모량을 판단할 수는 없습니다.

수정 후 세 가지 상태에서 마무리 확인하세요. 앱을 화면에 띄운 상태, 화면을 잠갔다가 다시 켠 상태, 네트워크를 직접 전환한 상태에서 각각 새 요청을 보내세요. 각 상태에서 VPN 세션 표시 여부, 프록시를 사용하는 앱의 작동 여부, 직접 연결해야 하는 앱이 예상대로 작동하는지 기록하세요. 특정 상태에서만 문제가 남는다면 재현 절차와 같은 시각의 로그를 보존하면 됩니다. 기기의 네트워크 설정을 모두 초기화할 필요는 없습니다.