클라이언트 다운로드 · 한국어 설정 가이드

V2Ray 리소스 허브 v2rayN 클라이언트

다양한 플랫폼용 클라이언트를 선택하고 구독 가져오기, 라우팅 설정 순서로 구성하세요. 연결에 문제가 생기면 로그를 확인해 원인을 하나씩 점검합니다.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

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

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요. 설치 파일은 운영체제와 프로세서 아키텍처에 맞아야 합니다. 클라이언트는 설정을 관리하며, 실제로 연결하려면 사용 가능한 서버 정보나 구독 주소가 필요합니다.

Windows

v2rayN · 추천Desktop / WPF

처음 설치한다면 Desktop 버전부터 확인하세요. 클래식 인터페이스에 익숙하다면 WPF 버전을 살펴볼 수 있습니다. 두 버전은 인터페이스 프레임워크가 다르므로 시스템 요구 사항과 기존 설정을 고려해 선택하세요. 화면이 달라졌다는 이유만으로 옮길 필요는 없습니다.

다운로드 전에 시스템의 ‘정보’에서 기기 아키텍처를 확인하세요. 처음 실행한 뒤 구독 그룹과 서버 목록을 찾고, 코어가 정상적으로 시작되는지 확인합니다. 실행에 필요한 구성 요소 안내가 표시되면 다운로드 페이지의 설명을 따르고, 서로 다른 버전의 프로그램 파일을 섞어 쓰지 마세요.

이전에 다른 프록시 도구를 설치했다면 시스템 프록시가 현재 어디를 가리키는지 먼저 확인하세요. 기존 클라이언트를 종료한 뒤 새 클라이언트를 테스트하면 포트 충돌과 프록시 설정이 반복해서 덮어써지는 문제를 줄일 수 있습니다.

macOS

v2rayNApple Silicon / Intel

‘이 Mac에 관하여’에 표시된 칩에 맞춰 설치 파일을 선택하세요. Apple Silicon은 arm64, Intel은 x64를 사용합니다. 아키텍처를 확인한 뒤 시스템 안내에 따라 앱을 설치하고 처음 실행하면 됩니다.

시스템 프록시 권한과 TUN에 필요한 권한은 서로 다릅니다. 먼저 일반 시스템 프록시 연결을 설정해 서버가 작동하는지 확인한 다음 가상 네트워크 인터페이스 모드를 고려하세요. 처음 권한을 허용하지 못했다면 재설치를 반복하지 말고 시스템 설정에서 해당 항목을 확인하세요.

앱은 정상적으로 실행되지만 브라우저가 연결되지 않는다면 시스템 프록시 주소와 포트를 먼저 확인하고, 다른 네트워크 도구가 동시에 트래픽을 처리하는지도 살펴보세요. 보안 경고에 대응하는 방법은 블로그의 macOS 설치 및 권한 안내를 참고하세요.

Android

v2rayNG · 추천v2flyNG · 대안

v2rayNG는 Xray 코어를 사용하며, 일반적인 공유 링크나 구독을 가져오는 방식으로 시작하기 좋습니다. v2flyNG는 V2Fly 코어를 사용하는 대안으로, 해당 설정 환경에 적합할 수 있습니다. 연결 기능은 클라이언트 이름이 아니라 필요한 설정을 기준으로 확인하세요.

최근 출시된 일반적인 기기라면 arm64를 선택하면 됩니다. 아키텍처가 확실하지 않다면 기기 정보를 먼저 확인하고 범용 설치 파일이 지원하는 범위도 살펴보세요. 설정을 가져온 뒤 서버를 선택하고 연결을 시작할 때 시스템의 VPN 권한 요청을 허용합니다.

백그라운드에서 연결이 자주 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. Wi-Fi와 모바일 데이터는 DNS와 네트워크 조건이 다를 수 있으므로 각각 테스트해 결과를 기록한 뒤 클라이언트 설정을 조정할지 결정하세요.

Linux

v2rayNdeb / rpm

