데스크톱 클라이언트 · 구독 및 라우팅

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

메뉴를 따라 구독을 가져오고, 라우팅을 설정하고, TUN을 설정하세요. 클라이언트 선택부터 시작하면 됩니다.

  • VLESS
  • VMess
  • Trojan
  • Shadowsocks
  • REALITY

클라이언트 선택

운영체제별 다운로드

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG를 우선 살펴보세요. V2Fly 커널이 필요한 경우 v2flyNG를 고려할 수 있습니다.

Windows

데스크톱 권장

v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 Windows용입니다. 다운로드 페이지에서 시스템 요구 사항과 두 버전의 차이를 확인한 뒤 설치 방법을 선택하세요. 인터페이스 프레임워크와 프록시 커널은 서로 다른 역할을 하므로 혼동하지 마세요.

처음 실행한 뒤 구독을 가져오고 서버를 선택한 다음 ‘시스템 프록시 자동 설정’을 적용하세요. 일반적인 브라우저 사용은 여기서 시작할 수 있습니다. 대상 앱이 시스템 프록시를 사용하지 않을 때만 TUN 모드를 검토하세요.

다운로드 Windows 클라이언트

macOS

v2rayN 데스크톱 버전을 선택하세요. 시스템의 ‘이 Mac에 관하여’를 열어 Apple 칩인지 Intel 프로세서인지 확인하고, 해당하는 Apple Silicon 또는 Intel 다운로드 항목을 선택하세요. 설치 패키지 아키텍처는 기기에 맞아야 하며, 외관이나 구입 연도만으로 판단하면 안 됩니다.

구독, 서버, 라우팅의 기본 사용법은 동일하지만 현재 시스템에 표시되는 네트워크 권한 안내에 따라 설정하세요. 데스크톱 인터페이스는 Windows와 다를 수 있으므로 메뉴 위치가 바뀌었다면 같은 이름의 설정 항목을 찾아보세요.

다운로드 macOS 클라이언트

Android

Xray 커널

Android에서는 v2rayNG를 우선 선택하세요. Xray 커널을 사용합니다. v2flyNG는 V2Fly 커널을 사용하며, 해당 커널이 필요한 설정의 대안으로 활용할 수 있습니다. 최신 스마트폰은 대체로 arm64를 선택하면 됩니다. 기기 아키텍처를 확인하기 어렵다면 시스템 정보와 다운로드 페이지의 범용 버전 안내를 먼저 확인하세요.

구독을 가져온 뒤 서버를 선택하고 연결을 시작한 다음, Android 시스템의 VPN 권한을 허용하세요. Android의 트래픽 처리 방식은 데스크톱의 시스템 프록시와 다릅니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 권한을 확인하고, 그다음 클라이언트 설정을 조정할지 판단하세요.

다운로드 Android 클라이언트

Linux

v2rayN 데스크톱 버전을 선택하고 배포판의 패키지 형식에 맞는 deb 또는 rpm 항목을 확인한 뒤 x64와 arm64 아키텍처를 대조하세요. 설치 시에는 시스템의 패키지 관리 방식을 이용해 의존성을 처리하고, 현재 배포판에 맞지 않는 패키지를 섞어 설치하지 마세요.

실행한 뒤 먼저 클라이언트의 로컬 리스닝을 확인하고, 데스크톱 환경이나 앱 자체의 프록시를 설정하세요. 프록시 설정을 읽는 방식은 데스크톱 환경마다 다를 수 있습니다. 가상 네트워크 어댑터로 트래픽을 처리하려면 권한, 라우팅, DNS를 별도로 확인하세요. 다른 운영체제의 설정 절차를 그대로 적용하지 마세요.

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

설정 항목 및 기능

v2rayN 기능 구성도

프로토콜, 커널, 구독, 트래픽 유입 경로를 구분해서 이해하세요. 오른쪽에서 주제를 선택하면 관련 설정과 사용 범위를 확인할 수 있습니다.

설정 입력 → 커널 처리 → 트래픽 경로

VLESS / VMess / Trojan프로토콜 Xray / sing-box커널 구독 그룹 geosite:cn → direct 시스템 프록시 TUN 모드트래픽 처리

