클라이언트 선택구독 · 라우팅 · 코어

V2Ray 안드로이드 클라이언트
다운로드 및 설정 가이드

v2rayN 다운로드 가이드 보기

플랫폼에 맞는 오픈소스 클라이언트를 선택하고, 구독 가져오기부터 라우팅 설정까지 차례로 진행하세요.

프로토콜 및 전송 방식
  • VMess
  • VLESS
  • Trojan
  • REALITY

구독·라우팅·연결 설정

클라이언트는 설정을 관리하고 코어는 연결을 처리합니다. 먼저 구독이 정상적으로 파싱되는지 확인한 다음, 앱 트래픽을 클라이언트로 전달할 방법을 정하고 라우팅 규칙을 조정하세요.

각 단계는 서로 다른 문제를 해결합니다. 구독 그룹은 설정 출처를 저장하며, 업데이트하면 선택 가능한 서버 항목이 생성됩니다. 시스템 프록시나 TUN 모드는 어떤 앱의 요청을 받아들일지 결정하고, 라우팅 사전 설정은 받아들인 요청을 직접 연결·프록시·차단 중 어느 경로로 보낼지 정합니다. 목록에 항목이 있다고 시스템 프록시가 켜진 것은 아니며, 프록시가 켜져 있어도 모든 요청이 프록시 경로를 이용하는 것은 아닙니다. 문제를 진단할 때 각 항목을 따로 확인하면 클라이언트를 반복해서 재설치해도 실제 설정이 바뀌지 않는 상황을 피할 수 있습니다.

아래 설정 창은 일반적인 작업 순서에 따라 구성했습니다. 클라이언트마다 메뉴 이름은 다를 수 있으며, 예시는 설정의 의미를 설명하기 위한 것으로 완전한 실행 설정이 아닙니다. 처음 사용하는 경우 가이드에 따라 최소한의 연결을 완료한 뒤 구독 업데이트, 사설 주소 직접 연결, 앱 트래픽 처리 설정을 하나씩 추가하세요.

구독 그룹

구독 그룹은 구독 주소와 서버 항목을 연결하므로 설정을 정기적으로 업데이트할 때 유용합니다. v2rayN에서는 먼저 그룹 이름과 구독 주소를 추가하고 저장한 다음 구독 업데이트를 실행하세요. v2rayNG에서는 구독 설정에 주소를 추가한 뒤 목록으로 돌아가 업데이트하면 됩니다. 단일 공유 링크는 설정 하나만 가져오며, 자동으로 업데이트 가능한 구독이 되지는 않습니다. 그룹 이름은 출처를 구분하기 위한 것이고, 주소는 신뢰할 수 있는 제공자가 준 것이어야 합니다. 업데이트에 실패하면 주소가 완전한지, 만료되지는 않았는지, 응답 형식이 올바른지 확인하세요. 웹 로그인 주소를 구독 링크로 착각하지 않도록 주의하세요.

구독 그룹 → 추가
그룹 이름: 개인 구독
구독 주소: 제공자가 안내한 구독 링크 입력
저장 → 구독 업데이트 → 설정 선택
4Windows / Android / macOS / Linux
3v2rayN / v2rayNG / v2flyNG
GPL-3.0클라이언트 오픈소스 라이선스

운영체제에 맞는 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 먼저 v2rayNG를 살펴보세요. 설치 파일은 운영체제와 프로세서 아키텍처에 모두 맞아야 합니다.

Windows

v2rayN · 데스크톱 버전 / WPF 버전

Windows 사용자는 v2rayN 데스크톱 버전과 클래식 WPF 버전 중에서 선택할 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용해 여러 데스크톱 운영체제에서 비슷한 방식으로 사용할 수 있습니다. WPF 버전은 Windows용으로, 기존 사용 경험이 있고 클래식 메뉴 구성을 선호하는 사용자에게 적합합니다. 두 인터페이스 모두 시스템 요구 사항을 대신 확인해 주지는 않습니다. 다운로드 전에 설치 안내를 읽고 시스템 환경과 실행 종속성을 확인하세요.

처음 설치할 때는 기본 수신 설정을 유지하고, 사용 가능한 것으로 확인된 설정 하나를 가져온 뒤 시스템 프록시를 켜 브라우저에서 기본 연결을 확인하는 것이 좋습니다. 대상 앱이 시스템 프록시를 사용하지 않을 때만 앱별 프록시 설정이나 TUN 모드를 고려하세요. 이렇게 하면 설치 문제, 앱 트래픽 처리 문제, 원격 연결 문제를 구분할 수 있습니다.

