클라이언트 사용 FAQ

v2rayN 자주 묻는 질문

구독 가져오기부터 연결 문제 해결까지, 증상별 조치 방법을 확인하세요. 데스크톱 클라이언트는 v2rayN을 중심으로 설명하며, Android 안내는 v2rayNG와 v2flyNG의 일반적인 사용 사례에도 적용됩니다.

먼저 문제가 발생한 단계를 확인한 다음 항목별로 점검하세요. 버전에 따라 메뉴 위치가 다를 수 있으므로 아래 안내에서는 설정 이름과 실제 기능을 기준으로 설명합니다.

기초 지식

클라이언트와 구독, 트래픽 연결 방식을 먼저 구분한 뒤 기기에 맞는 설정 방법을 선택하세요.

v2rayN, v2rayNG, v2flyNG 중 어떤 클라이언트를 선택해야 하나요?

Windows, macOS, Linux에서는 v2rayN을 사용하고, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려할 수 있습니다. V2Fly 코어를 사용하는 v2flyNG도 대안입니다. 클라이언트는 설정을 관리하고 코어를 실행해 프록시 연결을 제공하지만, 사용할 수 있는 구독을 자동으로 만들어 주지는 않습니다. 선택하기 전에 기기 플랫폼을 확인하고, 구독에서 사용하는 프로토콜과 전송 방식이 해당 클라이언트에서 지원되는지 확인하세요. 세 프로그램은 설정 폴더와 인터페이스가 다르므로, 옮길 때는 데이터 파일을 덮어쓰지 말고 구독을 새로 가져오는 편이 안전합니다.

클라이언트를 설치한 뒤 연결하려면 무엇을 더 준비해야 하나요?

신뢰할 수 있고 유효한 구독 주소나 완전한 서버 설정이 필요합니다. 구독에는 보통 서버 주소와 포트, 프로토콜, 인증 정보가 포함되며, 클라이언트는 이 정보를 읽어 사용합니다. 설치가 끝나면 설정을 가져오고 서버를 선택한 다음, 시스템 프록시 또는 Android VPN 연결을 설정해 접속을 확인하세요. 프로그램 설치가 완료되어도 서버를 사용할 수 있다는 뜻은 아닙니다. 설정을 아직 받지 못했다면 제공자에게 받는 방법을 문의하세요. 출처가 불분명한 설정을 테스트에 사용하지 말고, 공개 스크린샷에 구독 주소가 노출되지 않도록 주의하세요.

구독 주소와 개별 서버 공유 링크는 어떻게 다른가요?

구독 주소는 여러 설정을 가져오는 경로로, 업데이트하면 서버가 추가·삭제되거나 변경될 수 있습니다. 개별 서버 공유 링크에는 보통 서버 설정 하나만 담겨 있어 구독과 함께 자동으로 바뀌지 않습니다. 가져오기 전에 받은 것이 웹페이지 주소인지, 구독 주소인지, 프로토콜 공유 링크인지 확인하세요. 구독 주소는 구독 그룹의 주소 입력란에 넣고, 공유 링크는 클라이언트의 클립보드 가져오기 기능을 이용하면 됩니다. 계정 관리 페이지는 구독 주소를 대신할 수 없습니다. 복사할 때 앞뒤 공백이나 줄바꿈이 포함되지 않았는지도 확인하세요. 구독 주소에 포함된 인증 정보는 민감한 정보이므로 계정 자격 증명처럼 안전하게 보관해야 합니다.

시스템 프록시와 TUN 모드는 각각 어떤 앱에 영향을 주나요?

시스템 프록시는 운영체제 설정에 프록시 연결 정보를 등록해 해당 설정을 따르는 브라우저와 앱에서 사용하게 합니다. 앱이 자체적으로 연결하거나 별도의 프록시를 설정한 경우에는 영향을 받지 않을 수 있습니다. TUN 모드는 가상 네트워크 인터페이스로 트래픽을 받아 더 많은 앱에 적용할 수 있지만, 라우팅과 DNS, 시스템 권한이 함께 작동합니다. 어느 방식이든 모든 요청이 반드시 프록시를 거치는 것은 아니며, 최종 연결 경로는 분할 라우팅 규칙의 영향을 받습니다. 처음 설정할 때는 시스템 프록시로 연결을 확인한 뒤 필요에 따라 TUN을 켜세요. 여러 네트워크 설정을 한꺼번에 바꾸면 원인을 찾기 어려워질 수 있습니다.

