macOS · Windows · Linux · Android 클라이언트

V2Ray Mac용 클라이언트 다운로드 v2rayN 구독 및 프록시 설정

무료 오픈 소스 클라이언트를 선택하고, 한국어 메뉴 경로를 따라 구독 가져오기와 시스템 프록시, 라우팅을 설정하세요.

구독 그룹 시스템 프록시 라우팅 및 TUN
4개데스크톱 및 모바일 플랫폼
3종GUI 클라이언트
2종코어 계열
GPL-3.0 오픈 소스 라이선스 Xray-core · v2fly-core

메뉴 경로를 확인하고 프록시와 트래픽 분기를 설정하세요

먼저 구독을 가져와 서버를 선택한 뒤, 앱 트래픽이 어디로 들어가 어떤 규칙을 따를지 설정하세요. 아래 화면은 설정 예시이며 기기의 현재 상태를 나타내지 않습니다.

시스템 프록시의 세 가지 상태

트레이 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하면 시스템 프록시 설정을 따르는 브라우저 등의 앱이 로컬 프록시를 사용합니다. ‘시스템 프록시 해제’는 시스템 프록시 설정을 제거하고, ‘시스템 프록시 변경 안 함’은 현재 설정을 유지합니다. 프록시를 끄는 것과는 다릅니다. 앱마다 포트를 입력하는 대신 한곳에서 전환할 수 있지만, 모든 프로그램의 트래픽을 자동으로 처리하지는 않습니다. 브라우저에서 별도의 프록시 확장 프로그램을 사용 중이라면 설정이 충돌하지 않도록 먼저 확인하세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면, 앱이 종료된 로컬 포트에 계속 연결되는 문제를 예방할 수 있습니다.

경로트레이 메뉴 → 시스템 프록시 자동 설정

라우팅 규칙과 글로벌 프록시

트레이 메뉴에서 ‘라우팅’으로 이동한 뒤 프리셋으로 트래픽 처리 방식을 확인하고, 필요에 따라 분할 규칙을 편집하세요. 규칙은 도메인이나 대상 주소와 일치시킬 수 있으며, outboundTag로 해당 아웃바운드를 지정합니다. 규칙은 일반적으로 순서대로 평가되므로 구체적인 조건을 포괄적인 조건보다 앞에 두세요. 글로벌 프리셋은 코어에 들어온 트래픽의 아웃바운드 방식을 정할 뿐, 클라이언트를 거치지 않는 앱까지 자동으로 프록시를 사용하게 하지는 않습니다. 변경 전에 기존 설정을 저장하고, 테스트할 때는 조건을 한 번에 하나씩 바꾸세요. 그래야 라우팅, 도메인 조회, 서버 문제를 구분해 확인할 수 있습니다.

경로트레이 메뉴 → 라우팅

구독 그룹 및 키워드 필터

‘구독 그룹 설정’에서 구독 출처별로 이름과 구독 주소를 입력하고 저장한 다음 구독을 업데이트하세요. 이름은 로컬에서 구분하기 위한 것이며 서버 측 정보에는 영향을 주지 않습니다. 키워드 필터는 서버 목록을 좁혀 보여줄 뿐, 노드의 연결 가능 여부를 확인해 주지는 않습니다. 모든 서버를 한 목록에 섞는 것보다 출처별로 나누면 업데이트 실패, 중복 항목, 요금제 변경을 파악하기 쉽습니다. 구독 주소에 접근 정보가 포함될 수 있으니 공개 화면에 노출하지 마세요. 업데이트 후 목록이 비어 있다면 주소와 필터 조건부터 확인하고, 프록시를 통한 업데이트가 필요한지 살펴보세요.

경로구독 그룹 → 구독 그룹 설정

TUN 모드와 관리자 권한

시스템 프록시를 따르지 않는 앱의 트래픽까지 처리해야 할 때 TUN 모드를 고려하세요. 가상 네트워크 인터페이스로 트래픽을 받아들이므로 라우팅 및 도메인 조회 설정도 필요합니다. 단순히 ‘전역’ 옵션을 대신하는 기능은 아닙니다. 처음 활성화할 때는 시스템 안내에 따라 권한을 부여하고, 플랫폼과 코어, 필요한 권한을 먼저 확인하세요. TUN은 시스템 프록시보다 네트워크에 미치는 영향이 큽니다. 다른 가상 네트워크 어댑터나 원격 접속, 프록시 도구를 함께 실행할 때는 충돌에 특히 유의하세요. 테스트를 마친 뒤에는 설정 상태를 기록해 두세요. 인터넷 연결이 끊기면 먼저 TUN을 끄고 기본 네트워크가 복구되는지 확인하세요.

