• 클라이언트 및 설정 안내

v2rayN 다운로드 센터 데스크톱 클라이언트 및 구독 설정 가이드

v2rayN 다운로드 가이드 보기

여러 플랫폼 설치 안내, 구독 가져오기 절차, 프록시 설정 안내를 제공합니다. 클라이언트 선택부터 연결 확인까지 순서대로 설정할 수 있습니다.

  • 구독 그룹
  • 라우팅
  • Xray · V2Fly

설정 안내 작업 공간

v2rayN 설정의 다섯 가지 메뉴

구독은 설정을 가져오고, 시스템 프록시는 앱을 연결하며, 라우팅은 트래픽이 나갈 경로를 선택합니다. 각 기능의 역할은 다르므로 처음 실행할 때 모두 변경할 필요는 없습니다. 먼저 구독을 업데이트하고 브라우저 연결을 확인한 뒤, 필요한 앱에 맞춰 규칙을 추가하세요. 설정을 한꺼번에 여러 개 바꾸지 않으면 문제 원인을 찾기 쉽습니다.

아래 창은 설정을 설명하기 위한 정적 예시이며 실제로 조작할 수 있는 클라이언트가 아닙니다. 탭을 전환해 각 설정의 용도를 확인하세요. 실제 메뉴 이름과 위치는 클라이언트 버전에 따라 달라질 수 있으므로 사용 중인 클라이언트의 설정 화면을 확인해야 합니다.

v2rayN · 구독 그룹
구독 그룹 설정모든 구독 업데이트

구독 추가

주소(URL) · 사용 예시 https://example.com/sub?token=xxxx 확인

구독 가져오기는 서비스 제공자가 배포한 설정을 한곳에서 관리할 때 유용합니다. ‘구독 그룹 설정’에서 그룹 이름과 전체 주소를 추가하고 저장한 뒤 ‘모든 구독 업데이트’를 실행하세요. 그런 다음 목록에서 사용할 설정을 선택하면 됩니다. 링크를 하나씩 붙여넣는 방식과 달리 구독 그룹을 사용하면 이후 변경 사항을 동기화하기 쉽습니다. 다만 업데이트 성공 여부는 주소의 유효성, 네트워크 연결, 서비스 만료 여부에 달려 있습니다. 주소에 포함된 토큰은 접근 권한을 나타내는 경우가 많으므로 공개 스크린샷에 노출하거나 출처가 불분명한 변환 페이지에 입력하지 마세요. 업데이트 후 목록이 비어 있다면 클라이언트를 반복해서 재설치하기보다 먼저 업데이트 로그를 확인하세요.

설치 파일 선택

운영체제에 맞는 클라이언트 선택

데스크톱에서는 v2rayN을, 안드로이드 기기에서는 우선 v2rayNG를 확인하세요. V2Fly 코어가 필요하다면 v2flyNG도 고려할 수 있습니다. 먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 페이지에서 맞는 패키지를 선택하세요. 데스크톱 설치 파일은 휴대폰에서 사용할 수 없으며, 구독 주소가 대상 클라이언트와 호환되는지는 서비스 제공자에게 확인해야 합니다.

아래 버튼을 누르면 다운로드가 시작되는 것이 아니라 다운로드 페이지의 해당 플랫폼 항목으로 이동합니다. 다운로드 페이지에서 패키지 종류, 설치 조건, 클라이언트 차이를 한곳에서 확인할 수 있으므로 기기를 바꾸거나 처음 설치하기 전에 살펴보세요. 클라이언트는 무료로 사용할 수 있지만 설정과 연결을 위한 도구입니다. 설치 후에는 유효한 설정이나 구독을 별도로 준비해야 합니다.

Windows

v2rayN · 데스크톱 버전 / 클래식 WPF 버전

데스크톱 버전은 여러 플랫폼에서 사용할 수 있는 인터페이스를 제공해 일관된 설정 절차로 시작하기 좋습니다. 클래식 WPF 버전은 익숙한 데스크톱 레이아웃을 유지합니다. 두 버전 모두 구독 관리, 설정 선택, 라우팅 조정에 사용합니다. 시스템 조건과 사용 습관에 맞춰 선택하세요. 두 인터페이스를 모두 설치해야 하는 구성 요소로 오해하지 마세요.

설치 전에 시스템 아키텍처와 다운로드 페이지의 실행 조건을 확인하세요. 브라우저 연결은 먼저 시스템 프록시로 시험하고, 시스템 설정을 따르지 않는 앱이 있을 때 TUN을 검토하세요. 인터페이스 버전을 바꾸기 전에 구독 그룹, 사용자 지정 라우팅, 포트 설정 등 필요한 설정을 보관해 기존 환경이 덮어쓰이지 않도록 하세요.

