FAQ / CONFIGURATION REFERENCE

V2Ray 자주 묻는 질문 및 클라이언트 문제 해결

v2rayN, v2rayNG, v2flyNG의 설치·구독·노드 선택·시스템 프록시·TUN 모드를 중심으로 정리했습니다. 먼저 문제가 발생한 단계를 파악한 뒤 클라이언트 상태, 설정 필드, 시스템 네트워크 설정을 차례로 확인하세요.

v2rayN v2rayNG v2flyNG 설정 참고
01 / CLIENT 클라이언트와 플랫폼 확인

먼저 데스크톱과 Android 클라이언트를 구분한 다음 설치 패키지 아키텍처와 클라이언트 버전을 확인하세요.

02 / CONFIG 구독 및 노드 필드 확인

구독이 업데이트되었고 활성 노드가 선택되었는지, 프로토콜과 전송 매개변수가 누락되지 않았는지 확인하세요.

03 / ROUTE 프록시 인계 범위 확인

앱 특성에 따라 시스템 프록시, TUN, DNS 및 라우팅 모드를 확인하세요.

01 / BASICS

기본 이해

클라이언트, 코어, 프로토콜, 구독이 각각 어떤 역할을 맡는지 먼저 파악하세요. 이름이 비슷하다고 기능 계층까지 같은 것은 아닙니다. 문제를 점검할 때는 설정 관리, 프록시 인계, 실제 연결 중 어느 단계에서 장애가 발생했는지 먼저 확인해야 합니다.

V2Ray, v2rayN, v2rayNG는 각각 무엇인가요?

V2Ray는 일반적으로 Project V와 관련된 프로토콜, 코어 및 도구 생태계를 가리킵니다. v2rayN은 Windows, macOS, Linux용 데스크톱 그래픽 클라이언트로 Xray 또는 V2Fly 코어를 호출할 수 있으며, v2rayNG는 Android용 그래픽 클라이언트로 주로 Xray 코어를 사용합니다. 클라이언트는 구독, 노드 및 시스템 프록시 설정을 담당하고, 코어는 실제 연결과 라우팅을 처리합니다.

처음 사용할 때 어떤 클라이언트를 선택해야 하나요?

Windows, macOS, Linux 데스크톱 환경에서는 보통 v2rayN을 선택합니다. Android에서는 보통 v2rayNG를 사용합니다. Android 설정이 V2Fly 코어에 명시적으로 의존한다면 v2flyNG를 사용할 수도 있습니다. 클라이언트는 설정 진입점일 뿐이며, 정상 연결 여부는 노드 프로토콜, 주소, 포트, 전송 매개변수와 구독 상태가 완전한지에 따라서도 달라집니다.

VMess, VLESS, Trojan, Shadowsocks를 함께 가져올 수 있나요?

가능합니다. 하나의 노드 목록에 여러 프로토콜을 포함할 수 있지만, 각 노드는 프로토콜 필드를 별도로 저장합니다. 가져온 후 프로토콜 유형, 전송 방식, TLS 또는 REALITY 매개변수가 올바르게 인식되었는지 확인하세요. 구독에 클라이언트가 인식하지 못하는 새 필드가 있다면 클라이언트와 코어를 업데이트한 뒤 다시 가져오는 편이 안전합니다.

구독 링크와 개별 노드 링크는 어떻게 다른가요?

구독 링크에는 보통 여러 노드가 포함되며, 서버에서 노드 이름·주소·설정을 일괄 조정할 수 있습니다. 개별 노드 링크는 하나의 연결만 설명합니다. 구독은 장기 관리와 일괄 업데이트에 적합하고, 개별 노드 링크는 임시 가져오기나 특정 노드 테스트에 적합합니다. 구독을 가져온 뒤에도 한 번 업데이트해야 노드 목록이 클라이언트에 기록됩니다.

클라이언트에 연결됨으로 표시되면 모든 프로그램이 프록시를 사용하나요?

반드시 그렇지는 않습니다. 연결됨 표시는 보통 코어가 실행되고 현재 노드가 로드되었다는 뜻입니다. 앱 트래픽이 프록시를 통과하는지는 시스템 프록시, TUN 모드, 앱 자체 프록시 설정 및 라우팅 규칙에 따라 달라집니다. 브라우저는 먼저 시스템 프록시로 확인할 수 있으며, 시스템 프록시를 따르지 않는 프로그램은 앱 프록시를 설정하거나 필요에 따라 TUN 모드를 활성화해야 합니다.

02 / INSTALLATION

설치 및 설정

설치 단계에서는 플랫폼, 프로세서 아키텍처, 가져오기 방식을 중점적으로 확인해야 합니다. 노드가 표시되지 않는다고 곧바로 라우팅 모드를 바꾸지 말고, 먼저 링크 유형, 구독 업데이트 결과, 현재 목록의 그룹 필터 상태를 확인하세요.

v2rayN에 구독 링크를 어떻게 가져오나요?