경로메인 창 → TUN 모드

앱 동작에 맞는 트래픽 연결 방식 선택

먼저 설정을 최소화해 연결을 확인한 다음 트래픽 처리 범위를 넓히세요. 아래 설명을 전환하며 앱이 시스템 프록시를 따르는지 확인하세요.

브라우저로 먼저 확인하기

처음 설정할 때는 시스템 프록시부터 사용하세요. 구독을 가져와 서버를 선택하고 ‘시스템 프록시 자동 설정’을 켠 다음, 시스템 프록시를 따르는 브라우저로 원하는 페이지에 접속합니다. 문제가 발생하면 클라이언트 로그와 로컬 수신 포트를 확인하고, 곧바로 TUN이나 별도 브라우저 프록시 확장 프로그램, 여러 라우팅 규칙을 추가하지 마세요. 브라우저가 정상 작동하면 다른 앱도 같은 시스템 설정을 사용하는지 확인하세요. 이 순서대로 점검하면 서버 연결 문제와 앱의 프록시 연결 문제를 구분할 수 있어 이후 변경도 쉽게 되돌릴 수 있습니다.

시스템 프록시 설정 단계 보기 →

클라이언트 및 설치 파일 선택

데스크톱에서는 v2rayN을, 모바일에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 먼저 프로세서 아키텍처를 확인한 다음 해당 다운로드 페이지로 이동하세요.

macOS

v2rayN으로 구독과 프록시 설정을 관리하세요. Apple 메뉴에서 ‘이 Mac에 관하여’를 열어 확인합니다. ‘칩’이 표시되는 모델은 Apple Silicon용 다운로드를, Intel 프로세서가 표시되는 모델은 Intel용 다운로드를 선택하세요. 외관이나 구매 연도만으로 판단하지 마세요. 다운로드한 뒤 설치 안내에 따라 앱을 ‘응용 프로그램’으로 옮기고, 고정된 위치에서 실행하세요. 그래야 디스크 이미지가 마운트 해제된 뒤 클라이언트를 찾지 못하는 일을 막을 수 있습니다.

처음 실행할 때 시스템에서 차단하면 다운로드 출처와 시스템 호환성을 먼저 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에 표시된 안내를 살펴보세요. 일반적인 브라우저 사용에는 시스템 프록시부터 설정하고, TUN이 필요할 때 관련 권한을 부여하세요. 설치와 권한 부여는 별개의 단계입니다. 설치가 완료되어도 모든 앱의 트래픽이 프록시를 통과하는 것은 아닙니다.

다운로드 페이지로 이동

Windows

v2rayN 데스크톱 버전과 클래식 WPF 버전 중에서 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용해 여러 운영체제의 컴퓨터에서 비슷한 방식으로 사용하려는 경우에 적합합니다. WPF 버전은 기존 Windows 인터페이스를 유지합니다. 두 버전은 요구 사항이 다르므로 각각의 안내를 확인하세요. 한 버전의 메뉴 위치나 실행 의존성을 다른 버전에 그대로 적용하지 마세요.

설치 전에 ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하고 다운로드 페이지의 실행 조건을 살펴보세요. 실행 후에는 먼저 구독을 가져와 서버를 선택한 다음 시스템 프록시를 설정하세요. 클라이언트를 종료한 뒤 브라우저에서 웹페이지가 열리지 않으면 시스템이 여전히 로컬 프록시 포트를 가리키는지 확인하세요. 기존 프록시 설정을 정리하는 대신 재설치하는 것으로는 문제가 해결되지 않을 수 있습니다.

다운로드 페이지로 이동

Android

먼저 Xray 코어를 사용하는 v2rayNG를 확인하세요. 기존 설정이 V2Fly 동작에 의존한다면 v2flyNG와 비교해 볼 수 있습니다. 대부분의 최신 기기에는 arm64 설치 파일이 적합하며, 아키텍처를 확인할 수 없다면 범용 버전 안내를 참조하세요. 설치 파일 아키텍처는 설치와 실행 가능 여부를, 코어 종류는 설정 기능 지원 여부를 결정합니다. 둘을 혼동하지 마세요.

