클라이언트 다운로드 / 설정 가이드

v2rayN 클라이언트 다운로드 및 설정

플랫폼에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 시작하세요. 이어서 시스템 프록시, 트래픽 분할 라우팅, DNS를 설정합니다.

프로토콜
VMessVLESSTrojanShadowsocks
설정 작업 공간

구독 그룹부터 코어 선택까지

각 설정이 담당하는 기능을 먼저 구분한 뒤 하나씩 조정하세요. 아래는 설정 예시입니다. 메뉴 이름은 클라이언트 업데이트에 따라 조금 달라질 수 있습니다.

출처별 구독 및 필터 조건 관리

구독 그룹을 사용하면 링크, 업데이트 방식, 서버 목록을 따로 관리할 수 있습니다. 먼저 ‘구독 그룹 설정’에서 이름과 구독 URL을 입력한 다음 해당 그룹을 업데이트하세요. 개별 공유 링크를 구독으로 착각하지 않도록 주의해야 합니다. 출처가 여러 개라면 메모와 필터 조건으로 목록을 좁히고, 직접 추가한 서버는 그대로 보관할 수 있습니다. 서버를 한 번에 붙여넣는 방식과 달리 그룹은 출처 정보가 유지되어 이후 업데이트를 관리하기 쉽습니다. 필터 조건을 삭제하거나 수정하기 전에는 현재 선택된 그룹을 확인해 다른 출처의 설정을 잘못 처리하지 않도록 하세요.

설정 예시

그룹 이름구독 그룹 A
구독 URL출처별로 입력
서버 필터메모로 필터링
업데이트 범위현재 그룹
플랫폼별 다운로드

V2Ray 클라이언트 다운로드 가이드

데스크톱에서는 v2rayN을 먼저 살펴보고, 모바일에서는 필요한 코어에 맞춰 선택하세요. 다운로드 페이지에서 CPU 아키텍처, 설치 파일 형식, 설치 시 주의 사항을 확인할 수 있으며 플랫폼별로 다운로드 경로가 제공됩니다.

Windows

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

데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, WPF 버전은 익숙한 Windows 인터페이스를 유지합니다. 처음 사용하는 경우 두 버전의 안내를 확인한 뒤 편한 쪽을 선택하세요. 설정 파일과 실행 파일이 섞이지 않도록 두 프로그램을 같은 폴더에 압축 해제하지 마세요.

설치 전에 운영체제와 CPU 아키텍처를 확인하세요. 처음 실행한 뒤 구독을 가져오고 시스템 프록시를 설정합니다. 브라우저가 이전 설정을 계속 사용한다면 시스템 프록시 주소와 클라이언트의 수신 포트가 일치하는지 확인하세요.

다운로드 페이지로 이동

macOS

v2rayN · Apple Silicon / Intel

먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 설치 파일 형식이 같아도 CPU 아키텍처는 다를 수 있습니다. 맞는 설치 경로를 선택하면 이후 권한 설정과 업데이트 절차도 일관되게 관리할 수 있습니다.

앱을 ‘응용 프로그램’ 폴더로 옮긴 뒤 실행하고, 시스템 안내에 따라 권한을 설정하세요. 일반 프록시는 작동하지만 TUN을 켤 수 없다면 구독을 삭제하거나 서버 정보를 다시 입력하기 전에 권한과 네트워크 인터페이스를 따로 확인하세요.

다운로드 페이지로 이동

Android

v2rayNG · v2flyNG 대안

먼저 Xray 기반 v2rayNG를 확인하고, V2Fly 코어 환경이 필요한 경우 v2flyNG를 살펴보세요. 대부분의 최신 기기는 arm64를 사용합니다. 아키텍처를 모른다면 다운로드 페이지의 범용 패키지 안내를 참고하고, 파일 크기만으로 호환성을 판단하지 마세요.

