v2rayN · v2rayNG · v2flyNG

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

v2rayN 다운로드 가이드 보기

오픈소스 클라이언트 다운로드와 설정 안내. 플랫폼별로 구독 가져오기부터 라우팅 설정까지 차근차근 살펴보세요.

프로토콜
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
플랫폼

클라이언트 다운로드

운영체제에 맞는 설치 파일 선택

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 데스크톱에서는 v2rayN, Android에서는 우선 v2rayNG를 살펴보세요. V2Fly 설정이 필요하다면 v2flyNG도 확인할 수 있습니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 버전은 기존 사용 방식에 익숙한 사용자에게 적합합니다. 처음 설치한다면 실행 환경 안내를 먼저 확인하고, 두 버전을 모두 설치할 필요는 없습니다.

프로그램과 설정 파일은 관리하기 편한 위치에 두고, 업데이트 전에는 구독 그룹과 라우팅 설정을 백업하세요. 실행한 뒤 서버를 가져오고 시스템 프록시를 설정하면 됩니다.

Windows 다운로드

macOS

v2rayN은 Apple Silicon용과 Intel용 설치 파일을 제공합니다. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 실제 하드웨어에 맞는 파일을 선택하세요. 컴퓨터 외관이나 구입 연도만으로 판단하지 마세요.

처음 실행할 때 표시되는 시스템 권한 안내를 확인하세요. 시스템 프록시나 가상 네트워크 인터페이스 설정은 현재 시스템의 권한 및 클라이언트 안내에 따라 진행해야 합니다.

macOS 다운로드

Android

v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 기반으로 합니다. 최근 출시된 대부분의 스마트폰은 arm64를 선택할 수 있습니다. 프로세서 아키텍처를 모르겠다면 다운로드 페이지에서 범용 버전 안내를 먼저 확인하세요.

연결을 시작하면 시스템에서 VPN 권한을 요청합니다. 다른 VPN 앱이 실행 중이라면 충돌하는 연결을 먼저 종료하세요. 백그라운드에서 연결이 끊긴다면 배터리 최적화 설정도 확인해야 합니다.

Android 다운로드

Linux

v2rayN은 배포판의 패키지 형식에 따라 deb 및 rpm 설치 파일을 제공하며, x64와 arm64를 구분합니다. 배포판 종류와 기기 아키텍처를 확인한 뒤 시스템 패키지 설치 도구로 설치하세요.

데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다를 수 있습니다. 앱에서 시스템 프록시를 사용하지 않는다면 서버를 계속 바꾸기보다 해당 앱의 네트워크 설정부터 확인하세요.

Linux 다운로드
모든 클라이언트 보기

설정 핵심

구독, 라우팅 및 네트워크 모드

클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 두 역할을 구분해 두면 문제가 생겼을 때 확인할 설정을 더 쉽게 찾을 수 있습니다.

구독 가져오기 및 그룹 관리

구독은 서버 설정을 갱신하는 경로이지, 클라이언트가 제공하는 연결 서비스가 아닙니다. 유효한 구독 주소를 받았다면 별도의 그룹을 만들고 업데이트하세요. 이후에는 출처별로 서버를 정리할 수 있어 매번 매개변수를 직접 입력하지 않아도 됩니다.

  • 출처별로 그룹을 만드세요. 용도를 알아보기 쉬운 이름을 지정해 서로 다른 출처의 서버가 섞이지 않도록 하세요. 업데이트 전에는 작업할 그룹을 확인하고, 삭제할 때도 영향을 받는 범위를 쉽게 파악할 수 있습니다.
  • 가져온 뒤 내용을 확인하세요. 구독 주소를 저장했다고 서버가 자동으로 목록에 추가되는 것은 아닙니다. 업데이트 후 항목이 표시되는지 확인하고, 현재 선택한 서버가 방금 가져온 그룹에 속하는지 살펴보세요.
  • 구독 주소와 공유 링크를 구분하세요. 공유 링크 하나에는 보통 서버 설정 하나가 들어 있고, 구독 주소는 여러 설정을 가져오는 데 사용됩니다. 알맞은 가져오기 메뉴를 선택하면 형식 인식 오류를 줄일 수 있습니다.

