본문으로 건너뛰기
데스크톱 클라이언트 설정 안내서설치부터 라우팅까지

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

v2rayN 다운로드 가이드 보기

칩에 맞는 설치 파일을 선택하고 구독 가져오기, 시스템 프록시, 라우팅을 설정한 다음 DNS와 TUN을 차례로 조정하세요.

PROTOCOLS VMessVLESSTrojanShadowsocks
DESKTOPv2rayN데스크톱 설정 시작하기
ANDROIDv2rayNG / v2flyNG필요한 코어에 맞춰 선택
CORE FAMILYXray · V2Fly지원 프로토콜은 선택한 코어에 따라 다릅니다

클라이언트 다운로드

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

전체 클라이언트 보기 →

데스크톱에서는 v2rayN부터, Android에서는 v2rayNG부터 확인하세요. 운영체제를 먼저 확인한 뒤 프로세서 아키텍처를 살펴보세요. 설치 파일 이름의 arm64와 x64는 컴퓨터 외관만으로 판단할 수 없습니다. 다운로드 페이지에서 플랫폼별 링크를 확인하고, 각 클라이언트 카드에서 버전 정보를 살펴보세요.

Windows

v2rayN · Desktop / WPF

데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 기존의 익숙한 조작 방식을 유지합니다. 기존 설정이 있다면 먼저 백업한 다음 사용 방식에 맞춰 선택하세요. 처음 설치한다면 다운로드 페이지에서 시스템 요구 사항을 확인하고, 두 버전을 동시에 시스템 프록시로 설정하지 마세요.

다운로드 페이지로 이동 Windows 클라이언트→

macOS

v2rayN · Apple Silicon / Intel

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple Silicon이라고 표시되면 arm64, Intel 프로세서라고 표시되면 x64를 선택합니다. 디스크 이미지 파일을 다운로드한 다음 앱을 ‘응용 프로그램’ 폴더로 옮겨 실행하세요. 마운트된 이미지에서 계속 실행하지 않는 것이 좋습니다.

처음 실행할 때 보안 경고가 표시되면 출처와 앱 이름을 확인한 뒤 ‘개인정보 보호 및 보안’에서 관련 안내를 살펴보세요. 먼저 시스템 프록시로 브라우저 접속을 확인하고 구독과 노드 매개변수가 올바른지 확인한 다음, 추가 권한이 필요한 TUN 사용을 검토하세요.

다운로드 페이지로 이동 macOS 클라이언트→

Android

v2rayNG · v2flyNG

대부분의 최신 스마트폰에서는 arm64 패키지를 확인하고, 아키텍처를 모르겠다면 범용 패키지를 살펴보세요. v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용할 대안입니다. 연결 전에 시스템 VPN 권한 안내를 읽고 배터리 절약 설정이 백그라운드 실행에 미치는 영향도 확인하세요.

다운로드 페이지로 이동 Android 클라이언트→

Linux

v2rayN · deb / rpm

배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64를 확인하세요. 데스크톱 환경이 시스템 프록시를 사용하는지에 따라 앱이 처리하는 범위가 달라집니다. 설치 후에도 프록시 설정, 로컬 수신 포트, 앱 자체 네트워크 옵션을 확인해야 합니다.

다운로드 페이지로 이동 Linux 클라이언트→

클라이언트는 로컬 설정을 관리하며 사용할 수 있는 구독을 제공하지 않습니다. 설치 전에 사용 권한이 있는 구독 주소나 전체 노드 매개변수를 준비하고 출처 정보를 안전하게 보관하세요. 구독 링크에는 보통 접속 인증 정보가 포함되므로 공개 댓글이나 스크린샷에 붙여 넣지 마세요.

v2rayN 설정 색인

시스템 프록시, 라우팅 및 구독 관리

‘트래픽이 클라이언트로 들어오는 경로’와 ‘들어온 뒤 이용할 경로’를 구분해서 이해하세요. 시스템 프록시와 TUN은 트래픽을 가져오고, 라우팅 규칙은 출구를 선택하며, DNS는 도메인 조회 결과에 영향을 줍니다. 아래 순서대로 하나씩 확인하면 모든 옵션을 한꺼번에 켜는 것보다 문제를 찾기 쉽습니다.

시스템 프록시: 먼저 브라우저 연결하기

