클라이언트 설정 및 연결 문제 해결

V2Ray 자주 묻는 질문

구독 가져오기, 프록시 모드, TUN 권한.
문제가 발생한 단계를 먼저 확인한 뒤 관련 설정을 살펴보세요.

오류 메시지 원문과 발생시킨 작업을 기록하세요. 로그를 공유하기 전에는 구독 주소와 인증 정보를 가려 주세요.

연결 문제 해결 순서
앱 진입점에서 코어와 라우팅을 거쳐 원격 연결까지 확인합니다. DNS는 도메인 이름을 해석합니다. 코어 DNS 앱 진입점 라우팅 원격 연결

순서에 따라 원인을 좁히고, 여러 설정을 한꺼번에 바꾸지 마세요.

개념과 선택

기본 개념

클라이언트, 코어, 설정, 트래픽 진입점을 구분해 서로 다른 단계의 문제를 혼동하지 않도록 합니다.

V2Ray, V2Fly, Xray와 GUI 클라이언트는 어떤 관계인가요?

V2Ray는 보통 Project V 생태계의 프록시 코어와 관련 도구를 가리킵니다. V2Fly는 V2Ray 개발을 이어가는 커뮤니티 프로젝트이며, Xray는 별도의 코어 분기입니다. v2rayN, v2rayNG, v2flyNG는 설정 가져오기, 서버 선택, 프록시 진입점 관리를 위한 GUI를 제공합니다. GUI가 실행된다고 해서 코어까지 정상적으로 작동하는 것은 아닙니다. 연결 문제를 확인할 때는 코어 시작 로그도 살펴보세요. 설정의 사용 가능 여부는 코어가 해당 프로토콜과 세부 매개변수를 지원하는지에 달려 있으므로 클라이언트 이름만으로 판단할 수 없습니다.

Windows, macOS, Android, Linux에서는 어떤 클라이언트를 선택해야 하나요?

Windows, macOS, Linux 데스크톱에서는 v2rayN을 우선 고려하고, 프로세서 아키텍처와 설치 파일 형식에 맞는 버전을 선택하세요. Windows는 데스크톱 버전과 클래식 WPF 버전 중에서 고를 수 있습니다. macOS는 Apple Silicon과 Intel을 구분해야 하며, Linux는 아키텍처와 배포판 패키지 형식을 모두 확인해야 합니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어 환경이 필요하면 v2flyNG를 선택할 수 있습니다. 구독이 만료됐다고 오해하지 않도록 기존 설정의 프로토콜과 전송 방식부터 확인한 뒤 클라이언트를 고르세요.

클라이언트를 설치했는데 왜 구독이나 서버 설정이 필요한가요?

클라이언트는 연결을 관리하는 도구이며, 바로 사용할 수 있는 원격 서버가 포함되어 있지는 않습니다. 구독을 이용하면 서버 설정을 한곳에서 가져올 수 있고, 개별 공유 링크에는 보통 주소, 포트, 인증 정보, 전송 매개변수가 포함됩니다. 설치 후에는 직접 관리하거나 사용 권한이 있는 설정을 가져온 다음 사용할 서버를 선택해야 합니다. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 민감 정보로 취급하세요. 도움을 요청할 때 전체 주소나 QR 코드, 인증 정보가 보이는 스크린샷을 공개하지 마세요.

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

세 설정은 서로 다른 단계에서 작동합니다. 시스템 프록시는 해당 설정을 따르는 앱에 로컬 프록시 주소를 제공합니다. 전역 라우팅은 코어에 들어온 트래픽의 아웃바운드 경로를 결정하지만 모든 앱의 트래픽을 자동으로 가져오지는 않습니다. TUN은 가상 네트워크 인터페이스로 설정된 범위의 트래픽을 받아 처리합니다. 먼저 시스템 프록시와 기본 라우팅으로 연결을 확인하고, 필요에 따라 TUN을 설정하세요. 웹페이지 하나의 문제를 확인하려고 모든 기능을 한꺼번에 켜면 진입점, 규칙, 원격 연결 중 어디서 문제가 발생했는지 파악하기 어려워집니다.

