v2rayN 사용 가이드 · 문제 색인
v2rayN 자주 묻는 질문
문제가 발생한 단계에서 답을 찾아보세요. 오류와 현재 설정을 기록하고, 한 번에 한 항목만 변경한 뒤 같은 앱으로 다시 테스트하세요.
구독 주소와 단일 노드 공유 링크는 어떻게 다른가요?
구독 주소는 보통 HTTPS로 시작하며, 클라이언트가 구독을 업데이트할 때 해당 주소에서 여러 설정을 가져옵니다. vmess:// 또는 vless://로 시작하는 공유 링크는 대개 노드 하나의 정보만 담고 있습니다. 구독 주소를 받았다면 ‘구독 그룹 설정’을 열고 ‘주소(url)’에 입력한 뒤 구독을 업데이트하세요. 단일 노드 링크는 클립보드에서 가져오면 됩니다. 일반 웹페이지 주소도 HTTPS로 시작할 수 있으므로 접두사만으로 판단하지 마세요. 서비스 관리 페이지 주소가 아니라 구독 링크를 복사했는지 먼저 확인하세요.
클라이언트, 코어, 노드는 각각 무엇인가요?
v2rayN은 설정을 가져오고 노드를 선택하며 옵션을 조정하는 그래픽 클라이언트입니다. Xray, V2Fly 같은 코어는 호환되는 설정을 읽어 연결을 처리하고, 노드는 클라이언트가 접속하려는 원격 서버와 그 연결 정보입니다. 문제를 해결할 때는 원인을 나눠 확인하세요. 창이 열리지 않으면 설치 및 실행 기록을 살펴보고, 창은 열리지만 로그에 코어 시작 실패가 표시되면 코어 설정을 확인하세요. 코어는 정상인데 노드 하나만 실패한다면 해당 노드의 설정과 테스트 결과를 비교하세요.
시스템 프록시, 라우팅 규칙, TUN은 어떻게 다른가요?
‘시스템 프록시 자동 설정’을 사용하면 시스템 프록시 설정을 따르는 앱에서 사용할 프록시가 지정됩니다. 앱 자체의 프록시 설정이 우선 적용되거나 시스템 설정을 아예 따르지 않을 수도 있습니다. 라우팅 규칙은 코어로 들어온 트래픽을 프록시로 보낼지, 직접 연결할지, 차단할지 결정합니다. TUN은 가상 네트워크 인터페이스로 라우팅 대상 트래픽을 처리하지만 모든 연결이 프록시를 거치는 것은 아닙니다. 브라우저만 테스트할 때는 시스템 프록시를 먼저 사용하세요. 앱이 시스템 프록시를 우회하는지 확인하려면 TUN을 별도로 테스트하면 됩니다.
데스크톱과 Android에서는 어떤 클라이언트를 사용해야 하나요?
Windows, macOS, Linux에서는 v2rayN을 사용하세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어가 필요할 때는 v2flyNG를 선택하세요. 먼저 기기에 맞는 클라이언트를 고른 다음 설정에서 요구하는 프로토콜과 전송 방식을 확인하세요. 이름이 비슷하다고 설정이 서로 호환되는 것은 아닙니다. 클라이언트를 바꿀 예정이라면 기존 설정을 보존하고, 정상 작동이 확인된 설정 하나만 가져와 연결을 테스트하세요. 시작, 접속, 연결 해제가 모두 정상인지 확인한 뒤 구독 전체를 옮기세요.
Android 설치 파일은 arm64와 universal 중 무엇을 선택해야 하나요?
기기가 arm64-v8a 앱 실행을 지원한다고 확실히 알고 있다면 arm64를 선택하세요. 시스템에서 지원하는 ABI를 모른다면 여러 아키텍처를 포함한 universal을 선택할 수 있지만, 설치 파일 크기가 더 클 수 있습니다. 프로세서가 64비트라고 해서 기기의 시스템도 64비트 앱을 설치할 수 있는 것은 아닙니다. 설치 오류가 나면 먼저 안내 문구를 확인하세요. 아키텍처가 맞지 않는다는 메시지가 표시되면 universal 패키지를 다시 시도하고, 서명 충돌이나 시스템 버전 미지원 오류라면 아키텍처를 바꿔도 해결되지 않을 수 있습니다.
구독을 추가할 때 가져오기 실패가 표시되면 어디부터 확인해야 하나요?
먼저 올바른 가져오기 경로를 사용했는지 확인하세요. 구독 주소는 단일 노드용 클립보드 가져오기를 사용하지 않습니다. ‘구독 그룹 설정’을 열고 ‘메모’와 ‘주소(url)’를 입력한 뒤 저장하고 구독을 업데이트하세요. 저장 단계에서 오류가 나면 주소에 따옴표, 줄바꿈, 설명 문구가 섞이지 않았는지 확인하고 물음표 뒤의 쿼리 매개변수까지 모두 복사했는지 살펴보세요. 업데이트는 성공했는데 목록이 비어 있다면 해당 구독 그룹으로 돌아가 ‘필터’가 모든 항목을 제외하지 않았는지 확인한 다음, 구독 내용에 클라이언트가 인식할 수 있는 설정이 포함되어 있는지 점검하세요.
TUN을 켤 때 권한 부족 오류가 표시되면 어떻게 해야 하나요?
먼저 가상 네트워크 어댑터 생성, 라우팅 변경, 코어 시작 중 어느 단계에서 실패했는지 확인하세요. Windows 로그에 권한 부족이 명확히 표시되면 클라이언트를 종료한 뒤 기존 v2rayN 프로그램을 ‘관리자 권한으로 실행’해 결과를 비교해 보세요. macOS와 Linux의 권한 부여 방법은 설치 파일과 버전에 따라 다르므로 클라이언트 안내를 따르고 시스템 권한을 전반적으로 완화하지 마세요. Android에서는 시스템 VPN 권한을 사용합니다. 이미 다른 VPN이 실행 중이라면 연결을 끊고 클라이언트로 돌아와 연결을 시작한 뒤 권한을 허용하세요.
Windows에서 압축을 푼 뒤 v2rayN을 실행해도 아무 반응이 없으면 어떻게 해야 하나요?
압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요. 압축 파일 전체를 현재 계정에서 쓸 수 있는 폴더에 푼 다음 해당 폴더에서 실행하세요. 이미 실행했다면 알림 영역에 아이콘이 있는지 먼저 확인하세요. 팝업에 런타임 구성 요소가 없다고 표시되면 구성 요소 이름, 버전, 아키텍처를 기록하고 선택한 배포 패키지의 요구 사항에 맞춰 설치하세요. 팝업이 없다면 Windows ‘이벤트 뷰어’의 ‘응용 프로그램’ 로그에서 실행 시각을 기준으로 관련 오류를 찾으세요. 기존 설정을 먼저 덮어쓰지 마세요.
노드를 바꾼 뒤 새 노드가 실제로 사용되는지 어떻게 확인하나요?
v2rayN 노드 목록에서 새 노드를 선택하고 ‘활성 서버로 설정’을 실행하세요. 행이 강조 표시된 것만으로는 노드가 바뀐 것이 아닙니다. 현재 활성 항목이 변경됐는지 확인한 뒤 새 연결을 시작하세요. 브라우저가 기존 연결을 재사용할 수 있으므로 테스트할 때 브라우저를 완전히 종료했다가 다시 열고, 평소 접속 가능한 동일한 페이지를 확인하세요. 메인 화면에 새 노드가 표시되는데도 접속에 문제가 있다면 전환 후 로그를 확인하고 활성 설정이 시작될 때 처음 발생한 오류를 찾으세요. 마지막 줄만 확인하지 마세요.
문제가 라우팅 규칙 때문인지 노드 때문인지 어떻게 구분하나요?
노드와 프록시 진입점은 그대로 두고 현재 라우팅 프리셋을 기록하세요. 같은 앱으로 정상 대상과 문제가 있는 대상을 각각 접속한 다음, 임시로 ‘전역’으로 바꿔 문제가 있는 대상을 테스트하세요. 기존 프리셋에서만 실패한다면 규칙 적용 여부와 순서, DNS 확인을 우선 점검하세요. 두 프리셋에서 결과가 같다면 앱 트래픽이 프록시로 들어가는지와 노드 연결 여부를 확인하세요. 테스트가 끝나면 원래 프리셋으로 되돌리고 노드, 라우팅, DNS를 한 번에 모두 변경하지 마세요.
‘시스템 프록시 변경 안 함’을 선택하면 기존 설정이 삭제되나요?
아니요. 이 옵션은 현재 시스템 프록시를 적극적으로 수정하지 않는다는 뜻이며, 직접 연결이나 ‘시스템 프록시 지우기’와는 다릅니다. 기존에 로컬 주소를 가리키는 시스템 프록시가 설정되어 있었다면 ‘시스템 프록시 변경 안 함’으로 바꾼 뒤에도 그대로 남아 있을 수 있습니다. v2rayN이 설정한 값을 취소하려면 ‘시스템 프록시 지우기’를 사용한 뒤 시스템 네트워크 설정에서 결과를 확인하세요. 조직에서 관리하는 기기에 기존 프록시 설정이 있다면 테스트 전에 원래 값을 기록하고 바로 덮어쓰지 마세요.
구독을 업데이트하기 전에 직접 수정한 노드를 보존하려면 어떻게 해야 하나요?
구독 그룹에 포함된 항목은 업데이트할 때 다시 생성될 수 있으므로 특정 설정을 직접 수정해 계속 보존하는 방법은 적합하지 않습니다. 남길 항목을 구독 주소에 연결되지 않은 그룹으로 별도 설정으로 가져온 뒤 복사본을 수정하세요. 이후 원래 구독 그룹만 업데이트하고 복사본이 남아 있는지, 기존 활성 노드가 계속 작동하는지 확인하세요. 공유 링크로 항목을 옮길 때는 연결 인증 정보가 포함될 수 있습니다. 링크를 공개 채팅방에 올리거나 도움을 요청하는 스크린샷에 전체 구독 주소를 노출하지 마세요.
노드 속도 테스트가 계속 시간 초과될 때 원인을 어떻게 좁히나요?
먼저 노드 하나만 테스트하고 연결 테스트인지 실제 연결 테스트인지 기록하세요. 포트 연결에 성공해도 이후 프로토콜 핸드셰이크까지 성공한다는 뜻은 아닙니다. 같은 네트워크와 같은 테스트 방식으로 정상 작동이 확인된 다른 노드도 테스트해 보세요. 하나만 실패하면 서버 주소, 포트, 전송 설정을 확인하고 핸드셰이크 오류가 있는지 살펴보세요. 모두 시간 초과라면 코어가 실행 중인지 확인한 뒤 로그에서 가장 먼저 발생한 DNS 확인, 연결, 인증 오류를 찾으세요. 속도 테스트 대상에 접속할 수 없어 결과가 잘못 표시될 수도 있습니다.
클라이언트는 연결됨으로 표시되는데 웹페이지가 열리지 않는 이유는 무엇인가요?
연결됨으로 표시된다고 해서 대상 웹페이지까지 연결된 것은 아닙니다. 먼저 기존 브라우저에서 평소 직접 접속할 수 있는 페이지를 연 다음, 열리지 않는 페이지와 비교하세요. 두 종류의 페이지가 모두 실패하면 직접 연결이 허용되는 네트워크에서 시스템 프록시를 잠시 지우거나 TUN을 끄고 한 번만 비교 테스트하세요. 직접 연결도 실패한다면 먼저 로컬 네트워크를 확인하세요. 프록시를 켰을 때만 실패한다면 활성 노드와 로그를 살펴보세요. 주소 확인 실패는 DNS를, 연결 거부는 로컬 프록시 포트를, 핸드셰이크 실패는 원격 설정을 확인하세요.
‘시스템 프록시 자동 설정’을 선택했는데 앱이 프록시를 사용하지 않는 이유는 무엇인가요?
먼저 시스템 네트워크 설정에서 프록시가 켜져 있는지 확인하고, 주소와 포트가 v2rayN의 로컬 수신 설정과 일치하는지 확인하세요. 시스템 프록시를 따르는 브라우저에서 새 요청을 보내고 클라이언트에 해당 연결 기록이 나타나는지도 살펴보세요. 브라우저는 프록시를 사용하지만 대상 앱은 그렇지 않다면 앱에 자체 프록시 설정이 있는지, 시스템 프록시를 사용하지 않도록 설정되어 있는지 확인하세요. 브라우저도 프록시를 사용하지 못한다면 코어 실행 상태와 포트 사용 여부를 확인하세요. 트래픽이 코어에 들어온 뒤 직접 연결되는 것으로 로그에 표시되면 라우팅 규칙을 점검하세요.
구독이 전에는 업데이트됐는데 이제 실패하면 어떻게 해야 하나요?
기존 그룹과 노드를 유지한 채 업데이트 로그부터 확인하세요. 삭제한 뒤 다시 만들지 마세요. 401 또는 403 응답이 오면 구독이 아직 유효한지, 주소가 변경되지 않았는지 확인하세요. 성공 응답인데 파싱에 실패한다면 응답이 로그인 페이지나 오류 페이지인지 살펴보세요. 시간 초과가 표시되면 허용되는 네트워크 환경에서 업데이트 경로 두 가지를 비교하세요. 현재 노드가 작동하면 ‘프록시를 통해’ 업데이트하고, 노드 자체를 사용할 수 없으면 ‘프록시를 사용하지 않고’ 업데이트하세요. 문제가 있는 그룹 하나만 업데이트해야 결과를 비교하기 쉽습니다.