데스크톱에서는 v2rayN을 사용하세요. 안드로이드에서는 v2rayNG를 먼저 확인하고, V2Fly 코어가 필요하면 v2flyNG를 선택하세요.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 처음 설치한다면 먼저 크로스 플랫폼 인터페이스를 갖춘 데스크톱 버전을 살펴보세요. 기존 사용 방식에 익숙하다면 WPF 버전 안내를 확인하면 됩니다. 설치 패키지를 고르기 전에 시스템 아키텍처를 확인하고, 런타임 설치 안내가 표시되면 다운로드 페이지의 요구 사항에 따라 필요한 구성 요소를 설치하세요.
다운로드 페이지로 이동 →v2rayN 데스크톱 클라이언트를 사용하세요. ‘이 Mac에 관하여’에서 칩을 확인한 뒤 Apple Silicon 또는 Intel에 맞는 설치 패키지를 선택하면 됩니다. 처음 실행할 때 표시되는 보안 안내와 시스템 프록시 권한은 운영체제 설정에서 처리하세요. 설치 문제를 확인할 때 설정을 반복해서 바꾸기보다 안내에 따라 각 항목을 차례로 설정하는 것이 좋습니다.
다운로드 페이지로 이동 →v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 대안으로 제공합니다. 기기 아키텍처에 맞춰 arm64 또는 범용 설치 패키지를 선택하세요. 처음 연결할 때는 VPN 권한을 허용해야 합니다. 장시간 백그라운드에서 사용하려면 배터리 최적화와 백그라운드 실행 권한도 확인하세요.
다운로드 페이지로 이동 →v2rayN은 deb 및 rpm 설치 패키지를 제공하며 x64와 arm64로 구분됩니다. 먼저 배포판의 패키지 형식을 확인한 다음 프로세서 아키텍처에 맞는 패키지를 선택하세요. 그래픽 데스크톱의 프록시 설정과 터미널 프로그램의 프록시 환경은 서로 독립적이므로 설치 후 실제로 사용할 앱에서 각각 확인해야 합니다.
다운로드 페이지로 이동 →클라이언트는 설정을 정리하고 코어를 실행하지만, 연결 매개변수는 사용할 수 있는 서버 설정을 통해 제공되어야 합니다. 설치를 마쳤다고 바로 연결할 수 있는 것은 아닙니다. 구독 주소, 공유 링크, 직접 입력한 서버 매개변수 중 하나 이상을 준비해야 합니다. 구독에는 인증 정보가 포함되는 경우가 많으므로 계정 정보처럼 안전하게 보관하고 옮기세요.
하나의 구독을 여러 기기에 가져올 수 있지만, 그대로 사용할 수 있는지는 구독 형식과 클라이언트의 파싱 기능, 코어의 지원 범위에 따라 달라집니다. 컴퓨터와 휴대전화에서 설정 항목의 이름이 같더라도 앱별 설정이나 시스템 프록시 설정까지 구독과 함께 동기화되는 것은 아닙니다.
전체 클라이언트 보기 →설정의 출처, 트래픽 경로, 앱 연결 방식을 구분해 이해하세요. 아래 내용은 설정 안내이며, 예시 화면은 설명용입니다.
v2rayN의 ‘구독 그룹 설정’에서 새 그룹을 만들고 메모와 구독 주소를 입력한 뒤 저장하고 ‘구독 업데이트’를 실행하세요. 그룹은 설정 출처를 구분하는 데 쓰이고, 메모를 남기면 나중에 원하는 그룹을 쉽게 찾을 수 있습니다. 공유 링크를 하나씩 붙여 넣는 방식과 달리 서버에서 항목을 변경해도 다시 가져오면 되므로 개별 항목을 일일이 수정할 필요가 없습니다. 업데이트 결과가 비어 있으면 주소가 완전한지, 구독이 유효한지 확인한 다음 로그를 살펴보세요. 기존 그룹을 서둘러 삭제하지 마세요. 원래 설정을 남겨 두면 문제를 확인하는 동안 같은 작업을 반복할 가능성이 줄어듭니다.
v2rayN의 ‘라우팅 설정’에서는 도메인, 주소, 포트에 따라 아웃바운드 방향을 지정합니다. 규칙은 일반적으로 위에서 아래 순서로 적용되므로, 범위가 넓은 규칙을 앞에 두면 뒤에 있는 세부 조건이 적용되지 않을 수 있습니다. 먼저 규칙 세트가 정상적으로 작동하는지 확인한 뒤 사설 주소의 직접 연결과 다른 아웃바운드 경로를 설정하세요. 전역 모드 전환은 임시 비교 테스트에만 사용하고, 장기적인 트래픽 분할을 대신하지 않도록 하세요. 시스템 프록시와 달리 라우팅은 이미 코어에 들어온 트래픽을 처리합니다. 앱이 로컬 프록시에 연결되어 있지 않다면 라우팅을 바꿔도 자동으로 연결되지는 않습니다.
geoip:privatedirect데스크톱용 v2rayN에서 ‘시스템 프록시 자동 설정’을 선택하면 현재 운영체제의 프록시 설정이 바뀌고, 해당 설정을 따르는 앱이 로컬 프록시로 연결됩니다. ‘시스템 프록시 해제’는 운영체제 수준의 프록시 설정을 제거하고, ‘시스템 프록시 변경 안 함’은 기존 설정을 유지합니다. 시스템 프록시가 모든 트래픽을 처리하는 것은 아닙니다. 자체 네트워크 스택을 사용하는 앱은 프록시를 별도로 지정해야 할 수 있습니다. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면 앱이 중지된 로컬 포트에 계속 연결되는 일을 방지할 수 있습니다. 라우팅 모드는 클라이언트에서 별도로 선택해야 합니다.
코어는 실제 연결을 설정하고, 인터페이스는 설정을 생성하고 관리합니다. v2rayN은 여러 코어를 사용할 수 있으므로 전환하기 전에 프로토콜, 전송 방식, 보안 계층의 지원 범위를 확인하세요. 설정에 REALITY 같은 기능이 포함되어 있다면 해당 매개변수를 인식하는 코어가 필요합니다. 항목을 가져왔다는 이유만으로 연결 호환성이 보장되는 것은 아닙니다. Xray와 V2Fly는 일부 설정 개념을 공유하지만 기능 발전 방향은 완전히 같지 않습니다. 실행 오류가 발생하면 로그에서 지원되지 않는 필드를 먼저 확인한 뒤 매개변수를 조정할지 코어를 바꿀지 결정하세요. 근거 없이 코어를 반복해서 전환하지 않는 것이 좋습니다.
v2rayNG의 앱별 프록시는 VPN 인터페이스를 통해 연결할 앱을 선택하는 기능으로, 데스크톱의 시스템 프록시와는 다릅니다. 설정에서 앱별 프록시 옵션을 열고, 선택한 앱을 우회할지 선택한 앱에만 프록시를 적용할지 먼저 정한 다음 앱 목록을 선택하세요. 두 방식은 의미가 반대이므로 변경한 뒤 연결을 다시 설정하고 앱별로 확인해야 합니다. 이 기능은 앱 연결 범위를 정하는 것으로 도메인 라우팅을 대신하지 않습니다. 프록시에 연결된 앱에도 라우팅 규칙은 계속 적용됩니다. 백그라운드에서 연결이 끊기면 운영체제의 배터리 최적화 설정도 별도로 확인하세요.
DNS 설정은 도메인을 어떻게 해석할지 정하고, 라우팅 규칙은 트래픽을 어느 아웃바운드로 보낼지 결정합니다. 서로 연관되어 있지만 대신 사용할 수는 없습니다. 먼저 클라이언트의 기본 설정으로 기본 연결이 정상인지 확인한 뒤 실제 사용 환경에 맞게 DNS 서버와 도메인 정책을 조정하세요. 브라우저에 내장된 암호화 DNS는 다른 경로로 도메인을 확인할 수 있으므로 문제를 확인할 때는 앱 설정도 함께 기록해야 합니다. 여러 DNS 옵션을 한꺼번에 바꾸지 마세요. 변경 전 값을 보관하고 매번 조정 후 도메인 접속과 연결 로그를 각각 확인해야 어느 계층에서 변화가 생겼는지 판단할 수 있습니다.
geositegeoip클라이언트 업데이트에 따라 설정 항목 이름이 달라질 수 있습니다. 조작할 때는 기능을 기준으로 찾으세요. 구독은 설정을 가져오고, 코어는 설정을 실행합니다. 시스템 프록시나 VPN 인터페이스는 앱 트래픽을 클라이언트로 전달하고, 라우팅은 아웃바운드 방향을 결정합니다. 이 네 계층을 나눠 기록해 두면 ‘가져오기는 했지만 접속되지 않는’ 상황에서도 증상과 가장 가까운 계층부터 확인할 수 있습니다.
프로토콜 및 코어 선택 참고 →먼저 반복 가능한 연결 절차를 완성한 뒤 규칙을 추가하고 코어를 전환하거나 DNS를 조정하세요.
설치 후 클라이언트를 열어 기본 화면이 정상적으로 표시되는지 확인하세요. v2rayN에서는 ‘구독 그룹 설정’을 열고 그룹을 추가한 뒤 구독 주소를 저장하고, 구독 메뉴에서 업데이트를 실행합니다. 주소만 저장하고 업데이트하지 않으면 목록에 항목이 표시되지 않습니다. 단일 공유 링크를 사용한다면 전체 내용을 복사한 다음 클립보드에서 가져오기 기능을 이용하세요.
v2rayNG에서는 기본 화면의 추가 메뉴에서 가져오기 방식을 선택한 뒤 구독을 업데이트할 수 있습니다. 가져온 후 프로토콜 유형, 서버 주소, 포트, 전송 설정을 확인하세요. 구독 주소를 서버 주소 입력란에 넣으면 안 됩니다. QR 코드나 클립보드 내용에도 인증 정보가 포함될 수 있으므로 화면을 캡처하기 전에 해당 항목을 가리세요.
목록에서 사용할 설정을 선택한 뒤 라우팅 방식을 확인하세요. 처음에는 여러 조건을 한꺼번에 바꾸지 말고 클라이언트의 기본 규칙을 유지하는 것이 좋습니다. 데스크톱에서는 ‘시스템 프록시 자동 설정’을 선택해 시스템 프록시를 따르는 앱을 연결하세요. 안드로이드에서는 연결을 시작할 때 운영체제에 표시되는 VPN 권한 요청을 읽고 허용하세요.
시스템 프록시와 규칙 모드는 각각 앱 연결과 아웃바운드 선택을 제어하므로 서로 대신 사용할 수 없습니다. 브라우저에 별도 프록시가 설정되어 있다면 이전 포트를 계속 가리키는지 확인하세요. 테스트 중에는 프록시 설정을 변경할 수 있는 다른 프로그램을 먼저 종료해 설정이 서로 덮어쓰이는 일을 줄이세요.
클라이언트를 시작한 뒤 설정 파싱 실패, 포트 사용 중, 연결 수립 오류가 로그에 표시되는지 먼저 확인하고, 실제 사용할 앱으로 대상 서비스에 접속해 보세요. 설정 항목이 목록에 표시되거나 화면에 실행 중이라고 나타나는 것만으로는 앱에서의 연결이 확인된 것이 아닙니다. 테스트에 성공하면 현재 설정, 라우팅 모드, 프록시 연결 방식을 기록해 이후 조정의 기준으로 삼으세요.
특정 앱에서만 실패한다면 해당 앱이 시스템 프록시를 따르는지, 앱별 규칙에서 제외되었는지, 별도 DNS를 사용하는지 먼저 확인하세요. 모든 앱에서 실패한다면 서버 매개변수와 로컬 연결 로그를 확인하세요. 한 번에 하나의 조건만 변경하고 결과를 확인한 뒤 다음 항목을 조정하세요.
클라이언트를 업데이트하기 전에 기존 설정과 필요한 그룹 정보를 저장하세요. 구독은 다시 가져올 수 있지만 수동 라우팅, 앱 목록, 인터페이스 설정은 구독에 포함되지 않을 수 있습니다. 복원할 때도 기본 연결부터 확인한 다음 사용자 지정 항목을 복구하세요. 이전 설정을 한꺼번에 적용하면 기존 문제가 새 환경에 그대로 이어질 수 있습니다.
전체 가이드 보기 →Project V는 V2Ray의 기반을 제공했습니다. V2Fly는 커뮤니티 주도로 이를 이어 왔고, Xray는 같은 기반에서 별도의 코어 계열로 발전했습니다. 클라이언트는 설정에 접근하는 창구이며, 실제 설정을 실행하는 부분은 코어입니다.
V2Ray는 인바운드, 아웃바운드, 라우팅, 전송 등의 기능을 하나의 설정 체계로 구성하며, 그래픽 클라이언트는 이 설정을 메뉴에서 조작할 수 있도록 변환합니다. V2Fly와 Xray는 여러 개념을 이어받아 문서에 같은 필드명과 아웃바운드 태그가 반복해서 등장합니다. 기반을 공유한다는 점은 설정을 이해하는 데 도움이 되지만, 모든 매개변수를 다른 코어에 그대로 복사해도 된다는 뜻은 아닙니다.
코어를 선택할 때는 먼저 서버에서 제공하는 프로토콜과 전송 방식의 조합을 확인한 뒤, 클라이언트가 해당 필드를 빠짐없이 저장할 수 있는지 살펴보세요. 한 코어에서 지원되는 기능이 다른 코어에서도 같은 이름과 기본값, 처리 방식으로 제공된다고 볼 수는 없습니다. REALITY, 전송 방식, 구독 호환성의 차이는 프로토콜 참고 페이지에서 사용 사례별로 확인할 수 있습니다.
v2rayN은 데스크톱용으로 구독 그룹, 라우팅, 시스템 프록시를 통합 관리하고 다양한 코어에 맞는 설정 작업을 지원합니다. v2rayNG는 안드로이드용이며 Xray 코어를 사용하고, 시스템 VPN 인터페이스를 통해 앱 트래픽을 연결합니다. v2flyNG도 안드로이드용으로 V2Fly 코어를 선택할 수 있습니다. 이름만 비교하기보다 운영체제와 프로토콜 요구 사항을 기준으로 선택하세요.
세 클라이언트 모두 오픈 소스 프로젝트로 코드를 공개합니다. 클라이언트, 코어, 함께 제공되는 구성 요소는 각기 다른 오픈 소스 라이선스를 적용할 수 있으므로 사용, 재배포, 수정 전에 해당 라이선스를 각각 확인하세요. 오픈 소스는 코드와 라이선스를 공개하는 방식에 관한 설명이며, 다운로드 출처나 설정 내용, 시스템 권한을 일상적으로 확인할 필요가 없어지는 것은 아닙니다.
구독을 업데이트하면 일반적으로 사용 가능한 설정과 관련 매개변수가 바뀌지만 클라이언트가 자동으로 업그레이드되지는 않습니다. 클라이언트 업데이트는 화면을 변경하거나 가져오기 문제를 수정하고 코어 연동을 업데이트할 수 있습니다. 규칙 리소스 업데이트는 도메인 및 주소 분류에 영향을 줍니다. 세 가지를 따로 관리하고 변경 사항도 각각 기록해야 접속 동작의 원인이 무엇인지 파악할 수 있습니다.
장기간 사용할 때는 검증된 설정 기준을 유지하세요. 업데이트 후에는 구독 항목, 현재 선택한 설정, 라우팅 방식을 확인한 다음 시작 로그를 살펴보세요. 이전 상태로 되돌려야 한다면 방금 변경한 계층부터 복원하는 것이 좋습니다. 모든 문제를 ‘구독 다시 업데이트’로 해결하려 하면 포트 충돌, 권한 제한, 앱 연결 문제는 해결되지 않을 수 있습니다.
V2Ray 내비게이터는 세 가지 클라이언트의 다운로드 경로, 설정 안내, 프로토콜 정보를 정리한 독립적인 사용 참고 사이트이며 해당 클라이언트의 공식 웹사이트가 아닙니다. 페이지는 일반적인 그래픽 인터페이스 사용 절차를 중심으로 작성했습니다. 설치 요건, 메뉴 이름, 이용 가능한 기능은 실제 클라이언트에서 확인해야 합니다.
모든 기기에 통하는 단 하나의 프로토콜 선택 기준은 없습니다. VMess, VLESS, Trojan, Shadowsocks는 매개변수 구조가 서로 다릅니다. REALITY는 보안 계층과 관련된 기술이므로 프록시 프로토콜과 같은 계층의 대체 항목으로 보면 안 됩니다. 먼저 서버에서 제공한 조합을 정확히 가져온 뒤 리소스 사용량, 모바일 백그라운드 제한, 유지 관리 부담을 고려하세요. 특정 이름만 좇는 것보다 안정적인 설정을 구성하기 쉽습니다.
기기 간 설정 이전, 안드로이드 백그라운드 실행, 데스크톱 권한 등 실제 사용 상황별 설정 정보를 확인하세요.
컴퓨터와 휴대전화 간 설정을 동기화하는 방법을 비교합니다. 구독 링크 공유, QR 코드나 공유 링크를 통한 이전, 백업 파일 내보내기 및 가져오기를 살펴보고 각각에 적합한 상황과 주의 사항을 안내합니다.
v2rayNG 첫 연결 시 VPN 권한을 허용하는 방법, 백그라운드 연결이 끊기지 않도록 시스템의 배터리 최적화 예외 목록에 클라이언트를 추가하는 방법, 앱별 프록시의 우회 및 선택 앱만 프록시에 연결하는 설정을 안내합니다.
macOS에서 v2rayN을 설치하는 전체 과정을 설명합니다. ‘개발자를 확인할 수 없음’ 경고가 표시될 때 개인정보 보호 및 보안 설정에서 앱을 허용하는 방법과 네트워크 확장 및 시스템 프록시 권한 설정 위치도 확인할 수 있습니다.