업데이트 전에 구독 그룹, 사용자 지정 라우팅, 필요한 로컬 설정을 백업하세요. 다른 인터페이스로 옮길 때는 설정을 가져오는 방법을 확인하고 실행 중인 디렉터리를 그대로 덮어쓰지 마세요. 사용을 마친 뒤 시스템 프록시가 해제되었는지 확인하세요. 다른 프록시 도구도 시스템 설정을 변경한다면 어느 프로그램이 설정을 관리할지 정해 서로 덮어쓰지 않도록 하세요.

다운로드 페이지로 이동

macOS

v2rayN · Apple Silicon / Intel

macOS에서는 v2rayN 데스크톱 버전을 사용합니다. 먼저 시스템의 “이 Mac에 관하여”에서 칩 정보를 확인하세요. Apple Silicon은 arm64 설치 항목을, Intel은 x64 항목을 선택하면 됩니다. 프로세서 아키텍처에 따라 설치 파일이 달라지므로 컴퓨터 외관이나 구입 연도만으로 판단하지 마세요. 설치 후 시스템 안내에 따라 앱을 열고 필요한 권한을 부여한 다음 구독과 프록시를 설정하세요.

시스템 프록시와 TUN 모드는 서로 다른 설정입니다. 시스템 프록시는 운영체제 설정을 따르는 앱에 영향을 주고, TUN 모드는 더 많은 트래픽을 처리하며 추가 권한이 필요할 수 있습니다. 먼저 시스템 프록시로 브라우저 접속을 확인한 뒤 처리 범위를 넓힐 필요가 있는지 판단하세요. 회사에서 관리하는 기기는 프록시 설정 변경이 제한될 수 있으므로 관련 설정이 허용되는지 먼저 확인해야 합니다.

Wi-Fi를 바꾸거나 유선 네트워크에 연결하거나 절전 모드에서 깨어난 뒤 동작이 달라지면 먼저 현재 네트워크 서비스의 프록시 설정을 확인하고 클라이언트가 실행 중인지 살펴보세요. 브라우저는 정상인데 특정 앱만 접속되지 않는다면 앱 자체의 네트워크 옵션을 먼저 확인하세요. 로컬 네트워크 기기에 접속할 수 없다면 사설 주소 직접 연결 규칙을 확인하고, 모든 트래픽을 곧바로 프록시로 돌리지는 마세요.

다운로드 페이지로 이동

Android

v2rayNG · Xray / v2flyNG · V2Fly

Android에서는 먼저 v2rayNG를 살펴보고, V2Fly 설정 생태계를 사용하는 경우 v2flyNG를 고려할 수 있습니다. 두 클라이언트는 서로 다른 코어를 사용하므로 이름이 비슷한지가 아니라 설정 요구 사항과 사용 방식에 따라 선택하세요. 최신 스마트폰 대부분은 arm64를 사용합니다. 아키텍처를 알 수 없다면 기기 정보를 확인하고 다운로드 페이지의 범용 버전 안내를 참고하세요. 설치 권한은 현재 사용하는 설치 출처에만 허용하세요.

단일 공유 링크를 복사했다면 클라이언트의 클립보드 가져오기 기능으로 설정을 추가할 수 있습니다. 구독 주소를 받았다면 구독 설정에서 출처를 저장하고 업데이트를 실행하세요. 가져오기가 끝나면 설정을 선택하고 서비스를 시작한 뒤 시스템 VPN 연결을 허용합니다. 시스템 권한은 로컬 트래픽 처리를 위한 것이며, 서버 정보를 대신 만들거나 유효한 구독 출처를 제공하지는 않습니다.

화면을 잠근 뒤 연결이 자주 끊긴다면 배터리 최적화, 백그라운드 실행, 제조사별 자동 시작 관리 설정을 확인하세요. 앱별 프록시 설정은 실제로 처리되는 범위를 바꾸므로 변경 후 상태 아이콘만 보지 말고 대상 앱으로 확인해야 합니다. 기존 VPN 서비스가 시스템의 트래픽 처리 권한을 두고 클라이언트와 충돌할 수 있으니 테스트 전에 현재 활성화된 서비스를 확인하세요. 구독 링크는 비공개 설정으로 취급하고, 주소와 인증 정보가 보이지 않도록 가린 뒤 화면을 공유하세요.

다운로드 페이지로 이동

Linux

v2rayN · deb / rpm

