안드로이드 및 데스크톱 클라이언트/설정 입문

V2Ray 다운로드 설정 가이드

v2rayNG 안드로이드 다운로드부터 데스크톱 v2rayN 설정까지, 기기에 맞는 설치 파일을 선택한 뒤 구독을 가져오고 라우팅을 설정하세요.

구독 주소와 노드 링크는 따로 가져오기

구독 주소는 여러 노드를 업데이트하는 경로이며, 개별 노드 링크는 하나의 연결 설정만 담고 있습니다. v2rayN에서는 먼저 ‘구독 그룹 설정’을 열어 주소를 추가하고 저장한 다음 구독을 업데이트하세요. v2rayNG에서는 사이드 메뉴에서 구독 그룹 설정으로 이동할 수 있습니다. 나중에 필요한 그룹만 업데이트할 수 있도록 그룹 이름에 출처를 명확히 적어 두는 것이 좋습니다. 가져온 뒤 목록에 노드가 표시되는지 확인하고 하나를 선택해 연결을 테스트하세요. 노드를 하나씩 직접 입력하는 것보다 구독으로 관리하면 편리하지만, 업데이트 성공 여부는 로그에서 확인해야 합니다. 목록에 기존 노드가 남아 있다는 것만으로는 업데이트가 성공했다고 볼 수 없습니다.

구독 가져오기 단계 보기 →

진행 순서

  1. 구독 그룹 설정 → 그룹 추가
  2. 이름과 구독 주소 입력 → 저장
  3. 구독 업데이트 → 결과 확인
  4. 노드 선택 → 연결 시작

구독 주소에는 로그인 정보가 포함될 수 있으므로 스크린샷을 공유할 때는 전체 주소를 가리세요.

클라이언트 업데이트에 따라 설정 메뉴 이름이 달라질 수 있습니다. 같은 이름의 항목을 찾을 수 없다면 데스크톱 v2rayN인지 안드로이드 v2rayNG인지 먼저 확인하세요. 두 클라이언트에서 비슷한 노드 정보를 사용할 수는 있지만 메뉴, 권한 및 트래픽 처리 방식은 서로 다릅니다. 서버 측 전송 매개변수는 서비스 제공업체의 안내를 따르세요.

기기에 맞게 선택

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 확인하세요. 같은 플랫폼이라도 프로세서 아키텍처를 확인해야 합니다. 파일 형식에 따라 설치 방법이 다르며, 노드 프로토콜 지원 여부는 코어와 설정에 따라 달라지므로 설치 파일 이름만으로 판단할 수 없습니다.

Windows

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

데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 화면 구성을 유지합니다. 처음 사용한다면 데스크톱 버전 안내부터 살펴보세요. 기존 사용 방식에 익숙하다면 필요에 따라 전환 여부를 결정하면 됩니다. 어느 인터페이스든 사용할 노드 정보가 필요하며, 설치만으로 연결에 필요한 리소스가 자동 제공되지는 않습니다.

설치하기 전에 ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류와 기기 아키텍처를 확인하세요. 이전할 때는 구독 주소, 라우팅 설정 및 필요한 사용자 지정 설정을 보관하고, 이전 폴더를 새 폴더에 그대로 덮어쓰지 마세요. 처음 실행한 뒤 노드 하나를 테스트하고 시스템 프록시를 설정하세요. 브라우저 연결이 확인된 다음 다른 프로그램까지 처리하도록 TUN 모드를 사용할지 고려하면 됩니다.

macOS

v2rayN은 칩에 맞는 설치 파일을 선택하세요

시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩을 확인하세요. Apple 칩이면 Apple Silicon용 arm64 설치 파일을, Intel 프로세서면 x64 설치 파일을 선택하세요. 먼저 칩을 확인한 뒤 시스템 요구 사항을 살펴보면 다운로드 후 아키텍처가 맞지 않는 상황을 줄일 수 있습니다.

설치가 끝나면 시스템 안내에 따라 앱 실행 권한을 설정한 뒤 구독을 가져오세요. 시스템 프록시, 브라우저 확장 프로그램 프록시, 터미널 프록시는 서로 다른 계층의 설정입니다. 브라우저에서 접속된다고 해서 터미널 프로그램도 같은 경로를 사용하는 것은 아닙니다. 앱마다 동작이 다르면 클라이언트를 다시 설치하기보다 각 앱이 어떤 프록시 설정을 사용하는지 먼저 확인하세요. 다른 네트워크 도구를 사용 중이라면 시스템 프록시를 동시에 변경하지 않도록 주의하세요.

Android

v2rayNG 우선, v2flyNG 대안

