클라이언트 / 구독 가져오기 / JSON 설정

v2rayNG 다운로드 사이트v2rayN 및 V2Ray 클라이언트

v2rayN 다운로드 튜토리얼 보기

오픈 소스 클라이언트 다운로드 경로와 구독 가져오기 방법, JSON 설정을 참고해 플랫폼과 코어에 맞는 항목을 선택하세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY

01 / 클라이언트 다운로드

플랫폼에 맞는 V2Ray 클라이언트 선택

운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 살펴보세요. V2Fly 코어 호환성이 필요한 경우 v2flyNG를 고려할 수 있습니다. 다운로드 페이지에서 파일과 설치 조건을 확인할 수 있으며, 홈페이지에는 특정 릴리스 버전을 고정해 안내하지 않습니다.

Windows

 데스크톱은 v2rayN 우선

v2rayN은 데스크톱 버전과 클래식 WPF 버전의 다운로드 경로를 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 익숙한 클래식 데스크톱 사용 방식을 이어갑니다. 두 버전 모두 설정과 구독 관리에 사용됩니다. 시스템 요구 사항과 사용 습관에 따라 선택하고, 같은 구독을 위해 두 인터페이스를 모두 설치할 필요는 없습니다.

설치 전에 시스템의 ‘정보’에서 시스템 유형을 확인하세요. 처음 실행한 뒤 기존 설정을 가져오고 활성 설정을 선택한 다음 시스템 프록시를 설정합니다. 브라우저는 보통 시스템 프록시를 사용하지만, 터미널과 일부 앱은 프록시 주소를 따로 설정해야 합니다. 클라이언트가 실행된다고 모든 프로그램이 프록시를 사용한다는 뜻은 아닙니다.

기존 설정을 옮길 때는 먼저 구독 그룹과 사용자 지정 라우팅을 백업하세요. 작동하는 설정을 하나 남겨 두고 로컬 포트와 프록시 모드를 하나씩 조정하면 차이를 파악하기 쉽습니다.

Windows 다운로드

macOS

v2rayN의 macOS 설치 파일은 Apple Silicon과 Intel용으로 나뉩니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 해당 설치 파일을 선택하세요. 설정은 데스크톱 운영체제 간에 재사용할 수 있지만, 로컬 파일 경로와 권한, 네트워크 연결 방식은 다시 확인해야 합니다.

설치 후에는 구독을 정상적으로 가져올 수 있는지 확인하고 현재 설정과 수신 대기 포트를 점검하세요. 시스템 프록시와 TUN 연결은 적용 범위가 다르며, TUN은 네트워크 권한과 라우팅 변경도 수반합니다. 처음에는 확인하기 쉬운 연결 방식을 사용하고 접속 결과를 살펴본 뒤 규칙을 추가하는 것이 좋습니다.

시스템 보안 알림이 표시되면 내용을 읽고 선택한 파일이 기기 아키텍처에 맞는지 확인하세요. 실행 실패, 권한 요청, 원격 연결 실패를 모두 같은 문제로 취급하지 마세요.

macOS 다운로드

Android

 v2rayNG 우선

v2rayNG는 Xray 코어를 사용하며 일반적인 공유 링크와 구독을 관리하는 데 적합합니다. v2flyNG는 V2Fly 코어를 사용하며 특정 설정이 필요한 경우 대안으로 고려할 수 있습니다. 비교적 최신 기기는 arm64를 선택할 수 있습니다. 아키텍처를 확인하기 어렵거나 설치 호환 문제가 있으면 다운로드 페이지의 안내에 따라 범용 버전을 선택하세요.

설정을 가져온 뒤에는 사용할 항목을 선택하고 연결을 시작해야 합니다. 시스템에서 VPN 연결 권한을 요청하는 것은 앱 트래픽을 로컬 전달 경로로 보내기 위한 절차입니다. 다른 앱이 같은 종류의 연결을 사용 중이라면 충돌 여부를 먼저 확인한 다음 앱별 프록시, 라우팅 모드, 백그라운드 배터리 제한을 점검하세요.