라우팅 및 아웃바운드 선택

라우팅은 연결을 직접 연결할지 프록시로 보낼지 결정합니다. 서버 선택과는 별개입니다. 프록시 서버를 선택했더라도 직접 연결 규칙에 해당하는 연결은 직접 연결됩니다. 먼저 규칙의 적용 순서를 파악한 뒤 도메인이나 주소 규칙을 추가하세요.

  • 구체적인 규칙을 앞에 두세요. 특정 도메인이나 로컬 네트워크 주소 규칙은 범위가 넓은 규칙과 구분해 관리하세요. 규칙이 겹친다면 목록에 대상 도메인이 있는지만 볼 것이 아니라 매칭 순서를 먼저 확인해야 합니다.
  • 전체 프록시는 비교 테스트에 활용하세요. 문제가 라우팅 규칙에서 비롯된 것인지 확인하려면 잠시 프록시 아웃바운드로 전환해 테스트할 수 있습니다. 테스트가 끝나면 원래 모드로 되돌리세요. 일회성 점검 결과를 장기 설정의 근거로 삼지는 마세요.
  • 라우팅과 DNS를 함께 확인하세요. 도메인 해석 결과는 주소 규칙의 매칭에 영향을 줍니다. 일부 사이트에서만 문제가 생긴다면 도메인 규칙, DNS 해석 방식, 실행 로그를 함께 확인해 원인을 좁혀 보세요.
라우팅 규칙 실전 가이드

멀티 플랫폼 설정 및 네트워크 처리

데스크톱과 Android에서 같은 출처의 서버 정보를 쓸 수 있지만, 메뉴 위치와 권한, 네트워크 처리 방식은 다릅니다. 플랫폼을 옮길 때는 프로토콜 매개변수와 라우팅 목적을 확인하세요. 한 플랫폼의 설정 폴더 전체를 다른 플랫폼에 그대로 덮어쓰지 마세요.

  • 먼저 시스템 프록시로 확인하세요. 데스크톱 브라우저는 시스템 프록시부터 테스트하는 것이 좋습니다. 시스템 설정을 따르는 앱에서만 사용할 수 있으므로, 기기의 모든 프로그램이 프록시를 사용한다고 볼 수는 없습니다.
  • 필요할 때만 TUN을 활성화하세요. TUN은 가상 네트워크 인터페이스로 트래픽을 처리하며, 관리자 권한이나 DNS 및 라우팅 충돌이 발생할 수 있습니다. 기본 연결이 정상적으로 작동하는지 확인한 다음 처리 범위를 넓히세요.
  • 기기별 설정은 따로 관리하세요. 로컬 수신 포트, 시작 동작, 배터리 설정은 기기 환경에 따라 달라집니다. 구독을 공유하더라도 각 기기의 옵션을 별도로 확인해 환경 문제를 구독 문제로 오해하지 않도록 하세요.

문제에 맞는 설정 순서 확인

서버 목록이 비어 있다면 먼저 구독 그룹에 주소가 저장되어 있는지 확인한 뒤 해당 그룹을 직접 업데이트하세요. 업데이트에 실패하면 주소 접속 실패와 내용 해석 실패를 구분하세요. 전자는 네트워크, 주소 유효 기간, 접근 권한을 확인하고, 후자는 구독 형식과 클라이언트 지원 범위를 확인합니다. 로그를 캡처해 공유할 때는 전체 구독 주소를 공개하지 마세요. 접근 자격 증명이 포함되어 있을 수 있습니다. 목록이 정상적으로 표시되면 서버 하나를 선택해 실제 연결을 테스트하세요. 구독 업데이트 성공은 설정을 가져왔다는 뜻일 뿐, 모든 서버에 연결할 수 있다는 보장은 아닙니다.