Linux 데스크톱에서는 v2rayN 데스크톱 버전을 사용하고, 배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택하세요. 기기의 아키텍처가 x64인지 arm64인지도 확인해야 합니다. Debian, Ubuntu 계열은 일반적으로 deb 패키지를, Fedora 계열은 rpm 패키지를 사용합니다. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 둘 중 하나만 맞는다고 설치 파일을 사용할 수 있는 것은 아닙니다.

설치 후 먼저 앱 메뉴에서 클라이언트를 실행해 인터페이스와 코어가 정상적으로 동작하는지 확인한 다음 구독을 가져오세요. 데스크톱 환경마다 시스템 프록시 관리 방식이 다르고 브라우저에 별도 설정이 남아 있을 수도 있습니다. 확인할 때는 대상 앱이 실제로 어떤 프록시 설정을 읽는지 먼저 살펴보세요. 필요한 경우 앱에서 클라이언트의 로컬 수신 주소와 포트를 지정하고, 서버를 반복해서 바꾸지는 마세요.

TUN 모드는 권한과 라우팅에 영향을 주므로 클라이언트 안내에 따라 활성화하세요. 단순히 설정 하나를 켜기 위해 모든 데스크톱 프로그램을 계속 높은 권한으로 실행하지 마세요. 로그인 시 자동 시작을 설정하기 전에 수동 실행을 먼저 확인하고, 클라이언트를 종료한 뒤 네트워크가 복구되는지도 살펴보세요. 종속성이나 권한 오류가 발생하면 안내 문구와 시작 로그를 기록한 뒤 설치 가이드의 해당 부분을 참고하세요. 자동 시작 문제와 연결 문제는 따로 해결해야 합니다.

다운로드 페이지로 이동
전체 클라이언트 보기 → 전체 플랫폼 설치 가이드 보기 →

Project V·V2Fly·Xray 생태계

프로젝트, 코어, 클라이언트를 구분해야 설정 호환성을 판단할 수 있습니다. 오픈소스 라이선스는 코드 사용 조건을 설명하며, 실제 연결 결과는 설정과 네트워크 환경에 따라 달라집니다.

Project V와 클라이언트의 역할

V2Ray는 Project V의 프록시 도구 생태계에서 시작했으며, 설정 가능한 인바운드·아웃바운드·라우팅 구조로 네트워크 연결을 관리합니다. 인바운드는 로컬 요청을 받고, 아웃바운드는 요청을 내보내는 방식을 정의하며, 라우팅은 매칭 조건을 출구와 연결합니다. 그래픽 클라이언트는 이러한 설정을 조작하기 쉬운 화면으로 구성해 구독 관리, 설정 생성, 프로세스 실행, 로그 표시를 담당합니다. 화면에 시작 완료로 표시되어도 일부 실행 절차가 끝났다는 뜻일 뿐이므로 실제 요청이 올바른 인바운드로 들어오는지 확인해야 합니다.

“클라이언트”, “코어”, “구독”은 서로 바꿔 쓸 수 있는 말이 아닙니다. 클라이언트는 일상적인 조작 도구이고, 코어는 프로토콜과 전송 로직을 실행하며, 구독은 설정의 출처입니다. 클라이언트를 다운로드해 설치한 뒤에도 현재 코어에 맞는 연결 설정을 적법하게 확보해야 합니다. 클라이언트 자체가 구독을 제공하지 않으며, 인터페이스를 바꾼다고 서버 측 요구 사항이 달라지지도 않습니다. 이 관계를 이해하면 오류가 발생했을 때 어느 단계에서 해결해야 하는지 파악하기 쉽습니다.

V2Fly와 Xray의 코어 관계

V2Fly는 V2Ray의 커뮤니티 개발과 유지보수를 이어가고 있으며, Xray는 관련 코드 생태계에서 발전했습니다. 두 프로젝트는 일부 개념과 프로토콜 배경을 공유하지만 개발 방향과 기능 발전은 각각 다릅니다. JSON 필드가 비슷하다고 모든 매개변수를 서로 바꿔 쓸 수 있는 것은 아닙니다. 프로토콜 이름뿐 아니라 전송 방식, 보안 설정, 서버 기능, 현재 코어의 필요한 기능 지원 여부도 확인해야 합니다. REALITY는 보안 및 전송 관련 기능이므로 프로토콜 표시 하나만으로 전체 설정의 호환성을 판단할 수 없습니다.

