V2Ray 자주 묻는 질문

문제가 발생한 위치에 따라 답을 찾아보세요. 설치 실패는 시스템과 아키텍처를, 목록이 비어 있으면 구독 가져오기를, 클라이언트는 실행되지만 웹페이지가 열리지 않으면 프록시 연결과 라우팅을 확인하세요. v2rayN, v2rayNG, v2flyNG에 적용됩니다.

기초 개념

클라이언트, 코어, 노드는 각각 무엇인가요?

클라이언트는 설정을 관리하고, 코어는 연결과 라우팅을 처리하며, 노드는 원격 연결에 필요한 매개변수를 제공합니다. v2rayN은 데스크톱 클라이언트이고, v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 클라이언트를 설치했다고 해서 사용할 노드까지 설정된 것은 아닙니다. 목록이 비어 있으면 먼저 가져오기 결과를 확인하고, 노드가 표시되지만 서비스가 시작되지 않으면 코어 로그를 살펴보세요. 두 경우의 점검 방법은 다르므로 문제가 발생한 계층부터 구분한 뒤 재설치나 클라이언트 변경을 고려하세요.

구독 링크와 단일 노드 공유 링크는 어떻게 다른가요?

구독 링크는 다시 가져올 수 있는 설정 목록을 가리키고, 단일 노드 공유 링크는 하나의 연결 정보만 담습니다. 구독 주소는 구독 그룹에 추가한 뒤 업데이트해야 하고, 단일 노드 링크는 클립보드나 QR 코드로 가져옵니다. 구독을 업데이트하면 서비스 제공자가 목록을 변경한 내용이 반영되지만, 따로 가져온 노드는 자동으로 갱신되지 않습니다. 서비스 계정 관리 페이지 주소만 받은 경우에는 전용 구독 메뉴를 찾아야 합니다. 로그인 페이지를 구독 주소로 사용할 수는 없습니다.

시스템 프록시와 전역 라우팅은 같은 설정인가요?

아닙니다. 시스템 프록시는 해당 설정을 따르는 앱이 요청을 로컬 프록시로 보낼지 결정하고, 전역 라우팅은 코어에 전달된 요청을 어떤 아웃바운드로 보낼지 결정합니다. 전역 라우팅을 선택해도 시스템 프록시를 무시하는 앱까지 자동으로 제어하지는 않습니다. 반대로 시스템 프록시를 켜도 사용자 지정 규칙에 따라 요청이 직접 연결될 수 있습니다. 확인하려면 시스템 프록시를 따르는 브라우저에서 요청을 보내고, 클라이언트 로그에서 해당 요청과 아웃바운드를 찾을 수 있는지 살펴보세요.

프로토콜, 전송 방식, TLS 설정은 각각 따로 변경해도 되나요?

각각 다른 항목이지만 연결 매개변수는 서버 설정과 일치해야 합니다. VMess와 VLESS는 프로토콜이고, WebSocket은 전송 방식이며, TLS는 보안 계층 옵션입니다. 서비스 제공자가 준 설정을 사용할 때는 더 빨라 보인다는 이유로 어느 항목이든 임의로 바꾸지 마세요. 핸드셰이크 오류가 발생하면 서버 주소, 포트, 전송 방식, 서버 이름부터 확인하세요. 설정이 구독에서 온 것이라면 먼저 구독을 업데이트한 뒤 이전 항목과 새 항목을 비교하세요.

더 읽기: 프로토콜·코어·라우팅 용어 설명

설치 및 설정

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

처음 설치한다면 데스크톱 버전을 선택하면 됩니다. 익숙한 클래식 인터페이스를 선호한다면 Windows용 WPF 버전을 선택할 수 있습니다. 먼저 시스템 정보에서 프로세서 아키텍처를 확인하고 설치 파일과 맞는지 살펴보세요. 클라이언트가 실행되지 않으면 시스템 오류 메시지를 먼저 확인하세요. 런타임이 없다는 안내가 나오면 구독이나 노드를 변경하기보다 해당 설치 파일의 안내에 따라 필요한 런타임을 설치하세요. 두 버전을 함께 시험할 때는 로컬 프록시를 동시에 켜지 마세요. 수신 포트가 충돌하거나 한쪽을 종료할 때 시스템 프록시 상태에 영향을 줄 수 있습니다.

Android 설치 파일은 arm64와 universal 중 무엇을 선택해야 하나요?

