CLIENT / CONFIGURATION / DIAGNOSIS
V2Ray 자주 묻는 질문
구독·연결·프록시 문제 해결
설치 파일, 구독 내용, 트래픽 유입 방식, 라우팅 규칙을 구분한 뒤 증상에 따라 점검하세요. 아래 안내는 Android용 v2rayNG와 데스크톱용 v2rayN을 다룹니다. 설정 이름은 버전에 따라 조금 다를 수 있습니다.
기본 이해
클라이언트, 코어, 설정의 역할부터 확인하세요.
v2rayNG, v2rayN, v2flyNG 중 어떤 클라이언트를 선택해야 하나요?
Android에서는 보통 Xray 코어를 사용하는 v2rayNG를 선택합니다. V2Fly 코어 설정이 필요하다면 v2flyNG를 고려하세요. Windows, macOS, Linux 데스크톱에서는 v2rayN을 선택하면 됩니다. 클라이언트는 설정을 가져오고 편집해 실행하며, 코어는 연결과 라우팅을 처리합니다. 두 구성 요소는 서로 다른 역할을 합니다. 먼저 운영체제를 확인한 다음 서버에서 요구하는 프로토콜, 전송 방식, 보안 계층을 확인하세요. 이름이 비슷하다는 이유만으로 설정을 서로 바꿔 쓸 수 있다고 판단하면 안 됩니다. 클라이언트 설치 파일은 다운로드 페이지에서 확인할 수 있으며, 코어 기능과 프로토콜 차이는 프로토콜 가이드를 참고하세요.
클라이언트를 설치했는데 사용할 연결 설정이 없는 이유는 무엇인가요?
클라이언트 설치 파일에는 그래픽 인터페이스와 실행에 필요한 구성 요소가 포함되어 있지만, 원격 서버 주소나 접속 자격 증명이 자동으로 만들어지지는 않습니다. 사용 권한이 있는 구독 URL, 개별 공유 링크 또는 전체 설정 파일을 먼저 받아 해당 클라이언트로 가져와야 합니다. 가져온 뒤 주소, 포트, 프로토콜, 보안 계층이 모두 입력되었는지 확인하고, 사용할 설정을 선택해 연결을 시작하세요. 화면에 설정 항목이 표시되는 것은 구문 분석에 성공했다는 뜻일 뿐, 원격 서버에 접속할 수 있다는 의미는 아닙니다. 이 사이트에서는 클라이언트 다운로드와 설정 안내를 제공하며, 연결 서비스의 사용 가능 여부는 설정 제공자에게 확인해야 합니다.
V2Ray 구독 URL과 개별 공유 링크는 어떻게 다른가요?
구독 URL은 보통 클라이언트가 설정 목록을 가져오는 HTTPS 주소이며, 업데이트할 때마다 해당 주소에 다시 요청을 보냅니다. 개별 공유 링크는 대개 vmess://, vless://, trojan:// 또는 ss://로 시작하며 연결 설정 하나를 나타냅니다. Base64 구독은 여러 공유 링크를 묶어 인코딩한 형식인 경우가 많으며, 별도의 프록시 프로토콜은 아닙니다. 구독 URL은 구독 그룹에 입력하고, 개별 링크는 클립보드 가져오기 등의 메뉴로 추가하세요. 구독 URL을 일반 공유 링크처럼 붙여 넣으면 클라이언트에서 지원하지 않는 형식이라고 표시될 수 있습니다. 브라우저의 로그인 페이지 주소를 구독 URL로 착각하지 않도록 주의하세요.
시스템 프록시, 전역 라우팅, Android VPN 모드는 같은 기능인가요?
아닙니다. 시스템 프록시는 해당 설정을 따르는 앱이 요청을 로컬 프록시로 보내도록 합니다. 전역 라우팅은 코어에 전달된 요청을 어떤 아웃바운드로 보낼지 결정합니다. Android VPN 모드는 시스템 VPN 인터페이스를 통해 트래픽을 가져옵니다. 라우팅을 전역으로 바꿔도 모든 데스크톱 프로그램이 시스템 프록시를 사용하게 되는 것은 아닙니다. Android VPN을 켰다고 모든 요청이 원격 프록시를 거치는 것도 아니며, 라우팅과 앱별 설정을 함께 확인해야 합니다. 문제를 점검할 때는 먼저 앱 트래픽이 클라이언트로 들어오는지 확인한 다음 규칙에 따라 어디로 전달되는지 살펴보세요. 데스크톱 TUN은 별도의 트래픽 유입 방식이므로 라우팅 프리셋과 혼동하지 마세요.
설치 및 설정
설치 패키지 아키텍처, 가져오기 메뉴, 시스템 권한부터 확인하세요.
Android APK는 arm64와 universal 중 무엇을 선택해야 하나요?
최신 Android 휴대전화 대부분은 arm64를 선택할 수 있지만, 최종적으로는 시스템에서 지원하는 앱 ABI를 기준으로 판단해야 합니다. 프로세서의 홍보 명칭이나 구입 연도만으로 결정하지 마세요. 먼저 기기 사양을 확인하고, 그래도 알기 어렵다면 여러 아키텍처에 필요한 구성 요소를 포함하는 universal을 선택하세요. 설치 파일은 보통 더 큽니다. 64비트 프로세서를 사용하더라도 32비트 앱만 지원하는 시스템이 설치된 기기라면 arm64 패키지를 설치하지 못할 수 있습니다. 패키지 비호환 오류가 표시되면 아키텍처와 최소 시스템 요구 사항을 확인하세요. 서명 충돌 오류라면 기존 앱의 설치 경로를 별도로 확인하고, 아키텍처를 바꿔 가며 덮어쓰기를 반복하지 마세요.
v2rayNG에서 구독 URL은 어디에 입력하나요?
v2rayNG 사이드 메뉴를 열고 구독 그룹 설정으로 이동한 뒤, 추가 메뉴에서 메모와 구독 URL을 입력하세요. 저장하고 설정 목록으로 돌아와 메뉴에서 구독 업데이트를 실행하면 됩니다. 메뉴 이름은 버전에 따라 조금 다를 수 있지만, 먼저 그룹을 저장하고 구독 내용을 요청하는 순서는 같습니다. 붙여 넣기 전에 주소 앞뒤에 공백이나 줄바꿈, 메신저가 덧붙인 문장 부호가 없는지 확인하고 기존 URL 매개변수는 그대로 두세요. 업데이트가 끝나면 해당 그룹에서 설정을 선택해 연결을 시작하세요. 웹페이지 전체 내용을 주소 입력란에 붙여 넣거나 구독 자격 증명을 공개 게시판에 올리지 마세요. 자세한 절차는 입문 가이드를 참고하세요.
가져올 때 형식이 잘못되었거나 지원하지 않는다는 오류가 표시되면 무엇부터 확인해야 하나요?
먼저 입력한 내용이 구독 URL인지, 개별 공유 링크인지, 전체 설정 파일인지 확인하고 해당 형식에 맞는 메뉴를 사용하세요. v2rayNG와 v2rayN의 클립보드 가져오기는 인식 가능한 공유 정보를 불러오는 기능이며, 모든 구독 형식을 변환하는 도구는 아닙니다. 복사할 때 코드 블록 표시와 설명 문구를 제거하고 링크 매개변수는 모두 유지하세요. QR 코드는 내용이 잘리거나 흐릿하지 않은지 확인합니다. 응답이 로그인 페이지, 오류 페이지 또는 다른 설정 체계의 파일이라면 다운로드에 성공했더라도 현재 형식으로 구문 분석할 수 없습니다. 형식을 확인한 뒤 클라이언트와 코어가 해당 프로토콜 및 전송 방식 조합을 지원하는지 살펴보세요. 링크 접두사를 한꺼번에 바꾸지는 마세요.
VPN 또는 TUN을 켤 때 권한 부족 오류가 발생하면 어떻게 해야 하나요?
Android에서 v2rayNG VPN 모드를 시작할 때 시스템에 표시되는 VPN 연결 요청을 승인해야 합니다. 요청을 거부했다면 연결을 다시 시작해 권한을 허용하고, 다른 VPN이나 상시 연결 VPN 정책이 인터페이스를 사용 중인지 확인하세요. 데스크톱 v2rayN의 TUN 모드는 가상 인터페이스와 시스템 라우팅을 사용하므로 필요한 권한은 운영체제, 설치 방식, 버전에 따라 다릅니다. 관리자 권한이나 관련 보조 서비스가 필요할 수 있습니다. 먼저 로그에 표시된 구체적인 오류를 확인하고 클라이언트 안내에 따라 권한을 설정하세요. 항상 최고 권한으로 실행하는 것을 만능 해결책으로 여기거나 시스템 보안 기능을 함부로 끄지 마세요.
사용 팁
앱의 트래픽 유입 방식을 확인한 뒤 요청의 아웃바운드를 조정하세요.
v2rayN에서 시스템 프록시를 설정했는데 일부 앱에서만 작동하는 이유는 무엇인가요?
시스템 프록시는 해당 설정을 읽는 앱에만 적용됩니다. 별도의 프록시 설정을 사용하는 프로그램도 있고, 프록시를 거치지 않고 직접 연결하는 프로그램도 있습니다. 먼저 v2rayN 코어가 실행 중인지, 시스템 프록시 설정을 적용했는지 확인하고 시스템 프록시 포트가 클라이언트의 로컬 수신 포트와 일치하는지 살펴보세요. 브라우저에 프록시 확장 프로그램이 설치되어 있다면 일단 사용 중지하거나 설정을 통일하세요. 터미널은 보통 환경 변수를 별도로 설정해야 합니다. 앱 하나에서 작동하지 않는다는 이유로 원격 설정부터 바꾸지는 마세요. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 모드를 검토하고 권한, 라우팅, DNS가 사용 환경에 맞는지 확인하세요.
터미널에서 v2rayN의 로컬 프록시를 사용하려면 어떻게 해야 하나요?
먼저 클라이언트 설정에서 실제 로컬 HTTP 또는 SOCKS 수신 주소와 포트를 확인한 다음 터미널 도구 문서에 따라 프록시를 설정하세요. 일반적인 도구는 http_proxy, https_proxy 또는 ALL_PROXY를 읽지만, 프로그램마다 변수 대소문자와 프로토콜 지원 방식이 다릅니다. 변수 값은 이 기기에서 실제로 수신 중인 프록시를 가리켜야 합니다. HTTPS 요청이 HTTP 프록시를 사용한다면 보통 http:// 형식으로 입력합니다. 대상 URL이 HTTPS라는 이유만으로 https://로 바꾸지 마세요. 설정을 변경한 뒤 같은 터미널 세션에서 테스트하고, 프록시를 사용하지 않을 때는 변수도 함께 제거하세요. 다른 사람이 사용하는 포트를 그대로 복사하거나 원격 서버 포트를 로컬 프록시 포트로 착각하지 마세요.
앱별 프록시를 켜면 어떤 앱이 클라이언트를 거치나요?
v2rayNG 설정에서 앱별 프록시를 켠 뒤, 현재 선택된 모드에 대한 설명을 먼저 읽고 목록이 선택한 앱만 프록시 처리하는 방식인지, 선택한 앱을 제외하는 방식인지 확인하세요. 버전에 따라 표시 방식이 다를 수 있으므로 체크 표시만 보고 판단하면 안 됩니다. 설정을 저장한 후 VPN 연결을 다시 시작해 새 앱 범위를 적용하고 대상 앱으로 접속을 테스트하세요. 앱별 설정은 어떤 앱의 트래픽을 프록시 처리할지 정하며, 라우팅 규칙은 해당 요청을 어느 아웃바운드로 보낼지 결정합니다. 브라우저는 정상인데 다른 앱에서 문제가 생긴다면 대상 앱이 제외되어 있는지, 범위에 포함되지 않은 다른 서비스 구성 요소에 의존하는지 먼저 확인하세요.
라우팅 규칙과 DNS를 함께 바꿔야 하나요?
두 설정은 따로 조정하고 한 번에 하나의 변수만 바꾸는 것이 좋습니다. 라우팅 규칙은 요청의 전달 경로를 결정하고, DNS는 이름을 해석합니다. domainStrategy는 라우팅 일치 여부를 판단할 때 도메인을 언제 해석할지에 영향을 줍니다. 현재 작동하는 설정을 기록하고 사용 중인 라우팅 프리셋과 규칙 순서를 확인한 뒤 이름 해석 문제를 점검하세요. 특정 사이트가 느리다는 이유로 로컬 DNS를 켜고, DNS 주소를 바꾸고, 규칙 순서까지 한꺼번에 변경하면 어떤 조치가 효과가 있었는지 알기 어렵습니다. geosite 또는 geoip 규칙을 사용한다면 리소스 파일을 사용할 수 있는지도 확인하세요. 효과를 비교하려면 같은 앱과 대상, 비슷한 네트워크 환경에서 테스트하고 원래 설정으로 되돌릴 수 있도록 기록해 두세요.
문제 해결
사용 가능한 설정은 보존하고 로그를 바탕으로 오류가 발생한 단계를 찾으세요.
구독 업데이트는 실패했지만 기존 설정으로는 연결됩니다. 어떻게 해야 하나요?
구독 업데이트와 기존 설정을 통한 연결은 서로 다른 요청 경로를 사용할 수 있으므로 한쪽만 성공하거나 실패할 수 있습니다. 기존 설정을 보존한 상태에서 구독 URL이 만료되었는지, 접속 자격 증명이 바뀌었는지, 기기의 날짜와 시간이 정확한지 확인하세요. 그런 다음 로그를 살펴 이름 해석 실패, 연결 시간 초과, 인증서 오류, HTTP 상태 오류를 구분합니다. 접속이 거부되었거나 주소가 더 이상 유효하지 않다면 구독 제공자에게 문의하세요. 클라이언트에 프록시를 통해 구독을 업데이트하는 옵션이 있다면 현재 네트워크에서 직접 연결할 수 있는지, 기존의 사용 가능한 연결을 이용해야 하는지 확인한 뒤 선택하세요. 새 구독 내용을 받기 전에 구독 그룹 전체를 삭제하거나 전체 구독 URL을 공개 로그에 붙여 넣지 마세요.
서버 테스트가 시간 초과되면 서버를 사용할 수 없다는 뜻인가요?
반드시 그렇지는 않습니다. 테스트에 따라 TCP 연결, 전체 프록시 요청, 특정 웹사이트 접속 등을 확인하므로 시간 초과가 발생한 단계도 다를 수 있습니다. 먼저 어떤 종류의 테스트인지 확인한 다음 접속 가능한 것으로 알려진 URL을 직접 열어 보고 같은 시각의 로그를 확인하세요. 서버 주소와 포트가 정확한지, 기기 시간이 맞는지, 현재 네트워크에서 해당 연결 방식을 허용하는지 점검하고 가능하다면 다른 네트워크에서도 테스트하세요. TCP 연결에 성공해도 인증, TLS 또는 전송 협상이 성공했다는 의미는 아닙니다. 한 번의 테스트 결과를 영구적인 상태로 간주하거나 테스트 시간 초과 값을 계속 줄이지 마세요. 여러 네트워크에서 같은 오류가 발생하면 설정 제공자에게 서버 상태와 매개변수를 확인하세요.
클라이언트에 연결됨으로 표시되는데 웹페이지가 열리지 않으면 어떤 순서로 점검해야 하나요?
연결됨 표시는 보통 로컬 서비스나 VPN 인터페이스가 시작되었다는 뜻이지, 원격 접속까지 확인되었다는 의미는 아닙니다. 먼저 의도한 설정을 선택했는지 확인한 다음 대상 앱이 로컬 프록시를 사용하는지 살펴보세요. Android에서는 VPN과 앱별 적용 범위를, 데스크톱에서는 시스템 프록시, 브라우저 확장 프로그램, 터미널의 별도 설정을 확인합니다. 이어 로그에서 DNS 해석, 인증, TLS 협상, 원격 연결 오류를 구분하고 라우팅 규칙이 대상을 예상한 아웃바운드로 보내는지 확인하세요. 다른 앱과 URL로 교차 테스트해 특정 사이트의 문제를 전체 장애로 오해하지 않도록 합니다. 한 번에 한 항목만 변경하고 결과를 기록하세요. 구독, DNS, 라우팅 프리셋을 동시에 바꾸지 마세요.
화면을 잠근 뒤 한동안 지나면 연결이 끊기거나 네트워크 복구 후 다시 연결되지 않을 때는 어떻게 해야 하나요?
먼저 화면 잠금, Wi-Fi와 모바일 네트워크 전환, 시스템의 백그라운드 앱 정리 중 어느 상황에서 문제가 발생하는지 확인하세요. Android에서는 시스템 앱 설정에서 v2rayNG의 배터리 정책, 백그라운드 실행, 백그라운드 데이터 권한을 확인하고 기기에서 제공하는 옵션에 따라 필요한 백그라운드 활동을 허용하세요. 모든 앱의 제한을 풀 필요는 없습니다. 시스템 VPN 상태가 유지되는지 확인한 뒤 연결을 중지하고 다시 시작해 보세요. 네트워크 전환 후에만 실패한다면 연결 복구 시점의 로그를 기록하세요. 데스크톱에서는 절전 모드에서 깨어난 뒤 네트워크와 로컬 코어 상태를 확인합니다. 자주 재시작하는 것만으로는 원인을 찾기 어려우므로 배터리 정책과 네트워크 환경을 바꿔 가며 재현 조건을 비교하세요.