설정을 가져온 뒤 처음 연결할 때는 시스템 VPN 권한을 허용해야 합니다. 다른 앱으로 전환한 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 클라이언트를 바꿀 때는 시스템 연결 권한이 서로 덮어쓰이지 않도록 기존 연결을 먼저 중지해야 합니다.

다운로드 페이지로 이동

Linux

v2rayN · deb / rpm

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64를 구분하세요. 그래픽 클라이언트를 사용하려면 데스크톱 환경과 해당 실행 조건도 갖춰야 합니다. CPU 아키텍처와 패키지 형식은 서로 별개의 조건이므로 둘 다 확인해야 합니다.

데스크톱 환경마다 시스템 프록시를 사용하는 방식이 다릅니다. 앱이 프록시를 자동으로 사용하지 않으면 앱 자체의 프록시 설정을 확인하고 로컬 수신 주소도 점검하세요. TUN이 필요하다면 문서에서 권한과 라우팅을 확인하고, 문제가 생겼을 때 되돌릴 수 있도록 기존 네트워크 설정을 보관하세요.

다운로드 페이지로 이동
첫 설정 순서

가져오기, 모드 선택, 연결 확인

먼저 기본 설정 하나를 완전히 작동시킨 뒤 트래픽 분할과 연결 범위를 넓히세요. 한 번에 한 가지씩만 변경해야 문제가 생겼을 때 원인을 찾기 쉽습니다.

  1. 01 / 설정 가져오기

    구독을 가져와 서버 선택

    v2rayN에서는 ‘구독 그룹’에서 ‘구독 그룹 설정’으로 이동해 새 그룹을 만든 뒤 구독 URL을 입력하고 해당 그룹을 업데이트하세요. v2rayNG에서는 ‘구독 설정’에 출처를 추가한 다음 구독을 업데이트합니다. 개별 공유 링크는 클립보드 가져오기 기능을 사용해야 하며 구독 URL을 대신할 수 없습니다.

    목록이 표시되면 서버 메모, 프로토콜, 전송 설정을 확인하고 사용할 서버를 선택하세요. 구독 URL에 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷에 노출하지 마세요. 업데이트 후 목록이 비어 있다면 링크가 온전한지, 출처가 여전히 유효한지, 필터 조건이 지나치게 제한적이지 않은지 확인하세요.

  2. 02 / 트래픽 진입점

    시스템 프록시와 라우팅을 각각 설정

    데스크톱에서는 먼저 ‘시스템 프록시 자동 설정’을 선택해 시스템 설정을 따르는 앱의 트래픽이 클라이언트로 전달되도록 한 다음, 필요에 맞는 라우팅 모드를 선택하세요. ‘전역’은 클라이언트에 들어온 트래픽의 출구 정책을 뜻하며 기기의 모든 앱을 자동으로 처리한다는 의미는 아닙니다. 일반적인 웹 사용은 시스템 프록시부터 테스트하면 됩니다.

    ‘시스템 프록시 변경 안 함’은 현재 설정을 유지하고, ‘시스템 프록시 해제’는 해당 프록시 설정을 제거합니다. 일반 연결을 복구하려면 창만 닫지 말고 필요한 동작을 정확히 선택하세요. 문제 원인을 구분하기 어려워지지 않도록 TUN을 켜고, DNS를 바꾸고, 사용자 지정 라우팅을 추가하는 작업을 동시에 하지 마세요.

  3. 03 / 연결 결과 확인

    진입점, DNS 해석, 출구 확인

    연결한 뒤 정상 작동을 확인한 대상에 같은 앱으로 접속해 요청이 예상한 경로를 거치는지 확인하세요. 클라이언트에서 연결 정보나 로그를 제공한다면 사용된 출구와 오류 유형을 살펴보세요. 화면에 실행 중이라고 표시되어도 관련 프로세스가 시작된 것일 뿐, 대상 사이트에 접속할 수 있다는 뜻은 아닙니다.

    브라우저는 되지만 다른 앱이 실패하면 앱이 시스템 프록시를 사용하는지 먼저 확인하세요. 도메인 접속과 IP 주소 접속 결과가 다르면 DNS를 점검하고, 모든 대상에 연결할 수 없다면 서버 설정과 네트워크 상태를 확인하세요. 변경 전후 결과를 기록하고 같은 대상으로 다시 테스트하면 여러 모드를 연달아 바꾸는 것보다 문제를 찾기 쉽습니다.