다운로드 페이지로 이동

macOS

v2rayN · Apple Silicon / Intel

먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 Apple Silicon 또는 Intel에 맞는 항목을 선택하세요. 프로세서에 맞는 패키지를 고르는 것이 설치의 첫 단계입니다. 기기 외관이나 구입 연도만으로 판단하지 마세요. 실행 후 구독을 가져오고 설정을 선택한 다음 시스템 네트워크 설정에 프록시가 의도대로 적용됐는지 확인하세요.

시스템에서 앱 출처를 확인하라는 메시지가 표시되면 설치 파일을 받은 경로부터 확인하고 시스템 안내에 따라 진행하세요. 클라이언트를 실행하려고 전체 보안 기능을 끄지 마세요. 시스템 프록시와 앱 자체의 프록시 설정이 동시에 적용될 수도 있습니다. 특정 브라우저에서만 문제가 발생하면 브라우저 확장 프로그램과 연결 방식을 먼저 확인하세요.

다운로드 페이지로 이동

Android

v2rayNG 우선 · v2flyNG 대안

v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 클라이언트를 고를 때는 필요한 프로토콜 기능을 확인하세요. 비교적 최신 휴대폰이라면 arm64 패키지를 우선 살펴볼 수 있습니다. 아키텍처를 확인하기 어렵다면 기기 정보와 다운로드 페이지 안내를 참고해 범용 패키지를 선택하세요. 두 클라이언트는 별개의 앱이며 설치 후 서로의 코어를 자동으로 보완하지 않습니다.

구독을 가져와 업데이트한 뒤 설정을 하나 선택하고 연결을 시작하세요. 처음 연결할 때는 시스템의 VPN 연결 권한을 승인해야 하는 경우가 많습니다. 앱을 벗어난 뒤 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 이런 시스템 동작은 구독 유효성과 별개이므로 따로 테스트하면 됩니다. 이미 정상적으로 가져온 그룹을 반복해서 삭제할 필요는 없습니다.

다운로드 페이지로 이동

Linux

v2rayN · deb / rpm · x64 / arm64

Ubuntu, Debian 등에서는 보통 deb 패키지를, Fedora 등에서는 보통 rpm 패키지를 선택합니다. 프로세서 아키텍처도 확인하세요. 여기서 안내하는 것은 구독과 라우팅을 창에서 관리하려는 데스크톱 환경을 위한 그래픽 클라이언트입니다. 배포판에 맞는 패키지를 선택한 뒤에도 데스크톱 환경과 실행 의존성을 확인해야 합니다.

시스템 프록시가 대상 앱에 적용되는지는 데스크톱 환경과 앱의 프록시 설정 처리 방식에 따라 달라집니다. 브라우저는 연결되는데 터미널은 직접 연결된다면 설치 실패로 단정하지 말고 터미널 도구 자체의 프록시 설정을 확인하세요. 시작 시 실행, 로그인 후 실행, 권한이 필요한 네트워크 기능도 각각 따로 설정해 시작 순서가 연결에 영향을 주지 않도록 하세요.

다운로드 페이지로 이동
전체 클라이언트 보기 →

빠른 시작 미리보기

구독 가져오기부터 연결 확인까지

처음에는 간단하게 시작하세요. 유효한 구독 하나, 선택한 설정 하나, 명확한 트래픽 연결 방식 하나면 충분합니다. 먼저 재현 가능한 연결을 만든 다음 자동 업데이트, 사용자 지정 라우팅, TUN을 추가하세요. 이렇게 하면 문제가 생겼을 때 새 설정이 영향을 줬는지 기존 연결 조건이 달라졌는지 구분하기 쉽습니다.

