V2Ray 클라이언트다운로드 · 구독 · 연결 설정

v2rayN 클라이언트 다운로드및 V2Ray 설정 가이드

v2rayN 다운로드 가이드 보기

기기에 맞는 클라이언트를 선택하고 구독 가져오기, 시스템 프록시 및 TUN을 설정한 뒤 실제 연결 테스트로 구성을 확인하세요.

오픈 소스구독 그룹라우팅

설정 가이드

구독 · 프록시 · 라우팅

사용 설명서 열기 →

구독 가져오기 →

서비스 제공자가 안내한 구독 주소를 그룹에 저장한 뒤 업데이트하세요. 구독은 설정을 가져오는 경로일 뿐 클라이언트 자체가 아닙니다. 설치 후에도 사용할 수 있는 연결 정보가 필요합니다.

프록시 모드 →

먼저 시스템 프록시로 브라우저 접속을 확인한 다음 TUN이 필요한지 판단하세요. 트래픽 처리 방식은 어떤 앱의 트래픽을 클라이언트로 보낼지 결정하고, 라우팅 규칙은 들어온 트래픽의 경로를 정합니다.

연결 확인 →

먼저 연결이 설정되는지 테스트한 다음 대상 페이지와 출구 IP를 확인하세요. 한 번 측정한 지연 시간은 다운로드 속도를 뜻하지 않으며 DNS, 규칙 적용 여부, 실제 접속 결과를 확인하는 절차를 대신할 수 없습니다.

구독 하나로 사용할 수 있는 설정 만들기

구독 그룹 설정

여러 출처의 서버를 한 목록에서 관리하면 업데이트 범위를 혼동하기 쉽습니다. 먼저 ‘구독 그룹 설정’에서 알아보기 쉬운 메모를 입력하고 전체 구독 주소를 붙여 넣은 뒤 저장하고 업데이트하세요. v2rayN에서는 그룹별로 서버를 필터링할 수 있으며, v2rayNG에서도 구독 그룹 관리 메뉴에서 출처를 관리할 수 있습니다. 연결 링크를 하나씩 붙여 넣는 것보다 구독을 이용하면 여러 설정을 한꺼번에 갱신하기 편하지만, 결과는 서비스 제공자가 반환하는 내용에 따라 달라집니다. 목록이 비어 있으면 클라이언트를 반복해서 재설치하지 말고 주소와 유효 기간, 네트워크를 먼저 확인하세요. 구독 주소에는 접속 정보가 포함되는 경우가 많으므로 화면을 공유하거나 도움을 요청할 때 전체 주소를 가리세요.

구독 그룹 및 필터링 활용 →

구독 그룹 설정

메모일반 구독
구독 주소 예시https://example.com/sub?token=xxxx
업데이트 사용 · 켜짐

설정 예시입니다. 클라이언트에서 직접 설정하세요.

설치 파일 다운로드

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

전체 클라이언트 보기 →

데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하다면 v2flyNG를 고려할 수 있습니다. 설치 파일은 운영체제뿐 아니라 프로세서 아키텍처와 패키지 형식도 맞아야 하므로 파일 이름의 클라이언트명만 보고 선택하면 안 됩니다. 아래 링크를 누르면 다운로드 페이지의 해당 플랫폼 섹션으로 이동하며, 설치 요구사항도 그 페이지에서 확인할 수 있습니다.

클라이언트는 연결 설정을 읽어 사용하며 이용 가능한 구독 서비스를 제공하지 않습니다. 설치 전에 서비스 제공자가 안내한 구독 주소나 연결 링크를 준비하고 기기의 시간이 정확한지, 네트워크에 정상적으로 접속할 수 있는지 확인하세요. 다른 프록시 도구를 사용 중이라면 포트나 시스템 네트워크 설정이 충돌하지 않도록 먼저 프록시 기능을 중지하세요.

Windows

v2rayN · 추천

다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 새로운 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 기존 조작 방식을 유지합니다. 운영체제 요구사항과 사용 습관을 고려해 선택하고, 인터페이스를 시험하려고 두 프록시를 동시에 실행할 필요는 없습니다.

처음 설치할 때는 쓰기 권한이 있고 장기간 보관하기 편한 폴더를 선택한 뒤 패키지 안내에 따라 실행하세요. 먼저 구독을 가져오고 코어가 정상적으로 작동하는지 확인한 다음 시스템 프록시를 켜세요. TUN이 필요하면 권한과 가상 네트워크 어댑터 상태를 확인하세요. 관리자 권한을 모든 연결 문제의 해결책으로 여기지 마세요.

