구독 가져오기 / 데스크톱 및 Android 설정

V2Ray 구독 설정 가이드:
v2rayN 구독 가져오기 및 클라이언트 다운로드

먼저 구독 그룹을 설정하고, 순서대로 라우팅과 시스템 프록시를 구성하세요.

한국어 설정 안내 Xray · V2Fly 오픈 소스 클라이언트

CLIENT / 클라이언트

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

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 확인하세요. 먼저 운영체제와 프로세서 아키텍처를 확인한 다음 기존 구독을 가져오면 됩니다. 클라이언트를 설치해도 사용할 서버 설정이 자동으로 생성되지는 않습니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 창 구성을 유지합니다. 두 버전 모두 올바른 구독과 실행 환경이 필요하며, 화면의 신구만으로 연결 성능을 판단해서는 안 됩니다.

처음 설치할 때는 기본 설정을 마치고 구독을 가져온 뒤, 구성을 하나 선택해 시스템 프록시를 설정하세요. 다른 프록시 프로그램을 사용 중이라면 해당 프로그램의 프록시 기능을 먼저 종료하고 로컬 수신 포트가 겹치지 않는지 확인한 다음 TUN 모드를 고려하세요. 클라이언트를 바꾸기 전에는 구독 그룹, 라우팅, 로컬 포트를 기록해 두면 기존 설정 문제를 새 설치로 가져오는 일을 막을 수 있습니다.

다운로드 페이지로 이동 →

macOS

v2rayN 설치 파일은 Apple Silicon과 Intel 칩용으로 나뉩니다. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인하고 맞는 아키텍처를 선택하세요. 컴퓨터의 외관이나 구입 시기로 판단하지 마세요.

설치를 마친 뒤 시스템 안내에 따라 앱 실행 권한을 설정하고 구독을 가져오세요. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주며, 터미널 도구는 프록시 주소를 별도로 지정해야 할 수 있습니다. 문제를 확인할 때는 먼저 클라이언트가 로컬 포트를 수신 중인지 확인한 다음 브라우저 설정과 터미널 환경 변수를 구분해 살펴보세요. 처음부터 모든 네트워크 옵션을 바꿀 필요는 없습니다.

다운로드 페이지로 이동 →

Android

v2rayNG는 주로 Xray 코어를 기반으로 하므로 Android에서 우선 고려할 만한 클라이언트입니다. v2flyNG는 V2Fly 코어 기반의 대안입니다. 이름이 비슷한지보다 구독 프로토콜과 코어 기능의 호환성을 확인하는 것이 중요합니다.

최근 출시된 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 알 수 없다면 범용 버전을 확인하세요. 처음 연결할 때는 시스템의 VPN 권한을 허용해야 하며, 일반적으로 한 번에 하나의 앱만 해당 연결을 사용할 수 있습니다. 백그라운드에서 연결이 끊기면 시스템 절전 정책, 앱 백그라운드 권한, 로그를 함께 살펴보세요. 시스템이 백그라운드 프로세스를 종료한 것을 구독 만료로 오해하지 않도록 주의하세요.

다운로드 페이지로 이동 →

Linux

v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64 아키텍처를 구분합니다. 배포판의 패키지 형식과 기기 아키텍처에 맞춰 선택하세요. GUI 클라이언트를 사용하려면 데스크톱 세션과 필요한 실행 환경도 갖춰져 있어야 합니다.

데스크톱 환경의 시스템 프록시를 설정해도 모든 프로세스가 자동으로 프록시를 사용하는 것은 아닙니다. 명령줄 프로그램, 컨테이너, 백그라운드 서비스는 각각 확인해야 합니다. TUN을 켜기 전에는 현재 네트워크 관리 방식과 기존 가상 네트워크 어댑터를 확인하고 원래 설정을 보관하세요. 라우팅 문제가 생기면 먼저 기본 프록시 방식으로 되돌린 뒤 권한, DNS, 라우팅 적용 범위를 차례로 점검하세요.

다운로드 페이지로 이동 →

같은 구독이라도 코어에 따라 모든 설정이 똑같이 적용되는 것은 아닙니다. 가져오기 전에 프로토콜, 전송 방식, 보안 옵션을 대상 클라이언트가 지원하는지 확인하세요. 노드 이름이 표시된다는 사실만으로 호환성이 보장되지는 않습니다.

전체 클라이언트 보기 →

SETTINGS / 설정 모음

v2rayN 주요 설정

‘설정 출처 → 트래픽 경로 → 적용 범위’ 순서로 살펴보세요. 아래 화면은 정적인 예시이며, 옵션 이름과 위치는 클라이언트 업데이트에 따라 달라질 수 있습니다. 예시 화면의 스위치를 눌러도 현재 기기의 네트워크 설정은 바뀌지 않습니다.

먼저 진입 경로를 확인하고, 다음으로 나가는 경로를 점검하세요

