HELP / CLIENT CONFIGURATION
v2rayN 자주 묻는 질문과 연결 문제 해결
구독 가져오기, 시스템 프록시, TUN 설정을 문제 발생 단계에 따라 확인하세요.
설정 가져오기, 로컬 트래픽 진입점, 원격 연결을 구분한 뒤 관련 설정을 확인하세요. 아래 단계는 v2rayN, v2rayNG, v2flyNG의 일반적인 사용 상황을 다룹니다. 메뉴 이름과 사용할 수 있는 옵션은 각 클라이언트 버전을 기준으로 확인하세요.
CONCEPTS
기본 정보
클라이언트, 코어, 프록시 진입점은 서로 다른 계층에 있습니다. 먼저 각각의 역할을 파악한 뒤 어떤 설정을 바꿀지 결정하세요.
V2Ray, Xray, v2rayN은 각각 어떤 역할을 하나요?
V2Ray는 Project V 프록시 도구 생태계에 속하며, V2Fly와 Xray는 관련 코어 프로젝트입니다. v2rayN은 서버 설정, 구독, 프록시 모드를 관리하는 그래픽 클라이언트입니다. 인터페이스는 설정을 만들고 관리하며, 코어는 실제로 트래픽을 수신하고 전달합니다. 따라서 인터페이스에서 링크를 가져올 수 있다고 해서 현재 코어가 링크의 모든 옵션을 지원한다는 뜻은 아닙니다. 프로토콜이나 전송 매개변수 오류가 발생하면 클라이언트 설정에서 사용 중인 코어를 확인하고, 해당 코어가 지원하는 설정 항목과 대조하세요. 클라이언트 이름만으로 호환 여부를 판단하지 마세요.
v2rayN, v2rayNG, v2flyNG 중 어떤 클라이언트를 선택해야 하나요?
Windows, macOS, Linux 데스크톱에서는 v2rayN을 선택하고 운영체제와 프로세서 아키텍처에 맞는 설치 파일을 사용하세요. Android에서는 보통 Xray 코어를 사용하는 v2rayNG를 먼저 선택합니다. 기존 설정이 V2Fly 동작 방식에 의존한다면 v2flyNG를 대안으로 고려할 수 있습니다. 세 클라이언트는 메뉴 이름, 설정 저장 방식, 코어 지원 범위가 서로 달라 앱 데이터 폴더 전체를 그대로 옮길 수는 없습니다. 이전할 때는 기존 구독 주소나 호환되는 공유 링크를 우선 사용하고, 라우팅·DNS·로컬 수신 설정을 하나씩 확인하세요.
클라이언트를 설치한 뒤에도 구독이나 서버 설정이 필요한 이유는 무엇인가요?
클라이언트는 로컬 설정과 연결을 관리하는 도구이며, 설치 프로그램이 사용할 수 있는 원격 서버까지 제공하지는 않습니다. 연결하려면 사용 권한이 있는 서버 주소, 포트, 프로토콜, 인증 매개변수가 필요합니다. 구독은 이러한 설정을 한곳에서 가져오고 업데이트하는 데 사용됩니다. 가져온 뒤에는 목록에 유효한 항목이 있는지 확인하고, 항목 하나를 선택해 연결을 테스트하세요. 앱이 정상적으로 실행된다고 해서 원격 서비스도 이용할 수 있는 것은 아닙니다. 아직 설정을 받지 못했다면 로컬 프록시 포트를 반복해서 바꾸기보다 제공자에게 설정을 받는 방법, 유효 기간, 호환 클라이언트를 문의하세요.
시스템 프록시, 라우팅 모드, TUN은 어떻게 다른가요?
시스템 프록시는 시스템 프록시 설정을 따르는 앱에 로컬 프록시 진입점을 지정합니다. 라우팅 모드는 코어에 들어온 요청을 프록시로 보낼지, 직접 연결할지, 차단할지를 결정합니다. TUN은 가상 네트워크 인터페이스를 통해 지정된 조건에 해당하는 트래픽을 수신합니다. 이 세 설정은 서로 대체할 수 없습니다. 전역 라우팅으로 바꿔도 모든 앱이 자동으로 프록시에 연결되는 것은 아니며, TUN을 켜도 서버 설정이 올바르다는 보장은 없습니다. 처음 문제를 점검할 때는 TUN을 끄고 시스템 프록시로 브라우저 접속을 확인한 다음 TUN을 별도로 켜세요. 진입점과 라우팅을 동시에 바꾸면 문제 위치를 파악하기 어렵습니다.
INSTALLATION / IMPORT
설치 및 설정
설치 파일 아키텍처, 구독 형식, 시스템 권한을 각각 확인하세요. 이전하거나 재설치하기 전에 기존 설정을 백업하세요.
Android 설치 파일은 arm64와 universal 중 무엇을 선택해야 하나요?
ARM64 프로세서를 사용하고 시스템이 해당 앱 아키텍처를 지원하는 것을 확인했다면 arm64 설치 파일을 우선 선택하세요. 최신 Android 스마트폰 대부분이 여기에 해당합니다. 아키텍처를 확인하기 어렵다면 여러 아키텍처 구성 요소를 포함하는 universal 패키지를 선택할 수 있지만, 파일 크기가 더 큰 편입니다. 설치 파일을 분석할 수 없거나 호환되지 않는다는 메시지가 표시되면 아키텍처 문제로 단정하지 말고 시스템 버전 요구 사항, 남은 저장 공간, 다운로드 완료 여부도 확인하세요. 다른 출처의 앱을 옮기는 과정에서 서명 충돌이 발생했다면 설정을 먼저 백업한 뒤 기존 앱을 삭제해야 하는지 판단하세요.
구독 링크를 가져오지 못할 때 먼저 무엇을 확인해야 하나요?
먼저 구독 주소와 개별 서버 공유 링크를 구분하세요. 구독 주소는 구독 그룹의 주소 입력란에 넣고, 서버 공유 링크는 클립보드에서 가져오기 등 설정 가져오기 메뉴를 사용해야 합니다. 복사할 때 앞뒤 공백, 줄바꿈, 메신저에 딸려 온 설명을 제거하고 주소가 온전한지 확인하세요. 구독을 추가한 뒤 구독 업데이트를 실행해야 목록에 항목이 표시되는 경우가 많습니다. 형식을 지원하지 않는다는 메시지가 나오면 제공자에게 현재 클라이언트에서 사용할 수 있는 형식인지 문의하세요. 로그인 페이지나 오류 페이지, 호환되지 않는 설정 형식이 반환되는 경우 같은 주소를 다시 붙여넣어도 해결되지 않습니다.
v2rayN이 처음 실행되지 않거나 코어가 시작되지 않을 때는 어떻게 해야 하나요?
먼저 설치 파일이 현재 운영체제와 프로세서 아키텍처에 맞는지 확인하세요. 압축 파일을 사용한다면 전체 압축을 푼 뒤 실행하고, 압축 파일 미리보기 창에서 바로 실행하지 마세요. 압축을 푼 경로에 현재 사용자에게 읽기 및 쓰기 권한이 있어야 합니다. 그런 다음 시스템 알림과 클라이언트 로그를 살펴 런타임 누락, 실행 권한 부족, 코어 파일 사용 불가, 로컬 포트 충돌을 구분하세요. 런타임 요구 사항은 선택한 배포 패키지의 안내를 따르세요. 특정 인터페이스 버전의 요구 사항을 모든 버전에 적용해서는 안 됩니다. 시스템이 프로그램 실행을 차단한다면 출처와 차단 사유를 확인한 뒤 시스템 절차에 따라 허용할지 결정하세요.
TUN 모드에서 권한 부족 메시지가 표시되면 어떻게 해야 하나요?
먼저 TUN을 끄고 일반 프록시 연결이 되는지 확인한 뒤 가상 인터페이스에 필요한 권한을 처리하세요. 데스크톱에서는 클라이언트 버전과 시스템에 따라 관리자 권한, 보조 서비스, 가상 네트워크 구성 요소가 필요할 수 있습니다. 인터페이스 안내에 따라 권한을 부여하고 시스템 보안 기능을 장기간 끄지 마세요. Android에서 처음 활성화할 때는 시스템 VPN 권한을 허용하고, 다른 앱이 이미 해당 연결을 사용 중인지 확인하세요. 권한을 허용한 뒤에도 실패한다면 인터페이스 생성이나 라우트 추가 단계의 오류를 확인하고 다른 VPN 도구를 끈 후 다시 시도하세요. 여러 네트워크 제어 규칙이 동시에 적용되지 않도록 해야 합니다.
PROXY / ROUTING / SUBSCRIPTION
사용 팁
테스트 방식, 라우팅 규칙, 구독 업데이트는 각각 다른 단계에 영향을 줍니다. 설정을 바꾸기 전에 기존 값을 기록하고, 결과를 확인한 뒤 변경 사항을 유지하세요.
로컬 수신 주소와 포트를 직접 바꿔야 하나요?
충돌이 없다면 클라이언트의 기본값을 그대로 사용하세요. 튜토리얼 화면과 다르다는 이유만으로 포트를 변경할 필요는 없습니다. 브라우저, 명령줄 도구, 다른 앱에서 로컬 프록시에 직접 연결해야 한다면 클라이언트 설정에서 실제 수신 포트와 프로토콜을 먼저 확인하세요. 특정 포트가 항상 HTTP 또는 SOCKS를 의미한다고 가정해서는 안 됩니다. 이 기기에서만 사용할 때는 보통 수신 주소를 루프백 주소로 유지합니다. 수신 설정을 바꾼 뒤에는 설정을 다시 적용하고 시스템 프록시와 앱 내 수동 프록시 설정도 함께 수정하세요. 이전 포트가 남아 있으면 클라이언트는 정상 작동해도 앱이 연결되지 않을 수 있습니다.
노드 지연 시간 테스트에 결과가 나오면 정상적으로 접속할 수 있다는 뜻인가요?
반드시 그런 것은 아닙니다. TCP 지연 시간은 보통 서버 포트까지 연결되는 데 걸린 시간만 보여 주며, 프로토콜 인증이나 암호화 협상, 대상 웹사이트 접속 성공까지 보장하지 않습니다. 실제 연결 테스트는 프록시 경로를 추가로 확인하지만 테스트 주소, DNS, 테스트 시점의 네트워크 상태에도 영향을 받습니다. 노드를 선택한 뒤에는 실제로 이용하려는 서비스에 접속해 확인하고, 로그에서 핸드셰이크나 이름 확인 오류가 있는지 살펴보세요. 노드를 비교할 때는 테스트 방식과 대상 주소를 동일하게 유지하고 안정성, 트래픽 배수, 사용 지역도 함께 고려하세요. 한 번 측정한 최저 지연 시간만으로 판단하지 마세요.
전역 모드와 중국 본토 우회 분할 라우팅 중 무엇을 선택해야 하나요?
프록시에 들어온 요청을 가능한 한 모두 원격으로 보내려면 전역 라우팅을 선택하세요. 규칙에 따라 직접 연결과 프록시를 나누려면 중국 본토 우회 등의 분할 라우팅을 사용할 수 있습니다. 여기서 전역은 코어 내부의 라우팅 결정만 의미하며 모든 앱이 자동으로 제어된다는 뜻은 아닙니다. 모드를 바꾼 뒤 시스템 프록시나 TUN이 의도한 상태인지 확인하고 대상 웹사이트를 테스트하세요. 일부 도메인만 예상과 다르게 연결된다면 노드를 자주 바꾸기보다 규칙 순서, 규칙 리소스, DNS 확인 결과를 살펴보세요. 먼저 일치한 규칙이 요청의 출구를 이미 결정했을 수 있습니다.
구독 자동 업데이트 간격과 업데이트 시 프록시 사용은 어떻게 설정하나요?
구독 그룹이나 구독 설정에서 자동 업데이트 옵션을 찾아 간격 단위를 확인하고, 제공자의 업데이트 주기에 맞춰 설정하세요. 간격을 짧게 한다고 연결이 안정되는 것은 아닙니다. 업데이트 시 프록시 사용은 구독 내용을 가져오는 과정에만 영향을 주며 노드 연결 방식을 자동으로 바꾸지 않습니다. 현재 네트워크에서 구독 주소에 직접 연결할 수 없고 사용 가능한 노드가 있다면 프록시를 통한 업데이트를 시도할 수 있습니다. 노드가 모두 작동하지 않으면 업데이트할 수 없는 순환 상태가 될 수 있으므로 직접 연결로 가져오거나 제공자에게 주소 상태를 확인하세요. 메뉴 위치는 버전마다 다를 수 있으니 실제 인터페이스의 항목을 기준으로 설정하세요.
DIAGNOSTICS
문제 해결
오류가 발생했을 때의 로그를 보관하고 기본 네트워크, 구독 상태, 트래픽 진입점, 원격 연결 순서로 문제를 좁혀 가세요. 여러 설정을 한 번에 바꾸지 마세요.
구독 업데이트 실패가 링크, 네트워크, 인증서 문제 중 무엇 때문인지 어떻게 구분하나요?
먼저 업데이트 로그에서 구체적인 오류를 확인하세요. HTTP 401 또는 403은 보통 접근 권한 문제이고, 404는 주소가 만료되었을 가능성이 있습니다. 연결 시간 초과가 발생하면 네트워크 연결 가능 여부와 업데이트가 프록시를 통하는지 확인하세요. 인증서 오류라면 시스템 날짜와 시간대, 시스템 인증서 업데이트 상태를 먼저 점검하세요. 파싱 실패 메시지가 나오면 서버가 웹페이지나 호환되지 않는 내용을 반환했을 수 있으므로 제공자에게 구독 형식을 확인하세요. 인증서 검증을 끄는 방법을 일반적인 해결책으로 사용하지 말고, 전체 구독 주소를 공개 도움말 게시판에 올리지 마세요. 주소에 구독 접근에 사용할 수 있는 개인 매개변수가 포함될 수 있습니다.
노드 연결 시간이 초과되면 어떤 순서로 점검해야 하나요?
먼저 프록시를 종료하고 기본 네트워크가 정상인지 확인한 다음 구독이 만료되지 않았고 현재 항목이 업데이트되었는지 확인하세요. 이어서 노드 하나만 테스트하고 로그에서 도메인 확인, 연결 수립, 핸드셰이크 중 어느 단계에서 실패했는지 살펴보세요. 이름 확인에 실패하면 DNS를 점검하고, 연결 시간이 초과되면 서버 주소와 포트, 네트워크 경로를 확인하세요. 핸드셰이크에 실패하면 프로토콜과 전송 매개변수를 확인합니다. 사용할 권한이 있는 다른 설정으로 전환하면 특정 서버 문제인지 로컬 환경 문제인지 구분하는 데 도움이 됩니다. DNS, 라우팅, 코어를 한꺼번에 바꾸지 마세요. 매번 한 항목만 바꾸고 결과를 기록해야 비교 가능한 점검 근거가 남습니다.
클라이언트에는 연결됨으로 표시되지만 브라우저에서 인터넷에 접속할 수 없으면 어떻게 해야 하나요?
연결됨은 로컬 코어가 시작되었다는 뜻일 수 있으며 대상 웹사이트 요청이 성공했다는 의미는 아닙니다. 먼저 유효한 노드를 선택했는지 확인한 뒤 브라우저가 시스템 프록시를 따르는지, 클라이언트의 실제 수신 포트가 시스템 설정과 일치하는지 확인하세요. 다음으로 로그에 브라우저 요청이 기록되는지 살펴보세요. 기록이 없다면 트래픽 진입점을 중점적으로 확인하고, 기록은 있지만 이름 확인에 실패했다면 DNS를 점검하세요. 핸드셰이크나 원격 오류가 나타나면 노드 매개변수를 확인합니다. 특정 웹사이트만 문제가 있다면 해당 도메인의 라우팅과 서비스 상태를 살펴보세요. 모든 웹사이트에서 문제가 발생하면 다른 프록시 확장 프로그램과 VPN 도구를 잠시 꺼 설정이 서로 덮어쓰지 않도록 하세요.
시스템 프록시가 작동하지 않거나 클라이언트를 종료한 뒤에도 인터넷에 연결되지 않으면 어떻게 해야 하나요?
먼저 시스템 프록시 주소가 클라이언트의 현재 로컬 수신 포트를 가리키는지 확인하고 대상 앱이 실제로 시스템 프록시를 사용하는지도 확인하세요. 일부 앱은 별도의 프록시 설정을 사용하며, 시스템 프록시 설정을 읽지 않는 연결도 있습니다. 브라우저 확장 프로그램, 다른 프록시 프로그램, 관리 정책이 설정을 덮어쓴다면 설정을 관리하는 출처를 하나만 남기세요. 클라이언트를 종료한 뒤에도 인터넷에 연결되지 않으면 시스템 네트워크 설정을 열어 중지된 포트를 가리키는 수동 프록시가 남아 있는지 확인하고 필요에 따라 해제하세요. 네트워크를 복구한 뒤 클라이언트를 다시 시작해 시스템 프록시를 설정하세요. 남은 설정을 확인하는 대신 반복해서 재설치하지 마세요.