프로토콜과 코어 이름을 확인하려면 용어집을 참고하세요.

설치 및 설정

기기 아키텍처에 맞는 설치 파일을 고르고 구독을 업데이트한 뒤 필요한 권한을 설정하세요.

구독을 가져오지 못하거나 주소를 저장해도 서버가 표시되지 않으면 어떻게 해야 하나요?

먼저 계정 로그인 페이지나 결제 페이지가 아닌 전체 구독 주소를 복사했는지 확인하고, 앞뒤 공백을 제거하세요. 구독 그룹에 주소를 추가하고 저장한 뒤에는 전체 구독 업데이트도 실행해야 합니다. 저장만으로 서버 목록이 바로 생성되지는 않습니다. 형식을 인식할 수 없다는 메시지가 나오면 응답 내용이 로그인 페이지나 오류 페이지인지, 또는 현재 클라이언트에서 지원하지 않는 설정 형식인지 확인하세요. 같은 주소를 반복해서 붙여넣기만 하지 마세요. 일부 설정만 나타나지 않으면 로그의 파싱 메시지를 확인하고 제공자에게 호환되는 형식을 문의하세요. 문제를 문의할 때는 오류 유형만 설명하고 인증 정보가 포함된 전체 주소를 공개하지 마세요.

Android 설치 파일은 arm64와 universal 중 어떤 것을 선택해야 하나요?

2015년 이후 출시된 주요 Android 스마트폰은 arm64를 우선 선택해도 되는 경우가 많지만, 실제로는 기기에서 지원하는 앱 아키텍처를 기준으로 선택해야 합니다. universal은 여러 아키텍처를 포함해 파일 크기가 더 큰 편이며, 기기 아키텍처를 모르거나 여러 기기에서 호환성이 필요할 때 적합합니다. arm64 설치 시 호환되지 않는다는 메시지가 나오면 시스템과 프로세서 정보를 확인한 뒤 universal 버전을 시도해 보세요. 일부 기기는 프로세서가 64비트를 지원해도 시스템 환경에 제한이 있을 수 있습니다. 설치 파일을 분석할 수 없다는 오류가 나면 시스템 버전이 요구 사항을 충족하는지도 확인하세요. 모든 설치 실패를 아키텍처 선택 탓으로만 돌릴 수는 없습니다.

v2rayN 데스크톱 버전과 기존 WPF 버전은 서로 바로 바꿔 사용할 수 있나요?

데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 기존 WPF 버전은 Windows용입니다. 인터페이스 구성과 종속 항목, 일부 설정 메뉴가 다를 수 있습니다. 버전을 바꾸기 전에 클라이언트의 내보내기 또는 백업 기능으로 설정을 저장하고, 구독 그룹과 라우팅, 로컬 포트를 기록해 두세요. 기존 클라이언트를 종료한 다음 다른 버전을 실행해 프록시 포트가 충돌하지 않도록 합니다. 두 버전의 파일을 임의로 섞어 덮어쓰거나, 이전할 설정이 정상인지 확인하기 전에 기존 데이터를 삭제하지 마세요. 새 버전을 처음 실행한 뒤 시스템 프록시와 서버를 다시 확인하고 연결이 정상일 때 이전 폴더를 정리하세요.

TUN을 켤 때 권한이 부족하다는 메시지가 나오면 어떻게 해야 하나요?

Windows에서는 클라이언트를 종료한 뒤 관리자 권한으로 실행하고 TUN을 다시 켜세요. macOS와 Linux의 권한 부여 방법은 클라이언트 버전과 시스템 환경에 따라 다르므로 현재 화면의 안내에 따라 승인하세요. 설정 폴더 전체의 권한을 무분별하게 낮추지 마세요. 권한을 승인한 뒤에도 실패하면 로그에 가상 인터페이스 생성 실패, 드라이버 문제, 포트 사용 중 등의 메시지가 있는지 확인하고 다른 VPN 또는 TUN 프로그램이 실행 중인지 살펴보세요. 테스트할 때는 네트워크를 제어하는 도구를 하나만 사용하세요. 실패하면 TUN을 끄고 일반 네트워크 연결을 복구한 뒤 원인을 확인하세요.

설치 파일은 다운로드 페이지에서 확인하고, 처음 설정할 때는 설정 가이드를 따라 진행하세요.

고급 활용

