v2rayN · Windows / macOS / Linux

V2Ray Windows 버전v2rayN 다운로드 및 설정

설치 패키지를 선택한 다음 구독 가져오기로 노드를 추가하고, 사용 환경에 맞게 시스템 프록시 또는 TUN을 설정하세요.

  • 오픈 소스
  • 그래픽 인터페이스
  • 라우팅 및 트래픽 분기

기능 한눈에 보기

클라이언트 기능데스크톱과 Android 비교

노드 프로토콜 및 전송 설정

노드를 가져올 때는 먼저 프로토콜을 확인하고, 다음으로 전송 방식과 핸드셰이크 설정을 살펴보세요. 데스크톱용 v2rayN과 Android용 v2rayNG 모두 각 코어를 통해 일반적인 VMess, VLESS, Trojan 설정을 처리할 수 있지만, 프로토콜 이름이 같다고 전송 설정까지 서로 호환되는 것은 아닙니다. 기존 노드를 복사할 때는 제공된 전송 방식과 보안 옵션을 그대로 유지하세요. 데스크톱에서는 연결되는데 Android에서 연결되지 않는다면 양쪽에서 해석된 필드를 비교한 다음, 해당 조합을 코어가 지원하는지 확인하세요. 여러 옵션을 한꺼번에 바꾸지 마세요.

  • VMess: 프로토콜, 전송 방식, 보안 옵션이 제공된 설정과 일치하는지 확인하세요.
  • VLESS: 흐름 제어 필드가 노드에서 사용하는 코어와 전송 방식에 적합한지 확인하세요.
  • TLS 및 REALITY: 노드의 기존 설정에 지정된 핸드셰이크 매개변수를 유지하세요.
항목v2rayN 데스크톱v2rayNG Android
VMess지원지원
VLESS지원지원
Trojan지원지원

설치 패키지 선택

4개 플랫폼운영체제와 아키텍처별 다운로드

먼저 기기의 프로세서 아키텍처를 확인한 다음 운영체제, 배포판 또는 인터페이스 종류에 맞는 패키지를 선택하세요. 설치 패키지는 클라이언트만 제공하며 노드나 구독 주소는 별도로 준비해야 합니다. 기존 클라이언트를 사용 중이라면 현재 설정을 백업한 뒤 같은 노드로 새 설치가 정상 작동하는지 확인할 수 있습니다.

Windows

v2rayN · 데스크톱 버전 / WPF 버전

시스템의 ‘정보’ 페이지에서 시스템 종류를 확인하세요. 다운로드 페이지의 두 패키지는 모두 x64용입니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 기존 인터페이스 구성을 사용합니다. 처음 설치할 때는 둘 중 하나만 선택하면 됩니다. 가이드를 비교하려고 두 버전을 동시에 설치할 필요는 없습니다.

압축 파일로 배포되는 경우 쓰기 가능한 폴더에 압축을 완전히 푼 다음 프로그램을 실행하세요. 압축 프로그램 창에서 실행 파일을 바로 열지 마세요. 시스템에서 런타임 환경이 없다고 알리면 선택한 패키지의 안내에 따라 처리하세요. 기존 클라이언트가 실행 중이라면 먼저 종료해 두 프로그램이 같은 로컬 포트를 사용하지 않도록 하세요.

다운로드

macOS

v2rayN · Apple Silicon / Intel

‘이 Mac에 관하여’를 열고 칩 또는 프로세서 항목을 확인하세요. Apple 칩이면 arm64, Intel 프로세서이면 x64를 선택하세요. 출시 연도만으로 판단하지 마세요. 같은 시기에 나온 모델도 아키텍처가 다를 수 있습니다. 디스크 이미지를 연 뒤 안에 있는 안내에 따라 설치하세요.

설치가 끝나면 ‘응용 프로그램’에서 클라이언트를 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. 처음 연결할 때는 브라우저가 시스템 프록시를 예상대로 사용하는지 확인한 뒤 개별 앱의 프록시 설정을 살펴보세요. 시스템 권한 요청이 표시되면 앱 실행 권한인지 네트워크 기능 사용 권한인지 먼저 확인하세요.

다운로드

Android

v2rayNG · v2flyNG

일반적으로 Xray 코어를 사용하는 v2rayNG를 선택합니다. 기존 설정에서 V2Fly가 필요한 경우에만 v2flyNG를 확인하세요. 최근 출시된 대부분의 기기는 arm64를 선택할 수 있습니다. 기기 정보에서 지원하는 앱 아키텍처를 확인할 수 없다면 데스크톱 설치 패키지를 휴대폰으로 옮기지 말고 범용 패키지를 먼저 확인하세요.