v2rayN의 구독 그룹 설정에서 새 구독을 추가하고, 식별하기 쉬운 메모와 전체 구독 주소를 입력한 다음 모든 구독 업데이트를 실행하세요. 업데이트가 끝나면 서버 목록에서 노드를 선택해 활성 서버로 지정합니다. 목록이 계속 비어 있다면 구독이 활성화되었는지, 그룹 필터가 노드를 숨기고 있지 않은지, 주소 앞뒤에 공백이 섞이지 않았는지 먼저 확인하세요.

v2rayNG에서 QR 코드를 스캔했는데 노드가 나타나지 않으면 어떻게 하나요?

먼저 QR 코드 내용이 일반 웹 주소가 아니라 노드 링크 또는 클라이언트가 인식할 수 있는 구독 내용인지 확인하세요. 카메라 권한을 허용한 뒤 다시 스캔하거나, 원본 링크를 복사해 클립보드에서 가져올 수도 있습니다. 가져온 후 오른쪽 위의 구성 목록을 확인하세요. 형식 오류가 표시되면 보통 설정 제공자에게 전체 링크를 다시 생성해 달라고 요청해야 합니다.

Android 설치 패키지의 arm64와 universal 중 무엇을 선택해야 하나요?

2015년 이후 출시된 주요 Android 스마트폰은 보통 64비트 ARM 프로세서를 사용하므로 파일이 더 작은 arm64 설치 패키지를 우선 선택할 수 있습니다. 프로세서 아키텍처를 확인할 수 없거나 기기가 오래되었거나 arm64 패키지가 호환되지 않는다고 표시될 때는 universal 범용 버전을 선택하세요. 두 패키지의 주요 기능은 같으며, 포함하는 프로세서 아키텍처 범위가 다릅니다.

v2rayN 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?

데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하므로 여러 데스크톱 시스템에서 비슷한 방식으로 사용하려는 사용자에게 적합합니다. 클래식 WPF 버전은 주로 Windows용이며 기존 사용 방식과 인터페이스가 더 가깝습니다. 처음 설치한다면 데스크톱 버전을 먼저 선택하고, 안정적인 설정과 익숙한 작업 흐름을 유지 중인 Windows 사용자는 WPF 버전을 계속 사용해도 됩니다.

v2rayN TUN 모드를 켤 때 관리자 권한이 필요한 이유는 무엇인가요?

TUN 모드는 가상 네트워크 인터페이스를 만들고 시스템 라우팅을 조정해야 하므로 시스템 수준의 네트워크 설정에 해당하며, 일반적으로 관리자 권한이 필요합니다. 시작에 실패하면 클라이언트를 종료한 뒤 관리자 권한으로 다시 실행하고, 시스템에 같은 종류의 가상 인터페이스가 남아 있는지 확인하세요. 기업용 기기는 보안 정책의 제한을 받을 수 있으므로 장치 관리자가 권한 범위를 확인해야 합니다.

03 / OPERATION

사용 팁

클라이언트를 실행한 뒤에는 트래픽이 코어로 유입되는 방식을 정해야 합니다. 시스템 프록시는 일반적인 브라우저와 시스템 설정을 따르는 앱에 적합하고, TUN은 인계 범위를 넓혀야 하는 상황에 더 적합하므로 실제 필요에 따라 선택하세요.

전역·규칙·직접 연결 모드는 어떻게 선택해야 하나요?

규칙 모드는 도메인, 주소 또는 규칙 집합에 따라 트래픽 경로를 결정하므로 일상적인 사용에 적합합니다. 전역 모드는 인계 범위에 해당하는 연결을 현재 노드를 통해 통과시키며, 분기 문제를 짧게 확인할 때 유용합니다. 직접 연결 모드는 노드를 우회하므로 문제가 프록시 경로와 관련 있는지 확인할 수 있습니다. 전환하기 전에 기존 모드를 기록하고 테스트가 끝나면 복원하세요.

시스템 프록시와 TUN 모드는 어떻게 다른가요?

시스템 프록시는 운영체제의 프록시 설정을 통해 앱에 HTTP 또는 SOCKS 진입점을 제공하는 방식으로, 설정은 간단하지만 시스템 프록시를 따르는 프로그램만 사용합니다. TUN 모드는 가상 네트워크 인터페이스로 더 넓은 범위의 트래픽을 인계하므로 시스템 프록시를 읽지 않는 프로그램에 더 효과적이며, 라우팅·DNS·권한 설정도 함께 다룹니다. 문제를 확인할 때는 먼저 시스템 프록시를 검증한 뒤 필요에 따라 TUN을 활성화하세요.

어떤 노드를 선택해야 할지 어떻게 판단하나요?

먼저 연결 테스트에 실패하거나 자주 시간 초과되는 노드를 제외한 다음, 출구 지역·프로토콜 호환성·실제 접속 성능을 종합해 선택하세요. Ping은 네트워크 경로 일부만 보여 주고, 실제 연결 지연은 프록시 연결 수립에 걸리는 시간에 더 가깝습니다. 다운로드 속도 측정에는 대역폭과 서버 부하도 포함됩니다. 일상적인 선별에서는 하나의 숫자만 보지 말고 대상 앱의 실제 연결 결과를 기준으로 판단하세요.

