Windows
v2rayN
Desktop 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 전자는 차세대 크로스 플랫폼 인터페이스를, 후자는 기존 방식의 조작 환경을 유지합니다. 운영체제와 프로세서 조건을 확인한 뒤 해당 설치 안내를 읽으세요. 처음 설정할 때는 로컬 수신 포트 충돌을 피하려면 인스턴스를 하나만 실행하는 것이 좋습니다.
다운로드 페이지로 →먼저 플랫폼 선택데스크톱에서는 v2rayN을, Android에서는 v2rayNG와 v2flyNG를 비교하세요. 클라이언트는 설정을 관리하며, 실제 연결에는 사용 가능한 노드 정보나 구독 주소가 필요합니다.
플랫폼별 다운로드
v2rayN
Desktop 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 전자는 차세대 크로스 플랫폼 인터페이스를, 후자는 기존 방식의 조작 환경을 유지합니다. 운영체제와 프로세서 조건을 확인한 뒤 해당 설치 안내를 읽으세요. 처음 설정할 때는 로컬 수신 포트 충돌을 피하려면 인스턴스를 하나만 실행하는 것이 좋습니다.
다운로드 페이지로 →v2rayN
칩에 맞춰 Apple Silicon 또는 Intel 설치 파일을 선택하세요. ‘이 Mac에 관하여’에서 확인할 수 있습니다. 설치 후에는 시스템에서 허용하는 앱 실행 절차를 마친 다음 구독을 가져오세요. 시스템 프록시를 켠 뒤에는 브라우저가 시스템 설정을 사용하는지 확인해야 합니다. 클라이언트가 실행 중이라는 이유만으로 연결이 정상이라고 판단하지 마세요.
다운로드 페이지로 →v2rayNG / v2flyNG
v2rayNG는 Xray를 사용하며 v2flyNG는 V2Fly 코어를 대안으로 제공합니다. 설치 파일은 arm64와 범용 버전으로 나뉘므로 기기 아키텍처에 맞춰 선택하세요. 처음 연결할 때는 Android VPN 권한을 허용해야 합니다. 다른 VPN 앱이 실행 중이라면 먼저 인터페이스 충돌을 해결한 뒤 노드를 테스트하세요.
다운로드 페이지로 →v2rayN
배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 다음 x64와 arm64를 구분하세요. 그래픽 인터페이스의 시스템 프록시 설정을 모든 앱이 사용하는 것은 아니며, 터미널 프로그램은 별도의 환경 변수를 사용할 수도 있습니다. 설치 후 브라우저 연결을 확인하고 프록시가 필요한 다른 프로그램도 각각 점검하세요.
다운로드 페이지로 →설치 파일 형식은 설치 가능 여부를, 프로세서 아키텍처는 실행 가능 여부를, 노드와 코어의 호환성은 연결 가능 여부를 결정합니다. 세 가지를 따로 확인하면 클라이언트를 계속 바꾸는 것보다 문제를 쉽게 찾을 수 있습니다. 업그레이드 전에는 구독 그룹, 라우팅 설정 및 사용자 설정을 보관하세요. 업그레이드 후에는 새 기능을 켜기 전에 기존 노드로 연결을 테스트하세요.
전체 클라이언트 보기 →기능별 비교
"outbounds": [{ "protocol": "vless" }]
구독은 여러 노드를 한 번에 가져올 때 사용하며, 공유 링크에는 보통 단일 노드 정보가 담깁니다. 일반 JSON에는 인바운드, 아웃바운드 및 라우팅 설정 전체가 포함될 수도 있습니다. 세 클라이언트 모두 구독 가져오기 기능을 제공하지만, 파싱할 수 있는 프로토콜과 필드는 클라이언트와 코어에 따라 다릅니다. 가져온 뒤 구독을 업데이트하고 그룹에 노드가 표시되는지 확인한 다음 사용할 항목을 선택하세요. 위 예시는 코어의 아웃바운드 키 이름이지 구독 주소 형식이 아닙니다. 가져오기에 실패하면 주소 입력란에 전체 설정을 붙여 넣지 말고, 먼저 원본의 형식과 업데이트 로그를 확인하세요.
"routing": { "domainStrategy": "AsIs" }
라우팅 규칙은 도메인이나 대상 IP 등의 조건에 따라 아웃바운드를 선택하며, 일반적으로 규칙 순서대로 처리됩니다. 세 클라이언트는 각자 인터페이스와 코어가 지원하는 규칙 설정을 사용할 수 있지만, 기본 규칙 이름과 편집 방법은 서로 다릅니다. 먼저 LAN 접속을 유지하고 구체적인 도메인 규칙을 추가한 뒤, 어떤 규칙에도 일치하지 않는 트래픽이 어디로 가는지 확인하세요. 규칙에서 geosite 또는 geoip를 참조한다면 관련 데이터 파일이 있는지도 확인해야 합니다. 전역 프록시는 문제 범위를 좁힐 때 유용하지만 일상적인 분할 라우팅을 대신하지는 않습니다. 테스트가 끝나면 원래 모드로 되돌리고 로그를 다시 확인하세요.
"inbounds": [{ "listen": "127.0.0.1", "protocol": "socks" }]
시스템 프록시는 시스템 설정을 따르는 앱에 로컬 프록시를 제공하고, TUN은 가상 네트워크 인터페이스를 통해 트래픽을 받습니다. v2rayN의 TUN 지원 여부와 권한, 설정 방법은 플랫폼 및 사용하는 코어에 따라 확인해야 하며, 한 운영체제의 절차를 다른 운영체제에 그대로 적용하면 안 됩니다. v2rayNG와 v2flyNG는 Android VPN 인터페이스를 사용하므로 데스크톱 시스템 프록시 설정과는 다릅니다. 처음 테스트할 때는 트래픽을 가로채는 방식을 하나만 켜세요. 연결이 정상이라면 앱 적용 범위, LAN 예외 및 권한을 확인하세요. 여러 방식을 동시에 켜면 라우팅 경로를 파악하기 어려워질 수 있습니다.
"outbounds": [{ "protocol": "vmess" }]
클라이언트는 설정을 관리하고 코어는 프로토콜을 처리하므로 서로 같은 계층으로 볼 수 없습니다. v2rayN은 여러 코어를 관리할 수 있으며, 실제 선택은 설치된 구성 요소, 노드 유형 및 클라이언트 설정에 따라 달라집니다. v2rayNG는 Xray, v2flyNG는 V2Fly를 코어로 사용합니다. 두 앱을 범용 멀티 코어 전환 도구로 생각해서는 안 됩니다. 코어를 바꾸기 전에 전송 방식과 필드 호환성을 확인하고 작동 중인 설정을 보관하세요. 프로토콜 이름이 같더라도 확장 매개변수까지 모두 호환되는 것은 아닙니다. 알 수 없는 필드가 있다면 설정의 출처와 코어 지원 범위를 먼저 확인하세요.
"dns": { "servers": ["localhost"] }
DNS 설정은 도메인을 해석하는 방식을, 라우팅 규칙은 연결을 내보내는 경로를 결정하므로 함께 확인해야 합니다. 먼저 오류가 노드 서버의 도메인에서 발생했는지 대상 웹사이트 도메인에서 발생했는지 구분한 뒤, 리졸버에 접근하는 경로를 확인하세요. 세 클라이언트는 각자 사용하는 코어의 DNS 설정 기능을 따르므로 인터페이스의 스위치와 JSON 필드가 완전히 같은 것은 아닙니다. 위 예시는 키 이름과 로컬 해석 형식만 보여 주며 범용 라우팅 방법은 아닙니다. 브라우저의 암호화 DNS, 시스템 비공개 DNS 및 클라이언트 내장 DNS가 동시에 해석에 관여할 수 있습니다. 테스트할 때는 한 번에 변수 하나만 바꾸고 결과를 기록하세요.
"log": { "loglevel": "warning" }
로그를 확인할 때는 코어 미실행, 노드 연결 실패, 앱의 프록시 미사용을 먼저 구분하세요. 코어가 시작되지 않는다면 첫 번째 오류를 읽고 포트 충돌, 설정 문법 및 데이터 파일을 확인하세요. 연결 시간 초과가 발생하면 노드 주소와 네트워크 연결 상태를 확인해야 합니다. 세 클라이언트 모두 실행 정보를 확인할 수 있지만 로그 메뉴와 상세 수준은 다릅니다. 필요하면 로그 수준을 일시적으로 높여 문제를 한 번 재현한 뒤 원래대로 돌리세요. 로그를 공유하기 전에는 구독 주소, 사용자 식별 정보 및 노드 인증 정보를 삭제하고 오류 전후의 내용만 남기세요. 전체 설정을 공개된 문제 해결 자료로 올리지 마세요.
각 설정은 설정의 출처, 규칙 적용, 트래픽 진입 경로, 실행 코어 및 도메인 해석에 각각 영향을 줍니다. 문제를 해결할 때 모든 옵션을 한꺼번에 바꾸지 마세요. 먼저 노드 연결을 확인하고, 다음으로 앱 트래픽이 프록시로 전달되는지 확인한 뒤, 라우팅과 DNS가 예상대로 작동하는지 검증하세요. 각 단계의 결과를 기록해 두면 이후 설정을 바꿀 때 비교 기준으로 활용할 수 있습니다.
전체 플랫폼 설치 및 설정 가이드 보기 →3단계 빠른 시작
01 / IMPORT
클라이언트를 설치한 뒤 사용할 수 있는 구독 주소나 노드 공유 링크를 준비하세요. 구독 관리에서 그룹을 추가하고 주소를 입력한 다음 업데이트하여 노드 수와 이름이 실제로 바뀌었는지 확인합니다. 공유 링크는 클립보드 가져오기에, 구독 주소는 이후 업데이트에 적합합니다. 두 기능을 혼동하지 마세요.
업데이트에 실패하면 먼저 알림을 확인해 주소에 접근할 수 없는지, 내용 형식이 맞지 않는지, 구독이 만료되었는지 판단하세요. 클라이언트 설치가 끝났다고 연결 가능한 노드까지 생기는 것은 아닙니다. 목록이 비어 있다면 프록시 모드를 계속 바꾸지 말고 설정을 제공하는 곳부터 확인하세요.
02 / CONNECT
노드 하나를 활성 설정으로 선택한 다음 클라이언트의 실제 연결 테스트로 접속 가능 여부를 확인하세요. 지역 이름은 목록을 정리하는 데 도움이 될 뿐 연결 가능성을 보장하지 않습니다. 테스트가 끝나면 데스크톱에서는 시스템 프록시를 켜고, Android에서는 연결을 시작해 VPN 권한을 허용하세요.
처음 연결할 때는 이해하기 쉬운 라우팅 프리셋을 사용하고 LAN 접속을 유지하세요. 다른 프록시 앱, 브라우저의 수동 프록시 설정 및 여러 가상 인터페이스를 동시에 켜지 마세요. 트래픽 진입 경로가 적을수록 어떤 설정이 앱의 접속 경로를 바꿨는지 파악하기 쉽습니다.
03 / VERIFY
브라우저에서 프록시를 통해 접속할 페이지를 열고 외부 IP와 클라이언트 로그를 확인하세요. 페이지가 열린다는 것만으로는 충분하지 않습니다. 요청이 실제로 의도한 아웃바운드 규칙에 일치했는지도 확인해야 합니다. 분할 라우팅을 사용하면 직접 연결 사이트와 프록시 연결 사이트의 외부 IP가 다를 수 있습니다. 이는 규칙에 따른 결과이므로 각각 테스트하세요.
브라우저는 정상인데 다른 앱에서 연결되지 않는다면 노드를 바로 바꾸기 전에 해당 앱이 시스템 프록시를 사용하는지 확인하세요. 모든 앱에서 실패한다면 노드 연결 테스트와 코어 로그부터 다시 살펴보세요. 매번 한 가지 설정만 바꾸고 같은 테스트를 반복해야 원인과 결과를 명확히 파악할 수 있습니다.
클라이언트를 종료하기 전에 시스템 프록시를 끄거나 VPN 연결을 중지해, 중단된 서비스로 연결되는 설정이 남지 않도록 하세요. 다시 실행한 뒤에는 먼저 활성 노드가 있는지 확인하고 연결을 복구하세요. 기기 간 설정을 옮길 때는 구독 출처와 필요한 규칙만 옮기는 것이 좋습니다. 로컬 경로, 수신 포트 및 플랫폼 권한이 포함된 전체 설정을 다른 기기에 그대로 덮어쓰지 마세요.
전체 사용 가이드 보기 →Project V · V2Fly · Xray
PROJECT V
Project V는 네트워크 프록시 도구와 모듈식 설정을 중심으로 발전한 오픈 소스 생태계이며, V2Ray는 그 안에서 널리 사용되는 프로젝트 이름입니다. ‘V2Ray 클라이언트’를 검색하는 사용자가 찾는 것은 대개 노드를 관리하고 설정을 생성해 연결을 제어하는 그래픽 프로그램이지, 단독 실행하는 코어 파일이 아닙니다. v2rayN, v2rayNG 및 v2flyNG는 이 사용자 영역에 속하며 구독 관리, 매개변수 편집 및 실행 정보 표시를 담당합니다.
이 차이를 이해하면 문제도 계층별로 나눠 확인할 수 있습니다. 인터페이스에 설정이 저장됐는지, 생성된 설정을 코어가 받아들였는지, 시스템이나 앱이 트래픽을 연결 경로로 보냈는지를 각각 살펴보세요. 세 문제는 확인할 위치가 다르므로 모든 실패를 ‘클라이언트가 작동하지 않는다’고 단정할 필요는 없습니다.
CORE FAMILY
V2Fly는 V2Ray 관련 프로젝트의 커뮤니티 유지보수와 발전을 이어 왔으며, Xray는 관련 코드 기반에서 출발해 고유한 기능과 프로토콜 구현을 발전시켰습니다. 기본 설정 개념은 상당 부분 비슷하지만 독립적으로 발전하면서 지원 필드, 전송 조합 및 확장 기능은 완전히 같지 않습니다. 노드 설정은 실제 실행 중인 코어와 맞아야 합니다. 공유 링크의 접두어만 보고 모든 매개변수가 호환된다고 판단하지 마세요.
v2rayNG는 Xray를, v2flyNG는 V2Fly를 코어로 사용하며 v2rayN은 데스크톱에서 여러 코어를 선택할 수 있습니다. 코어를 선택할 때는 기존 노드의 요구 사항을 기준으로 삼으세요. 코어 이름을 속도 순위로 해석해서는 안 됩니다. 네트워크 경로, 서버 조건 및 로컬 트래픽 처리 방식도 사용 결과에 영향을 줍니다.
OPEN SOURCE
세 클라이언트 모두 오픈 소스로 코드를 제공합니다. 코어와 그래픽 인터페이스는 별개의 프로젝트입니다. V2Fly의 V2Ray 코어와 Xray 코어는 MPL 2.0 라이선스를 사용하며, 클라이언트 자체와 함께 제공되는 구성 요소에는 각자의 라이선스가 적용됩니다. 오픈 소스란 코드와 라이선스를 확인할 수 있다는 뜻이지, 모든 프로젝트에 같은 조건이 적용되거나 모든 설정 파일을 그대로 사용할 수 있다는 뜻은 아닙니다.
일상적인 사용에서는 설정의 의미를 이해하는 것이 중요합니다. 수정, 재배포 또는 통합을 할 때는 해당 구성 요소의 라이선스 전문을 확인하세요. 구독에 포함된 노드 주소, 인증 매개변수 및 서버 구성은 설정 제공처에서 결정하며 그래픽 클라이언트가 자동으로 제공하는 기능이 아닙니다. 소프트웨어 설치와 연결 설정 확보는 별개의 단계입니다.
UPDATE PATH
클라이언트 업데이트는 인터페이스, 구독 파싱 및 설정 생성 방식을 바꿀 수 있습니다. 코어 업데이트는 프로토콜 지원과 매개변수 요구 사항에 영향을 줄 수 있고, 규칙 데이터 업데이트는 도메인이나 IP 목록의 일치 결과를 바꿀 수 있습니다. 이 세 요소가 항상 동시에 바뀌는 것은 아닙니다. 업데이트 전에는 정상 작동 중인 노드, 프록시 진입 방식 및 사용자 규칙을 기록하세요. 업데이트 후 같은 대상을 다시 테스트해야 어느 계층에서 변화가 생겼는지 확인하기 쉽습니다.
구독 업데이트는 설정 목록을 다시 가져오는 기능일 뿐 앱 업그레이드가 아니며, 로컬 권한이나 포트 충돌을 자동으로 해결하지도 않습니다. 문제가 생기면 최근에 변경한 항목부터 확인한 다음 구독을 다시 확인할지, 코어를 조정할지, 규칙을 복원할지 결정하세요. 장기간 사용할 때는 필요한 설정 기록을 보관하되 인증 정보가 포함된 설정을 공개 문서에 올리지 마세요.
데스크톱에서 여러 노드와 라우팅을 관리해야 한다면 v2rayN을 먼저 살펴보세요. Android에서 기존 Xray 설정을 사용한다면 v2rayNG를, V2Fly 동작에 의존하는 설정이라면 v2flyNG를 확인하세요. 클라이언트 선택은 플랫폼, 코어 및 유지보수 방식을 기준으로 하고, 연결 품질은 실제 네트워크에서 테스트해야 합니다. 두 가지를 같은 기준으로 판단하지 마세요.
플랫폼 및 코어별 세 클라이언트 비교 →설정 가이드
포트 충돌, JSON 문법 오류, 알 수 없는 프로토콜 필드, geo 파일 누락 등 자주 발생하는 오류를 정리하고 v2rayN과 v2rayNG 로그에서 문제 위치를 찾아 수정하는 방법을 안내합니다.
문서 읽기 →LAN 우회와 중국 본토 대상 라우팅부터 전역 프록시까지 설명합니다. domain, ip, outboundTag를 조합하는 방법과 대표적인 라우팅 규칙 순서, 사용자 규칙 세트 예시를 확인하세요.
문서 읽기 →dns servers, domains 매칭 및 queryStrategy 필드를 살펴보고, 한국 국내 도메인은 로컬 DNS로, 해외 도메인은 원격 DNS로 해석하는 방법을 설명합니다. 흔히 발생하는 DNS 오염과 유출도 예방하세요.
문서 읽기 →구독을 가져온 직후라면 빠른 시작 가이드에 따라 노드와 시스템 프록시를 확인하세요. 연결은 정상이지만 라우팅 결과가 예상과 다를 때는 라우팅 및 DNS 문서를 읽어 보세요. 코어가 시작되지 않는다면 먼저 로그에 나타난 설정 오류를 해결해야 합니다. 리졸버와 라우팅 최적화로 기본적인 시작 조건을 대신할 수는 없습니다.
전체 문서 보기 →