V2Ray 클라이언트
자주 묻는 질문

V2Ray는 Project V 프록시 도구 생태계에 속하며, V2Fly는 그 코어를 이어서 관리합니다. Xray는 같은 기술 생태계의 또 다른 코어 구현체입니다. v2rayN은 서버, 구독, 라우팅을 관리하고 코어를 실행하는 그래픽 클라이언트입니다. 인터페이스가 열린다고 코어가 정상 작동하는 것은 아니므로 연결 문제를 확인하기 전에 코어 로그부터 살펴보세요. 프로토콜을 선택할 때는 클라이언트 이름만 보지 말고 사용 중인 코어가 해당 전송 방식과 보안 매개변수를 지원하는지도 확인해야 합니다.

Windows, macOS, Linux 데스크톱에서는 v2rayN을 먼저 살펴보세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 설정과의 호환성이 필요하면 v2flyNG를 검토할 수 있습니다. 선택 기준은 인터페이스의 유사성이 아니라 운영체제, 프로세서 아키텍처, 서버 설정입니다. 같은 구독도 클라이언트마다 필드 해석이 다를 수 있으므로 이전 후 프로토콜, 전송 방식, TLS, 라우팅을 확인하세요. 기존 로컬 설정 폴더를 그대로 가져다 쓰지 않는 것이 좋습니다.

구독 주소는 보통 여러 설정을 반환하는 URL이며, 추가한 뒤 구독을 갱신해야 합니다. 공유 링크는 대개 vmess://, vless://, trojan://으로 시작하며 서버 설정 하나를 담습니다. 기본 JSON에는 인바운드, 아웃바운드, DNS, 라우팅 등 전체 설정이 들어갈 수 있습니다. 세 형식은 가져오기 메뉴를 서로 바꿔 사용할 수 없습니다. 받은 내용의 형식부터 확인한 뒤 구독 그룹, 클립보드 가져오기, 설정 파일 가져오기 중 알맞은 방법을 선택하세요. 구독 URL을 서버 주소 입력란에 넣지 마세요.

시스템 프록시는 해당 설정을 따르는 앱이 로컬 프록시 포트에 연결되도록 합니다. 라우팅 분기는 코어에 들어온 연결을 direct, proxy, block 중 어디로 보낼지 정합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 전달하며, 적용 범위는 플랫폼과 설정에 따라 달라집니다. 세 기능은 서로 다른 단계에서 작동합니다. 브라우저 트래픽이 클라이언트에 들어오지 않는다면 geosite 규칙을 바꿔도 대개 소용없습니다. 트래픽은 들어오지만 잘못된 아웃바운드로 나간다면 시스템 프록시를 반복해서 전환하기보다 규칙 순서를 확인하세요.

VLESS와 Trojan은 프록시 프로토콜이고 REALITY는 연결 보안 방식이므로, 같은 계층에서 서로 배타적인 세 가지 옵션으로 볼 수 없습니다. 서버의 프로토콜, 전송 방식, 보안 설정에 맞춰 구성해야 합니다. REALITY를 사용할 때는 공개 키, serverName, shortId 등의 매개변수도 확인하세요. 이름만 보고 프로토콜을 직접 바꾸거나 기존 TLS 설정을 그대로 REALITY로 변경하지 마세요. 제공업체가 준 전체 링크를 먼저 가져온 뒤 현재 클라이언트와 코어의 지원 여부를 항목별로 확인하는 것이 좋습니다.

2015년 이후 출시된 대부분의 Android 스마트폰은 arm64를 우선 고려할 수 있지만, 출시 시기만으로 아키텍처를 단정하지 말고 기기 정보와 앱 요구 사항을 확인하세요. universal은 여러 아키텍처를 지원하므로 아키텍처를 모를 때 시도하기 좋지만 파일 크기가 더 큽니다. 설치할 수 없다는 메시지가 표시되면 최소 OS 버전, 저장 공간, 기존 앱과의 서명 충돌도 확인하세요. 설치 실패를 모두 아키텍처 탓으로 돌리면 안 됩니다. 기존 앱을 삭제하기 전에 필요한 설정을 백업하세요.

데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 Windows 데스크톱 인터페이스를 사용합니다. 메뉴 위치와 일부 설정 진입 경로가 다를 수 있습니다. Windows 사용자는 사용 습관과 호환성을 고려해 선택하면 되며 두 버전을 동시에 실행할 필요는 없습니다. 처음 이전할 때는 서버와 라우팅 설정을 내보낸 뒤 새 버전에서 가져오고 로컬 포트를 확인하세요. 새 버전의 데이터 파일로 구버전 폴더를 덮어쓰거나 두 인스턴스가 같은 프록시 포트를 사용하게 하지 마세요.

