desktop / v2rayN
Windows
데스크톱에서는 먼저 v2rayN을 선택하는 것이 좋습니다. 다운로드 페이지에서 크로스 플랫폼 데스크톱 버전과 클래식 WPF 버전의 인터페이스 차이, 지원 시스템 및 설치 방법을 함께 안내하므로 최신 시스템과 기존 장비에 맞춰 선택할 수 있습니다.
다운로드로 이동 →routing / rules
브라우저나 시스템 트래픽은 먼저 로컬 리스닝 포트로 들어온 뒤 routing 규칙에 따라 도메인, IP, 프로토콜 유형, 프로세스 출처를 확인하고 지정된 outbound로 전달됩니다. 이 흐름을 이해하면 시스템 프록시, 로컬 네트워크 우회, 직접 연결 규칙과 원격 연결의 관계를 더 명확히 파악할 수 있습니다.
download / platforms
현재 사용하는 시스템에 맞는 영역으로 이동한 다음, 프로세서 아키텍처와 사용 환경에 따라 클라이언트를 선택하세요. 홈에서는 플랫폼 안내만 제공하며, 설치 패키지 종류와 시스템 요구 사항, 구체적인 다운로드 경로는 다운로드 페이지에서 통합해 설명합니다.
desktop / v2rayN
데스크톱에서는 먼저 v2rayN을 선택하는 것이 좋습니다. 다운로드 페이지에서 크로스 플랫폼 데스크톱 버전과 클래식 WPF 버전의 인터페이스 차이, 지원 시스템 및 설치 방법을 함께 안내하므로 최신 시스템과 기존 장비에 맞춰 선택할 수 있습니다.
다운로드로 이동 →desktop / v2rayN
v2rayN 데스크톱 버전은 Apple Silicon과 Intel 아키텍처별 다운로드 경로를 제공합니다. 시스템 정보에서 칩 이름을 확인하면 쉽게 구분할 수 있으며, 다운로드 페이지에서 최초 실행, 설정 가져오기, 시스템 프록시 전환 위치도 안내합니다.
다운로드로 이동 →mobile / v2rayNG
Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택할 수 있으며, 코어 선호도에 따라 v2flyNG를 선택해도 됩니다. 대부분의 최신 기기는 arm64를 사용합니다. 아키텍처를 확인하기 어렵다면 다운로드 페이지의 범용 설치 패키지 선택 안내를 참고하세요.
다운로드로 이동 →desktop / v2rayN
v2rayN은 주요 배포판용 패키지를 제공하며 x64와 arm64 아키텍처로 구분됩니다. 먼저 배포판이 deb와 rpm 중 어느 형식을 사용하는지 확인한 뒤 다운로드 페이지에서 해당 아키텍처를 선택하면 설치 중 형식 오류를 줄일 수 있습니다.
다운로드로 이동 →config / anatomy
하나의 설정은 각 역할이 분명한 여러 최상위 필드로 구성됩니다. 왼쪽 목차에서 필드의 기능, 일반적인 값, 그래픽 클라이언트에서 해당 설정을 찾는 위치, 수정할 때 놓치기 쉬운 연동 관계를 확인할 수 있습니다.
config > inbounds
inbounds는 브라우저, 시스템 또는 다른 프로그램의 트래픽을 클라이언트가 수신하는 방식을 정의합니다. 일반적인 설정에는 listen, port, protocol, tag가 포함됩니다. 리스닝 주소는 연결 가능한 장치를 결정하고, 로컬 포트는 시스템 프록시 설정과 일치해야 하며, 프로토콜은 보통 SOCKS 또는 HTTP를 사용합니다. v2rayN에서는 매개변수 설정의 로컬 리스닝 포트에 해당하고, v2rayNG에서는 로컬 프록시 및 VPN 서비스 진입점에 해당합니다. 포트를 변경한 뒤에는 프록시 주소를 수동으로 설정한 브라우저나 앱도 함께 수정해야 합니다. 그렇지 않으면 클라이언트가 정상적으로 시작되어도 트래픽이 코어로 들어오지 않습니다.
config > outbounds
outbounds는 트래픽이 로컬 기기를 떠난 뒤 처리되는 방식을 설명합니다. 하나의 설정에는 보통 원격 프록시, 직접 연결, 차단 출구가 포함되며 각 출구는 tag로 고유한 이름을 부여받고 routing 규칙에서 참조됩니다. 원격 출구에는 프로토콜, 서버 주소, 포트, 사용자 매개변수, 전송 계층 옵션도 포함됩니다. 그래픽 클라이언트에서 구독을 가져오면 주요 출구가 자동으로 생성되므로, 사용자가 주로 다루는 항목은 활성 서버 선택, 전송 설정, 코어 전환입니다. 수동 편집 시에는 먼저 tag가 라우팅 규칙과 일치하는지 확인해야 합니다. 출구가 있어도 이를 참조하는 규칙이 없으면 사용할 수 없습니다.
config > routing > rules
routing은 특정 트래픽을 어느 outbound로 보낼지 결정합니다. 규칙은 도메인, IP 대역, 포트, 네트워크 유형, 인바운드 tag 또는 프로세스 이름으로 매칭할 수 있으며, outboundTag를 통해 프록시, 직접 연결 또는 차단 출구를 지정합니다. v2rayN의 라우팅 설정에는 사전 정의 규칙과 사용자 지정 규칙 메뉴가 있고, v2rayNG에서는 라우팅 설정에서 도메인 정책과 규칙 순서를 조정할 수 있습니다. 실제 매칭은 대개 순서의 영향을 받으므로 정확한 규칙을 포괄적인 규칙보다 앞에 배치하세요. 변경 후에는 로그에서 적용된 규칙과 최종 출구를 확인해야 합니다.
config > dns
dns는 코어에서 사용할 조회 서버와 도메인별 조회 경로를 제어합니다. 일반적인 설정에는 서버 목록, hosts 매핑, 조회 전략, 도메인별 조회 서버 지정이 포함됩니다. DNS는 routing과 밀접하게 연동됩니다. 도메인이 주소로 변환된 뒤에도 후속 IP 규칙이 매칭에 참여할 수 있습니다. 그래픽 클라이언트에서는 보통 DNS 설정, 라우팅 고급 설정 또는 사용자 지정 설정 영역에서 이 옵션을 찾을 수 있습니다. 도메인은 조회되지만 연결에 문제가 있을 때는 시스템 DNS, 클라이언트 DNS, 라우팅 도메인 정책을 각각 확인해 서로 다른 계층을 혼동하지 않도록 하세요.
config > log
log는 액세스 로그, 오류 로그, 출력 수준을 설정합니다. 평소에는 출력량을 낮게 유지하고, 연결 실패, 잘못된 라우팅, 포트 충돌, 구독 생성 오류가 발생했을 때 일시적으로 로그 수준을 높여 핵심 기록을 확인하세요. v2rayN과 v2rayNG 모두 로그 보기 기능을 제공합니다. 리스너가 시작되었는지, 아웃바운드가 연결되었는지, 도메인 조회 결과가 반환되었는지, routing이 최종적으로 어떤 tag를 선택했는지를 중점적으로 확인하면 됩니다. 로그에는 서버 주소와 로컬 경로가 포함될 수 있으므로 문제 해결 정보를 공유하기 전에는 관련 행만 정리하고 개인 연결 매개변수는 가리세요.
project v / ecosystem
그래픽 클라이언트, 프록시 코어, 설정 데이터는 서로 다른 계층에 속합니다. 각 계층의 역할을 구분해야 클라이언트 업데이트, 코어 전환, 구독 내용, 라우팅 규칙 사이의 관계를 올바르게 이해할 수 있습니다.
Project V는 V2Ray 설정 모델과 모듈형 네트워크 도구의 기본 구조를 마련했습니다. 설정 파일은 인바운드, 아웃바운드, 라우팅, DNS, 전송, 로그를 서로 연동되는 모듈로 나누며, 사용자는 tag를 이용해 여러 모듈을 명확한 데이터 경로로 조합할 수 있습니다. 이러한 구조는 config.json을 수동으로 관리하기에도 적합하고, 그래픽 클라이언트가 구독과 화면 옵션에 따라 설정을 생성하기에도 편리합니다. 따라서 그래픽 클라이언트에서 보는 서버, 프록시 모드, 라우팅 프리셋, 로컬 포트는 결국 해당 설정 필드로 연결됩니다.
V2Fly는 V2Ray의 핵심 기능을 이어받아 모듈형 설정과 프로토콜 구현을 유지하고 있습니다. Xray는 유사한 설정 체계를 바탕으로 독립적인 코어로 발전했으며 여러 클라이언트에서 연결과 라우팅 처리에 사용됩니다. 둘 다 그래픽 클라이언트 자체가 아니라 클라이언트가 호출하는 하위 코어입니다. 하나의 그래픽 클라이언트가 서로 다른 코어를 중심으로 기능을 구성할 수 있고, 같은 구독도 클라이언트와 코어의 지원 범위에 따라 전송 매개변수, 라우팅 기능, 설정 작성 방식에서 세부 차이가 나타날 수 있습니다.
v2rayN, v2rayNG, v2flyNG 및 관련 코어는 오픈 소스 커뮤니티에서 지속적으로 유지 관리됩니다. 오픈 소스 라이선스는 코드 사용, 수정, 재배포의 범위를 정하며 프로토콜 구현, 설정 해석, 문제 수정 과정을 개발자가 공개적으로 검토할 수 있게 합니다. 일반 사용자에게 더 실용적인 기준은 현재 시스템에 맞는 클라이언트를 다운로드하고, 업데이트 내용을 읽고, 정상 작동하는 설정을 보관하며, 업그레이드 후 시스템 프록시, 라우팅, 코어 상태를 확인하는 것입니다.
클라이언트 업데이트와 코어 업데이트가 항상 동시에 이루어지는 것은 아닙니다. 인터페이스 프로그램은 구독 관리, 설정 편집, 트레이 제어, 시스템 연동을 담당하고, 코어는 프로토콜 연결, DNS, 라우팅, 트래픽 처리를 담당합니다. 업데이트가 화면 구성만 변경한다면 기존 연결 방식은 대개 바뀌지 않습니다. 코어나 설정 형식이 변경되었다면 사용자 지정 라우팅, 전송 매개변수, 이전 설정과의 호환성을 중점적으로 확인해야 합니다. 일상적인 관리에서는 소프트웨어 이름 하나만 기록하기보다 클라이언트 종류, 사용 코어, 주요 설정을 함께 기록하는 것이 문제 원인을 찾는 데 도움이 됩니다.
desktop
Windows, macOS, Linux용 데스크톱 그래픽 클라이언트로 구독 관리, 서버 선택, 시스템 프록시, 라우팅 프리셋, TUN 모드, 로그 보기를 지원합니다. 데스크톱에서 시스템 네트워크 설정을 폭넓게 제어해야 한다면 v2rayN부터 시작하는 것이 좋습니다.
android / xray
Xray 코어를 사용하는 Android 클라이언트로 QR 코드 스캔, 클립보드 가져오기, 구독 업데이트, 앱별 프록시, 라우팅 설정을 제공합니다. Xray 관련 매개변수를 이미 사용하거나 해당 프로토콜 기능이 필요하다면 모바일 기본 선택지로 사용할 수 있습니다.
android / v2fly
V2Fly 코어 기반의 Android 대안 클라이언트로, 인터페이스와 일반적인 구독 절차가 익숙한 편입니다. V2Fly 설정 체계를 유지하거나 코어별 동작 차이를 확인해야 할 때 실제 설정 요구 사항에 따라 선택할 수 있습니다.
workflow / checklist
quick answers
먼저 구독 업데이트를 한 번 실행한 다음 구독 그룹이 활성화되어 있는지, 링크가 완전한지, 클라이언트 로그에 해석 오류가 없는지 확인하세요. 전체 절차는 구독 가져오기 단계를 참고할 수 있습니다.
시스템 프록시는 시스템 프록시 설정을 따르는 앱의 트래픽을 주로 처리하고, TUN 모드는 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 처리합니다. 선택하기 전에 TUN 모드 섹션을 먼저 읽어 보세요.
먼저 로컬 리스닝 포트를 점유한 프로세스를 찾은 다음 클라이언트의 SOCKS 또는 HTTP 포트를 변경하고 브라우저와 다른 앱의 프록시 설정도 함께 수정하세요. 포트 충돌 문제 해결에서 자세히 확인할 수 있습니다.
최신 시스템이라면 크로스 플랫폼 데스크톱 버전을 먼저 고려하고, 클래식 인터페이스와 기존 사용 방식이 중요하다면 WPF 버전과 비교해 보세요. 구체적인 차이는 클라이언트 비교 페이지에 정리되어 있습니다.
notes / latest
문서는 재현 가능한 문제를 중심으로 구성합니다. 먼저 발생 조건을 설명한 뒤 설정 경로, 확인 방법, 복구 절차를 제시합니다. 설정 구조를 다룰 때는 각 필드의 역할도 함께 설명해 그래픽 인터페이스의 조작을 코어 설정과 연결해 이해할 수 있도록 합니다.
클라이언트 시작 시 포트 충돌이 발생하는 경우는 대개 자주 사용하는 리스닝 포트를 다른 프로그램이 점유하고 있기 때문입니다. 이 글에서는 프로세스를 찾은 뒤 v2rayN 매개변수 설정에서 로컬 포트를 변경하고 브라우저 프록시를 함께 수정하는 방법을 설명합니다.
전문 읽기 →다운로드와 압축 해제, 최초 실행, 구독 가져오기까지 Windows 환경의 설정을 순서대로 안내하고, 실행 환경 누락, 시스템 프록시 미작동, 클라이언트 버전 선택 등 자주 발생하는 문제도 설명합니다.
전문 읽기 →최소 설정 파일을 분해해 인바운드가 로컬 트래픽을 수신하는 방식, 아웃바운드가 연결을 생성하는 방식, routing이 tag를 통해 규칙을 지정된 출구로 연결하는 방식을 설명합니다.
전문 읽기 →