먼저 운영체제와 프로세서 아키텍처를 확인한 다음 설치 패키지를 선택하세요. 설치 패키지는 프로그램이 기기에서 실행될 수 있는지를 결정하고, 노드 프로토콜은 연결을 처리할 코어를 결정합니다. 둘은 별개의 선택입니다. 설치가 끝난 뒤에도 구독이나 서버에서 제공한 매개변수를 참고해 노드를 설정해야 합니다.
v2rayN 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, 클래식 버전은 WPF 인터페이스를 유지합니다. 처음 설치한다면 다운로드 페이지의 시스템 요구 사항을 확인해 선택하세요. 기존 설정이 있다면 현재 버전의 데이터 폴더 위치를 먼저 확인한 뒤 인터페이스를 바꿀지 결정하세요.
더블클릭해도 창이 열리지 않으면 프로세서 아키텍처, 해당 데스크톱 런타임, 압축을 푼 폴더에 대한 프로그램의 쓰기 권한을 먼저 확인하세요. 클라이언트가 아직 시작되지 않았다면 구독이나 라우팅 규칙을 수정해도 실행 중단 문제는 해결되지 않습니다.
Xray와 Xray 전용 연결 설정을 사용하려면 v2rayNG를 선택할 수 있습니다. 기존 노드를 V2Fly 구현으로 검증하려면 v2flyNG를 선택하세요. 두 클라이언트 모두 ARM64와 범용 패키지를 제공하며, 시스템이 ARM64를 지원하는 것으로 확인됐다면 해당 패키지를 바로 선택하면 됩니다.
처음 연결할 때는 시스템의 VPN 권한 요청에 유의하세요. 다른 앱이 이미 해당 연결 경로를 사용 중이라면 연결을 끊은 뒤 다시 시도하세요. 모바일 데이터와 무선 네트워크에서 같은 노드를 각각 테스트하면 네트워크 경로 차이와 설정 오류를 구분하기 쉽습니다.
먼저 배포판의 패키지 관리 방식에 맞춰 v2rayN 패키지를 선택하세요. Debian·Ubuntu 계열은 보통 DEB, Fedora 등은 보통 RPM을 사용합니다. 그런 다음 기기 아키텍처에 맞춰 x64 또는 ARM64를 선택하세요. 배포판에서 패키지 형식을 인식하더라도 모든 종속성이 충족된 것은 아닙니다.
데스크톱 환경의 프록시 설정과 터미널 프로그램의 연결 경로는 다를 수 있습니다. 브라우저에서는 접속되지만 터미널 도구에서는 안 된다면 해당 도구의 프록시 설정이나 환경 변수를 먼저 확인하세요. 이것만으로 노드가 작동하지 않는다고 판단해서는 안 됩니다.
구독은 노드를 제공하고, 시스템 프록시와 가상 네트워크 어댑터는 트래픽이 들어오는 경로를 정하며, 라우팅 규칙은 유입된 트래픽이 어느 출구로 나갈지 결정합니다. 처음 설정할 때는 한 번에 한 계층만 변경하세요. 먼저 노드 하나를 확인하고, 대상 앱이 클라이언트로 트래픽을 보내는지 점검한 다음 분할 라우팅을 켜세요. 이렇게 하면 연결에 문제가 생겼을 때 직전 설정과 비교할 수 있습니다.
설정 / 구독 그룹
구독은 변경될 수 있는 여러 노드를 한곳에서 관리할 때 적합합니다. 그룹을 추가한 뒤 제공업체가 안내한 구독 주소를 입력하고 업데이트하세요. 공유 링크 하나만 받은 경우에는 클립보드에서 가져오기를 사용하고, 노드 링크를 구독 주소로 입력하지 마세요. 목록이 업데이트되면 노드 하나를 선택해 연결을 확인한 뒤 나머지 노드도 점검하세요. 업데이트는 성공했지만 항목이 추가되지 않았다면 응답 내용이 클라이언트에서 인식할 수 있는 구독 형식인지, 가져올 때 올바른 그룹을 선택했는지 확인하세요. 수동으로 추가한 노드는 별도 그룹에 두어 직접 수정한 항목과 구독으로 생성된 항목을 섞지 않는 것이 좋습니다.
구독 그룹
구독 그룹 추가
구독 주소
제공받은 구독 주소 입력
구독 업데이트
현재 구독 그룹 업데이트
설정 / 시스템 프록시
시스템 프록시 자동 설정은 데스크톱 시스템에 클라이언트의 로컬 프록시 경로를 등록하며, 시스템 설정을 따르는 브라우저와 앱에 적합합니다. 먼저 작동이 확인된 노드를 실행한 다음 시스템 프록시를 전환하고 연결을 다시 시도하세요. 클라이언트에서 노드 연결만 테스트해서는 앱도 같은 경로를 사용하는지 확인할 수 없습니다. 별도의 프록시 설정이 있는 프로그램은 계속 직접 연결하거나 자체 저장된 주소를 사용할 수 있습니다. 이 경우 앱 내부의 프록시 유형과 포트를 확인하세요. 더 많은 앱의 트래픽을 처리해야 한다면 가상 네트워크 어댑터 모드와 필요한 권한을 검토하세요.
시스템 프록시
시스템 프록시 자동 설정
테스트 종료
시스템 프록시 해제
설정 / 라우팅 분할
라우팅은 트래픽이 클라이언트로 들어온 뒤 도메인, 주소 또는 다른 조건에 따라 출구를 선택합니다. 먼저 기존 규칙 세트를 선택해 직접 연결되어야 할 대상과 프록시를 사용해야 할 대상을 각각 테스트한 다음 사용자 규칙을 추가하세요. 구체적인 예외 규칙은 범위가 넓은 규칙보다 앞에 배치하고, 어떤 규칙에도 해당하지 않는 트래픽이 어느 출구로 나가는지도 확인해야 합니다. 도메인 규칙과 주소 규칙의 결과는 코어가 호스트 이름을 받는지, 아니면 해석된 주소를 받는지에 따라서도 달라집니다. 일부 사이트만 문제가 있다면 노드를 바꾸거나 클라이언트를 다시 설치하기 전에 규칙 적용 결과와 이름 해석을 먼저 확인하세요.
라우팅 프리셋 예시
중국 본토 우회
outboundTag
일치한 규칙에 따라 직접 연결 또는 프록시 출구 선택
설정 / TUN
가상 네트워크 어댑터는 시스템 프록시 설정을 읽지 않지만 클라이언트가 트래픽을 처리해야 하는 프로그램에 적합합니다. 사용 전에 필요한 권한을 확인하고, 시스템 라우팅을 변경할 수 있는 다른 도구를 잠시 종료한 뒤 기존 프록시 설정을 보관하세요. 활성화한 다음 자주 쓰는 앱, 이름 해석, 로컬 네트워크 접속을 차례로 테스트하세요. 웹페이지 하나만으로 설정이 올바른지 판단하면 안 됩니다. 로컬 네트워크 기기에 연결할 수 없다면 먼저 가상 네트워크 어댑터를 끄고 비교한 뒤, 트래픽 처리 범위와 라우팅 제외 항목을 확인하세요. 문제를 찾을 때 노드 변경, 규칙 수정, 이름 해석 설정을 동시에 바꾸지 마세요. 무엇이 결과에 영향을 줬는지 파악하기 어렵습니다.
TUN 모드
가상 네트워크 어댑터 사용
자동 라우팅
현재 네트워크 어댑터와 트래픽 처리 범위에 맞춰 설정
설정 / 코어 유형
코어는 노드 설정을 해석하고 외부 연결을 수립합니다. 코어를 바꾸면 기존 설정의 각 필드가 같은 의미로 유지되지 않을 수 있습니다. REALITY와 Vision이 필요한 노드에는 해당 조합을 지원하는 Xray를 선택하세요. 기존 VMess 설정도 전송 방식과 보안 계층을 확인해야 합니다. 프로토콜 이름만 보고 두 코어 간에 설정을 옮길 수 있다고 판단하면 안 됩니다. 인터페이스에서 코어를 바꿀 수 있다면 노드를 복사한 뒤 코어 유형을 변경하고 시작 로그와 실제 연결을 각각 확인하세요. 모바일에서는 해당 코어를 사용하는 클라이언트와 비교해 볼 수도 있습니다.
코어 유형
Xray / V2Fly(클라이언트에서 제공하는 옵션에 따라 선택)
flow
노드에서 요구하는 경우에만 Vision 흐름 제어 사용
설정 / 기기 간 구독
데스크톱과 휴대폰에서 같은 구독 주소를 각각 추가하고 기기별로 노드 목록을 업데이트할 수 있습니다. 동기화되는 것은 구독에서 제공하는 노드뿐이며, 현재 선택한 노드나 시스템 프록시 상태, 기기별 규칙은 동기화되지 않습니다. 클라이언트 간 계정 공유와도 다릅니다. 기기를 옮길 때는 대상 기기에 새 그룹을 만들고 업데이트한 뒤 노드 수와 프로토콜 유형을 확인하세요. 그런 다음 해당 기기의 네트워크 환경에 맞춰 연결 경로와 분할 라우팅을 설정하면 됩니다. 한 기기에서만 특정 노드가 보이지 않는다면 업데이트 결과와 구독 형식을 먼저 확인하세요. 문제 해결을 위해 화면을 공유할 때는 구독 주소와 사용자 식별 정보를 가리세요.
클라이언트는 설정 인터페이스이고, 코어는 연결을 실행하는 프로그램이며, 프로토콜은 양쪽이 통신할 때 따르는 규약입니다. 하나의 클라이언트가 여러 설정 방식을 지원할 수 있고, 이름이 같은 프로토콜이라도 코어에 따라 지원하는 전송 및 보안 옵션이 일부만 겹칠 수 있습니다.
Project V의 모듈 구성
Project V는 V2Ray가 속한 오픈 소스 프로젝트 생태계입니다. V2Ray 코어는 연결을 인바운드, 라우팅, 아웃바운드로 나눕니다. 먼저 인바운드가 앱 트래픽을 받고, 라우팅이 사용할 출구를 판단한 뒤, 아웃바운드가 해당 프로토콜로 연결을 수립합니다. 그래픽 클라이언트는 이 구조를 노드 목록, 프록시 스위치, 라우팅 옵션으로 보여 줍니다. 따라서 연결 아이콘이 켜져 있다는 것은 보통 해당 서비스가 실행 중이라는 뜻일 뿐, 브라우저와 터미널 등 모든 앱이 같은 프록시 경로를 사용한다는 의미는 아닙니다.
예를 들어 브라우저와 명령줄 도구가 같은 도메인에 접속하더라도, 브라우저는 시스템 프록시를 따르고 명령줄 도구는 환경 변수만 읽을 수 있습니다. 도메인과 노드가 같아도 한쪽은 접속되고 다른 쪽은 안 될 수 있습니다. 구독을 계속 새로고침하기보다 문제가 트래픽 유입 전인지, 아웃바운드 연결 단계인지 먼저 구분하세요. 로그에 대상 앱의 연결 시도가 없다면 앱의 연결 경로 설정부터 확인하세요. 연결 기록이 있다면 적용된 규칙과 아웃바운드 결과를 살펴보세요.
코어 계열과 설정 호환성
V2Fly는 커뮤니티에서 V2Ray를 이어서 유지 관리합니다. Xray는 관련 코드에서 분리된 뒤 독립적으로 발전해 REALITY 등의 기능을 추가했습니다. 두 코어는 일부 개념과 설정 구조를 공유하지만 같은 프로그램의 다른 이름은 아닙니다. 선택할 때는 서버 요구 사항부터 확인하세요. 프록시 프로토콜, 하위 전송 방식, 보안 계층, 흐름 제어를 차례로 점검한 뒤 선택한 클라이언트가 해당 필드를 코어에 빠짐없이 전달하는지 확인해야 합니다. 구독에 노드 이름과 서버 주소가 표시된다고 해서 설정을 모두 읽어 들였다는 뜻은 아닙니다.
코어를 바꿔 테스트할 때는 기존 노드 설정을 그대로 보관하고, 현재 작동하는 항목을 먼저 삭제하지 마세요. 전환 후 편집기에 입력란이 추가되거나 사라졌다면 해당 필드가 다른 설정으로 표현되는지, 아니면 해당 조합이 지원되지 않는지 확인하세요. 시작 단계의 설정 오류와 시작 후 핸드셰이크 실패는 점검을 시작할 지점이 다릅니다. 전자는 필드와 코어의 대응 관계를 먼저 확인하고, 후자는 입력한 값이 서버 설정과 일치하는지 확인하세요. Xray와 V2Fly의 차이 보기.
프로토콜, 보안 계층, 흐름 제어
VMess, VLESS, Trojan, Shadowsocks는 프록시 프로토콜 옵션입니다. Xray의 VLESS 설정에서는 REALITY가 전송 계층 보안 항목에, Vision이 흐름 제어 항목에 들어갑니다. 공유 링크가 VLESS로 시작한다는 사실만으로는 프록시 프로토콜만 알 수 있으며, 어떤 보안 계층을 사용하는지 또는 Vision을 적용하는지는 알 수 없습니다. 직접 설정할 때는 노드 매개변수를 기준으로 삼고 모든 구성에 같은 보안 옵션을 일괄 적용하지 마세요. 일반 TLS 설정의 서버 이름은 REALITY 노드에 필요한 다른 매개변수를 대신할 수 없습니다.
공개 프로토콜과 오픈 소스 구현을 참고하면 각 설정 필드의 역할은 구분할 수 있지만, 프로토콜 이름만으로 실제 속도나 배터리 소모량을 예측할 수는 없습니다. 비교하려면 같은 기기와 네트워크에서 비슷한 시간대에 정상 작동이 확인된 설정 두 개로 같은 작업을 수행하세요. 페이지를 처음 여는 데 걸리는 시간과 지속 전송 성능은 따로 살펴봐야 합니다. 휴대폰에서는 무선 네트워크를 바꾼 뒤 연결이 반복해서 끊기고 다시 연결되는지도 확인하세요. 한 번의 연결 테스트 결과만으로 전체 사용 경험을 판단하면 안 됩니다.
클라이언트, 코어, 규칙은 각각 업데이트
v2rayN은 서버 편집과 구독 그룹을 주요 기능으로 제공하는 오픈 소스 데스크톱 클라이언트입니다. v2rayNG는 Xray를 주 코어로 사용하는 오픈 소스 Android 클라이언트이고, v2flyNG는 V2Fly 구현이 필요한 Android 사용자를 위한 오픈 소스 선택지입니다. 세 프로젝트는 인터페이스와 배포 패키지를 각각 관리합니다. 두 기기에서 같은 구독을 사용하더라도 메뉴 위치, 로컬 수신 방식, 시스템 권한은 클라이언트에 따라 다릅니다. 데스크톱 설정 폴더를 휴대폰의 그룹이나 네트워크 설정 대신 사용할 수는 없습니다.
업데이트 전에 무엇을 바꾸려는지 구분하세요. 설치 패키지를 업데이트하면 메뉴, 실행 종속성, 코어 호출 방식이 바뀔 수 있습니다. 코어만 바꾸면 주로 프로토콜과 필드 지원에 영향을 주고, 구독 업데이트는 노드 목록을 새로 고칩니다. 라우팅 데이터 업데이트는 일부 규칙의 일치 결과를 바꿀 수 있습니다. 어떤 변경이 문제를 일으켰는지 확인하려면 현재 작동하는 노드와 프록시 모드, 라우팅 프리셋을 기록해 두고 업데이트를 하나씩 적용한 뒤 같은 앱으로 다시 테스트하세요. 업데이트 전후에 네트워크도 바뀌었다면 네트워크 변경을 별도 변수로 확인해야 합니다. 프로토콜 및 코어 안내 보기.
최근 기술 문서
문제가 발생한 단계에 맞춰 확인하세요. 프로그램이 시작되지 않으면 플랫폼 안내를, 실행은 되지만 대상 앱이 연결되지 않으면 트래픽 유입 경로를, 노드 프로토콜을 선택하려면 보안 계층과 흐름 제어의 설계 차이를 살펴보세요.