Project V 오픈 소스 클라이언트

v2rayN 공식 사이트 · V2Ray 클라이언트 다운로드 및 설정

기기에 맞춰 데스크톱 클라이언트 또는 안드로이드 클라이언트를 선택한 다음, 가이드를 따라 구독을 가져오고 라우팅과 DNS를 설정하세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

설정 구성

v2rayN 코어 설정

구독은 서버 목록의 출처를 정하고, 시스템 프록시 또는 TUN은 어떤 트래픽을 클라이언트로 보낼지 결정합니다. 라우팅은 그 트래픽의 경로를 정합니다. 문제가 생기면 세 계층을 나눠 확인하는 편이 모든 설정을 한꺼번에 초기화하는 것보다 원인을 찾기 쉽습니다.

출처별 구독 추가

구독 분류 → 구독 분류 설정 → 추가

출처가 다른 구독은 각각 저장하고, 알아보기 쉬운 별칭을 지정하세요. 업데이트 전에는 대상 그룹을 선택한 뒤 현재 구독 업데이트를 실행하고, 전체 구독을 새로고침해야 할 때만 모두 업데이트하세요. 서버를 하나씩 붙여 넣는 방식과 달리 구독을 업데이트하면 출처에서 목록을 다시 가져오므로 수동으로 수정한 항목이 덮어써질 수 있습니다. 계속 보관할 수동 설정은 별도로 저장하세요. 업데이트에 실패하면 다운로드 오류인지, 내용을 해석하지 못한 것인지 먼저 확인한 뒤 설정을 조정하세요.

구독 및 서버 필터링 안내

플랫폼 및 설치 파일

기기에 맞는 클라이언트 선택

데스크톱에서는 v2rayN을 사용하세요. 안드로이드에서는 필요한 코어에 따라 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드하기 전에 기기의 프로세서 아키텍처를 확인하세요. 같은 클라이언트라도 설치 파일에 따라 지원하는 칩이나 설치 방식이 다를 수 있습니다.

다운로드 페이지에는 v2rayN 데스크톱 버전과 클래식 WPF 버전이 별도로 제공됩니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용합니다. 기존 사용 방식에 익숙하거나 이전 버전 가이드를 참고하는 중이라면 클래식 WPF 버전 안내를 확인하세요. 두 버전은 메뉴 위치가 다를 수 있으므로 화면을 하나씩 대조하기보다는 구독 그룹, 라우팅, 시스템 프록시 등 기능 이름으로 찾아보세요.

다운로드 전에 「설정 → 시스템 → 정보」에서 시스템 유형을 확인하세요. 처음 연결할 때는 서버 하나를 선택하고 시스템 프록시를 읽는 브라우저에서 연결을 테스트하면 됩니다. 다른 앱의 트래픽까지 처리해야 한다면 TUN을 고려하세요. 종료한 뒤에도 시스템이 로컬 프록시에 연결하려고 하면 시스템 프록시 설정이 복구됐는지 확인하세요.

「이 Mac에 관하여」에서 칩 또는 프로세서를 확인하세요. Apple 칩이면 arm64, Intel 프로세서면 x64를 선택합니다. 두 설치 파일은 아키텍처가 다르므로 시스템 이름만 보고 고르면 안 됩니다. 설치한 다음 클라이언트를 실행해 기본 화면이 열리는지 확인하고 구독을 가져오세요.

앱이 열리지 않는 문제와 앱은 열리지만 프록시를 설정할 수 없는 문제는 서로 다릅니다. 전자는 시스템에 표시되는 앱 실행 안내를 확인하고, 후자는 네트워크 관련 권한과 프록시 설정을 점검하세요. 관리 대상 기기에서는 시스템 정책에 따라 설정이 제한될 수 있으므로 이를 설치 파일 선택 오류로 오해하지 마세요.

Xray 코어가 필요하면 v2rayNG를, V2Fly 설정을 기준으로 사용하려면 v2flyNG를 선택하세요. 시스템이 arm64를 지원하는지 확인한 뒤 해당 설치 파일을 고르고, 확실하지 않으면 범용 버전을 확인하세요. 설치 파일의 아키텍처는 기기에 설치할 수 있는지를 결정하고, 코어 선택은 구독의 프로토콜과 전송 설정을 처리할 수 있는지를 결정합니다.

시스템에서 설치 충돌이 표시되면 업데이트 대상이 같은 앱인지, 안내된 충돌 원인이 무엇인지 먼저 확인하세요. 삭제 후 재설치를 고려한다면 구독과 로컬 설정을 복구할 수 있는지 점검하세요. VPN 권한을 처음 요청할 때는 다른 앱이 이미 해당 연결을 사용 중인지도 확인해야 합니다.

