데스크톱에서는 v2rayN을 사용하고, Android에서는 먼저 v2rayNG를 살펴본 뒤 코어 요구 사항에 따라 v2flyNG를 고려하세요.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 기존 레이아웃을 유지합니다. 원하는 인터페이스를 기준으로 선택한 뒤 다운로드 페이지에서 실행 요구 사항을 확인하세요. 동일한 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.
처음 실행한 뒤 프로그램이 설정 폴더에 정상적으로 파일을 쓸 수 있는지 확인하고 구독 그룹을 추가하세요. 기존 환경에서 이전하는 경우 현재 설정과 사용자 지정 라우팅 규칙을 저장하고, 이전 폴더를 새 설치 위치에 그대로 덮어쓰지 마세요. 시작 오류가 발생하면 실행 환경 문제와 설정 문제를 구분해 확인하세요.
다운로드 Windows 설치 파일v2rayN은 프로세서에 따라 Apple Silicon 및 Intel 설치 파일을 제공합니다. 먼저 시스템의 '이 Mac에 관하여'에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택하면 됩니다. 아키텍처 선택은 구독 프로토콜과 무관하며 서버 프로세서에 따라 판단할 수 없습니다.
설치한 뒤 클라이언트를 실행하고 서버를 선택한 다음 시스템 프록시를 설정하세요. 브라우저에 프록시 확장 프로그램이 있다면 확장 프로그램이 시스템 설정을 덮어쓰는지 확인하세요. 터미널 프로그램은 별도의 환경 변수를 사용할 수도 있습니다. 따라서 브라우저에서 접속된다고 해서 모든 앱이 같은 연결 경로를 사용하는 것은 아닙니다.
다운로드 macOS 설치 파일v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 대부분의 최신 Android 기기에서는 먼저 arm64 설치 파일을 확인하고, 기기 아키텍처를 모르면 범용 버전을 살펴보세요. 두 앱은 파일 이름이 비슷한지가 아니라 설정 호환성과 코어 요구 사항을 기준으로 선택해야 합니다.
처음 연결할 때는 클라이언트가 앱 트래픽을 처리할 수 있도록 시스템 VPN 연결 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 앱별 프록시는 프록시 경로를 사용할 앱을 지정하는 기능입니다. 우회와 프록시 전용 설정을 반대로 이해하지 않도록 규칙 방향을 먼저 확인하세요.
다운로드 Android 설치 파일v2rayN은 deb 및 rpm 설치 파일을 제공합니다. 배포판의 패키지 관리 체계에 맞는 형식을 선택하세요. 프로세서 아키텍처는 x64와 arm64로 나뉩니다. 패키지 형식은 어떤 패키지 관리자로 설치할지를, 아키텍처는 어떤 프로세서에서 실행할지를 뜻하므로 두 항목을 각각 확인해야 합니다.
설치한 뒤 데스크톱 세션에서 GUI 클라이언트를 실행하고 로컬 수신이 정상인지 먼저 확인하세요. 데스크톱 환경에 따라 시스템 프록시를 사용하는 방식이 다를 수 있으며, 일부 앱은 프록시 주소와 포트를 직접 입력해야 합니다. 설치가 완료됐다는 이유만으로 모든 앱이 프록시에 연결됐다고 판단하지 마세요.
다운로드 Linux 설치 파일설치 파일에는 클라이언트 프로그램만 포함됩니다. 구독 주소, 서버 연결 매개변수 및 접근 권한은 설정을 제공하는 곳에서 받아야 하며, 설치 후에도 유효한 설정을 가져와야 합니다. 다운로드 페이지에서는 아키텍처와 패키지 형식을 안내하고, 클라이언트 비교 페이지에서는 세 앱이 각각 어떤 환경에 적합한지 설명합니다.
클라이언트 전체 보기 →먼저 클라이언트에서 설정 항목을 찾고, 해당 항목이 영향을 주는 설정 계층을 확인하세요.
구독 그룹은 클라이언트 관리 계층의 객체이며, 코어 JSON에서 공통으로 사용하는 최상위 항목은 아닙니다. 출처별로 구분하기 쉬운 메모를 설정하고 구독 주소를 입력한 뒤 업데이트를 실행하여 서버 항목이 생성됐는지 확인하세요. 업데이트에 실패하면 주소에 접근할 수 없는지, 응답을 파싱할 수 없는지, 현재 네트워크 경로에 문제가 있는지부터 구분하세요. 기존 설정을 바로 삭제하지 마세요. 구독 그룹은 계속 업데이트되는 출처를 서버별로 관리하는 것보다 편리하지만, 로컬 수정 사항이 유지되는지는 클라이언트 동작에 따라 다릅니다. 중요한 매개변수는 별도로 저장하세요.
구독 그룹
├─ 메모
├─ 구독 주소
└─ 구독 업데이트라우팅 규칙은 코어에 들어온 트래픽을 어떤 아웃바운드로 보낼지 결정합니다. 규칙은 보통 위에서부터 순서대로 확인하며, 조건에 맞는 규칙을 찾으면 해당 아웃바운드 태그를 사용합니다. 따라서 구체적인 조건을 포괄적인 조건보다 앞에 두세요. 예시에서는 중국 도메인 목록을 direct로 보내지만, 해당 아웃바운드와 규칙 데이터가 이미 정의되어 있어야 합니다. 라우팅 규칙은 앱을 자동으로 프록시에 연결하지 않으며 시스템 프록시 설정과도 다릅니다. 라우팅을 점검할 때는 요청이 코어에 들어왔는지 먼저 확인한 다음, 일치 조건과 태그를 살펴보세요. 서로 다른 계층의 설정을 반복해서 바꾸지 않도록 주의하세요.
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}시스템 프록시는 시스템 설정을 따르는 앱에 요청을 전달할 로컬 주소와 포트를 알려줍니다. 사용하기 전에 코어가 실행 중인지, 포트가 올바른 프로토콜에 해당하는지 확인해야 합니다. 브라우저 확장 프로그램, 명령줄 환경 변수 및 앱 내 설정은 각각 별도의 경로를 사용할 수 있으므로 시스템 프록시가 모든 트래픽을 제어하는 단일 스위치는 아닙니다. 일부 코어와 클라이언트는 혼합 수신을 지원하고, 다른 설정은 HTTP와 SOCKS를 분리합니다. 실제 수신 항목을 확인하고 흔히 쓰이는 포트 번호만으로 프로토콜을 단정하지 마세요.
시스템 프록시 → 시스템 프록시 자동 설정
로컬 주소 → 127.0.0.1
수신 포트 → 클라이언트의 실제 설정 확인GUI 클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 코어를 전환하기 전에 프로토콜, 전송 방식 및 보안 설정이 지원되는지 확인하세요. 이름이 비슷하다고 설정 항목까지 완전히 호환되는 것은 아닙니다. v2rayNG는 Xray용이고 v2flyNG는 V2Fly용입니다. 데스크톱에서는 현재 v2rayN에서 선택할 수 있는 코어를 확인하세요. 전환한 뒤에는 이미 작동하는 설정 하나로 검증한 다음 사용자 지정 라우팅을 복원하세요. 시작에 실패하면 서버 주소와 포트를 동시에 바꾸기보다 설정 파싱 오류를 먼저 확인하세요.
클라이언트 관리 계층 → 설정 생성
코어 실행 계층 → 프로토콜 및 전송
점검 순서 → 설정 파싱 → 연결 수립기본 설정이 로컬 루프백 주소만 수신하도록 되어 있으면 다른 기기에서 로컬 프록시에 직접 연결할 수 없습니다. LAN 연결을 허용하면 수신 범위가 넓어지므로 방화벽, 접근 제어 및 올바른 호스트 주소도 설정해야 합니다. 공유할 기기에는 클라이언트가 실행 중인 컴퓨터의 LAN 주소를 입력해야 하며, 해당 기기 자신의 루프백 주소를 입력하면 안 됩니다. 신뢰할 수 있는 네트워크에서 필요한 경우에만 활성화하고 사용 후에는 끄세요. 프록시 포트를 공용 네트워크에 노출하지 마세요. 연결이 거부되면 수신 주소와 방화벽을 먼저 확인한 뒤 프록시 프로토콜과 대상 기기의 포트 설정을 살펴보세요.
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}이 설정은 로컬 기기에서만 사용하는 인바운드 예시이며, LAN에 공개하는 설정이 아닙니다.
클라이언트 인터페이스 항목과 코어 설정은 일대일로 대응하지 않습니다. 구독 그룹과 창 표시 설정 등은 클라이언트가 저장하고, 인바운드·아웃바운드·라우팅·DNS는 일반적인 코어 설정 객체에 해당합니다. 직접 편집하기 전에 클라이언트 설정을 수정하는지 생성된 실행 설정을 수정하는지 확인하세요. 후자는 다음 실행 때 다시 생성될 수 있습니다.
JSON 구조 및 설정 항목 보기 →'설정 출처 → 트래픽 진입점 → 연결 결과' 순서로 진행하세요.
구독 그룹 설정을 열고 출처를 쉽게 구별할 수 있는 메모를 입력한 뒤 전체 구독 주소를 붙여 넣으세요. 저장 후 업데이트를 실행하고 사용할 수 있는 설정이 목록에 표시되는지 확인한 다음 연결할 서버를 선택하세요. 단일 공유 링크를 가지고 있다면 클라이언트의 가져오기 기능을 사용하세요. 구독 주소 입력란에 넣으면 안 됩니다.
가져오기에 성공했다는 것은 내용을 파싱할 수 있다는 뜻일 뿐, 서버에 연결된다는 의미는 아닙니다. 먼저 주소, 포트, 프로토콜, 전송 방식 및 보안 매개변수가 같은 설정에서 가져온 것인지 확인하세요. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 공개 스크린샷이나 문의 내용에 노출하지 마세요. 로그를 공유하기 전에도 민감한 항목을 삭제하세요.
연결을 시작한 뒤 클라이언트에서 수신 포트 충돌을 보고하지 않는지 확인하고 필요에 따라 시스템 프록시를 활성화하세요. 브라우저는 보통 시스템 설정을 따르지만 터미널과 일부 데스크톱 앱은 별도로 설정해야 합니다. 프록시를 직접 입력할 때는 주소, 포트 및 프로토콜이 클라이언트의 실제 수신 설정과 일치해야 합니다.
그다음 현재 목적에 맞는 라우팅 모드를 선택하세요. 라우팅은 요청이 코어에 들어온 뒤 어디로 갈지 제어하고, 시스템 프록시는 앱이 요청을 코어에 전달할지 제어합니다. 두 설정은 같은 스위치가 아닙니다. 처음에는 클라이언트의 기본 규칙을 유지하고 연결이 정상인지 확인한 뒤 도메인이나 주소 조건을 하나씩 추가하세요.
프록시가 필요한 실제 앱으로 대상에 접속하고 클라이언트에 해당 연결 기록이 표시되는지 확인하세요. 특정 앱만 실패하면 해당 앱의 프록시 경로를 점검하세요. 모든 앱에서 실패하면 코어 실행 상태, 서버 매개변수 및 네트워크 연결을 확인하세요. 한 번에 조건 하나만 바꿔야 어떤 변경이 영향을 주었는지 알 수 있습니다.
로그의 연결 거부, 시간 초과 및 핸드셰이크 실패는 각각 발생 단계가 다르므로 모두 구독 만료로 단정하면 안 됩니다. 문제를 찾을 때는 로그 수준을 일시적으로 높이고, 해결한 뒤에는 평소 사용하는 수준으로 되돌리세요. Android에서는 VPN 연결 권한과 앱별 프록시 범위도 확인해야 합니다. 백그라운드에서 연결이 끊기면 구독을 반복해서 가져오기보다 배터리 최적화를 점검하세요.
기기를 옮기거나 클라이언트를 바꿀 때는 현재 작동하는 설정의 출처와 사용자 지정 규칙을 먼저 저장하세요. 시스템 프록시, 복잡한 라우팅, LAN 공유를 한꺼번에 활성화하지 마세요. 최소한의 연결 경로부터 구성한 뒤 하나씩 확장하세요. 이렇게 하면 설정 간 간섭을 줄이고 문제를 추적하기 위한 명확한 시작점을 유지할 수 있습니다.
전체 가이드 보기 →생태계, 실행 코어, GUI의 역할을 구분하면 설정이 어느 계층에 적용되는지 파악하기 쉽습니다.
Project V는 네트워크 프록시 도구와 관련 기능을 중심으로 형성된 오픈 소스 프로젝트 생태계이며, V2Ray는 그중 널리 사용되는 핵심 프로젝트입니다. 일상적인 검색에서 'V2Ray 클라이언트'는 GUI 관리 프로그램을 가리키는 경우가 많지만, 기술 문서에서는 V2Ray가 실행 코어를 뜻할 수도 있습니다. 서로 다른 계층의 용어이므로 가이드를 읽을 때 문맥을 먼저 확인하세요.
코어는 보통 설정 파일로 인바운드, 아웃바운드 및 매칭 규칙을 정의합니다. GUI 클라이언트는 이러한 객체를 조작할 수 있는 입력란, 목록 및 메뉴로 보여줍니다. 따라서 인터페이스에 특정 버튼이 있다고 해서 모든 코어가 같은 JSON 설정을 지원하는 것은 아닙니다. 메뉴 위치를 외우기보다 이 차이를 이해해야 설정을 오래 안정적으로 관리할 수 있습니다.
V2Fly는 V2Ray의 커뮤니티 개발을 이어가고 있으며, Xray는 관련 생태계에서 분리되어 자체 기능을 발전시켰습니다. 두 코어는 일부 개념을 공유하지만 프로토콜 구현, 전송 옵션 및 설정 세부 사항은 다릅니다. REALITY, XTLS Vision 등의 기능을 사용한다면 클라이언트 이름에 V2Ray가 포함됐는지만 볼 것이 아니라 Xray의 지원 여부를 확인하세요.
'특정 프로토콜 지원'이 그 프로토콜의 모든 조합을 지원한다는 뜻은 아닙니다. 전송 방식, 보안 계층, 흐름 제어 옵션 및 코어 기능에 따라 사용 가능 여부가 달라집니다. 코어를 바꾼 뒤 오류가 발생하면 실행 중 연결을 점검하기 전에 파싱 단계의 메시지를 먼저 확인하세요. 설정 호환성 문제를 서버에 접근할 수 없는 문제로 오해하지 마세요.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 GUI 클라이언트로, 데스크톱 및 Android 환경에서 설정을 관리합니다. v2rayN은 여러 데스크톱 플랫폼용 인터페이스를 제공하고, v2rayNG는 Xray와 연동하며, v2flyNG는 V2Fly와 연동합니다. 운영체제를 먼저 확인하고 필요한 설정을 기준으로 선택하세요. 이름이 비슷하다는 이유로 중복 설치할 필요는 없습니다.
오픈 소스란 해당 라이선스에 따라 코드를 공개한다는 뜻입니다. 코드 복사, 수정 및 재배포 시 각 프로젝트와 의존 구성 요소의 라이선스 조건을 따라야 합니다. 클라이언트와 코어의 라이선스는 서로 다를 수 있으므로 모든 라이선스 정보를 하나의 포괄적인 표기로 대신할 수 없습니다. 클라이언트 프로그램은 무료로 사용할 수 있지만 서버 자원과 구독 서비스는 별개의 제공 항목입니다.
클라이언트 업데이트에는 인터페이스, 설정 생성 로직 또는 포함된 코어의 변경이 들어갈 수 있습니다. 구독 업데이트는 주로 서버 설정을 갱신하고, 규칙 데이터 업데이트는 도메인 및 주소 목록에 영향을 줍니다. 각 업데이트의 역할은 서로 다르므로 구독을 업데이트했다고 프로그램과 코어까지 업데이트된 것은 아닙니다. 문제를 진단하기 전에 실제 사용 환경을 기록해 두면 관련 설정 항목을 찾는 데 도움이 됩니다.
업데이트 전에 사용자 지정 라우팅, DNS 설정 및 구독 그룹 정보를 저장하세요. 업데이트 후에는 기존 연결이 정상인지 확인하고 사용자 지정 규칙이 계속 적용되는지 점검하세요. 매개변수 이름이나 기본값이 달라졌다면 현재 인터페이스와 해당 코어의 문서를 기준으로 확인하세요. 이 페이지에서는 객체별 참고 자료를 제공하고, 다운로드 페이지에서는 설치 옵션을 모아 안내하며, 설정 항목 페이지에서는 JSON 각 부분의 용도를 설명합니다.
필요한 내용에 따라 읽을 페이지를 선택하세요. 앱을 고를 때는 클라이언트 비교를, 처음 연결할 때는 가이드를, 특정 항목을 이해할 때는 설정 참고 자료를 확인하면 됩니다. 구독 업데이트가 실패하거나 시스템 프록시가 작동하지 않으면 먼저 문제가 발생한 단계를 파악한 다음 해당 문제 해결 안내를 살펴보세요. 서로 다른 계층의 문제를 한데 섞지 않는 것이 중요합니다.
코어 차이, 프로토콜 선택, Android 작동 방식까지 설정의 판단 기준을 설명합니다.
Xray가 Project V 생태계에서 분리된 배경을 살펴보고 XTLS Vision, REALITY 등 고유 기능과 V2Fly의 차이를 비교합니다. v2rayNG와 v2flyNG가 각각 어떤 코어를 사용하는지도 설명합니다.
글 읽기 →암호화 방식, 핸드셰이크 구조, TLS 의존성, 설정 복잡도라는 네 가지 기준으로 네 프로토콜을 비교하고 사용 환경에 맞는 선택 방법을 안내합니다.
글 읽기 →v2rayNG가 Android에서 VpnService를 사용하는 방식과 백그라운드 실행이 종료되지 않도록 배터리 최적화 예외를 설정하는 방법을 설명합니다. 앱별 프록시의 우회 및 프록시 전용 설정도 안내합니다.
글 읽기 →