프로젝트와 코어

Project V, V2Fly, Xray의 관계

클라이언트 이름, 코어 이름, 프록시 프로토콜은 서로 다른 계층의 개념입니다. 세 가지를 구분해야 설정을 가져올 수 있는지, 실제 연결을 어느 구성 요소가 처리하는지, 업데이트 시 무엇을 확인해야 하는지 알 수 있습니다.

설정 관리v2rayN / v2rayNG / v2flyNG
연결 처리Xray / V2Fly
프로토콜 및 전송서버 설정에 맞춰 선택

생태계의 출발점: Project V에서 여러 코어로

Project V는 네트워크 통신 도구를 중심으로 형성된 오픈 소스 프로젝트 생태계이며, V2Ray는 그중 주요 구현체입니다. V2Fly 커뮤니티는 V2Ray 관련 구현을 지속적으로 유지 관리하고, Xray는 관련 코드 기반에서 발전해 독립적인 코어 분기가 되었습니다. 두 계열은 비슷한 개념과 설정 방식을 공유하지만 기능, 프로토콜 확장, 구현 세부 사항은 각각 발전해 왔습니다. 이름만 다른 같은 소프트웨어로 보면 안 됩니다.

일상적인 검색에서 ‘V2Ray 클라이언트’는 이 생태계의 그래픽 도구를 가리키는 경우가 많지만, 모든 도구가 같은 코어를 실행하는 것은 아닙니다. 서버 설정에 특정 프로토콜 확장이 필요하다면 앱 이름에 V2Ray가 포함됐는지만 보지 말고 실제 코어가 지원하는지 확인하세요. 설정 항목이 비슷해 보여도 서로 그대로 바꿔 쓸 수 있는 것은 아닙니다.

가이드를 읽을 때 그래픽 메뉴와 코어 설정 파일도 구분해야 합니다. 메뉴의 스위치 하나가 여러 하위 설정을 생성할 수 있으며, 설정 파일을 직접 편집해도 다음에 그래픽 인터페이스에서 저장할 때 내용이 다시 생성될 수 있습니다. 평소에는 그래픽 인터페이스로 관리하고, 사용자 지정 설정이 필요하면 클라이언트의 생성 및 병합 방식을 먼저 확인하세요.

클라이언트 세 가지: 인터페이스와 코어의 역할

v2rayN은 데스크톱 환경에서 서버 관리, 구독 업데이트, 라우팅 선택 및 관련 설정을 담당하고 해당 코어를 호출해 연결합니다. v2rayNG는 Android용 Xray 코어 클라이언트이며, v2flyNG는 V2Fly 기반 Android 클라이언트입니다. 세 클라이언트는 모두 오픈 소스 소프트웨어지만, 구체적인 사용법은 각 인터페이스와 포함된 코어에 따라 확인해야 합니다.

그래픽 인터페이스는 출처 저장, 서버 선택, 실행 설정 생성, 상태 표시 등 설정 관리를 담당합니다. 코어는 프로토콜 핸드셰이크, 전송, DNS 해석, 라우팅을 처리합니다. 인터페이스가 구독을 읽었다고 해서 코어가 구독에 포함된 모든 조합을 지원하는 것은 아닙니다. 반대로 코어 시작에 실패했다고 구독 URL이 잘못된 것은 아니며, 특정 매개변수나 실행 조건이 맞지 않을 수도 있습니다.

데스크톱과 모바일은 트래픽 진입 방식도 다릅니다. 데스크톱은 보통 시스템 프록시를 사용하고, 모바일은 대개 시스템 VPN 권한이 필요합니다. 설정을 옮길 때는 먼저 같은 서버 설정을 가져와 연결을 확인한 뒤 그룹, 규칙, 기타 설정을 적용하세요. 플랫폼마다 다른 트래픽 처리 방식을 그대로 옮길 수 있는 옵션으로 착각하지 마세요.