설치 파일과 첫 설정 가져오기

설치 및 설정

기기에 맞는 아키텍처를 선택한 다음 구독을 가져오고 시스템 권한을 설정하세요.

구독 가져오기에 실패하거나 가져온 뒤 목록이 비어 있으면 무엇부터 확인해야 하나요?

먼저 구독 주소를 가져오는지 개별 공유 링크를 가져오는지 확인하고, 각각 구독 관리 또는 클립보드에서 가져오기에 해당하는 기능을 사용하세요. 복사한 문자열 앞뒤의 공백과 줄바꿈, 메신저에 붙은 안내 문구를 제거하고 구독 주소가 잘리지 않았는지 확인합니다. 구독 그룹을 저장한 뒤에는 구독 업데이트도 실행해야 합니다. 목록이 비어 있다면 그룹 필터와 업데이트 로그를 확인하세요. 로그인 페이지나 오류 페이지, 지원하지 않는 설정 형식이 반환된 경우에는 다시 붙여 넣어도 해결되지 않습니다. 접근 권한을 확인하거나 현재 클라이언트에 맞는 구독 형식을 받아야 합니다.

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

2015년 이후 출시된 대부분의 Android 스마트폰에서는 arm64를 우선 고려할 수 있지만, 최종적으로는 기기 프로세서와 시스템이 지원하는 앱 아키텍처를 확인해야 합니다. 아키텍처를 모르면 여러 아키텍처용 파일이 포함된 universal 패키지를 선택할 수 있습니다. 대신 파일 크기가 더 큰 편입니다. 설치할 수 없다는 메시지가 나오면 Android 버전 요구 사항, 저장 공간, 서명이 다른 동일 앱이 설치되어 있는지 확인하세요. 설치 출처를 바꾸기 전에 설정을 백업하고 앱을 바로 삭제하지 마세요. 설치에 성공하더라도 실제 실행과 연결을 확인해야 호환성을 판단할 수 있습니다.

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

Windows 데스크톱 버전은 새로운 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 기존 사용 방식에 익숙한 경우 적합합니다. 메뉴 위치와 일부 기능의 표시 방식이 다를 수 있습니다. 처음 사용하는 경우 다운로드 센터에서 데스크톱 버전을 선택하고, 이미 안정적인 작업 방식이 있다면 호환성을 고려해 WPF 버전을 선택하세요. 두 인스턴스가 동시에 시스템 프록시를 관리하거나 같은 포트를 수신하지 않도록 주의해야 합니다. 전환하기 전에 설정을 내보내고 기존 폴더를 보관하세요. 실행 시 런타임 환경이 없다는 메시지가 나오면 구독을 계속 바꾸지 말고 선택한 설치 파일 안내에 따라 필요한 구성 요소를 설치하세요.

Android에서 처음 연결할 때 VPN 권한 요청이 표시되면 어떻게 해야 하나요?

v2rayNG와 v2flyNG는 Android VPN 서비스를 통해 로컬 트래픽 진입점을 만들므로 처음 연결할 때 시스템 권한을 허용해야 합니다. 현재 사용 중인 클라이언트에서 나온 요청인지 확인한 후 허용하세요. 권한을 허용했다고 원격 서버 연결까지 완료된 것은 아닙니다. 권한을 허용한 직후 연결이 끊기면 다른 VPN 서비스가 연결을 점유하고 있는지, 시스템이 백그라운드 실행을 제한하는지 확인하세요. 기기가 조직의 관리 대상이거나 업무 프로필 정책이 적용되어 있다면 관리자가 권한을 제어할 수 있습니다. 클라이언트를 반복해서 재설치해 관리 제한을 우회하려고 하지 마세요.

프록시 진입점과 규칙

사용 팁

앱 트래픽이 코어에 들어오는지 확인한 뒤 라우팅 모드와 처리 범위를 정하세요.