v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. v2rayN은 데스크톱 GUI 관리 기능을 제공하며, 클라이언트 옵션과 설정 유형에 맞는 코어를 사용할 수 있습니다. 기존 설정의 요구 사항을 먼저 확인한 다음 플랫폼과 인터페이스 사용 방식을 고려하세요. 특정 필드가 거부되면 정확한 오류 메시지를 기록하고 해당 필드가 어느 코어 계열에 속하는지 확인하세요. 구독 이름을 바꾸거나 설정 이름을 변경해도 호환되지 않는 매개변수가 지원되는 것은 아닙니다.

세 클라이언트와 GPL-3.0

v2rayN·v2rayNG·v2flyNG 클라이언트 프로젝트는 GPL-3.0 오픈소스 라이선스를 적용합니다. 오픈소스란 라이선스에 따라 코드를 열람·사용·수정·배포할 수 있다는 뜻입니다. 수정한 코드를 배포할 때는 관련 라이선스 의무를 이행해야 합니다. 클라이언트, 코어, 앱과 함께 사용하는 다른 구성 요소에는 각각 다른 라이선스가 적용될 수 있으므로 클라이언트의 라이선스 표시 하나로 모든 구성 요소의 라이선스를 대신할 수는 없습니다. 일반 사용자는 클라이언트의 오픈소스 여부를 확인하면 되고, 개발자와 배포자는 해당 라이선스 전문을 확인해야 합니다.

오픈소스는 투명한 개발 방식이지 모든 연결 결과를 보장하는 것은 아닙니다. 서버 사용 가능 여부, 구독 유효성, 인증 매개변수, 네트워크에서 해당 전송을 허용하는지 등을 각각 확인해야 합니다. 이 사이트는 중국어 안내를 통해 선택과 설정 절차를 정리하며, 클라이언트에 주관적인 점수를 매기거나 커뮤니티 유지보수를 정해진 업데이트 주기와 동일시하지 않습니다. 세 제품을 비교할 때는 이름만으로 성능을 추측하지 말고 플랫폼, 코어, 설정 지원 범위의 구체적인 차이를 살펴보세요.

업데이트·백업·설정 범위

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 설정 생성 방식, 실행 종속성을 바꿀 수 있고, 코어 업데이트는 프로토콜 구현과 필드 지원에 영향을 줍니다. 구독 업데이트는 출처 주소에서 서버 설정을 다시 가져옵니다. 구독을 업데이트해도 시스템 프록시가 자동으로 복구되지는 않으며, 앱을 업데이트해도 만료된 구독이 유효해지지 않습니다. 문제가 생기면 최근 변경 사항을 먼저 기록하고 관련 단계부터 확인하세요. 모든 항목을 한꺼번에 업데이트하면 원인을 찾기 어려워집니다.

설정을 변경하기 전에 구독 그룹, 사용자 지정 라우팅, 사용 가능한 것으로 확인된 설정을 백업하세요. 백업에는 구독 주소, 인증 정보, 서버 매개변수가 포함될 수 있으므로 접근을 통제할 수 있는 곳에 보관하고 로그와 함께 공개하지 마세요. 오류를 다른 사람에게 설명할 때는 필드 이름, 오류 유형, 작업 순서는 남기되 민감한 값은 숨기세요. 전체 구독과 단일 설정은 공유 범위가 다르지만 둘 다 접근 권한이 포함될 수 있는 정보로 취급해야 합니다.

라우팅 설정도 관리가 필요합니다. 도메인 및 IP 분류는 클라이언트가 사용하는 데이터 파일에 의존하며, 분류 내용이 바뀌면 같은 대상도 다른 규칙에 매칭될 수 있습니다. 규칙 순서와 DNS 정책, 기본 출구가 함께 결과에 영향을 줍니다. 첫 화면의 라우팅 창은 매칭 조건과 출구의 연결을 보여주는 예시일 뿐, 그대로 실행할 수 있는 완전한 설정이 아닙니다. 실제 사용 시에는 아웃바운드 설정에 해당 태그를 정의하고, 일치하지 않는 요청에 사용할 기본 출구를 확인해야 합니다.

세 클라이언트 비교 보기 → 구독 가져오기 및 연결 가이드 보기 → 사이트 콘텐츠 범위 알아보기 →

클라이언트 선택 및 플랫폼 배포 글

최근 글 세 편에서 클라이언트별 차이, Linux 배포, 데스크톱 인터페이스 선택을 살펴봅니다. 기본 연결을 마친 뒤 사용하는 플랫폼에 맞는 세부 내용을 확인하세요.

전체 글 보기 →