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

V2Ray 공식 사이트 · v2rayN
클라이언트 다운로드 및 모든 플랫폼 설정

클라이언트 선택부터 구독 가져오기까지, 단계별로 라우팅 및 프록시를 설정하세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY

구독 가져오기 및 그룹 관리

구독을 이용하면 여러 연결 설정을 하나의 업데이트 경로로 관리할 수 있습니다. v2rayN에서는 구독 그룹에 주소를 입력한 뒤 해당 그룹을 업데이트하고, v2rayNG에서도 구독 그룹 설정으로 같은 작업을 할 수 있습니다. 설정을 하나씩 입력하는 대신 그룹별로 출처를 구분하면 각각 업데이트하고 문제를 확인하기 쉽습니다. 처음 가져온 뒤에는 목록에 설정이 표시되는지 확인하고, 사용할 설정을 선택하세요. 구독 업데이트는 설정 내용을 새로 고치는 작업이며 시스템 프록시를 켜는 것과는 다릅니다. 주소에 접속 정보가 포함될 수 있으므로 화면을 공유하기 전에 전체 링크를 가리고, 구독을 변환할 때는 받는 서비스가 신뢰할 수 있는지 먼저 확인하세요.

가이드 보기 →
구독 그룹구독 그룹 설정
메모개인 구독
주소구독 제공업체가 안내한 전체 주소를 입력하세요
구독 업데이트그룹별 업데이트

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

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 알맞은 설치 패키지를 선택하세요. 다운로드 페이지에서 플랫폼별 링크와 설치 요구사항을 확인할 수 있습니다.

전체 클라이언트 보기 →

Windows

v2rayN 추천

데스크톱 버전 및 클래식 WPF 버전

Windows PC에서는 v2rayN을 사용할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 클래식 데스크톱 인터페이스를 유지합니다. 메뉴 위치와 설정 구성은 버전마다 다를 수 있으므로 가이드를 따라 하기 전에 사용 중인 인터페이스를 확인하세요. 보통 구독 관리, 사용할 설정 선택, 시스템 프록시 설정부터 시작하면 됩니다. 처음부터 모든 매개변수를 바꿀 필요는 없습니다.

다운로드 전에 시스템 설정에서 기기의 아키텍처와 시스템 정보를 확인하고, 다운로드 페이지의 실행 요구사항과 비교하세요. 설치 후에는 기본 수신 설정을 유지하고 기존 설정을 가져와 브라우저 접속을 테스트하세요. TUN을 켤 때 권한 안내가 표시되면 설치 안내에 따라 처리하세요. 시스템 프록시는 작동하지만 특정 앱에서 접속할 수 없다면 구독이 만료됐다고 단정하기 전에 해당 앱이 시스템 프록시를 사용하는지 확인하세요.

macOS

v2rayN

Apple Silicon 및 Intel용 다운로드

Mac에서는 v2rayN으로 구독과 라우팅을 관리할 수 있습니다. 다운로드 전에 ‘이 Mac에 관하여’를 열어 Apple 칩인지 Intel 프로세서인지 확인한 뒤 알맞은 패키지를 선택하세요. 아키텍처는 기기 외관이나 구입 연도가 아니라 하드웨어 정보에 따라 선택해야 호환성 문제를 줄일 수 있습니다.

설치가 끝나면 응용 프로그램 폴더에서 클라이언트를 실행하고 시스템 안내에 따라 필요한 권한을 설정하세요. 보안 경고가 표시되면 파일 출처와 앱 정보를 확인하고, 시스템 보안 기능 전체를 끄는 것은 권장하지 않습니다. 첫 연결은 시스템 프록시부터 시작해 설정이 작동하는지 확인한 뒤 TUN 사용을 고려하세요. 앱을 종료한 후 브라우저가 인터넷에 연결되지 않으면 네트워크 설정의 프록시가 중지된 로컬 수신 포트를 가리키고 있는지 확인하세요.

Android

v2rayNG 추천

v2rayNG · Xray / v2flyNG · V2Fly

Android 기기에서는 v2rayNG를 우선 선택하고, V2Fly 코어 설정이 필요하다면 v2flyNG를 고려하세요. 최근 출시된 주류 스마트폰 대부분은 arm64를 사용합니다. 기기의 아키텍처를 확인하기 어렵다면 다운로드 페이지 안내를 먼저 읽고 범용 설치 패키지가 필요한지 판단하세요. 패키지 아키텍처는 설치와 실행 가능 여부에 영향을 주고, 코어 계열은 프로토콜과 매개변수 호환 범위에 영향을 줍니다.

