• 데스크톱 클라이언트 · 한국어 설정 가이드

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

구독 가져오기부터 시작해 시스템 프록시와 라우팅 분할을 설정하세요. 플랫폼에 맞는 무료 오픈 소스 클라이언트를 선택하고 로그로 연결 상태를 확인할 수 있습니다.

  • 구독 그룹
  • Xray · V2Fly 생태계
  • 그래픽 인터페이스 설정
SUBSCRIPTION

구독 주소는 설정의 출처
가져왔다고 연결된 것은 아닙니다

SYSTEM PROXY

시스템 프록시는 앱의 연결 경로를 결정
먼저 앱이 프록시를 따르는지 확인하세요

ROUTING

라우팅 규칙은 연결 경로를 결정
그다음 규칙이 적용되는지 확인하세요

v2rayN 구독 및 프록시 설정

연결 흐름에 따라 설정을 이해하세요. 설정 출처, 앱의 연결 경로, 라우팅 출구 순으로 확인한 뒤 TUN 적용을 검토하면 됩니다.

클라이언트를 연 뒤 여러 설정을 한꺼번에 바꾸지 마세요. 서버 목록에는 사용할 설정이 저장되고, 구독 그룹은 설정을 일괄 업데이트하며, 시스템 프록시는 앱에 로컬 프록시 경로를 알려줍니다. 각 기능의 역할은 다릅니다. 목록에 설정이 있어도 브라우저가 프록시를 사용한다는 뜻은 아니며, 시스템 프록시를 켰다고 선택한 서버에 연결되는 것도 아닙니다. 각 단계를 따로 확인해야 문제가 발생한 지점을 찾기 쉽습니다.

구독 그룹을 저장한 뒤 목록 업데이트

「구독 그룹 설정」을 열고 알아보기 쉬운 별칭을 입력한 다음, 전체 V2Ray 구독 링크를 「선택 주소(URL)」에 붙여넣고 저장하세요. 이후 「현재 구독 업데이트」를 실행합니다. 그룹은 주소와 서버 목록을 연결하므로 다음부터 공유 링크를 하나씩 복사할 필요가 없습니다. 개별 링크를 수동으로 가져오는 것보다 구독을 이용하면 설정 변경을 계속 받아볼 수 있지만, 업데이트 과정에서 그룹 내 항목이 바뀔 수 있습니다. 업데이트 전에 직접 수정한 설정을 따로 보관하고, 완료 후 로그와 그룹 필터를 확인하세요. 구독 링크에 접근 정보가 포함될 수 있으므로 공개 화면에 노출하지 마세요.

구독 그룹 → 구독 그룹 설정 → 현재 구독 업데이트
구독 그룹 설정 · 예시
별칭
일상 사용
선택 주소(URL)
https://example.com/sub
업데이트 사용

예시 주소는 입력란을 설명하기 위한 것으로, 구독 서비스가 아닙니다.

운영체제에 맞는 V2Ray 클라이언트 선택

데스크톱에서는 v2rayN을 사용하고, Android에서는 먼저 v2rayNG를 살펴보세요. V2Fly 코어가 필요하다면 v2flyNG도 고려할 수 있습니다.

다운로드 전에 시스템 정보를 열어 프로세서 아키텍처를 확인하고 설치 패키지 유형을 선택하세요. 이름이 비슷한 클라이언트라도 설치 파일을 서로 바꿔 쓸 수는 없습니다. 같은 클라이언트도 데스크톱과 Android 인터페이스는 다릅니다. 여기의 링크는 플랫폼별 다운로드 페이지로 연결되며 설치 안내와 사용 가능한 옵션을 함께 확인할 수 있습니다. 파일 크기로 적합한 패키지를 판단하지 마세요. 아키텍처, 운영체제, 패키지 형식이 선택 기준입니다.

v2rayN을 선택하세요. 다운로드 페이지에서 차세대 크로스 플랫폼 인터페이스 버전과 클래식 WPF 버전을 구분해 제공합니다. 사용 방식과 시스템 요구 사항에 맞춰 선택하면 되며, 처음 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.

「설정 → 시스템 → 시스템 정보」에서 시스템 유형을 확인하세요. 설치 후에는 클라이언트에 필요한 관련 파일을 함께 보관하세요. 실행 환경 안내가 표시되면 다운로드 페이지의 설명을 따르세요. 처음 연결할 때는 시스템 프록시로 확인하고, TUN은 기본 연결이 정상적으로 작동한 뒤 설정하세요.

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