구독을 가져온 뒤 서버를 선택하고 연결을 시작한 다음, 시스템의 VPN 연결 요청을 허용하세요. Android의 연결 방식은 데스크톱 시스템 프록시와 다르므로 Mac의 트레이 메뉴를 그대로 따라 할 필요가 없습니다. 백그라운드로 전환한 뒤 연결이 끊긴다면 클라이언트의 배터리 최적화 및 백그라운드 실행 제한을 확인하세요. 다른 VPN 앱을 실행 중이라면 기존 연결이 대체되었는지도 살펴보세요.

다운로드 페이지로 이동

Linux

v2rayN을 선택하고 배포판의 패키지 형식에 따라 deb 또는 rpm을 고른 뒤 x64와 arm64 중에서 선택하세요. 패키지 형식과 프로세서 아키텍처가 모두 일치해야 하며 파일 확장자만으로 판단해서는 안 됩니다. 데스크톱 환경, 디스플레이 서버, 패키지 의존성도 실행에 영향을 줍니다. 설치 전에 다운로드 페이지와 전체 설치 가이드의 시스템 요구 사항을 확인하세요.

실행 후 먼저 GUI, 구독 업데이트, 일반 프록시 연결이 작동하는지 확인한 다음 데스크톱 환경의 시스템 프록시를 설정하세요. 일부 앱은 데스크톱 프록시 설정을 읽지 않으므로 별도 설정이나 다른 트래픽 연결 방식이 필요할 수 있습니다. TUN을 켜기 전에 필요한 권한과 가상 네트워크 어댑터 조건을 확인하세요. 문제가 생기면 일반 네트워크를 먼저 복구하고 오류 로그를 보관한 뒤 의존성과 라우팅을 하나씩 점검하세요.

다운로드 페이지로 이동

처음 사용하려면 접속 가능한 서버 설정이나 구독 링크도 필요합니다. 클라이언트는 설정을 읽고 코어를 실행하며 조작 인터페이스를 제공합니다. 클라이언트만 설치한다고 접속 가능한 서버가 자동으로 만들어지지는 않습니다. 서버 정보를 준비한 뒤 ‘설치 → 구독 가져오기 → 서버 선택 → 프록시 설정 → 접속 확인’ 순서로 진행하면 문제가 발생한 단계를 쉽게 찾을 수 있습니다.

전체 클라이언트 보기 → 전체 플랫폼 설치 및 설정 가이드 보기 →

오픈 소스 클라이언트와 코어 이해하기

인터페이스, 코어, 서비스 설정을 구분하세요. 이름이 비슷해도 기능 범위가 완전히 같지는 않습니다.

Project V 생태계 V2Fly / Xray 코어 GUI 클라이언트 및 설정

Project V에서 두 코어 계열로

Project V는 V2Ray 생태계를 이해하는 출발점입니다. 일반적인 검색에서 ‘V2Ray’는 프록시 코어를 가리킬 수도 있고, 관련 클라이언트와 설정 방식을 통칭할 수도 있습니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어가며, Xray는 관련 코드를 바탕으로 별도의 코어 계열로 발전했습니다. 두 계열은 일부 기술적 배경을 공유하지만 기능 발전 방향과 설정 지원 범위가 완전히 같지는 않습니다. 가이드를 읽을 때 어떤 코어 계열을 다루는지 먼저 확인하세요. 이름이 같은 필드나 비슷한 메뉴가 있다고 해서 호환이 보장되는 것은 아닙니다.

코어는 프로토콜 처리, 라우팅 판단, 실제 네트워크 연결을 담당합니다. GUI 클라이언트는 구독, 서버 목록, 로그, 스위치를 관리하는 화면을 제공합니다. 서비스 제공업체는 원격 주소와 연결 매개변수를 제공합니다. 각 계층의 역할은 서로 다릅니다. 구독 업데이트가 성공했다는 것은 클라이언트가 설정을 가져와 해석했다는 뜻일 뿐입니다. 서버를 선택했어도 시스템 프록시가 켜졌다는 의미는 아닙니다. 모든 설정을 반복해서 바꾸기보다 각 계층을 따로 확인하세요.

설정 요구 사항에 맞는 코어 선택

