클라이언트 설정 안내 · 구독 그룹부터 시작하기

V2Ray 구독 가이드 v2rayN 다운로드 및 구독 가져오기

플랫폼에 맞는 클라이언트를 선택하고 구독 가져오기, 프록시 모드, 라우팅 설정을 차례로 진행하세요.

오픈 소스 클라이언트 Xray / V2Fly 커널 한국어 사용 안내
설정 메뉴

구독 가져오기부터 연결 설정까지

구독, 프록시 진입점, 라우팅, 커널은 서로 다른 설정 단계입니다. 먼저 구독 그룹의 항목을 클라이언트로 가져온 다음, 애플리케이션 트래픽을 어떤 방식으로 커널에 전달할지 정하고 마지막으로 규칙이 제대로 적용되는지 확인하세요. 메뉴 이름은 업데이트에 따라 달라질 수 있습니다. 차이가 있으면 아이콘 위치를 짐작해 누르기보다 설정 항목의 기능을 기준으로 찾으세요.

구독 주소를 저장한 뒤 그룹 업데이트

구독 주소는 설정을 반복해서 가져올 수 있는 URL이고, 노드는 업데이트 후 생성되는 개별 연결 설정입니다. v2rayN에서 ‘구독 그룹 설정’을 열고 메모와 주소를 입력해 저장한 다음 구독을 업데이트하세요. 저장만으로 노드가 자동 생성되지는 않습니다. 항목을 하나씩 수동으로 추가하는 것보다 그룹을 사용하면 출처의 설정을 한꺼번에 갱신할 수 있습니다. 다만 업데이트 과정에서 출처에서 삭제된 항목이 제거될 수 있으므로 구독 항목에 직접 수정한 설정을 보관하지 마세요. 주소에 포함된 인증 정보는 안전하게 관리하고, 도움을 요청할 때는 전체 URL을 가리세요. 업데이트 후 그룹과 프로토콜 종류를 확인한 다음 사용할 설정을 선택하세요.

입문 가이드 보기 →
설치 파일 다운로드

플랫폼별 V2Ray 클라이언트 선택

데스크톱에서는 주로 v2rayN을 사용하고, 안드로이드에서는 먼저 v2rayNG를 확인한 뒤 커널 요구 사항에 따라 v2flyNG를 고려하세요. 클라이언트는 설정 도구일 뿐이며, 설치 후에도 유효한 구독 주소나 공유 링크가 필요합니다. 다운로드 페이지에서 프로세서 아키텍처와 설치 파일 종류를 확인하고 해당 플랫폼의 설치 안내를 읽으세요.

Windows

v2rayN

다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 받을 수 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 조작 방식을 유지합니다. 메뉴 위치가 다를 수 있으니 설정할 때는 항목 이름을 기준으로 찾으세요. 먼저 시스템 설정에서 기기 아키텍처를 확인한 다음 알맞은 설치 파일을 선택하세요.

기존 설정이 있다면 먼저 백업한 뒤 인터페이스 버전을 바꾸세요. 시스템 프록시를 제어하는 클라이언트를 여러 개 동시에 실행하지 마세요. 브라우저가 다른 프로세스의 로컬 포트를 계속 가리키면 구독 연결에 문제가 있는 것처럼 보일 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN

먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인한 뒤 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 앱을 설치한 다음 클라이언트가 실행되는지와 시스템 프록시 설정을 각각 확인하세요. 앱 창이 열려도 시스템 트래픽이 프록시를 통과한다는 뜻은 아닙니다.

시스템에서 앱 실행을 제한한다는 알림이 표시되면 다운로드 출처와 알림 내용을 먼저 확인한 뒤 시스템의 보안 설정 안내에 따라 처리하세요. 처음 연결을 확인할 때는 시스템 프록시만 사용하세요. 가상 네트워크 어댑터 권한과 트래픽 분기 설정은 기본 연결이 정상 작동한 뒤 구성해도 됩니다.

다운로드 페이지로 이동

Android

v2rayNG / v2flyNG

v2rayNG는 Xray 커널을, v2flyNG는 V2Fly 커널을 사용합니다. 이름이 비슷하다고 서로 바꿔 쓸 수 있는 것이 아니라 설정 호환성을 기준으로 선택해야 합니다. 최신 스마트폰 대부분은 arm64 패키지에 적합합니다. 기기 아키텍처를 모르면 기기 정보를 먼저 확인한 뒤 범용 패키지를 고려하세요.

처음 연결할 때 시스템 VPN 권한 요청이 표시됩니다. 이는 클라이언트가 기기의 트래픽을 처리할 권한을 요청하는 것으로, 구독 연결이 검증되었다는 뜻은 아닙니다. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행 권한, 같은 시스템 경로를 사용하는 다른 네트워크 도구를 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN

