Project V 생태계의 GUI 클라이언트

V2Ray 공식 사이트 포털 v2rayN 클라이언트 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 오픈 소스 클라이언트를 시작으로 구독 가져오기와 분할 라우팅을 설정할 수 있습니다.

무료 사용 오픈 소스 한국어 설정 가이드

클라이언트 구성 및 연결 절차

먼저 구성을 가져온 다음 트래픽이 들어오는 경로와 나가는 경로를 확인하세요. 아래는 설정 구조를 보여 주는 예시이며, 실제 메뉴 이름은 사용하는 클라이언트에 따라 다를 수 있습니다. 현재 연결 상태를 나타내는 화면은 아닙니다.

v2rayN / 구독 그룹 설정
구독 주소서비스 제공자가 제공
가져오기 방법구독 그룹 → 추가
다음 단계구독 업데이트 → 구성 선택
구성 구조 예시
{"outbounds":[{"tag":"proxy",
"protocol":"vless"}]}

구독 주소와 단일 노드 링크 구분하기

구독은 여러 구성을 한꺼번에 가져올 때 사용하고, 공유 링크는 보통 하나의 노드 정보만 담습니다. 먼저 신뢰할 수 있는 출처인지 확인한 뒤 구독 그룹에 주소를 저장하고 업데이트하세요. 공유 링크를 복사한 경우에는 클립보드에서 가져오기 기능을 사용해야 합니다. 업데이트가 끝나면 프로토콜, 전송 방식, 보안 매개변수가 모두 포함됐는지 확인하고 사용할 구성을 선택하세요. GUI 클라이언트는 이 항목들을 목록으로 정리해 일상적인 관리에 편리합니다. 코어를 직접 실행한다면 구성 파일을 직접 관리해야 합니다. 구독 주소에는 접근 정보가 포함되는 경우가 많으므로 스크린샷이나 문의용 로그를 공유할 때 민감한 부분을 가리세요.

4개 플랫폼 클라이언트 다운로드

먼저 운영체제를 선택한 다음 프로세서 아키텍처와 설치 형식을 고르세요. 다운로드 센터에서 설치 파일을 확인할 수 있으며, 홈페이지에서는 설치 파일을 직접 제공하지 않습니다.

Windows

v2rayN 데스크톱 버전과 클래식 WPF 버전

데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하고, WPF 버전은 클래식한 데스크톱 사용 방식을 유지합니다. 인터페이스 선호도에 따라 선택할 수 있으며, 다운로드 센터에서 시스템 요구 사항을 먼저 확인하세요. 처음 사용할 때는 설정 저장에 필요한 권한이 차단되지 않도록 쓰기 가능한 폴더에 프로그램을 설치하세요.

macOS

v2rayN · Apple Silicon / Intel

먼저 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 알맞은 아키텍처를 선택하세요. 설치 후 앱이 실행되는지, 코어가 작동하는지 확인하고 시스템 프록시를 설정합니다. 시스템에서 출처 확인을 요청하면 다운로드 출처와 안내 내용을 검토하세요. 보안 보호 기능을 통째로 끄지 마세요.

Android

v2rayNG 우선, v2flyNG 대안

대부분의 최신 기기는 arm64 다운로드 항목부터 확인하면 됩니다. 아키텍처를 모르겠다면 범용 버전 안내를 읽어 보세요. 처음 연결할 때는 시스템 VPN 권한을 승인해야 하며, 다른 VPN이 연결되어 있다면 먼저 충돌을 해결하세요. 백그라운드에서 연결이 끊기면 배터리 최적화, 앱 백그라운드 권한, 네트워크 전환 동작을 확인하세요.

Linux

v2rayN · deb / rpm

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 다음 기기가 x64인지 arm64인지 확인하세요. GUI 클라이언트 설치와 데스크톱 트래픽 처리는 별개의 단계입니다. 코어가 정상적으로 실행되더라도 앱에서 시스템 프록시나 자체 프록시를 설정해야 할 수 있습니다. 창이 열렸다는 이유만으로 연결이 완료된 것은 아닙니다.

설치, 구독, 연결은 각각 별개의 단계입니다

클라이언트는 설정을 관리하는 인터페이스를 제공하지만, 바로 사용할 수 있는 원격 연결 서비스가 포함되어 있지는 않습니다. 다운로드와 설치를 마친 뒤에도 신뢰할 수 있는 서비스 제공자나 직접 구축한 서버에서 유효한 구성을 받아야 합니다. 구독 업데이트가 성공하고 사용할 구성을 선택한 뒤 로컬 트래픽 경로가 작동해야 앱 요청이 예상한 경로로 전송됩니다. 이 세 단계를 따로 확인하면 구독이 만료됐을 때 프로그램을 반복해서 재설치하거나 시스템 프록시 미적용을 서버 문제로 오인하는 일을 줄일 수 있습니다.

