설치 및 연결 문제 해결
v2rayN 자주 묻는 질문
문제가 발생한 단계를 먼저 구분하세요. 설치 파일이 열리지 않는지, 구독을 가져오지 못하는지, 앱 요청이 프록시로 전달되지 않는지 확인한 뒤 현재 증상에 맞는 항목을 선택하세요. 문제를 확인할 때는 한 번에 한 가지씩만 변경하세요.
기본 개념
클라이언트, 코어, 설정의 역할을 구분하세요. 각 단계의 기능을 알면 어디에서 설정을 찾아야 할지 판단하기 쉽습니다.
v2rayN, V2Ray, Xray는 어떻게 다른가요?
v2rayN은 설정을 관리하고 코어를 실행하며 로컬 프록시를 설정하는 데스크톱 GUI 클라이언트입니다. V2Ray는 Project V 생태계의 프록시 소프트웨어이며, V2Fly 커뮤니티가 관련 구현을 계속 관리합니다. Xray는 별도로 개발되는 코어 프로젝트입니다. GUI를 바꾸는 것과 코어를 바꾸는 것은 서로 다른 작업입니다. 설정을 가져오기 전에 현재 코어가 해당 프로토콜, 전송 방식, 보안 옵션을 지원하는지 확인하세요.
구독 URL과 단일 노드 링크는 어떻게 다른가요?
구독 URL은 주기적으로 가져올 수 있는 설정 내용을 가리키며, 한 번 업데이트하면 전체 항목을 새로 고칠 수 있습니다. 단일 노드 링크는 하나의 연결 설정을 담으며, 가져온 뒤 구독 업데이트에 따라 변경되지 않는 경우가 많습니다. 먼저 제공받은 것이 어느 유형인지 확인한 다음 구독 그룹에 추가하거나 단일 항목으로 가져오세요. 둘 다 접속 인증 정보가 포함될 수 있으므로 공개 스크린샷, 문의 제목, 온라인 변환 사이트에 올리지 마세요.
시스템 프록시와 TUN 모드는 어떻게 다른가요?
시스템 프록시는 시스템 설정을 따르는 앱에 로컬 프록시를 제공하지만, 자체 네트워크 설정을 사용하는 앱은 이를 따르지 않을 수 있습니다. TUN은 가상 인터페이스를 통해 라우팅된 트래픽을 받아들이며, 적용 범위는 시스템 라우팅, 제외 규칙, 권한에 따라 달라집니다. 문제를 진단할 때는 한 가지 방식만 선택해 앱 하나가 접속되는지 확인한 뒤 적용 범위를 넓힐지 결정하세요.
클라이언트를 설치했는데 사용할 수 있는 노드가 없는 이유는 무엇인가요?
클라이언트는 연결 설정을 실행하는 프로그램이지 원격 연결을 제공하는 서비스가 아닙니다. 처음 실행했을 때 목록이 비어 있는 것은 정상입니다. 사용 권한이 있는 구독이나 단일 설정을 받은 뒤 가져와 항목을 선택하고 코어가 실행되는지 확인하세요. 가져온 후에도 항목이 보이지 않는다면 현재 그룹과 검색 필터를 먼저 확인하세요. 같은 내용을 반복해서 가져올 필요는 없습니다.
설치 및 설정
운영 체제와 아키텍처에 맞는 설치 파일을 선택하세요. 클라이언트를 실행한 뒤 구독을 불러올 수 있는지, 가상 인터페이스를 만들 수 있는지 각각 확인하세요.
Windows에서 v2rayN 데스크톱 버전과 WPF 버전 중 무엇을 선택해야 하나요?
데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 Windows 인터페이스를 유지합니다. 먼저 시스템 아키텍처와 릴리스 안내의 실행 요구 사항을 확인한 뒤 익숙한 인터페이스를 선택하세요. 기존 설정이 있다면 전환 전에 클라이언트 데이터를 백업하세요. 다른 버전을 시험하기 전에는 기존 클라이언트를 종료해 두 프로세스가 시스템 프록시를 동시에 변경하거나 같은 로컬 포트를 두고 충돌하지 않도록 하세요.
Android 설치 파일은 arm64와 universal 중 무엇을 선택해야 하나요?
기기 시스템이 arm64-v8a를 지원한다면 arm64 패키지를 우선 선택하세요. 앱 아키텍처 지원 여부를 모르겠다면 기기 사양을 확인하거나 여러 아키텍처를 지원하는 universal 패키지를 선택할 수 있습니다. 프로세서가 64비트를 지원해도 시스템에서 64비트 앱을 실행할 수 있다는 뜻은 아닙니다. universal 패키지도 설치되지 않는다면 Android 버전 요구 사항과 기존 앱과의 서명 충돌 여부를 확인하세요.
구독을 가져오지 못하거나 가져온 뒤 항목이 없으면 어떻게 해야 하나요?
복사한 구독 URL이 완전한지, 줄바꿈이나 불필요한 공백이 없는지, 계정 로그인 페이지 주소가 아닌지 먼저 확인하세요. 구독 그룹에 저장한 뒤 해당 그룹을 직접 업데이트하고 로그를 확인하세요. 로그인 페이지나 오류 안내 페이지를 받아 온 경우 요청 자체는 성공해도 노드로 변환할 수 없습니다. 지원되지 않는 형식이라는 로그가 표시되면 설정 제공자에게 현재 클라이언트와 호환되는 구독 형식을 제공할 수 있는지 문의하세요.
TUN을 켤 때 권한 부족 오류가 표시되면 어떻게 해야 하나요?
로그에서 가상 인터페이스를 생성할 때와 라우팅을 설정할 때 중 어느 단계에서 오류가 발생했는지 먼저 확인하세요. Windows에서는 클라이언트를 종료한 뒤 릴리스 안내에 따라 관리자 권한으로 실행해 볼 수 있습니다. macOS와 Linux에서는 해당 버전 문서를 참고해 가상 인터페이스, 보조 프로세스, 권한 요구 사항을 확인하세요. 조직에서 관리하는 기기라면 관련 권한이 허용되는지 확인하고, 실행 오류를 해결하려고 시스템 보호 기능을 끄지 마세요.
사용 팁
테스트 결과를 실제 요청과 대조하세요. 포트 접속 가능 여부, 요청의 코어 도달 여부, 규칙에 따른 예상 아웃바운드 선택 여부는 서로 다른 확인 단계입니다.
앱이 실제로 프록시를 사용하는지 어떻게 확인하나요?
테스트할 앱 하나에서 새 요청을 보내고 클라이언트 로그에 해당 대상과 아웃바운드 기록이 나타나는지 확인하세요. 기록이 없다면 앱이 자체 프록시 설정을 사용하는지, 이전에 연결한 세션을 계속 재사용하는지 살펴보세요. 로그에 기록이 있다는 것은 요청이 코어에 도달했다는 뜻일 뿐입니다. 실제로 매칭된 아웃바운드가 프록시인지 직접 연결인지도 확인해야 합니다.
포트 테스트는 성공했는데 실제 연결 테스트는 왜 실패하나요?
Tcping 성공은 보통 테스트 시점에 대상 TCP 포트에 연결할 수 있었다는 뜻일 뿐, 프로토콜 핸드셰이크나 인증, 테스트 URL 접속 여부까지 확인하지는 않습니다. 실제 연결에 실패한다면 같은 테스트 URL로 정상 작동이 확인된 항목과 비교한 뒤, 로그에서 핸드셰이크 오류인지 테스트 대상 접속 시간 초과인지 확인하세요. 포트 테스트 결과만으로 노드 사용 가능 여부를 판단하지 마세요.
라우팅 규칙을 추가했는데도 이전 규칙이 적용되는 이유는 무엇인가요?
현재 활성화된 라우팅 설정을 수정했는지 확인하고, 저장한 뒤 설정을 다시 불러온 다음 새 연결을 시도하세요. 규칙은 보통 순서대로 적용되므로 앞쪽의 포괄적인 규칙이 먼저 매칭되면 뒤쪽 예외 규칙은 적용되지 않을 수 있습니다. 대상이 도메인으로 코어에 전달되는지 IP로 전달되는지 확인하고, 도메인 확인 정책에 맞는 매칭 조건을 선택하세요.
클라이언트를 업데이트하기 전에 무엇을 백업해야 하나요?
현재 버전과 사용 중인 코어를 기록하고 클라이언트를 종료한 뒤, 해당 버전 안내에 따라 데이터 디렉터리를 백업하세요. 사용자 지정 라우팅, 구독 그룹, 수동 설정을 중점적으로 보관하세요. 설치 디렉터리가 데이터 디렉터리와 같다고 단정하지 마세요. 백업에는 인증 정보가 포함될 수 있으므로 안전하게 관리되는 위치에 보관하세요. 업데이트 후 정상 작동이 확인된 항목 하나를 먼저 테스트한 다음 사용자 지정 설정을 하나씩 복원하세요.
문제 해결
먼저 문제가 영향을 미치는 범위를 확인하세요. 앱 하나만 열리지 않는지, 설정 하나만 시간 초과되는지, 구독 요청 자체가 실패하는지 살펴보세요. 처음 발생한 오류를 기록한 뒤 확인할 단계를 정하세요.
노드가 갑자기 시간 초과되면 무엇부터 확인해야 하나요?
현재 네트워크에서 자주 사용하는 사이트에 정상적으로 접속되는지 확인한 뒤, 같은 테스트 방식으로 정상 작동이 확인된 다른 항목과 비교하세요. 항목 하나만 실패한다면 로그에서 도메인 확인 실패, 연결 시간 초과, 핸드셰이크 실패 중 어떤 오류인지 살펴보고 서버 주소, 포트, 현재 설정을 확인하세요. 모든 항목이 실패한다면 코어가 실행 중인지, 로컬 포트가 정상적으로 수신 대기 중인지 먼저 확인하세요.
클라이언트에는 연결됨으로 표시되는데 인터넷에 접속할 수 없는 이유는 무엇인가요?
항목을 실행했거나 선택했다는 사실만으로 앱 요청이 정상적으로 전달되는 것은 아닙니다. 중복으로 활성화된 프록시 연결 방식을 끄고 하나만 남긴 뒤, 브라우저에서 새 요청을 보내 로그와 대조하세요. 요청 기록이 없다면 앱 연결 설정과 로컬 포트를 확인하세요. 기록이 있다면 라우팅 매칭, DNS, 아웃바운드 오류를 확인하세요. 클라이언트를 종료한 뒤에도 접속할 수 없다면 시스템이 더 이상 수신 대기하지 않는 프록시 포트를 계속 가리키는지 확인하세요.
시스템 프록시를 켰는데 특정 앱에서 적용되지 않는 이유는 무엇인가요?
먼저 시스템 프록시를 따르는 브라우저로 비교해 보세요. 브라우저는 정상인데 대상 앱의 요청 기록이 없다면 자체 프록시 설정이나 우회 목록이 있는지, 다른 도구가 네트워크 설정을 관리하는지 확인하세요. 프록시를 직접 입력할 때는 프로토콜과 포트가 클라이언트의 실제 인바운드 설정과 일치해야 합니다. 앱이 프록시 설정을 캐시한다면 설정을 변경한 뒤 앱을 완전히 종료하고 다시 실행하세요.
구독이 전에는 작동했는데 업데이트에 실패하면 어떻게 해야 하나요?
기존 그룹을 그대로 둔 채 한 번 직접 업데이트하고 오류를 확인하세요. 401 또는 403 오류라면 구독 권한이나 주소가 변경되었는지 먼저 살펴보세요. 연결 시간 초과라면 클라이언트가 구독 요청을 보낼 때 사용한 네트워크 경로를 확인하세요. 업데이트에 프록시가 필요하지만 현재 항목을 사용할 수 없다면, 먼저 정상 연결을 복구하거나 구독 제공자가 허용하고 직접 접속할 수 있는 경우 직접 연결로 업데이트하세요.