Project V 생태계 · 클라이언트와 설정

V2Fly 공식 사이트클라이언트와 설정

구독 가져오기부터 라우팅까지, 플랫폼별 오픈 소스 클라이언트와 설정 방법을 확인하세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY

설정 메뉴

구독·라우팅·
프록시 모드를 한곳에서 설정

구독 그룹 및 필터 키워드

구독을 여러 개 사용한다면 먼저 그룹으로 나눈 뒤 업데이트하세요. v2rayN의 구독 그룹 설정에서 이름과 주소를 추가하고 저장한 다음 구독을 업데이트하면 됩니다. 필터 키워드는 서버 이름을 정리할 때 사용하며 원격 설정을 바꾸지는 않습니다. 업무용과 테스트용을 분리해 두면 나중에 구독 주소를 바꾸더라도 출처를 쉽게 구분할 수 있습니다. 서버 공유 링크를 하나씩 붙여 넣는 방식과 달리 구독은 서버 변경 사항을 계속 동기화하는 데 적합합니다. 업데이트 후 목록이 비어 있다면 필터를 지우고 주소가 만료되지 않았는지 확인하세요. 클라이언트를 반복해서 재설치할 필요는 없습니다.

그룹 및 필터 설정 보기 →
구독 그룹 설정
이름업무
필터 키워드서버 이름으로 필터링
저장한 뒤 업데이트구독 업데이트

설치 패키지 선택

플랫폼별 클라이언트 찾기

운영체제와 프로세서 아키텍처를 먼저 확인한 뒤 인터페이스와 코어를 선택하세요. 다운로드 페이지에서 플랫폼별 설치 파일을 확인할 수 있습니다.

전체 클라이언트 보기 →

Windows

v2rayN 추천

데스크톱 버전은 Avalonia 기반의 크로스 플랫폼 인터페이스를 사용하며, 클래식 WPF 버전은 별도의 화면 구성을 제공합니다. 처음 사용한다면 데스크톱 버전으로 시작하는 것이 좋습니다. WPF에 익숙하다면 두 인터페이스의 차이를 먼저 살펴보고 이전 여부를 결정하세요. 설치 파일을 고를 때는 파일명에 클라이언트 이름이 있는지만 보지 말고 운영체제 요구 사항과 프로세서 아키텍처도 확인해야 합니다.

설치 후 구독 그룹 설정에서 구독 주소를 저장하고 업데이트한 다음 서버를 선택하세요. 시스템 프록시 자동 설정을 켜고 브라우저에서 연결을 테스트합니다. 코어가 시작되지 않으면 로그에서 포트 충돌과 설정 오류를 확인하세요. TUN은 추가 권한이 필요하므로 일반 프록시 연결이 정상인지 확인한 뒤 별도로 켜는 것이 좋습니다.

macOS

v2rayN

Apple Silicon 기기는 arm64, Intel 기기는 x64를 선택하세요. Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인할 수 있습니다. 디스크 이미지를 다운로드한 뒤 안내에 따라 응용 프로그램 폴더에 설치하고, 임시로 마운트한 위치에서 계속 실행하지 않도록 해당 폴더에서 앱을 시작하세요.

처음 실행할 때 운영체제의 보안 경고가 표시되면 앱 출처를 확인한 후 시스템 설정에서 제공하는 허용 절차를 따르세요. 앱을 실행하려고 시스템 보호 기능 전체를 끄면 안 됩니다. 구독을 설정한 뒤 시스템 프록시와 DNS 동작을 각각 확인하세요. 종료 후에도 브라우저가 연결되지 않으면 네트워크 설정에 로컬 프록시 주소가 남아 있는지 확인한 뒤 클라이언트를 다시 시작해 포트가 정상적으로 열려 있는지 살펴보세요.

Android

v2rayNG 추천

Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. v2fly 코어가 필요하다면 대체 옵션인 v2flyNG를 확인할 수 있습니다. 비교적 최신 스마트폰은 대부분 arm64를 사용합니다. 아키텍처를 모르겠다면 기기 정보를 먼저 확인하세요. 범용 패키지는 더 다양한 아키텍처를 지원할 뿐, 연결 성능이 더 뛰어나다는 뜻은 아닙니다.

구독 설정에서 이름과 주소를 추가한 뒤 메인 화면으로 돌아가 구독을 업데이트하고 서버를 선택해 연결을 시작하세요. 운영체제에서 표시되는 VPN 연결 요청은 로컬 트래픽을 처리하기 위한 통로를 만드는 절차이며, 구독이 정상적으로 작동한다는 뜻은 아닙니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화 설정과 백그라운드 실행 권한을 확인하세요. 앱별 라우팅을 설정할 때는 앱이 프록시 대상 목록에 포함되는지, 우회 목록에 포함되는지 구분해 방향을 혼동하지 않도록 하세요.

Linux

v2rayN