처음 연결을 시작하면 시스템에서 VPN 연결 권한을 요청할 수 있습니다. 요청한 앱을 확인한 뒤 허용하세요. 연결 후에는 필요한 백그라운드 실행 권한을 유지해 화면을 잠갔을 때 절전 정책이 서비스를 종료하지 않도록 하세요. 시스템 VPN 통로를 사용하는 다른 서비스가 있다면 먼저 충돌을 해결해야 합니다. 설정을 가져오는 데 성공했다고 해서 네트워크 트래픽이 처리되는 것은 아닙니다. 클라이언트 연결 상태와 시스템 안내, 실제 앱의 접속 결과를 함께 확인하세요.

Linux

v2rayN

deb / rpm, 배포판과 아키텍처에 맞게 선택

Linux 데스크톱에서는 v2rayN 그래픽 클라이언트를 사용할 수 있습니다. 설치 패키지는 배포판의 패키지 형식과 기기 아키텍처를 함께 고려해 선택해야 합니다. deb와 rpm은 파일 크기만 보고 고를 수 없고, x64와 arm64도 서로 바꿔 사용할 수 없습니다. 먼저 시스템 정보에서 배포판과 프로세서 정보를 확인한 뒤 다운로드 페이지에서 알맞은 항목을 찾으세요.

설치 후 데스크톱 앱 메뉴에서 실행하고 창이 정상적으로 열리는지 확인한 뒤 구독을 가져오세요. 데스크톱 환경마다 시스템 프록시 지원 방식이 다르고, 일부 앱은 자체 설정에서 프록시를 지정해야 합니다. TUN에는 가상 네트워크 어댑터, 권한, 라우팅 설정이 필요하므로 플랫폼별 안내를 따라 차례대로 확인하세요. 기기에서 다른 네트워크 서비스를 실행 중이라면 수신 포트가 사용 중인지 먼저 확인하고, 문제가 생겼을 때 복구할 수 있도록 기존 네트워크 설정을 보존하세요.

첫 연결을 위한 세 단계

먼저 기본 연결을 확인한 다음 DNS, 트래픽 분기, 앱 적용 범위를 세부 조정하세요.

전체 가이드 보기 →
  1. 구독을 가져와 설정 출처 확인

    전체 구독 주소를 준비한 뒤 클라이언트의 구독 그룹 설정에서 그룹을 추가하세요. 알아보기 쉬운 메모를 입력해 저장하고 업데이트를 실행합니다. 단일 공유 링크를 받은 경우에는 해당 링크를 가져오는 기능을 사용하세요. 구독 주소 입력란에 넣으면 안 됩니다. 업데이트가 끝나면 목록에 설정이 표시되는지 확인하세요. 목록이 비어 있거나 형식 오류 또는 요청 실패가 발생하면 주소가 완전한지, 만료되지 않았는지, 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인하세요.

    구독 주소를 통해 다른 사람이 연결 설정을 읽을 수 있으므로 민감 정보로 취급해야 합니다. 문제를 확인할 때는 필요한 오류 메시지만 공유하고 전체 주소, 계정 정보, 연결 인증 정보는 공개하지 마세요. 형식을 변환하기 전에 클라이언트가 이미 해당 형식을 인식하는지 확인해 불필요하게 다른 서비스에 구독 정보를 전달하지 않도록 하세요. 자세한 절차는 구독 가져오기 가이드를 참고하세요.

  2. 설정을 선택하고 트래픽 처리 방식 지정

    목록에서 사용할 설정을 선택한 다음 적절한 시스템 프록시 또는 연결 모드를 지정하세요. 데스크톱에서는 시스템 설정을 따르는 브라우저가 요청을 보내도록 시스템 프록시 자동 설정부터 사용할 수 있습니다. Android에서는 클라이언트 안내에 따라 연결을 시작하고 시스템 권한을 허용하세요. 이 단계에서는 기존 라우팅 구성을 사용하고 수신 주소, DNS, 복잡한 규칙은 잠시 그대로 두어 동시에 바뀌는 조건을 줄이세요.

    시스템 프록시와 라우팅은 서로 다른 역할을 합니다. 시스템 프록시는 앱이 요청을 클라이언트에 전달하는 방법을 정하고, 라우팅은 요청을 받은 뒤 어떤 아웃바운드로 보낼지 결정합니다. 전역 라우팅을 선택해도 시스템 프록시를 사용하지 않는 앱의 트래픽은 처리되지 않을 수 있습니다. 더 많은 앱에 적용해야 한다면 시스템 프록시 및 TUN 안내를 참고해 항목별로 설정하고 다른 네트워크 도구와 충돌하는지도 확인하세요.

  3. 접속을 확인한 뒤 라우팅 조정

    대상 사이트를 열고, 직접 연결될 것으로 예상되는 사이트와 로컬 네트워크 리소스도 테스트해 프록시 접속, 직접 접속, 로컬 네트워크가 모두 예상대로 작동하는지 확인하세요. 클라이언트가 시작됐다는 것은 서비스가 실행 중이라는 뜻일 뿐입니다. 목록의 테스트 결과만으로 실제 앱의 접속 여부를 판단할 수는 없습니다. 필요한 경우 이번 요청과 관련된 오류 로그를 확인해 DNS 조회 실패, 연결 시간 초과, 인증 오류, 규칙 불일치를 구분하세요.

    기본 연결이 작동한 뒤 라우팅이나 DNS를 한 번에 하나씩 변경하고 매번 다시 확인하세요. 설정을 되돌릴 때는 이전 설정으로 복구하고 모든 옵션을 한꺼번에 초기화하지 마세요. 사용을 마치면 연결을 정상적으로 중지하고 시스템 네트워크 설정이 복구됐는지 확인하세요. 특정 앱만 문제가 있다면 먼저 앱 자체의 프록시 설정을 살펴보세요. 트래픽 분기에 대해서는 라우팅 규칙 시작하기를, 플랫폼 권한 문제는 전체 플랫폼 설치 및 설정 가이드를 참고하세요.