먼저 배포판의 패키지 형식에 따라 deb 또는 rpm을 선택하고, 기기가 x64인지 arm64인지 확인하세요. 데스크톱 버전은 그래픽 환경에서 설정을 관리하는 용도입니다. 설치 후 데스크톱 환경의 프록시 설정이 클라이언트 설정과 일치하는지 확인해야 합니다.

일부 앱은 시스템 프록시 설정을 따르지만, 별도의 프록시 설정을 사용하는 앱도 있습니다. 따라서 브라우저가 연결된다고 해서 모든 프로그램이 프록시를 사용하는 것은 아닙니다. 프록시를 지원하는 앱 하나로 먼저 확인한 다음 다른 앱의 트래픽 설정을 차례로 점검하세요.

TUN을 사용하려면 권한과 기존 라우팅, DNS 관리 방식도 고려해야 합니다. 여러 네트워크 관리 구성 요소를 동시에 바꾸지 마세요. 기존 설정을 저장하고 한 번에 한 항목씩 조정해야 연결에 영향을 준 단계를 찾기 쉽습니다.

v2rayN 설정 기능

설정을 다섯 단계로 나눠 보세요. 먼저 서버 정보를 준비하고 사용할 코어를 정한 다음, 트래픽 진입 방식과 아웃바운드 규칙을 설정합니다. 아래 예시는 각 설정의 의미를 설명하며 기기의 클라이언트를 변경하지 않습니다.

구독 가져오기 및 업데이트

→

구독은 서버 설정을 일괄 관리할 때 유용하며, 노드를 정기적으로 동기화해야 하는 경우에 적합합니다. 구독 그룹에 주소와 알아보기 쉬운 이름을 추가한 뒤 업데이트하고, 서버 목록에 해당 그룹이 나타나는지 확인하세요. 공유 링크는 클립보드에서 가져올 수 있으므로 두 방법을 혼용하지 마세요. 처음 연결하기 전이라면 프록시 없이 업데이트를 시도해 볼 수 있습니다. 주소가 특정 네트워크에서만 열리는 경우에는 실제 환경에 맞게 설정하세요. 업데이트에 실패하면 오류 메시지와 주소 유효 기간, 시스템 시간을 먼저 확인하세요. 바로 클라이언트를 다시 설치할 필요는 없습니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 공개된 화면에 노출되지 않도록 주의하세요.

구독 그룹 → 구독 주소 추가 → 구독 업데이트

빠른 시작: 가져오기, 연결, 확인

먼저 설정 하나를 안정적으로 연결한 뒤 라우팅과 가상 네트워크 인터페이스 기능을 추가하세요. 각 단계에서 확인할 결과를 남기고 오류가 발생하면 해당 단계에서 원인을 찾으세요. 설치, 구독, 네트워크 문제를 한꺼번에 다루지 않는 것이 좋습니다.

STEP 01

설치 및 설정 가져오기

다운로드 페이지에서 플랫폼과 아키텍처에 맞는 설치 파일을 선택해 설치한 다음 클라이언트를 실행하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요. 인터페이스가 바뀌면 메뉴 이름이 다를 수 있지만 구독 관리, 서버 선택, 연결 시작의 기본 순서는 같습니다.

구독 주소를 받았다면 구독 그룹에 항목을 추가하고 업데이트하세요. 단일 공유 링크를 받았다면 클립보드에서 가져오기를 사용합니다. 가져온 뒤 그룹과 서버 유형이 올바른지 확인하고, 목록이 비어 있거나 파싱 오류가 없는지 살펴본 다음 테스트할 설정 하나를 선택하세요.

클라이언트가 사용 가능한 서버를 자동으로 만들지는 않습니다. 구독은 제공자가 관리하며 주소 만료, 할당량 소진 또는 설정 변경이 연결에 영향을 줄 수 있습니다. 구독은 접속 정보처럼 주의해서 보관하고, 다른 사람에게 문제를 문의할 때는 주소의 민감한 부분을 가리세요.

STEP 02

모드 선택 및 연결 시작

