도움말 센터 · 클라이언트 및 연결 설정

V2Ray 자주 묻는 질문설정 및 문제 해결

먼저 문제가 발생한 계층을 파악한 뒤 해당 설정을 조정하세요. 아래 답변은 v2rayN, v2rayNG, v2flyNG를 다룹니다. 메뉴 이름은 클라이언트 버전에 따라 다를 수 있습니다.

클라이언트, 코어, 설치 파일

입문 가이드

클라이언트 비교 보기
V2Ray, 코어, GUI 클라이언트는 어떻게 다른가요?

설정을 다루는 인터페이스와 실제 연결을 처리하는 코어를 구분해야 합니다. V2Ray는 일반적으로 Project V와 관련된 기술 및 소프트웨어 생태계를 가리킵니다. V2Fly와 Xray는 관련 코어 계열로, 프로토콜·라우팅·연결 처리를 담당합니다. v2rayN, v2rayNG, v2flyNG는 설정을 가져오고 노드를 선택하거나 옵션을 변경할 수 있는 GUI를 제공합니다. 인터페이스에 특정 옵션이 보여도 현재 사용하는 코어가 해당 기능을 지원한다는 뜻은 아닙니다. 호환성을 확인할 때는 클라이언트 버전과 실제 실행 중인 코어, 설정 항목을 함께 살펴보고 클라이언트 이름만으로 판단하지 마세요.

데스크톱과 Android에서는 어떤 클라이언트를 선택해야 하나요?

데스크톱에서는 운영체제에 맞춰 v2rayN을 우선 고려하고, Android에서는 보통 v2rayNG를 먼저 선택한 뒤 코어 호환성에 따라 v2flyNG를 검토하세요. v2rayN은 Windows, macOS, Linux를 지원하며, v2rayNG는 Xray 코어, v2flyNG는 V2Fly 코어를 사용합니다. 두 Android 클라이언트는 지원하는 설정 항목과 업데이트 주기가 다를 수 있으므로 특정 코어용 설정을 공통 설정으로 간주하면 안 됩니다. 이미 구독을 사용 중이라면 제공자가 안내한 프로토콜과 클라이언트 요구 사항을 확인한 뒤 설치할 앱을 정하세요. 클라이언트를 바꾸기 전 필요한 설정을 저장하고, 가져온 뒤 라우팅과 DNS를 다시 확인하세요.

클라이언트를 설치한 뒤에는 무엇이 더 필요한가요?

유효한 서버 설정이나 호환되는 구독 링크가 필요합니다. 클라이언트만 설치한다고 연결이 자동으로 만들어지지는 않습니다. 노드 설정에는 보통 주소, 포트, 인증 정보, 전송 방식과 TLS 등의 항목이 포함됩니다. 구독 링크를 사용하면 이러한 설정을 한꺼번에 가져올 수 있습니다. 가져온 뒤 사용할 노드를 선택하고, 앱의 필요에 따라 시스템 프록시나 TUN을 켜세요. 구독 링크에는 계정 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관해야 합니다. 도움을 요청할 때는 전체 링크, QR 코드, 설정 화면에 표시된 인증 정보를 공개하지 말고 민감한 내용을 가린 오류 설명과 로그 일부만 공유하세요.

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

기기가 ARM64를 사용하고 운영체제도 해당 앱 아키텍처를 지원하는지 확인했다면 arm64를 우선 선택하세요. 확실하지 않다면 universal을 고려할 수 있습니다. 최근 출시된 Android 스마트폰 대부분은 ARM64를 사용하지만, 프로세서가 지원하더라도 운영체제에서 해당 실행 환경을 사용할 수 있는 것은 아닙니다. 구형 기기와 에뮬레이터는 특히 별도로 확인해야 합니다. universal 패키지는 여러 아키텍처용 구성 요소를 포함하는 경우가 많아 파일 크기가 더 크며, 실제 지원 범위는 패키지 안내를 확인하세요. 설치 파일을 분석할 수 없다는 오류가 발생하면 아키텍처만 의심하지 말고 Android 버전, 다운로드 완료 여부, 기존 앱과의 서명 충돌도 점검하세요.

구독 가져오기 및 트래픽 처리

플랫폼 가이드