시스템 프록시는 시스템 네트워크 설정을 따르는 앱의 트래픽을 클라이언트의 로컬 포트로 전달합니다. 구독을 가져오고 노드를 선택한 뒤 상태 표시줄에서 ‘시스템 프록시 자동 설정’을 선택하고 브라우저에서 접속을 확인하세요. ‘시스템 프록시 해제’는 시스템 프록시 설정을 되돌리고, ‘시스템 프록시 변경 안 함’은 현재 상태를 그대로 둡니다. 이미 프록시가 꺼져 있다는 뜻은 아닙니다. 앱마다 포트를 직접 입력하는 것보다 시스템 프록시가 데스크톱에서 시작하기 편하지만, 모든 프로그램에 자동으로 적용되지는 않습니다. 특정 앱이 여전히 직접 연결된다면 시스템 프록시를 사용하는 앱인지 확인한 뒤 개별 설정이나 TUN을 검토하세요.

  • 클라이언트 코어가 실행 중이고 로컬 포트가 사용 중이 아닌지 확인하세요.
  • 종료하기 전에 시스템 프록시를 해제해 연결할 수 없는 로컬 주소가 남지 않도록 하세요.
  • 브라우저 프록시 확장 프로그램이 시스템 설정을 덮어쓸 수 있으니, 문제를 확인할 때 충돌하는 확장 프로그램을 먼저 비활성화하세요.

시스템 프록시 · 상태 표시줄 옵션

시스템 프록시 해제
시스템 프록시 자동 설정
시스템 프록시 변경 안 함

클라이언트 업데이트에 따라 화면의 항목 이름이 바뀔 수 있습니다. 이름이 다르면 다른 플랫폼 화면의 버튼 위치를 그대로 따라 하지 말고 ‘시스템 프록시, 라우팅, 구독, 코어’ 기능별로 해당 메뉴를 찾으세요. 화면 예시는 설정 간 관계를 설명하며 설치 후 사용할 수 있는 설정이 자동으로 제공된다는 뜻은 아닙니다.

모든 플랫폼의 설치 및 설정 가이드 보기 →

빠른 시작

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

전체 가이드 보기 →

처음 설정할 때는 가장 간단한 순서로 진행하세요. 구독을 준비하고 노드를 선택한 뒤 시스템 프록시를 켜서 브라우저 접속을 확인합니다. 기본 연결이 작동한 다음 사용자 지정 규칙과 TUN을 추가하세요. 이렇게 하면 재현 가능한 시작 상태를 만들고 이후 설정이 실패했을 때 정상 작동하던 상태로 돌아가기 쉽습니다.

  1. 01 / IMPORT

    구독을 가져오고 목록 업데이트

    ‘구독 그룹’에서 새 그룹을 만들고 알아보기 쉬운 별칭과 전체 구독 주소를 입력하세요. 저장한 뒤 업데이트를 실행합니다. 목록에 설정이 표시되는지 확인하고 노드 하나를 선택해 활성 설정으로 지정하세요. 공유 링크가 있다면 클라이언트의 해당 가져오기 기능을 사용하고 구독 주소 입력란에 잘못 넣지 마세요.

    목록이 비어 있다면 먼저 업데이트 결과를 확인하세요. 주소 만료, 호환되지 않는 응답, 연결 시간 초과는 각각 다른 방식으로 해결해야 합니다. 컴퓨터 시간이 올바른지, 링크를 복사할 때 따옴표나 공백, 메신저의 줄바꿈이 섞이지 않았는지 확인하세요. 출처에 접속할 수 없다면 그룹 전체를 반복해서 삭제하기보다 직접 연결과 프록시 연결 업데이트를 비교해 보세요.

  2. 02 / ROUTE

    시스템 프록시 및 기본 라우팅 설정

    노드를 선택한 뒤 코어가 실행되는지 확인하고 시스템 프록시를 ‘시스템 프록시 자동 설정’으로 지정하세요. 라우팅은 현재 접속 요구에 맞는 기본 설정부터 사용합니다. 규칙이 접속에 영향을 주는지 확실하지 않다면 전역 모드로 잠시 전환해 비교해 볼 수 있습니다. 단, 전역 라우팅을 설정해도 모든 앱의 트래픽이 자동으로 처리되는 것은 아닙니다. 앱 트래픽은 먼저 클라이언트로 들어와야 합니다.

    이 단계에서는 권한, 가상 네트워크 어댑터, 다른 VPN으로 인한 변수를 줄이기 위해 TUN을 꺼 두세요. 브라우저 프록시 확장 프로그램이 있다면 비활성화하거나 시스템 프록시와 같은 주소를 사용하는지 확인하세요. 업무용 네트워크에 전용 프록시가 있다면 나중에 복구할 수 있도록 기존 설정을 기록하세요. Android에서는 시스템 안내에 따라 VPN 연결 권한을 확인합니다.

  3. 03 / VERIFY

    접속 확인 및 사용 가능한 설정 저장

    브라우저에서 확인할 대상에 접속하면서 클라이언트 로그도 살펴보세요. 직접 연결되어야 하는 대상과 프록시를 거쳐야 하는 대상을 각각 테스트해 규칙이 예상대로 적용되는지 확인합니다. 한 번의 연결 테스트나 지연 시간은 해당 테스트 대상의 결과일 뿐입니다. 실제 웹 페이지, 로그인, 앱 기능까지 확인해야 합니다.

    연결되었는데 웹 페이지가 열리지 않는다면 프로그램을 바로 재설치하지 말고 시스템 프록시, 로컬 수신 포트, 라우팅, DNS를 차례로 확인하세요. 특정 앱에서만 실패한다면 앱 자체 프록시 설정도 살펴보세요. 연결을 확인한 뒤 설정을 저장하고 종료하기 전에 시스템 프록시를 해제한 다음 트래픽 처리를 중지하세요. 자세한 설정 및 복구 방법은 빠른 시작 가이드에서 계속 확인할 수 있습니다.