서버에서 제공한 설정에 따라 VLESS, VMess, Trojan 또는 Shadowsocks를 선택하세요. 프로토콜 이름만으로 연결 결과를 판단해서는 안 됩니다. 링크를 가져온 뒤 주소, 포트, 인증 정보, 전송 설정을 확인하세요. REALITY를 사용하는 경우 서버 이름과 공개 키 등 관련 항목도 점검해야 합니다. REALITY는 보안 계층과 관련된 기술이지, 독립된 프록시 프로토콜은 아닙니다. v2rayN은 이러한 항목을 그래픽 인터페이스에서 한곳에 관리하지만, 사용할 수 있는 조합은 커널 지원과 서버 설정에 따라 달라집니다. 수정하기 전에 기존 설정을 보관하고, 연결을 확인한 뒤 평소 사용하는 항목을 교체하세요.

계속 읽기: 라우팅 분기 안내서 · TUN 권한 및 문제 해결. 이 구성도는 기능 간 관계를 보여 주며, 고정된 실행 순서를 뜻하지 않습니다.

첫 연결 체크리스트

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

처음 설정할 때는 꼭 필요한 항목만 변경하세요. 기본 프록시 모드에서 설정 하나가 정상 작동하도록 한 뒤 라우팅 예외나 가상 네트워크 어댑터를 통한 트래픽 처리를 추가하세요. 이렇게 하면 문제가 생겼을 때 구독, 서버, 앱 설정, 라우팅 중 어디에서 변화가 발생했는지 파악하기 쉽습니다.

  1. 구독을 가져오고 서버 선택하기

    v2rayN을 실행하고 ‘구독 그룹 설정’을 열어 그룹을 추가한 다음 제공받은 구독 주소를 입력하세요. 저장 후 ‘현재 구독 업데이트(프록시 미사용)’를 실행하고 목록이 갱신될 때까지 기다리세요. 사용할 서버를 선택해 활성 서버로 지정합니다. 서버 공유 링크 하나만 받은 경우에는 ‘클립보드에서 URL 일괄 가져오기’ 등의 메뉴를 사용할 수도 있습니다. 메뉴 이름은 현재 인터페이스를 기준으로 확인하세요.

    구독 주소와 서버 공유 링크는 서로 다릅니다. 구독 주소는 여러 설정을 가져와 계속 업데이트하는 데 사용하고, 공유 링크는 보통 특정 연결의 매개변수를 담고 있습니다. 목록이 비어 있다면 그룹 필터, 주소의 완전성, 업데이트 오류부터 확인하세요. 목록에 항목이 있지만 연결되지 않으면 활성 서버와 로그를 확인하세요. 중복 설정이 생기도록 반복해서 가져오지 마세요.

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

    ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택한 뒤 ‘라우팅’에서 필요한 사전 설정을 고르세요. 시스템 프록시는 해당 설정을 지원하는 앱이 요청을 어느 로컬 경로로 전달할지 결정합니다. 라우팅은 커널에 전달된 요청이 어떤 출구로 나갈지 결정합니다. 두 설정은 서로 다른 계층에 있습니다. 라우팅이 ‘전역’이어도 모든 프로그램이 자동으로 프록시를 사용하는 것은 아닙니다.

    먼저 브라우저로 기본 연결을 확인하세요. 명령줄 도구, 게임, 별도의 네트워크 구성 요소는 자체 프록시 설정을 사용할 수 있으므로 따로 설정하거나 TUN을 검토해야 합니다. 시스템 프록시를 변경하는 클라이언트를 여러 개 동시에 실행하지 마세요. 사용을 마친 뒤에는 ‘시스템 프록시 지우기’를 선택해 클라이언트가 로컬 포트에서 더 이상 대기하지 않는데도 앱이 계속 접속을 시도하는 상황을 방지할 수 있습니다.

  3. 접속 결과 및 오류 로그 확인

    직접 연결되어야 하는 대상과 프록시를 사용해야 하는 대상에 각각 접속해 라우팅 설정대로 작동하는지 확인한 다음, 실제로 사용할 앱을 테스트하세요. 특정 웹페이지가 열린다고 해서 다른 앱, DNS, UDP 트래픽도 같은 경로를 이용한다고 단정할 수는 없습니다. 출구를 확인해야 한다면 대상 서비스에 표시되는 연결 정보와 클라이언트 로그를 함께 살펴보세요.

    오류가 발생하면 ‘커널이 시작됐는가 → 로컬 포트가 대기 중인가 → 앱이 프록시를 사용하는가 → 서버에 연결할 수 있는가 → DNS와 라우팅이 일치하는가’ 순서로 확인하세요. 한 번에 한 항목만 변경하고 변경 전후의 결과를 기록하세요. 문제 해결 자료를 공유하기 전 구독 주소, 인증 정보, 개인 접속 기록을 삭제하고 필요한 오류 유형만 남기세요.

