FAQ · CLIENT / CORE / ROUTING
v2rayN 및 v2rayNG 자주 묻는 질문
연결 경로, 플랫폼, 작업 단계별로 정리했습니다. 문제가 클라이언트, 구독, 코어, 시스템 프록시, 출구 노드 중 어디에 있는지 먼저 판단한 뒤 해당 항목을 점검하세요.
01 · BASICS
기본 개념
클라이언트, 코어, 구독, 프록시 모드를 먼저 구분해 서로 다른 연결 단계를 하나의 설정으로 혼동하지 않도록 하세요.
V2Ray, v2rayN, v2rayNG는 각각 무엇인가요?
V2Ray는 일반적으로 Project V 생태계의 프로토콜, 코어 및 도구 모음을 가리키며, 특정 그래픽 클라이언트와 같은 의미는 아닙니다. v2rayN은 Windows, macOS, Linux용 데스크톱 클라이언트로 서버, 구독, 라우팅 및 시스템 프록시를 관리합니다. v2rayNG는 Android 클라이언트이며, 일반적으로 Xray 코어를 사용합니다. 클라이언트는 조작 화면을 제공하고, 실제 연결과 트래픽 처리는 클라이언트가 호출하는 코어가 담당합니다.
구독 주소와 클라이언트 설치 패키지는 같은 것인가요?
아닙니다. 설치 패키지는 v2rayN, v2rayNG 또는 v2flyNG를 기기에 설치할 때 사용하며, 구독 주소는 네트워크 서비스 제공자가 생성해 서버 설정을 클라이언트로 전달하는 데 사용합니다. 클라이언트를 설치한 뒤에도 유효한 구독을 가져오거나 서버 매개변수를 직접 입력해야 합니다. 이 사이트는 클라이언트 설치 및 설정 안내를 제공하지만 구독 주소를 생성하지 않으며, 설치 패키지로 서버 설정을 대신할 수도 없습니다.
시스템 프록시와 TUN 모드는 어떻게 다른가요?
시스템 프록시는 운영체제의 프록시 설정을 읽는 앱의 연결을 가로채는 방식으로, 설정이 간단해 브라우저와 대부분의 데스크톱 프로그램에 적합합니다. TUN 모드는 가상 네트워크 어댑터를 통해 더 넓은 범위의 네트워크 트래픽을 처리하므로 시스템 프록시를 읽지 않는 앱도 적용할 수 있지만, 더 높은 권한이 필요하고 다른 가상 어댑터, 네트워크 필터 프로그램 또는 보안 정책과 충돌하기 쉽습니다. 일상적인 사용은 먼저 시스템 프록시부터 시도하는 것이 좋습니다.
데스크톱과 Android에서는 어떤 클라이언트를 선택해야 하나요?
Windows, macOS, Linux에서는 v2rayN을 선택할 수 있으며, 데스크톱 플랫폼 간 화면과 구독 관리 방식이 비교적 일관적입니다. Android에서는 일반적으로 v2rayNG를 우선 선택합니다. 구독 설정이 v2fly 코어의 동작에 명확히 의존한다면 v2flyNG를 사용할 수 있습니다. 클라이언트마다 설정 메뉴는 완전히 같지 않지만, 구독 업데이트, 노드 선택, 연결 시작, 필요에 따른 라우팅 설정이라는 기본 흐름은 동일합니다.
02 · INSTALLATION
설치 및 설정
설치 단계에서는 운영체제, 프로세서 아키텍처, 구독 가져오기 위치, 네트워크 권한을 중점적으로 확인하세요.
Windows 데스크톱 버전과 클래식 WPF 버전은 어떻게 선택하나요?
데스크톱 버전은 최신 크로스 플랫폼 인터페이스를 사용하므로 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 사용자에게 적합합니다. 클래식 WPF 버전은 전통적인 Windows 인터페이스를 사용해 이전 버전의 메뉴와 트레이 조작에 익숙한 사용자에게 알맞습니다. 두 버전 모두 구독, 노드, 코어를 관리하는 용도입니다. 두 버전을 동시에 실행하면 로컬 수신 포트와 시스템 프록시 설정이 서로 덮어쓸 수 있으므로 피하세요.
macOS 설치 패키지에서 Apple Silicon과 Intel은 어떻게 구분하나요?
시스템 정보 또는 이 Mac에 관하여를 열고 칩 또는 프로세서 항목을 확인하세요. Apple M 시리즈 칩으로 표시되면 Apple Silicon용 arm64 설치 패키지를 선택하고, Intel 프로세서로 표시되면 x64 설치 패키지를 선택합니다. 아키텍처를 잘못 선택하면 앱이 실행되지 않거나 별도의 호환 계층이 필요할 수 있습니다. 다운로드 전에 하드웨어 아키텍처를 확인하는 것이 시스템 버전 번호로 추측하는 것보다 정확합니다.
Android에서는 arm64와 universal 설치 패키지 중 무엇을 선택해야 하나요?
2015년 이후 출시된 대부분의 주요 Android 스마트폰은 arm64 아키텍처를 사용하므로, 우선 arm64 설치 패키지를 다운로드하는 것이 좋습니다. 일반적으로 파일 크기도 더 작습니다. 프로세서 아키텍처를 확인할 수 없거나 기기가 오래되었거나 arm64 패키지가 호환되지 않는다고 표시될 때는 universal 범용 버전을 선택하세요. 범용 버전은 더 많은 아키텍처를 지원하므로 용량이 클 수 있지만, 같은 버전의 arm64 패키지와 클라이언트 기능은 거의 같습니다.
구독 주소를 붙여 넣은 뒤 가져오기에 실패하는 이유는 무엇인가요?
먼저 주소 앞뒤에 공백이나 줄바꿈이 있거나 메신저에서 일부가 잘리지 않았는지 확인하세요. 또한 가져오기 위치가 개별 서버 설정 창이 아니라 구독 그룹인지 확인합니다. 그런 다음 브라우저에서 해당 주소가 여전히 내용을 반환하는지 확인하고, 기기 시간이 정확한지도 점검하세요. 서비스 제공자가 전용 요청 매개변수를 요구하거나 주소를 변경했다면 최신 전체 링크를 사용해야 합니다. 이전 주소는 클라이언트가 자동으로 복구할 수 없습니다.
TUN을 켤 때 권한이 부족하다고 표시되면 어떻게 해야 하나요?
먼저 클라이언트를 완전히 종료한 뒤, 운영체제의 요구에 따라 관리자 권한, 네트워크 확장 또는 가상 네트워크 어댑터 관련 권한을 부여하고 다시 시작하세요. 그래도 실패하면 다른 프록시 도구, 가상 머신 네트워크, 컨테이너 네트워크 또는 보안 소프트웨어가 같은 기능을 사용하고 있는지 확인합니다. 문제를 점검할 때는 다른 가상 네트워크 어댑터 프로그램을 먼저 끄고 클라이언트 하나만 남겨 테스트하세요. 시스템 프록시가 정상적으로 작동하는 것을 확인한 뒤 TUN을 별도로 활성화하는 것이 좋습니다.
03 · OPERATION
활용 팁
구독 업데이트, 라우팅 모드, 노드 테스트는 하나의 연결 흐름 안에서 함께 판단해야 합니다.
v2rayN에서 구독을 올바르게 가져오고 업데이트하려면 어떻게 하나요?
먼저 구독 그룹을 새로 만들고 전체 구독 주소를 입력해 저장한 다음, 현재 구독 업데이트 또는 모든 구독 업데이트를 실행하세요. 업데이트가 끝나면 서버 목록에 노드가 나타나는지 확인하고, 노드 하나를 선택해 활성 서버로 지정한 뒤 시스템 프록시 또는 필요한 연결 모드를 켭니다. 이후 업데이트는 기존 그룹을 대상으로 실행하세요. 같은 이름의 그룹을 반복해서 만들면 중복 노드와 선택 상태 혼란이 발생하기 쉽습니다.
V2Ray 전체 프록시는 언제 사용해야 하나요?
전체 프록시는 클라이언트가 가로채도록 설정된 트래픽을 현재 프록시 출구로 일괄 전송합니다. 라우팅 규칙 때문에 접속에 문제가 생겼는지 임시로 확인하거나, 모든 트래픽을 하나의 출구로 보내야 하는 경우에 적합합니다. 일상적인 사용에서는 도메인, 주소, 로컬 네트워크 범위에 따라 분할 라우팅을 설정하는 편이 좋습니다. LAN 기기, 시스템 업데이트 또는 프록시가 필요 없는 서비스가 불필요하게 우회하는 것을 막을 수 있습니다. 모드를 바꾼 뒤에는 대상 앱을 다시 열어 테스트하세요.
구독을 업데이트하면 수동 메모와 현재 노드가 덮어써지나요?
결과는 클라이언트 버전, 그룹 설정, 구독 내용에 따라 달라집니다. 구독 업데이트는 일반적으로 서버 식별자를 기준으로 목록을 다시 생성하므로, 서비스 제공자가 노드 이름이나 매개변수를 변경하면 기존 항목이 교체될 수 있습니다. 현재 노드가 계속 일치하면 보통 유지되지만, 일치하지 않으면 다시 선택해야 합니다. 중요한 사용자 지정 서버는 별도 그룹에 넣고 자동 업데이트되는 구독 항목과 섞지 마세요.
지연 시간 테스트, 실제 지연 시간, 연결 속도는 왜 서로 다른가요?
테스트마다 대상 주소, 프로토콜 단계, 시간 초과 조건이 다릅니다. 기본 지연 시간은 연결을 설정하는 데 걸린 시간만 반영할 수 있고, 실제 지연 시간은 프록시 핸드셰이크와 대상 요청까지 포함합니다. 실제 다운로드 속도는 출구 대역폭, 대상 서버, 회선 혼잡, 기기 성능의 영향도 받습니다. 따라서 지연 시간 수치는 1차 선별에만 사용하고, 최종 판단은 대상 웹사이트 접속과 안정성을 함께 확인해야 합니다.
라우팅 모드는 규칙 분할과 전체 중 무엇을 선택해야 하나요?
처음 설정할 때는 전체 모드를 잠시 사용해 노드와 코어 연결 경로가 정상인지 확인할 수 있습니다. 접속이 확인되면 규칙 분할로 전환하세요. 규칙 분할은 도메인, IP 주소, 규칙 집합에 따라 직접 연결, 프록시 또는 차단을 결정하므로 장기간 사용에 더 적합합니다. 전환 후 일부 웹사이트만 실패한다면 모든 노드를 즉시 바꾸기보다 적용된 라우팅 규칙과 DNS 결과를 먼저 확인하세요.
04 · DIAGNOSTICS
문제 해결
로컬 네트워크부터 시작해 클라이언트 상태, 코어 로그, 프록시 적용 여부, DNS, 라우팅, 노드 출구를 차례로 확인하세요.
노드 테스트가 계속 시간 초과로 표시되면 어떻게 점검하나요?
먼저 기기 자체가 정상적으로 인터넷에 연결되는지 확인한 뒤 시스템 시간, 서버 주소, 포트, 전송 방식, TLS, SNI, 사용자 식별자가 모두 정확한지 점검하세요. 이후 코어 로그를 확인해 도메인 확인 실패, 연결 거부, 핸드셰이크 실패, 응답 대기 시간 초과를 구분합니다. 같은 구독의 모든 노드가 시간 초과되면 로컬 네트워크와 구독 설정을 확인하고, 일부 노드만 시간 초과되면 해당 서버 상태에 문제가 있을 가능성이 높습니다.
클라이언트는 연결되었다고 표시되지만 웹페이지가 열리지 않으면 어떻게 해야 하나요?
연결 경로 순서대로 확인하세요. 먼저 현재 노드가 활성 서버로 지정되었는지 확인하고, 시스템 프록시 또는 TUN이 실제로 켜져 있는지 점검합니다. 다음으로 브라우저에 별도의 프록시 설정이 사용되고 있지 않은지 확인하세요. 이어서 코어 로그에서 DNS, 라우팅 또는 핸드셰이크 오류를 확인합니다. 임시로 전체 모드로 전환해 비교할 수도 있습니다. 전체 모드에서는 작동하지만 규칙 모드에서는 작동하지 않는다면 대개 분할 라우팅 규칙이나 DNS 설정이 원인입니다.
v2rayN에서 시스템 프록시를 켰는데도 앱이 계속 직접 연결되면 어떻게 해야 하나요?
일부 앱은 운영체제 프록시를 읽지 않거나 시작할 때 이전 설정을 캐시합니다. 먼저 대상 앱을 종료하고 시스템 프록시가 v2rayN의 현재 로컬 수신 주소와 포트를 가리키는지 확인한 다음 앱을 다시 여세요. 앱 내부에 직접 연결 또는 별도 프록시가 설정되어 있는지도 확인해야 합니다. 해당 프로그램이 계속 시스템 프록시를 우회한다면 권한과 호환성을 확인한 뒤 TUN을 사용하세요. 여러 프록시 도구를 동시에 겹쳐 사용하는 것은 피하는 것이 좋습니다.
구독 업데이트에 실패하거나 빈 목록이 반환되면 어떻게 해야 하나요?
먼저 올바른 그룹을 업데이트하고 있는지 확인하고, 구독 주소가 완전한지, 만료되지 않았는지, 기기 시간이 정확한지 점검하세요. 빈 목록이 반환되었다고 해서 반드시 클라이언트 문제는 아닙니다. 서비스 제공자가 빈 내용을 반환했거나 인증이 만료되었거나 구독 형식이 변경되었을 수도 있습니다. 업데이트 로그에서 HTTP 상태, 파싱 오류, 시간 초과 정보를 확인하세요. 그룹을 연속해서 새로 만들지 말고 기존 주소를 수정한 뒤 업데이트를 한 번 다시 실행하세요.
코어가 시작되자마자 종료될 때 원인을 어떻게 찾나요?
클라이언트 로그 창을 열고 이번 시작 과정에서 가장 먼저 나타난 오류 행을 찾으세요. 포트가 사용 중이면 해당 프로그램을 종료하거나 로컬 수신 포트를 변경합니다. 설정 파싱에 실패했다면 최근에 변경한 라우팅, DNS 또는 수동 서버 매개변수를 되돌리세요. 필수 필드가 없으면 유효한 구독에서 다시 가져옵니다. 마지막 종료 메시지만 보지 마세요. 실제 원인은 대개 그 앞에 기록된 첫 번째 오류입니다.
일부 도메인만 열리지 않는 경우 DNS 문제일 수 있나요?
그럴 수 있습니다. 먼저 같은 노드로 여러 도메인을 테스트해 문제가 특정 도메인이나 규칙 그룹에 집중되는지 확인하세요. 클라이언트 DNS 설정, 시스템 캐시, 라우팅 규칙의 도메인 일치 여부, 그리고 DNS 결과가 직접 연결과 프록시 중 어느 경로로 처리되는지 점검합니다. 변경 후에는 시스템 DNS 캐시를 비우고 대상 앱을 다시 시작하세요. 전체 모드로 전환했을 때 정상으로 돌아온다면 클라이언트를 재설치하기보다 분할 라우팅과 DNS 확인 경로를 계속 점검해야 합니다.