빠른 시작 보기
구독 링크 가져오기에 실패하면 어디부터 확인해야 하나요?

로그인 페이지나 공유 페이지, 단일 노드 설명이 아니라 구독 주소를 복사했는지 먼저 확인하세요. 주소 앞뒤의 공백과 줄바꿈을 제거하고 구독 그룹에 추가해 저장한 다음 해당 그룹을 업데이트하세요. 형식 오류가 표시되면 제공자가 현재 클라이언트에서 인식할 수 있는 구독 형식을 제공하는지 확인해야 합니다. 웹페이지나 로그인 안내, 빈 응답은 노드 목록으로 처리할 수 없습니다. 단일 노드 공유 링크는 클립보드 가져오기 등 해당 기능을 사용하세요. 그래도 실패하면 오류 메시지와 발생 시각을 기록하고 구독이 만료되지 않았는지 확인하세요. 만료된 주소를 반복해서 붙여넣어도 해결되지 않습니다.

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

새로 설치한다면 먼저 크로스 플랫폼 데스크톱 버전을 살펴보고, 기존 Windows 인터페이스가 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 주로 UI 기술과 실행 환경 요구 사항이 다르며, 이름이 비슷하다고 설정 파일을 모두 공유할 수 있는 것은 아닙니다. 설치 전에 시스템 아키텍처와 배포 패키지에 필요한 런타임을 확인하세요. 시작할 때 구성 요소가 없다는 메시지가 표시되면 오류 내용에 맞는 환경을 설치해야 합니다. 노드를 계속 바꾸는 것은 해결책이 아닙니다. 이전할 때는 클라이언트의 백업 또는 내보내기 기능을 이용한 뒤 새 인터페이스에서 구독 그룹, 수신 대기 포트, 라우팅을 확인하세요. 두 프로그램을 같은 폴더에 설치해 덮어쓰지 마세요.

시스템 프록시, 라우팅 모드, TUN은 어떻게 함께 사용해야 하나요?

먼저 시스템 프록시로 기본 연결을 확인한 다음, 앱의 필요에 따라 TUN 사용 여부를 결정하세요. 시스템 프록시는 운영체제 설정을 따르는 앱이 로컬 프록시 포트를 사용하도록 안내하고, 라우팅 규칙은 코어에 전달된 연결을 어떤 아웃바운드로 보낼지 결정합니다. 두 설정은 서로 다른 단계에서 작동합니다. TUN은 가상 네트워크 인터페이스로 더 많은 트래픽을 처리하지만, 적절한 라우팅과 DNS, 권한이 필요합니다. 처음 설정할 때 여러 클라이언트의 시스템 프록시나 TUN을 동시에 켜지 말고, 출처가 불분명한 트래픽 가로채기 도구도 함께 사용하지 마세요. 경로를 하나로 단순하게 유지하고 연결이 정상인지 확인한 뒤 분기와 트래픽 처리 설정을 하나씩 추가하세요.

TUN 권한 부족 또는 가상 네트워크 인터페이스 생성 실패는 어떻게 해결하나요?

먼저 운영체제와 클라이언트가 안내하는 필요한 권한을 허용한 뒤 가상 네트워크 구성 요소가 정상인지 확인하세요. Windows에서는 구현에 따라 관리자 권한이나 관련 서비스 설치가 필요할 수 있습니다. macOS와 Linux에서도 배포 패키지에 따라 시스템 승인, 보조 구성 요소 또는 네트워크 인터페이스 접근 권한이 필요할 수 있습니다. Android에서는 VPN 연결 권한을 허용했는지 확인하고 다른 앱이 같은 유형의 연결을 사용 중인지 살펴보세요. 권한 부여에 실패하면 우선 TUN을 끄고 일반 프록시가 작동하는지 확인한 다음 시작 로그를 살펴보세요. 한 번 발생한 오류를 해결하려고 보안 기능을 계속 꺼두거나 가상 네트워크를 처리하는 기능을 두 개 동시에 켜지 마세요.

구독 관리, 트래픽 분기, DNS

사용 팁

고급 설정 보기
구독 업데이트는 실패했지만 기존 노드는 연결될 때 어떻게 해야 하나요?