v2rayNG에서 구독을 가져오는 메뉴와 단일 링크를 가져오는 메뉴는 서로 다릅니다. 설정 묶음을 이후에도 업데이트하려면 구독 그룹을 사용하고, 단일 설정을 임시로 가져오려면 클립보드나 QR 코드 방식을 사용하세요.

Android 다운로드

Linux

Linux 데스크톱에서는 v2rayN을 사용합니다. 배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택하고 프로세서가 x64인지 arm64인지 확인하세요. 패키지 형식과 프로세서 아키텍처는 별개의 조건입니다. 패키지 관리자가 파일을 인식하더라도 프로그램이 현재 프로세서에서 실행된다는 보장은 없습니다.

설치한 뒤 GUI에서 구독을 가져오고 로컬 수신 대기 상태를 확인하세요. 데스크톱 환경과 브라우저, 터미널은 프록시 설정을 적용하는 방식이 다를 수 있으므로 각각 점검해야 합니다. TUN을 켜기 전에는 필요한 권한과 시스템 라우팅을 확인하세요. 트래픽을 가로채는 도구를 여러 개 동시에 실행하면 충돌이 생길 수 있습니다.

문제 해결을 시작할 때는 기본 라우팅과 포트를 유지하고 로그에 수신 대기 오류나 DNS 확인 오류가 있는지 살펴보세요. 클라이언트 실행 문제와 앱 연결 문제를 먼저 구분한 뒤 코어 설정을 변경하세요.

Linux 다운로드

전체 클라이언트 보기 → 코어별 차이가 헷갈린다면 먼저 선택 가이드를 읽어 보세요.

02 / 설정 섹션 살펴보기

로컬 인바운드부터 라우팅까지

GUI는 설정을 만들고 관리하며, 코어는 설정에 따라 트래픽을 전달합니다. 데이터가 어디로 들어오고 어떤 아웃바운드로 전송되는지 먼저 이해한 뒤 라우팅과 DNS를 조정하면 여러 설정을 한꺼번에 잘못 바꾸는 일을 줄일 수 있습니다. 아래 예시는 각 필드를 설명하기 위한 것으로, 원격 서버에 바로 연결할 수 있는 완성 설정이 아닙니다.

v2rayN / 설정 → 로컬 수신 대기 관련 설정

인바운드에서 앱 연결 방식을 결정합니다

로컬 인바운드는 브라우저나 다른 앱에서 들어오는 연결을 받습니다. GUI 클라이언트가 보통 이 설정을 만들어 주므로, 평소에는 설정에서 수신 대기 포트를 확인한 뒤 앱에서도 같은 주소와 포트를 사용하면 됩니다. 예시는 루프백 주소만 수신하므로 이 기기에서만 사용할 수 있습니다. LAN에 개방하려면 별도로 접근 제어를 설정해야 합니다. SOCKS와 HTTP 인바운드는 사용 방식이 다르므로 포트만 바꾸고 프로토콜을 확인하지 않으면 안 됩니다. 포트 충돌이 발생하면 원격 설정을 계속 바꾸기보다 먼저 충돌하는 프로그램을 찾으세요.