먼저 구독 주소 전체를 복사했는지 확인하고, 앞뒤 공백이나 줄바꿈, 메신저가 덧붙인 문장부호가 없는지 살펴보세요. v2rayN에서 주소를 구독 그룹에 넣은 뒤 구독 갱신도 실행해야 합니다. 그룹만 저장해서는 서버 목록이 만들어지지 않습니다. 지원하지 않는 형식이라는 메시지가 나오면 응답 내용이 로그인 페이지나 오류 페이지인지, 클라이언트가 지원하지 않는 구독 형식인지 확인하세요. 공유 링크는 해당 클립보드 가져오기 메뉴를 사용하세요. 주소가 만료된 문제를 인코딩을 직접 바꿔서 해결하려 하지 마세요.

데스크톱 TUN은 가상 네트워크 인터페이스를 만들거나 관리하므로 클라이언트 버전과 운영체제에 따라 관리자 권한, 서비스 설치 또는 시스템 승인이 필요할 수 있습니다. Android 클라이언트는 시스템 VPN 승인을 받아 트래픽을 전달하므로 시스템 확인 창에서 허용해야 합니다. 승인 후에도 실패하면 인터페이스 생성 관련 로그를 확인하고 다른 VPN 앱이 사용 중인지 살펴보세요. 먼저 일반 시스템 프록시가 작동하는지 확인한 다음 TUN을 켜면 서버 설정 문제와 인터페이스 권한 문제를 구분하기 쉽습니다.

macOS에서는 시스템의 이 Mac에 관하여에서 Apple Silicon인지 Intel인지 확인한 뒤 arm64 또는 x64 설치 파일을 선택하세요. Linux에서는 프로세서 아키텍처와 패키지 형식을 모두 확인해야 합니다. Debian·Ubuntu 계열은 보통 deb, Fedora 등은 보통 rpm을 선택한 뒤 x64와 arm64 중 맞는 파일을 고릅니다. 설치 후 실행되지 않으면 시스템 종속성과 앱 로그를 확인하세요. 설치 파일 확장자만 바꿔 다른 아키텍처나 패키지 관리자로 설치하려 하지 마세요.

중국 본토 웹사이트는 직접 연결하고 나머지는 규칙에 따라 프록시로 보내려면 중국 본토 우회 규칙 세트부터 사용해 보세요. 전역 모드는 분기 설정이 문제인지 임시로 확인할 때 유용하지만, 사설 주소 등의 트래픽이 실제 규칙에서 어떻게 처리되는지도 살펴봐야 합니다. 모드를 전환한 뒤 설정이 다시 로드됐는지 확인하고 같은 웹사이트로 반복 테스트하세요. 전역 모드라고 모든 앱이 프록시를 사용하는 것은 아닙니다. 시스템 프록시를 따르지 않는 앱은 직접 연결될 수 있으므로 앱 자체의 프록시 설정이나 TUN 적용 여부를 먼저 확인하세요.

현재 네트워크에서 구독 서비스에 직접 접속할 수 있다면 프록시를 사용하지 않고 구독을 갱신하세요. 직접 연결이 실패하고 사용 가능한 프록시가 있다면 프록시를 통한 갱신을 시도해 보세요. 두 방법은 구독을 가져오는 네트워크 경로만 바꾸며 만료된 주소나 서버가 반환한 오류 내용을 해결하지는 않습니다. 방식을 바꾸기 전에 파싱 오류, 연결 시간 초과, HTTP 상태 코드 등 로그의 구체적인 오류를 기록하세요. 요청 제한에 걸리지 않도록 짧은 간격으로 반복 갱신하지 마세요.

라우팅 설정에서 도메인 일치 규칙을 추가하고 direct 아웃바운드를 선택하세요. 예를 들어 domain:example.com은 해당 도메인과 하위 도메인에 적용되고, full:example.com은 도메인 전체가 일치할 때만 적용됩니다. Xray 라우팅은 보통 위에서 아래 순서로 규칙을 확인하므로, 예외 규칙은 먼저 일치할 수 있는 포괄적인 규칙보다 위에 두세요. 저장하고 설정을 다시 불러온 뒤 기존 연결을 닫고 다시 접속해 액세스 로그의 아웃바운드 태그를 확인하세요. 웹페이지가 열리는지만으로 규칙 적용 여부를 판단하거나 시스템 프록시의 우회 목록을 코어 라우팅 표로 간주하지 마세요.

구독 주소나 클라이언트에서 내보낼 수 있는 설정을 먼저 이전한 뒤 현재 서버, 라우팅 규칙, DNS를 확인하세요. 시스템 프록시, TUN 승인, 시작 프로그램 등록, 로컬 포트, 앱별 분기는 기기 환경에 따라 달라지므로 새 기기에서 다시 설정해야 하는 경우가 많습니다. 클라이언트마다 전체 백업 형식이 서로 호환되는 것은 아닙니다. 공유 링크를 가져올 수 있어도 다른 클라이언트의 데이터베이스를 읽을 수 있다는 뜻은 아닙니다. 백업에는 서버 인증 정보와 비공개 구독 주소가 포함될 수 있으므로 안전한 위치에 보관하고 이전이 끝나면 임시 사본을 삭제하세요.