기존 노드를 유지하고 그룹을 삭제해 복구하려고 하지 마세요. 구독 업데이트 요청과 노드 연결은 서로 다른 경로이므로 기존 노드가 연결된다고 구독 주소에도 접근할 수 있다는 뜻은 아닙니다. 구독 만료 여부와 주소 변경 여부, 클라이언트에서 프록시를 통한 구독 업데이트를 설정했는지 확인하세요. 직접 연결로 업데이트가 실패하면 사용 가능한 연결을 통해 프록시 업데이트를 시도하고, 반대의 경우에도 다른 경로를 시험해 볼 수 있습니다. 메뉴 위치는 버전에 따라 달라질 수 있으므로 현재 인터페이스를 기준으로 확인하세요. 인증서 오류나 HTTP 상태 코드가 표시되면 원문을 기록하세요. 인증서 검증을 꺼서 문제를 숨기거나 짧은 간격으로 계속 새로고침하지 마세요.

중국 본토 웹사이트까지 프록시를 거친다면 트래픽 분기 규칙을 어떻게 바꿔야 하나요?

먼저 어떤 규칙이 적용되는지 확인한 뒤, 직접 연결할 트래픽을 실제로 존재하는 direct 아웃바운드에 지정하세요. 일반적인 설정에서는 geoip:private와 geosite:cn을 기본 프록시 규칙보다 앞에 배치하지만, 차단 규칙과 사용 목적에 따라 순서는 달라질 수 있습니다. 규칙은 보통 위에서부터 순서대로 적용되므로 앞에 광범위한 프록시 규칙이 있으면 뒤의 직접 연결 규칙이 적용되지 않을 수 있습니다. geosite나 geoip를 사용한다면 현재 코어가 필요한 규칙 데이터를 불러올 수 있는지도 확인하세요. 수정 후 저장하고 설정을 다시 불러온 다음 새 연결로 검증하세요. 이미 연결된 세션은 이전 경로를 계속 사용할 수 있습니다.

DNS 설정을 바꿀 때 구성이 더 복잡해지지 않게 하려면 어떻게 해야 하나요?

먼저 도메인을 앱, 운영체제, 코어 중 어디에서 해석하는지 확인한 뒤 해당 계층을 수정하세요. 브라우저의 보안 DNS, 시스템 DNS, 코어 DNS, TUN의 DNS 가로채기가 동시에 작동할 수 있으므로 한 곳만 바꿔도 실제 조회 경로가 달라지지 않을 수 있습니다. 문제를 확인할 때는 기존 설정을 기록하고 한 번에 한 항목만 변경한 뒤 도메인 접속과 연결 로그를 각각 확인하세요. 라우팅의 domainStrategy는 특정 조건에서 도메인 해석과 IP 매칭에 영향을 주지만 전역 DNS 스위치는 아닙니다. 다른 코어의 설정 항목을 그대로 복사하지 마세요. DNS 조회 경로를 확인한 뒤에 도메인별 DNS나 FakeDNS를 검토하세요.

구독이 여러 개라면 노드를 잘못 선택하지 않도록 어떻게 그룹화해야 하나요?

구독 출처나 용도에 따라 그룹을 나누고 각 그룹에 알아보기 쉬운 이름을 붙이세요. 모든 주소를 구분하기 어려운 목록 하나에 몰아넣지 마세요. 그룹 하나를 업데이트한 뒤 해당 그룹에서 가져온 노드와 현재 선택된 항목을 확인하고 연결하세요. 필터가 노드를 숨길 수 있으므로 업데이트 후 목록이 비어 있다면 이름 필터, 프로토콜 필터, 선택된 그룹도 점검해야 합니다. 클라이언트마다 업데이트 동작이 다르며 구독에서 생성된 노드를 직접 수정하면 다음 업데이트 때 변경 내용이 덮어써질 수 있습니다. 계속 유지해야 하는 사용자 설정 항목은 클라이언트가 지원하는 방식으로 별도 관리하세요. 그룹을 삭제하기 전에 필요한 설정을 백업하세요.

로컬 설정부터 목적지 연결까지

문제 해결

문제 해결 가이드 보기
노드 연결 시간이 계속 초과되면 어떤 순서로 점검해야 하나요?