설치가 끝나면 구독을 가져와 목록을 업데이트하고 노드를 선택한 다음 시작을 눌러 시스템 안내에 따라 로컬 VPN 연결을 설정하세요. 일부 앱에서만 연결되지 않으면 앱별 프록시 목록을 확인하세요. 백그라운드로 전환한 뒤 한동안 지나 연결이 끊기는 경우에는 시스템이 클라이언트의 백그라운드 활동을 제한하는지 살펴보세요.

다운로드

Linux

v2rayN · deb / rpm

먼저 배포판에 맞는 패키지 형식을 선택하고, 다음으로 기기에 맞는 아키텍처를 선택하세요. Debian과 Ubuntu는 보통 deb를, Fedora와 openSUSE는 보통 rpm을 선택합니다. 다운로드 페이지에는 x64와 arm64가 각각 제공됩니다. 설치할 때 배포판의 패키지 관리 도구로 의존성 안내를 확인하세요.

처음 실행할 때는 클라이언트가 시작되고 코어가 노드를 불러오는지 확인한 다음 데스크톱 환경의 프록시 설정을 살펴보세요. 그래픽 인터페이스에서 시스템 프록시가 작동하더라도 터미널 프로그램이 같은 설정을 사용하는 것은 아닙니다. 먼저 앱별로 확인한 뒤 TUN이 필요한지 결정하면 트래픽 적용 범위 문제와 노드 문제를 혼동하지 않을 수 있습니다.

다운로드

빠른 시작

구독 가져오기3단계로 연결 확인

  1. 주소를 추가하고 구독 그룹 업데이트

    구독 그룹 설정을 열고 새 그룹을 만든 다음 알아보기 쉬운 메모를 입력하고 전체 구독 주소를 붙여넣으세요. 저장하면 주소만 기록되며 보통 바로 노드가 생성되지는 않습니다. 메인 화면으로 돌아가 업데이트를 실행하고 새 그룹으로 전환해 선택 가능한 노드가 있는지 확인하세요. 노드 공유 링크가 하나뿐이라면 구독 주소로 입력하지 말고 클라이언트의 클립보드 가져오기 기능을 사용하세요.

    목록이 계속 비어 있다면 방금 추가한 그룹을 업데이트했는지 먼저 확인한 다음 업데이트 안내를 살펴보세요. 주소에 공백이 포함됐거나 구독이 만료됐거나, 클라이언트가 노드 정보가 아닌 로그인 페이지를 가져온 경우에는 각각 해결 방법이 다릅니다. 다음 단계로 넘어가기 전에 목록 업데이트 문제부터 해결하세요.

  2. 노드를 선택하고 프록시 모드 설정

    그룹에서 노드를 하나 선택해 현재 서버로 지정하세요. 데스크톱에서 처음 테스트할 때는 TUN을 동시에 켤 필요가 없습니다. 시스템 프록시 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하고 시스템 프록시를 사용하는 브라우저로 테스트하세요. Android에서는 노드를 선택한 뒤 연결을 시작하고, 처음 사용할 때 시스템 VPN 권한을 승인하세요.

    브라우저에서는 접속되지만 대상 앱에서는 안 된다면 먼저 해당 앱에 자체 프록시 설정이 있는지 확인하세요. 시스템 프록시를 사용하지 않는 프로그램까지 처리해야 하는 경우에만 TUN을 테스트하세요. 모드를 바꾸기 전에 기존 시스템 프록시 상태를 기록해 두면 나중에 어떤 변경으로 문제가 생겼는지 파악하기 쉽습니다.

  3. 실제 접속을 확인하고 실패 지점 기록

    클라이언트 로그에서 코어가 정상적으로 시작됐는지 확인한 다음 테스트할 페이지나 앱을 여세요. 지연 시간 테스트는 해당 시점의 탐지 결과만 보여 주므로 실제 접속을 대신할 수 없습니다. 앱 연결에 실패하면 대략적인 시간, 현재 노드, 프록시 모드, 가장 먼저 확인할 만한 오류 메시지를 기록하세요.

    다음 테스트에서는 조건을 하나만 바꾸세요. 먼저 같은 앱에서 정상 작동이 확인된 다른 노드를 사용한 뒤, 같은 노드로 앱을 바꿔 비교하세요. 첫 번째 방법은 노드나 전송 문제를, 두 번째는 앱에 프록시가 적용되는지 판단하는 데 도움이 됩니다. 테스트가 끝나면 TUN을 끄거나 임시 시스템 프록시 설정을 해제하고 기존 네트워크 접속이 복구됐는지 확인하세요.

오픈 소스 생태계

Project V클라이언트와 코어의 역할

