download
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 먼저 운영체제와 CPU 아키텍처를 확인한 뒤 다운로드 페이지에서 맞는 설치 파일을 고르면 됩니다. 클라이언트 이름이 비슷해도 설치 파일 형식과 코어 기능까지 같은 것은 아닙니다.
v2rayN / Desktop · WPF
데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 Windows 데스크톱 환경을 유지합니다. 두 버전 모두 구독 관리, 활성 노드 선택, 프록시 설정에 사용할 수 있습니다. 운영체제 요구 사항과 인터페이스 취향에 맞춰 하나를 선택하면 되며, 같은 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.
처음 실행한 뒤 노드 목록과 로그가 정상인지 확인하고 시스템 프록시를 켜세요. 브라우저에서는 접속되지만 개발 도구가 연결되지 않으면 해당 도구의 프록시 설정을 확인해야 합니다. 프로그램 실행, 코어 작동, 앱 트래픽의 프록시 유입은 각각 따로 점검해야 합니다.
다운로드하기 →v2rayN / Apple Silicon · Intel
먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 컴퓨터 외관만 보고 판단하기보다 프로세서에 맞는 디스크 이미지를 선택하는 편이 정확합니다. 설치 후 응용 프로그램 폴더에서 실행하고, 처음 열 때 필요한 권한은 시스템 안내에 따라 처리하세요.
구독을 가져온 뒤 먼저 시스템 프록시로 브라우저 연결을 확인하고, 다른 트래픽 처리 방식은 그다음에 검토하세요. 터미널 도구는 데스크톱 네트워크 프록시 설정을 따르지 않을 수 있으므로 프록시 주소를 별도로 지정해야 합니다. 시스템 네트워크 옵션을 바꾸기 전에 기존 값을 기록하고, 클라이언트를 종료할 때 프록시 설정이 복원됐는지도 확인하세요.
다운로드하기 →v2rayNG / Xray · v2flyNG / V2Fly
Android에서는 v2rayNG를 우선 사용하고, V2Fly 코어가 필요한 설정에는 v2flyNG를 선택하세요. 비교적 최신 스마트폰은 대부분 arm64를 선택할 수 있습니다. 기기 아키텍처가 확실하지 않다면 다운로드 페이지에서 패키지 종류를 먼저 확인하세요. 두 앱은 코어와 옵션이 완전히 같지 않으므로 공유 링크를 가져올 수 있다는 이유만으로 설정이 호환된다고 판단하면 안 됩니다.
처음 연결할 때는 시스템 VPN 권한을 확인해야 합니다. 노드 설정은 연결 매개변수를 정하고, 앱 분할 설정은 프록시가 적용될 앱을 정하므로 서로 다른 기능입니다. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인한 다음, 로그에서 실제 연결 오류가 발생했는지 살펴보세요.
다운로드하기 →v2rayN / deb · rpm
Debian, Ubuntu 등에서는 보통 deb를, Fedora 등에서는 rpm을 선택하고 x64와 arm64도 구분해야 합니다. 패키지 형식을 맞춘 뒤에도 배포판의 데스크톱 환경과 실행 의존성이 충족되는지 확인하세요. GUI 클라이언트는 사용할 수 있는 데스크톱 세션에서 실행해야 합니다.
Linux 데스크톱의 시스템 프록시와 터미널 환경 변수는 서로 별개입니다. 먼저 로컬 SOCKS 포트로 연결을 테스트한 다음 데스크톱 네트워크 프록시를 설정하세요. TUN이 필요하면 권한, 라우팅, DNS도 확인해야 합니다. 단계별로 점검하면 데스크톱 설정 문제를 노드 장애로 오해하는 일을 줄일 수 있습니다.
다운로드하기 →다운로드 페이지에서 플랫폼별 패키지 종류와 적용 안내를 확인할 수 있습니다. 설치 파일을 선택한 뒤 빠른 시작 가이드로 돌아가 설정을 가져오세요. 홈페이지에서 특정 파일을 찾을 필요는 없습니다.
전체 클라이언트 보기 →features
구독은 설정을 가져오는 경로, 프록시 모드는 트래픽이 들어오는 경로, 라우팅은 나가는 경로를 정합니다. 먼저 세 계층을 구분한 뒤 필요에 따라 TUN을 켜거나 코어를 전환하세요. 아래는 설정 항목의 예시이며, 실제 명칭과 사용 가능 기능은 클라이언트에 따라 다릅니다.
구독 링크는 여러 노드 설정을 한 번에 가져올 때 사용하며, 연결 정보를 주기적으로 동기화해야 하는 경우에 적합합니다. v2rayN에서 구독 그룹을 만들고 주소를 입력해 저장한 다음 업데이트를 실행하고 활성 노드를 선택하세요. 공유 링크를 하나씩 붙여 넣는 것보다 그룹별로 출처를 구분하고 개별 업데이트나 비활성화가 쉽습니다. 업데이트는 보통 노드 목록을 대상으로 하며 로컬 라우팅 규칙 전체를 동기화하는 것은 아닙니다. 삭제하거나 덮어쓰기 전에 필요한 설정을 보관하세요. 구독 주소에는 접근 권한 정보가 포함될 수 있으므로 공개 스크린샷, 로그, 공유 문서에 노출하지 마세요.
설정 예시: 먼저 그룹을 저장한 뒤 구독 메뉴에서 업데이트를 실행하세요.
시스템 프록시는 시스템 네트워크 설정을 따르는 앱의 요청을 클라이언트로 전달합니다. 전역 또는 중국 본토 우회 같은 라우팅 모드는 클라이언트로 들어온 요청을 어떤 경로로 내보낼지 정합니다. 둘은 서로 다른 계층이므로 전역 라우팅을 켠다고 모든 프로그램이 자동으로 프록시를 사용하는 것은 아닙니다. 처음에는 시스템 프록시를 켜고 적절한 라우팅 프리셋을 선택한 뒤 브라우저로 확인하세요. 시스템 프록시는 TUN보다 적용 범위를 파악하기 쉬운 편이지만, 일부 명령줄 도구와 앱은 별도로 설정해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시가 해제되거나 원래 상태로 복원됐는지 확인하세요.
메뉴 예시: 시스템 프록시는 ‘모든 앱에 프록시 강제 적용’을 뜻하지 않습니다.
라우팅 분기는 조건에 따라 요청을 프록시, 직접 연결 또는 차단 경로로 보내며, 로컬 리소스와 원격 서비스를 함께 이용할 때 유용합니다. 먼저 클라이언트 프리셋을 사용하고, 꼭 필요한 경우에만 사용자 지정 규칙을 추가하세요. 전역 모드 전환과 달리 규칙은 도메인과 IP 범위까지 세밀하게 지정할 수 있지만, 매칭 순서와 DNS 조회, 분류 데이터에 유의해야 합니다. 먼저 앞쪽 규칙이 의도치 않게 먼저 적용되는지 확인하고 출구 태그가 존재하는지 살펴보세요. 한 번에 한 종류의 조건만 바꾸고 로그로 확인하면 규칙이 겹쳐 관리하기 어려워지는 일을 막을 수 있습니다.
규칙 예시: 분류 매칭은 사용하는 코어와 규칙 데이터에 따라 달라집니다.
TUN 모드는 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시 설정을 읽지 않는 앱에도 적용할 수 있습니다. 일반 시스템 프록시보다 낮은 계층에서 트래픽을 처리하므로 권한, 시스템 라우팅, DNS, 로컬 네트워크 접근에 영향을 줍니다. 먼저 일반 프록시 연결을 확인한 뒤 플랫폼 안내에 따라 TUN을 사용하세요. LAN 기기에 접속할 수 없거나 도메인 조회에 문제가 생기면 TUN을 끄고 비교 테스트한 다음 우회 범위와 DNS 설정을 점검하세요. TUN을 모든 연결 장애를 해결하는 기능으로 간주하면 안 됩니다. 사용 가능 여부는 클라이언트와 실행 환경에 따라 달라집니다.
옵션 예시이며 모든 플랫폼의 기본 설정이 같다는 뜻은 아닙니다.
클라이언트는 인터페이스와 설정 관리를 담당하고, 코어는 실제 프로토콜 처리와 트래픽 전달을 담당합니다. v2rayN은 Xray, V2Fly 등의 코어를 통해 관련 설정을 관리할 수 있지만, 코어마다 지원하는 프로토콜 매개변수와 확장 기능은 다릅니다. 클라이언트 이름만 보는 것보다 노드 요구 사항과 실제 사용하는 코어를 확인해야 호환성 문제를 파악하기 쉽습니다. 가져온 뒤 지원하지 않는 필드가 나타나면 프로토콜, 전송 방식, 보안 계층의 조합을 먼저 확인하고 이에 맞는 코어를 선택하세요. 코어를 바꾸면 설정 해석과 실행 동작이 달라질 수 있으므로 기존 설정을 보관하고 연결을 다시 확인해야 합니다.
선택 예시: 실제 프로토콜 지원 범위는 사용하는 코어의 구현에 따라 다릅니다.
quickstart
설치가 끝나도 설정이 완료된 것은 아닙니다. ‘설정 가져오기, 프록시 경로 선택, 연결 확인’ 순서로 진행하고 단계마다 한 종류의 문제만 점검하세요. 이렇게 하면 어느 단계에서 문제가 생겨도 정상으로 확인된 부분을 유지할 수 있습니다.
01 / import
사용 가능한 구독 링크나 공유 링크를 준비하세요. v2rayN에서는 구독 그룹을 만들고 주소를 저장한 뒤 업데이트를 실행합니다. v2rayNG에서는 구독 설정에서 소스를 추가하고 설정을 업데이트하세요. 주소를 입력란에 붙여 넣는 것만으로는 가져오기가 완료되지 않습니다. 목록으로 돌아가 설정이 실제로 표시되는지 확인하고 사용할 노드를 직접 선택하세요.
프로토콜 유형, 서버 포트, 전송 방식, 보안 계층이 설정 제공처의 안내와 일치하는지 확인하세요. 웹페이지 주소를 구독 주소로 사용하지 말고, 업데이트에 실패했다고 모든 그룹을 반복해서 삭제하지도 마세요. 먼저 주소에 연결할 수 없는지, 내용을 해석할 수 없는지, 가져온 뒤 목록이 비어 있는지 확인한 다음 업데이트 방식 변경이나 설정 제공처 확인을 결정하세요.
구독과 단일 노드 공유 링크의 차이는 관리 범위입니다. 구독은 보통 여러 설정을 한꺼번에 갱신하는 데 쓰고, 공유 링크는 특정 설정 하나를 가져올 때 사용합니다. 클라이언트는 원격 서버 계정을 제공하지 않으며, 소프트웨어를 설치한다고 연결 가능한 서버가 생기는 것도 아닙니다. 다음 단계로 진행하려면 사용할 설정이 있어야 합니다.
구독 가져오기 안내 보기 →02 / connect
데스크톱에서는 먼저 시스템 프록시를 켜서 시스템 설정을 따르는 앱의 트래픽을 로컬 수신 포트로 보내세요. Android에서는 연결을 시작할 때 시스템 안내에 따라 VPN 권한을 허용합니다. 그다음 사용 목적에 맞는 라우팅 프리셋을 선택하세요. 라우팅 프리셋은 출구 선택을 바꾸는 기능이지 앱이 프록시를 사용하도록 연결하는 단계를 대신하지 않습니다.
일상적인 웹 이용은 일반적인 분기 프리셋으로 시작해 로컬 리소스와 원격 사이트에 모두 접속되는지 확인하세요. 개발 도구, 터미널 및 일부 독립 앱은 시스템 프록시를 따르지 않을 수 있으므로 각 앱 설정에 프록시 유형, 주소, 포트를 지정해야 합니다. 특별한 요구가 없다면 처음부터 TUN을 켜거나 여러 사용자 지정 규칙을 겹쳐 설정할 필요는 없습니다.
로컬 수신 주소는 보통 루프백 주소를 사용합니다. 같은 LAN의 다른 기기에 프록시를 제공해야 하는 경우에만 수신 범위 개방과 방화벽 설정을 검토하세요. ‘LAN 연결 허용’은 일반적인 로컬 사용에 필수인 옵션이 아닙니다.
모드 선택 단계 보기 →03 / verify
먼저 테스트용 웹페이지를 브라우저에서 열고 클라이언트 로그에 해당 연결이 표시되는지 확인하세요. 연결 테스트 기능이 있다면 참고 자료로 활용할 수 있지만, 테스트 성공이 모든 앱에서 프록시를 사용한다는 뜻은 아닙니다. 실제 서비스 접속, 도메인 조회, 시스템 프록시 적용 범위는 각각 확인해야 합니다.
웹페이지가 열리지 않으면 시스템 시간, 노드 설정, 로컬 포트를 먼저 확인하고 시스템 프록시, DNS, 라우팅을 차례로 점검하세요. 브라우저는 정상인데 터미널이 실패하면 터미널 프록시 설정부터 확인하세요. 도메인 접속은 실패하지만 IP 주소 연결 테스트가 정상이라면 DNS 조회 경로를 집중적으로 살펴봐야 합니다. 한 번에 하나의 설정만 바꾸고 결과를 기록하면서 진행해야 문제 원인이 흐려지지 않습니다.
확인이 끝난 뒤 일상적으로 사용할 설정을 정리하세요. 작동하는 구독 그룹을 보관하고 자주 쓰는 라우팅 모드를 기록하며, 클라이언트 종료 후 시스템 네트워크 상태도 알아두세요. 이후 업데이트하거나 네트워크를 바꿀 때 같은 순서로 다시 확인하면 처음부터 재설치할 필요가 없습니다.
문제 해결로 이동 →ecosystem
V2Ray는 특정 GUI 앱 하나를 가리키는 이름이 아닙니다. Project V, V2Fly, Xray와 세 가지 클라이언트의 관계를 이해하면 설정을 어떤 프로그램에서 사용해야 하는지, 오류가 어느 계층에서 발생했는지 판단하는 데 도움이 됩니다.
Project V는 모듈형 프록시 도구를 중심으로 생태계를 이루며, V2Ray는 널리 사용되는 핵심 프로젝트입니다. 코어는 인바운드, 아웃바운드, 라우팅, 프로토콜 처리를 조합하고 GUI 클라이언트는 이를 구독 그룹, 노드 목록, 설정 화면으로 구성합니다. 사용자가 연결을 누른 뒤 실제 네트워크 요청을 처리하는 것은 보통 인터페이스 자체가 아니라 클라이언트가 실행하거나 통합한 코어입니다.
따라서 이름에 V2Ray가 들어간 설정이라도 클라이언트에 따라 결과가 다를 수 있습니다. 클라이언트의 가져오기 및 설정 생성 방식, 코어가 지원하는 매개변수가 모두 영향을 줄 수 있습니다. 문제를 확인할 때는 ‘링크를 가져올 수 있는가’, ‘코어가 시작되는가’, ‘요청이 목적지에 도달하는가’를 구분하세요. 이 세 단계를 하나의 연결 상태로 묶어 판단하면 안 됩니다.
V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 관련 기술을 바탕으로 발전한 코어 프로젝트입니다. 두 프로젝트는 기술적 기반을 공유하지만 프로토콜 기능과 설정 동작은 각각 발전해 왔습니다. VMess, VLESS, Trojan은 프로토콜 이름이고 WebSocket 등은 전송 방식, TLS와 REALITY 등은 보안 계층과 관련된 이름입니다. 서로 대체할 수 있는 용어가 아닙니다.
코어는 프로젝트 이름만 비교하지 말고 실제 설정 요구 사항을 기준으로 선택하세요. 특정 확장 매개변수를 사용하는 경우 해당 코어가 그 조합을 지원하는지 확인해야 합니다. 일반 설정도 코어를 바꾸기 위해 보안 매개변수를 임의로 수정하지 마세요. 프로토콜만으로 속도가 결정되는 것은 아니며 네트워크 경로, 서버 자원, 전송 방식, 클라이언트 환경이 모두 사용 경험에 영향을 줍니다.
v2rayN은 이 페이지에 소개된 세 가지 데스크톱 플랫폼에서 GUI 설정을 제공합니다. v2rayNG는 Xray 코어를 사용하는 Android 클라이언트이며, v2flyNG는 V2Fly 코어 기반 Android 클라이언트입니다. 세 클라이언트 모두 오픈소스 프로젝트지만 화면 구성, 가져오기 기능, 코어 통합 방식이 다릅니다. 한 클라이언트의 메뉴 경로를 다른 클라이언트에 그대로 적용할 수는 없습니다.
오픈소스란 해당 라이선스에 따라 소스 코드를 확인하고 사용하거나 개선에 참여할 수 있다는 뜻입니다. 클라이언트에 원격 프록시 서비스가 포함돼 있거나 모든 설정을 가져올 수 있다는 의미는 아닙니다. 설정 출처, 앱 권한, 기기 실행 환경을 별도로 확인해야 합니다. 일반 사용자라면 여러 클라이언트를 설치해 설정을 섞어 바꾸기보다 플랫폼과 프로토콜에 맞는 하나를 선택하는 편이 관리하기 쉽습니다.
클라이언트, 코어, 관련 데이터는 서로 다른 오픈소스 라이선스를 적용할 수 있습니다. 사용, 수정, 재배포 전에 관련 프로젝트의 라이선스 안내를 각각 확인해야 하며, ‘오픈소스’라는 포괄적인 표현으로 구체적인 조건을 대신할 수는 없습니다. 커뮤니티 유지 관리로 오류 수정과 기능 개선이 이어지지만, 업데이트가 현재 기기에 적합한지는 시스템 요구 사항과 변경 내역을 함께 확인해야 합니다.
일상적인 유지 관리에서도 업데이트 대상을 구분하세요. 구독 업데이트는 보통 원격에서 제공하는 노드 설정을 바꾸고, 클라이언트 업데이트는 인터페이스와 설정 생성 방식을 바꿀 수 있으며, 코어 업데이트는 프로토콜 구현에 영향을 줄 수 있습니다. 도메인 및 IP 분류 데이터는 또 다른 계층입니다. 변경 후에는 어느 부분이 업데이트됐는지 먼저 확인하고 로그를 다시 살펴보면 불필요한 롤백이나 재설치를 줄일 수 있습니다.
문서 선택: 웹페이지가 열리지 않는 문제라면 먼저 문제 해결에서 진입 경로, DNS 조회, 출구를 점검하세요. 데스크톱과 휴대폰에서 같은 노드 소스를 사용하려면 여러 기기 설정 동기화 방법을 확인하세요. 직접 라우팅 규칙을 작성하려면 라우팅 안내를 참고하세요. 모든 고급 옵션을 한꺼번에 살펴보기보다 문제에 맞는 문서부터 읽는 편이 원인을 찾기 쉽습니다.
journal
기본 연결을 완료한 뒤 구체적인 설정 문제를 살펴보세요. 아래 글은 프로토콜 작동 방식, 여러 기기 간 동기화, 사용자 지정 라우팅을 각각 다룹니다. 먼저 현재 문제가 어느 계층에 해당하는지 확인하고 알맞은 설정 방법을 선택하세요.
TLS 핸드셰이크, 내부 암호화의 중복, 흐름 제어를 바탕으로 XTLS Vision이 중복 암호화를 줄이는 방식과 REALITY가 별도 인증서를 요구하지 않는 이유를 설명합니다. 프로토콜 기능과 실제 연결 조건을 구분하고, 작동 방식을 이해한 뒤 노드 매개변수를 확인하세요.
글 읽기 →구독 링크를 통한 일괄 배포, 공유 링크와 QR 코드, 설정 파일 가져오기·내보내기의 세 가지 방법을 비교하고 데스크톱과 Android에서 노드와 규칙을 동일하게 유지하는 방법을 안내합니다. 노드와 로컬 설정은 동기화 범위가 다르므로 옮기기 전에 각각 보관할 항목을 확인하세요.
글 읽기 →domain 접두사 매칭, ip 및 geoip 범위, geosite 분류의 작성법과 규칙의 위에서 아래로 이어지는 매칭 순서, 자주 발생하는 충돌의 해결 방법을 설명합니다. 기본 분기 프리셋을 사용하고 있으며 특정 서비스에 규칙을 추가하려는 사용자에게 적합합니다.
글 읽기 →