다운로드 페이지로 이동 →

macOS

v2rayN · 데스크톱 클라이언트

먼저 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 아키텍처에 맞는 파일을 사용하면 호환성 계층으로 인한 변수를 줄일 수 있습니다. 두 설치 파일은 기능 등급이 다른 것이 아니라 서로 다른 프로세서 플랫폼에 대응합니다.

앱을 자주 사용하는 애플리케이션 폴더에 설치하세요. 처음 실행할 때 시스템 경고가 표시되면 보안 설정에서 앱 출처와 허용 항목을 확인하고 보안 기능 전체를 끄지는 마세요. 연결 전에 기존 네트워크 프록시 설정을 확인하고, 연결한 다음 브라우저 접속을 테스트하세요. TUN 설정은 클라이언트 안내와 현재 시스템의 권한 요구사항을 따르세요.

다운로드 페이지로 이동 →

Android

v2rayNG · 추천

Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 코어가 필요하다면 v2flyNG를 선택할 수 있습니다. 최근 출시된 대부분의 스마트폰에는 arm64 패키지가 적합합니다. 기기 아키텍처를 확인하기 어렵다면 다운로드 페이지에서 범용 패키지 안내를 확인하고 기기 정보를 바탕으로 선택하세요.

설치할 때 신뢰할 수 있는 출처에 필요한 권한만 허용하세요. 구독 그룹을 추가하고 설정을 업데이트한 뒤 서버를 선택하고 연결을 누른 다음 Android VPN 권한을 허용하세요. 일반적으로 한 번에 하나의 앱만 이 연결을 사용할 수 있습니다. 백그라운드에서 연결이 끊기면 같은 구독을 반복해서 가져오기보다 배터리 절약 정책과 백그라운드 실행 제한을 확인하세요.

다운로드 페이지로 이동 →

Linux

v2rayN · 데스크톱 클라이언트

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택하고 x64 또는 arm64 아키텍처도 확인하세요. deb는 Debian, Ubuntu 등의 배포판에서 주로 사용하고 rpm은 Fedora 등의 배포판에서 주로 사용합니다. 파생 배포판에서는 해당 배포판의 패키지 및 의존성 안내를 확인해야 합니다.

설치 후 데스크톱 세션에서 클라이언트가 실행되는지, 로컬 포트가 열리는지 먼저 확인한 다음 브라우저가 데스크톱 환경의 시스템 프록시 설정을 따르는지 점검하세요. 앱마다 프록시 설정을 읽는 방식이 다를 수 있으므로 브라우저 접속이 된다고 해서 모든 프로세스의 트래픽이 처리되는 것은 아닙니다. TUN이 필요하면 추가 권한과 라우팅을 설정하세요. 데스크톱 작업 전체를 계속 높은 권한으로 실행하지 마세요.

다운로드 페이지로 이동 →

빠른 시작 미리보기

설정 가져오기부터 첫 연결까지

전체 가이드 보기 →