데스크톱에서는 먼저 서버를 선택한 다음 시스템 프록시 자동 설정을 켜서 해당 설정을 지원하는 앱을 클라이언트에 연결하세요. Android에서는 연결을 시작할 때 시스템의 VPN 권한 요청을 허용해야 합니다. 첫 테스트에서는 기본 라우팅 설정을 사용하고 사용자 지정 규칙은 아직 추가하지 마세요.

로그에서 코어 시작 실패, 수신 포트 충돌, 프로토콜 매개변수 오류가 있는지 확인하세요. 시작 버튼의 상태가 바뀌었다는 사실만으로 실제 접속이 확인되는 것은 아닙니다. 다른 프록시 프로그램이 실행 중이라면 한쪽을 잠시 중지해 두 프로그램이 연결 지점을 서로 바꾸지 않도록 하세요.

서버 선택, 시스템 프록시, 라우팅 모드는 서로 다른 설정입니다. 서버를 바꾼 뒤에도 앱이 현재 클라이언트의 수신 포트를 사용하는지 확인하세요. 라우팅을 조정했다면 테스트 요청이 실제로 클라이언트에 들어왔는지도 살펴보세요.

STEP 03

연결 확인 및 결과 기록

브라우저로 안정적인 페이지에 접속한 다음 평소 연결하려는 앱도 테스트하세요. 도메인 조회가 되는지, 연결이 수립되는지, 접속 로그에 해당 요청이 나타나는지 각각 확인합니다. 브라우저는 정상인데 특정 앱만 실패한다면 먼저 해당 앱의 프록시 설정과 네트워크 연결 방식을 살펴보세요.

문제가 생기면 한 번에 한 항목만 바꾸세요. 먼저 사용 가능한 것으로 확인된 설정으로 바꾸거나 네트워크 환경을 변경하고, 코어와 라우팅, DNS를 동시에 바꾸지 마세요. 오류 메시지와 조작 순서, 발생 시간을 기록하면 속도 측정을 반복하는 것보다 원인을 찾는 데 도움이 됩니다.

연결을 확인한 뒤 라우팅 규칙을 추가하거나 TUN을 단계적으로 활성화하세요. 사용을 마칠 때 시스템 프록시가 복원됐는지 확인하고, 클라이언트를 업데이트하기 전에는 설정을 백업하세요. 업데이트 후 같은 대상에 다시 접속해 변화의 원인을 비교할 수 있도록 합니다.

Project V 생태계와 클라이언트 관리

특정 버튼의 위치보다 ‘클라이언트, 코어, 프로토콜’ 세 가지 개념을 이해하는 것이 중요합니다. 각각 설정 관리, 연결 실행, 통신 규약을 담당하며 서로 대체할 수 없습니다.

Project V, V2Fly 및 Xray

Project V는 V2Ray를 중심으로 형성된 오픈소스 프록시 도구 생태계로, 프로토콜 처리와 전송, DNS, 라우팅 기능을 포함합니다. V2Fly는 V2Ray의 커뮤니티 유지보수 흐름을 이어가고, Xray는 관련 기술을 바탕으로 자체 코어와 확장 기능을 발전시켰습니다. 두 프로젝트는 공통된 배경이 있지만 기능과 설정에 차이가 있으므로 이름만 바뀐 것으로 보면 안 됩니다.

클라이언트는 이런 기능을 그래픽 인터페이스로 구성해 구독과 서버 목록, 자주 쓰는 옵션을 쉽게 관리하도록 돕습니다. 실제 연결을 실행하는 것은 코어입니다. 따라서 인터페이스가 공유 링크를 인식하더라도 현재 선택한 코어가 모든 매개변수를 지원한다고 볼 수는 없습니다. 연결에 문제가 있다면 가져오기 결과와 코어 로그를 함께 확인하세요.

프로토콜, 전송 방식, 보안 계층도 구분해서 이해해야 합니다. VMess, VLESS, Trojan, Shadowsocks는 일반적인 설정에 쓰이는 프로토콜 이름입니다. WebSocket과 gRPC 등은 전송 방식을 나타내고, TLS와 REALITY는 연결 보안 메커니즘과 관련이 있습니다. 사용할 수 있는 조합은 프로토콜 이름만이 아니라 서버 설정과 클라이언트 코어가 함께 지원하는지에 따라 달라집니다.