구독 가져오기 단계 보기

v2rayN 주요 설정 위치 예시

현재 서버를 확인한 다음 트래픽이 코어로 들어가는 방식과 아웃바운드를 선택하는 규칙을 살펴보세요.

이 화면은 정적 예시이며 포트는 설명용입니다. 실제 이름과 위치, 포트는 사용 중인 클라이언트 설정을 기준으로 확인하세요.

빠른 시작

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

사용 가능한 구독이 있다면 아래 순서에 따라 처음 설정을 완료할 수 있습니다. 클라이언트에는 서버가 포함되어 있지 않으므로 구독과 서버 매개변수는 직접 준비해야 합니다.

  1. 구독을 가져와 서버 목록 업데이트

    클라이언트를 설치하고 실행한 뒤 구독 관리 화면에서 그룹을 추가하고 구독 주소를 저장한 다음 해당 그룹을 업데이트하세요. 데스크톱과 Android에서는 메뉴 이름이 조금 다를 수 있지만, 핵심은 ‘출처 저장’과 ‘내용 가져오기’ 두 단계입니다. 공유 링크 하나를 사용하는 경우에는 해당 링크에 맞는 가져오기 기능을 선택하세요. 가져온 뒤 서버 이름과 프로토콜 종류, 그룹이 예상한 내용과 일치하는지 확인하세요. 구독 주소를 서버 주소 입력란에 붙여 넣지 마세요.

  2. 서버를 선택하고 트래픽 처리 방식 확인

    목록에서 서버 하나를 현재 연결 대상으로 선택하세요. 데스크톱에서는 가이드에 따라 시스템 프록시를 켜고, Android에서는 연결을 시작할 때 시스템 VPN 권한을 허용하세요. 처음 테스트할 때는 기본 라우팅 설정을 유지하고 여러 프록시 앱을 동시에 켜지 마세요. DNS와 TUN, 라우팅 규칙을 한 번에 모두 변경해서도 안 됩니다. 그래야 문제가 생겼을 때 서버 연결, 앱 프록시 설정, 규칙 매칭 중 어디에서 비롯됐는지 판단할 수 있습니다.

  3. 직접 접속해 로그로 확인

    클라이언트 아이콘 변화만 보지 말고 실제로 접속할 페이지를 열어 정상적으로 로드되는지 확인하세요. 목록의 연결 테스트는 특정 테스트 대상만 확인하므로 모든 사이트의 접속 상태를 보장하지 않습니다. 접속에 실패하면 로컬 네트워크가 정상인지, 올바른 서버를 선택했는지, 시스템 프록시가 적용됐는지 먼저 확인한 뒤 같은 시간대의 실행 로그를 살펴보세요. 한 번에 조건 하나만 바꾸고 다시 테스트하는 편이 여러 설정을 연달아 바꾸는 것보다 효과적입니다.

전체 가이드 보기

오픈소스 생태계

Project V, 코어 및 그래픽 클라이언트

‘V2Ray’는 서로 관련된 여러 도구를 통틀어 가리키는 말로 자주 쓰입니다. 클라이언트를 선택할 때는 이름만 보고 호환성을 판단하지 말고 플랫폼, 코어, 설정 지원 범위를 각각 확인하세요.

Project V

프록시 도구와 모듈형 네트워크 처리의 프로젝트 배경

V2Fly
커뮤니티가 유지 관리하는 V2Ray 코어 계열
Xray
V2Ray와 역사적 연관이 있는 독립 코어 분기
그래픽 클라이언트
구독, 라우팅 및 로컬 실행 설정 관리

각 프로젝트의 역할을 구분하기 위한 그림이며, 프로젝트 간에 통합된 배포 또는 관리 체계가 있다는 의미는 아닙니다.

