PLATFORM ENTRY

운영체제에 맞는 클라이언트 선택

먼저 기기의 플랫폼을 확인한 뒤 다운로드 페이지에서 설치 패키지를 선택하세요. 데스크톱은 주로 v2rayN을 사용하고, Android에서는 코어 선호도에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 플랫폼별 페이지에서 아키텍처, 설치 방법과 첫 실행 시 주의사항도 안내합니다.

DESKTOP

Windows

v2rayN 그래픽 클라이언트에 적합합니다. 다운로드 페이지에서 최신 데스크톱 인터페이스와 클래식 WPF 인터페이스를 나누어 제공하고 각각의 사용 환경을 설명합니다. 설치 후 트레이 메뉴에서 시스템 프록시 설정, 구독 업데이트와 라우팅 모드 전환을 할 수 있습니다.

다운로드 페이지로 이동

DESKTOP

macOS

v2rayN의 크로스플랫폼 데스크톱 인터페이스를 사용합니다. 플랫폼 페이지에서 기기의 칩셋에 맞춰 Apple Silicon 또는 Intel 설치 패키지를 선택한 다음, 첫 실행 시 시스템 권한을 허용하세요. 구독, 노드 테스트와 라우팅 분기 메뉴는 다른 데스크톱 플랫폼과 대체로 비슷합니다.

다운로드 페이지로 이동

MOBILE

Android

일반적으로 Xray 코어를 사용하는 v2rayNG를 선택하며, V2Fly 코어가 필요하면 v2flyNG를 사용할 수 있습니다. 다운로드 페이지에서 arm64와 범용 아키텍처별 항목을 제공하고, 첫 연결 권한 승인, 배터리 절전 예외와 앱별 프록시 설정 방향도 안내합니다.

다운로드 페이지로 이동

DESKTOP

Linux

데스크톱 환경에서는 v2rayN을 사용하고 배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택할 수 있습니다. 플랫폼 페이지에서 x64와 arm64 아키텍처를 구분합니다. 설치 후 데스크톱 세션, 시스템 프록시 설정 권한과 앱이 현재 프록시 설정을 읽는지 확인하세요.

다운로드 페이지로 이동

모든 클라이언트 보기 →

CONFIGURATION PATH

구독부터 라우팅 분기까지의 설정 구조

클라이언트의 안정적인 작동은 버튼을 계속 바꾸는 데 있지 않고, 구독·노드·프록시 모드·진단 로그가 각각 어떤 역할을 하는지 구분하는 데 있습니다. 네 가지 단계를 순서대로 확인해 재사용 가능한 설정 흐름을 만들어 보세요.

SUBSCRIPTION

원격 설정을 관리하기 쉬운 노드 목록으로 변환

구독 주소는 단일 노드가 아니라 업데이트 가능한 설정 모음입니다. 클라이언트에서 먼저 구독 그룹을 만든 다음 업데이트를 실행하고 노드가 해당 그룹에 들어갔는지 확인하세요. 이렇게 하면 출처별로 구분할 수 있고 이후 업데이트가 수동 설정을 덮어쓰는 일도 막을 수 있습니다. 노드가 바뀌지 않는다면 계속 다시 가져오기보다 현재 업데이트한 그룹, 주소의 완전성, 클라이언트 로그부터 확인해야 합니다.

클라이언트는 일반적으로 구독 내용에서 프로토콜, 서버, 포트, 사용자 식별자와 전송 매개변수를 파싱합니다. 사용자는 구독 출처를 명확하게 관리하고 업데이트 후 사용할 수 있는 노드를 다시 선택하면 됩니다. 공유 링크를 하나씩 붙여 넣는 것보다 그룹별 관리가 장기 유지에 적합하며, 여러 회선을 비교 테스트하기도 쉽습니다.

구독 그룹 → 구독 업데이트 → 노드 선택 → 연결 시작

ROUTING

각 요청을 명확한 아웃바운드 경로로 전달

라우팅 분기는 연결을 직접 연결할지, 프록시로 전달할지, 차단할지 판단합니다. 조건은 도메인, 주소 범위, 네트워크 유형 또는 프로세스 정보에서 가져올 수 있습니다. 일상적인 설정에서는 먼저 클라이언트가 제공하는 검증된 규칙 세트를 사용하고, 필요할 때만 소량의 사용자 지정 규칙을 추가하세요. 규칙이 많다고 더 나은 결과가 나오는 것은 아니며, 충돌과 순서 오류로 문제 해결이 어려워질 수 있습니다.