한 번에 한 단계만 바꾸세요. 먼저 설정을 클라이언트로 가져오고, 다음으로 트래픽 처리 범위를 정한 뒤, 실제 요청이 되는지 확인하세요. 문제가 생겨도 어느 단계부터 점검해야 하는지 파악하기 쉽습니다.

  1. 구독 추가 및 설정 업데이트

    v2rayN에서 구독 그룹 설정을 열고 출처를 구분할 메모를 입력하세요. 구독 주소 전체를 붙여 넣어 저장한 다음 구독을 업데이트합니다. v2rayNG에서는 구독 그룹 메뉴에서 같은 작업을 진행하세요. 복사할 때 앞뒤 공백, 누락된 매개변수, 줄바꿈이 없는지 확인하세요. 웹사이트 로그인 주소는 보통 구독 주소로 사용할 수 없습니다.

    업데이트 후 현재 그룹에 서버가 표시되는지 먼저 확인하세요. 목록이 비어 있으면 업데이트 안내를 읽고 서비스가 유효한지, 구독 주소에 접속할 수 있는지 확인하세요. 기존 설정을 전부 삭제하지 말고 먼저 원래 설정을 백업한 뒤 새 그룹만 따로 테스트하세요. 그래야 문제를 확인할 때 기존에 작동하던 설정과 비교할 수 있습니다.

  2. 서버 및 프록시 방식 선택

    사용할 서버를 실제 연결 테스트한 뒤 활성 서버로 지정하세요. 데스크톱에서는 시스템 프록시 자동 설정을 선택하고 기본 또는 내장 라우팅 설정으로 먼저 확인하세요. Android에서는 설정을 선택하고 연결을 누른 다음 시스템 VPN 권한 안내를 읽고 허용하세요. 화면에 연결 중이라고 표시되어도 트래픽 처리가 시작됐다는 의미일 뿐이므로 실제 접속 테스트가 필요합니다.

    시스템 프록시, TUN, 라우팅은 서로 다른 설정입니다. 앞의 두 설정은 트래픽을 클라이언트로 보내는 방식을 정하고 라우팅은 들어온 트래픽의 출구를 정합니다. 일반 브라우저 접속이 정상인지 확인한 뒤 앱 요구사항에 따라 TUN을 켜거나 규칙을 추가하세요. 기기에 다른 프록시, 네트워크 가속, VPN 도구가 설치되어 있다면 먼저 트래픽 처리 기능을 중지하세요.

  3. 접속 확인 및 기준 기록

    프록시를 통해 접속해야 하는 대상을 하나 열어 페이지가 완전히 로드되는지 확인한 뒤, 신뢰할 수 있는 출구 IP 확인 서비스를 이용해 요청 경로를 점검하세요. 테스트 전에 브라우저 캐시와 별도 프록시 확장 프로그램을 확인하고 필요하면 새 브라우저 세션을 사용하세요. 실제 연결 테스트는 성공했는데 웹페이지가 열리지 않으면 서버만 바꾸지 말고 두 테스트의 대상, DNS, 라우팅을 먼저 비교하세요.

    정상 작동을 확인했다면 활성 그룹, 프록시 방식, 라우팅 선택을 기록해 이후 변경의 기준으로 삼으세요. 문제가 생기면 먼저 이 설정으로 되돌린 뒤 구독 만료 여부, 로컬 포트 충돌, 시스템 시간 정확성을 확인하세요. 도움을 요청할 때는 오류 메시지와 작업 단계를 공유하되 구독 주소와 연결 인증 정보는 공개하지 마세요.

연결 전 설정 확인

구독 그룹추가 및 업데이트 완료
활성 서버수동 선택
시스템 프록시자동 설정
라우팅 설정중국 본토 우회
TUN 모드 사용 · 꺼짐

정적 화면 예시입니다. 웹페이지의 설정은 기기 네트워크를 변경하지 않으므로 클라이언트에서 직접 설정하세요.

연결에 실패하면 어느 단계부터 확인할까요?

구독 업데이트에 실패하면 주소와 접속 조건을 먼저 확인하세요. 목록에는 서버가 있지만 연결되지 않으면 서버 매개변수와 코어 로그를 확인하세요. 특정 앱만 실패하면 트래픽 처리 범위와 라우팅을 점검하세요. 문제를 한 단계로 좁힌 다음 설정을 조정하세요.

증상별 자주 묻는 문제 →

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

클라이언트와 코어의 역할

용어 설명서 보기 →

V2Ray는 특정 인터페이스를 가리키는 소프트웨어 이름이 아닙니다. Project V 생태계는 프록시 프로토콜, 전송 방식, 라우팅 기능을 중심으로 발전해 왔으며, 그래픽 클라이언트는 이러한 기능을 구독, 서버, 프록시 모드, 로그 등의 설정 메뉴로 제공합니다. 특정 버튼의 위치를 외우는 것보다 각 구성 요소의 역할을 이해하는 것이 더 유용합니다.

Project VV2FlyXray

이 사이트에서는 세 클라이언트의 설치 경로와 한국어 설정 안내를 정리합니다. 클라이언트, 코어 프로젝트, 구독 서비스를 제공하는 업체는 각각 역할이 다릅니다. 클라이언트가 사용할 수 있는 서비스를 자동으로 만들어 주지는 않으며, 코어가 프로토콜을 지원해도 서버 설정이 올바르다는 뜻은 아닙니다. 구독의 유효 여부는 서비스 제공자가 결정합니다.

Project V, V2Fly, Xray

Project V는 V2Ray 생태계를 이해하는 데 필요한 배경을 제공합니다. V2Fly는 V2Ray 관련 프로젝트를 계속 관리하고 있으며, Xray는 관련 기술 생태계에서 발전한 별도의 코어 계열입니다. 공통된 개념도 있지만 기능 발전 방향, 프로토콜 지원, 설정 세부 사항은 서로 완전히 같지 않습니다. 가이드에 나오는 프로토콜명, 전송 유형, 보안 옵션은 사용 중인 코어가 지원하는지 확인해야 합니다.