Project V 생태계

클라이언트, 코어, 프로토콜의 역할

Project V는 V2Ray 기술 생태계를 이해하기 위한 출발점입니다. 그래픽 클라이언트는 구독, 노드, 규칙을 조작하기 쉬운 화면으로 정리하고, 코어는 설정을 읽어 연결을 실행합니다. VMess, VLESS, Trojan, Shadowsocks 등의 프로토콜은 서로 다른 통신 방식을 정의합니다. 각 계층의 역할이 다르므로 ‘V2Ray 클라이언트 설치’만으로 특정 프로토콜 기능을 사용할 수 있다고 단정할 수 없습니다. 코어, 전송 방식, 서버 매개변수를 함께 확인해야 합니다.

V2Fly 커뮤니티는 V2Ray 관련 프로젝트를 이어서 관리하고 있으며, Xray는 관련 기술 기반에서 발전해 자체 코어 기능과 설정 체계를 갖추고 있습니다. 기술 용어 일부를 공유하지만 기능 발전 방향이 완전히 같지는 않습니다. 가이드를 읽을 때는 먼저 어떤 코어를 대상으로 하는지 확인하고 현재 클라이언트 화면과 비교하세요. 특히 DNS, 라우팅, 전송 보안 매개변수는 이름이 비슷해도 그대로 복사할 수 없습니다. 알 수 없는 필드나 지원되지 않는 조합은 코어 시작 단계에서 오류를 일으킬 수 있습니다.

v2rayN: 데스크톱 그래픽 인터페이스

v2rayN은 GPL-3.0 라이선스로 배포되는 오픈소스 데스크톱 클라이언트이며 설정 관리와 여러 코어 사용 기능을 제공합니다. 데스크톱에서 사용할 때는 창 상태, 코어 실행 상태, 시스템 프록시 상태를 구분해야 합니다. 주 창이 열려도 코어가 설정을 정상적으로 불러왔다는 뜻은 아닙니다. 노드를 선택했더라도 시스템 프록시가 로컬 수신 포트를 가리킨다는 보장은 없습니다.

컴퓨터를 옮길 때 구독과 라우팅 설정은 보관할 수 있지만 앱 경로, 권한, 플랫폼 네트워크 설정은 다시 확인해야 합니다. 기본 설정부터 실행한 다음 사용자 지정 규칙을 복원하면 모든 설정을 한꺼번에 옮기는 것보다 문제를 찾기 쉽습니다.

v2rayNG: Android 및 Xray