{
  "inbounds": [
    {
      "tag": "socks-in",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}

03 / 오픈 소스 생태계와 유지 관리

Project V, V2Fly, Xray의 역할 구분

제품명, 코어 이름, 프로토콜 이름은 서로 다른 계층을 나타냅니다. 클라이언트를 고를 때는 먼저 실행 플랫폼을 확인하고, 설정 호환성을 판단할 때는 코어 지원 범위와 서버 매개변수를 살펴보세요. 오픈 소스 생태계에서는 구현 내용을 검토하고 지속적인 개선을 확인할 수 있지만, 실제 연결 결과는 설정과 시스템, 네트워크 환경에 따라 달라집니다.

PROJECT V

프로젝트 생태계는 단일 설치 프로그램이 아닙니다

Project V는 V2Ray 도구 생태계를 이해하는 출발점입니다. 코어 구현은 프로토콜 처리, 연결 전달, 라우팅, DNS 확인 등의 기반 기능을 담당합니다. GUI 클라이언트는 그 위에 설정 편집과 구독 관리, 시스템 연결 기능을 제공합니다. 따라서 ‘V2Ray 공식 사이트’나 ‘V2Ray 클라이언트’를 검색하면 프로젝트 문서, 코어 설명, GUI 프로그램 등 서로 다른 자료가 나올 수 있습니다. 이 사이트는 다운로드, 입문, 필드 참고 자료를 구분해 안내하므로 각 역할을 하나의 설치 목록으로 혼동하지 않아도 됩니다.

이 차이를 이해하면 문제도 쉽게 분류할 수 있습니다. 가져오기 메뉴를 찾을 수 없다면 먼저 클라이언트 사용법을 확인하고, 로그에 인식할 수 없는 필드가 표시되면 코어의 지원 여부를 점검하세요. 브라우저가 로컬 포트에 연결되지 않는다면 시스템 프록시 설정을 확인해야 합니다. GUI를 바꿔도 원격 서버 매개변수 오류가 해결되는 것은 아니며, 프로토콜을 바꿔도 올바른 앱 연결 설정을 대신할 수 없습니다.

XRAY / V2FLY

코어는 공통 기반을 갖추면서도 각자 발전합니다

V2Fly는 V2Ray를 잇는 커뮤니티 유지 관리 경로를 이어가고, Xray는 관련 기술을 바탕으로 자체 기능과 설정을 발전시켜 왔습니다. 두 코어는 공통 개념을 공유하지만 새 필드와 전송 조합, 기본 동작이 완전히 같다고 볼 수는 없습니다. 특히 REALITY와 XTLS Vision을 사용할 때는 Xray에 맞는 설정인지 확인하고 임의의 코어에 설정 조각을 그대로 넣지 마세요. 코어 선택은 필요한 기능과 설정 호환성을 기준으로 해야 하며, 이름만 보거나 어느 한쪽이 항상 더 빠르다고 가정해서는 안 됩니다.

V2Ray 프로토콜을 선택할 때는 서버 측 지원도 필요합니다. VMess, VLESS, Trojan은 인증 방식이 다르며 TLS, REALITY, 전송 계층 매개변수도 각각 별도로 확인해야 합니다. 공유 링크에는 대개 이런 조합 정보가 포함되어 있으므로 가져온 뒤 주소와 포트, 서버 이름, 흐름 제어 설정을 점검하세요. 한 가지 테스트에 성공했더라도 특정 테스트 경로만 확인된 것이며, 모든 웹사이트와 앱 사용 환경이 검증된 것은 아닙니다.

CLIENTS

오픈 소스 클라이언트 3종의 용도

v2rayN은 데스크톱 환경용으로 구독 그룹과 활성 설정 선택, 라우팅 관리, 프록시 연결 설정을 제공합니다. 실제 사용할 수 있는 코어는 배포 패키지와 클라이언트 지원 범위에 따라 달라집니다. v2rayNG는 Android 기기용으로 Xray 코어와 시스템 VPN 연결을 활용해 연결을 관리합니다. v2flyNG도 Android용이지만 V2Fly 코어를 사용하므로 기존 설정이 해당 구현에 의존하는 경우 적합합니다. 세 클라이언트 모두 오픈 소스 프로젝트이며, 실제 사용 전 해당 릴리스 안내와 라이선스 파일을 확인하세요.

클라이언트는 설정을 저장할 뿐 서버를 자동으로 제공하지 않습니다. 구독 주소와 인증 매개변수는 신뢰할 수 있는 출처에서 받고 사용 권한에 맞게 안전하게 관리하세요. 구독 링크에는 접근 인증 정보가 포함될 수 있으므로 문제 해결 과정에서 전체 주소를 공개하지 마세요. 오류 정보를 공유할 때는 오류 유형과 필드 이름, 발생 단계를 남기되 주소에 포함된 개인 식별 정보와 인증 정보는 삭제하세요.

LICENSE / UPDATE

라이선스, 클라이언트 업데이트, 구독 업데이트는 각각 다릅니다

오픈 소스 라이선스는 소스 코드의 사용과 수정, 재배포 조건을 설명합니다. GUI 클라이언트와 코어, 함께 제공되는 데이터 리소스에는 서로 다른 라이선스가 적용될 수 있으므로 생태계 전체를 하나의 라이선스로 단정할 수 없습니다. 무료 사용 여부와 관계없이 서버 리소스와 네트워크 접근, 서드파티 서비스에는 각각의 이용 조건이 적용됩니다. 설정 설명서는 기술 필드를 안내하지만 프로젝트 라이선스 문서를 대신하지 않으며, 출처가 다른 모든 설정의 적합성을 보장하지도 않습니다.

클라이언트 업데이트는 프로그램과 관련 구성 요소를 교체합니다. 구독 업데이트는 연결 설정 묶음을 다시 가져옵니다. 라우팅 데이터 업데이트는 geosite, geoip 등의 분류 기준을 바꿉니다. 각각 해결하는 문제가 다릅니다. 업그레이드 전에 사용자 지정 라우팅과 구독 그룹을 백업하고, 업그레이드 후에는 기존에 작동하던 설정부터 확인한 다음 새 기능을 하나씩 활성화하세요. ‘구독 업데이트 성공’을 프로그램 업데이트 완료로 오해하지 말고, 한 번의 문제 해결 과정에서 모든 설정을 동시에 바꾸지 마세요.

다운로드 후 확인 순서

처음 사용할 때는 가져오기 유형부터 확인하세요. vmess://, vless:// 등으로 시작하는 내용은 보통 공유 링크입니다. 설정 묶음을 정기적으로 가져오는 주소는 구독 관리에 입력해야 합니다. 가져오기가 끝나면 활성 항목을 선택하고 현재 플랫폼에 맞는 트래픽 연결 방식을 켠 다음 브라우저와 인터넷이 필요한 앱을 각각 확인하세요. 단계를 마칠 때마다 결과를 점검하고 다음 단계로 넘어가면 가져오기, 연결, 앱 연결 중 어디에서 실패했는지 파악하기 쉽습니다.

기존 설정이 갑자기 작동하지 않으면 먼저 로컬 수신 대기 상태와 활성 설정, 오류 로그를 확인한 뒤 구독이 변경되었는지 살펴보세요. V2Ray 지연 시간 테스트와 실제 웹페이지 접속은 서로 다른 검증입니다. 테스트 대상과 DNS 경로, 적용 규칙이 다를 수 있습니다. 구체적인 절차는 입문 가이드에서, 오류 증상별 확인 방법은 FAQ에서 살펴보세요. 필드를 변경해야 한다면 JSON 설명서를 참고하세요.

04 / 설정 주제별 안내

구독 형식, 라우팅 규칙, 프록시 문제 해결

아래 주제는 설정 출처와 연결 라우팅, 앱 연결 문제를 각각 다룹니다. 문제가 발생한 계층에 맞춰 살펴본 뒤 클라이언트에서 결과를 확인하세요. 형식 변환은 표현 방식만 바꿀 뿐 누락된 서버 매개변수를 보충하지 않습니다. 라우팅 규칙은 기존 아웃바운드를 선택할 뿐 올바른 연결 설정을 대신하지 않습니다.

구독 관리

V2Ray 구독 형식 비교: Base64 구독, 네이티브 JSON, 공유 링크 간 변환

자주 쓰이는 구독 및 설정 형식 세 가지의 구조와 용도를 비교하고, 서로 변환하는 방법과 변환 후 클라이언트에서 가져오기 결과를 확인하는 절차를 안내합니다.

글 읽기 →
라우팅

V2Ray 라우팅 규칙 실전: geosite·geoip로 한국 국내외 트래픽 나누기

실제 routing 설정 예시로 중국 본토 사이트는 직접 연결하고 해외 사이트는 프록시를 사용하도록 트래픽을 나누는 방법을 보여 줍니다. domainStrategy의 선택 기준과 규칙 적용 순서도 설명합니다.

글 읽기 →
문제 해결

v2rayN 시스템 프록시가 작동하지 않을 때: 브라우저와 명령줄 터미널 따로 점검하기

브라우저와 터미널은 프록시 설정을 읽는 방식이 다릅니다. 확장 프로그램 충돌, PAC 모드, 환경 변수, 로컬 포트를 차례로 점검하세요.

글 읽기 →

전체 글 보기 →