대부분의 최신 안드로이드 스마트폰에서는 arm64 설치 파일을 먼저 확인하세요. 기기 아키텍처를 모르면 범용 버전 안내를 살펴보세요. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 대체 클라이언트는 설정 호환성이 필요한 경우 선택하는 것이며, 두 클라이언트를 동시에 실행하는 방식은 아닙니다.

처음 연결할 때 시스템 VPN 연결 권한을 확인하고, 이후에는 앱별 프록시에서 대상 앱이 제외되지 않았는지 살펴보세요. 화면을 잠근 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 먼저 기본 트래픽 처리 범위로 테스트한 뒤 필요한 앱만 지정하도록 범위를 좁히면 노드 문제와 앱 설정 문제를 구분하기 쉽습니다. 업데이트 전에는 구독과 사용자 지정 규칙을 보관하세요. 재설치는 일반적인 문제 해결 방법이 아닙니다.

Linux

v2rayN의 deb 및 rpm 설치 방법

먼저 배포판에서 사용하는 패키지 형식을 확인한 다음 프로세서 아키텍처를 살펴보세요. Debian 및 Ubuntu 계열은 보통 deb, Fedora 등은 보통 rpm 패키지를 사용합니다. 일반적인 데스크톱 PC는 대부분 x64이며, ARM 기기에서는 해당 arm64 파일을 선택해야 합니다. 배포판 이름만으로 판단하지 마세요.

설치 후에는 GUI에서 구독을 가져오고 코어가 실행되는지 확인하세요. 데스크톱 환경의 프록시 설정과 터미널 환경 변수는 서로 동기화되지 않을 수 있습니다. 특정 프로그램이 프록시를 사용하지 않으면 해당 프로그램이 읽는 설정을 따로 확인하세요. TUN을 켠 뒤 로컬 네트워크나 컨테이너 네트워크에 문제가 생기면 TUN을 꺼서 기존 네트워크를 복구한 다음 라우팅과 권한을 점검하세요. 다운로드 페이지에는 패키지 형식과 아키텍처가 구분되어 있어 시스템에 맞는 파일을 선택하기 쉽습니다.

모든 클라이언트 보기 →

빠른 시작 미리보기

구독 가져오기, 연결 및 확인

먼저 가장 짧은 연결 경로를 설정한 뒤 고급 옵션을 조정하세요. 아래 세 단계는 문제 해결의 기준을 세우는 데 도움이 됩니다. 한 번에 한 항목만 변경하고 전후 결과를 기록하면 코어, DNS, 라우팅을 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.

  1. 노드 정보를 가져오고 출처와 유형 확인

    사용 가능한 구독 주소나 개별 노드 링크를 준비하세요. 구독 주소는 구독 그룹 설정에 입력하고, 개별 링크는 클립보드에서 가져오기 등 노드 가져오기 메뉴를 이용하세요. 웹 주소, 구독 주소, 노드 링크는 서로 다른 종류이므로 같은 항목에 붙여 넣지 마세요. 가져온 뒤 노드가 표시되는지와 이름이 적절한지 확인하고, 업데이트 로그에 오류가 있는지도 살펴보세요.

    v2rayN과 v2rayNG는 클라이언트 도구이며, 설치만으로 서버가 제공되지는 않습니다. 구독 업데이트에 실패하면 주소가 완전한지, 만료되지 않았는지, 현재 네트워크에서 업데이트 주소에 접근할 수 있는지 먼저 확인하세요. 이전 노드가 목록에 남아 있어도 로컬 데이터가 보존된 것일 뿐, 이번 업데이트가 성공했다는 뜻은 아닙니다. 도움을 요청하며 스크린샷을 공유할 때는 주소에 포함된 인증 정보와 노드 인증 정보를 가리세요.

  2. 노드를 선택하고 트래픽 처리 방식 확인

    현재 연결에 사용할 노드 하나를 먼저 선택하고 여러 설정을 한꺼번에 변경하지 마세요. 데스크톱 v2rayN에서는 시스템 프록시와 적절한 라우팅 모드부터 사용할 수 있습니다. 안드로이드 v2rayNG를 시작할 때는 시스템 VPN 연결 요청을 승인해야 합니다. 권한 요청은 시스템에서 표시됩니다. 승인한 뒤 클라이언트가 정상 실행되는지, 대상 앱이 트래픽 처리 범위에 포함되는지 확인하세요.

    라우팅 모드는 코어에 들어온 트래픽을 어떻게 나눌지 결정하고, 시스템 프록시나 VPN 서비스는 트래픽이 클라이언트로 들어올지를 결정합니다. 두 설정은 서로 다른 문제를 해결합니다. 브라우저 확장 프로그램에서 별도 프록시를 지정했거나 안드로이드에서 앱별 제외를 설정했다면 대상 프로그램이 현재 연결을 우회할 수 있습니다. 먼저 이해하기 쉬운 기본 설정으로 되돌려 연결을 확인한 다음 특수 규칙을 하나씩 추가하세요.

  3. 대상 앱으로 확인하고 정상 설정 보관

    실제로 사용할 웹페이지나 앱을 열어 정상적으로 로드되는지 확인하고 클라이언트 로그도 살펴보세요. 연결 스위치가 켜져 있거나 노드 테스트 결과가 표시되는 것만으로 실제 접속이 확인되는 것은 아닙니다. 웹페이지가 열리지 않으면 먼저 시스템 시간을 확인한 다음 DNS, 노드 매개변수 및 라우팅을 점검하세요. 특정 앱만 문제라면 앱 자체 프록시를 사용 중인지, 앱별 규칙에서 제외되었는지 살펴보세요.

    테스트를 마치면 현재 노드, 라우팅 모드 및 DNS 설정을 기록해 다음 조정의 기준으로 삼으세요. 이후 TUN을 활성화하거나 사용자 지정 규칙을 추가할 때는 항목을 하나씩 적용하고 매번 다시 테스트하세요. 문제가 생기면 모든 옵션을 초기화하지 말고 직전의 정상 상태로 되돌리면 됩니다. 화면별 조작 안내가 필요하면 가이드를, 설정 항목 간 관계를 알고 싶다면 JSON 가이드를 확인하세요.