v2rayNG는 GPL-3.0 라이선스로 배포되는 오픈소스 Android 클라이언트이며 Xray 코어를 사용합니다. Android에서는 시스템 VPN 인터페이스로 앱 트래픽을 가져오므로 데스크톱의 시스템 프록시와 사용 방식이 다릅니다. 연결 권한, 백그라운드 제한, 앱별 설정, 다른 VPN의 사용 여부가 실제 연결에 영향을 줄 수 있습니다.

같은 구독이 데스크톱에서는 작동하지만 휴대폰에서는 실패한다면 먼저 휴대폰의 시간, 현재 네트워크, 코어 지원 여부를 확인한 다음 전송 매개변수를 살펴보세요. 클라이언트 이름이 비슷하다는 이유만으로 기기마다 프로토콜 지원과 기본 설정이 완전히 같다고 가정하지 마세요.

v2flyNG: V2Fly 코어 대안

v2flyNG는 GPL-3.0 라이선스로 배포되는 오픈소스 Android 클라이언트이며 V2Fly 코어를 사용하는 설정 대안을 제공합니다. V2Fly 동작을 비교하거나 해당 설정을 사용하는 경우에 적합합니다. 대체 클라이언트를 선택할 때는 프로토콜 호환성과 설정 요구 사항을 기준으로 삼으세요. 여러 클라이언트를 동시에 설치해 연결을 계속 바꾸는 방식은 권장하지 않습니다.

결과를 비교할 때는 같은 네트워크와 매개변수를 사용하고 VPN 연결이 하나만 실행 중인지 확인하세요. 클라이언트마다 구독 형식을 다르게 변환할 수 있습니다. 가져오기에 성공한 뒤에도 노드 세부 정보에 서버가 요구하는 주요 항목이 유지되었는지 확인해야 합니다.

오픈소스 라이선스와 정기 업데이트

오픈소스 라이선스는 코드의 사용, 배포, 수정 조건을 정합니다. 구체적인 적용 범위는 각 프로젝트와 포함된 구성 요소의 라이선스를 확인하세요. 클라이언트, 코어, 포함된 구성 요소는 서로 다른 라이선스를 사용할 수 있습니다. 오픈소스라고 해서 라이선스 조건을 무시해도 되는 것은 아니며, 클라이언트 프로젝트가 제3자 구독 서비스를 제공한다는 뜻도 아닙니다. 이 사이트는 다운로드 및 설정 정보를 정리하며 클라이언트 프로젝트, 구독 제공처, 대상 웹사이트는 각각 다른 역할을 합니다.

업데이트도 계층별로 구분해야 합니다. 클라이언트 업데이트는 인터페이스와 설정 관리 로직을 바꾸고, 코어 업데이트는 프로토콜 지원에 영향을 줄 수 있습니다. 구독 업데이트는 제공처의 노드 정보를 새로 가져오고 라우팅 리소스 업데이트는 규칙 일치 결과를 바꿉니다. 문제가 생기면 변경한 계층을 먼저 기록하고 사용 가능한 백업을 보관한 뒤 필요한 부분만 복원하세요. ‘구독 업데이트’를 클라이언트 업그레이드로 착각하지 말고 노드 하나를 고치려고 모든 구성 요소를 동시에 교체하지 마세요.

여러 플랫폼에서의 사용법은 전체 플랫폼 가이드에서 확인하세요. 다운로드, 설치, 가져오기, 연결 확인 순으로 설정하면 됩니다. 문제를 해결할 때는 오류 유형과 발생 단계를 기록하세요. 공개적으로 도움을 요청하기 전에 구독 주소, 인증 정보, 노드의 개인 매개변수를 제거해 재사용 가능한 접속 정보가 함께 공유되지 않도록 하세요.

설정 및 문제 해결 노트

연결 실패, 웹 접속, 구독 업데이트

모든 글 보기 →

증상에 맞는 글부터 확인하세요. 노드 연결 시간 초과는 연결 매개변수와 로그를, 브라우저에서 웹 페이지가 열리지 않는 문제는 트래픽 유입 경로와 DNS를, 구독 업데이트 실패는 출처와 요청 경로를 중점적으로 살펴보세요. 문제를 세 가지로 나눠 해결하면 잘못된 설정 계층을 반복해서 건드리는 일을 줄일 수 있습니다.

V2Ray 클라이언트 다운로드