기기가 arm64-v8a를 지원한다면 arm64를 우선 선택하고, 아키텍처를 모르겠다면 universal을 선택하세요. 범용 패키지는 보통 여러 아키텍처의 네이티브 라이브러리를 포함해 용량이 더 크지만, 낮은 OS 버전이나 설치 정책 제한 문제를 해결해 주지는 않습니다. 같은 이름의 앱이 이미 설치되어 덮어쓸 수 없다면 먼저 설치 안내에 서명 불일치가 표시되는지 확인한 다음 앱의 출처를 살펴보세요. 바로 삭제하지 마세요. 삭제하면 로컬 설정이 지워질 수 있으므로 먼저 기기에 백업하세요.

구독을 가져온 뒤 노드가 표시되지 않는 이유는 무엇인가요?

구독 주소를 저장한 뒤 업데이트를 실행했는지 확인하고, 해당 그룹으로 이동해 목록을 살펴보세요. 주소가 유효하지 않다는 오류가 나오면 전체 링크를 다시 복사하고 앞뒤 공백을 제거하되 쿼리 매개변수는 그대로 두세요. 요청은 성공했지만 파싱에 실패했다면 구독 출력 형식이 현재 클라이언트 및 코어와 호환되는지 확인하세요. 로그인 페이지나 만료 안내는 성공 상태를 반환하더라도 노드 목록이 아닙니다. 로그를 확인할 때는 시간과 오류 유형만 기록하고 전체 구독 주소는 공개하지 마세요.

TUN 또는 Android VPN을 켤 때 권한 부족 메시지가 나오면 어떻게 하나요?

데스크톱에서는 로그를 확인해 권한이 거부된 것인지, 가상 네트워크 어댑터를 만들거나 라우팅을 설정하지 못한 것인지 구분하세요. 클라이언트와 시스템 안내에 따라 필요한 권한이 있는 계정을 사용하되, 이 문제를 해결하려고 시스템 보호 기능을 끄지는 마세요. Android에서는 처음 실행할 때 시스템 VPN 권한을 승인해야 합니다. 이미 다른 VPN 연결을 사용 중이라면 기존 연결을 끊고 다시 시도하세요. 조직 정책으로 관리되는 기기라면 해당 기능의 사용이 허용되는지 먼저 확인하세요. 브라우저만 시험할 때는 기존 시스템 프록시 설정으로 노드를 확인할 수 있습니다.

더 읽기: 구독 가져오기·연결·확인 가이드

사용 팁

지연 시간 테스트는 TCP와 실제 지연 시간 중 무엇을 봐야 하나요?

TCP 테스트는 보통 클라이언트가 서버 포트에 연결할 수 있는지만 보여 주며, 프로토콜 핸드셰이크나 데이터 전달이 정상인지 증명하지는 않습니다. 실제 지연 시간 테스트는 선택한 노드를 통해 테스트 주소에 요청을 보내므로 실제 사용 상태에 더 가깝지만, 테스트 대상과 네트워크, 당시 부하의 영향도 받습니다. 노드를 비교할 때는 같은 테스트 주소와 네트워크를 사용하고, 이상한 결과는 다시 측정하세요. 시간 초과는 해당 요청이 제한 시간 안에 완료되지 않았다는 뜻일 뿐, 그 결과만으로 노드가 작동하지 않는다고 판단할 수는 없습니다.

GeoSite와 GeoIP 라우팅 규칙은 어떻게 구분하나요?

geosite:cn은 규칙 데이터베이스의 도메인 집합과 일치하고, geoip:private는 사설 IP 주소 집합과 일치하므로 서로 대체할 수 없습니다. 코어는 규칙을 순서대로 확인해 처음 일치하는 라우팅 규칙을 적용합니다. 따라서 더 구체적인 예외 규칙을 범위가 넓은 규칙보다 앞에 두세요. 도메인 규칙이 적용되지 않으면 로그에 표시된 대상이 도메인인지 IP인지 먼저 확인하세요. IP 일치에 의존하는 경우에는 주소 해석 정책도 확인해야 합니다. 규칙을 변경한 뒤 같은 대상을 다시 테스트하세요.

일부 웹사이트만 열리지 않을 때 DNS 문제인지 어떻게 확인하나요?

현재 노드와 라우팅은 그대로 둔 채 문제가 있는 사이트와 정상적으로 열리는 사이트를 각각 접속한 다음 같은 시간대의 로그를 비교하세요. 도메인 해석 실패가 보이면 시스템, 브라우저, 코어가 각각 어떤 DNS 경로를 사용하는지 확인하세요. 브라우저의 보안 DNS 설정은 시스템 설정과 다를 수 있습니다. 로그에 도메인 해석 성공이 표시된 뒤 연결 오류나 인증서 오류가 발생한다면 해당 단계의 문제를 확인하세요. 모든 DNS 옵션을 한꺼번에 변경하지 마세요.