처음 설치할 때는 기본 수신 주소를 유지하고 필요한 항목만 변경하는 것이 좋습니다. 다른 프록시 프로그램을 사용 중이라면 현재 포트와 시스템 프록시 상태를 기록하고, 여러 프로그램이 같은 설정을 동시에 변경하지 않도록 하세요. 기본 연결을 확인한 후 사용자 지정 라우팅, DNS, 앱별 분할 설정을 하나씩 추가하세요. 한 번에 한 종류만 바꾸면 문제가 생겼을 때 되돌릴 항목을 정확히 찾을 수 있습니다.

전체 클라이언트 보기 →

Project V 오픈 소스 생태계

프로젝트, 코어, 클라이언트를 구분하면 다운로드 이름과 설정 항목을 이해하기 쉽습니다. 사이트 이름은 다운로드와 문서 탐색에 쓰이며, 독립된 오픈 소스 프로젝트를 사이트가 개발했다는 뜻은 아닙니다.

생태계의 발전: 코어 기능에서 GUI 도구까지

Project V는 V2Ray 관련 도구를 이해하는 데 필요한 배경입니다. 초기에는 코어와 구성 파일을 중심으로 사용했지만, 점차 데스크톱과 모바일용 GUI 클라이언트가 등장했습니다. 코어는 네트워크 연결을 처리하고, 클라이언트는 구독과 노드, 라우팅, 로컬 프록시 설정을 다루기 쉬운 화면으로 구성합니다. ‘V2Ray 공식 사이트’를 검색하면 프로젝트명, 코어명, 클라이언트명이 함께 표시되는 경우가 많습니다. 이들은 서로 다른 계층을 가리키며, 하나의 설치 프로그램을 다르게 부르는 이름이 아닙니다.

코어 종류: 호환 여부는 전체 구성을 확인하세요

V2Fly는 V2Ray 코어의 커뮤니티 개발을 이어 가고 있으며, Xray는 관련 코드 기반에서 발전한 별도의 코어 계열입니다. 두 코어는 공통된 기술적 배경을 갖지만 기능의 발전 방향과 지원하는 매개변수는 완전히 같지 않습니다. VMess와 VLESS는 프로토콜 이름이고, WebSocket은 전송 방식과 관련된 선택지이며, TLS와 REALITY는 연결 보안 설정에 해당합니다. 프로토콜 이름만으로 호환성을 판단할 수는 없습니다. 서버 측 요구 사항을 항목별로 확인하고, 모든 클라이언트가 모든 공유 링크를 지원한다고 가정하지 마세요.

클라이언트 역할: 데스크톱 관리와 모바일 트래픽 처리

v2rayN은 데스크톱 플랫폼용으로 구독 관리, 사용할 구성 전환, 라우팅 설정에 적합합니다. v2rayNG는 Android용이며, 구성을 가져온 뒤 시스템 VPN 인터페이스로 관련 트래픽을 처리하는 방식이 일반적입니다. v2flyNG는 V2Fly 코어 기반의 Android 대안을 제공합니다. 세 클라이언트 모두 오픈 소스 GUI 클라이언트지만 메뉴와 구성 내보내기 형식, 플랫폼 권한은 서로 다릅니다. 이름이 비슷하다는 이유만으로 앱을 바꾸기보다 기기와 구성 요건을 먼저 고려하세요.

오픈 소스 라이선스: 코드 공개와 서비스 출처는 별도로 확인

관련 클라이언트와 코어는 각자의 오픈 소스 라이선스에 따라 배포되며, 라이선스는 코드 사용, 수정, 재배포 조건을 규정합니다. 클라이언트와 코어가 서로 다른 라이선스를 사용할 수도 있으므로 구체적인 범위는 해당 프로젝트의 라이선스 문서를 확인하세요. 코드가 공개되어 있으면 커뮤니티에서 검토하고 기여할 수 있지만, 구독 서비스와 원격 서버, 로컬 권한의 신뢰성을 대신 판단해 주지는 않습니다. 설치 프로그램 다운로드, 연결 구성 수신, 트래픽 처리 권한 부여는 각각 별개의 신뢰 단계이므로 하나씩 확인해야 합니다.

업데이트 방식: 프로그램, 코어, 규칙은 따로 바뀝니다

