PLATFORM / 01
Windows
v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 기존 조작 방식을 유지합니다. 사용 습관에 따라 고르면 됩니다.
V2Ray 클라이언트 설정 체크리스트
먼저 운영체제에 맞는 클라이언트를 선택한 다음 설정을 항목별로 진행합니다. 가이드에서는 구독 가져오기, 시스템 프록시 및 연결 확인을 다루며, 각 단계마다 확인할 설정 위치와 판단 기준을 제공합니다.
활성화 체크리스트
먼저 클라이언트를 정한 다음 구독, 시스템 프록시 및 연결 상태를 확인하세요. 왼쪽에서 점검 항목을 선택하면 오른쪽에서 작업 범위와 판단 기준을 확인할 수 있습니다.
점검 01
Windows, macOS, Linux 데스크톱에서는 주로 v2rayN을 사용하고, Android에서는 먼저 v2rayNG를 확인합니다. V2Fly 코어가 필요하다면 해당 플랫폼의 대안으로 v2flyNG를 검토하세요. 클라이언트 인터페이스, 코어, 설치 패키지 아키텍처는 서로 다른 문제이므로 순서대로 판단해야 합니다. 먼저 운영체제를 고르고, 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하면 데스크톱 절차를 모바일에 잘못 적용하거나 가져온 뒤 메뉴를 찾지 못하는 일을 줄일 수 있습니다.
다운로드 페이지에서는 네 플랫폼을 나누어 표시하고 데스크톱 버전, 클래식 인터페이스, arm64, 범용 패키지, deb 및 rpm 등의 차이를 안내합니다. 모든 프로토콜을 먼저 이해할 필요 없이 플랫폼을 선택하면 다음 단계로 넘어갈 수 있습니다.
platform=Windows → client=v2rayN
점검 02
구독 링크는 일반 웹 주소가 아니라 클라이언트의 구독 관리 메뉴에서 추가해야 합니다. 붙여넣기 전에 앞뒤가 모두 온전한지 확인하고, 메신저의 줄바꿈이나 불필요한 공백이 들어가지 않았는지 살펴보세요. 저장한 뒤 한 번 수동으로 업데이트하고 그룹이나 노드가 표시되는지 확인합니다. 목록이 비어 있다면 시스템 프록시를 반복해서 전환하기보다 먼저 업데이트 안내를 확인하세요. 구독이 아직 파싱되지 않았다면 프록시를 켜도 노드 정보가 생성되지 않습니다.
QR 코드 가져오기와 클립보드 가져오기의 결과는 같아야 합니다. 그룹이 중복되면 기존 구독을 먼저 정리하고 출처가 분명한 하나만 남기세요. 이후 업데이트와 문제 해결이 훨씬 쉬워집니다.
subscription → save → update manually → select node
점검 03
시스템 프록시는 운영체제의 프록시 설정을 따르는 앱의 트래픽을 클라이언트로 보냅니다. TUN 모드는 더 넓은 범위를 처리하지만 일반적으로 추가 권한이 필요합니다. 둘 다 노드 프로토콜 자체가 아니며, 원인을 찾기 전 두 설정을 동시에 자주 전환해서도 안 됩니다. 처음에는 시스템 프록시로 시작해 브라우저가 정상 작동하는지 확인한 뒤, 앱이 시스템 프록시를 읽는지에 따라 TUN 모드를 검토하세요.
분할 라우팅 규칙은 어떤 요청을 직접 연결하고, 프록시로 보내거나 차단할지 결정합니다. 먼저 클라이언트의 기본 규칙을 사용한 뒤 도메인, 주소 대역 및 앱 요구에 맞춰 규칙을 조금씩 추가하세요. 한 번에 하나의 조건 그룹만 수정하고 즉시 확인해야 규칙끼리 덮어쓰는 일을 피할 수 있습니다.
mode=system-proxy · route=rule-based
점검 04
연결 버튼을 눌렀다는 것은 클라이언트가 설정 실행을 시작했다는 뜻일 뿐, 모든 앱이 이미 프록시를 사용한다는 의미는 아닙니다. 먼저 코어 프로세스가 정상적으로 시작됐는지 확인하고, 로그에서 포트 충돌, 인증서 이름, DNS 해석 또는 설정 필드 오류가 있는지 살펴보세요. 이어 시스템 프록시가 켜져 있는지, 대상 앱이 해당 설정을 따르는지도 확인합니다. 단계별로 점검하면 ‘클라이언트가 시작되지 않음’과 ‘앱이 프록시를 사용하지 않음’을 별개의 문제로 나눌 수 있습니다.
확인이 끝나면 당시 사용한 노드, 모드 및 규칙을 기록하세요. 이후 문제가 생겨도 가장 최근에 변경한 내용만 비교하면 되며, 클라이언트를 재설치하거나 모든 설정을 한꺼번에 초기화할 필요가 없습니다.
core running → log clean → proxy enabled → app test
플랫폼 가이드
플랫폼, 프로세서 아키텍처 및 설치 패키지 유형을 각각 확인하세요. 홈페이지는 플랫폼별 안내만 제공하고, 실제 파일 다운로드는 다운로드 페이지에 모아 두었습니다.
PLATFORM / 01
v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 기존 조작 방식을 유지합니다. 사용 습관에 따라 고르면 됩니다.
PLATFORM / 02
v2rayN을 사용할 때는 먼저 시스템 정보에서 칩 유형을 확인하세요. Apple Silicon과 Intel용 설치 패키지는 기기 외관만으로 판단할 수 없습니다.
PLATFORM / 03
먼저 v2rayNG의 arm64 및 범용 패키지를 확인하세요. V2Fly 코어를 사용하려면 v2flyNG에서 같은 아키텍처의 다운로드 항목을 비교하면 됩니다.
PLATFORM / 04
데스크톱 환경에서는 v2rayN을 사용하세요. Debian과 Ubuntu는 deb, Fedora와 openSUSE 등은 패키지 관리 체계에 맞춰 rpm을 선택합니다.
빠른 시작
처음 설정할 때는 필요한 단계만 진행하세요. 한 항목을 완료할 때마다 결과를 확인하고 여러 스위치를 동시에 변경하지 마세요.
전체 가이드 보기 →구독 관리 메뉴에 전체 링크를 붙여넣고 저장한 뒤 업데이트를 실행하세요. 그룹과 노드 목록이 표시되어야 가져오기가 완료된 것입니다. 형식 오류가 표시되면 원본 링크를 다시 복사하고 공백이나 줄바꿈이 포함되지 않았는지 확인하세요.
먼저 노드 하나를 선택한 다음 코어를 시작하세요. 데스크톱에서는 처음에 시스템 프록시부터 사용하고, Android에서는 연결할 때 시스템 안내에 따라 네트워크 연결 권한을 허용합니다. 불필요한 변수를 줄이기 위해 라우팅 규칙은 당분간 기본값으로 유지하세요.
클라이언트에 포트, DNS, 인증서 이름 또는 설정 필드 오류가 없는지 확인한 뒤 대상 앱을 열어 테스트하세요. 일부 앱에서만 작동하지 않는다면 구독을 바로 바꾸기보다 해당 앱이 시스템 프록시를 읽는지 확인해야 합니다.
코어 및 생태계
클라이언트는 인터페이스와 시스템 연동을 담당하고, 코어는 프로토콜, 전송, 라우팅 및 연결 처리를 담당합니다. 이 두 계층을 구분하면 더 정확하게 선택할 수 있습니다.
Project V는 설정을 기반으로 프록시 연결을 구성하는 기술 생태계를 발전시켰으며, 인바운드, 아웃바운드, 라우팅, DNS, 전송 계층 및 프로토콜 매개변수 등의 개념을 포함합니다. V2Fly는 V2Ray의 커뮤니티 중심 유지보수 흐름을 이어받아 기존 설정 방식과 프로토콜 조합을 폭넓게 유지합니다. Xray는 같은 기술적 맥락에서 일부 프로토콜 및 전송 기능을 확장하고 독립적인 업데이트 주기를 형성했습니다. 공통된 기반이 있지만 지원 범위는 서로 다르므로 이름만으로 우열을 판단할 수 없습니다.
일반 클라이언트 사용자는 먼저 구독의 프로토콜이 클라이언트 코어와 호환되는지 확인해야 합니다. VMess, VLESS, Trojan, Shadowsocks 등의 유형은 코어에 따라 필요한 매개변수가 다를 수 있으며, REALITY 같은 기능도 구체적인 코어와 클라이언트 구현에 좌우됩니다. 구독을 가져올 수 있다는 것은 텍스트를 인식했다는 뜻일 뿐, 현재 코어가 모든 필드를 실행할 수 있다는 의미는 아닙니다. 연결에 실패하면 ‘구독 형식 호환성’과 ‘프로토콜 기능 호환성’을 나누어 확인하세요.
v2rayN은 데스크톱 그래픽 클라이언트로 구독 관리, 시스템 프록시, 라우팅 설정, 로그 확인 및 코어 호출을 담당합니다. v2rayNG는 Android용이며 일반적으로 Xray 코어를 사용하고 시스템 네트워크 인터페이스를 통해 연결합니다. v2flyNG 역시 Android용이지만 V2Fly 코어 호환성이 필요한 설정에 더 적합합니다. 세 클라이언트 모두 오픈 소스 소프트웨어이며, 기능 변화는 각 프로젝트의 유지보수 주기, 플랫폼 권한 및 하위 코어에 함께 영향을 받습니다.
구독은 설정을 배포하는 방식이지 클라이언트나 코어와 같은 개념이 아닙니다. 같은 구독이라도 클라이언트에 따라 표시되는 필드가 조금 다를 수 있는데, 이는 대개 인터페이스 명칭, 기본값 및 코어 지원 범위의 차이 때문입니다. 문제를 해결할 때는 먼저 클라이언트 이름, 코어 유형, 프로토콜 및 프록시 모드를 기록하세요. 단순히 ‘연결이 안 된다’고 말하는 것보다 훨씬 정확하게 원인을 좁힐 수 있습니다.
OPEN SOURCE
공개된 코드를 통해 프로토콜 처리, 설정 변환 및 플랫폼 연동을 검토할 기반을 확보할 수 있습니다. 그래도 자신의 시스템 권한, 설정 출처 및 사용 환경에 따라 선택해야 하며, ‘오픈 소스’라고 해서 모든 설정이 자동으로 올바르다고 볼 수는 없습니다.
UPDATE PATH
그래픽 인터페이스 업데이트가 코어 기능을 동시에 바꾸는 것은 아니며, 코어 업데이트는 프로토콜 매개변수와 기본 동작에 영향을 줄 수 있습니다. 업그레이드 후 차이가 생기면 먼저 클라이언트 안내를 읽고 현재 코어 유형과 설정 필드를 확인하세요.
DOCUMENTATION
설치 문제는 플랫폼 안내를, 가져오기 문제는 구독 형식을, 연결 문제는 로그와 코어를 확인하세요. 앱에서만 작동하지 않는다면 시스템 프록시와 분할 라우팅을 살펴보세요. 계층별로 읽는 편이 반복해서 재설치하는 것보다 원인을 찾기 쉽습니다.
자주 묻는 질문
이 질문들은 주로 다운로드, 가져오기 및 최초 연결 단계에서 발생합니다. 먼저 판단 방법을 확인한 뒤 해당 문서에서 해결하세요.
새로운 크로스 플랫폼 인터페이스를 사용하려면 데스크톱 버전을 선택하고, 기존 Windows 방식이 익숙하다면 클래식 WPF 버전을 확인하세요. 두 버전 모두 먼저 시스템 아키텍처와 실행 환경을 점검해야 합니다.
관련 문답 보기 →먼저 링크가 온전한지 확인하고 구독을 수동으로 업데이트한 뒤 클라이언트 안내를 살펴보세요. 노드 목록이 생성되기 전에는 시스템 프록시를 전환하거나 분할 라우팅 규칙을 수정할 필요가 없습니다.
관련 문답 보기 →처음 설정할 때는 시스템 프록시로 기본 연결을 확인하세요. 대상 앱이 시스템 프록시를 읽지 않고 노드와 코어가 정상임을 확인한 경우에만 TUN 모드를 검토합니다.
사용 방법 보기 →코어 프로세스, 클라이언트 로그, 시스템 프록시, 대상 앱의 네 계층을 순서대로 확인하세요. 한 번에 하나의 조건만 바꾸고, 마지막으로 정상 작동했던 설정을 기록해 두세요.
문제 해결로 이동 →사용 팁
인증서 오류, Android 백그라운드 연결 및 데스크톱 클라이언트 시작 문제를 중심으로 실행 가능한 점검 순서를 안내합니다.
먼저 시스템 시간 오차를 확인하고, SNI와 serverName이 인증서와 일치하는지 점검한 뒤 관련 포트와 보안 옵션을 확인하세요.
전체 글 읽기 →최초 연결 권한, 백그라운드 실행 제한 및 앱별 프록시 설정의 관계를 정리해 화면 잠금이나 앱 전환 후 예기치 않은 연결 끊김을 줄입니다.
전체 글 읽기 →발생 빈도가 높은 순서에 따라 데스크톱 실행 환경, 디렉터리 쓰기 권한 및 로컬 포트 충돌을 확인하고, 원인을 모른 채 반복해서 덮어 설치하지 마세요.
전체 글 읽기 →