가져오기에 성공했다는 것은 클라이언트가 설정을 읽었다는 뜻일 뿐, 대상 서버에 반드시 접속할 수 있다는 의미는 아닙니다. 시스템 프록시를 켜도 모든 프로그램이 프록시를 사용하는 것은 아닙니다. 한 번에 한 종류의 설정만 바꾸세요. 먼저 구독을 업데이트하고 구성을 선택한 뒤 브라우저에서 로컬 프록시를 사용하게 하고, 마지막으로 라우팅과 DNS를 확인하세요. 기본 연결이 정상적으로 작동한 다음 TUN, LAN 공유, 앱별 예외를 차례로 추가하세요.

테스트할 때는 연결 수립, 도메인 조회, 대상 서비스 응답을 구분하세요. 특정 사이트가 열리지 않는 이유는 DNS 결과, 규칙 적용, 대상 서비스 자체에 있을 수 있습니다. 노드 속도 측정 한 번으로 모든 사용 환경을 확인할 수도 없습니다. 여러 설정을 계속 전환하는 것보다 오류가 발생한 시간과 클라이언트 로그를 기록하는 편이 원인을 찾기 쉽습니다.

ECOSYSTEM / 프로젝트와 코어

Project V, V2Fly, Xray

클라이언트, 코어, 프로토콜, 구독은 서로 다른 계층입니다. 각 계층의 역할을 먼저 파악한 다음 현재 기기와 설정에 해당 옵션이 적용되는지 판단하세요.

설정 출처

구독 / 공유 링크

GUI · 가져오기, 그룹, 옵션

v2rayN · v2rayNG · v2flyNG

연결 실행 · 프로토콜, 전송, 라우팅

Xray / V2Fly

구체적인 조합은 클라이언트 구현과 포함된 코어에 따라 다릅니다. 그림은 각 계층의 역할을 나타내며, 모든 클라이언트에서 코어를 자유롭게 전환할 수 있다는 뜻은 아닙니다.

생태계의 출처와 분기

Project V는 V2Ray 기술 생태계를 이해하기 위한 배경입니다. 모듈화 구조를 바탕으로 인바운드, 아웃바운드, 라우팅, 전송을 분리해 처리합니다. 일상적으로 말하는 ‘V2Ray 클라이언트’는 보통 GUI 관리 프로그램을 뜻하며 단일 프로토콜을 가리키는 것은 아닙니다. 한 클라이언트에서 여러 프로토콜 설정을 표시하고 서로 다른 연결 코어를 사용할 수도 있습니다. 따라서 제품 이름이 비슷하다고 내부 기능까지 같다고 볼 수는 없습니다.

V2Fly는 V2Ray 핵심 프로젝트를 이어받아 커뮤니티에서 유지 관리하고 있으며, Xray는 관련 코드 기반에서 발전해 독립적인 기술 분기가 되었습니다. 두 프로젝트는 일부 역사와 설정 개념을 공유하지만 기능 발전 방향은 완전히 같지 않습니다. 안내를 참고할 때는 클라이언트와 코어를 함께 확인하세요. 한 분기의 매개변수를 다른 분기에 그대로 적용하거나, 설정을 인식했다는 이유만으로 모든 항목이 적용되었다고 판단하면 안 됩니다.

그래픽 클라이언트 3종의 특징

v2rayN은 데스크톱 환경에서 구독 그룹, 서버 설정, 라우팅, 로컬 수신 포트를 통합 관리합니다. v2rayNG는 Android용으로 Xray 코어를 중심으로 연결을 구성합니다. v2flyNG는 V2Fly 코어를 선호하는 Android 사용자에게 대안이 될 수 있습니다. 세 클라이언트 모두 오픈 소스 GUI 프로그램이며, 화면에서 설정한 내용은 최종적으로 코어가 실행할 수 있는 구성으로 변환되어야 합니다.

클라이언트를 선택할 때는 운영체제, 구독에 필요한 프로토콜 기능, 주로 사용할 적용 방식, 유지 관리 상태를 차례로 고려하세요. 기기마다 같은 코어를 사용하도록 이름을 맞출 필요는 없습니다. 구독 출처를 명확히 기록하고 되돌릴 수 있는 설정을 유지하는 편이 여러 기기에서 문제를 해결하는 데 도움이 됩니다. 같은 그룹이 컴퓨터에서는 작동하고 휴대폰에서는 작동하지 않는다면 서버 장애라고 단정하기 전에 프로토콜 매개변수와 권한을 비교하세요.

오픈 소스 라이선스와 서비스 범위