불필요한 설정 변경을 줄이고 앱의 프록시 연결 경로를 명확히 하면 분할 라우팅을 쉽게 확인할 수 있습니다.

구독을 업데이트하면 직접 수정한 서버 설정도 덮어쓰나요?

구독의 서버 정보는 제공자가 관리하며 업데이트할 때 다시 생성될 수 있습니다. 구독 항목에 직접 수정한 값을 계속 보관할 수 있다고 기대하지 마세요. 특정 매개변수를 테스트하려면 해당 설정을 별도의 수동 항목으로 복사하고, 구독 원본과 테스트 항목을 구분할 수 있도록 알아보기 쉬운 메모를 붙이세요. 업데이트 전에 현재 설정을 백업해 두면 실수로 변경했을 때 복구하기 쉽습니다. 같은 항목을 매번 수정해야 한다면 업데이트 후 반복해서 고치기보다 제공자에게 원래 설정이 잘못되었는지 먼저 확인하세요. 그룹 수준 설정과 서버 필드는 유지 방식이 다를 수 있으므로 현재 버전에서 실제로 어떻게 처리되는지 확인해야 합니다.

시스템 프록시의 자동 설정, 초기화, 변경 안 함은 각각 언제 사용하나요?

브라우저 등에서 클라이언트의 프록시를 사용하려면 시스템 프록시 자동 설정을 선택하세요. 사용을 잠시 중단하거나 클라이언트를 종료할 때는 시스템 프록시 초기화를 선택하면 됩니다. 다른 도구가 시스템 프록시를 관리하고 있을 때만 변경 안 함을 고려하세요. 변경 안 함은 직접 연결을 뜻하지 않고, 현재 시스템 설정을 그대로 유지한다는 뜻입니다. 이전 프록시 주소가 계속 사용될 수도 있습니다. 설정을 바꾼 뒤에는 운영체제의 프록시 설정에서 실제 연결 정보를 확인하세요. 클라이언트를 종료했는데도 브라우저가 열리지 않으면 로컬 포트를 가리키는 프록시가 남아 있는지 확인하고 더 이상 사용하지 않는 설정을 초기화하세요.

브라우저에서는 접속되지만 터미널 도구가 프록시를 사용하지 않으면 어떻게 해야 하나요?

브라우저와 터미널 도구는 서로 다른 프록시 설정을 사용할 수 있습니다. 브라우저 접속이 된다는 사실만으로 브라우저의 연결 경로가 정상임을 알 수 있을 뿐입니다. 먼저 터미널 도구가 시스템 프록시를 지원하는지 확인하세요. 지원하지 않는다면 해당 도구의 문서를 참고해 프록시 매개변수나 http_proxy, https_proxy 등의 환경 변수를 설정하세요. 주소에는 클라이언트가 실제로 수신 중인 로컬 주소와 포트를 입력하고 HTTP 또는 SOCKS 유형을 맞춰야 합니다. 다른 기기의 값을 그대로 복사하지 마세요. 환경 변수는 현재 세션이나 새로 실행한 프로세스에만 적용되는 경우가 많습니다. 테스트가 끝나면 임시 설정을 지워 클라이언트를 종료한 뒤에도 터미널이 이전 포트에 연결을 시도하지 않도록 하세요.

다른 분할 라우팅 규칙은 유지하면서 로컬 네트워크 주소만 직접 연결하려면 어떻게 하나요?

라우팅 규칙에 geoip:private를 direct로 보내는 항목이 있는지 확인하고, 이 항목이 먼저 적용될 수 있는 광범위한 규칙보다 앞에 있는지 살펴보세요. 이 규칙은 주로 사설 IP 주소에 적용되며 모든 내부 도메인이 포함되는 것은 아닙니다. 내부 도메인으로 접속할 때는 DNS가 올바른 내부 IP 주소를 반환하는지도 확인하세요. 규칙을 저장한 뒤 라우터 관리 페이지, 프린터 또는 내부 서비스에 다시 접속해 보세요. 여전히 접속되지 않으면 프록시를 잠시 끄고 기본 네트워크가 정상인지 확인한 다음, 앱에 별도의 프록시가 지정되어 있는지 살펴보세요. 하나의 로컬 네트워크 서비스 문제를 해결하려고 전체 분할 라우팅 규칙을 삭제하지 마세요.

문제 해결

구독 요청, 서버 연결, 앱 연결 순서로 범위를 좁혀 확인하고 모든 문제를 서버 오류로 단정하지 마세요.