전체 가이드 보기 →

  1. 그룹을 추가하고 구독 업데이트

    데스크톱 클라이언트의 구독 그룹 설정에서 이름과 주소를 추가하고 저장한 뒤 구독을 업데이트하세요. 안드로이드 클라이언트에서도 구독 설정을 통해 같은 준비를 한 다음 업데이트할 수 있습니다. 구독 주소와 개별 설정 공유 링크는 용도가 다릅니다. 링크가 길다는 이유만으로 가져오기 메뉴를 판단하지 마세요. 작업을 마친 뒤 목록에 설정이 표시되는지, 업데이트 실패 메시지가 없는지 확인하세요.

    주소는 저장되는데 내용을 가져오지 못한다면 복사 과정에서 공백이나 줄바꿈이 추가되지 않았는지, 매개변수가 빠지지 않았는지 먼저 확인하세요. 그런 다음 서비스 상태와 업데이트 로그를 살펴보세요. 이 단계에서 라우팅, DNS, 코어 설정을 동시에 바꾸면 실제 원인을 파악하기 어렵습니다.

  2. 설정을 선택하고 연결 방식을 정하세요

    업데이트된 목록에서 사용할 설정을 하나 선택하세요. 데스크톱에서는 먼저 코어를 시작하고 시스템 프록시를 자동 설정합니다. 안드로이드에서는 연결을 시작하고 시스템 권한을 승인하세요. 시스템 프록시와 라우팅 모드는 서로 다른 설정입니다. 시스템 프록시는 앱 요청을 클라이언트로 전달하고, 라우팅은 전달된 요청이 어떤 출구를 사용할지 정합니다.

    기존의 기본 라우팅은 그대로 두고 첫 테스트를 위해 규칙을 하나씩 추가할 필요는 없습니다. 다른 프록시나 가상 네트워크 도구를 실행 중이라면 같은 시스템 설정을 변경하거나 로컬 포트를 점유하는지 먼저 확인한 뒤, 비교 테스트를 위해 잠시 종료할지 결정하세요.

  3. 웹페이지와 다른 앱을 각각 확인하세요

    선택한 출구를 통해 접속해야 하는 대상 하나를 열고, 일반 웹페이지와 로컬 네트워크 서비스에도 계속 접근할 수 있는지 확인하세요. 클라이언트에 시작 성공이 표시되어도 로컬 프로세스가 실행 중이라는 뜻일 뿐, 원격 연결까지 성공했다고 단정할 수는 없습니다. 실제 접속 결과와 로그를 함께 확인하세요. 한 번의 테스트만으로 모든 앱이 연결됐다고 판단하지 마세요.

    브라우저는 되는데 터미널이 안 되면 터미널이 시스템 프록시를 읽는지 확인하세요. 모든 대상에 연결되지 않으면 코어 로그와 설정 유효성을 살펴보세요. 도메인만 실패한다면 DNS 확인 경로를 점검하세요. 연결이 안정적으로 확인된 다음 자동 시작을 설정하고 정상 작동하는 연결 방식을 기록해 두세요.

클라이언트, 코어, 오픈 소스 생태계

Project V, V2Fly, Xray의 관계

클라이언트와 코어의 역할을 이해하면 설치 안내와 오류 로그를 파악하기 쉽습니다. 여러 클라이언트에 같은 프로토콜 이름이 표시되어도 모든 옵션이 동일한 것은 아닙니다. 그래픽 클라이언트를 설치했다고 해서 유효한 원격 서비스까지 갖춰지는 것도 아닙니다. 도구를 선택할 때는 인터페이스, 프로토콜 지원, 설정 출처를 각각 확인하세요.

생태계 배경

Project V: 프록시 프로토콜과 도구의 배경

Project V는 V2Ray 관련 도구를 이해할 때 자주 언급되는 생태계 배경입니다. 프록시 프로토콜, 전송 방식, 라우팅, 설정을 중심으로 다양한 도구가 만들어졌습니다. 일상적으로 말하는 ‘V2Ray 클라이언트’는 관련 설정을 관리하는 그래픽 앱을 통칭하는 경우가 많으며, 반드시 하나의 설치 프로그램을 가리키지는 않습니다. 데스크톱과 안드로이드 클라이언트의 인터페이스는 다르지만, 둘 다 사용자가 고른 설정을 실제 연결을 처리하는 코어에 전달해야 합니다.

따라서 구독 가져오기 절차는 비슷할 수 있지만 세부 설정은 사용하는 클라이언트에 맞춰야 합니다. 프로토콜 이름, 전송 방식, 암호화 매개변수를 다른 앱의 같은 이름 옵션만 보고 그대로 입력하지 마세요. 서비스 측 요구 사항을 먼저 확인한 뒤 클라이언트와 코어가 해당 조합을 지원하는지 점검하는 편이 관련 없는 설정을 여러 개 바꾸는 것보다 효과적입니다.

코어 계열

V2Fly와 Xray: 각기 발전해 온 구현체

V2Fly는 V2Ray 관련 구현을 유지 관리하며, Xray는 관련 기술을 바탕으로 발전한 별도의 코어 계열입니다. 일부 프로토콜 배경을 공유하지만 기능 지원, 설정 필드, 개발 속도는 완전히 같지 않습니다. ‘Xray 코어 사용’ 또는 ‘V2Fly 코어 사용’은 연결 처리 계층의 차이를 뜻하며 인터페이스 스타일이나 서비스 품질을 보장하는 표현은 아닙니다.