배포판의 패키지 형식에 따라 deb 또는 rpm을 선택하고 x64와 arm64를 구분하세요. Debian 및 Ubuntu 계열은 보통 deb, Fedora 등은 보통 rpm을 사용합니다. 다운로드 페이지에서 아키텍처별 설치 파일을 확인할 수 있습니다. 설치 중 패키지 관리자가 표시하는 의존성 안내를 확인하고 아키텍처가 다른 패키지를 함께 설치하지 마세요.

데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다르며, 명령줄 프로그램은 데스크톱 프록시 설정을 사용하지 않을 수도 있습니다. 먼저 클라이언트의 로컬 포트가 열려 있는지 확인한 다음 각 앱에서 프록시 주소를 지정하세요. TUN을 사용하려면 권한과 라우팅 변경 사항을 확인하고, 데스크톱 세션 전체를 높은 권한으로 장시간 실행하지 마세요. 연결 문제가 생기면 앱이 프록시를 사용하지 않는 문제인지 코어의 아웃바운드 연결 실패인지 구분한 뒤 해당 설정을 수정해야 합니다.

코어와 오픈 소스 생태계

클라이언트, 코어, 프로토콜

세 가지 역할을 구분하세요. 인터페이스는 설정을 관리하고 코어는 설정에 따라 연결하며 프로토콜은 통신 방식을 정합니다.

Project VV2FlyXray

Project V와 V2Fly의 관계

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 그중 핵심 소프트웨어 중 하나입니다. V2Fly 커뮤니티는 V2Ray 관련 코어 개발과 문서 작업을 이어가고 있습니다. 일상적인 대화에서 ‘V2Ray’는 관련 클라이언트를 통칭하는 말로도 쓰이지만, 데스크톱에 설치하는 v2rayN은 코어 자체가 아닙니다. 각 이름의 차이를 알아야 가이드에서 말하는 ‘클라이언트 업데이트’와 ‘코어 변경’이 무엇을 바꾸는지 이해할 수 있습니다.

그래픽 클라이언트는 보통 구독, 서버 목록, 라우팅 템플릿, 시스템 설정을 관리하고 정리된 설정을 코어에 전달합니다. 따라서 인터페이스에 특정 항목이 보인다는 사실만으로 현재 코어가 해당 기능을 지원한다고 단정할 수 없습니다. 실제 사용 전에는 선택한 코어, 서버 요구 사항, 클라이언트가 생성한 설정을 함께 확인하세요. 문제를 진단할 때 이 세 가지를 먼저 기록해 두면 소프트웨어 전체를 바꾸는 것보다 정확하게 원인을 찾을 수 있습니다.

Xray와 V2Fly의 기능은 동일하지 않습니다

Xray는 관련 코드 기반에서 발전한 별도의 코어 계열입니다. 두 계열은 일부 개념을 공유하지만 각기 다른 방향으로 발전하고 있습니다. VMess, VLESS, 전송 계층, 보안 계층을 구분해 이해해야 합니다. REALITY는 보안 관련 기술이지 모든 프록시 프로토콜과 나란히 놓을 수 있는 독립적인 서버 유형이 아닙니다. 설정이 작동하는지는 공유 링크를 인터페이스가 인식하는지만 볼 것이 아니라 실제 조합을 확인해야 합니다.

XTLS 또는 REALITY를 사용하는 설정은 Xray의 해당 구현 요구 사항을 기준으로 확인하세요. 코어마다 설정 항목, 기본값, 동작이 완전히 같다고 보장할 수 없습니다. 이전하기 전에는 기존 설정을 보관하고 지원 여부가 명확한 연결 하나를 테스트한 뒤 로그에서 알 수 없는 항목, 전송 방식 불일치, 핸드셰이크 오류가 있는지 살펴보세요. 이 문서의 설정 창은 인바운드와 라우팅 항목을 보여주는 예시일 뿐, 그대로 실행할 수 있는 완전한 설정이 아닙니다.

세 클라이언트의 오픈 소스 범위

v2rayN은 데스크톱용으로 그래픽 인터페이스에서 서버, 구독, 라우팅을 관리합니다. v2rayNG는 Android용이며 일반적인 배포판은 Xray 코어를 사용합니다. v2flyNG는 v2fly 코어 기반의 Android 사용 경로를 제공합니다. 세 클라이언트 모두 오픈 소스이지만 이름이 비슷하다고 인터페이스 기능, 코어 지원, 플랫폼 권한까지 같다고 볼 수는 없습니다.

오픈 소스 소프트웨어는 각 프로젝트의 라이선스 조건에 따라 코드를 읽고 사용하거나 재배포할 수 있다는 뜻이지, 모든 구성 요소가 같은 라이선스를 따른다는 뜻은 아닙니다. 그래픽 인터페이스, 코어, 규칙 데이터는 각각 살펴봐야 합니다. 클라이언트는 구독 서비스가 아닙니다. 소프트웨어를 설치해도 사용할 수 있는 서버가 자동으로 만들어지지 않으며, 구독의 유효 기간과 내용, 사용 권한은 제공자가 정합니다. 클라이언트를 선택할 때는 먼저 현재 설정에 필요한 프로토콜을 확인하고 플랫폼과 사용 방식에 맞는 제품을 고르세요.

