데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지는 CPU 아키텍처와 설치 형식별로 파일을 나누므로, 먼저 플랫폼을 정해 이후 단계에서 맞지 않는 파일을 선택하지 않도록 하세요.
Windows에서는 v2rayN을 사용하며, 최신 데스크톱 인터페이스와 기존 WPF 인터페이스 중에서 선택할 수 있습니다. 최신 인터페이스는 다른 데스크톱 플랫폼과 구성이 비슷하고, WPF 버전은 기존 메뉴와 트레이 조작에 익숙한 사용자에게 적합합니다. 설치 후에는 먼저 구독을 가져온 다음 시스템 프록시를 설정하거나 필요에 따라 TUN 모드를 켜세요.
macOS에서는 v2rayN 데스크톱 버전을 사용합니다. 다운로드하기 전에 기기가 Apple Silicon인지 Intel 프로세서인지 확인하세요. CPU 아키텍처는 설치 파일 선택에만 영향을 주며 구독 형식이나 라우팅 설정은 바뀌지 않습니다. 처음 실행한 뒤 시스템 권한을 확인하고 구독을 가져온 다음 브라우저가 시스템 프록시를 따르는지 확인하는 것이 좋습니다.
Android에서는 일반적인 구독 설정과 잘 맞는 v2rayNG를 우선 사용할 수 있으며, V2Fly 코어가 필요하면 v2flyNG를 선택하세요. 대부분의 최신 기기는 arm64 설치 파일을 사용할 수 있고, 아키텍처를 알 수 없을 때는 범용 설치 파일을 사용하면 됩니다. 연결하기 전에 클라이언트가 로컬 네트워크 연결을 생성하도록 허용해야 합니다.
Linux에서는 v2rayN을 사용합니다. 배포판의 패키지 체계에 따라 deb 또는 rpm을 선택하고, 기기 아키텍처에 맞춰 x64와 arm64를 구분하세요. 설치 후 그래픽 인터페이스는 실행되지만 앱 트래픽이 클라이언트로 들어오지 않는다면 데스크톱 환경의 프록시 설정, 터미널 환경 변수, TUN에 필요한 권한을 각각 확인해야 합니다.
클라이언트에 연결 상태가 표시된다고 해서 코어 프로세스가 실행 단계에 들어갔다는 것만 확인할 수 있습니다. 설정이 완전한지 판단하려면 구독 내용, 활성 서버, 프록시 적용 방식, 라우팅 일치 결과와 실행 로그를 이어서 확인해야 합니다. 아래 네 가지 주제는 가장 일반적인 설정 흐름에 해당합니다.
먼저 구독 주소와 그룹을 확인한 뒤 서버 목록을 로컬에 업데이트하세요.
규칙은 순서대로 일치하며, 처음 일치한 규칙이 요청의 아웃바운드 방식을 결정합니다.
먼저 시스템 프록시로 기본 연결을 확인한 뒤, 앱 적용 범위에 따라 TUN 사용 여부를 결정하세요.
상태 표시줄은 결과만 보여 주고, 실행 로그에 연결 실패가 어느 단계에서 발생했는지가 기록됩니다.
처음 설정할 때는 확실히 작동하는 서버 하나만 남기고, 가장 단순한 시스템 프록시 방식으로 연결을 확인하는 것이 좋습니다. 브라우저 요청이 클라이언트를 통해 전달되는 것을 확인한 뒤 라우팅 규칙, DNS 정책, TUN 등의 설정을 추가하세요. 처음부터 구독, 코어, 라우팅, 트래픽 적용 방식을 모두 바꾸면 문제가 생겼을 때 원인을 구분하기 어렵습니다.
매번 서로 관련된 옵션 한 묶음만 수정하고, 수정 전후의 현상을 기록하세요. 예를 들어 서버를 바꾼 뒤에는 연결 결과만 확인하고, 라우팅을 조정한 뒤에는 일치 규칙과 아웃바운드만 점검하며, TUN을 켠 뒤에는 권한과 DNS를 중점적으로 확인합니다. 한 번 더 확인하는 과정이 필요하지만, 불필요한 재설치와 방향 없는 설정 변경에 드는 시간을 크게 줄일 수 있습니다.
다음은 전체 가이드의 간단한 실행 순서로, 구독 링크를 이미 준비한 사용자에게 적합합니다. 각 단계에는 클라이언트 실행, 서버 목록 업데이트, 실제 요청의 프록시 통과라는 명확한 확인 지점이 있습니다. 확인을 마친 뒤 다음 단계로 넘어가세요.
다운로드 센터에 들어간 뒤 운영체제에 맞는 플랫폼으로 전환하세요. Windows는 인터페이스 선호에 따라 데스크톱 버전이나 기존 WPF 버전을 선택할 수 있고, macOS는 프로세서에 맞는 설치 파일을 선택해야 합니다. Android는 코어 경로에 따라 v2rayNG 또는 v2flyNG를 선택하고, Linux는 배포판의 패키지 체계와 프로세서 아키텍처에 맞는 파일을 고르세요. 설치 후에는 클라이언트를 실행해 메인 화면, 트레이 메뉴 또는 연결 권한이 정상적으로 작동하는지 확인합니다.
시스템이 처음 실행을 차단하면 운영체제가 제공하는 앱 권한 화면에서 파일 출처와 실행 권한을 확인하세요. 문제를 피하려고 반복해서 압축을 풀거나 재설치하지 마세요. Linux 환경에서는 데스크톱 구성 요소와 설치 의존성이 모두 갖춰졌는지도 확인해야 합니다. 이 단계에서는 복잡한 라우팅을 수정하지 말고 클라이언트가 안정적으로 실행되어 설정 화면에 들어갈 수 있게 하는 데 집중하세요.
구독 그룹에 링크를 추가하고 저장한 뒤 해당 그룹을 한 번 수동으로 업데이트하세요. 업데이트가 성공하면 서버 항목이 표시되어야 합니다. 그룹은 존재하지만 목록이 비어 있다면 먼저 링크가 완전한지 확인한 다음 올바른 그룹에 업데이트를 적용했는지 점검하세요. 목록이 나타나면 서버 하나를 활성 항목으로 선택하고 실제 연결 테스트나 직접 접속으로 확인하세요. 단순한 네트워크 응답만으로 판단해서는 안 됩니다.
구독에는 여러 프로토콜과 전송 조합이 포함될 수 있으며, 클라이언트는 설정에 따라 해당 코어 기능을 호출합니다. 일반적으로 각 필드를 직접 수정할 필요는 없지만 서버와 클라이언트의 매개변수는 일치해야 합니다. 로그에 인증, 주소 또는 전송 매개변수 오류가 표시되면 로컬 옵션을 무작정 바꾸기보다 구독 제공처로 돌아가 설정을 확인하세요.
데스크톱에서는 먼저 시스템 프록시를 활성화해 시스템 설정을 따르는 브라우저와 앱이 클라이언트를 사용하도록 하세요. Android에서 연결할 때는 시스템 네트워크 연결 권한을 확인해야 합니다. 그런 다음 캐시되지 않은 페이지를 열어 확인하면서 클라이언트 로그에 해당 요청이 나타나는지도 살펴보세요. 요청이 올바른 아웃바운드로 들어오는 것이 확인되어야 앱, 시스템 프록시, 클라이언트 코어 사이의 흐름이 정상적으로 연결된 것입니다.
브라우저는 작동하지만 명령줄 도구가 작동하지 않는다면 두 프로그램이 프록시 설정을 읽는 방식이 다르다는 뜻일 수 있습니다. TUN을 켠 뒤 모든 요청에 문제가 생기면 권한, DNS, 라우팅 충돌을 확인하세요. 클라이언트의 연결 아이콘만 보지 말고 실제 접속, 로그 기록, 라우팅 일치 결과를 함께 확인해야 합니다.
클라이언트 이름, 코어 이름, 프로토콜 이름은 자주 함께 등장합니다. 세 계층의 관계를 이해하면 다운로드와 문제 해결이 쉬워집니다. 그래픽 클라이언트는 상호작용과 설정 관리를 담당하고, 코어는 네트워크 처리를 담당하며, 프로토콜과 전송 매개변수는 클라이언트와 서버가 통신하는 방식을 설명합니다.
Project V는 프록시 프로토콜, 라우팅 기능, 네트워크 전송을 중심으로 한 도구 생태계를 구축했습니다. 프로젝트가 발전하면서 V2Fly는 V2Ray 관련 구현과 커뮤니티 유지 관리를 이어 왔고, Xray는 같은 기술 흐름에서 다른 기능 방향과 업데이트 주기로 발전했습니다. 두 코어 경로는 많은 개념을 공유하지만, 실제 프로토콜 기능과 설정 필드, 구현 진행 상황이 항상 일치하는 것은 아닙니다.
v2rayN, v2rayNG, v2flyNG는 그래픽 클라이언트이며 하위 코어와 동일하지 않습니다. 이들은 구독 관리, 서버 목록, 시스템 프록시, 라우팅 설정, 로그 표시를 담당하고 정리된 설정을 코어에 전달해 실행합니다. 따라서 인터페이스가 정상적으로 표시된다고 해서 모든 코어 매개변수가 유효한 것은 아닙니다. 연결 문제가 발생하면 클라이언트 설정, 현재 코어, 서버 설정을 함께 확인해야 합니다.
이러한 계층 구조는 같은 구독이 클라이언트마다 조금 다르게 표시될 수 있는 이유이기도 합니다. 클라이언트는 자체 인터페이스 모델에 따라 설정을 읽고, 코어는 지원 범위에 따라 실행합니다. 클라이언트를 선택할 때는 모든 제품명을 완전히 같은 대체재로 보기보다 현재 운영체제, 필요한 코어 경로, 사용 습관을 우선 고려하세요.
v2rayN은 Windows, macOS, Linux를 지원하며 구독 그룹, 서버 선택, 시스템 프록시, TUN, 라우팅, 로그 등을 그래픽 인터페이스로 설정할 수 있습니다. 데스크톱 플랫폼마다 설치 형식은 다르지만 구독 가져오기와 기본 설정 방식은 같아 여러 데스크톱 기기에서 같은 작업 흐름을 재사용하기 좋습니다.
v2rayNG는 Android용 클라이언트로, 일반적으로 Xray 코어 경로와 함께 사용됩니다. 인터페이스는 모바일 기기의 연결 권한, 서버 전환, 라우팅, 앱별 처리에 맞춰 구성되어 있습니다. 모바일 네트워크는 자주 전환되므로 문제를 해결할 때 설정뿐 아니라 Wi-Fi와 모바일 네트워크 변화, 백그라운드 제한, 시스템 네트워크 권한도 확인해야 합니다.
v2flyNG 역시 Android용이며, 주요 차이점은 V2Fly 코어 경로를 사용한다는 점입니다. 구독 설정이 V2Fly의 구현 방식에 명확히 의존하거나 해당 코어 체계를 유지하고 싶다면 v2flyNG를 선택할 수 있습니다. 선택할 때는 서버 설정과 실제 프로토콜 요구 사항을 기준으로 판단하세요.
이 프로젝트들은 오픈 소스로 유지되며, 라이선스는 코드의 사용·수정·재배포 조건을 규정합니다. 오픈 소스의 실질적인 가치는 구현 세부 사항을 검토할 수 있고, 문제를 구체적인 코드와 설정을 바탕으로 논의할 수 있다는 데 있습니다. 파생 클라이언트도 해당 라이선스를 따라야 합니다. 사용자는 자신에게 맞는 플랫폼용 빌드를 공식적인 다운로드 경로에서 받고 버전 설명과 설정 변경 사항을 읽어야 합니다.
그래픽 클라이언트와 하위 코어는 서로 다른 프로젝트에서 관리되므로 출시 주기가 반드시 같지는 않습니다. 클라이언트 업데이트는 인터페이스, 설치 방식, 설정 변환 로직을 바꿀 수 있고, 코어 업데이트는 프로토콜 구현, 라우팅 동작, 매개변수 지원을 바꿀 수 있습니다. 업그레이드 후 동작이 달라졌다면 먼저 변화가 클라이언트 계층인지 코어 계층인지 판단한 뒤 설정, 로그, 구독 내용을 다시 확인하세요.
프로토콜 이름은 설정의 일부일 뿐이며 주소, 포트, 인증 정보, 전송 방식, TLS 관련 설정, 라우팅 동작도 연결에 영향을 줄 수 있습니다. 두 클라이언트에 같은 프로토콜이 표시되더라도 사용하는 코어, 매개변수 지원 범위, 설정 형식을 확인해야 합니다. 호환성 문제가 발생하면 프로토콜 이름만 비교하기보다 전체 설정 흐름을 점검하는 편이 효과적입니다.
처음 설정할 때 발생하는 문제는 대부분 구독 미업데이트, 활성 서버 미선택, 앱의 시스템 프록시 미사용, 과도한 라우팅 또는 DNS 변경에서 비롯됩니다. 아래 네 가지 항목에서 판단 방향을 확인하고, 관련 개념은 용어 안내서에서 더 살펴보세요.
먼저 구독 그룹이 저장되었는지 확인한 다음 해당 그룹을 수동으로 업데이트하고 로그를 확인하세요. 그룹 이름이 있다는 것은 링크 기록이 만들어졌다는 뜻일 뿐, 구독 내용이 정상적으로 다운로드되고 파싱되었다는 의미는 아닙니다. 로그에 요청 오류가 나타나면 링크가 완전한지와 현재 네트워크를 확인하고, 다운로드는 완료되었지만 파싱에 실패했다면 구독 형식을 점검하세요.
구독 및 서버 용어 보기 →프로그램마다 프록시 설정을 읽는 방식이 다릅니다. 브라우저는 대체로 시스템 프록시를 따르지만 일부 터미널 도구, 개발 환경, 독립 네트워크 프로그램은 자체 프록시 매개변수가 필요하거나 TUN으로 트래픽을 적용해야 합니다. 먼저 특정 프로그램만 연결되지 않는지, 모든 트래픽이 클라이언트를 거치지 않는지 구분하세요.
시스템 프록시 및 TUN 보기 →테스트 결과는 연결 과정의 일부만 확인합니다. 시스템 시간, DNS, 라우팅 일치, 활성 서버, 앱 프록시 설정을 계속 점검하고 로그를 지운 뒤 다시 접속하세요. 로그에 해당 요청이 없다면 문제는 대개 앱과 클라이언트 사이에서 발생한 것입니다. 요청과 오류가 있다면 키워드를 기준으로 코어 또는 설정을 확인하세요.
로그 및 문제 해결 용어 보기 →대상 앱이 시스템 프록시를 읽지 않거나 더 넓은 범위의 네트워크 트래픽을 일괄 처리해야 할 때 TUN을 고려할 수 있습니다. 켜기 전에 시스템 프록시로 기본 연결을 확인한 뒤 권한, DNS, LAN 라우팅을 설정하세요. 이렇게 하면 서버 설정 문제와 트래픽 적용 문제를 나누어 판단할 수 있습니다.
라우팅 및 분류 용어 보기 →각 글은 실제 작업에서 발생하는 하나의 문제를 중심으로 점검 순서, 로그 근거, 설정 항목 사이의 관계를 설명합니다. 구체적인 문제가 생기면 제목에서 가장 가까운 상황을 먼저 선택한 뒤 전체 문서로 돌아가 관련 개념을 보완하세요.
서버 상태, 시스템 시간, DNS, 라우팅 규칙, 시스템 프록시를 차례로 확인해 연결 상태와 실제 요청이 클라이언트를 통과했는지 구분합니다.
전체 글 읽기 →rejected, timeout, invalid user 등 자주 나오는 로그 키워드의 의미를 설명하고, 오류 발생 시간·대상 주소·아웃바운드 태그로 구체적인 설정 항목을 찾는 방법을 안내합니다.
전체 글 읽기 →Project V 기술 흐름에서 두 코어의 관계를 정리하고, v2rayN·v2rayNG·v2flyNG의 플랫폼 및 코어 선택과 연결해 설명합니다.
전체 글 읽기 →