VMess, VLESS, Trojan 같은 이름은 연결 프로토콜을 나타내며, REALITY와 XTLS Vision 등의 기능은 구체적인 구현 및 설정 조건과도 관련이 있습니다. 서버 이름만으로 호환 여부를 판단할 수 없고, 설정을 가져왔다고 연결이 반드시 되는 것도 아닙니다. 서비스 측 요구 사항과 클라이언트에서 선택할 수 있는 코어 및 지원 범위를 비교하세요. 이전이 필요하다면 기존 설정을 보관하고 설정 하나만 골라 테스트하세요. 전체 구독 그룹을 옮기기 전에 프로토콜, 전송 방식, 보안 설정, 도메인 조회 동작을 확인하세요.

v2rayN은 데스크톱용 클라이언트로, GUI에서 설정을 관리하고 해당 코어를 실행합니다. v2rayNG는 Android용 Xray 코어 클라이언트이며, v2flyNG는 V2Fly 코어를 사용하는 Android 클라이언트입니다. 세 클라이언트 모두 오픈 소스 프로젝트지만 모든 기능을 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 같은 구독을 여러 기기에서 사용한다면 클라이언트 이름만 비교하지 말고, 각 기기에서 실제 사용하는 코어와 해석 가능한 설정 필드를 확인하세요.

오픈 소스 라이선스와 서비스 조건 구분하기

세 클라이언트는 GPL-3.0 오픈 소스 라이선스로 배포됩니다. 오픈 소스 라이선스는 코드의 사용, 수정, 재배포 조건을 설명하며 원격 프록시 서비스의 이용 약관과는 다릅니다. 서비스 제공업체를 선택하는 기준을 대신하지도 않습니다. 클라이언트를 무료로 사용할 수 있는지와 구독 서비스에 요금이 부과되는지는 별개의 문제입니다. 사용 전에 소프트웨어 라이선스, 서비스 요금제, 적용되는 네트워크 환경을 각각 확인하세요. 클라이언트 다운로드 페이지는 서버 계정을 발급하는 곳이 아닙니다.

오픈 소스라고 해서 현재 기기의 개인정보 보호 범위가 자동으로 정해지는 것은 아닙니다. 구독 링크에는 사용자 식별 정보가 포함될 수 있고, 설정에는 서버 주소와 인증 정보가 저장될 수 있습니다. 로그에도 접속 대상과 오류 세부 정보가 남을 수 있습니다. 문제를 해결할 때는 필요한 부분만 공유하고, 화면을 캡처해 올리기 전 구독 주소와 인증 정보를 가리세요. 출처가 불분명한 설정은 먼저 출처를 확인하고, 연결 문제를 해결하려고 알 수 없는 전체 설정을 함부로 가져오지 마세요.

프로그램 업데이트와 구독 업데이트를 따로 관리하기

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 설정 관리 기능을 바꾸고, 코어 업데이트는 프로토콜 지원이나 네트워크 동작에 영향을 줄 수 있습니다. 구독 업데이트는 서비스 제공업체가 배포한 서버 설정을 다시 가져옵니다. 한 번에 한 계층만 변경하고 되돌릴 수 있는 설정을 보관하면 문제가 소프트웨어 변경, 구독 변경, 현재 네트워크 환경 중 어디에서 비롯됐는지 파악하기 쉽습니다. 다운로드 페이지에서는 현재 이용 가능한 설치 파일을 확인하고, 홈페이지에서는 제품 선택과 설정 순서를 안내합니다.

업그레이드 전에 구독 그룹, 라우팅 선택, 시스템 프록시, TUN 상태를 기록해 두세요. 업그레이드 후에는 기본 연결부터 확인한 다음 사용자 지정 규칙을 복원하세요. 새 환경에서 기존 설정이 다르게 작동한다면 로그와 해당 기능 안내를 먼저 살펴보고 모든 설정을 한꺼번에 덮어쓰지 마세요. 페이지에 나온 메뉴 위치는 조작 순서를 이해하기 위한 예시이며 실제 인터페이스는 클라이언트 버전에 따라 달라질 수 있습니다. 항목을 찾을 수 없다면 전체 설치 가이드에서 해당 플랫폼 안내를 확인하세요.

설정 및 문제 해결 문서 읽기

구독 관리부터 연결 문제까지, 구체적인 상황에 맞는 설정 방법을 찾아보세요.