오픈소스 클라이언트 세 가지 비교

v2rayN은 데스크톱 설정 관리용으로 Windows, macOS, Linux에서 사용할 수 있으며 구독 관리, 서버 전환, 프록시 및 라우팅 설정을 한곳에서 다루기 좋습니다. v2rayNG는 Android용으로 Xray 코어를 사용하고, v2flyNG는 같은 Android용이지만 V2Fly 코어를 사용합니다. 세 클라이언트 모두 오픈소스 프로젝트이며, 기기 플랫폼과 필요한 설정의 호환성을 기준으로 선택하세요.

오픈소스 소프트웨어는 해당 라이선스에 따라 코드를 확인하고 사용하거나 유지보수에 참여할 수 있습니다. 클라이언트와 코어, 포함된 종속성은 서로 다른 라이선스를 적용할 수 있으므로 구체적인 이용 조건은 각 프로젝트 배포물에 포함된 라이선스 문서를 확인하세요. 무료 클라이언트와 구독 서비스는 별개입니다. 소프트웨어의 사용 방식이 서버 제공자의 서비스 조건이나 할당량, 유효 기간을 결정하지는 않습니다.

이 사이트는 세 클라이언트를 기준으로 다운로드와 한국어 설정 가이드를 구성하며, 클라이언트 이름을 연결 품질의 지표로 사용하지 않습니다. 실제 사용 환경은 서버 자원과 네트워크, DNS, 라우팅 규칙, 앱 동작의 영향을 받습니다. 설정을 평가할 때는 테스트 조건을 고정하고 로그를 확인해 로컬 설정 문제와 원격 서비스 문제를 구분하세요.

설정 관리

업데이트 전에 백업

클라이언트 업데이트, 코어 업데이트, 구독 업데이트, 규칙 데이터 업데이트는 서로 다른 작업입니다. 앞의 두 작업은 프로그램 동작에 영향을 주고, 구독 업데이트는 서버 정보를 바꾸며, 규칙 데이터 업데이트는 도메인과 주소 분류에 영향을 줍니다. 문제가 발생하면 최근 변경된 항목이 어느 계층인지 먼저 확인하고 모든 설정을 한꺼번에 초기화하지 마세요.

업그레이드 전에 현재 설정과 중요한 옵션을 저장하고 변경 사항을 확인하세요. 업그레이드 후에는 이전에 정상 작동했던 서버와 같은 앱으로 검증한 다음 다른 옵션을 조정합니다. 나중에 되돌릴 수 있도록 설정을 기록해 두면 다시 구성할 때 빠뜨리는 항목을 줄일 수 있습니다.

문제 해결 순서

로그와 구체적인 증상

‘연결할 수 없음’이라는 증상을 더 구체적으로 나눠 보세요. 구독 업데이트 실패인지, 코어가 시작되지 않는지, 도메인 조회가 실패하는지, 연결 후 끊기는지 확인합니다. 먼저 증상을 기록한 다음 해당 단계부터 점검하세요. 시스템 시간 오류와 포트 충돌, 만료된 매개변수도 비슷한 접속 실패를 일으킬 수 있습니다.

로그를 공유하기 전에 구독 주소와 계정 정보, 서버 접속 정보를 삭제하세요. 오류 유형과 필요한 맥락만 남겨도 대개 문제를 설명하기에 충분합니다. 자주 발생하는 증상은 FAQ에서 먼저 확인하고, 기본 개념부터 차례로 익히려면 전체 가이드를 참고하세요.

최신 설정 및 문제 해결 글

문제에 맞는 글을 골라 읽어 보세요. macOS 설치 권한, FakeDNS와 TUN의 조합, 초보자가 자주 묻는 개념을 다룹니다. 각 글은 구체적인 상황을 보완하는 내용이며, 처음 설치한다면 먼저 사용 가이드에 따라 기본 연결을 설정하세요.