프로젝트 배경을 통해 코어의 역할 이해하기

Project V를 중심으로 모듈형 프록시 도구 생태계가 형성되었습니다. V2Ray 코어는 연결을 받아 프로토콜을 처리하고 설정에 따라 트래픽을 해당 아웃바운드로 전달합니다. V2Fly는 커뮤니티가 유지 관리하는 V2Ray 계열을 이어가고, Xray는 공통된 역사를 바탕으로 독립적으로 발전했습니다. 두 코어는 개념이 비슷하고 일부 설정 형식도 공유하지만, 지원 기능과 필드의 의미, 업데이트 주기는 완전히 같지 않습니다. 이름이 비슷하다고 설정을 자유롭게 바꿔 쓸 수 있는 것은 아닙니다.

클라이언트 인터페이스와 코어는 서로 다른 계층

v2rayN은 데스크톱용으로 서버 관리, 구독 업데이트, 라우팅 설정 등의 그래픽 기능을 제공하며 선택한 기능에 따라 적절한 코어를 호출합니다. v2rayNG는 Android용이며 주로 Xray를 기반으로 하고, v2flyNG는 V2Fly를 기반으로 합니다. 세 클라이언트는 모두 오픈소스 소프트웨어이며 각 프로젝트에서 코드와 배포를 관리합니다. 오픈소스는 코드 공개 방식을 뜻할 뿐, 구독 출처와 서버 운영 주체, 기기 권한을 직접 확인해야 한다는 점은 달라지지 않습니다.

프로토콜은 전송 및 보안 설정과 함께 확인

VMess, VLESS, Trojan, Shadowsocks는 흔히 사용되는 프로토콜 이름입니다. WebSocket과 gRPC 등은 전송 관련 옵션이며, TLS와 REALITY는 서로 다른 보안 설정에 해당합니다. 프로토콜 이름이 같다는 사실만으로 설정이 정상적으로 작동한다고 판단할 수는 없습니다. 클라이언트가 구독 형식을 인식해야 하고, 사용 중인 코어가 설정에 포함된 기능을 지원해야 합니다. 인증서 이름과 전송 경로 등의 매개변수도 서버 설정과 일치해야 합니다.

오픈소스 라이선스와 업데이트의 실제 의미

클라이언트와 해당 클라이언트가 사용하는 코어에는 서로 다른 오픈소스 라이선스가 적용될 수 있습니다. 코드를 읽거나 수정 또는 배포할 때는 각 프로젝트에 포함된 라이선스 문서를 확인하세요. 생태계 전체에 하나의 라이선스가 적용되는 것처럼 일반화해서는 안 됩니다. 클라이언트 인터페이스, 코어, 구독 업데이트는 각각 다른 작업입니다. 구독을 업데이트해도 서버 설정만 새로 받아올 뿐, 새로 추가된 모든 프로토콜 기능이 자동으로 지원되는 것은 아닙니다.

클라이언트를 업데이트하기 전에 그룹과 라우팅 규칙, 필요한 로컬 설정을 저장하고 실행 환경 및 설정 호환성 안내를 확인하세요. 특정 사이트에서만 문제가 생긴다면 먼저 규칙과 DNS 해석 동작을 살펴보세요. 로그에 설정 필드를 인식할 수 없다는 내용이 명확히 표시되면 코어의 지원 범위를 확인하면 됩니다. 업데이트 자체를 우선하기보다 문제의 계층에 맞춰 대응하는 편이 재현 가능한 결과를 얻기 쉽습니다.

고급 설정 가이드: 구독 관리, DNS 및 TUN 설정

기술 노트

클라이언트 설치 및 코어 선택

아래 세 편의 글에서는 코어 호환성, 첫 설치, 프로젝트 간 관계를 각각 다룹니다. 기본 연결을 설정한 뒤 이어서 읽어 보세요.

전체 글 보기