전체 가이드 보기 →

클라이언트와 코어의 관계

Project V, V2Fly 및 Xray

생태계의 관계를 이해하면 설정이 적용되는 범위를 파악하기 쉽습니다. 이름이 비슷한 제품이라고 해서 모든 옵션을 서로 바꿔 쓸 수 있는 것은 아닙니다. GUI 클라이언트, 실행 코어, 프로토콜의 차이를 먼저 알아 두면 가이드를 읽을 때 서로 다른 계층의 설정을 혼동하지 않을 수 있습니다.

생태계의 역사: 이름은 비슷해도 역할은 다릅니다

Project V는 V2Ray 생태계를 이해하는 출발점입니다. V2Ray는 인바운드, 아웃바운드, 라우팅 등의 기능을 설정 가능한 네트워크 도구로 구성합니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어 가고 있으며, Xray는 V2Ray 관련 코드에서 발전해 자체 기능과 설정 방향을 확장해 왔습니다. 이들은 같은 제품에 스킨만 다르게 입힌 것이 아닙니다. 이름만으로 특정 새 프로토콜이나 설정 항목의 지원 여부를 판단해서도 안 됩니다.

일반 사용자가 가장 자주 접하는 것은 GUI 클라이언트입니다. 클라이언트는 구독, 노드 목록, 시스템 프록시, 로그 메뉴를 조작하기 쉬운 화면으로 구성하고, 코어는 그 뒤에서 실제 데이터 처리를 담당합니다. 따라서 화면에 옵션이 표시된다고 해서 모든 코어가 같은 매개변수를 받아들이는 것은 아닙니다. 가이드를 따라 하기 전에 해당 가이드가 어떤 조합을 기준으로 하는지 확인하세요.

코어 계열: 설정 요구에 맞춰 선택

v2rayNG는 Xray 코어를 사용하는 안드로이드 오픈소스 클라이언트이며, v2flyNG는 V2Fly 코어를 사용하는 안드로이드 대안입니다. v2rayN은 데스크톱용이며, 실제 프로토콜 지원은 사용하는 코어와 지원 범위에 따라 달라집니다. 노드 링크에 표시된 프로토콜 이름은 설정의 일부일 뿐입니다. 전송 방식, TLS, 서버 이름 및 기타 매개변수도 연결에 영향을 줍니다.

VMess, VLESS, Trojan은 GUI의 모양을 나타내는 이름이 아니며 속도 순위로 단순하게 나눌 수도 없습니다. 실제 성능은 서버 구현, 네트워크 경로, 전송 설정 및 로컬 환경에 따라 달라집니다. 현재 설정이 정상 작동한다면 이름이 바뀌었다는 이유만으로 옮길 필요는 없습니다. 특정 기능이 필요할 때 클라이언트, 코어 및 서버가 모두 이를 지원하는지 확인하세요.

오픈소스 라이선스: 프로젝트별 라이선스 이해

v2rayN, v2rayNG 및 v2flyNG는 모두 공개 소스 코드와 커뮤니티 관리 기반을 갖추고 있으며 클라이언트는 무료로 사용할 수 있습니다. 코어 차원에서 V2Fly의 V2Ray core와 Xray core는 MPL 2.0 라이선스를 사용합니다. GUI 클라이언트에는 각각 별도의 라이선스 조건이 있습니다. 클라이언트와 호출하는 코어는 서로 다른 프로젝트이므로 한 프로젝트의 라이선스 안내를 전체 소프트웨어의 모든 조건에 적용할 수 없습니다.