Project V 생태계와 코어 차이

클라이언트와 코어의 역할을 이해하면 제품을 선택하거나 옮길 때 혼란을 줄일 수 있습니다. 그래픽 인터페이스는 구독을 저장하고 설정을 선택하며 옵션과 로그를 관리합니다. 코어는 생성된 설정을 읽어 프로토콜, 전송, 라우팅, 연결을 처리합니다. 인터페이스의 스위치가 실제로 작동하는지는 클라이언트가 매개변수를 생성하는 방식과 코어의 지원 여부에 달려 있습니다. 따라서 앱 이름이나 같은 프로토콜 표기만으로 모든 기능이 동일하다고 판단해서는 안 됩니다.

Project V, V2Fly, Xray의 관계

Project V는 V2Ray를 중심으로 형성된 오픈 소스 프록시 도구 생태계입니다. V2Fly는 관련 코어 구현을 이어받아 발전시켰고, Xray는 이러한 기술적 배경에서 나온 별도의 코어 계열입니다. 일부 개념과 설정 방식은 공유하지만 기능의 발전 방향, 매개변수 지원, 구체적인 동작은 서로 다를 수 있습니다. ‘V2Ray 코어 차이’를 비교할 때는 어떤 코어 구현을 말하는지 분명히 해야 하며, 관련 그래픽 클라이언트를 모두 같은 프로그램으로 취급해서는 안 됩니다.

VMess, VLESS, Trojan은 연결 프로토콜 관련 이름이고 REALITY는 보안 계층과 관련된 기술입니다. 서로 같은 계층에 속하거나 임의로 바꿔 쓸 수 있는 옵션이 아닙니다. 연결에는 전송 방식, 도메인, 포트, 인증 정보 등 다른 매개변수도 포함될 수 있습니다. 클라이언트가 공유 링크를 인식한다는 것은 형식을 해석했다는 뜻일 뿐입니다. 실제 연결 여부는 코어 지원, 서버 설정, 현재 네트워크 조건이 서로 맞는지에 달려 있습니다. 프로토콜 설정을 바꾸기 전에 정확한 매개변수를 확인하세요.

세 가지 오픈 소스 클라이언트의 역할

v2rayN은 데스크톱용으로 구독을 한곳에서 관리하고 설정과 라우팅을 바꾸는 데 적합합니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG도 Android용으로 V2Fly 코어를 연결 기반으로 사용합니다. 세 클라이언트 모두 오픈 소스이며, 구체적인 기능은 각 설치 패키지와 인터페이스 안내를 기준으로 확인해야 합니다. 먼저 기기 플랫폼을 확인하고 다음으로 설정 요구사항을 살펴보세요. 이름이 비슷하다는 이유만으로 여러 앱 사이를 반복해서 옮길 필요는 없습니다.

데스크톱과 모바일은 시스템 트래픽을 처리하는 방식이 다릅니다. 같은 구독을 양쪽에 가져와도 시스템 권한, 백그라운드 실행 정책, DNS 동작은 달라질 수 있습니다. 예를 들어 컴퓨터의 앱은 시스템 프록시를 사용할 수 있지만 Android 기기에서는 보통 클라이언트가 시스템 VPN 연결을 시작해야 합니다. 설정을 옮길 때 정당하게 이용 권한이 있는 구독은 재사용할 수 있지만, 다른 기기에서 라우팅 모드, 권한 승인, 백그라운드 설정까지 자동으로 이어진다고 가정해서는 안 됩니다.

오픈 소스 라이선스와 구성 요소의 범위