코어를 바꿀지는 설정 요구 사항에 따라 판단해야 합니다. 예를 들어 로그에 특정 필드를 인식할 수 없거나 전송 조합이 지원되지 않는다고 표시될 때 호환성을 확인할 수 있습니다. 시스템 프록시가 적용되지 않거나 구독 업데이트가 시간 초과되는 문제라면 먼저 연결 방식과 네트워크 경로를 확인하세요. 코어가 설정을 읽을 수 있어도 서버가 현재 온라인이라는 보장은 없습니다.

오픈 소스 클라이언트 세 가지

v2rayN, v2rayNG, v2flyNG의 역할

v2rayN은 데스크톱용으로 구독 관리, 설정 선택, 시스템 프록시, 라우팅 메뉴를 제공합니다. v2rayNG는 안드로이드 기기용이며 Xray 코어를 사용합니다. v2flyNG도 안드로이드용으로 V2Fly 코어 계열을 선택할 수 있습니다. 세 클라이언트 모두 오픈 소스로 배포되며, 실제 사용 적합성은 기기와 설정 요구 사항, 다운로드한 릴리스 구성에 따라 달라집니다.

오픈 소스 라이선스는 소프트웨어의 사용, 수정, 배포 조건을 설명하며 구독 서비스 요금제를 뜻하지 않습니다. 클라이언트, 코어, 포함된 구성 요소에는 각각 다른 라이선스가 적용될 수 있습니다. 재배포하거나 수정할 때는 해당 라이선스 전문을 확인하세요. 일반 사용자는 시스템 요구 사항과 사용 절차부터 살펴보면 됩니다. 구독을 가져오기 위해 소스 코드를 빌드하거나 수정하는 방법까지 배울 필요는 없습니다.

업데이트 및 설정 관리

소프트웨어 업데이트와 구독 업데이트 구분하기

소프트웨어 업데이트는 인터페이스를 개선하거나 문제를 수정하고 기능 지원을 갱신합니다. 구독 업데이트는 서비스 제공자가 배포한 설정을 다시 가져옵니다. 두 작업은 서로 다릅니다. 구독 내용이 변경되면 해당 그룹을 먼저 업데이트하세요. 클라이언트 호환성 문제가 명확할 때는 릴리스 정보를 읽고 소프트웨어 업데이트를 검토하면 됩니다. 모든 문제 해결의 첫 단계로 재설치를 선택하지 마세요.

소프트웨어를 업데이트하기 전에 사용자 지정 라우팅, 구독 그룹, 필요한 설정을 보관하고 민감한 주소가 저장된 위치를 확인하세요. 업데이트 후에는 기존 연결 방식으로 브라우저, 다른 앱, 로컬 네트워크 접근을 다시 확인한 뒤 사용자 지정 옵션을 하나씩 복원하세요. 버전 차이, 로그 의미, 일반 설정이 궁금하다면 자주 묻는 질문과 증상별 문제 해결 가이드도 참고하세요.

설정별 가이드

프로토콜, 시스템 프록시, DNS 문제 해결

기본 연결을 확인한 뒤 실제로 발생한 문제에 맞는 가이드를 살펴보세요. 프로토콜 안내에서는 설정 유형을 구분하고, 시스템 프록시 점검에서는 브라우저와 터미널의 연결 방식을 비교합니다. DNS 가이드에서는 도메인 확인 요청이 실제로 어떤 경로를 거치는지 다룹니다. 설정을 변경한 뒤에는 같은 대상으로 다시 테스트해야 효과를 판단할 수 있습니다.

문제 해결

V2Ray DNS 누출 테스트 방법과 v2rayN DNS 누출 방지 설정

테스트 결과를 통해 DNS 요청이 어디에서 전송되는지 먼저 확인한 뒤 로컬 DNS, 원격 DNS, TUN에서의 DNS 가로채기를 구분하세요. 설정을 바꾼 뒤 다시 테스트하고, 옵션 하나만 수정한 결과를 모든 DNS 응답이 예상대로 작동한다는 뜻으로 해석하지 마세요.

기초 지식

VMess와 VLESS의 차이: 노드 선택 전 알아두는 1분 프로토콜 가이드

VMess와 VLESS를 프로토콜의 역할, 시간 요구 사항, 전송 방식의 조합을 기준으로 이해하세요. 먼저 공유 링크와 설정 필드를 구분한 뒤 클라이언트가 필요한 기능을 지원하는지 확인하세요. 프로토콜 이름만으로 연결 성능을 판단해서는 안 됩니다.

전체 글 보기 →