구독을 업데이트하면 수동으로 수정한 노드가 덮어써지나요?

구독 그룹의 노드는 보통 서버가 반환한 내용을 기준으로 하며, 다시 업데이트할 때 같은 이름의 노드가 교체되거나 해당 그룹이 재생성될 수 있습니다. 장기간 보관할 수동 설정은 별도 그룹으로 복사하고 이름을 바꾸어 구독 노드와 섞이지 않게 하세요. 라우팅 규칙과 클라이언트 공통 설정은 보통 별도로 저장되지만, 업데이트 전에 현재 그룹을 다시 확인하는 것이 좋습니다.

하나의 구독을 컴퓨터와 Android 기기에서 함께 사용할 수 있나요?

대부분의 표준 구독은 v2rayN과 v2rayNG에 각각 가져올 수 있지만, 최종 호환성은 구독에 포함된 프로토콜 필드와 클라이언트 코어 버전에 따라 결정됩니다. 두 기기는 선택한 노드·라우팅·로컬 포트 설정을 각각 저장하며, 구독 업데이트는 이러한 로컬 옵션을 동기화하지 않습니다. 특정 노드가 한쪽에서만 실패한다면 양쪽의 코어 버전과 전송 매개변수를 비교하세요.

04 / DIAGNOSTICS

문제 해결

연결 문제를 점검할 때는 단일 노드, 전체 노드, 단일 앱, 전체 앱의 네 범위로 단계적으로 좁혀 가세요. 매번 변수 하나만 변경하고 클라이언트 로그에서 가장 먼저 나타난 오류를 보존해야 여러 설정이 동시에 바뀌는 일을 피할 수 있습니다.

노드 테스트가 계속 시간 초과로 표시될 때 어떻게 점검하나요?

먼저 같은 구독의 다른 노드로 전환해 문제가 특정 노드에만 해당하는지 모든 노드에 해당하는지 판단하세요. 이후 로컬 네트워크, 노드 주소, 포트, 프로토콜, 전송 방식 및 TLS 매개변수를 확인하고 시스템 시간과 시간대가 정확한지 점검합니다. 모든 노드가 동시에 시간 초과된다면 다른 프록시 프로그램을 잠시 종료하고, 클라이언트 로그에서 가장 먼저 나타난 연결 오류를 확인하세요.

클라이언트에는 연결 성공으로 표시되지만 웹 페이지가 열리지 않으면 어떻게 하나요?

먼저 활성 노드가 선택되었는지 확인한 뒤 시스템 프록시가 켜져 있는지, 브라우저에 별도 프록시가 설정되어 있는지, 라우팅 모드가 대상 주소를 직접 연결 또는 차단으로 지정하지 않았는지 점검하세요. 그런 다음 노드를 바꾸어 다시 테스트합니다. 도메인만 열리지 않고 직접 주소는 연결된다면 DNS 설정을 중점적으로 확인하세요. 모든 앱에서 실패한다면 코어 로그의 핸드셰이크 또는 라우팅 오류를 확인합니다.

v2rayN 시스템 프록시가 작동하지 않을 때 어떻게 처리하나요?

v2rayN이 코어를 실행했는지 확인하고, 시스템 프록시 메뉴가 시스템 프록시 설정 상태인지 점검하세요. 일부 프로그램은 자체 네트워크 설정을 사용하거나 시작할 때 프록시 매개변수를 캐시하므로 프로그램을 완전히 종료한 뒤 다시 여세요. 시스템에서 다른 프록시 도구도 실행 중이면 나중에 시작한 프로그램이 프록시 주소를 바꿀 수 있습니다. 충돌하는 프로그램을 종료한 뒤 다시 설정하고 로컬 수신 포트를 확인하세요.

v2rayN 구독 업데이트가 실패하는 흔한 원인은 무엇인가요?

흔한 원인으로는 구독 주소가 완전히 복사되지 않았거나 링크가 만료된 경우, 현재 네트워크에서 구독 주소에 접근할 수 없는 경우, 시스템 시간이 잘못된 경우, 구독 반환 내용이 클라이언트가 인식할 수 없는 형식인 경우가 있습니다. 먼저 구독 설정에서 주소와 활성화 상태를 확인한 다음 업데이트 로그의 HTTP 상태나 파싱 메시지를 확인하세요. 중복 그룹이 생기지 않도록 같은 구독을 반복해서 새로 만들지 마세요.

TUN을 켠 뒤 인터넷이 끊기거나 DNS 오류가 발생하면 어떻게 하나요?

먼저 TUN을 끄고 시스템 프록시를 복원해 기본 연결이 정상인지 확인하세요. 이후 TUN 가상 인터페이스, DNS 모드 및 라우팅 규칙을 점검하고 여러 VPN이나 가상 네트워크 카드가 동시에 기본 경로를 인계하지 않도록 하세요. 클라이언트가 비정상 종료된 뒤 네트워크가 복구되지 않으면 관련 프로그램을 정상 종료하고 네트워크 인터페이스를 다시 시작한 뒤 관리자 권한으로 TUN을 재활성화하세요.

V2Ray 클라이언트 다운로드