구독이 전에는 업데이트됐는데 지금은 실패한다면 무엇부터 확인해야 하나요?

먼저 요청 시간 초과, 인증 실패, 콘텐츠 파싱 실패 중 어떤 유형인지 구분하세요. 시간 초과가 발생하면 로컬 네트워크와 구독 도메인의 DNS 확인 상태를 점검하고, 업데이트 요청이 직접 연결인지 기존 프록시를 거치는지 확인하세요. 기존 서버가 이미 작동하지 않는다면 그 서버를 통해 업데이트할 수 없습니다. 인증에 실패하면 구독이 만료됐는지, 주소가 재설정됐는지 확인하세요. 파싱에 실패하면 제공자가 형식을 변경했는지 확인해야 합니다. 짧은 시간에 반복해서 요청하지 마세요. 서버에서 요청을 제한할 수 있습니다. 새 구독 주소를 받아야 한다면 주소를 저장한 뒤 다시 업데이트하고, 제공자에게는 인증 정보를 제거한 오류 내용만 전달하세요.

서버 테스트가 시간 초과되면 모든 서버를 사용할 수 없다는 뜻인가요?

한 번의 테스트에서 시간 초과가 발생했다는 것은 해당 요청이 제한 시간 안에 완료되지 않았다는 뜻일 뿐, 전체 설정이 모두 작동하지 않는다는 의미는 아닙니다. 먼저 기기 시간이 정확한지 확인한 뒤 같은 그룹의 다른 서버로 실제 접속을 테스트하세요. 한 항목만 실패한다면 주소와 포트, 전송 매개변수를 확인하세요. 모든 항목이 실패한다면 로컬 네트워크와 구독 유효 기간, 코어 시작 로그, 방화벽 메시지를 우선 확인하세요. 일부 테스트 대상에 접근할 수 없어도 시간 초과가 발생할 수 있으므로 클라이언트에서 지원하는 다른 테스트 방법으로 교차 확인해 보세요. 연결 문제를 조사하는 동안 시스템 보호 기능을 장시간 끄지 마세요.

연결됨으로 표시되지만 웹페이지가 열리지 않거나 시스템 프록시가 작동하지 않으면 어떻게 해야 하나요?

연결됨 표시는 보통 로컬 서비스나 Android VPN 인터페이스가 시작됐다는 뜻이며, 원격 서버에 접속할 수 있음을 보장하지는 않습니다. 먼저 TUN을 끄고 연결 방식을 하나만 유지한 뒤 현재 서버와 로컬 수신 포트를 확인하세요. 시스템 프록시가 해당 포트를 가리키는지도 점검합니다. 브라우저에서 별도의 프록시 확장 프로그램을 사용하고 있다면 잠시 끄고 페이지를 다시 여세요. 네트워크 연결은 유지되지만 도메인만 열리지 않는다면 DNS를 확인하세요. 모든 요청이 실패하면 코어 로그에서 인증, 핸드셰이크 또는 연결 오류를 살펴보세요. Android에서는 앱별 프록시 목록을 확인해 브라우저가 제외되지 않았는지도 점검해야 합니다.

Android에서 백그라운드로 전환한 뒤 연결이 끊기면 시스템 제한과 서버 문제를 어떻게 구분하나요?

먼저 화면을 잠그거나 앱을 전환한 뒤에만 연결이 끊기는지 확인하세요. 앱을 사용할 때는 정상인데 백그라운드에서 자주 중단된다면 시스템이 클라이언트의 백그라운드 활동이나 배터리 사용을 제한하는지 살펴보고, 기기 설정에서 필요한 백그라운드 실행을 허용하세요. VPN 권한이 유효한지, 다른 VPN 앱이 현재 연결을 대체하지 않았는지도 확인해야 합니다. Wi-Fi와 모바일 데이터 사이를 전환할 때만 실패한다면 클라이언트에서 다시 연결하고 로그를 확인한 뒤 다른 서버도 테스트하세요. 백그라운드 제한과 서버 문제는 동시에 발생할 수 있으므로 각각 따로 확인하세요. 배터리, DNS, 라우팅, 서버 설정을 한꺼번에 바꾸지 않는 것이 좋습니다.

증상별로 더 자세히 확인하려면 문제 해결 가이드를 참고하세요. 브라우저나 터미널에서만 문제가 발생한다면 시스템 프록시가 작동하지 않을 때: 브라우저와 터미널별 점검 방법을 확인하세요.