클라이언트·코어·구독 업데이트

클라이언트 업데이트는 주로 인터페이스, 설정 관리, 플랫폼 호환성에 영향을 줍니다. 코어 업데이트는 프로토콜 구현과 실행 동작을 바꾸며 구독 업데이트는 원격 서버 정보를 다시 가져옵니다. 세 작업은 서로 다른 대상을 처리합니다. 구독이 만료된 경우 인터페이스를 재설치해도 해결되지 않으며, 인터페이스 오류가 구독 업데이트로 고쳐지지도 않습니다. 먼저 문제가 발생한 계층을 파악한 뒤 해당 작업을 진행하세요.

업데이트 전 필요한 설정을 저장하고 현재 코어 선택, 라우팅 모드, 로컬 수신 포트를 기록하세요. 업데이트 후에는 기본 연결을 테스트한 다음 사용자 지정 규칙과 TUN을 다시 설정합니다. 구독을 업데이트하면 제공 서버의 매개변수가 덮어써질 수 있으므로 계속 사용할 수동 설정은 구독 그룹과 분리해 관리하세요. 구독 주소, 공유 링크, 전체 설정에는 접속 정보가 포함될 수 있으니 공개 스크린샷이나 문제 해결 기록에 그대로 올리지 마세요.

데이터 흐름 순서에 따라 설정 문제 진단

연결 과정을 앱, 인바운드, 라우팅, 아웃바운드, 원격 서버 단계로 나눠 살펴보세요. 브라우저가 시스템 프록시를 사용하지 않는다면 앱에서 인바운드까지의 문제입니다. 포트 충돌은 로컬 수신 문제이고, 요청이 잘못된 태그로 전달되면 라우팅 문제입니다. 원격 서버와 매개변수가 맞지 않는다면 아웃바운드와 서버 설정을 확인해야 합니다. DNS는 도메인 확인과 규칙 매칭에도 영향을 줄 수 있으므로 마지막에만 확인해서는 안 됩니다.

한 번에 하나의 설정만 변경하고 변경 전후의 로그를 보관하세요. 먼저 서버 설정으로 연결할 수 있는지 확인하고, 그다음 분할 라우팅 규칙을 검증한 후 투명 프록시를 설정합니다. 웹페이지가 열린다는 사실은 해당 요청이 완료됐다는 뜻일 뿐, 모든 프로그램과 도메인, 전송 방식이 예상한 경로를 사용한다는 의미는 아닙니다. 동작을 구체적으로 확인하려면 트레이 아이콘만 볼 것이 아니라 클라이언트 로그와 앱 자체의 프록시 설정을 함께 확인하세요.

설정 전 확인할 네 가지 질문

구독 주소와 공유 링크는 서로 바꿔 쓸 수 있나요?
같은 입력이라고 볼 수 없습니다. 구독은 보통 여러 서버 목록을 반환하고, 단일 공유 링크는 한 연결 정보를 담습니다. 전체 설정에는 라우팅과 DNS 정보가 포함될 수도 있습니다. 먼저 데이터 형식을 확인한 다음 알맞은 가져오기 메뉴를 선택하세요. 구독 및 노드 용어 알아보기 →
글로벌 프록시와 TUN은 같은 스위치인가요?
아닙니다. 글로벌은 보통 코어에 들어온 트래픽을 어디로 보낼지 정하는 정책이고, TUN은 트래픽을 어떻게 가로채는지를 나타냅니다. TUN을 켜도 규칙에 따라 트래픽을 분할할 수 있습니다. 앱이 프록시 경로에 들어오지 않았다면 글로벌 정책만 바꿔서는 해당 앱의 트래픽을 처리할 수 없습니다. 프록시 모드 용어 알아보기 →
가져오기는 성공했는데 왜 연결되지 않나요?
가져오기에 성공했다는 것은 클라이언트가 입력을 받아들였다는 뜻일 뿐입니다. 설정이 완전한지, 코어가 지원하는지, 원격 서버가 유효한지, 시간과 네트워크 환경이 연결 조건에 맞는지 확인해야 합니다. 먼저 로그를 살펴보고 모든 오류를 구독 형식 문제로 단정하지 마세요. 프로토콜 및 전송 용어 알아보기 →
규칙의 direct, proxy, block은 고정된 프로토콜 이름인가요?
이 이름들은 아웃바운드 태그로 자주 사용되며 실제 아웃바운드 정의와 일치해야 합니다. 이름만 입력한다고 아웃바운드가 자동으로 만들어지지는 않습니다. 규칙을 복사할 때는 참조 관계와 기본 경로도 함께 확인하세요. 라우팅 및 분할 규칙 용어 알아보기 →

설정 기록

최신 기술 문서

코어 호환성부터 데스크톱 인터페이스 선택과 시작 로그 확인까지, 필요한 주제를 이어서 살펴보세요.

전체 문서 보기 →