시스템 프록시를 켰는데도 특정 앱이 프록시를 사용하지 않는 이유는 무엇인가요?

시스템 프록시는 시스템 프록시 설정을 따르는 앱에만 적용됩니다. 일부 앱은 별도의 네트워크 설정을 사용하며, 이미 연결된 세션은 기존 경로를 계속 사용할 수도 있습니다. 먼저 클라이언트 코어가 실행 중인지 확인하고, 시스템에 설정된 프록시 주소와 포트가 클라이언트의 로컬 진입점과 일치하는지 확인한 뒤 대상 앱을 다시 시작하세요. 브라우저에서 별도의 프록시 확장 프로그램을 사용한다면 설정이 서로 덮어쓰는지도 확인해야 합니다. 시스템 프록시를 따르지 않는 앱은 앱 자체의 프록시 설정을 사용하거나, 트래픽 처리 범위를 이해한 뒤 TUN을 설정할 수 있습니다. 전역 라우팅을 바꿔도 트래픽을 자동으로 가져오지는 않습니다.

전역, 중국 본토 우회, 규칙 모드 중 무엇을 선택해야 하나요?

일상적인 사용에서는 클라이언트가 제공하는 규칙 또는 중국 본토 우회 프리셋을 적용한 뒤 실제 사용 환경에 맞게 조정할 수 있습니다. 전역 모드는 보통 코어에 들어온 트래픽을 프록시 아웃바운드로 보내지만 프리셋의 예외 규칙이 적용될 수 있습니다. 중국 본토 우회는 도메인·주소 규칙과 관련 리소스를 바탕으로 일치하는 연결을 직접 연결합니다. 사용자 지정 규칙 모드는 규칙 순서에 따라 출구를 결정합니다. 클라이언트마다 모드 이름과 구체적인 동작이 다를 수 있으니 이름만 보지 말고 현재 규칙을 확인하세요. 모드를 바꾼 뒤에는 기존 연결을 재사용하지 말고 새 연결로 확인해야 오판을 줄일 수 있습니다.

TUN을 켤 때 권한 부족 메시지가 표시됩니다. 항상 관리자 권한으로 실행해야 하나요?

TUN은 가상 인터페이스를 만들고 관련 라우팅을 조정하므로 권한이 부족하면 로그에서 어떤 작업이 실패했는지 먼저 확인해야 합니다. Windows에서는 관리자 권한이나 클라이언트에서 제공하는 서비스 모드가 필요할 수 있습니다. macOS와 Linux에서는 클라이언트 안내에 따라 시스템 권한을 허용하세요. 계속해서 높은 권한으로 실행해야 하는지는 설치 방식과 서비스 설정에 따라 다르므로 일괄적으로 답할 수 없습니다. 먼저 TUN을 끄고 일반 프록시 진입점으로 연결되는지 확인한 다음 권한 문제와 인터페이스 충돌을 살펴보세요. 다른 VPN이나 가상 네트워크 어댑터 소프트웨어도 확인하되, 시스템 보호 기능 전체를 끄지는 마세요.

구독을 여러 개 관리하려면 어떻게 해야 하며, 업데이트할 때 직접 수정한 내용이 덮어써지지 않게 하려면 어떻게 해야 하나요?

출처별로 구독 그룹을 따로 만들고 알아보기 쉬운 이름을 지정하는 것이 좋습니다. 업데이트 전에 현재 그룹, 필터 조건, 활성 서버를 확인해 필터링된 목록을 업데이트 누락으로 오해하지 않도록 하세요. 구독을 업데이트하면 출처의 서버 항목이 다시 생성될 수 있으므로 구독 항목을 직접 수정해 사용자 지정 매개변수를 계속 보관하려고 하지 마세요. 별도로 조정해야 한다면 클라이언트가 지원하는 범위에서 로컬 설정으로 복사해 따로 관리하세요. 정기적으로 백업을 내보내고, 구독을 삭제하기 전에 로컬 항목도 그룹과 함께 삭제되는지 확인하세요.

증상별 문제 해결

문제 해결