v2rayN을 선택하고 Apple Silicon과 Intel용 설치 파일을 구분하세요. 「이 Mac에 관하여」를 열어 칩 이름인지 Intel 프로세서인지 확인한 뒤 해당 다운로드 링크로 이동하세요.

처음 실행할 때 시스템 보안 경고가 표시되면 먼저 파일 출처를 확인하고 운영체제 안내에 따라 처리하세요. 프로그램을 실행하려고 시스템 보호 기능 전체를 끄지 마세요. 구독 가져오기 방식은 다른 데스크톱 운영체제와 비슷하지만 네트워크 권한, 시스템 프록시 설정 위치, TUN 권한 부여 방법은 기기에 표시되는 안내를 따르세요.

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

Xray 코어를 사용하는 v2rayNG를 먼저 살펴보세요. V2Fly 코어 설정이 필요하다면 v2flyNG도 고려할 수 있습니다. 최근 출시된 대부분의 기기에서는 보통 arm64를 선택하면 됩니다. 아키텍처를 모르겠다면 범용 패키지 안내를 확인하세요.

설치한 뒤 구독 그룹을 추가하고 설정을 업데이트한 다음 서버를 선택해 연결을 시작하세요. VPN 연결 권한 요청은 기기의 트래픽을 처리하기 위해 필요한 시스템 안내입니다. 백그라운드 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 구독만 반복해서 업데이트하지 마세요.

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

v2rayN을 선택한 뒤 배포판에 맞는 deb 또는 rpm 패키지를 고르세요. 일반적인 x64 외에 arm64 다운로드도 제공됩니다. 프로세서 아키텍처와 패키지 형식을 모두 맞춰야 합니다.

먼저 그래픽 데스크톱 환경과 배포판의 요구 사항을 확인한 다음 시스템의 소프트웨어 설치 도구로 패키지를 설치하세요. 시스템 프록시가 적용되는 범위는 데스크톱 환경에 따라 다를 수 있습니다. 브라우저는 접속되지만 터미널은 연결되지 않는다면 각 프로그램의 프록시 설정을 따로 확인하세요. 클라이언트가 실행되지 않는다고 바로 판단하지 마세요.

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

v2rayN 첫 연결: 세 단계 점검

설정 하나가 안정적으로 작동하도록 한 뒤 라우팅 규칙이나 트래픽 처리 방식을 추가하세요.