프로그램을 종료한 뒤에도 시스템이 이미 닫힌 로컬 프록시 포트를 가리키면 브라우저는 계속 해당 포트에 연결을 시도합니다. v2rayN에서는 먼저 시스템 프록시를 해제한 뒤 정상적으로 종료하세요. TUN을 사용했다면 가상 인터페이스와 관련 라우팅도 복구됐는지 확인해야 합니다. 클라이언트가 이미 종료된 경우 시스템 네트워크 설정에서 수동 프록시를 확인하세요. 다른 프로그램이나 조직에서 관리하는 프록시 설정을 함부로 지우지 마세요. 복구한 뒤 브라우저를 다시 시작하고 로컬 네트워크와 일반 웹사이트 연결을 각각 확인하세요.

먼저 어떤 방식으로 테스트했는지 확인하세요. TCP 연결 성공은 대상 포트에 연결할 수 있다는 뜻일 뿐, 프로토콜 핸드셰이크나 웹 요청까지 성공했다는 의미는 아닙니다. 특정 테스트의 시간 초과만으로 서버가 작동하지 않는다고 단정할 수도 없습니다. 서버 주소, 포트, 시스템 시간, 현재 네트워크를 확인한 뒤 프로토콜, 전송 방식, 보안 매개변수를 점검하세요. 로그에서 파싱 실패, 연결 거부, 핸드셰이크 오류 중 무엇인지 확인하고 필요하면 다른 네트워크에서도 비교해 보세요. 원인을 파악하기 어려워지지 않도록 기존 설정을 보존하고 한 번에 한 항목만 변경하세요.

연결됨 표시는 보통 로컬 서비스나 VPN 인터페이스가 시작됐다는 뜻이지, 원격 서버 연결까지 성공했다는 뜻은 아닙니다. 먼저 코어 로그에서 정상적으로 시작됐는지 확인한 뒤 앱이 시스템 프록시나 VPN을 사용하는지 살펴보세요. 웹페이지에 접속하면서 요청 기록이 나타나는지도 확인하세요. 기록이 없다면 트래픽이 들어오는 경로를 확인하고, 기록은 있지만 요청이 실패한다면 서버 핸드셰이크, DNS, 라우팅을 점검하세요. 브라우저 하나와 웹사이트 하나로 먼저 테스트하고, 프록시 설정을 바꿀 수 있는 확장 프로그램은 잠시 꺼 시스템 설정이 덮어쓰이지 않도록 하세요.

먼저 상태 표시줄에서 시스템 프록시 자동 설정을 선택하고 코어가 정상적으로 실행되는지, 로컬 수신 포트를 다른 프로그램이 사용 중이지 않은지 확인하세요. 그런 다음 시스템 네트워크의 프록시 설정을 열어 주소와 포트가 현재 인스턴스를 가리키는지 확인합니다. 값이 곧바로 원래대로 돌아간다면 다른 프록시 프로그램, 브라우저 확장 프로그램, 기기 관리 정책을 점검하세요. 일부 앱은 시스템 프록시를 사용하지 않으므로 앱 안에서 따로 설정하거나 TUN 사용을 검토해야 합니다. 이런 앱에서는 라우팅 모드를 반복해서 바꿔도 클라이언트로 들어오지 않는 트래픽 문제가 해결되지 않습니다.

현재 사용할 수 있는 설정은 그대로 보존하고 갱신 오류를 기록한 뒤 주소 만료 여부, 기기 시간, 도메인 확인, 현재 네트워크의 구독 서비스 접속 가능 여부를 각각 점검하세요. HTTP 401 또는 403이면 인증과 서비스 상태를 우선 확인하고, 시간 초과라면 네트워크 경로를 중점적으로 살펴보세요. 요청은 성공했지만 파싱할 수 없다면 응답 내용의 형식을 확인해야 합니다. 사용 가능한 서버가 있는 경우 직접 연결과 프록시 갱신을 비교해 볼 수 있지만, 전체 구독 주소를 공개하지 마세요. 기존 목록이 비어 있다고 해서 클라이언트를 반드시 다시 설치해야 하는 것은 아닙니다.

같은 네트워크와 브라우저에서 정상 사이트와 문제가 있는 사이트를 비교한 뒤, 해당 도메인의 DNS 오류와 라우팅 규칙 적용 기록을 확인하세요. 임시로 전역 규칙을 적용했을 때 사이트가 열리면 먼저 일치한 직접 연결 또는 차단 규칙을 점검하세요. 로그에 도메인 확인 실패가 명확히 표시된다면 클라이언트 DNS 설정, 브라우저 보안 DNS, TUN의 DNS 가로채기가 서로 영향을 주는지 확인합니다. 한 번에 한 곳만 조정하고 캐시를 비운 뒤 새 연결을 만들어 다시 테스트하세요. 웹페이지는 열리지만 일부 리소스가 실패한다면 주소창의 기본 도메인뿐 아니라 리소스 도메인도 살펴봐야 합니다.