클라이언트 다운로드 및 설정 가이드
기기에 맞는 오픈 소스 클라이언트를 선택하고, 구독 가져오기부터 시작해 라우팅 및 DNS 설정을 차례로 확인하세요.
규칙 작성 예시입니다. 위에서부터 순서대로 매칭됩니다. 리소스 파일에 해당 분류가 있어야 하며, 실제 동작은 전체 설정에 따라 달라집니다.
SETTINGS / BEFORE CONNECTING
v2rayNG 안드로이드판은 Android 기기의 연결 설정을 관리하고, v2rayN은 데스크톱 그래픽 인터페이스를 제공합니다. v2flyNG는 V2Fly 코어를 사용하는 Android 대안입니다. 클라이언트를 설치하는 것은 실행 환경을 준비하는 단계일 뿐, 실제로 연결하려면 유효한 서버 설정이 필요합니다. 구독 주소는 여러 설정을 한꺼번에 가져오는 데 쓰이고, 단일 공유 링크는 하나의 연결 정보를 담습니다. 둘 다 텍스트 링크처럼 보이지만 가져오기 메뉴와 업데이트 방식은 다릅니다.
처음 설정할 때는 순서를 정해 진행하는 것이 좋습니다. 먼저 기기와 설치 파일의 아키텍처를 확인하고, 구독을 가져온 다음 실행 모드와 라우팅을 점검하세요. 연결을 확인하기 전에 스니핑, DNS, 다중화, 라우팅 규칙을 한꺼번에 바꾸지 마세요. 한 번에 한 항목만 조정하고 기존 값을 기록해 두면 문제가 생겼을 때 원인을 좁히기 쉽습니다. 아래 설정 화면은 메뉴와 항목을 보여 주는 예시이며, 모든 기기에 맞는 기본값을 제시하는 것은 아닙니다.
SETTINGS INDEX
필요한 설정 항목을 선택하세요. 먼저 어떤 계층에 영향을 주는지 확인한 뒤 사용할지 결정하면 됩니다. 클라이언트나 배포판에 따라 메뉴 이름은 조금씩 다를 수 있습니다.
라우팅 규칙은 요청을 직접 연결할지, 프록시를 거칠지, 차단할지 결정합니다. ‘라우팅 설정’에서 규칙 순서를 확인하고 도메인 및 IP 분류 리소스를 사용할 수 있는지 점검하세요. 예를 들어 사설 주소를 직접 연결하면 LAN 기기에 계속 접근할 수 있습니다. 도메인 규칙과 IP 규칙은 매칭 조건이 다르므로 분류 이름만 보고 결과를 단정할 수 없습니다. 전체 트래픽의 출구만 바꾸는 방식과 달리 규칙으로 요청을 세분화할 수 있지만, 리소스 파일과 예외 항목도 관리해야 합니다. 문제가 생기면 먼저 간단한 프리셋으로 연결을 확인한 뒤 사용자 지정 규칙을 추가하세요.
프로토콜 및 코어 참고 자료자주 쓰는 규칙 예시
매칭 항목과 동작만 보여 주는 예시이며, 완전한 라우팅 설정은 아닙니다.
구독 그룹을 사용하면 같은 출처의 설정을 모아 업데이트하고 구분하기 쉽습니다. v2rayNG에서 ‘구독 그룹 설정’을 열어 메모와 구독 주소를 입력하고 저장한 뒤, 메인 화면으로 돌아가 구독을 업데이트하세요. v2rayN에서는 ‘구독 그룹’ 메뉴로 이동하면 됩니다. 클립보드에서 단일 공유 링크를 가져오는 것과 달리 구독은 출처의 설정 변경 사항을 계속 가져올 수 있지만, 업데이트 중 기존 항목이 바뀔 수도 있습니다. 연결하기 전에 그룹과 항목 수가 예상과 맞는지 확인하세요. 구독 주소에는 접근 권한 정보가 포함되므로 게시판에 공개하거나 화면을 캡처해 공유하지 마세요.
구독 가져오기 단계 보기진행 순서
단일 공유 링크는 해당 클립보드 가져오기 메뉴를 사용하세요.
VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프록시 프로토콜이며, 전송 방식과 보안 계층은 별도로 설정합니다. REALITY는 보안 계층 방식이므로 VLESS와 완전히 동등한 프로토콜 이름으로 보면 안 됩니다. 설정을 가져온 뒤 프로토콜, 포트, 전송 방식, 보안 계층이 서로 맞는지 확인하세요. 프로토콜 이름만 보고 선택하는 것보다 전체 항목을 점검하는 편이 연결 실패를 예방하는 데 효과적입니다. 특정 프로토콜을 쓰려고 유형만 임의로 바꾸지 마세요. 서버에서 해당 설정을 제공하지 않으면 클라이언트에서 옵션을 바꿔도 지원되는 연결이 만들어지지 않습니다.
프로토콜 선택 가이드 보기설정은 여러 계층으로 구성됩니다
전송 방식
보안 계층
항목 조합 예시이며, 바로 연결할 수 있는 서버 정보는 포함하지 않습니다.
앱별 프록시는 Android VPN 인터페이스를 통해 요청을 보낼 앱을 지정하는 기능입니다. 설정에서 ‘앱별 프록시’를 켠 다음, 선택한 앱만 프록시로 보낼지 선택한 앱을 우회할지 현재 모드를 확인하고 대상 앱을 선택하세요. 도메인 라우팅과 달리 앱 단위로 연결 범위를 정하므로 일부 앱에만 프록시를 적용할 때 유용합니다. 클라이언트에서 나가는 요청에는 라우팅 규칙이 추가로 적용될 수 있습니다. 앱 목록을 바꾼 뒤에는 화면 안내에 따라 서비스를 다시 시작하고 대상 앱에서 연결을 확인하세요. 앱을 선택했다고 해서 요청이 반드시 프록시를 거치는 것은 아닙니다.
연결 및 확인 단계 보기예시: 사용 설정됨. 앱 목록과 선택 모드는 실제 클라이언트에서 확인해야 합니다.
Xray와 V2Fly는 같은 기술 생태계에서 출발했지만, 이후 기능과 설정 세부 사항이 서로 다르게 발전했습니다. Android에서는 v2rayNG가 Xray 코어를 사용하고, v2flyNG는 V2Fly 계열의 대안을 제공합니다. 데스크톱 v2rayN은 실제 배포판과 설정에서 코어 선택을 확인해야 합니다. 화면 모양만 보고 클라이언트를 고르는 것보다 코어가 연결 설정 항목을 인식하는지 확인하는 편이 확실합니다. 일반적인 설정은 호환될 수 있지만, 확장 보안 계층이나 새 항목까지 호환된다고 단정할 수는 없습니다. 클라이언트를 바꾸기 전에 기존 설정을 보관하고, 프로토콜 안내서에서 필요한 기능의 지원 조건을 확인하세요.
코어 및 설정 호환성 비교클라이언트 / 코어 계열
실행 중 두 코어를 전환하는 스위치가 아닙니다.
CLIENT SELECTION
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 살펴보세요. 다운로드 페이지에서 설치 파일 종류와 프로세서 아키텍처, 설치 시 주의 사항을 확인할 수 있습니다.
v2rayN은 Desktop 데스크톱판과 클래식 WPF판을 제공합니다. Desktop판은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF판은 기존 데스크톱 인터페이스를 유지합니다. 사용 방식과 시스템 환경에 맞춰 선택한 뒤 설치 안내를 확인하세요. 같은 구독을 위해 두 인터페이스를 모두 설치할 필요는 없습니다.
클라이언트가 실행된다고 시스템 프록시까지 설정된 것은 아닙니다. 브라우저와 터미널은 서로 다른 방식으로 프록시에 연결할 수 있습니다. 한쪽은 접속되고 다른 쪽은 안 된다면 연결 설정을 바로 바꾸기보다 각 앱의 설정과 환경 변수를 따로 확인하세요.
다운로드 페이지로 이동 →v2rayN에 맞는 디스크 이미지 설치 파일을 선택하세요. Apple Silicon 기기는 arm64, Intel 기기는 x64 항목을 사용합니다. 먼저 시스템의 ‘이 Mac에 관하여’에서 칩이나 프로세서 정보를 확인한 다음 다운로드 페이지에서 선택하세요. 컴퓨터 외관만 보고 아키텍처를 판단하지 마세요.
처음 실행할 때는 시스템 안내에 따라 앱 실행 권한을 허용하세요. 구독을 가져온 뒤에는 실행 모드가 대상 앱의 연결 방식에 맞는지도 확인해야 합니다. LAN 리소스에 접근하려면 사설 주소 규칙과 관련 권한을 점검하세요. 모든 접속 문제를 서버 탓으로 돌리지 않도록 주의하세요.
다운로드 페이지로 이동 →v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 최신 스마트폰 대부분은 arm64 설치 파일을 먼저 확인하면 됩니다. 기기의 ABI를 모르거나 아키텍처가 맞지 않는다는 안내가 표시되면 범용 패키지 설명을 확인하세요. 최종적으로는 기기에서 지원하는 아키텍처와 설치 결과를 기준으로 선택해야 합니다.
VPN 모드로 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 이미 같은 VPN 인터페이스를 사용하는 앱이 있다면 먼저 충돌을 해결하세요. 장시간 백그라운드에서 실행할 때는 시스템 배터리 정책이 영향을 줄 수 있으므로 연결이 끊기면 백그라운드 권한도 함께 확인하세요.
다운로드 페이지로 이동 →v2rayN 데스크톱판은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64 아키텍처로 나뉩니다. Debian·Ubuntu 계열 데스크톱은 보통 deb, Fedora 계열은 보통 rpm을 확인하세요. 패키지 형식과 프로세서 아키텍처는 서로 별개의 조건이므로 둘 다 맞아야 합니다.
설치 후 트레이 아이콘이 보이지 않으면 데스크톱 환경의 트레이 지원 여부와 앱 실행 상태부터 확인하세요. 로그인 시 자동 시작은 보통 그래픽 데스크톱에 로그인한 뒤 앱을 실행하는 기능이며, 시스템 서비스와는 다릅니다. 터미널 프로그램이 데스크톱 시스템 프록시를 사용하지 않을 수도 있으므로 프록시 환경 변수도 따로 확인하세요.
다운로드 페이지로 이동 →QUICK START / 03 STEPS
다시 확인할 수 있는 연결을 먼저 만든 다음 필요한 설정을 추가하세요. 아래는 간단한 순서이며, 전체 가이드에서는 각 메뉴를 단계별로 설명합니다.
클라이언트를 설치하고 연 뒤, 받은 것이 구독 주소인지 단일 공유 링크인지 먼저 확인하세요. v2rayNG에서는 ‘구독 그룹 설정’, v2rayN에서는 ‘구독 그룹’ 메뉴에서 구독을 관리합니다. 출처를 구분할 메모와 전체 주소를 입력하고 저장한 다음 구독을 업데이트하세요. 이후 설정 목록으로 돌아가 결과를 확인합니다. 구독 주소를 일반 웹페이지 주소처럼 판단하지 마세요. 브라우저에 표시되는 방식만으로 클라이언트가 주소를 해석할 수 있는지 알 수 없습니다.
업데이트 후 목록이 비어 있다면 주소를 빠짐없이 복사했는지, 출처가 아직 유효한지, 응답 형식이 클라이언트에서 지원되는지 확인하세요. 단일 공유 링크는 클립보드 가져오기를 사용해야 합니다. 설정 하나를 가져오려고 구독 그룹에 임의로 입력하지 마세요. 기존 그룹을 업데이트하기 전에는 따로 보관할 수동 설정이 있는지 확인해 출처의 변경 사항과 로컬 편집 내용을 혼동하지 않도록 하세요.
목록에서 사용할 설정을 선택한 다음 클라이언트의 실행 모드를 확인하세요. Android의 VPN 모드는 시스템 인터페이스를 통해 앱 요청을 연결하고, 프록시 전용 모드는 보통 앱이 로컬 프록시를 직접 사용해야 합니다. 데스크톱에서 ‘시스템 프록시 설정’은 시스템 프록시를 따르는 앱에만 영향을 줍니다. ‘전역’이나 ‘중국 본토 우회’ 같은 라우팅 프리셋과는 별개의 설정입니다. 전자는 연결 방식을, 후자는 연결된 요청이 향할 경로를 정합니다.
처음 연결할 때는 이해하기 쉬운 라우팅 프리셋을 사용하고 다른 고급 설정은 그대로 두세요. 특정 앱 하나가 연결되지 않는다고 모든 옵션을 켜지 마세요. 앱별 프록시, DNS, 스니핑은 각각 다른 단계에 영향을 줍니다. 동시에 변경하면 원인을 비교할 기준이 사라집니다. 프리셋의 차이를 알고 싶다면 먼저 프로토콜 안내서와 관련 자료를 확인한 뒤 실제 클라이언트에서 현재 적용된 설정을 살펴보세요.
연결을 시작하고 시스템에서 요구하는 권한을 허용한 뒤, 실제로 사용할 앱을 열어 접속을 확인하세요. 서비스가 실행 중이라는 표시만으로 로컬 프로세스가 시작된 것은 알 수 있지만, 종단 간 접속까지 확인되는 것은 아닙니다. 먼저 접속 가능 여부를 알고 있는 대상에 연결한 다음 LAN 리소스처럼 다른 유형의 요청도 점검하세요. 일부 도메인만 실패한다면 모든 연결이 안 된다고 단정하지 말고 DNS와 라우팅 매칭을 계속 확인하세요.
문제가 생기면 ‘어떤 앱에서, 어떤 작업을 하다가, 언제 실패했는지’를 기록한 뒤 클라이언트 로그의 오류 유형을 확인하세요. 로그나 화면을 공유하기 전에는 구독 주소, 인증 정보, 개인 경로를 삭제하세요. 설정 유효성, 실행 모드, 앱 연결, 라우팅, DNS 순으로 확인하면 앱을 반복해서 재설치하는 것보다 원인을 좁히기 쉽습니다. 자세한 조치와 자주 묻는 질문은 입문 가이드와 FAQ에서 확인할 수 있습니다.
PROJECT V / CORE FAMILY
클라이언트는 인터페이스와 설정 관리를 담당하고, 코어는 연결을 처리합니다. 이 역할 구분을 알면 기능을 제공하는 구성 요소와 업데이트 때 확인할 항목을 판단할 수 있습니다.
Project V는 프록시 통신 도구를 중심으로 형성된 오픈 소스 기술 생태계이며, V2Ray는 널리 알려진 핵심 프로젝트입니다. 인바운드, 아웃바운드, 전송, 라우팅 등의 단계를 조합 가능한 설정으로 구성해 하나의 그래픽 인터페이스에서 여러 연결 방식을 관리할 수 있습니다. 일상적으로 말하는 ‘V2Ray 클라이언트’는 그래픽 프로그램과 기반 코어를 함께 가리키는 경우가 많지만, 두 요소는 서로 다른 소프트웨어 계층입니다. 다운로드 페이지에서는 클라이언트별 다운로드 항목을 안내하고, 프로토콜 안내서에서는 기반 프로토콜과 코어의 관계를 설명합니다.
이런 계층 구분은 두 클라이언트가 비슷한 공유 링크를 가져오면서도 메뉴와 실행 모드는 다를 수 있는 이유이기도 합니다. 인터페이스는 클라이언트에 따라 달라지고, 연결 항목을 인식할 수 있는지는 코어 기능과 가져오기 기능에 따라 달라집니다. 설정을 찾을 때는 먼저 클라이언트 이름을 확인하고, 프로토콜 지원 여부를 판단할 때는 사용 중인 코어를 확인하세요. 한 플랫폼의 조작 화면을 다른 소프트웨어에 그대로 적용하지 않도록 주의해야 합니다.
V2Fly는 V2Ray 코어를 이어받아 커뮤니티에서 유지 관리하고, Xray는 관련 코드 기반에서 별도의 코어 계열로 발전했습니다. 두 코어는 일부 개념과 설정 방식이 같지만, 각각 발전하면서 새로 추가된 항목이나 보안 계층 방식을 모두 서로 인식하는 것은 아닙니다. 클라이언트가 VMess나 VLESS를 지원한다고 해서 해당 프로토콜의 모든 전송 조합을 지원한다는 뜻도 아닙니다. 코어 이름만 비교하거나 한 계열을 모든 상황의 정답으로 간주하지 말고, 서버에서 제공한 전체 설정을 기준으로 선택하세요.
모바일 기기의 실제 리소스 사용량은 전송 방식, 연결 수, 네트워크 전환, 백그라운드 정책에도 영향을 받습니다. 프로토콜 이름만으로 모든 상황에 적용되는 배터리 소모 순위를 정할 수는 없습니다. 현재 설정으로 필요한 기능을 이용할 수 있다면 값을 그대로 유지하세요. 기능을 추가해야 할 때 코어 지원 범위, 클라이언트의 가져오기 기능, 서버 조건을 확인하는 편이 여러 클라이언트 사이에서 설정을 반복해서 옮기는 것보다 관리하기 쉽습니다.
v2rayN, v2rayNG, v2flyNG는 모두 설정 관리와 일상적인 조작을 간편하게 해 주는 오픈 소스 그래픽 클라이언트입니다. v2rayN은 데스크톱용으로 구독 그룹, 시스템 프록시, 라우팅 메뉴를 제공합니다. v2rayNG는 Android용으로 시스템 VPN 인터페이스를 통해 요청을 관리합니다. v2flyNG는 V2Fly 코어를 사용하는 Android 클라이언트입니다. 인터페이스가 비슷해도 모든 옵션이 동일한 것은 아니므로 옮기기 전에 항목별로 확인하세요.
클라이언트 자체가 연결 서비스는 아니며, 설치를 마쳤다고 사용할 수 있는 구독이 자동으로 생기는 것도 아닙니다. 구독 제공처는 연결 매개변수를 제공하고, 클라이언트는 설정을 해석하고 실행합니다. 문제를 진단할 때 두 부분을 구분해야 설치, 가져오기, 서버 상태, 로컬 라우팅 중 어디에 원인이 있는지 판단할 수 있습니다. 이 사이트는 세 클라이언트를 중심으로 가이드를 구성하며, 설정 제공처와 소프트웨어 배포를 같은 것으로 취급하지 않습니다.
V2Ray 코어와 Xray 코어는 MPL 2.0 오픈 소스 라이선스를 사용하며, 그래픽 클라이언트는 각자의 라이선스 고지와 의존성 안내를 따릅니다. 오픈 소스 라이선스는 코드의 사용, 수정, 재배포 조건을 정하며, 모든 소프트웨어 계층에 완전히 동일한 라이선스 조건이 적용된다는 뜻은 아닙니다. 일반 사용자는 기능과 배포 안내를 확인하면 됩니다. 코드를 수정하거나 재배포할 때는 클라이언트, 코어, 관련 의존성의 실제 라이선스 문서를 각각 확인하세요.
업데이트 대상도 여러 계층으로 나뉩니다. 클라이언트 업데이트는 인터페이스와 가져오기 기능을 바꿀 수 있고, 코어 업데이트는 프로토콜 항목 지원을 추가할 수 있습니다. 구독 업데이트는 연결 설정을 새로고침하고, 규칙 리소스 업데이트는 분류 매칭에 영향을 줍니다. 구독 업데이트에 성공했다고 코어 기능까지 바뀐 것은 아닙니다. 업그레이드 전에 필요한 로컬 설정을 보관하고, 업데이트 후 기존 연결과 자주 쓰는 앱을 먼저 확인한 다음 새 옵션을 사용하면 여러 변수가 동시에 바뀌어 생기는 문제를 줄일 수 있습니다.
NOTES / RECENT ARTICLES
실제 메뉴와 조작을 중심으로 문제를 설명하고, 시스템 설정·앱 동작·클라이언트 라우팅을 구분합니다.
브라우저에서는 프록시 확장 프로그램 충돌과 PAC 잔여 설정을 확인하고, 터미널에서는 http_proxy·https_proxy 환경 변수와 로컬 리스닝 포트를 점검해 시스템 프록시가 작동하지 않는 원인을 단계별로 찾습니다.
글 읽기 →‘시스템 프록시 설정’과 ‘시스템 프록시 해제’, 라우팅 프리셋인 ‘전역’과 ‘중국 본토 우회’가 각각 어떤 계층에 영향을 주는지 설명하고, 일상적인 웹 브라우징과 개발 디버깅 상황에 맞는 조합을 안내합니다.
글 읽기 →Debian·Ubuntu 및 Fedora 계열 데스크톱을 대상으로 deb·rpm 설치 패키지 설치, 의존성 처리, 트레이 아이콘 표시와 데스크톱 자동 시작 항목을 통한 로그인 후 실행 방법을 설명합니다.
글 읽기 →