오픈 소스 라이선스: 구성 요소별로 이해하기

오픈 소스는 해당 라이선스에 따라 소스 코드를 공개하고, 라이선스 조건에 맞게 사용·연구·배포할 수 있다는 뜻입니다. V2Fly의 V2Ray 코어는 MIT 라이선스, Xray 코어는 MPL 2.0 라이선스를 사용합니다. 그래픽 클라이언트와 의존 구성 요소에는 각각 다른 라이선스가 적용될 수 있습니다. 소프트웨어 라이선스를 살펴볼 때는 클라이언트, 코어, 포함된 구성 요소를 구분해야 하며 한 구성 요소의 라이선스를 전체 소프트웨어에 적용해서는 안 됩니다.

일반 사용자에게 오픈 소스 여부는 프로젝트의 출처와 기술 구현을 이해하는 데 도움이 되지만, 개별 설정을 확인하는 일을 대신하지는 않습니다. 구독 출처는 서버 매개변수를 제공하고, 서버 운영자는 서비스 조건을 정하며, 클라이언트는 로컬 연결과 관리를 담당합니다. 각 요소는 함께 작동하지만 역할은 서로 다릅니다. 클라이언트를 설치한다고 사용할 수 있는 구독이나 서버가 자동으로 만들어지지는 않습니다.

문제를 공유할 때는 프로토콜 종류, 운영체제 환경, 오류 정보만으로도 대개 충분합니다. 전체 구독 URL, 사용자 식별 정보, 비공개 연결 매개변수는 공개하지 마세요. 문서의 설정 예시는 구조를 설명하기 위한 것으로, 바로 연결할 수 있는 서비스가 아니며 출처에서 제공한 실제 매개변수를 대신할 수 없습니다.

업데이트 순서: 호환성을 확인한 뒤 설정 변경

클라이언트 인터페이스, 코어 프로그램, 구독 내용, 라우팅 데이터는 각각 따로 변경될 수 있습니다. 클라이언트를 업데이트해도 구독이 바뀌는 것은 아니며, 구독을 업데이트한다고 코어가 업그레이드되는 것도 아닙니다. 연결 상태가 달라졌다면 최근에 어느 계층을 변경했는지 먼저 기록하고 해당 부분을 점검하세요. 화면 모양이나 파일 날짜만으로 실제 실행 중인 코어가 설정과 호환되는지 판단하기는 어렵습니다.

업데이트 전에 현재 작동하는 설정을 저장하고 설치 형식, 권한, 데이터 디렉터리 안내를 읽으세요. 업데이트 후에는 기존 서버와 모드로 먼저 테스트한 다음 새 기능을 하나씩 켜세요. 코어가 시작되지 않으면 시작 정보와 설정 호환성을 우선 확인하고, 특정 구독 출처에서만 문제가 생기면 전체 클라이언트를 다시 설치하기 전에 출처에서 반환한 내용을 확인하세요.

고급 설정을 변경할 때는 라우팅, DNS 정책, TUN 상태를 간단히 기록해 두세요. 되돌릴 때 변경 사항을 역순으로 취소하면 시스템 프록시나 가상 인터페이스 설정이 남는 일을 방지할 수 있습니다. 추가로 문제를 점검할 때는 같은 구독을 반복해서 가져오기보다 ‘앱 진입점, DNS 해석, 라우팅 규칙, 서버 연결’ 순서로 안내서를 확인하세요.

설정 가이드

구독 가져오기, 프로토콜, 프록시 모드

기본 설정을 마친 뒤 현재 문제에 맞는 주제를 선택하세요. 먼저 개념의 범위를 파악하고 클라이언트에서 관련 옵션을 조정하면 됩니다. 모든 고급 설정을 한 번에 읽을 필요는 없습니다.