전체 사용법 보기 →

오픈소스 생태계 및 유지 관리

Project V, V2Fly 및 Xray 커널

프로젝트 생태계, 프록시 커널, 그래픽 클라이언트를 구분해서 살펴보세요. 클라이언트 다운로드는 시작일 뿐입니다. 구성 요소 간 관계를 이해하면 선택과 문제 해결 과정에서 잘못 판단할 가능성을 줄일 수 있습니다.

커널과 인터페이스의 역할 이해하기

Project V는 프록시 통신 도구를 중심으로 형성된 오픈소스 생태계이며, V2Ray는 그중 주요 프로젝트입니다. V2Fly는 V2Ray 관련 개발을 이어 왔고, Xray는 관련 코드 기반에서 출발해 독자적인 커널 방향으로 발전했습니다. 기술적 배경을 일부 공유하지만 기능 발전, 설정 항목, 호환 범위가 항상 일치하는 것은 아닙니다. 설정을 선택할 때는 ‘V2Ray’라는 포괄적인 이름만 보지 말고 실제로 실행 중인 커널을 확인하세요.

커널은 연결, 전송, 해석, 라우팅 등의 작업을 담당하고, 그래픽 클라이언트는 서버 관리, 구독 업데이트, 시스템 설정을 조작하기 쉬운 인터페이스로 제공합니다. v2rayN, v2rayNG, v2flyNG는 각각 그래픽 클라이언트이며, 하나의 소프트웨어를 운영체제별로 이름만 바꾼 것이 아닙니다. 데스크톱과 Android의 시스템 기능이 다르므로 권한 안내, 트래픽 유입 경로, 백그라운드 실행 방식도 달라집니다.

프로토콜 이름만으로 전체 설정을 알 수는 없습니다. 연결에는 전송 방식, 보안 계층, 인증 매개변수, 서버 측 설정도 영향을 줍니다. VLESS나 Trojan이라는 이름이 같더라도 모든 커널과 매개변수 조합을 서로 바꿔 사용할 수 있는 것은 아닙니다. 먼저 제공받은 원본 설정을 보관하고 호환되는 커널을 선택한 뒤 로그에서 구체적인 항목을 확인하세요. 이름만 보고 계속 바꾸어 시도하는 것보다 문제 범위를 좁히기 쉽습니다.

클라이언트별 선택 기준

v2rayN: 데스크톱용으로 구독 그룹, 활성 서버, 로컬 리스닝, 라우팅을 한곳에서 관리합니다. Windows에서는 인터페이스 선호도와 시스템 요구 사항에 따라 데스크톱 버전이나 클래식 WPF 버전을 선택할 수 있습니다. macOS와 Linux에서는 해당 데스크톱 다운로드 항목을 확인하세요. 인터페이스 프레임워크를 비교하려면 Avalonia 및 WPF 버전 선택 안내를 읽어보세요. 인터페이스 차이를 프로토콜 지원의 직접적인 차이로 오해하지 마세요.

v2rayNG: Android용 클라이언트로 Xray 커널을 사용하며, Android 설정과 사용법을 익히기 위한 좋은 출발점입니다. 처음 연결할 때 시스템 VPN 권한을 허용해야 하며, 장기간 사용할 경우 시스템의 백그라운드 제한도 고려해야 합니다. 화면을 잠그거나 앱을 전환한 뒤에만 문제가 발생한다면 네트워크와 설정 변경을 확인하기 전에 실행 권한과 배터리 정책부터 점검하세요.