클라이언트와 사용할 권한이 있는 구독 주소를 준비하세요. 클라이언트는 설정을 읽어 연결을 만드는 프로그램이며 원격 서버를 자동으로 생성하지 않습니다. 설치 후 목록이 비어 있는 것은 정상입니다. 아래 내용은 v2rayN 데스크톱 화면을 중심으로 설명합니다. Android에서 v2rayNG를 사용할 때는 구독 그룹, 활성 설정, 연결 권한을 각각 휴대폰 화면에서 처리하세요. 메뉴 위치는 화면에 따라 달라질 수 있지만 작업 목적은 같습니다.

  1. 01 / 설정 출처

    구독 추가 후 업데이트 결과 확인

    「구독 그룹 → 구독 그룹 설정」으로 이동해 새 그룹을 만들고 별칭과 전체 주소를 입력한 뒤 저장하세요. 구독 그룹 메뉴로 돌아가 「현재 구독 업데이트」를 실행합니다. 업데이트가 완료되고 목록에 항목이 표시된 것을 확인한 다음 다음 단계로 넘어가세요. 확인 버튼은 주소를 저장할 뿐, 주소가 유효하다는 뜻은 아닙니다.

    목록이 계속 비어 있다면 불필요한 그룹 필터를 해제하고 로그를 확인하세요. 주소 만료, 로그인 페이지 응답, 형식 비호환, 로컬 네트워크 요청 실패 등으로 목록이 비어 보일 수 있습니다. 주소를 복사할 때 줄바꿈이나 공백, 메신저가 추가한 문장 부호가 포함되지 않도록 주의하세요. 구독 주소를 공개 게시판에 올려 도움을 요청하지 마세요. 오류 내용을 설명하고 민감한 정보만 가리면 됩니다.

    구독 가져오기 단계 보기 →
  2. 02 / 앱 연결 경로

    서버를 선택하고 시스템 프록시 설정

    목록에서 사용할 서버를 선택한 뒤 마우스 오른쪽 버튼 메뉴에서 활성 서버로 지정하세요. 이어서 메인 창 하단에서 「시스템 프록시 자동 설정」을 선택하고, 라우팅은 현재 필요한 기존 프리셋을 사용하세요. 첫 연결부터 TUN을 켜고 DNS를 바꾸거나 사용자 규칙을 추가할 필요는 없습니다. 단순한 설정을 유지하면 문제를 더 쉽게 찾을 수 있습니다.

    클라이언트가 계속 실행 중인지 확인한 다음 브라우저를 열어 테스트하세요. 브라우저 확장 프로그램이 프록시를 별도로 제어하면 시스템 설정을 덮어쓸 수 있습니다. 사용자 지정 네트워크 설정을 쓰는 프로그램도 시스템 프록시를 따르지 않을 수 있습니다. 이 경우 클라이언트를 다시 설치하기보다 앱 설정을 먼저 확인하세요. 종료하기 전 시스템 프록시를 지우면 앱이 중단된 클라이언트의 로컬 포트를 계속 가리키는 상황을 줄일 수 있습니다.

    시스템 프록시와 라우팅 구분하기 →
  3. 03 / 연결 확인

    대상에 접속하고 로그로 확인

    같은 대상으로 반복 테스트해 페이지가 끝까지 로드되는지 확인한 뒤 클라이언트 로그를 살펴보세요. 목록에 표시되는 지연 시간은 해당 테스트 조건에서의 결과일 뿐, 실제 다운로드 속도를 뜻하지 않으며 웹페이지 접속을 대신할 수도 없습니다. 첫 화면은 열리지만 리소스가 로드되지 않는다면 관련 도메인의 라우팅과 DNS 조회 결과도 확인해야 합니다.

    연결할 수 없다면 먼저 코어가 정상적으로 시작됐는지 확인한 다음 서버 연결, 도메인 조회, 앱의 연결 경로를 살펴보세요. 한 번에 하나의 조건만 바꾸고 변경 전후 결과를 기록하세요. 서버를 바꾸자 연결이 복구되면 원격 설정이나 회선 문제일 가능성이 높습니다. 모든 서버에서 동시에 실패한다면 로컬 네트워크, 프록시 포트, 다른 네트워크 도구와의 충돌부터 확인하세요.

    연결 확인 방법 보기 →

Project V, V2Fly, Xray 생태계

클라이언트, 코어, 프로토콜을 구분한 다음 설정을 가져올 수 있는지, 실행할 수 있는지 확인하세요.

개념 관계

인터페이스는 설정을 관리하고 코어는 연결을 처리합니다

Project V
V2Ray 생태계의 배경을 이해하는 출발점입니다.
V2Fly / Xray
관련 코어 프로젝트로, 지원 범위와 설정 세부 사항이 각기 발전합니다.
v2rayN / v2rayNG / v2flyNG
설정을 관리하고 코어를 호출하는 그래픽 클라이언트입니다.
VMess / VLESS / Trojan
설정에 사용되는 프록시 프로토콜이며 독립된 데스크톱 소프트웨어가 아닙니다.
핵심 개념부터 읽기 →

생태계 배경과 설치 패키지 이름은 다릅니다

Project V는 V2Ray 관련 기술 생태계를 이해하기 위한 배경입니다. 커뮤니티가 발전하면서 V2Fly는 관련 프로젝트의 유지 관리를 이어 갔고, Xray는 별도로 발전하는 코어 계열을 형성했습니다. 일부 개념을 공유하지만 기능 개발, 프로토콜 확장, 설정 요구 사항은 완전히 같지 않습니다. 「V2Ray 공식 사이트」를 검색할 때도 프로젝트 문서, 클라이언트 안내, 원격 서비스 설정 페이지 중 무엇을 찾는지 먼저 구분하세요.

그래픽 클라이언트는 서버 목록과 구독 관리, 설정 메뉴를 제공하고 코어는 설정에 따라 네트워크 연결을 처리합니다. 따라서 인터페이스가 공유 링크를 인식하더라도 일부 항목을 읽었다는 뜻일 뿐입니다. 실제로 연결하려면 사용 중인 코어가 링크에 포함된 프로토콜, 전송 방식, 보안 매개변수를 지원하는지 확인해야 합니다. 호환성 문제를 문의할 때는 단순히 「V2Ray를 사용한다」고 하기보다 클라이언트와 코어를 각각 밝혀야 정확한 도움을 받기 쉽습니다.