처음부터 모든 설정을 바꾸기보다 기기 시간, 구독 상태, 로컬 코어, 연결 매개변수, 서버 상태 순서로 확인하세요. 우선 자동 시간 설정을 켜고 구독을 업데이트한 다음 활성 노드를 확인하세요. 이어서 코어가 정상적으로 시작됐는지, 포트가 사용 중인지, 로그에 연결 시간 초과와 TLS 핸드셰이크 실패 중 어떤 오류가 기록됐는지 살펴보세요. 주소, 포트, 전송 방식, 서버 이름, 인증 정보를 확인하되 프로토콜마다 설정 항목이 다르므로 서로 바꿔 쓰지 마세요. 마지막으로 다른 네트워크나 정상 작동이 확인된 다른 설정과 비교하세요. 속도 측정이 시간 초과되더라도 테스트 대상의 문제일 수 있으므로 실제 접속 결과도 함께 확인하세요.

연결됨으로 표시되지만 웹페이지가 열리지 않으면 어떻게 해야 하나요?

먼저 트래픽이 클라이언트로 전달되는지 확인하세요. 인터페이스에 실행 중이라고 표시되는 것은 서비스나 트래픽 처리 과정이 시작됐다는 뜻일 뿐, 목적지 연결에 성공했다는 뜻은 아닙니다. 접속을 시도할 때 새 로그가 생성되는지 확인한 다음 활성 노드, 시스템 프록시 또는 TUN 상태, 라우팅 아웃바운드, DNS를 각각 점검하세요. 모든 도메인에 접속할 수 없다면 DNS 오류와 로컬 수신 대기를 중점적으로 확인하세요. 일부 사이트만 실패한다면 규칙 적용, 목적지 연결, 프로토콜 설정을 살펴보세요. 비교를 위해 잠시 단순한 규칙을 사용할 수 있지만 테스트가 끝나면 필요한 트래픽 분기 설정을 복구하세요. 한 번에 한 항목만 바꾸고 변경 전후 결과를 기록하면 원인을 찾기 쉽습니다.

v2rayN 시스템 프록시가 작동하지 않으면 브라우저와 터미널을 따로 점검해야 하나요?

브라우저와 명령줄 도구는 같은 프록시 설정을 읽지 않을 수 있으므로 각각 확인해야 합니다. 브라우저에서는 시스템 프록시 스위치, 프록시 확장 프로그램, PAC, 앱 자체 설정을 확인하고 현재 클라이언트의 수신 대기 주소와 포트를 가리키는지 살펴보세요. 터미널 프로그램은 프록시 환경 변수를 지원하는지 확인해야 하며, 이미 실행 중인 터미널은 다시 열어야 할 수 있습니다. 일부 도구에는 별도의 프록시 옵션도 있습니다. 한 프록시 프로토콜의 수신 포트를 다른 유형의 프록시 설정에 입력하지 마세요. 브라우저는 정상인데 터미널만 작동하지 않는다면 노드를 바꾸기보다 터미널 설정부터 확인하세요. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 사용을 검토하세요.

Android에서 백그라운드로 전환한 뒤 연결이 끊기면 원인을 어떻게 찾아야 하나요?

클라이언트 프로세스가 종료된 것인지, VPN 연결이 다른 앱으로 바뀐 것인지, 노드 자체가 작동하지 않는 것인지 먼저 구분하세요. 연결이 끊기기 전후의 상시 알림과 로그를 살펴본 뒤 배터리 최적화, 백그라운드 실행, 자동 시작 권한을 확인하세요. 설정 위치는 제조사마다 다를 수 있습니다. 다른 앱이 VPN을 시작했다면 같은 유형의 연결이 충돌할 수 있으므로 필요한 트래픽 처리 기능만 하나 활성화하세요. 모바일 네트워크와 Wi-Fi를 전환한 뒤 문제가 생겼다면 다시 연결하고 DNS와 네트워크 상태를 확인하세요. 화면을 잠근 뒤 웹페이지가 열리지 않는다는 이유만으로 구독이 만료됐다고 판단하지 마세요. 절전 설정을 한꺼번에 모두 끄기보다 필요한 권한을 하나씩 시험하세요.