소스 코드가 공개되어 있다는 것은 해당 라이선스 조건에 따라 코드를 확인하고 사용하거나 재배포할 수 있다는 뜻이지, 모든 구성 요소에 같은 라이선스가 적용된다는 뜻은 아닙니다. 그래픽 클라이언트, 코어, 패키지에 포함된 구성 요소마다 라이선스가 다를 수 있습니다. 개인적인 사용을 넘어 프로그램 수정, 재패키징, 배포를 계획한다면 적용되는 조건을 각각 확인하고 필요한 저작권 및 라이선스 정보를 보존하세요. 오픈 소스라는 사실만으로 구독 출처, 설정 내용, 시스템 권한의 안전성이 보장되지는 않습니다.

클라이언트 다운로드와 원격 서비스 이용도 별개의 영역입니다. 클라이언트는 로컬에서 관리하고 연결하는 기능을 제공하며 원격 서비스의 가용성, 권한, 접속 조건은 해당 서비스에 따라 달라집니다. 설치가 끝났지만 설정이 없거나 기존 구독을 업데이트할 수 없는 문제는 클라이언트가 무료인지 여부만으로 원인을 판단할 수 없습니다. 이 사이트는 도구 설치와 설정 정보를 다루며, 실제 사용 시에는 거주 지역의 법률과 네트워크 관리 요건, 서비스 약관을 준수해야 합니다.

클라이언트, 코어, 규칙은 각각 업데이트됩니다

커뮤니티의 유지보수에 따라 인터페이스, 호환성, 기능이 달라질 수 있습니다. 클라이언트 업그레이드, 코어 업데이트, 구독 새로고침, 규칙 데이터 업데이트는 서로 다른 작업입니다. 구독 새로고침은 연결 설정을 바꾸고, 규칙 데이터 업데이트는 분류 결과에 영향을 줍니다. 코어 업데이트는 매개변수 지원을 바꿀 수 있으며, 클라이언트 업그레이드는 인터페이스나 설정 생성 방식을 변경할 수 있습니다. 문제가 발생하면 가장 최근에 어떤 항목이 바뀌었는지 먼저 기록한 뒤 이전 설정으로 되돌리거나 다시 가져올지 결정하세요.

업데이트 전에 필요한 설정을 보관하고 백업에 포함된 민감 정보를 안전하게 보호하세요. 업데이트 후에는 시작, 구독 불러오기, 실제 연결, 라우팅 동작을 차례대로 확인해야 합니다. 창이 열리는지만 확인해서는 안 됩니다. 가이드의 메뉴와 현재 인터페이스가 다르면 ‘구독 관리’, ‘시스템 프록시’, ‘라우팅 설정’처럼 기능 이름을 기준으로 해당 메뉴를 찾으세요. 플랫폼별 전체 절차는 설치 및 설정 가이드에서, 세 앱의 사용 범위 비교는 클라이언트 비교에서 확인하세요.

설정 가이드와 문제 해결

기본 연결을 확인한 뒤 구체적인 문제에 맞는 가이드를 읽어 보세요. 한 번에 한 단계씩 조정하고 재현 가능한 테스트 결과를 남기세요.

전체 글 보기 →
고급 설정

v2rayN에서 로컬 네트워크 연결 허용하기: PC 프록시를 휴대폰과 TV에서 공유

로컬 네트워크 연결을 허용한 뒤 PC 주소와 포트를 확인하고 방화벽을 설정해 Android 기기와 TV에서 프록시를 사용하는 방법을 안내합니다. 수신 주소, PC의 로컬 네트워크 주소, 클라이언트 포트를 구분하세요. 스위치만 켜고 기기 쪽 설정을 빠뜨리는 일을 방지할 수 있습니다.

글 읽기 →
라우팅 규칙

GeoIP 및 GeoSite 규칙 파일 업데이트와 라우팅 설정 가이드

geoip.dat 및 geosite.dat의 출처와 업데이트 방법을 소개하고 geosite:cn, geoip:private 등 자주 쓰는 구문을 트래픽 분기 규칙에서 사용하는 방법을 설명합니다. IP 주소 분류와 도메인 분류를 구분한 뒤 규칙 적용 순서를 바탕으로 예상대로 작동하지 않는 이유를 확인하세요.

글 읽기 →
문제 해결

v2rayNG 배터리 소모가 빠를 때: Android 백그라운드 실행 및 절전 설정

v2rayNG의 배터리 소모가 커지는 일반적인 원인을 살펴보고 VPN 모드와 프록시 전용 모드의 배터리 사용량 차이를 비교합니다. 제조사별 시스템에서 백그라운드 실행을 허용하는 방법도 안내합니다. 먼저 백그라운드 활동과 연결이 끊기는 시점을 확인한 다음 실행 유지 설정을 조정해 절전 제한을 한꺼번에 모두 해제하지 않도록 하세요.

글 읽기 →