오픈소스 클라이언트 다운로드 정보를 모으고, 한국어 단계별 안내로 구독 가져오기, 라우팅 규칙 및 코어 선택 방법을 설명합니다.
CLIENT SHELF / 다운로드
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. 다운로드 전에 운영체제와 프로세서 아키텍처를 확인한 뒤 가이드에 따라 설정을 가져오세요.
데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 데스크톱 레이아웃을 유지합니다. 먼저 시스템 설정에서 기기 종류를 확인한 다음 다운로드 페이지에서 설치 안내를 살펴보세요. 설치 파일 이름이 비슷하다는 이유만으로 사용 중인 프로그램을 바꾸지 마세요.
처음 실행한 뒤 구독 주소를 저장하고 그룹을 업데이트한 다음 노드를 선택해 시스템 프록시를 설정하세요. 기존 설정을 사용 중이라면 먼저 백업하고 기존 그룹, 라우팅 규칙, 로컬 포트를 유지하세요. 마이그레이션 중 여러 설정을 한꺼번에 바꾸지 않는 편이 좋습니다.
칩에 따라 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 시스템 메뉴에서 「이 Mac에 관하여」를 열어 칩 이름이 표시되는지 Intel 프로세서가 표시되는지 확인한 뒤 알맞은 패키지를 고르면 됩니다. 다운로드 페이지에서 두 아키텍처의 안내를 확인할 수 있습니다.
처음 실행할 때는 시스템 안내에 따라 권한을 확인하세요. 먼저 시스템 프록시로 브라우저에서 대상 페이지에 접속되는지 확인한 뒤 Tun이 필요한지 판단하세요. 가상 네트워크 어댑터 모드는 일반 시스템 프록시와 권한 및 라우팅 범위가 다르므로 처음부터 함께 켤 필요는 없습니다.
v2rayNG는 Xray 코어를 사용하며, v2flyNG는 v2fly 코어를 사용하는 대안입니다. 일반적인 기기라면 arm64 다운로드를 먼저 확인하세요. 프로세서 아키텍처를 확인하기 어렵다면 범용 버전 안내를 살펴보세요. 클라이언트를 고를 때는 앱 이름뿐 아니라 구독에 사용된 프로토콜 매개변수도 확인해야 합니다.
구독을 가져온 뒤 노드를 선택하고 연결을 시작한 다음 시스템의 VPN 권한 요청을 승인하세요. 앱을 닫은 뒤 연결이 끊긴다면 시스템의 배터리 및 백그라운드 관리 설정에서 제한 여부를 확인하세요. 백그라운드 권한은 연결 유지에 영향을 주지만 노드 설정 자체를 확인하는 일을 대신하지는 않습니다.
배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 뒤 기기가 x64인지 arm64인지 확인하세요. 패키지 형식과 프로세서 아키텍처는 별개의 항목입니다. 패키지 형식은 설치에 사용할 패키지 관리자를, 아키텍처는 프로그램이 현재 프로세서에서 실행될 수 있는지를 결정합니다.
그래픽 인터페이스가 실행되면 로컬 수신 포트와 데스크톱 환경의 프록시 설정부터 확인하세요. 일부 앱은 시스템 프록시를 자동으로 따르지 않으므로 앱에서 별도로 설정해야 합니다. Tun을 켜기 전에는 권한 요구 사항도 확인해 권한 문제를 구독 오류로 오해하지 않도록 하세요.
CONFIGURATION / 설정 순서
먼저 설정 하나가 정상적으로 작동하는지 확인한 뒤 트래픽 적용 범위를 조정하세요. 아래는 실제 설정 순서에 따라 정리한 안내입니다. 인터페이스 이름은 클라이언트와 시스템에 따라 조금씩 다를 수 있습니다.
구독은 클라이언트가 설정을 가져오는 주소이며, 연결이 이미 설정됐다는 뜻은 아닙니다. v2rayN에서 「구독 그룹 설정」을 열고 그룹 이름과 구독 주소를 입력한 뒤 저장하고 업데이트하세요. 그룹을 나누면 서로 다른 출처를 구별할 수 있어 오류가 발생했을 때 어느 그룹에서 문제가 생겼는지 확인하기 쉽습니다. 업데이트에 실패하면 링크가 만료되지 않았는지, 전체 주소가 제대로 복사됐는지 확인한 다음 「구독 업데이트(프록시 사용 안 함)」를 시도하세요. 이 옵션은 구독을 가져오는 네트워크 경로만 바꾸며 만료된 주소를 복구하지는 않습니다. 같은 링크를 반복해서 가져오면 항목이 중복될 수 있으니 주의하세요.
구독 가져오기 단계 보기 →구독 그룹 설정
구독 주소에 접속 인증 정보가 포함될 수 있으므로 공개적으로 공유하지 마세요.
먼저 노드를 선택하고 「시스템 프록시」에서 「시스템 프록시 자동 설정」을 선택하세요. 그러면 시스템 프록시 설정을 따르는 앱이 로컬 프록시 포트에 연결됩니다. 그렇다고 모든 프로그램에 트래픽이 적용되는 것은 아닙니다. 일부 앱은 프록시를 별도로 지정해야 하고, 다른 경우에는 가상 네트워크 어댑터로 트래픽을 처리하는 Tun이 필요할 수 있습니다. 처음에는 한 가지 방식만 사용해 브라우저 접속을 확인한 뒤 설정을 추가하세요. 클라이언트를 종료하기 전 「시스템 프록시 해제」를 선택하면 프로그램이 중지된 뒤에도 시스템이 로컬 포트를 가리키는 상황을 방지할 수 있습니다. Tun에 필요한 권한과 구성 요소는 해당 플랫폼 가이드에 따라 설정하세요.
연결 및 확인 단계 보기 →정적 예시이며, 옵션을 선택해도 현재 기기의 설정은 바뀌지 않습니다.
라우팅 규칙은 트래픽을 직접 연결, 프록시 또는 차단 중 어디로 보낼지 결정합니다. 시스템 프록시를 켜는 것과는 별개의 설정입니다. 클라이언트의 라우팅 설정에서 적절한 프리셋을 선택하고 로컬 네트워크는 직접 연결하도록 유지해 라우터나 프린터 접속이 원격 경로를 거치지 않게 하세요. 도메인 규칙을 추가할 때는 규칙 순서를 확인하고 대상 사이트에서 동작을 검증하세요. 먼저 일치한 규칙이 이후 규칙의 적용을 막을 수 있습니다. 일부 도메인에서만 문제가 생기면 도메인을 IP 주소로 변환하는 DNS도 확인하세요. 한 번에 한 항목만 바꾸면 DNS 조회 실패인지 출구 경로 선택 문제인지 구별하기 쉽습니다.
라우팅 및 프로토콜 정보 보기 →로컬 네트워크 우회
규칙 프리셋의 이름과 실제 동작은 사용 중인 클라이언트에 따라 다를 수 있습니다.
코어는 실제 연결을 처리하고, 클라이언트는 인터페이스에서 설정한 내용을 구성으로 변환합니다. 프로토콜 이름이 같아도 코어마다 전송 방식과 보안 매개변수를 모두 똑같이 지원하는 것은 아닙니다. REALITY나 특정 흐름 제어 매개변수가 포함된 설정을 사용한다면 클라이언트와 Xray의 지원 여부를 먼저 확인하세요. 기존 v2fly 설정은 원래 필드를 기준으로 호환성을 점검하세요. 전환하기 전에 현재 선택을 기록하고 저장 후 시작 로그를 확인한 다음 동일한 대상 페이지에서 연결을 테스트하세요. 모든 프로토콜을 한꺼번에 바꾸지 마세요. 연결 실패는 주소, 시간 설정 또는 서버 측 매개변수 불일치 때문일 수도 있습니다.
V2Fly와 Xray 비교 →프로토콜, 전송 방식, 보안 계층, 흐름 제어 매개변수를 확인한 뒤 알맞은 코어를 선택하세요.
여러 기기에서 동기화할 때는 다른 기기의 설정 전체를 덮어쓰기보다 유효한 구독을 함께 사용하는 것이 중요합니다. v2rayN과 v2rayNG에 같은 구독 주소를 각각 저장하고 업데이트하세요. 그렇다고 두 기기의 시스템 프록시, 앱별 라우팅 또는 백그라운드 권한까지 자동으로 동기화되는 것은 아닙니다. 가져온 뒤 프로토콜과 보안 매개변수가 유지됐는지 확인하고, 노드를 선택해 각 기기에서 별도로 테스트하세요. 기기를 옮기기 전에는 클라이언트의 백업 기능을 사용할 수 있지만 구독 주소와 내보낸 설정에 접속 인증 정보가 포함될 수 있으므로 안전한 곳에 보관하세요. 화면을 공유할 때는 주소와 식별 정보를 가리고 문제 해결에 필요한 정보만 남기세요.
데스크톱 및 Android 설정 안내 보기 →구독 내용이 동기화되어도 기기의 시스템 설정까지 동기화되는 것은 아닙니다.
PROJECT V / 오픈소스 생태계
세 가지 개념을 구분하면 다운로드와 문제 해결이 쉬워집니다. 클라이언트는 조작 화면을 제공하고, 코어는 연결을 처리하며, 프로토콜은 통신 방식을 정의합니다.
Project V는 V2Ray 생태계를 이해하는 출발점입니다. 프록시 통신, 전송 및 라우팅을 중심으로 기능을 구성하며, 일상적으로 사용하는 그래픽 클라이언트는 여기에 구독 관리, 노드 목록, 설정 화면을 더합니다. 따라서 V2Ray 공식 사이트나 클라이언트 다운로드를 검색할 때는 프로젝트 자료, 코어 안내, 일상적인 설정에 사용하는 앱 중 무엇을 찾는지 구분해야 합니다. 이 사이트는 자주 찾는 다운로드와 한국어 사용 안내를 한곳에 정리하며, 커뮤니티가 만든 안내 페이지를 모든 상위 프로젝트의 공식 배포 페이지와 동일시하지 않습니다.
V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 관련 코드 기반에서 출발해 독자적인 기능 방향으로 발전했습니다. 두 프로젝트는 공통된 배경이 있지만 이름만 다르고 설정이 완전히 같은 프로그램으로 볼 수는 없습니다. 기본 설정 개념 일부는 공유하지만 새 전송 방식, 보안 메커니즘, 지원 필드는 각각 확인해야 합니다. 한 코어의 설정을 다른 코어에 그대로 적용하면 필드를 인식하지 못하거나 동작이 달라질 수 있습니다. 이때는 클라이언트 화면만 바꾸기보다 먼저 오류 메시지를 확인하세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 그래픽 클라이언트입니다. v2rayN은 데스크톱용으로 그룹, 시스템 프록시, 라우팅을 관리하기 편리합니다. v2rayNG는 Xray 기반 연결 기능을 Android 기기에 제공하고, v2flyNG는 v2fly 기반 Android 클라이언트입니다. 클라이언트와 코어는 서로 다른 프로젝트에서 관리하며 업데이트 주기도 다를 수 있습니다. 따라서 앱 실행, 구독 가져오기, 연결 설정은 각각 별도로 확인해야 합니다.
오픈소스는 해당 라이선스에 따라 소스 코드가 공개된다는 뜻이지, 프로젝트 간 코드와 배포물을 조건 없이 함께 사용할 수 있다는 뜻은 아닙니다. 생태계에는 GPL 계열 라이선스와 MPL 2.0 등 여러 조건이 있으며, 구체적인 적용 범위는 각 프로젝트와 의존성의 라이선스 고지를 확인해야 합니다. 일반 사용자는 이러한 클라이언트를 무료로 사용할 수 있습니다. 코드를 수정하거나 재배포 또는 통합하려면 전체 생태계를 하나의 라이선스로 간주하지 말고 관련 라이선스를 확인하세요.
VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프로토콜 설계를 가리키며, REALITY는 보안 계층과 관련된 메커니즘입니다. 이 용어들을 서로 바꿔 쓸 수 있는 노드 종류로 취급해서는 안 됩니다. 실제 연결에는 전송 방식, 서버 이름, 인증서 검증 등 여러 매개변수가 함께 사용됩니다. 클라이언트에서 프로토콜 이름만 올바르게 선택해도 충분하지 않으며 나머지 필드도 서버 설정과 일치해야 합니다. 가져온 설정에서 매개변수가 빠졌다면 구독 형식이 해당 필드를 표현할 수 있는지, 현재 클라이언트가 이를 해석할 수 있는지 먼저 확인하세요.
지연 시간, 처리량, 리소스 사용량은 회선, 서버 부하, 기기 성능, 앱 동작에도 영향을 받습니다. 프로토콜 이름만 보고 특정 노드가 반드시 더 빠르다고 판단하거나 한 번의 테스트 결과를 지속적인 사용 경험으로 간주해서는 안 됩니다. 일상적으로 사용할 노드를 고를 때는 먼저 설정 호환성을 확인하고 실제 접속이 안정적인지 살핀 뒤 필요한 경우 대상 앱의 성능을 비교하세요. 모바일 기기에서는 백그라운드 관리와 배터리 제한도 고려해야 합니다. 연결이 자주 끊겨도 원인이 반드시 프로토콜에 있는 것은 아닙니다.
클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 앱 기능과 인터페이스를 바꾸고, 코어 업데이트는 프로토콜 지원과 연결 동작에 영향을 줍니다. 구독 업데이트는 설정 내용을 다시 가져옵니다. 구독 파싱 오류가 발생하면 주소와 응답 형식부터 확인하고 앱을 바로 재설치할 필요는 없습니다. 코어 실행에 실패했다면 로그에 표시된 설정 항목을 확인하세요. 브라우저만 접속할 수 없는 경우에는 시스템 프록시, 로컬 포트, 라우팅, DNS 순서로 범위를 좁혀 보세요.
설정을 바꾸기 전에 현재 상태를 기록하고, 프로그램을 업데이트하기 전에는 설정을 백업하세요. 테스트할 때는 같은 노드와 같은 대상 페이지를 사용하세요. 그러면 변경 사항마다 결과를 비교하고 필요하면 쉽게 되돌릴 수 있습니다. 문제를 다른 사람에게 설명할 때는 클라이언트, 운영체제, 선택한 코어, 오류 메시지, 이미 시도한 작업을 전달하면 됩니다. 구독 링크, 전체 식별 정보, 인증 정보가 포함된 화면은 공개하지 마세요. 프로토콜 및 코어 정보를 더 읽거나 첫 연결 가이드에 따라 하나씩 진행하세요.
READING / 설정 및 문제 해결
문제가 발생한 단계에 맞춰 읽어 보세요. 구독 업데이트 오류, 연결 후 접속 불가, 프로토콜 및 흐름 제어에 관한 설명을 확인할 수 있습니다.
구독 링크 만료, 형식 비호환, 프록시를 통한 업데이트 차단 등 흔한 원인을 정리하고 클라이언트 설정을 확인해 구독 파싱 오류를 단계별로 진단합니다.
구독 문제 해결 단계 보기 →「시스템 프록시 상태 → 로컬 포트 → 라우팅 규칙 → DNS 설정 → 노드 상태」 순서로 확인할 수 있는 인터넷 연결 문제 체크리스트입니다.
연결 문제 체크리스트 보기 →그림과 함께 REALITY가 실제 사이트의 TLS 핸드셰이크를 어떻게 활용하는지, Vision 흐름 제어가 TLS 내부의 중복 암호화를 줄여 처리 부담과 속도 저하를 완화하는 방법을 쉽게 설명합니다.
프로토콜 작동 원리 보기 →