배포판에 맞는 패키지 형식을 선택하세요. Debian과 Ubuntu는 보통 deb, Fedora와 openSUSE는 보통 rpm을 사용합니다. 그런 다음 시스템 아키텍처에 따라 x64와 arm64 중에서 고르세요. 패키지 형식이 맞아도 필요한 의존성이 모두 설치된 것은 아닙니다. 설치 프로그램에서 구성 요소가 없다고 알리면 먼저 의존성을 해결하고 데스크톱 메뉴에 실행 항목이 생겼는지 확인하세요.

이 가이드는 그래픽 데스크톱 환경을 기준으로 합니다. 창은 열리지만 앱이 프록시를 사용하지 않는다면 현재 데스크톱 환경에 시스템 프록시 설정이 적용됐는지, 대상 앱이 해당 설정을 읽는지 확인하세요. 브라우저에서 테스트에 성공해도 다른 앱이 같은 설정을 따른다고 단정할 수는 없습니다.

기기를 바꿀 때 가져갈 설정

이전하기 전에 구독 주소, 직접 추가한 서버, 기기별 설정을 구분하세요. 새 기기에는 구독 주소를 다시 추가하면 됩니다. 구독과 별개로 추가한 서버 기록은 따로 저장해야 합니다. 시스템 프록시, 가상 네트워크 어댑터, 앱별 트래픽 분기는 기존 기기에 종속될 수 있으므로 새 기기에서 다시 확인하세요. 백업에 구독 링크나 연결 정보가 포함됐다면 공개용 문제 해결 스크린샷과 분리해 보관하세요.

새 기기에서는 먼저 최소한의 설정만 구성하세요. 구독 하나를 가져오고, 정상 작동이 확인된 서버 하나와 연결 모드 하나로 테스트합니다. 기본 연결이 확인된 다음 사용자 지정 DNS와 라우팅 규칙을 복원하세요. 기본 설정에서도 연결되지 않으면 이전 설정 전체를 그대로 적용해 보기보다 아키텍처, 코어, 권한부터 확인하세요.

생태계 및 유지 관리

Project V, V2Fly, Xray

클라이언트는 설정 화면과 구성을 관리하고, 코어는 연결을 만들고 라우팅 규칙을 실행합니다. 두 계층의 프로젝트는 각각 별도로 배포될 수 있습니다. 연결 문제가 생기면 화면에서 설정을 찾는 방법뿐 아니라 실제로 어떤 코어가 처리하는지도 알아야 합니다.

Project V 생태계의 역할

Project V는 초기 프로젝트 생태계를 가리키며, V2Ray는 그 안의 핵심 프록시 프로그램입니다. 기존 프로젝트를 커뮤니티가 이어받으면서 V2Fly가 V2Ray의 유지 관리와 배포를 이어갔고, Xray는 관련 코드 기반에서 갈라져 독립적으로 발전했습니다. 오늘날 클라이언트에서 보이는 이름은 생태계 전체를 가리킬 수도, 실제 실행 중인 특정 코어를 가리킬 수도 있으므로 가이드를 읽을 때 문맥을 살펴 구분해야 합니다.

그래픽 클라이언트는 구독 항목을 선택 가능한 서버 설정으로 정리하고 라우팅 및 네트워크 모드를 코어가 사용할 수 있는 설정으로 변환합니다. 서버 목록이 보이지 않는다면 먼저 가져오기나 업데이트 상태를 확인하세요. 목록에서 항목을 선택할 수 있지만 코어가 시작되지 않는다면 같은 주소를 다시 가져오기보다 로그부터 확인하는 것이 좋습니다.

코어와 프로토콜의 호환 범위

V2Fly와 Xray가 특정 설정에 적합한지 판단하려면 프로토콜, 전송 방식, 연결 보안 방식을 함께 확인해야 합니다. VMess, VLESS, Trojan은 프로토콜 이름이고 WebSocket은 전송 방식이며 REALITY는 연결 보안 방식입니다. 목록에 표시된 프로토콜 약어만으로 나머지 설정 항목까지 지원되는지 판단할 수는 없습니다.

예를 들어 서버에서 VLESS와 REALITY, 특정 flow 조합을 요구한다면 전체 조합을 지원하는 코어를 사용하고 서버 측 매개변수에 맞게 설정해야 합니다. 프로토콜 메뉴만 VLESS로 바꾸는 것으로는 충분하지 않습니다. 설정 전체를 옮길 때는 DNS와 아웃바운드 항목도 확인하세요. 연결 매개변수가 호환된다고 해서 사용자 지정 라우팅까지 그대로 사용할 수 있는 것은 아닙니다.

세 오픈 소스 클라이언트의 특징

