// TROUBLESHOOTING INDEX
V2Ray 자주 묻는 질문 및 문제 해결
기본 개념, 설치 및 설정, 사용 팁, 문제 해결 순서로 정리했습니다. 문제가 클라이언트 화면, 코어 시작, 로컬 네트워크, 원격 노드 중 어디에서 발생했는지 먼저 판단한 뒤 설정을 하나씩 변경하세요.
// 01 · BASICS
기본 개념
먼저 클라이언트, 코어, 구독, 프록시 모드를 구분하세요. 개념을 명확히 이해하면 설치와 로그 점검을 더 직접적으로 진행할 수 있습니다.
v2rayN, v2rayNG, v2flyNG 중 무엇을 선택해야 하나요?
Windows, macOS, Linux 데스크톱에서는 서버 목록, 구독 그룹, 시스템 프록시, 라우팅과 TUN을 모두 제공하는 v2rayN을 우선 선택하세요. Android에서는 일반적으로 Xray 코어를 사용하는 v2rayNG를 선택하며, V2Fly 코어 생태계가 필요할 때 v2flyNG를 사용합니다. 세 클라이언트의 설정 화면은 서로 다르고, 구독을 가져올 수 있는지는 서버에서 제공하는 프로토콜과 필드에 따라 결정됩니다.
V2Ray, V2Fly, Xray와 그래픽 클라이언트는 어떤 관계인가요?
V2Ray는 일반적으로 Project V에서 발전한 프로토콜 및 도구 생태계를 가리킵니다. V2Fly와 Xray는 연결, 전송, 라우팅, DNS 등 하위 수준 작업을 담당하는 대표적인 코어 계열입니다. v2rayN, v2rayNG, v2flyNG는 설정 저장, 코어 호출, 시스템 프록시 설정 등의 기능을 제공하는 그래픽 클라이언트입니다. 문제를 해결할 때는 화면 설정, 코어 실행, 원격 노드라는 세 가지 층위를 구분해야 합니다.
구독 링크와 개별 공유 링크는 어떻게 다른가요?
구독 링크는 보통 여러 서버 설정을 반환하며, 클라이언트에서 그룹별로 저장하고 주기적으로 업데이트할 수 있습니다. 개별 공유 링크는 하나의 노드만 설명하며 주소, 포트, 식별자, 전송 방식과 보안 매개변수 등이 포함됩니다. 구독을 가져올 때는 구독 관리 메뉴를 사용하고, 개별 링크는 클립보드 가져오기 또는 스캔 메뉴를 사용하세요. 서로 다른 메뉴에 입력하면 목록이 비어 있거나 형식을 인식하지 못한다는 메시지가 표시될 수 있습니다.
시스템 프록시 모드와 TUN 모드는 어떻게 다른가요?
시스템 프록시는 운영체제의 프록시 설정을 통해 프록시를 지원하는 앱의 트래픽을 클라이언트로 전달합니다. 설정이 간단해 브라우저와 시스템 프록시를 따르는 데스크톱 프로그램에 적합합니다. TUN 모드는 가상 네트워크 인터페이스를 만들어 시스템 프록시 설정을 읽지 않는 프로그램까지 더 폭넓게 처리할 수 있지만, 추가 권한이 필요하고 로컬 방화벽, 가상 네트워크 어댑터, DNS 설정의 영향을 더 쉽게 받습니다. 처음에는 시스템 프록시를 먼저 확인한 뒤 필요할 때 TUN을 활성화하세요.
// 02 · INSTALLATION
설치 및 설정
설치 단계에서는 운영체제, 프로세서 아키텍처, 앱 권한과 최초 가져오기 순서를 우선 확인하세요. 앱 실행 문제를 해결하려고 노드를 바꾸지는 마세요.
Windows에서 v2rayN 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?
데스크톱 버전은 최신 크로스 플랫폼 인터페이스를 사용하므로 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다. 클래식 WPF 버전은 Windows용이며 기존 사용 설명서의 메뉴 구성과 더 가깝습니다. 두 버전 모두 구독, 서버 선택, 시스템 프록시 설정을 지원합니다. 이미 안정적으로 사용하는 설정이 있다면 화면이 달라졌다는 이유만으로 옮길 필요는 없습니다. 새로 설치한다면 먼저 데스크톱 버전을 사용하고, 호환성 문제가 있을 때 WPF 버전을 시도해 보세요.
macOS 설치 파일에서 Apple Silicon과 Intel 중 무엇을 선택해야 하나요?
시스템의 ‘이 Mac에 관하여’ 페이지를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩으로 표시되면 Apple Silicon, 즉 arm64 설치 파일을 선택합니다. Intel 프로세서로 표시되면 x64 설치 파일을 선택하세요. 아키텍처를 잘못 선택하면 앱이 실행되지 않거나 별도의 변환 계층이 필요할 수 있습니다. 기기 외관이나 구입 연도보다 설치 전에 칩 종류를 직접 확인하는 것이 정확합니다.
Android 설치 파일에서 arm64와 universal 중 무엇을 선택해야 하나요?
2015년 이후 출시된 대부분의 주요 Android 스마트폰은 arm64를 우선 선택할 수 있으며, 설치 파일도 대체로 더 작습니다. 프로세서 아키텍처를 확인할 수 없거나 기기가 오래되었거나 arm64 설치 중 호환성 오류가 표시되면 universal 범용 버전으로 바꿔 보세요. 범용 버전은 더 많은 아키텍처를 포함하므로 파일 크기가 커지는 경우가 많지만 클라이언트 기능이 추가되는 것은 아닙니다. 시스템에 표시된 ‘64비트’라는 문구만으로 판단하지 말고 실제 설치 결과를 기준으로 삼으세요.
클라이언트 첫 실행이 시스템에 의해 차단되면 어떻게 처리하나요?
먼저 설치 파일이 현재 운영체제와 프로세서 아키텍처에 맞는지 확인한 다음, 시스템 보안 알림에서 차단 원인을 확인하세요. Windows에서는 앱 보호 알림을 확인하고, macOS에서는 개인정보 보호 및 보안 설정에서 이번 실행을 허용할 수 있습니다. Linux에서는 설치 형식, 파일 권한, 누락된 종속성을 점검하세요. 이 단계에서는 코어가 아직 실행되지 않았고 문제가 앱 로딩 과정에서 발생한 것이므로, 노드를 계속 바꾸는 방법으로 실행 차단 문제를 해결하려 하지 마세요.
처음 구독을 가져올 때 올바른 순서는 무엇인가요?
먼저 구독 주소 전체를 복사한 뒤 클라이언트에서 새 구독 그룹을 만들고 주소를 붙여 넣은 다음 구독 업데이트를 실행하세요. 서버 목록이 나타나면 활성 서버를 선택하고 코어를 시작한 뒤 시스템 프록시를 켭니다. 마지막으로 브라우저에서 자주 사용하는 사이트에 접속해 연결을 확인하세요. 구독 이름은 로컬 표시용이므로 업데이트에 영향을 주지 않습니다. 중요한 것은 구독 주소 전체를 유지하는 것이며, 복사할 때 시작 부분, 매개변수 또는 마지막 문자가 빠지지 않도록 하세요.
설치 후 V2Ray 또는 Xray 코어를 별도로 다운로드해야 하나요?
일반적으로는 클라이언트 설치 파일에 포함되어 있거나 클라이언트가 관리하는 코어를 먼저 사용하면 되며, 처음 설치할 때 코어 파일을 따로 추가할 필요가 없습니다. 로그에 코어가 없거나 시작할 수 없거나 버전이 호환되지 않는다는 내용이 명확히 표시될 때만 클라이언트의 코어 설정과 업데이트 메뉴를 확인하세요. 코어를 직접 배치할 경우 운영체제와 프로세서 아키텍처가 일치해야 하며, 클라이언트 설정의 코어 경로와 실제 파일 위치도 동일해야 합니다.
// 03 · OPERATION
사용 팁
일상적인 작업은 구독 업데이트, 활성 서버, 프록시 모드, 라우팅 규칙을 중심으로 진행됩니다. 한 번에 변수 하나만 바꿔야 로그를 비교할 수 있습니다.
구독은 얼마나 자주 업데이트해야 하나요?
업데이트 주기는 구독 제공자의 변경 빈도에 따라 달라집니다. 노드 정보가 오랫동안 안정적이라면 자주 새로 고칠 필요가 없습니다. 설정 변경 알림을 받았거나 현재 노드가 한꺼번에 작동하지 않거나 구독 내용이 변경되었다면 수동으로 한 번 업데이트하세요. 자동 업데이트 간격을 너무 짧게 설정하면 요청 제한에 걸릴 수 있습니다. 업데이트 전에 현재 사용할 수 있는 서버를 남겨 두고, 업데이트 후 그룹과 활성 서버가 교체되었는지 확인하세요.
활성 서버를 선택하고 설정 사용 가능 여부를 판단하려면 어떻게 해야 하나요?
먼저 구독을 업데이트한 다음 서버 목록에서 항목 하나를 활성 서버로 선택하세요. 클라이언트가 제공하는 테스트 결과는 필터링 참고 자료일 뿐이며, 최종적으로는 코어를 시작하고 실제 대상 사이트에 접속해야 합니다. 테스트가 실패하면 로그에서 도메인 확인 실패, 연결 거부, 핸드셰이크 실패 또는 시간 초과 메시지를 먼저 확인하세요. 이름과 순위만으로 판단하거나 프로토콜, 라우팅, DNS, 프록시 모드를 동시에 변경하면 원인을 추적하기 어렵습니다.
전역, 규칙, 직접 연결 모드는 어떻게 사용해야 하나요?
전역 모드는 처리할 수 있는 트래픽을 현재 서버로 보내므로 노드가 작동하는지 임시로 확인할 때 적합합니다. 규칙 모드는 domain, ip, geosite 등의 조건에 따라 프록시 또는 직접 연결을 결정해 일상적인 사용에 적합합니다. 직접 연결 모드는 프록시 경로를 잠시 중단하고 비교 점검할 때 주로 사용합니다. 새 구독을 설정할 때는 먼저 전역 모드로 연결을 확인한 뒤 규칙 모드로 돌아가세요. 전환 후 차이가 생기면 규칙 순서와 마지막 기본 규칙을 확인해야 합니다.
사용자 지정 라우팅 규칙이 적용되지 않는 이유는 무엇인가요?
먼저 규칙 유형과 내용이 일치하는지 확인하세요. 예를 들어 도메인은 domain 조건에, 주소 대역은 ip 조건에 넣고, 사전 정의된 분류는 올바른 geosite 이름을 사용해야 합니다. 대부분의 라우팅은 위에서 아래 순서로 매칭되므로 앞쪽의 포괄적인 규칙이 트래픽을 먼저 가로챌 수 있습니다. 수정 후 클라이언트가 설정을 다시 불러오게 하고, 로그에서 실제 대상 도메인, 확인된 주소와 매칭된 아웃바운드를 확인하세요. 규칙만 바꾸고 코어를 재시작하지 않으면 기존 설정이 계속 사용될 수 있습니다.
시스템 시작 시 실행하고 시작 후 자동으로 연결하려면 어떻게 설정하나요?
시스템 시작 시 실행, 코어 시작, 시스템 프록시 활성화는 서로 다른 동작입니다. 먼저 클라이언트 설정에서 시스템 시작 시 실행을 켜고, 시작할 때 마지막 서버를 불러오는지 확인한 다음, 필요할 경우 시작 후 시스템 프록시 설정을 활성화하세요. 처음 설정한 뒤에는 시스템을 한 번 재시작해 클라이언트 실행 여부, 코어 시작 여부, 시스템 프록시 등록 여부를 확인하는 것이 좋습니다. 트레이 아이콘이 보인다고 해서 프록시 경로가 실제로 작동한다는 뜻은 아닙니다.
// 04 · DIAGNOSIS
문제 해결
재현 가능한 첫 번째 오류부터 시작하세요. 구독 요청, 설정 파싱, 코어 시작, 노드 연결, DNS, 라우팅, 앱 트래픽 처리 순서로 점검합니다.
구독 링크를 가져온 후 서버가 표시되지 않는 이유는 무엇인가요?
먼저 구독 관리 메뉴를 사용했는지 확인하고 수동 업데이트를 한 번 실행하세요. 목록이 여전히 비어 있다면 주소가 완전한지, 불필요한 공백이 포함되지 않았는지, 만료되지 않았는지, 클라이언트 로그에 HTTP 상태나 파싱 오류가 있는지 확인합니다. 브라우저에서 구독 주소가 열린다고 해서 클라이언트가 반드시 파싱할 수 있는 것은 아닙니다. 내용이 클라이언트가 지원하는 구독 형식에도 맞아야 합니다. 서버가 다른 그룹으로 가져와졌거나 필터 조건에 의해 숨겨진 것은 아닌지도 확인하세요.
구독 업데이트가 실패하거나 네트워크 오류가 표시될 때는 어떻게 점검하나요?
먼저 현재 네트워크에서 구독 주소에 접속할 수 있는지 확인한 다음, 클라이언트에 구독 업데이트용 프록시 방식이 설정되어 있는지 점검하세요. 현재 활성 노드가 이미 작동하지 않는 상태에서 프록시를 통해 업데이트하면 의존성 순환이 생길 수 있으므로, 잠시 직접 연결로 업데이트해 보세요. 직접 연결도 불가능하다면 아직 사용할 수 있는 서버를 선택한 뒤 다시 시도해야 합니다. 시스템 시간, 주소 매개변수, 요청 제한, 로그에 표시된 인증서 또는 도메인 확인 관련 메시지도 확인하세요.
노드 테스트가 계속 시간 초과될 때 무엇을 확인해야 하나요?
먼저 같은 구독의 다른 노드로 전환해 특정 노드만 문제인지 전체 설정이 문제인지 확인하세요. 모든 노드가 시간 초과되면 로컬 네트워크, 시스템 시간, 방화벽, DNS, 코어 시작 로그를 점검합니다. 일부 노드만 시간 초과된다면 원격 서버 상태, 포트, 전송 매개변수 또는 네트워크 경로와 관련된 경우가 많습니다. 테스트 도구 자체가 특정 대상 주소를 사용할 수도 있으므로 실제 웹 접속 결과와 연결 로그를 함께 확인해야 합니다.
클라이언트는 연결되었다고 표시되지만 브라우저에서 인터넷이 되지 않으면 어떻게 하나요?
활성 서버, 코어 실행 상태, 시스템 프록시 스위치, 브라우저가 사용하는 프록시 출처를 차례로 확인하세요. 먼저 전역 모드로 비교 테스트를 한 번 진행한 뒤 로그에 DNS 실패, 직접 연결 라우팅, 연결 거부 또는 핸드셰이크 오류가 있는지 확인합니다. 브라우저에 별도의 프록시 확장 프로그램이 설치되어 있으면 시스템 설정을 우회할 수 있으므로 잠시 비활성화하고 다시 시도하세요. 변경 후에는 브라우저를 닫았다가 다시 열어 기존 세션을 재사용하지 않도록 하세요.
시스템 프록시는 켜져 있지만 일부 프로그램에서 적용되지 않을 때는 어떻게 하나요?
일부 프로그램은 운영체제 프록시를 읽지 않거나 특정 프록시 유형만 지원하므로 시스템 프록시를 켜도 직접 연결될 수 있습니다. 먼저 브라우저와 같은 표준 앱이 정상적으로 작동하는지 확인한 다음 대상 프로그램에 별도의 프록시 설정이 있는지 점검하세요. 더 많은 앱을 처리해야 한다면 TUN 모드를 검토할 수 있지만, 먼저 기존 네트워크 설정을 기록해 두세요. 기업 네트워크, 보안 소프트웨어, 다른 프록시 도구가 시스템 프록시를 덮어쓸 수도 있으므로 점검할 때는 제어 지점을 하나만 남기세요.
TUN 모드에서 권한 부족 또는 시작 실패가 표시되면 어떻게 처리하나요?
TUN은 가상 네트워크 인터페이스를 만들거나 관리해야 합니다. 데스크톱 운영체제에서는 클라이언트 안내에 따라 관리자 권한 또는 네트워크 확장 권한을 허용하고, Android에서는 시스템의 VPN 연결 권한을 승인했는지 확인하세요. 그래도 실패하면 다른 가상 네트워크 어댑터, 프록시 도구, 보안 소프트웨어가 관련 기능을 사용 중인지 확인하고, 로그에서 드라이버, 인터페이스 이름, 라우팅 등록 오류를 살펴보세요. 다른 네트워크 도구를 종료한 뒤 클라이언트를 다시 시작하는 편이 노드를 계속 바꾸는 것보다 효과적입니다.
// RELATED DOCUMENTS
설정 단계 계속 보기
구독 가져오기부터 시작하려면 사용 문서를 확인하고, 프록시 모드, 라우팅, TUN과 일상적인 관리 방법을 이해하려면 시스템 튜토리얼로 이동하세요.