v2flyNG: Android용 클라이언트로 V2Fly 커널을 사용하며, 해당 커널을 요구하는 설정을 위한 대안입니다. v2rayNG와 모든 설정 항목, 가져오기 결과, 프로토콜 지원이 완전히 같다고 가정하지 마세요. 클라이언트를 바꿀 때는 호환성이 명확한 설정 하나를 먼저 가져와 확인한 뒤 자주 사용하는 그룹을 옮기세요. 한 번에 너무 많은 항목을 옮기면 차이를 찾기 어렵습니다.

구성 요소별 오픈소스 라이선스 확인

세 클라이언트는 모두 오픈소스 프로젝트로 관리됩니다. 클라이언트, 프록시 커널, 종속 구성 요소마다 서로 다른 오픈소스 라이선스가 적용될 수 있으므로 사용, 수정, 재배포 전에 해당 구성 요소의 라이선스 원문과 동봉된 안내를 확인하세요. 오픈소스는 코드와 협업 과정을 검토할 수 있다는 뜻이지, 모든 서드파티 구독, 서버, 네트워크 환경의 신뢰성이 같다는 뜻은 아닙니다.

클라이언트를 무료로 사용하는 것과 서버 리소스는 별개입니다. 클라이언트를 설치해도 연결 가능한 서버가 자동으로 제공되거나 유효한 구독이 자동 생성되지는 않습니다. 연결 주소, 인증 매개변수, 서비스 이용 가능 여부는 설정을 제공한 출처에 따라 달라집니다. 설정을 관리할 때 필요한 출처 정보는 보관하되, 전체 구독 주소를 공개 웹페이지, 지원 요청 스크린샷, 공유 문서에 게시하지 마세요.

업데이트를 네 가지로 나눠 확인하기

클라이언트, 커널, 구독, 라우팅 데이터의 변경 사항을 각각 기록하세요. 인터페이스 업데이트는 메뉴 위치를 바꿀 수 있고, 커널 업데이트는 매개변수 호환성에 영향을 줄 수 있습니다. 구독 업데이트는 서버 설정을 교체할 수 있으며, 라우팅 데이터 업데이트는 분류 규칙의 일치 결과를 바꿀 수 있습니다. 한 번에 한 종류만 변경하면 문제가 생겼을 때 이전에 작동하던 상태로 되돌리기 쉽습니다.

업데이트 전에 필요한 설정을 백업하고 사용자 지정 규칙과 로컬 리스닝 설정을 기록하세요. 설정을 복원한 뒤에는 활성 서버, 시스템 프록시, TUN 상태를 다시 확인해야 합니다. 백업에 인증 정보가 포함될 수 있으므로 안전하게 관리하세요. 업데이트 후 문제가 생기면 오류 로그와 설정 차이를 먼저 확인한 뒤 되돌릴지 결정하세요. 모든 구성 요소를 바로 다시 설치할 필요는 없습니다.

간단한 일상 점검 순서를 정해 두세요. 구독 그룹 업데이트 결과를 확인하고, 활성 서버를 점검하고, 자주 사용하는 앱을 테스트한 뒤 직접 연결 대상과 로컬 네트워크 접속을 확인하면 됩니다. 라우팅 예외를 추가할 때는 목적과 적용 범위를 기록하고, 더 이상 사용하지 않는 규칙은 주기적으로 정리하세요. 단계별 학습은 초급부터 고급 설정까지 안내하는 설명서에서 확인할 수 있습니다. 낯선 설정 항목은 변경하기 전에 개념 빠른 참조에서 의미를 확인하세요.

기술 노트

클라이언트 설정 및 문제별 해결

기본 연결을 마친 뒤 구체적인 문제에 맞는 글을 확인하세요. 권한, 백그라운드 실행, 트래픽 처리 설정은 운영체제별 안내를 참조하세요.

모든 글 보기 →