v2rayN은 GPL-3.0으로 배포되는 데스크톱 그래픽 클라이언트로 구독 관리, 코어 선택, 라우팅 및 네트워크 모드 설정을 지원합니다. v2rayNG와 v2flyNG는 각각 Xray와 V2Fly를 대상으로 하는 오픈 소스 안드로이드 클라이언트입니다. 이 클라이언트들은 기기의 연결 설정을 처리하며 구독이나 원격 서버를 제공하지 않습니다.

라이선스를 확인할 때는 클라이언트와 함께 사용하는 코어 및 구성 요소를 구분해야 합니다. 클라이언트의 오픈 소스 라이선스는 해당 코드에 적용되는 조건을 설명하며, 코어와 다른 구성 요소의 라이선스는 각각 확인해야 합니다. 클라이언트를 무료로 사용할 수 있다는 사실이 원격 서비스를 이용할 권리를 뜻하지는 않습니다. 원격 서비스 이용 조건은 실제 서비스 제공자가 정합니다.

클라이언트, 코어 및 구독 업데이트

클라이언트 업데이트는 화면과 플랫폼 지원을 바꿀 수 있고, 코어 업데이트는 설정 항목과 프로토콜 지원에 영향을 줄 수 있습니다. 구독을 새로고침하면 서버에서 제공하는 목록을 다시 가져옵니다. 세 업데이트는 서로 독립적입니다. 구독 업데이트에 성공해도 프로그램이 업그레이드된 것은 아니며, 같은 클라이언트라도 출처가 다른 구독이 똑같이 작동한다고 보장할 수 없습니다.

업데이트 전에 사용 중인 코어, 라우팅 방식, 연결 모드를 기록하세요. 업데이트 후에는 기존에 정상 작동하던 기능 하나를 다시 테스트하고 사용자 지정 설정을 활성화하세요. 구독 새로고침 직후 문제가 생겼다면 해당 그룹의 설정 변경 사항을 먼저 비교하고, 프로그램 업그레이드 후 문제가 생겼다면 설정 이전이나 코어 시작 안내를 확인하세요.

사용 팁

코어 선택 및 프로토콜 가이드

안드로이드 클라이언트를 고르는 중이라면 먼저 Xray와 V2Fly의 차이를 확인하세요. 어떤 이름이 그래픽 클라이언트인지 코어인지 헷갈린다면 생태계 관계를 살펴보세요. REALITY 설정을 받았다면 보안 방식과 flow 항목을 함께 확인해 서로 다른 설정을 혼동하지 않도록 하세요.

· 프로토콜 심화

REALITY와 XTLS Vision 원리: VLESS 전송 방식은 왜 더 빠를까?

핸드셰이크 흐름도로 REALITY가 대상 사이트의 TLS 특성을 활용하는 방식을 설명합니다. XTLS Vision이 중복 암호화를 줄이는 원리와 클라이언트에서 flow 및 공개 키 매개변수를 입력하는 방법도 알아봅니다.

자주 묻는 질문

구독 업데이트는 성공했는데 왜 연결되지 않나요?

업데이트 성공은 클라이언트가 서버 목록을 가져왔다는 뜻일 뿐입니다. 항목을 선택한 뒤 코어가 실행 중인지, 앱의 트래픽이 클라이언트로 전달되는지 확인하고 문제 해결 안내에 따라 연결 오류와 도메인 조회 오류를 구분하세요.

왜 특정 앱 하나만 프록시를 사용하지 않나요?

먼저 해당 앱이 시스템 프록시를 읽는지, 자체 프록시가 설정되어 있는지, VPN 모드에서 제외되지는 않았는지 확인하세요. 트래픽이 클라이언트에 들어온 것을 확인한 뒤에야 라우팅 규칙과 아웃바운드 태그를 점검하면 됩니다.

DNS 또는 TUN을 방금 변경했는데 어떻게 점검을 다시 시작하나요?

마지막으로 정상 작동한 모드로 되돌리고 서버는 그대로 둔 채 자주 사용하는 앱과 로컬 네트워크 접속을 먼저 확인하세요. 그런 다음 DNS 또는 TUN 설정을 하나씩 복원하고, 특정 단계에서 문제가 재현되면 자주 묻는 질문을 참고해 해당 계층의 설정을 살펴보세요.

하나의 구독을 두 종류의 클라이언트에서 함께 사용할 수 있나요?

구독을 읽을 수 있는지는 반환되는 형식에 따라 달라지고, 가져온 뒤 연결할 수 있는지는 실제 코어와 설정 항목에 달려 있습니다. 두 기기에서 동시에 사용할 수 있는지는 서비스 제공자의 정책을 별도로 확인해야 합니다. 먼저 구독 및 서버 관련 용어를 참고해 이 세 가지를 구분하세요.