클라이언트 업데이트에는 인터페이스, 가져오기 호환성, 시스템 통합 변경이 포함될 수 있고, 코어 업데이트는 프로토콜 처리에 영향을 줄 수 있습니다. 라우팅 규칙 데이터가 바뀌면 도메인과 IP 분류 결과가 달라집니다. 구독 업데이트는 보통 원격 구성을 다시 가져오는 작업이며, 위 구성 요소가 모두 업데이트된다는 뜻은 아닙니다. 업그레이드 전에 현재 설정을 저장하고 변경 사항을 확인한 뒤 자주 사용하는 사이트와 앱을 다시 테스트하세요. 문제가 다시 발생하면 설정을 모두 초기화하기보다 어떤 업데이트 단계에서 생겼는지 기록하는 것이 원인을 찾는 데 도움이 됩니다.

백업할 때도 내용을 구분하세요. 공유 링크에는 연결 매개변수가 저장될 수 있고, 클라이언트 구성 백업에는 구독 인증 정보와 그룹 정보, 로컬 경로까지 포함될 수 있습니다. 다른 기기로 옮길 때 백업 파일을 공개된 곳에 올리지 마세요. 다른 사람에게 도움을 요청하려면 주소에 포함된 인증 정보와 사용자 식별자, 인증 항목을 먼저 가리세요. 문서의 구성 예시를 사용할 때도 각 항목의 역할을 이해하고 일부 예시를 완전한 실행 구성으로 간주하지 마세요.

처음 사용할 때 자주 묻는 질문

구성 출처, 트래픽 진입 경로, 라우팅 출구 순서로 확인하세요. 각 단계의 결과를 기록해야 다음 단계를 판단할 근거가 생깁니다.

클라이언트를 설치했는데 왜 연결할 수 없나요?

설치는 도구를 준비하는 단계일 뿐입니다. 유효한 구독이나 공유 링크를 가져오고 사용할 구성을 선택한 다음 코어가 정상적으로 시작됐는지 확인해야 합니다. 데스크톱에서는 시스템 프록시나 앱 프록시를, Android에서는 VPN 권한을 확인하세요. 여러 변수를 한꺼번에 점검하지 말고 먼저 브라우저 하나의 요청이 정상적으로 전송되는지 확인한 뒤 다른 앱으로 범위를 넓히세요. 자세한 순서는 입문 가이드를 참고하세요.

구독을 가져오는 데 성공하면 노드를 바로 사용할 수 있나요?

가져오기에 성공했다는 것은 클라이언트가 응답에서 구성을 인식했다는 뜻일 뿐, 원격 서비스에 현재 접속할 수 있다는 의미는 아닙니다. 구독 유효 기간과 사용할 구성, 시스템 시간, 연결 로그를 계속 확인하세요. 응답이 로그인 페이지나 오류 안내라면 브라우저에서 주소가 열려도 유효한 구독 내용이 아닙니다. 전체 구독 주소를 공개하지 말고 가이드의 가져오기 절차에 따라 입력 위치를 다시 확인하세요.

시스템 프록시를 켰는데 왜 일부 앱에서만 작동하나요?

일부 앱은 시스템 프록시를 따르지 않거나 자체 프록시 설정을 사용할 수 있습니다. 브라우저 확장 프로그램, 앱 내 프록시, 시스템 프록시가 동시에 설정되어 있으면 서로 다른 포트를 가리킬 수도 있습니다. 먼저 로컬 수신과 브라우저 접속을 확인한 다음 대상 앱의 네트워크 설정을 점검하세요. 직접 연결 또는 프록시 모드는 코어에 전달된 요청의 경로만 결정하며, 코어에 들어오지 않은 요청까지 규칙으로 제어하지는 않습니다. 증상에 따라 문제 해결을 참고하세요.

연결 후 DNS 문제가 발생하면 어떤 설정부터 확인해야 하나요?

먼저 실패한 도메인, 시스템 조회 결과, 클라이언트 로그를 기록한 다음 DNS 조회 실패인지 연결 실패인지 구분하세요. 브라우저의 보안 DNS, 시스템 DNS, 코어 DNS가 서로 다른 경로를 사용할 수 있으므로 한 곳만 바꿔도 모든 요청이 달라지지는 않습니다. 현재 설정을 보존하고 한 번에 한 항목씩 조정하세요. 예상대로 직접 연결되는 대상과 프록시를 거치는 대상을 함께 테스트해 한 사이트를 해결하는 과정에서 다른 규칙이 바뀌지 않도록 하세요. 다음 단계는 DNS 및 라우팅 문제 해결 안내를 참고하세요.

구성 및 배포 문서

첫 실행부터 링크 형식, 라우팅 배포까지 궁금한 주제별로 확인하세요. 먼저 GUI 클라이언트의 기본 연결을 설정한 뒤 더 복잡한 네트워크 트래픽 처리 방식을 검토하세요.

전체 문서 보기 →