세 가지 클라이언트의 오픈 소스 라이선스와 사용 범위

v2rayN, v2rayNG, v2flyNG는 모두 무료 오픈 소스 클라이언트입니다. v2rayN은 데스크톱용으로 구독 그룹, 시스템 프록시, 라우팅 등을 관리하는 기능을 제공합니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어가 필요한 Android 설정을 위한 대안입니다. 오픈 소스란 프로젝트 라이선스에 따라 소스 코드를 공개한다는 뜻입니다. 사용할 수 있는 서버가 클라이언트에 포함되어 있다는 뜻도, 특정 구독 서비스의 품질을 보장한다는 뜻도 아닙니다.

라이선스는 구성 요소별로 살펴봐야 합니다. v2rayN과 v2rayNG 클라이언트는 GPL 계열 라이선스를 사용하고, V2Fly와 Xray 코어는 MPL 계열 라이선스를 사용합니다. 클라이언트와 코어, 의존 구성 요소는 서로 다른 소프트웨어입니다. 일반 사용자는 오픈 소스 여부를 통해 유지 관리 방식을 파악할 수 있습니다. 수정, 재배포, 통합을 계획한다면 단순히 「오픈 소스」라는 표시만으로 의무를 판단하지 말고 사용하는 구성 요소의 구체적인 라이선스와 고지 사항을 확인하세요.

프로토콜이 같아도 전체 매개변수를 확인하세요

VMess, VLESS, Trojan 같은 이름은 설정의 일부만 나타냅니다. 전송 방식, TLS 설정, 서버 이름, 경로, 기타 보안 매개변수도 연결에 영향을 줍니다. 예를 들어 VLESS 설정을 가져올 때 주소와 포트만 남기고 나머지 항목을 선택 사항처럼 취급하면 안 됩니다. REALITY 같은 기능을 사용할 때는 현재 코어가 이를 지원하는지, 서버 설정과 일치하는지 확인해야 합니다. 설정이 작동하지 않는다면 프로토콜 이름만 보고 클라이언트를 바꾸기보다 항목과 코어 지원 여부를 먼저 대조하세요.

구독 형식도 하나로 정해져 있지 않습니다. 구독 응답에 여러 공유 링크가 들어 있을 수 있고, 인코딩된 링크 묶음이나 네이티브 설정 파일을 제공하는 경우도 있습니다. 그래픽 클라이언트마다 가져올 수 있는 입력 형식이 다르며, 네이티브 JSON 설정과 링크 목록을 서로 그대로 바꿔 쓸 수는 없습니다. 제공처에서 여러 형식을 선택할 수 있다면 클라이언트에 맞는 형식을 고른 뒤 가져오기 로그를 확인하세요. 인증 정보가 포함된 구독을 낯선 온라인 변환 사이트에 입력하지 마세요.

업데이트를 세 가지 작업으로 나누세요

클라이언트, 코어, 구독 업데이트는 서로 다른 문제를 해결합니다. 클라이언트 업데이트는 인터페이스와 설정 관리에 영향을 주고, 코어 업데이트는 연결 처리와 프로토콜 기능에 영향을 주며, 구독 업데이트는 제공처에서 새로운 서버 매개변수를 가져옵니다. 목록이 오래됐다면 먼저 구독을 업데이트하세요. 설정에서 특정 기능을 지원하지 않는다는 안내가 나오면 코어와 클라이언트의 호환성 정보를 확인하세요. 세 작업을 혼동하면 문제의 원인은 그대로인데 새로운 변수만 추가될 수 있습니다.

커뮤니티에서 관리하는 소프트웨어는 기능이 계속 바뀌고 가이드의 화면 구성도 달라질 수 있습니다. 업데이트 전에 필요한 설정과 사용자 규칙을 저장하고 변경 사항을 확인한 뒤 한 번에 한 부분만 업데이트하세요. 업데이트 후에는 원래 정상 작동하던 대상으로 먼저 다시 테스트하고 새 기능을 시도하세요. 이전 화면 캡처는 참고용으로만 활용하고 메뉴 이름, 라우팅 옵션, 권한 안내는 현재 설치된 클라이언트를 기준으로 확인하세요.

기초부터 고급까지 전체 설명서 읽기 →

구독 형식과 연결 문제 해결 팁

구체적인 오류와 설정 차이부터 살펴보고 점검 범위를 정한 뒤 설정을 변경하세요.