배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64 중에서 고르세요. 다운로드 페이지에서 해당 파일을 받을 수 있으며 그래픽 설치 프로그램으로 의존성 안내를 확인할 수 있습니다. 설치 파일 형식과 프로세서 아키텍처는 별개의 조건이므로 둘 다 기기에 맞아야 합니다.

데스크톱 환경마다 시스템 프록시를 읽는 방식이 다를 수 있으며, 일부 앱은 자체 네트워크 설정을 사용합니다. 테스트할 때는 프록시를 지원하는 것이 확실한 앱에서 먼저 확인하세요. 해당 앱은 정상인데 다른 앱이 실패한다면 구독을 바꾸기보다 각 앱의 네트워크 설정을 확인하세요.

다운로드 페이지로 이동
빠르게 시작하기

구독 설정 3단계

처음 설정할 때는 한 번에 한 종류의 설정만 바꾸는 것이 좋습니다. 먼저 구독을 읽을 수 있는지 확인하고, 다음으로 프록시 진입점을 설정한 뒤 실제 접속을 확인하세요. 이렇게 진행하면 문제가 생겼을 때 어느 단계로 돌아가야 하는지 파악하기 쉽고, 노드·DNS·커널을 번갈아 바꾸는 일을 줄일 수 있습니다.

  1. 1단계 · 구독 가져오기

    그룹을 저장하고 구독 업데이트

    구독 제공자가 안내한 전체 주소를 복사해 ‘구독 그룹 설정’에서 새 그룹을 추가하세요. 알아보기 쉬운 메모를 입력해 저장한 다음 업데이트를 실행하고 목록에 연결 항목이 나타나는지 확인하세요. 공유 링크는 클립보드 가져오기 메뉴를 사용하세요. 공유 링크를 주기적으로 업데이트할 수 있는 구독 주소처럼 사용하면 안 됩니다.

    업데이트 결과가 비어 있으면 요청 실패인지 파싱 실패인지 먼저 확인하세요. 요청 실패라면 주소가 유효한지, 업데이트 요청에 프록시가 사용되는지 확인하세요. 파싱 실패라면 구독 형식과 프로토콜 지원 여부를 확인하세요. 업데이트 버튼을 반복해서 눌러도 이미 만료된 주소가 복구되지는 않습니다.

  2. 2단계 · 연결 설정

    활성 설정과 프록시 방식 선택

    목록에서 사용할 설정을 선택하세요. 데스크톱에서는 먼저 ‘시스템 프록시 자동 설정’을 사용하고 현재 용도에 맞는 기본 라우팅을 유지하세요. 안드로이드에서는 연결을 시작하고 시스템 권한을 허용하세요. 연결을 확인하기 전에 복잡한 규칙을 추가하거나 DNS를 바꾸거나 커널을 전환하지 마세요.

    시스템 프록시는 앱이 요청을 클라이언트에 전달할지 결정하고, 라우팅 규칙은 요청을 받은 뒤 어떤 경로로 보낼지 결정합니다. 두 설정을 따로 확인하세요. 앱 자체에 프록시 주소가 설정되어 있다면 로컬 포트가 클라이언트의 수신 포트와 일치하는지도 확인해야 합니다.

  3. 3단계 · 연결 확인

    실제 접속 후 로그 확인

    자주 사용하는 앱으로 접속이 분명한 대상을 열고 클라이언트 로그에서 연결 오류가 있는지 확인하세요. 한 번의 연결 테스트는 해당 조건에서만 결과를 보여 주므로 브라우저, 앱, DNS의 실제 동작을 각각 확인해야 합니다. 문제 발생 시 되돌릴 수 있도록 테스트 중에는 기존 설정을 유지하세요.

    특정 앱만 실패하면 해당 앱의 프록시 설정을 확인하세요. 모든 앱이 실패하면 활성 설정, 시스템 시간, 프로토콜 매개변수를 확인하세요. 클라이언트를 종료하기 전에는 필요에 따라 시스템 프록시를 해제해 앱이 중지된 로컬 포트에 계속 요청하지 않도록 하세요.

오픈 소스 생태계와 선택 기준

클라이언트·커널·프로토콜의 관계

V2Ray는 여러 도구를 통칭하는 이름으로 자주 쓰입니다. 실제 설정에서는 그래픽 클라이언트, 연결 커널, 프로토콜 매개변수의 세 단계로 나눠 살펴보는 편이 좋습니다. 각 단계의 역할을 알면 어떤 파일을 다운로드해야 하는지, 무엇을 업데이트해야 하는지, 같은 구독이 기기마다 다르게 작동하는 이유를 파악하기 쉽습니다.

Project V와 커널 계열