v2rayN은 GPL-3.0 오픈 소스 라이선스를 적용합니다. 오픈 소스 라이선스는 소프트웨어의 사용, 수정, 재배포 조건을 정하며 네트워크 서비스 품질을 보장하지는 않습니다. 클라이언트를 무료로 사용할 수 있어도 원격 서버, 구독, 대역폭까지 무료라는 뜻은 아닙니다. 소프트웨어 프로젝트, 설정 제공처, 이 사이트의 문서는 각각 다른 역할을 합니다. 계정 상태나 구독 용량에 문제가 있다면 설정 제공처의 안내를 확인하세요.

오픈 소스 코드는 검토할 수 있지만 실제 실행 결과는 설치 출처, 실행 권한, 코어 설정, 원격 서비스에 따라 달라집니다. 이 사이트에서는 GUI 사용법과 기술 개념을 안내하며 사용할 수 있는 구독이나 서버 계정을 제공하지 않습니다. 예시 화면의 주소는 입력란 형식을 설명하기 위한 것으로 실제 연결 정보가 아닙니다.

업데이트 순서와 호환성

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 화면과 설정 생성 방식에 영향을 주고, 코어 업데이트는 프로토콜 실행 기능을 바꾸며, 구독 업데이트는 제공처에서 설정을 다시 가져옵니다. 가져오기에 실패하면 형식과 주소부터 확인하세요. 연결 매개변수가 지원되지 않으면 코어 기능을 점검하세요. 세 업데이트를 같은 것으로 취급하면 실제 문제를 놓치기 쉽습니다.

업그레이드 전에 현재 작동하는 트래픽 적용 방식, 로컬 포트, 사용자 지정 라우팅을 기록하세요. 클라이언트 기능을 활용해 설정을 백업하고 민감한 항목은 안전하게 보관하세요. 업그레이드 후에는 구성 하나로 먼저 확인한 다음 구독 업데이트와 평소 사용하는 앱을 테스트하세요. 프로토콜 조합에 VLESS, TLS, REALITY가 포함되어 있다면 인증, 전송, 보안 계층의 역할도 각각 확인하세요. 프로토콜 이름만 바꾸고 관련 매개변수를 빠뜨리지 않도록 주의하세요.

NOTES / 설정과 문제 해결

최신 가이드

기본 연결을 확인한 다음 증상에 맞는 설정을 찾아보세요. 각 글에서는 앱의 트래픽 진입 경로, 포트 수신, 가상 네트워크 어댑터 적용을 각각 다룹니다. 서로 다른 계층의 문제를 같은 방법으로 해결하지 않도록 안내합니다.

문제 해결

시스템 프록시를 켰는데 작동하지 않을 때: 브라우저와 터미널 단계별 점검

브라우저에서는 확장 프로그램의 프록시 설정, PAC, 예외 목록을 확인합니다. 터미널에서는 기본적으로 시스템 프록시를 사용하지 않는 이유와 환경 변수로 로컬 HTTP 포트를 지정하는 방법을 설명합니다.

먼저 앱이 로컬 프록시를 사용하는지 확인한 다음 프록시 서버와의 연결을 점검하세요. ‘앱이 프록시를 우회하는 문제’와 ‘프록시 연결 실패’를 구분하면 불필요한 라우팅 변경을 줄일 수 있습니다.

안내 보기 →
문제 해결

V2Ray 로컬 포트 충돌 해결: 충돌 프로세스 찾기 및 SOCKS·HTTP 수신 포트 변경

클라이언트가 시작되지 않거나 포트 사용 중이라는 메시지가 표시되면 시스템 명령으로 해당 포트를 사용하는 프로세스를 찾으세요. 그런 다음 설정에서 비어 있는 포트로 바꾸고, 해당 포트를 사용하는 앱의 설정도 함께 업데이트하세요.

클라이언트마다 수신 방식이 다를 수 있으므로 혼합 포트인지 개별 포트인지 먼저 확인하세요. 클라이언트만 변경하고 앱에 설정된 프록시 주소는 그대로 두면 연결되지 않습니다.

안내 보기 →
고급 설정

v2rayN TUN 모드의 원리: 가상 네트워크 어댑터가 전체 트래픽을 처리하는 방식

TUN 가상 네트워크 어댑터와 시스템 프록시의 차이, 가상 네트워크 어댑터로 트래픽을 처리해야 하는 프로그램을 설명하고, 사용 전 필요한 권한과 설정 순서, 자주 발생하는 충돌도 안내합니다.

트래픽이 코어에 들어오는 방식과 최종 출구를 구분하는 것이 중요합니다. TUN을 켜도 적절한 라우팅과 DNS 설정이 필요하며, 적용 범위가 넓어졌다고 모든 트래픽이 같은 경로로 나가는 것은 아닙니다.

안내 보기 →

문제가 어느 계층에 해당하는지 판단하기 어렵다면 FAQ에서 구독 유효성, 실행 권한, 프록시 모드를 먼저 확인하세요. 그런 다음 해당 주제를 살펴보고 설정을 바꾸기 전후의 증상을 기록해 두세요.