규칙을 수정한 뒤에는 설정을 다시 불러오고 직접 연결할 사이트와 프록시가 필요한 사이트를 각각 테스트해야 합니다. 특정 도메인 유형이 계속 잘못된 출구로 연결되면 먼저 적용된 규칙을 확인한 다음 우선순위를 조정하세요. 전역 스위치만 제공하는 단순한 도구와 달리 V2Ray 생태계에서는 판단 조건과 아웃바운드 동작을 분리해 관리할 수 있습니다.

domain:example.com → proxy · geoip:private → direct

PROXY MODE

시스템 프록시, 앱 프록시와 TUN 구분

시스템 프록시는 브라우저와 시스템 설정을 읽는 데스크톱 앱에 적합하며, 설정이 직관적이고 적용 범위를 파악하기 쉽습니다. 일부 앱은 시스템 프록시를 무시하므로 이때는 앱 내부에 로컬 수신 주소를 입력해야 합니다. TUN 모드는 더 넓은 범위의 트래픽을 처리할 수 있지만 가상 네트워크 인터페이스, 권한, DNS와 라우팅 테이블을 함께 다뤄야 합니다. 기본 연결이 정상인지 확인한 뒤 활성화하는 것이 좋습니다.

문제를 해결할 때는 가장 작은 범위부터 시작하세요. 먼저 클라이언트의 로컬 포트가 정상적으로 수신 중인지 확인하고, 다음으로 시스템 프록시를 테스트한 뒤 마지막에 TUN을 고려합니다. 한 번에 하나의 변수만 바꾸면 문제가 노드, 앱 설정 또는 시스템 네트워크 계층에서 발생했는지 빠르게 판단할 수 있으며, 여러 방식의 트래픽 가로채기로 인한 포트 충돌이나 라우팅 덮어쓰기도 피할 수 있습니다.

로컬 수신 → 시스템 프록시 → 앱 검증 → 필요할 때 TUN 활성화

DIAGNOSTICS

요청이 거치는 단계별로 연결 문제 확인

연결 버튼이 활성화되어 있다는 사실만으로는 클라이언트 프로세스가 시작을 시도했다는 것만 알 수 있으며, 원격 노드·DNS·라우팅이 모두 정상이라는 뜻은 아닙니다. 진단할 때는 설정 로드 여부, 로컬 포트 수신 여부, 시스템 프록시 적용 여부, 도메인 해석 여부, 원격 연결 성립 여부를 순서대로 확인하세요. 오류 로그의 failed to dial, rejected 같은 메시지는 발생한 위치와 함께 판단해야 합니다.

속도 테스트도 계층별로 이해해야 합니다. 연결 지연 시간, 다운로드 처리량과 웹페이지 로딩 속도는 서로 다른 구간을 측정합니다. 먼저 같은 기기, 같은 시간, 같은 테스트 대상으로 비교한 뒤 노드 교체 여부를 결정하세요. Mux, DNS와 라우팅 옵션을 무작정 바꾸기보다 변경 전후 결과를 기록하는 편이 안정적인 결론을 얻기 쉽습니다.

설정 로드 → 로컬 수신 → DNS → 라우팅 규칙 적용 → 원격 연결

QUICK START

세 단계로 첫 연결 완료

가장 짧은 경로를 먼저 확인한 뒤 라우팅 분기와 고급 네트워크 설정을 조정하세요. 처음 설정할 때 명확한 순서를 유지하면 문제가 발생해도 이미 검증한 이전 단계로 정확히 돌아갈 수 있습니다.

플랫폼에 맞는 클라이언트 설치

Windows, macOS, Linux 데스크톱 기기는 먼저 v2rayN 플랫폼 다운로드 영역으로 이동하세요. Android에서는 v2rayNG를 선택하거나 코어 요구사항에 따라 v2flyNG를 사용할 수 있습니다. 다운로드 전에 운영체제와 프로세서 아키텍처를 확인하고, 설치 후 앱의 메인 화면에서 설정하세요. 같은 로컬 포트를 사용하는 클라이언트를 여러 개 동시에 실행하지 마세요.
구독을 가져오고 노드 선택

구독 관리에서 이름과 주소를 추가하고 저장한 뒤 업데이트를 실행하세요. 노드 목록이 표시되면 하나를 활성 서버로 선택하고 기본 연결 테스트를 진행합니다. 구독 업데이트에 실패하면 먼저 주소가 완전한지 확인하고, 로그에서 파싱 실패인지 네트워크 시간 초과인지 반환 내용을 인식하지 못한 것인지 확인하세요.
프록시 활성화 및 라우팅 분기 확인