일반적인 설치 및 사용과 코드를 수정한 뒤 재배포하는 것은 서로 다른 상황입니다. 2차 개발이나 재패키징을 하려면 관련 프로젝트의 라이선스 파일을 각각 읽고 소스 코드, 고지 및 배포 의무를 확인하세요. 이 사이트는 사용법과 설정 안내를 중심으로 다룹니다. 오픈소스 정보는 프로젝트 간 관계를 설명하기 위한 것이며, 구체적인 소프트웨어 라이선스를 대신하거나 이 사이트가 해당 프로젝트 개발에 참여했음을 뜻하지 않습니다.

업데이트 확인: 인터페이스, 코어, 규칙을 따로 살펴보세요

클라이언트 업데이트에는 인터페이스와 종속 항목이 포함될 수 있고, 코어 업데이트는 프로토콜 동작이나 설정 항목 지원에 변화를 줄 수 있습니다. GeoIP 및 GeoSite 데이터 업데이트는 일부 라우팅 규칙의 매칭 대상에 영향을 줍니다. 이 세 가지 변경 사항은 각각 구분해서 이해해야 합니다. 업데이트 후 동작이 달라졌다면 변경 내역과 로그를 먼저 살펴보고 기존 라우팅 및 DNS 설정을 그대로 사용 중인지 확인하세요. 모든 변화를 노드 탓으로 돌리지 마세요.

업데이트 전에는 복구할 수 있도록 설정을 보관하고, 업데이트 후에는 기본 연결부터 확인한 다음 사용자 지정 규칙을 테스트하세요. 이전 가이드의 메뉴 이름이 바뀌었을 수 있고, 설정 예시가 특정 코어에서만 작동할 수도 있습니다. 이 사이트에서는 기본 조작을 가이드 페이지에, 구조와 설정 항목 설명을 JSON 가이드에, 문제 해결 사례를 사용 팁에 정리합니다. 현재 겪는 증상에 맞춰 찾아볼 수 있습니다.

사용 팁

연결 문제와 속도 저하 해결

‘연결이 안 된다’는 같은 증상도 원인은 앱, 시스템 프록시, DNS, 라우팅 또는 서버에 있을 수 있습니다. 아래 글에서는 증상별 점검 경로를 안내합니다. 먼저 문제가 발생한 범위를 확인한 다음 필요한 항목을 조정해, 반복적인 재설치로 실제 원인을 놓치지 않도록 하세요.

V2Ray 속도 저하 단계별 점검: 노드, 네트워크 경로와 로컬 설정

속도 저하 원인을 노드 부하, 네트워크 경로, 전송 프로토콜, 로컬 설정의 네 단계로 나누어 비교 테스트하고 병목과 조정할 항목을 찾습니다.

웹페이지 응답 지연과 대용량 파일 다운로드 지연은 원인이 다를 수 있습니다. 앱과 테스트 조건을 고정한 뒤 노드와 네트워크 환경을 비교하면 일시적인 변동으로 잘못 판단할 가능성을 줄일 수 있습니다. 연결 테스트 한 번만으로 네트워크 품질을 단정하지 마세요.

단계별 점검 방법 보기 →

노드는 연결됐는데 웹페이지가 열리지 않을 때: 단계별 점검 목록

시간 동기화, DNS 설정, 라우팅 규칙, 앱별 프록시부터 노드까지 순서대로 확인해 ‘연결됨’으로 표시되지만 인터넷에 접속할 수 없는 원인을 찾습니다.

먼저 모든 앱에 문제가 있는지, 특정 앱만 열리지 않는지 구분하세요. 로그를 확인해 요청이 코어에 들어갔는지 판단하면 트래픽이 처리되지 않는 상태에서 노드만 반복해서 바꾸는 일을 피할 수 있습니다. 트래픽이 코어에 들어오는데도 이름 확인에 실패한다면 DNS 경로를 점검하세요.

연결 점검 목록 보기 →

v2rayN 시스템 프록시가 작동하지 않을 때: 브라우저와 터미널 따로 점검하기

브라우저가 프록시를 사용하지 않는다면 확장 프로그램이나 PAC 설정을, 터미널이 사용하지 않는다면 환경 변수를 확인하세요. 두 경로의 설정을 따로 점검하고 확인 명령도 안내합니다.

시스템 프록시는 모든 프로그램이 따르는 공통 스위치가 아닙니다. 문제를 점검할 때는 먼저 앱이 어느 계층의 설정을 읽는지 확인한 다음 로컬 수신 주소와 포트를 살펴보세요. 브라우저 확장 프로그램, 터미널 환경 및 클라이언트 라우팅 규칙은 각각 따로 확인해야 합니다.

시스템 프록시 점검 기록 보기 →

모든 글 보기 →