Project V는 관련 프록시 도구와 프로토콜 생태계의 기반이며 V2Ray는 그 안의 주요 프로젝트입니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어 가고, Xray는 관련 코드 기반에서 출발해 독자적인 기능을 발전시켰습니다. 역사와 설정 개념 일부를 공유하지만 같은 커널의 서로 다른 인터페이스는 아닙니다. 파일 이름만 보고 기능이 완전히 같다고 판단할 수도 없습니다.

이 생태계에서 커널은 연결을 수립하고 전송, 보안 계층, 라우팅, DNS 해석을 처리합니다. 그래픽 클라이언트는 이러한 기능을 설정 화면으로 구성합니다. 오류가 나면 먼저 ‘화면에서 저장할 수 없음’과 ‘커널을 실행할 수 없음’을 구분하세요. 전자는 입력 형식이나 클라이언트 설정 문제일 수 있고, 후자는 커널 로그에서 지원되는 항목과 기능을 확인해야 하는 경우가 많습니다.

세 클라이언트의 역할

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. v2rayN은 데스크톱용으로 구독, 라우팅, 여러 커널을 관리할 수 있습니다. v2rayNG는 안드로이드에서 Xray 커널을 사용하고, v2flyNG는 V2Fly 기반의 안드로이드 클라이언트를 제공합니다. 이들은 설정과 연결을 관리하는 도구이며, 설치만으로 사용할 수 있는 구독 주소가 생기지는 않습니다.

오픈 소스란 프로젝트 코드가 해당 라이선스에 따라 공개되어 있다는 뜻입니다. 사용, 수정, 재배포 시에는 각 라이선스를 따라야 합니다. 클라이언트와 커널에 서로 다른 라이선스가 적용될 수 있으므로 모든 구성 요소를 하나의 라이선스로 묶어 설명할 수는 없습니다. 평소 설정에서는 출처가 분명한 설치 파일을 선택하고 업데이트 안내를 읽으며 앱이 시스템에 요청하는 네트워크 권한을 이해하는 것이 중요합니다.

프로토콜 이름은 성능 순위가 아닙니다

VMess, VLESS, Trojan, Shadowsocks는 서로 다른 프로토콜 설계를 가리키며, REALITY는 보안 계층 방식입니다. 모두 같은 수준의 선택지로 볼 수는 없습니다. 클라이언트에서 프로토콜, 전송 방식, 보안 계층은 서버가 제공한 매개변수에 맞춰 조합해야 합니다. VMess를 VLESS로 바꾸거나 보안 옵션을 임의로 켜는 것만으로 올바른 설정이 되지는 않습니다.

연결 품질은 네트워크 경로, 서버 부하, 전송 설정, 기기 성능에도 영향을 받으므로 프로토콜 이름만으로 속도나 배터리 소모를 예측할 수 없습니다. 모바일에서는 백그라운드 연결 유지와 트래픽 처리 방식도 고려해야 합니다. 먼저 호환성을 확인하고 같은 네트워크와 용도에서 실제 성능을 비교하세요. 설계상 차이를 알고 싶다면 프로토콜 상세 안내를 참고하세요.

프로토콜 및 커널 선택 가이드 →

구독 업데이트와 소프트웨어 업데이트는 따로 확인하세요

구독을 업데이트하면 출처에서 설정을 다시 가져옵니다. 클라이언트를 업데이트하면 인터페이스와 관리 방식, 패키지에 포함된 커널이 바뀔 수 있습니다. 두 업데이트의 목적은 다릅니다. 주소가 만료됐다면 구독 제공자에게 확인하고, 커널이 기능을 지원하지 않을 때는 소프트웨어와 커널의 호환 범위를 확인하세요. 그룹을 새로고침해도 지원되지 않는 기능이 생기지 않으며, 소프트웨어를 업그레이드해도 출처에서 취소한 접근 권한이 복구되지는 않습니다.

설정을 바꾸기 전에 필요한 항목을 백업하고 기존 라우팅 모드, DNS, 프록시 진입점을 기록해 두세요. 업데이트 후에는 확인된 설정 하나로 먼저 테스트한 다음 사용자 설정을 단계별로 복구하세요. 도움을 요청할 때는 오류 유형과 발생 단계를 남기면 됩니다. 전체 구독 주소, 공유 QR 코드, 사용자 ID, 인증 정보가 공개 스크린샷에 포함되지 않도록 주의하세요.

사용 팁

구독 업데이트 및 연결 문제 해결

기본 연결이 정상 작동한 뒤 구체적인 사용 문제를 확인하세요. 아래 글 세 편에서는 구독 읽기, 초보자가 알아야 할 개념, DNS 동작을 다룹니다. 문제를 진단할 때 오류 메시지를 그대로 보관하고 방금 바꾼 설정을 기록해 두면, 반복해서 재설치하는 것보다 원인을 좁히기 쉽습니다.