Windows
v2rayN · 데스크톱 추천Desktop과 클래식 WPF 버전을 제공합니다. Desktop은 차세대 크로스플랫폼 인터페이스를 사용하고, WPF는 익숙한 기존 데스크톱 방식을 유지합니다. 사용 습관과 실행 환경에 맞춰 선택하세요.
다운로드 페이지로 이동 →먼저 운영체제를 확인한 뒤 프로세서 아키텍처를 선택하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 필요한 코어에 따라 v2rayNG와 v2flyNG 중에서 고르면 됩니다.
Desktop과 클래식 WPF 버전을 제공합니다. Desktop은 차세대 크로스플랫폼 인터페이스를 사용하고, WPF는 익숙한 기존 데스크톱 방식을 유지합니다. 사용 습관과 실행 환경에 맞춰 선택하세요.
다운로드 페이지로 이동 →Apple Silicon과 Intel용 설치 파일은 서로 다릅니다. ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. 처음 실행할 때는 시스템 안내에 따라 앱 실행 허용과 네트워크 권한을 설정하면 됩니다.
다운로드 페이지로 이동 →v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 대부분의 기기에서는 arm64 버전을 선택하면 됩니다. 아키텍처를 모른다면 시스템 정보를 확인하거나 범용 패키지를 선택하세요.
다운로드 페이지로 이동 →Debian·Ubuntu 계열에서는 deb, Fedora 등에서는 rpm 패키지를 확인하세요. 패키지 형식뿐 아니라 x64와 arm64도 구분하고, 데스크톱 세션 및 트레이 지원 여부를 확인해야 합니다.
다운로드 페이지로 이동 →클라이언트, 코어, 구독은 서로 다른 구성 요소입니다. 클라이언트를 설치하면 조작 인터페이스와 로컬 프록시 기능을 사용할 수 있지만, 연결 가능한 서버가 자동으로 생기지는 않습니다. 시작하기 전에 사용 권한이 있는 구독 주소나 서버 설정을 준비하고, 서버에서 사용하는 프로토콜·전송 방식·보안 매개변수를 확인하세요. 서버 이름이나 지역 표시만으로는 연결할 수 없습니다.
하나의 구독에 여러 프로토콜이 포함될 수 있지만, 클라이언트에서 가져올 수 있는지는 구독 형식과 코어 호환성에 따라 달라집니다. 파일 확장자만 보고 판단하지 마세요. 공유 링크, 통합 구독, 전체 JSON은 각각 가져오기 메뉴가 다릅니다. 처음에는 출처가 분명한 구독 하나를 가져와 설정 하나를 선택한 다음 로컬 프록시가 실행되는지 확인하세요. 불확실한 요소를 한꺼번에 늘리지 않는 편이 좋습니다.
설치 후에는 기본 네트워크 설정으로 먼저 연결해 보세요. 데스크톱에서는 시스템 프록시가 브라우저 트래픽을 처리하는지 확인하고, Android에서는 VPN 권한이 허용되었는지 확인하세요. 게임, 명령줄 도구 또는 특정 앱의 트래픽을 처리해야 할 때 TUN 모드나 앱별 프록시를 검토하면 됩니다. 재현 가능한 기본 연결을 먼저 만든 뒤 라우팅 규칙을 바꾸면 문제 원인을 찾기 쉽습니다.
이미 설정을 사용 중인 기기라면 업그레이드 전에 구독 그룹, 라우팅 규칙, 사용자 지정 DNS 설정을 보존하세요. 다른 클라이언트의 데이터 디렉터리 전체를 그대로 덮어쓰지 마세요. 인터페이스 설정, 코어 설정, 규칙 파일은 각각 구조가 다릅니다. 이전이 필요하면 구독을 다시 가져온 뒤 실제로 사용하는 사용자 지정 설정만 하나씩 옮기는 것이 좋습니다.
클라이언트에서 실제로 사용하는 설정 항목을 중심으로 기능을 살펴봅니다. 먼저 설정 출처를 확인하고, 트래픽이 프록시에 들어가는 방식과 처리할 아웃바운드, 도메인 조회 위치를 정하세요.
구독 그룹을 사용하면 출처가 다른 서버를 나눠 관리할 수 있습니다. v2rayN의 ‘구독 그룹’에서 메모와 구독 주소를 입력하고 저장한 뒤 해당 그룹을 업데이트하세요. 그런 다음 서버 목록으로 돌아가 설정을 선택하면 됩니다. v2rayNG에서도 구독 그룹으로 출처를 관리할 수 있습니다. 공유 링크를 하나씩 붙여 넣는 것보다 구독을 사용하면 주소와 매개변수를 한곳에서 동기화할 수 있지만, 업데이트 과정에서 기존 항목이 바뀔 수 있습니다. 계속 사용할 수동 설정은 별도로 정리하세요. 필터 표현식은 적은 항목으로 먼저 시험해 필요한 서버까지 숨겨지지 않는지 확인하세요.
라우팅 규칙은 트래픽을 직접 연결할지, 프록시로 보낼지, 차단할지를 정합니다. 앱이 클라이언트에 연결되는지를 결정하는 것은 아닙니다. v2rayN에서는 시스템 프록시와 라우팅 모드를 각각 확인해야 합니다. ‘중국 본토 우회’를 설정해도 모든 앱이 시스템 프록시를 따르는 것은 아닙니다. 규칙은 보통 순서대로 적용되므로, 로컬 네트워크 주소 같은 명확한 예외를 적절한 위치에 두고 도메인 및 주소 목록을 처리하세요. 아래는 Xray 형식의 규칙 예시입니다. 해당 설정 구조에 맞게 넣어야 하며 direct 아웃바운드가 반드시 있어야 합니다. 전체 설정을 규칙 하나로 대체할 수는 없습니다.
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
TUN 모드는 시스템 프록시를 사용하지 않는 앱의 트래픽도 가상 네트워크 인터페이스를 통해 클라이언트로 보낼 수 있습니다. ‘전체 라우팅’과 같은 설정은 아닙니다. TUN 모드는 트래픽이 들어오는 경로를 처리하고, 라우팅은 들어온 트래픽이 나갈 경로를 정합니다. 데스크톱에서 사용하기 전 권한, 관련 구성 요소, 시스템 지원을 확인하고 네트워크를 가로채는 다른 도구가 동시에 실행되지 않도록 하세요. Android는 일반적으로 시스템 VPN 인터페이스를 사용하므로 데스크톱 설정을 그대로 적용하면 안 됩니다. 사용 후 로컬 네트워크에 접근할 수 없다면 서버를 계속 바꾸기보다 사설 주소 제외 규칙과 DNS를 확인하세요.
DNS는 도메인을 IP 주소로 변환하며, 조회 경로는 라우팅 대상과 맞아야 합니다. 페이지가 열리지 않으면 먼저 로그에 DNS 조회 시간 초과가 있는지 확인한 다음 서버 연결이 가능한지 점검하세요. 공용 DNS 주소를 모든 입력란에 무작정 넣지 마세요. 로컬 조회, 원격 조회, 부트스트랩 조회는 각각 용도가 다릅니다. 아래는 코어 DNS 설정의 최소 구조이며 전체 라우팅 구성을 의미하지 않습니다. v2rayNG의 ‘로컬 DNS 사용’도 실제 설정과 함께 확인해야 합니다. FakeDNS를 사용한다면 유입 경로와 라우팅이 해당 동작을 지원하는지도 살펴보세요.
{
"dns": {
"servers": ["localhost"]
}
}
Xray와 V2Fly는 관련은 있지만 독립적으로 발전하는 코어 프로젝트입니다. 지원하는 프로토콜 세부 사항과 설정 필드는 완전히 같지 않습니다. v2rayN에서 코어를 선택할 때는 현재 배포판과 설정 메뉴를 기준으로 판단하고, 어떤 설정이든 그대로 전환된다고 가정하지 마세요. Android에서는 v2rayNG와 v2flyNG로 서로 다른 코어 계열을 비교할 수 있습니다. 전환하기 전에 설정을 백업하고 전송 방식, 보안 매개변수, 규칙 리소스의 호환성을 확인한 뒤 같은 서버 설정으로 테스트하세요. 한 코어에서 링크를 가져올 수 있다고 해서 다른 코어도 모든 확장 매개변수를 지원하는 것은 아닙니다.
‘클라이언트는 실행 중인데 앱에서 접속할 수 없음’ 문제가 발생하면 먼저 앱 트래픽이 로컬 프록시로 들어오는지 확인하세요. 브라우저, 명령줄 도구, 백그라운드 서비스가 서로 다른 프록시 설정을 사용할 수 있습니다. 브라우저에서 접속된다는 것은 해당 브라우저의 현재 연결만 정상이라는 뜻입니다. 다음으로 선택한 서버 설정, 라우팅 규칙 적용 여부, 연결 로그를 확인하고 마지막으로 도메인 조회 문제를 살펴보세요. 세 단계를 나눠 확인하는 편이 포트, DNS, 라우팅을 동시에 바꾸는 것보다 효과적입니다.
지연 시간 테스트도 무엇을 측정하는지 구분해야 합니다. 주소 탐색에 성공해도 대상 웹사이트에 접속할 수 있다는 보장은 없습니다. 실제 연결 테스트는 프록시 연결 상태를 더 잘 반영하지만, 테스트 대상과 네트워크 부하, 시간에 따라 결과가 달라집니다. 서버를 고를 때는 실제 사용 환경에서 확인하고 한 번의 테스트 결과에 의존하지 마세요. 용어가 궁금하다면 용어집을, 규칙을 수정해야 한다면 고급 설정 가이드를 참고하세요.
클라이언트는 조작을 담당하고 코어는 연결을 처리합니다. 이 관계를 알아야 설정을 옮길 수 있는지, 프로토콜이 호환되는지, 업데이트 후 무엇을 확인해야 하는지 판단할 수 있습니다.
V2Ray 프로젝트의 기술적 배경
독립적으로 발전하는 코어 프로젝트
사용자용 그래픽 클라이언트
Project V는 V2Ray 생태계를 이해하는 출발점입니다. V2Ray는 프로토콜 처리, 전송, 라우팅 등의 기능을 설정 가능한 프록시 코어로 구성합니다. 그래픽 클라이언트는 서버 목록, 구독 그룹, 설정 화면을 통해 자주 쓰는 기능을 편리하게 조작하도록 합니다. 일상적으로 말하는 ‘V2Ray 설치’는 실제로 모든 코어 설정을 직접 편집하는 것이 아니라, 클라이언트와 관련 구성 요소를 설치하는 경우가 많습니다.
따라서 인터페이스에서 이름이 같은 옵션도 내부 구현까지 완전히 같다고 볼 수는 없습니다. 여러 하위 매개변수를 스위치 하나로 묶는 클라이언트도 있고, 일부 설정만 제공하는 클라이언트도 있습니다. 문제를 점검할 때는 클라이언트 이름, 사용 중인 코어, 실행 모드를 먼저 기록한 뒤 해당 문서를 확인하세요. 클라이언트와 코어를 혼동하면 인터페이스 조작 문제를 프로토콜 문제로 잘못 판단하기 쉽습니다.
V2Fly 커뮤니티는 V2Ray 관련 구현을 계속 유지·관리하고 있습니다. Xray는 관련 기술 계열에서 출발한 뒤 독립적으로 발전했습니다. 두 프로젝트는 일부 개념을 공유하지만, 프로토콜 지원, 전송 확장 기능, 설정 요구 사항은 각각의 발전에 따라 달라집니다. VLESS, VMess, Trojan, REALITY 등의 설정을 사용할 때는 클라이언트에 해당 이름이 표시되는지만 보지 말고 코어 기능과 서버 매개변수를 하나씩 확인하세요.
공유 링크에는 보통 서버 연결에 필요한 정보가 담기지만, 전체 JSON에는 인바운드, 아웃바운드, 라우팅, DNS 설정까지 포함될 수 있습니다. 두 형식을 서로 바꿔 쓸 수 있는 파일처럼 취급해서는 안 됩니다. 전체 설정을 다른 코어로 옮길 때는 필드의 의미, 아웃바운드 태그, 규칙 리소스를 확인하세요. 링크를 다른 클라이언트로 가져올 때도 확장 매개변수가 무시되지 않는지 점검해야 합니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈소스로 배포되며 클라이언트 프로젝트는 GPL-3.0 라이선스를 따릅니다. 코어와 함께 제공되는 구성 요소에는 각각 별도의 라이선스가 있으므로 배포하거나 수정할 때 따로 확인해야 합니다. 오픈소스란 라이선스 조건에 따라 코드를 열람·연구·수정할 수 있다는 뜻입니다. 모든 배포판이 독립적인 감사를 받았다는 의미는 아니며, 구독 출처와 서버 운영 주체를 확인하는 일을 대신하지도 않습니다.
데스크톱에서는 서버 관리, 구독 그룹, 라우팅 설정을 한곳에서 다루는 v2rayN을 우선 고려하세요. Android에서는 v2rayNG를 먼저 살펴보고, V2Fly 호환성이 필요한 경우 v2flyNG를 고려하면 됩니다. 이 선택은 플랫폼과 설정 요구 사항을 기준으로 한 것이며 성능 순위를 의미하지 않습니다. 차이는 클라이언트 선택 가이드에서 자세히 확인할 수 있습니다.
클라이언트 업데이트로 인터페이스, 설정 생성 방식, 함께 제공되는 코어가 바뀔 수 있습니다. 업데이트 전에 현재 작동하는 서버 설정, 시스템 프록시 상태, 사용자 지정 규칙을 기록하고 설정을 백업하세요. 업데이트 후에는 기존 네트워크 환경에서 기본 연결을 먼저 확인한 다음 구독 업데이트, DNS, TUN을 점검합니다. 업데이트와 동시에 모든 라우팅 설정을 다시 작성하면 변화가 어느 단계에서 비롯됐는지 파악하기 어렵습니다.
유지 관리 상태와 구체적인 호환 범위는 프로젝트 릴리스 안내와 실제 배포판을 기준으로 확인하세요. 사이트 홈에서는 안정적인 선택 기준을 안내하고, 설치 파일 정보는 다운로드 페이지에서 제공합니다. 업데이트 후 설정 메뉴의 위치가 바뀌었다면 현재 클라이언트와 플랫폼을 먼저 확인한 뒤 관련 가이드를 참고하세요. 오래된 화면만 보고 같은 메뉴를 찾으려 하지 않는 것이 좋습니다.
구독 주소에는 접속 자격 증명이 포함될 수 있으므로 민감 정보로 취급해야 합니다. 스크린샷, 로그, 문의 내용에 전체 구독 주소, 사용자 식별 정보, 서버 인증 매개변수를 그대로 공개하지 마세요. 문제를 설명할 때는 프로토콜 유형, 필드 이름, 오류 메시지는 남기되 계정을 식별할 수 있는 내용은 삭제하면 됩니다. 서버 목록 내보내기 파일에도 같은 정보가 포함될 수 있습니다.
클라이언트는 로컬 연결과 관리 기능을 제공하며, 서비스 품질은 네트워크 환경과 서버에도 좌우됩니다. 앱을 바꿔도 만료되거나 작동하지 않는 구독이 복구되지는 않으며 서버 측 제한이 자동으로 바뀌지도 않습니다. 반복해서 설치하거나 가져오기를 시도하기 전에 설정 출처가 유효하고 계정 상태가 정상인지 확인한 다음 로컬 설정을 점검하세요.
설치 파일 배포, 구독 형식, 서버 선택 등 궁금한 내용부터 살펴보세요. 작업 전에 클라이언트와 플랫폼을 확인하고 서로 다른 코어의 설정 예시를 섞어 사용하지 마세요.
Ubuntu, Debian, Fedora 등의 배포판에 deb 또는 rpm 패키지로 v2rayN을 설치하고, 의존성과 트레이 아이콘 문제를 해결한 뒤 데스크톱 자동 시작 항목으로 로그인 후 자동 실행되도록 설정합니다.
데스크톱 설치 가이드 보기 →Base64 구독, 전체 JSON 설정, vmess:// 및 vless:// 공유 링크의 구조를 설명하고 v2rayN과 v2rayNG에서 가져오기·내보내기 및 형식 변환 방법을 안내합니다.
구독 형식 가이드 보기 →구독에 서버가 많다면 실제 연결 지연 시간을 먼저 확인한 뒤 트래픽 배율, 지역, VLESS·VMess·Trojan의 차이를 비교하세요. 웹 서핑, 동영상 시청, 원격 근무에 맞는 서버를 고르는 방법을 안내합니다.
서버 선택 가이드 보기 →