구독 자동 업데이트 간격은 짧을수록 좋은가요?

그렇지 않습니다. 먼저 수동 업데이트가 성공하는지 확인한 뒤 서비스 제공자의 안내와 노드 변경 빈도에 맞춰 간격을 설정하세요. 간격을 너무 짧게 하면 요청 횟수만 늘고, 서비스 제공자가 요청을 제한하면 오히려 업데이트에 실패할 수 있습니다. 예약 업데이트 옵션은 클라이언트와 버전에 따라 다르므로 현재 버전의 구독 그룹이나 관련 설정에서 해당 기능을 제공하는지 확인하세요. 업데이트 후에는 현재 선택된 항목도 살펴보세요. 구독에서 삭제된 이전 노드를 계속 테스트하지 않도록 주의해야 합니다.

더 읽기: GeoIP·GeoSite 규칙 데이터베이스 업데이트 및 작성법

문제 해결

노드 시간이 초과되면 로컬과 서버 중 어디부터 확인해야 하나요?

먼저 노드 하나만 시간 초과되는지, 같은 네트워크에서 모든 노드가 시간 초과되는지 확인하세요. 하나만 문제가 있다면 같은 그룹의 정상 노드와 비교하고, 문제가 있는 노드의 주소와 포트, 전송 매개변수를 확인하세요. 모든 노드에 문제가 있다면 기기 네트워크가 정상인지, 코어가 실행되는지, 로컬 프록시 포트가 수신 대기 중인지 먼저 확인하세요. 테스트 대상이 일시적으로 접속 불가일 수도 있으니 접속 가능한 것으로 알려진 다른 대상으로 다시 테스트하세요. 그래도 실패하면 로그에서 연결 시간 초과와 핸드셰이크 실패를 구분하세요.

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

연결됨으로 표시되어도 웹 요청이 프록시를 통해 정상 처리됐다는 뜻은 아닙니다. 데스크톱에서는 시스템 프록시를 따르는 브라우저로 문제를 재현하세요. Android에서는 앱이 앱별 프록시 설정에서 제외되지 않았는지 먼저 확인하세요. 로그에 해당 요청이 없다면 트래픽이 클라이언트에 들어왔는지 확인하고, 요청은 있지만 예상하지 않은 아웃바운드로 전달됐다면 라우팅 순서를 살펴보세요. 예상한 아웃바운드로 나갔는데도 오류가 발생하면 DNS, 연결, 인증서 오류에 따라 원인을 좁혀 가세요. 한 번에 한 항목만 변경하고 같은 주소로 다시 확인하세요.

v2rayN에서 시스템 프록시를 설정했는데 특정 앱에서 작동하지 않는 이유는 무엇인가요?

시스템 프록시를 따르는 브라우저를 기준으로 비교해 보세요. 브라우저는 되는데 특정 앱만 안 된다면 해당 앱이 별도의 프록시 설정을 사용하거나 직접 연결하는지 확인하세요. 브라우저도 실패한다면 시스템 프록시의 주소와 포트가 클라이언트의 현재 수신 설정과 일치하는지 확인하고 코어가 실행 중인지 살펴보세요. 로컬 포트를 변경했다면 프록시를 수동으로 설정한 앱도 함께 수정해야 합니다. 로그에 포트가 사용 중이라는 메시지가 있으면 먼저 해당 포트를 사용하는 프로세스를 확인한 뒤 기존 인스턴스를 종료할지 포트를 변경할지 결정하세요.

잘 작동하던 구독이 갑자기 업데이트되지 않을 때 원인을 어떻게 찾나요?

기존 노드는 유지한 채 실패 유형부터 확인하세요. 401 또는 403 응답이 오면 구독이 만료되었는지, 접근 권한이 바뀌었는지 확인하세요. 도메인 해석 오류나 인증서 오류가 발생하면 DNS와 시스템 시간을 먼저 살펴보세요. 업데이트 요청이 현재 프록시를 통하지만 현재 노드가 작동하지 않는 경우, 구독 주소의 직접 연결이 허용된다면 프록시를 거치지 않는 업데이트 방식으로 바꿔 순환 의존 문제를 배제할 수 있습니다. 업데이트가 성공했는데도 새 노드가 없다면 그룹, 응답 형식, 파싱 로그를 확인하세요. 기존 그룹을 먼저 삭제하지 마세요.

더 읽기: 구독 업데이트 실패 단계별 점검、로컬 포트 충돌 원인 찾기

클라이언트 다운로드