데스크톱에서는 먼저 시스템 프록시를 활성화하고, Android는 첫 연결 시 시스템 네트워크 권한을 승인하세요. 그런 다음 직접 연결이 예상되는 사이트와 프록시가 필요한 사이트를 각각 열어 두 요청이 모두 예상대로 처리되는지 확인합니다. 기본 연결이 안정된 뒤 사용자 지정 라우팅, 앱 프록시 또는 TUN을 설정해 여러 문제를 한꺼번에 겹치지 않도록 하세요.

전체 가이드 보기 →

PROJECT V ECOSYSTEM

Project V, V2Fly와 Xray의 관계

클라이언트, 코어와 프로토콜은 자주 혼동됩니다. 세 요소의 역할을 이해하면 소프트웨어 선택, 로그 확인과 호환성 판단이 훨씬 쉬워집니다.

핵심 기능부터 그래픽 클라이언트까지

Project V는 프록시 프로토콜, 전송 방식, 라우팅 시스템과 확장 가능한 네트워크 구성 요소를 중심으로 형성된 오픈 소스 기술 생태계입니다. V2Ray라는 이름은 초기 코어를 가리키는 동시에 관련 클라이언트와 설정 방식을 통칭하는 의미로도 사용됩니다. 실제 사용에서는 그래픽 클라이언트가 구독 관리, 노드 선택, 시스템 프록시와 화면 조작을 담당하고, 하위 코어가 설정 파싱, 연결 수립, 프로토콜 실행과 라우팅 로직을 처리합니다.

V2Fly는 V2Ray 코어의 흐름을 이어받아 모듈화, 프로토콜 구현과 커뮤니티 유지 관리를 중시합니다. Xray는 비슷한 기술 계보를 바탕으로 기존 설정과의 호환성을 유지하면서 자체적인 전송 및 프로토콜 기능을 발전시켰습니다. 둘은 단순한 인터페이스 버전 차이가 아니라 독립적으로 발전한 코어 계열입니다. 구독에 포함된 프로토콜 매개변수의 사용 가능 여부는 최종적으로 클라이언트에 포함된 코어와 지원 범위에 달려 있습니다.

v2rayN은 Windows, macOS, Linux에서 서버, 구독, 라우팅 규칙과 로컬 프록시 설정을 관리할 수 있는 데스크톱 그래픽 클라이언트입니다. v2rayNG는 Android용이며 일반적으로 Xray 코어와 함께 사용합니다. v2flyNG도 Android용이지만 V2Fly 코어 계열을 사용합니다. 세 프로그램 모두 커뮤니티가 유지 관리하는 오픈 소스 소프트웨어이며, 업데이트 일정은 상위 코어의 변화, 플랫폼 API와 유지 관리 계획의 영향을 받습니다.

오픈 소스 라이선스는 커뮤니티가 코드를 읽고 연구하며 개선할 수 있게 하고, 설정 형식·문제 논의·버전 변경 사항을 공개적으로 기록할 수 있게 합니다. 일반 사용자에게 더 실질적인 의미는 프로토콜 호환성이나 실행 오류가 발생했을 때 모든 문제를 노드 장애로 단정하지 않고 클라이언트 로그, 코어 차이와 업데이트 내용에서 원인을 찾을 수 있다는 점입니다.

데스크톱 클라이언트

v2rayN

구독, 서버 목록, 시스템 프록시, 라우팅과 코어 관리를 그래픽 인터페이스에 통합합니다. 매일 노드를 바꾸거나 여러 구독을 관리하고 라우팅 규칙을 단계적으로 조정해야 하는 데스크톱 사용자에게 적합합니다. 크로스플랫폼 인터페이스와 클래식 Windows 인터페이스는 조작 방식에 차이가 있으며 다운로드 페이지에서 각각 설명합니다.

Xray 코어

v2rayNG

Android에서 자주 사용하는 그래픽 클라이언트로, 연결할 때 시스템이 제공하는 네트워크 인터페이스를 통해 앱 트래픽을 처리합니다. 구독 가져오기 외에도 백그라운드 실행, 배터리 절전 정책, 앱별 프록시와 시스템 시간을 확인해야 합니다. 프로토콜 기능과 호환 범위는 주로 사용하는 Xray 코어를 따릅니다.

V2Fly 코어

v2flyNG

조작 방식은 모바일에서 흔히 사용하는 클라이언트와 비슷하며 하위 코어로 V2Fly를 사용합니다. 구독 설정이 해당 코어 계열과 일치하거나 서로 다른 코어의 동작을 비교 검증해야 하는 경우에 적합합니다. 선택하기 전에 인터페이스 이름만 비교하지 말고 구독의 프로토콜과 전송 매개변수를 먼저 확인하세요.

LATEST NOTES