설정을 가져오는 데 성공했는데 실행되지 않는다면 항목이 표시되는지만 보지 말고 프로토콜과 코어의 지원 여부를 확인하세요. 서비스 제공자의 설정 안내, 클라이언트에서 선택한 코어, 오류 로그를 함께 살펴봐야 합니다. 용어가 비슷하다고 매개변수를 그대로 바꿔 쓸 수 있는 것은 아닙니다.

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

v2rayN은 데스크톱용 오픈 소스 그래픽 클라이언트로 구독, 시스템 프록시, 라우팅을 통합 관리하는 데 적합합니다. v2rayNG는 Android용이며 Xray 코어를 사용해 모바일 기기에서 설정을 가져오고 연결을 관리할 수 있습니다. v2flyNG도 Android용으로 V2Fly 코어가 필요한 사용자에게 다른 선택지를 제공합니다. 세 제품 모두 클라이언트이며 구독 서비스를 판매하는 곳은 아닙니다.

먼저 기기 플랫폼을 확인하고 서비스 제공자가 사용하는 프로토콜과 전송 설정을 살펴보세요. 특별한 호환성 요구사항이 없다면 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 사용하세요. 이미 안정적으로 작동하는 환경이 있다면 이름이 다르다는 이유만으로 설정을 반복해서 옮길 필요는 없습니다. 클라이언트마다 화면과 내보내기 형식이 다를 수 있으므로 이전하기 전에 구독을 다시 가져올 수 있는지 확인하세요.

오픈 소스 라이선스와 설정 정보 보호

오픈 소스 소프트웨어는 각 프로젝트의 라이선스 조건에 따라 소스 코드가 제공된다는 뜻입니다. 사용, 수정, 재배포 시 해당 라이선스를 따라야 합니다. 클라이언트와 코어는 별개의 프로젝트이므로 한 프로젝트의 라이선스를 전체 구성에 그대로 적용할 수는 없습니다. 오픈 소스라는 점이 설치 출처, 시스템 권한, 연결 설정을 신중히 확인해야 할 필요성을 대신하지는 않습니다.

구독 주소, 연결 링크, 내보낸 설정 파일에는 접속 정보가 포함될 수 있습니다. 문제 화면을 공유할 때는 전체 주소, 계정 식별 정보, 인증 정보를 가리세요. 로그를 공개하기 전에도 이러한 정보가 포함되어 있는지 확인하세요. 백업 파일은 접근을 제한할 수 있는 위치에 보관하고 기기를 교체하거나 다른 사람에게 넘기기 전에 저장된 설정과 자동 업데이트 작업을 삭제하세요.

클라이언트 업데이트와 구독 업데이트

클라이언트 업데이트는 프로그램 인터페이스, 호환성 또는 코어 구성을 바꾸고, 구독 업데이트는 서비스 제공자에게서 서버 설정을 다시 가져옵니다. 두 작업은 해결하는 문제가 다릅니다. 서버가 만료됐다면 구독 상태를 확인해야 하고, 프로토콜 옵션을 지원하지 않는다면 클라이언트나 코어의 기능을 살펴봐야 합니다. 연결 실패를 모두 프로그램 업데이트 문제로 돌리면 안 됩니다.

업데이트 전에 구독 그룹, 라우팅, 필요한 사용자 지정 설정을 저장하고 설치 조건과 변경 사항을 확인하세요. 업데이트 후에는 기존에 작동하던 설정으로 먼저 테스트한 다음 추가 설정을 하나씩 복원하세요. 특정 앱에서만 문제가 발생하면 다른 검증된 조건은 유지하고 해당 앱의 프록시 방식을 확인하세요. 여러 매개변수를 한꺼번에 바꾸기보다 재현 가능한 작업 기록을 남기는 편이 문제를 찾기 쉽습니다.

기술 노트

설치 · 속도 테스트 · 라우팅 활용

전체 글 보기 →

기본 연결이 되면 목적에 맞는 노트를 확인하세요. 첫 설치에서는 실행 환경과 초기 설정을 살펴보고, 연결을 선택할 때는 실제 연결 테스트와 접속 결과를 확인하세요. 트래픽 경로를 직접 설정해야 한다면 도메인, IP, 규칙 순서를 더 자세히 살펴보세요. 각 노트는 한 가지 작업을 다루므로 현재 설정을 항목별로 확인하기 쉽습니다.