V2Ray 클라이언트 가이드 / 클라이언트 및 설정
멀티플랫폼 클라이언트부터 구독 가져오기와 라우팅 규칙까지, GUI에서 설정한 다음 프록시가 제대로 작동하는지 확인하세요.
다운로드 안내 / 먼저 운영체제, 다음은 아키텍처
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보고 V2Fly 코어가 필요하면 v2flyNG를 확인하세요. 클라이언트 다운로드는 시작일 뿐입니다. 실제로 연결하려면 사용할 수 있는 서버 설정이 필요하며, 클라이언트를 설치해도 노드나 구독이 자동으로 생성되지는 않습니다. 먼저 기기 종류를 확인한 뒤 다운로드 페이지의 안내에 따라 파일을 선택하면 아키텍처 불일치나 중복 설치를 줄일 수 있습니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 GUI로, 일관된 방식으로 설정을 관리하기 좋습니다. WPF 버전은 익숙한 기존 화면과 메뉴 구성을 유지하고 있어 기존 조작 방식에 익숙한 사용자에게 적합합니다. 두 버전 모두 화면 모양만 보고 프로토콜 지원을 판단하지 말고, 실제 설정과 선택한 코어를 기준으로 확인하세요.
다운로드 전에 시스템 정보에서 프로세서와 시스템 종류를 확인하세요. 처음 실행한 뒤 로컬 수신 포트를 확인하고, 작동이 확인된 설정 하나를 가져온 다음 시스템 프록시를 설정하세요. 여러 클라이언트의 시스템 프록시 제어를 동시에 켜지 마세요. 수신 포트 설정이 서로 덮어써질 수 있습니다.
다운로드 페이지로 이동 →v2rayN 설치 파일은 Apple Silicon과 Intel 칩에 따라 구분됩니다. ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 알맞은 아키텍처를 선택하세요. 클라이언트 이름이 같아도 설치 파일을 서로 바꿔 쓸 수 있는 것은 아닙니다. 아키텍처를 맞게 선택하면 불필요한 호환성 계층으로 인한 부담도 피할 수 있습니다.
처음 실행할 때는 시스템 안내에 따라 필요한 권한을 허용하세요. 설정을 가져온 뒤 시스템 프록시를 사용해 브라우저 연결을 먼저 확인하고, 앱이 시스템 프록시를 사용하는지에 따라 다른 연결 방식이 필요한지 판단하세요. 접속에 문제가 있으면 모든 연결 매개변수를 바꾸기보다 로컬 포트와 프록시 설정부터 확인하세요.
다운로드 페이지로 이동 →Xray 코어를 사용하는 v2rayNG를 먼저 확인하세요. V2Fly 코어 설정이 필요하면 v2flyNG를 대안으로 사용할 수 있습니다. 대부분의 기기는 arm64를 선택하면 됩니다. 아키텍처를 확인하기 어렵다면 범용 버전 안내를 살펴보세요. 두 클라이언트의 이름은 비슷하지만 코어 기능과 인식 가능한 연결 매개변수는 각각 확인해야 합니다.
처음 연결할 때는 시스템 VPN 권한을 확인해야 합니다. 시스템 제한으로 VPN 연결을 동시에 여러 개 사용할 수 없습니다. 백그라운드 연결 유지 여부는 배터리 최적화, 절전 설정, 네트워크 전환의 영향도 받습니다. 먼저 앱을 화면에 띄운 상태에서 연결을 확인한 뒤 백그라운드 설정을 살펴보세요. 프로토콜 항목을 반복해서 바꾸는 것보다 문제 원인을 찾기 쉽습니다.
다운로드 페이지로 이동 →v2rayN은 데스크톱 GUI를 제공하며, 다운로드 페이지에는 주로 deb·rpm 형식과 해당 arm64 파일이 안내되어 있습니다. Debian·Ubuntu 계열과 Fedora 계열은 패키지 관리 방식이 다릅니다. 배포판과 프로세서 아키텍처를 먼저 확인해 설치 패키지 형식과 프로토콜 종류를 혼동하지 않도록 하세요.
데스크톱 환경의 시스템 프록시 설정을 모든 앱이 사용하는 것은 아닙니다. 브라우저는 연결되는데 다른 앱은 연결되지 않는다면 해당 앱의 프록시 옵션부터 확인하세요. 클라이언트가 정상적으로 연결되는지 확인한 다음 로그인 시 자동 실행을 설정하세요. 그래야 잘못된 설정이 매번 로그인할 때마다 적용되는 일을 막을 수 있습니다.
다운로드 페이지로 이동 →설정 한눈에 보기 / 네 가지 문제를 나눠서 확인
연결 설정은 서버 정보를 담고, 프록시 모드는 앱이 연결되는 방식을 정하며, 라우팅 규칙은 트래픽이 향하는 곳을 결정합니다. 각 단계를 나눠 점검하면 ‘실행 중’이라는 표시만 보고 ‘정상 작동 중’이라고 오해하지 않을 수 있습니다. 아래 설정 예시는 GUI의 개념을 설명하기 위한 것으로, 실제 연결에 바로 사용할 수 있는 서버 설정이 아닙니다.
설정 가져오기 / 가져오는 방법
공유 링크는 보통 서버 설정 하나를 담고, 구독 주소는 설정 목록을 가져오거나 업데이트하는 데 사용합니다. 링크를 받으면 먼저 용도를 확인하세요. 단일 링크는 클립보드나 QR 코드로 가져오고, 구독 주소는 구독 그룹에 추가하면 됩니다. 가져오기에 성공했다는 것은 클라이언트가 내용을 인식했다는 뜻일 뿐, 서버가 작동한다는 의미는 아닙니다. 구독을 업데이트하기 전에 수동 설정을 보관하고, 업데이트 후에는 노드 이름과 프로토콜, 전송 매개변수를 확인하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 전체 주소나 주소가 보이는 스크린샷을 공개하지 마세요. 도움을 요청할 때는 민감한 정보를 가린 항목만 공유하세요.
구독 가져오기 단계 보기 →연결 방식 / 설정 예시
시스템 프록시는 로컬 프록시 주소를 운영체제 설정에 등록하지만, 실제로 그 주소를 사용할지는 앱에 따라 다릅니다. Tun 모드는 가상 네트워크 인터페이스로 트래픽을 전달하며, 보통 추가 권한과 라우팅·DNS 설정이 필요합니다. 처음 설정할 때는 시스템 프록시로 브라우저 연결을 확인한 다음 Tun이 필요한지 판단하세요. 두 방식은 프로토콜이 아니며 서버 설정을 대신할 수도 없습니다. 사용 설정 후 문제가 생기면 추가 연결 방식을 먼저 끄고, 명확한 테스트 경로 하나만 남긴 뒤 권한과 포트, 다른 네트워크 도구와의 충돌을 하나씩 확인하세요.
프록시 모드 안내 보기 →트래픽 경로 / 규칙 개념
라우팅 규칙은 조건에 맞는 도메인, 주소 또는 연결을 지정한 아웃바운드로 보냅니다. 규칙은 보통 순서대로 적용되므로, 구체적인 규칙을 이를 덮어쓸 수 있는 포괄적인 규칙보다 앞에 배치해야 합니다. 일반적인 사용에서는 클라이언트에 내장된 설정으로 시작하고, 필요한 경우에만 예외를 추가하세요. 변경 전 현재 설정을 기록하고, 변경 후 프록시 연결 대상과 직접 연결 대상을 각각 확인하세요. 전역 프록시도 라우팅 선택일 뿐, 클라이언트로 들어오지 않는 앱의 트래픽까지 자동으로 처리하지는 않습니다. DNS 조회 위치와 결과도 규칙 적용에 영향을 줄 수 있으니 로그를 함께 확인하세요.
프로토콜과 라우팅의 역할 알아보기 →연결 확인 순서 / 단계별 점검
포트 연결 테스트에 성공해도 대상 포트에 연결할 수 있다는 뜻일 뿐, 프로토콜 핸드셰이크와 인증, 대상 서버 접속까지 모두 성공했다는 의미는 아닙니다. 노드를 선택한 뒤 클라이언트의 실제 연결 테스트를 실행하고, 시스템 프록시가 현재 수신 포트를 가리키는지 확인한 다음 브라우저로 접속해 로그를 살펴보세요. 트레이 아이콘이나 한 가지 테스트 결과만으로 판단하지 마세요. 테스트에 실패하면 연결 시간 초과, 인증 오류, 도메인 이름 확인 오류를 먼저 구분하세요. 한 번에 한 종류의 매개변수만 바꾸고 같은 대상을 다시 테스트해야 변경으로 문제가 해결됐는지 알 수 있습니다.
연결 문제 해결 방법 보기 →VMess, VLESS, Trojan, Shadowsocks는 각각 설계상의 특징과 선택이 다릅니다. 실제 사용 경험은 전송 방식과 보안 계층, 서버 부하, 네트워크 경로에도 영향을 받습니다. 먼저 설정 호환성을 확인한 뒤 동일한 환경에서 실제 접속을 비교하세요. 프로토콜 이름만으로 성능을 단정해서는 안 됩니다.
프로토콜 선택 가이드 읽기 →클라이언트와 코어, 라우팅 데이터는 각각 따로 업데이트될 수 있습니다. 업그레이드 전에 현재 작동하는 설정을 보관하고 사용 중인 코어와 연결 방식을 기록하세요. 업그레이드 후에는 기존 연결부터 확인한 다음 새 기능을 사용하세요. 여러 항목을 한 번에 바꾸면 호환성 문제의 원인을 찾기 어렵습니다.
코어 및 클라이언트 용어 살펴보기 →오픈소스 생태계 / GUI와 코어의 역할 구분
V2Ray는 Project V 생태계의 프록시 도구 프로젝트입니다. 생태계를 이해하려면 먼저 세 가지 역할을 구분해야 합니다. 클라이언트는 사용자가 조작하는 화면을 제공하고, 코어는 연결과 라우팅을 처리하며, 프로토콜은 통신 방식을 정합니다. 다운로드하는 것은 GUI 클라이언트이고, 선택하는 것은 서버 설정이며, 실제 연결을 처리하는 것은 클라이언트가 호출하는 코어입니다. 이 세 가지 이름은 서로 다를 수 있으며 서로를 대신하지 않습니다.
v2rayN
v2rayNG / v2flyNG
설정 가져오기, 구독 관리, 노드 선택, 로그 확인.
Xray
V2Fly
프로토콜 핸드셰이크, 전송 처리, 라우팅 규칙 적용 및 아웃바운드 연결.
Project V는 프록시 기능을 인바운드, 아웃바운드, 라우팅, 전송 등의 모듈로 나눕니다. 인바운드는 로컬 앱의 연결을 받고, 라우팅은 어느 아웃바운드로 보낼지 결정하며, 아웃바운드는 지정된 프로토콜로 원격 서버와 통신합니다. GUI 클라이언트는 이 개념을 메뉴와 설정 항목으로 정리해, 일상적인 작업을 전체 설정 파일부터 시작하지 않아도 되게 합니다. 문제가 생기면 이 연결 흐름을 따라가며 점검하는 편이 반복해서 재설치하는 것보다 효과적일 때가 많습니다.
일상적인 대화에서 V2Ray는 이런 종류의 클라이언트를 통칭하는 말로도 쓰이지만, 특정 GUI 하나를 가리키는 것은 아닙니다. ‘V2Ray 공식 사이트’를 검색할 때도 코어 프로젝트와 클라이언트 프로젝트, 한국어 자료 사이트의 역할을 구분해야 합니다. 이 사이트는 다운로드 링크와 사용 안내를 제공합니다. 클라이언트에 바로 사용할 수 있는 원격 서버가 포함되어 있는 것은 아니므로, 연결 매개변수는 실제로 사용할 권한이 있는 작동 가능한 서버에서 제공받아야 합니다.
V2Fly는 V2Ray 코어를 이어받아 커뮤니티에서 개발하고 있으며, Xray는 관련 코드를 바탕으로 발전한 코어 분기입니다. 두 코어는 일부 개념과 설정 방식을 공유하지만 기능은 각자 발전하고 있습니다. 설정을 가져올 수 있다고 해서 두 코어가 이를 똑같이 처리한다고 단정할 수는 없습니다. 특정 프로토콜 조합과 전송 매개변수, 보안 계층은 실제 코어의 지원 여부를 확인해야 합니다.
예를 들어 REALITY는 보안 계층과 관련된 기능이며, 모든 프록시 프로토콜과 같은 계층에 속하는 독립 클라이언트가 아닙니다. 이런 매개변수가 포함된 설정을 선택할 때는 클라이언트가 해당 항목을 인식하는지, 코어가 해당 조합을 지원하는지, 서버 측 매개변수와 일치하는지 함께 확인하세요. 프로토콜 이름이 같아도 포트, 서버 이름, 공개 키 등의 항목을 임의로 함께 사용할 수 있는 것은 아닙니다.
v2rayN은 데스크톱용 클라이언트로, 서버 목록과 구독 그룹, 시스템 프록시, 라우팅을 GUI에서 관리할 수 있습니다. 실제로 사용할 수 있는 코어는 배포 파일과 설정에 따라 다릅니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG도 Android용으로, V2Fly 코어를 기반으로 설정을 처리합니다. 선택할 때는 먼저 운영체제를 확인하고, 현재 서버 설정에 필요한 기능을 살펴보세요.
세 클라이언트는 모두 오픈소스 프로젝트로, 공개된 소스 코드에서 기능 구현과 변경 내역을 확인할 수 있습니다. 오픈소스는 코드의 공개 및 라이선스 방식을 뜻할 뿐, 프로젝트마다 유지보수 주기가 같다는 의미는 아닙니다. GUI 클라이언트와 함께 제공되는 코어의 라이선스도 서로 다를 수 있습니다. 재배포하거나 수정 개발할 때는 각 구성 요소의 라이선스와 고지 사항을 따로 확인하세요.
클라이언트 업데이트는 메뉴와 가져오기 처리, 권한 관리, 코어 호출 방식 등을 바꿀 수 있습니다. 코어 업데이트는 프로토콜 구현과 설정 요구 사항에 영향을 줄 수 있으며, 라우팅 데이터 업데이트는 도메인 분류와 규칙 적용 결과를 바꿀 수 있습니다. 업데이트를 각기 다른 계층의 변경으로 보면 ‘업데이트 후 연결이 안 됨’ 문제가 어느 단계에서 발생했는지 더 정확히 확인할 수 있습니다. 곧바로 노드 문제라고 단정하지 마세요.
구독 형식도 서비스마다 다를 수 있습니다. 구독 주소에서 공유 링크 목록이 반환되기도 하고 전체 설정 형식이 반환되기도 하며, 클라이언트는 지원하는 형식만 처리할 수 있습니다. 가져오기에 실패하면 먼저 형식과 응답 내용을 확인하고, 주소가 완전한지와 접속 정보가 유효한지 살펴보세요. 구독 주소를 브라우저 프록시 주소처럼 사용하지 말고, 수동으로 수정한 노드 매개변수가 구독 업데이트 후에도 유지된다고 가정하지 마세요.
사용 가이드 / 프로토콜, 생태계와 플랫폼 설치
기본 설정을 가져온 뒤 실제로 겪는 문제에 맞춰 더 자세히 살펴보세요. 프로토콜 선택에서는 설정 지원 범위를 확인하고, 생태계 안내에서는 클라이언트와 코어의 차이를 살펴보며, 플랫폼 설치에서는 설치 방법과 시스템 프록시, 자동 실행을 다룹니다. 읽는 동안 현재 작동하는 설정을 보관하고, 한 가지를 변경할 때마다 확인하세요. 여러 문제를 한 번에 해결하려다 혼란이 생기는 일을 막을 수 있습니다.
Debian/Ubuntu 및 Fedora 계열 배포판에서 deb·rpm 패키지로 v2rayN 데스크톱 버전을 설치하고, 데스크톱 자동 실행과 시스템 프록시를 설정하며, 자주 발생하는 의존성 문제를 해결합니다.
먼저 배포판과 아키텍처를 확인한 뒤 수동으로 한 번 실행해 연결을 점검하세요. 설치와 데스크톱 세션, 프록시 설정을 나눠 다뤄 ‘실행은 되지만 앱이 프록시를 사용하지 않는’ 단계별 문제를 찾기 쉽게 안내합니다.
설치 및 설정 단계 보기 →Project V의 배경과 V2Fly·Xray 두 코어 분기의 역할, 그리고 v2rayN·v2rayNG·v2flyNG 클라이언트가 각각 사용하는 코어와 지원 플랫폼을 정리합니다.
화면에 표시되는 클라이언트 이름을 넘어 실제 연결을 처리하는 구성 요소를 설명하고, 설정을 가져와도 코어와 호환되지 않을 수 있는 이유를 살펴봅니다. 클라이언트 전환이나 설정 이전, 프로토콜 매개변수를 확인하기 전에 개념을 정리하는 데 도움이 됩니다.
오픈소스 생태계 안내 보기 →네 가지 프록시 프로토콜의 설계 방식과 암호화, 리소스 사용량을 비교하고 데스크톱 일상 사용, 모바일 배터리 절약, 여러 기기 공유 등 상황별 선택 기준을 안내합니다.
프로토콜뿐 아니라 전송 방식과 보안 계층도 핸드셰이크와 리소스 사용량에 영향을 줍니다. 각 요소를 나눠 설명해 이름 변경이나 더 많은 매개변수, 한 번의 테스트 결과만으로 보편적인 성능 순위를 매기지 않도록 돕습니다.
프로토콜 비교 읽기 →