클라이언트 기능 및 설정 메뉴
기기와 코어를 먼저 정한 다음 구독, 트래픽 분기 및 트래픽 처리 방식을 설정하세요. 화면은 설정 예시이며 항목 이름은 클라이언트 업데이트에 따라 달라질 수 있습니다.
v2rayN은 구독, 서버 설정, 라우팅 규칙과 실행 로그를 하나의 데스크톱 화면에서 관리합니다. 설치 후 로컬 수신 포트를 확인하고 서비스 제공자가 안내한 링크를 가져온 다음, 사용할 설정을 선택해 코어를 실행하세요. 시스템 프록시는 시스템 설정을 따르는 브라우저와 앱에 적합하며, 터미널 도구에는 프록시 주소를 따로 지정할 수 있습니다. 데스크톱 버전은 운영체제가 달라도 익숙한 방식으로 사용할 수 있지만, 파일 경로와 네트워크 권한, TUN 권한은 시스템별로 확인해야 합니다. 다른 기기의 실행 환경을 그대로 적용할 수는 없습니다.
데스크톱 설정 단계 보기 →v2rayNG는 Xray 코어를 사용하는 Android 클라이언트로, 휴대전화에서 구독을 가져오거나 공유 QR 코드를 스캔하고 라우팅 모드를 선택할 수 있습니다. 처음 연결을 시작하면 시스템에서 VPN 연결 권한을 요청합니다. 허용해야 클라이언트가 해당 트래픽을 처리할 수 있습니다. 데스크톱의 시스템 프록시와 달리 Android에서는 일반적으로 로컬 VPN 인터페이스를 사용합니다. 일부 앱만 처리하려면 앱별 프록시 설정을 확인하세요. 연결이 끊기면 먼저 로그와 시스템의 배터리 제한을 살펴본 뒤 구독을 확인하세요. 백그라운드 프로세스가 중지된 상황을 서버 문제로 오인하지 않도록 주의해야 합니다.
Android 설치 파일 선택 →v2flyNG는 V2Fly 코어가 필요한 Android 환경에서 선택할 수 있습니다. 선택 기준은 화면이 비슷한지가 아니라 설정과 코어의 호환성입니다. 가져오기 전에 프로토콜, 전송 방식 및 보안 설정을 확인하세요. Xray에서 사용할 수 있는 항목이라고 해서 V2Fly에서도 같은 의미로 작동하는 것은 아닙니다. 이미 v2rayNG 설정이 있다면 기존 구독을 보관하고, 일부 설정만으로 가져오기와 연결을 테스트하세요. 두 Android 클라이언트의 권한과 설정은 각각 관리하고, 테스트 중에는 VPN 인터페이스 충돌을 피하도록 한 번에 하나만 실행하세요.
클라이언트 3종 비교 보기 →구독 주소는 여러 서버 설정을 가져오는 데 사용하며, 클라이언트 자체나 단일 공유 링크와는 다릅니다. 구독 그룹 설정에 전체 주소와 알아보기 쉬운 이름을 입력하고 저장한 뒤 구독을 업데이트하세요. 업데이트 성공은 설정을 가져왔다는 뜻일 뿐, 연결 가능 여부는 별도로 확인해야 합니다. 업데이트에 실패하면 주소가 잘리지 않았는지, 만료되지 않았는지, 현재 네트워크에서 구독 서버에 접속할 수 있는지 먼저 확인하세요. 그다음 프록시를 통한 업데이트가 필요한지 판단하면 됩니다. 구독 링크에 접근 정보가 포함될 수 있으므로 공개 스크린샷이나 채팅, 문제 보고서에 노출하지 마세요.
구독 업데이트 문제 해결 보기 →라우팅 규칙은 연결을 직접 연결할지, 프록시를 사용할지, 차단할지 결정합니다. 일반적으로 위에서부터 순서대로 확인하며 먼저 일치하는 규칙이 적용됩니다. 처음 설정할 때는 LAN 및 사설 주소 우회부터 시작해 프린터, 라우터 관리 페이지, 로컬 개발 서버에 영향을 주지 않도록 하세요. 도메인별로 트래픽을 분기해야 한다면 범위를 명확히 정한 규칙을 추가하고 해당 아웃바운드 태그가 있는지 확인하세요. DNS는 도메인 확인과 일부 규칙의 일치 여부에 영향을 줄 수 있으므로 분기 문제를 해결할 때 DNS 설정도 함께 점검해야 합니다. 시스템 프록시가 켜져 있는지만 확인해서는 충분하지 않습니다.
routing 필드 설명 보기 →TUN 모드는 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시 설정을 읽지 않는 앱에 적합합니다. 다만 잘못된 서버 설정을 고쳐 주지는 않습니다. 먼저 로컬 프록시로 연결이 되는지 확인한 뒤 TUN을 켜면 문제 범위를 좁히기 쉽습니다. 데스크톱 운영체제에서는 추가 네트워크 권한이나 관리자 권한이 필요할 수 있으며, Linux에서는 가상 인터페이스, 라우팅 테이블과 DNS 변경도 확인해야 합니다. 활성화 후 LAN 접속에 문제가 생기면 TUN을 끄고 기존 네트워크 상태를 복구한 다음 우회 규칙을 점검하세요. 코어, DNS, 라우팅을 한꺼번에 변경하면 문제를 재현하기 어려워집니다.
모드 선택 및 확인 방법 보기 →클라이언트 다운로드 및 설치
데스크톱에서는 v2rayN, Android에서는 먼저 v2rayNG를 확인하세요. 설치 파일 형식, 칩 아키텍처, 클라이언트 코어는 서로 다른 선택 기준입니다.
v2rayN은 차세대 크로스 플랫폼 인터페이스 버전과 기존 WPF 버전을 제공합니다. 처음 설치한다면 데스크톱 버전을 먼저 살펴보세요. WPF 사용 방식에 익숙하다면 실행 환경에 맞춰 선택할 수 있습니다. 두 버전의 인터페이스가 다르더라도 구독 서비스가 달라지는 것은 아닙니다. 연결 여부는 설정 내용과 코어 호환성에 따라 달라집니다.
실행에 문제가 생기면 런타임 환경, 폴더 쓰기 권한, 보안 소프트웨어 알림을 먼저 확인하세요. 설정 폴더를 반복해서 덮어쓰지 마세요. 업데이트 전 개인 설정을 저장하고 새 인터페이스의 수신 포트가 기존과 같은지 확인하세요.
v2rayN 설치 파일은 Apple Silicon과 Intel 칩에 따라 다릅니다. 먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 알맞은 아키텍처를 선택하세요. 앱을 처음 열 때 개발자 관련 안내를 확인해야 할 수 있으며, 네트워크 및 프록시 설정 권한도 표시되는 안내에 따라 허용해야 합니다.
설치가 끝나도 시스템 프록시가 자동으로 활성화되는 것은 아닙니다. 클라이언트에서 코어를 실행한 다음 프록시 모드와 브라우저 요청을 확인하세요. 권한 안내가 표시되면 가이드에 따라 항목별로 처리하고, 시스템 보안 기능을 바로 끄지는 마세요.
v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 위한 대안입니다. 최근 출시된 대부분의 스마트폰은 arm64 패키지를 선택하면 됩니다. 기기의 아키텍처를 모르겠다면 먼저 범용 버전 안내를 확인하세요. 클라이언트 이름이 비슷하다고 해서 지원하는 프로토콜 필드까지 완전히 같다고 단정하면 안 됩니다.
처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. VPN 인터페이스를 사용하는 다른 앱을 함께 실행하면 연결이 바뀔 수도 있습니다.
v2rayN의 deb 패키지는 해당 패키지 관리 체계를 사용하는 배포판용이며, rpm 패키지는 다른 계열의 배포판에서 사용합니다. x64와 arm64도 구분해야 합니다. 패키지 형식과 프로세서 아키텍처를 혼동하지 않도록 배포판, 프로세서 아키텍처, 데스크톱 환경을 먼저 확인한 뒤 설치 파일을 선택하세요.
Linux에서는 앱마다 프록시 설정을 읽는 방식이 다릅니다. 데스크톱 프록시, 터미널 환경 변수, 앱 자체의 프록시 설정을 각각 확인하세요. 더 넓은 범위의 트래픽 처리가 꼭 필요한 경우에만 TUN 모드와 관련 네트워크 권한을 고려하세요.
첫 연결 단계
클라이언트는 설정을 읽고 프록시를 실행하지만 사용할 수 있는 서버를 자동으로 제공하지는 않습니다. 사용 권한이 있는 구독 주소나 공유 링크를 준비한 다음 순서대로 진행하세요.
첫 테스트는 설정을 최대한 단순하게 유지하세요. 활성 설정 하나, 프록시 연결 방식 하나, 명확한 테스트 요청 하나로 시작하면 됩니다. 연결이 안정된 뒤 복잡한 분기 규칙과 자동 업데이트를 추가하면 문제가 생겼을 때 원인을 찾기 쉽습니다.
전체 가이드 보기 →구독 그룹에 전체 주소를 입력하고 저장한 뒤 업데이트하세요. 단일 공유 링크는 해당 가져오기 메뉴에서 추가하면 됩니다. 설정 항목이 나타나면 프로토콜, 서버 주소, 전송 설정을 확인하세요. 구독 업데이트 실패와 설정 연결 실패는 서로 다른 단계의 문제이므로 각각 로그를 확인해야 합니다. 구독을 반복해서 업데이트하는 것만으로 해결되지는 않습니다.
테스트할 설정을 활성 항목으로 지정한 뒤 연결을 시작하세요. 데스크톱에서는 먼저 시스템 프록시나 앱별 프록시를 사용하고, Android에서는 VPN 권한을 허용하세요. 실제 연결 테스트는 현재 설정의 사용 가능 여부를 확인하는 데 도움이 되지만 결과는 테스트 대상과 네트워크 상태에 따라 달라집니다. 한 번의 테스트 결과만으로 설정 그룹 전체를 삭제하지 마세요.
브라우저에서 테스트 페이지를 연 다음 프록시 주소를 명시한 명령으로 요청을 확인하세요. 브라우저에서는 되지만 터미널에서는 안 된다면 먼저 터미널에 프록시가 설정되어 있는지 확인해야 합니다. 둘 다 안 된다면 코어 로그, 로컬 포트, 원격 연결을 점검하세요. 한 번에 설정 하나만 바꾸고 문제를 재현할 수 있는 순서를 기록해 두세요.
Project V 오픈 소스 생태계
클라이언트는 설정을 관리하고 코어는 이를 실행합니다. 이 관계를 이해하면 클라이언트 이름만 기억하는 것보다 선택과 문제 해결에 도움이 됩니다.
그래픽 클라이언트
v2rayN · v2rayNG · v2flyNG프록시 코어 계열
Xray · V2Fly구체적인 기능은 클라이언트가 사용하는 코어와 해당 코어의 설정 지원 여부에 따라 달라집니다.
Project V는 네트워크 프록시 기능을 중심으로 형성된 오픈 소스 프로젝트 생태계이며, V2Ray는 그 안에서 널리 알려진 핵심 이름입니다. 일상적으로 말하는 ‘V2Ray 설치’는 실제로 그래픽 클라이언트를 설치한 뒤 그 클라이언트로 프록시 코어를 관리하는 경우가 많습니다. 구독 관리, 트레이 메뉴, 설정 편집은 인터페이스의 기능이며 로컬 연결 수신, 아웃바운드 연결, 라우팅 규칙 적용은 코어가 담당합니다. 이 두 계층을 구분해야 오류가 인터페이스 설정에서 발생했는지 코어 실행 중 발생했는지 판단할 수 있습니다.
V2Fly는 V2Ray 관련 개발을 이어 가며, Xray는 V2Ray에서 파생되어 독자적으로 발전한 코어 프로젝트입니다. 두 코어는 일부 프로토콜과 설정 개념이 비슷하지만 기능, 필드, 업데이트 주기가 완전히 같지는 않습니다. 특히 VLESS, REALITY나 일부 전송 옵션은 사용하는 코어에서 실제로 지원하는지 확인해야 합니다. REALITY는 연결 보안 관련 기술입니다. 프로토콜 이름과 함께 자주 등장한다고 해서 임의로 서로 바꿔 쓸 수 있는 독립 프록시 프로토콜로 보면 안 됩니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트 프로젝트입니다. 데스크톱 설정 관리가 필요하면 v2rayN을, Android에서는 Xray 또는 V2Fly 호환성에 따라 나머지 두 클라이언트를 선택하세요. 오픈 소스라는 사실은 코드를 확인하고 관련 라이선스를 살펴볼 수 있다는 뜻이지, 출처와 관계없이 모든 구독을 신뢰해도 된다는 뜻은 아닙니다. 클라이언트, 코어, 함께 제공되는 구성 요소에 서로 다른 오픈 소스 라이선스가 적용될 수 있습니다. 수정, 재배포, 패키징을 할 때는 각 라이선스와 릴리스 안내를 따로 확인해야 하며, 클라이언트 이름만으로 모든 의존성의 사용 조건을 판단할 수는 없습니다.
프로그램 업데이트는 클라이언트 구성 요소를 교체하는 것이고, 구독 업데이트는 서버 설정을 다시 가져오는 것입니다. 프로그램을 업데이트해도 서비스 이용 기간이 자동으로 연장되지 않으며, 구독을 업데이트해도 코어에서 지원하지 않는 기능이 추가되지는 않습니다. 업그레이드 전에 기존 프록시 모드, 포트, 라우팅, DNS 설정을 기록하세요. 업그레이드 후 기본 연결을 확인하고 고급 설정을 복구하면 됩니다. 설정 파일에 포함된 인증 정보와 구독 주소는 안전하게 보관하세요. 로그를 공유할 때는 민감한 내용을 삭제하되 오류 유형, 발생 시각, 조작 순서는 문제를 파악할 수 있도록 남겨 두세요.
수정하려는 항목이 클라이언트 자체 설정인지 코어에 전달되는 설정인지 먼저 확인하세요. 코어 JSON에서 inbounds는 로컬 진입점을, outbounds는 트래픽 출구를 정의합니다. routing은 규칙을 아웃바운드 태그에 연결하고, dns는 DNS 설정을 처리합니다. 필드 이름이 비슷하더라도 코어가 다르면 설정을 그대로 바꿔 쓸 수 있는 것은 아닙니다. 직접 수정하기 전에 원본 파일을 백업하고 JSON 문법을 확인한 다음 항목별로 동작을 검증하세요. 클라이언트가 자동 생성하는 파일은 다음 실행 때 다시 작성될 수도 있습니다.
설정 및 문제 해결 문서
문제가 생기면 먼저 어느 단계에서 막혔는지 확인하세요. 프로그램이 실행되는지, 구독이 업데이트되는지, 코어가 연결되는지, 앱이 실제로 프록시를 사용하는지 살펴봅니다.
런타임 누락, 프로그램 폴더 쓰기 권한 부족, 설정 파일 손상, 포트 사용 중의 네 가지 원인을 차례로 확인해 v2rayN이 실행 직후 종료되는 문제를 해결합니다.
LAN 연결 허용, 수신 포트, 방화벽 허용 설정을 설명하고 휴대전화나 TV 같은 기기에서 PC의 LAN 주소를 입력해 프록시를 공유하는 방법을 안내합니다.
구독을 가져온 뒤 노드를 선택하고 실제 연결 속도 테스트로 사용 가능 여부를 확인하는 방법, 브라우저와 명령줄에서 트래픽이 프록시를 통과하는지 확인하는 방법을 안내합니다.