기존 설정을 보존하고 로그와 교차 테스트로 원인을 좁히세요. 한 번에 조건 하나만 변경하세요.

노드 테스트 시간이 초과되면 어떤 순서로 확인해야 하나요?

먼저 기기 자체가 정상적으로 인터넷에 연결되는지 확인한 다음 코어가 정상적으로 시작됐는지, 로컬 포트를 다른 프로세스가 사용 중인지 살펴보세요. 이어서 서버 주소와 포트, 인증 매개변수, 전송 설정을 확인합니다. 기기의 시간이 맞지 않아도 보안 연결에 문제가 생길 수 있습니다. 테스트 시간 초과는 제한 시간 안에 테스트가 완료되지 않았다는 뜻일 뿐, 서버를 사용할 수 없다는 증거는 아닙니다. 테스트 방식에 따라 실제 웹 요청 경로와 결과가 다를 수도 있습니다. 사용 가능한 것으로 확인된 설정과 다른 네트워크로 교차 테스트하고, 로그를 통해 주소 조회 실패, 연결 거부, 인증서 오류, 원격 응답 시간 초과를 구분하세요.

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

연결됨 표시는 보통 로컬 서비스나 가상 인터페이스가 시작됐다는 뜻이며, 요청이 원격 서버에 도달했다는 의미는 아닙니다. 먼저 사용 가능한 서버를 선택했는지 확인하고, 웹페이지를 열 때 해당 연결이 로그에 기록되는지 살펴보세요. 기록이 없다면 앱의 진입점, 시스템 프록시, TUN의 트래픽 처리 범위를 확인해야 합니다. 기록은 있지만 실패한다면 아웃바운드 라우팅, DNS, 인증, 전송 매개변수를 확인하세요. 브라우저 하나로 확인 가능한 테스트 페이지에 접속하고 다른 프록시 도구는 잠시 중지한 뒤 한 번에 설정 하나만 변경하세요. 처음부터 모든 설정을 초기화하면 원인 파악에 필요한 단서가 사라질 수 있습니다.

잘 업데이트되던 구독이 갑자기 업데이트되지 않으면 어떻게 해야 하나요?

먼저 업데이트 로그를 확인해 연결 시간 초과, 주소 조회 실패, 접근 거부, 응답 내용 해석 실패 중 어떤 오류인지 파악하세요. 구독이 만료됐는지, 주소가 바뀌었는지, 기기 시간이 정확한지도 확인합니다. 구독 주소에 접근할 때 기존 프록시가 필요한 경우 클라이언트에서 해당 옵션을 제공한다면 프록시를 통해 업데이트할 수 있습니다. 다만 사용 가능한 활성 서버가 있어야 합니다. 직접 연결로 접근할 수 있다면 굳이 우회할 필요는 없습니다. 아직 사용할 수 있는 기존 항목을 먼저 삭제하지 말고, 전체 구독 주소를 공개 게시판에 올리지 마세요. 오류 유형을 기록하고 구독 제공처에 접근 상태를 확인하세요.

DNS 오류가 나거나 일부 도메인이 열리지 않을 때 바로 FakeDNS를 켜야 하나요?

FakeDNS를 만능 해결책처럼 사용해서는 안 됩니다. 먼저 시스템 DNS, 브라우저의 보안 DNS, 코어 DNS를 구분해 어느 단계에서 실패하는지 확인하고, 현재 DNS 서버에 예정된 아웃바운드 경로로 접근할 수 있는지 살펴보세요. 일부 도메인만 실패한다면 도메인 규칙과 해석 정책, 만료된 캐시가 있는지도 확인해야 합니다. FakeDNS는 주소 매핑에 사용할 가상 주소를 반환하므로 트래픽 처리와 라우팅 설정이 함께 필요합니다. 단독으로 켜면 새로운 문제가 생길 수 있습니다. 먼저 동작을 이해할 수 있는 기본 DNS 설정을 복구한 뒤 TUN 등 실제 사용 환경에 맞춰 하나씩 설정하고 확인하세요.