그래픽 인터페이스는 설정을 입력하고 관리하며, 코어는 연결을 수립하고 프로토콜을 처리하며 라우팅을 실행합니다. 이 두 계층을 구분하면 설치 패키지를 바꿔야 하는지, 노드 매개변수를 수정해야 하는지, 프록시 연결 방식을 조정해야 하는지 판단할 수 있습니다.

Project V와 V2Fly

Project V는 인바운드, 아웃바운드, 라우팅을 조합 가능한 네트워크 설정으로 구성합니다. 인바운드는 트래픽을 프로그램에 전달하는 방식을 정하고, 아웃바운드는 트래픽을 보내는 방식을 정하며, 라우팅은 대상에 알맞은 아웃바운드를 지정합니다. V2Fly는 V2Ray 개발을 이어 가는 커뮤니티 프로젝트로, V2Ray 코어와 관련 문서를 관리합니다.

이 역할 구분은 흔히 겪는 설정 문제를 이해하는 데도 도움이 됩니다. 노드를 가져오는 데 성공했다는 것은 클라이언트가 목록을 읽었다는 뜻일 뿐입니다. 노드 연결 여부는 코어가 해당 매개변수를 사용할 수 있는지에 달려 있고, 브라우저가 이 연결을 사용하는지는 앱이 요청을 클라이언트에 전달할 수 있는지에 따라 달라집니다. 문제를 해결할 때는 구독을 계속 업데이트하기보다 이 세 단계를 각각 확인하는 편이 효과적입니다.

Xray와 프로토콜 지원

Xray는 V2Ray 코드 체계에서 분리된 뒤 독립적으로 발전해 왔습니다. V2Fly와 일부 설정 개념을 공유하지만 기능과 매개변수는 각각 관리합니다. 예를 들어 REALITY는 연결의 보안 계층 설정이며 VMess나 VLESS를 대체하는 노드 프로토콜이 아닙니다. 연결 매개변수를 노드 프로토콜, 전송 방식, 보안 계층으로 나누면 실제로 호환되지 않는 필드를 찾기 쉽습니다.

데스크톱에서 코어를 바꿀 때는 기존 노드의 전송 방식, 흐름 제어, 보안 옵션이 모두 지원되는지 먼저 확인하세요. 설정이 불러와진 뒤 연결 로그를 살펴보세요. 시작하자마자 오류가 발생한다면 시스템 프록시를 바꾸거나 DNS를 반복해서 변경하기보다 설정과 코어의 조합을 먼저 확인하세요.

오픈 소스 클라이언트와 라이선스

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. v2rayN은 데스크톱 노드와 라우팅을 관리하며 지원되는 코어와 함께 사용할 수 있습니다. v2rayNG는 Android용으로 Xray를 코어로 사용하고, v2flyNG는 V2Fly 코어가 필요한 Android 설정을 위한 클라이언트입니다. 인터페이스나 이름이 비슷하다고 해서 고급 설정과 구성 파일을 서로 그대로 사용할 수 있는 것은 아닙니다.

오픈 소스 라이선스는 코드의 사용, 수정, 재배포에 적용됩니다. 구체적인 조건은 각 프로젝트와 패키지에 포함된 구성 요소의 라이선스를 확인하세요. 클라이언트 코드가 공개되어 있다는 사실과 구독 서비스의 제공 주체 및 노드의 지속 사용 가능 여부는 별개의 문제입니다. 클라이언트를 고를 때는 플랫폼과 코어 요구 사항을 확인하고, 구독 문제를 점검할 때는 구독 출처와 업데이트 상태를 따로 확인하세요.

클라이언트, 코어, 구독 업데이트

클라이언트 업데이트는 인터페이스, 기본 설정, 실행 환경을 바꿀 수 있습니다. 코어 업데이트는 지원 프로토콜 기능, 설정 해석, 연결 동작을 바꿀 수 있습니다. 구독 업데이트는 노드 목록을 다시 가져옵니다. 이 세 가지 업데이트는 서로 대체할 수 없습니다. 노드 목록이 갱신되지 않았을 때 프로그램을 먼저 다시 설치할 필요는 없습니다. 코어가 특정 필드를 인식하지 못한다면 목록을 반복해서 새로고침해도 해결되지 않을 수 있습니다.

변경하기 전에 현재 노드, 시스템 프록시 모드, 사용자 지정 라우팅, 수신 포트를 기록하세요. 한 번에 한 계층만 업데이트하고 같은 노드와 앱으로 다시 테스트한 뒤 다음 항목을 바꿀지 결정하세요. 연결할 수 없다면 기존 설정과 새 설정의 차이를 하나씩 비교하며 원인을 찾으세요. 프로토콜 이름이나 설정 필드가 궁금하다면 먼저 용어집을 확인하세요.

설정 및 문제 해결

최신 활용 가이드