Project V · 클라이언트 및 설정 레퍼런스

V2Ray 입문 가이드 v2rayN 다운로드 및 설정

구독 가져오기부터 라우팅 분할까지, 클라이언트 메뉴와 JSON 필드를 대조해 로컬 포트, 시스템 프록시, DNS를 확인하세요.

  • VLESS / VMess
  • Trojan / REALITY
  • Xray · V2Fly
플랫폼 선택
메뉴를 찾은 다음 필드를 수정하세요

클라이언트 설정
및 구성 메뉴

먼저 세 가지를 구분하세요. 구독은 원격 연결 정보를 저장하고, 시스템 프록시는 앱의 요청을 클라이언트로 보낼지 결정하며, 라우팅은 코어에 들어온 연결의 출구를 결정합니다. 가져오기에 성공했다는 것은 설정을 읽었다는 뜻일 뿐, 브라우저가 프록시를 사용한다는 의미는 아닙니다.

오른쪽에는 자주 쓰는 메뉴를 기준으로 설정을 여섯 가지로 정리했습니다. 구독 그룹 하나와 사용할 연결 하나를 먼저 설정한 뒤 라우팅과 DNS를 조정하세요. 한 번에 한 항목씩만 수정하고 변경 전 값을 기록해 두면, 오류가 발생했을 때 로그 변화와 작업을 연결해 원인을 찾을 수 있습니다.

설정 필드 보기 →

메뉴 이름은 인터페이스 업데이트에 따라 달라질 수 있습니다

같은 버튼을 찾을 수 없다면 ‘구독 그룹’, ‘매개변수 설정’, ‘라우팅 설정’ 메뉴를 찾아보세요. 그림은 설정 간의 관계를 설명하며 연결 상태를 보여 주는 것은 아닙니다. 코드의 direct는 정의된 아웃바운드 태그와 연결해야 합니다. 규칙 한 줄만 복사해서 전체 설정이 작동하리라 기대해서는 안 됩니다.

구독 링크 및 그룹 업데이트

구독은 여러 연결을 한곳에서 관리할 때 유용합니다. v2rayN에서 ‘구독 그룹 설정’을 열고 새 그룹을 추가한 다음 전체 주소를 붙여 넣고 저장한 뒤 ‘구독 업데이트’를 실행하세요. Android에서는 ‘구독 그룹 설정’에 주소를 입력하고 메인 화면으로 돌아가 업데이트하면 됩니다. 공유 링크를 하나씩 가져오는 방식과 달리, 구독은 그룹 단위로 나중에 새로 고칠 수 있습니다. 업데이트 오류가 발생하면 주소의 유효 기간, 시스템 시간, 네트워크 경로부터 확인하세요. 기존 그룹을 반복해서 삭제하지 마세요. 구독 주소에 접속 인증 정보가 포함될 수 있으므로 스크린샷이나 문의용 로그에 전체 링크가 보이지 않도록 가리세요.

  • 구독 그룹 설정 → 주소(Url)
  • 구독 업데이트 → 프록시 사용 안 함 / 프록시 사용
  • 자동 업데이트 간격 → 필요에 따라 설정
먼저 운영체제를 고르고, 다음으로 아키텍처를 선택하세요

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요. 설치 패키지의 아키텍처는 기기의 프로세서에 따라 달라지며 구독에 사용된 프로토콜과는 관계가 없습니다. 아래 링크를 누르면 다운로드 페이지의 해당 플랫폼 영역으로 이동합니다. 기기에 맞는 설치 패키지를 선택하세요.

Windows

v2rayN · 데스크톱 클라이언트

다운로드 페이지에서 Desktop 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 전자는 크로스 플랫폼 인터페이스를 사용하고, 후자는 익숙한 기존 레이아웃을 유지합니다. 선택하기 전에 시스템 요구 사항을 확인하세요. 기존 설정이 있는 기기라면 먼저 백업을 내보내고, 유일한 작업 설정 파일을 바로 덮어쓰지 마세요.

처음 실행한 뒤 구독을 가져오고 사용할 연결을 선택한 다음 시스템 프록시를 설정하세요. 브라우저에서 여전히 접속할 수 없다면 로컬 포트를 다른 프로그램이 사용 중인지, 보안 프로그램이 클라이언트의 코어 실행을 차단하는지 확인하세요. 재설치하기 전에 로그에 표시된 구체적인 오류부터 살펴보세요.

다운로드 페이지로 이동

macOS

v2rayN · 칩에 맞는 버전 선택

시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 이름이 표시되는지 Intel 프로세서가 표시되는지 확인하세요. Apple Silicon 기기는 arm64, Intel 기기는 x64를 선택합니다. 기기 출시 연도만 보고 판단하지 말고 먼저 아키텍처를 확인한 뒤 다운로드 페이지에서 해당 설치 파일을 고르세요.

설치한 뒤 현재 네트워크 서비스에 시스템 프록시가 적용되었는지 확인하세요. Wi-Fi와 유선 네트워크에 서로 다른 설정이 저장되어 있을 수 있습니다. 네트워크를 바꾼 뒤 연결에 문제가 생기면 현재 서비스의 프록시 주소와 포트를 다시 확인하세요. 프록시를 별도로 설정하는 앱은 해당 앱 내부 설정도 확인해야 합니다.

다운로드 페이지로 이동

Android

v2rayNG · v2flyNG

먼저 Xray 코어를 사용하는 v2rayNG를 확인하고, V2Fly 코어 환경이 필요하면 v2flyNG를 살펴보세요. 비교적 최신 기기에서는 보통 arm64를 선택합니다. 아키텍처를 모르겠다면 범용 패키지 안내를 확인하세요. 두 클라이언트는 설정을 각각 관리하므로 하나를 설치해도 다른 클라이언트의 구독이 자동으로 옮겨지지 않습니다.

처음 연결할 때는 시스템 VPN 권한을 확인해야 합니다. 다른 VPN 앱이 동시에 실행 중이면 연결에 영향을 줄 수 있으므로 현재 어떤 앱이 트래픽을 처리하는지 먼저 확인하세요. ‘앱별 프록시’를 켠 뒤에는 허용 목록인지 제외 목록인지 살펴보고, 테스트할 브라우저가 제외되지 않았는지 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN · deb / rpm

먼저 배포판의 패키지 형식에 따라 deb 또는 rpm을 선택하고, 다음으로 x64와 arm64를 구분하세요. 데스크톱 클라이언트는 그래픽 환경에서 구독과 라우팅을 관리하는 데 적합합니다. 패키지 형식이 같아도 시스템별 의존성은 다를 수 있으므로 설치 전에 다운로드 페이지의 시스템 요구 사항을 읽어보세요.

데스크톱 환경과 앱에 따라 시스템 프록시를 처리하는 방식이 다를 수 있습니다. 브라우저에서는 접속되지만 다른 프로그램에서 실패한다면, 해당 프로그램이 데스크톱 프록시 설정을 읽는지 확인한 뒤 앱 자체의 HTTP 또는 SOCKS 설정을 살펴보세요. 앱 하나가 프록시에 연결되지 않는 것을 구독 전체의 문제로 오해하지 마세요.

다운로드 페이지로 이동

클라이언트는 로컬 연결 도구이며 구독과 원격 서비스는 별도로 설정해야 합니다. 플랫폼을 바꿀 때 호환되는 구독은 재사용할 수 있지만, 시스템 프록시, 앱 적용 범위, 로컬 포트는 각 기기에서 따로 확인해야 합니다.

클라이언트 전체 보기 →
인터페이스, 코어, 프로토콜을 나눠서 확인하세요

Project V와 오픈 소스 코어 생태계

‘V2Ray’는 여러 도구와 설정 방식을 통칭하는 말로 자주 쓰입니다. 문제를 진단할 때는 클라이언트 이름, 코어 유형, 연결 프로토콜을 구체적으로 확인해야 합니다. 같은 인터페이스에서 링크를 가져올 수 있다고 해서 기반 코어가 링크의 모든 매개변수를 지원하는 것은 아닙니다.

Project V

설정 및 프록시 도구 생태계

로컬 인바운드로 요청을 받은 뒤 규칙에 따라 아웃바운드를 선택합니다. 그래픽 클라이언트는 이 구조에 메뉴와 설정 관리 기능을 제공합니다.

  • V2Fly → 커뮤니티가 이어서 유지 관리하는 V2Ray 프로젝트
  • Xray → V2Ray에서 발전한 독립 코어 프로젝트
  • v2rayN / v2rayNG / v2flyNG → 그래픽 관리 클라이언트

Project V: 먼저 설정 구조 이해하기

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 프로젝트 생태계이며, V2Ray는 그중 널리 사용되는 구현입니다. 설정은 일반적으로 수신 지점, 원격 연결, 라우팅 매칭, DNS 동작을 서로 다른 모듈로 나눕니다. 이렇게 구성하면 문제를 단계별로 찾기 쉽습니다. 앱 요청 기록이 없으면 진입점을 확인하고, 요청 기록은 있지만 잘못된 출구로 전달되면 라우팅을 확인하세요. 도메인으로 접속할 수 없지만 IP 주소로는 가능하다면 DNS를 살펴보면 됩니다. 한 번의 테스트에서 구독, 코어, DNS를 동시에 바꾸면 어떤 변경이 영향을 줬는지 판단하기 어렵습니다.

V2Fly와 Xray: 공통된 배경이 있어도 필드가 모두 호환되는 것은 아닙니다

V2Fly는 커뮤니티가 V2Ray 프로젝트를 이어서 유지 관리하고 있습니다. Xray는 V2Ray에서 발전한 뒤 독립적인 기능 개발 경로를 형성했습니다. 두 프로젝트는 일부 개념과 설정 방식을 공유하지만, 프로토콜 지원, 보안 매개변수, 필드 세부 사항은 구현에 따라 다를 수 있습니다. ‘알 수 없는 필드’ 또는 ‘지원하지 않는 프로토콜’ 오류가 표시되면 먼저 어떤 코어가 실행 중인지 확인하고 해당 코어의 문서를 대조하세요. REALITY는 전송 보안 관련 설정입니다. 링크 제목만으로 호환성을 판단해서는 안 되며, 모든 프로토콜에 그대로 적용할 수 있는 독립 노드 유형으로 취급해서도 안 됩니다.

클라이언트 3종: 그래픽 인터페이스로 연결 매개변수 관리

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. v2rayN은 데스크톱에서 구독, 라우팅, 코어를 관리하고, v2rayNG는 주로 Android와 Xray 코어를 지원하며, v2flyNG는 Android에서 V2Fly 코어를 선택할 수 있습니다. 각 프로젝트의 오픈 소스 라이선스는 해당 프로젝트에서 별도로 정하므로 한 코어의 라이선스를 모든 클라이언트에 적용할 수는 없습니다. 이름이 비슷한지를 기준으로 대체 가능성을 판단하지 말고, 운영체제와 필요한 기능을 확인한 뒤 기존 설정과 호환되는지 살펴보세요.

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

세 업데이트는 대상이 서로 다릅니다. 클라이언트 업데이트는 인터페이스와 설정 생성 로직을 바꾸고, 코어 업데이트는 실제 연결 구현을 바꾸며, 구독 업데이트는 주로 서비스 제공자가 배포한 연결 매개변수를 새로 고칩니다. 도메인과 주소 매칭에 사용하는 규칙 파일은 또 다른 리소스입니다. 구독 업데이트에 성공해도 시스템 프록시가 자동으로 켜지지는 않으며 규칙 데이터베이스가 최신 상태라는 보장도 없습니다. 업데이트하기 전에 구독 그룹과 사용자 지정 규칙을 백업하고 안내를 확인한 다음 하나씩 진행하세요. 문제가 발생하면 ‘안 됨’이라고만 기록하지 말고 오류 메시지 원문을 남기세요.

증상에 맞는 설정 찾기

가져오기는 성공했는데 브라우저가 여전히 프록시를 사용하지 않는 이유는 무엇인가요?

가져오기는 연결 매개변수를 저장하는 단계일 뿐입니다. 사용할 연결을 선택하고 시스템 프록시가 켜져 있는지 확인한 다음 브라우저가 시스템 설정을 따르는지 살펴보세요. 로그에 해당 요청이 없다면 원격 포트를 바로 수정하지 말고 진입점부터 확인하세요. 순서는 시스템 프록시 설정을 참고하세요.

전역 프록시가 모든 프로그램의 트래픽을 처리하나요?

라우팅의 전역 설정은 보통 코어에 들어온 연결의 아웃바운드 선택에 영향을 주며, 모든 프로그램이 프록시를 사용하도록 강제하지는 않습니다. 터미널, 게임, 독립 네트워크 구성 요소는 자체 프록시 설정이 필요할 수 있습니다. 먼저 앱 요청이 어디로 들어오는지 확인한 다음 트래픽 분할 여부를 살펴보세요. 자세한 내용은 연결 확인 방법을 참고하세요.

공유 링크와 전체 설정 파일은 어떻게 다른가요?

공유 링크는 보통 원격 연결 하나를 설명하고, 전체 설정에는 로컬 수신, DNS, 규칙도 포함됩니다. 공유 링크를 가져오면 클라이언트가 로컬 설정을 결합해 실행 설정을 생성합니다. 설정 파일을 구독 주소 입력란에 넣지 마세요. 먼저 JSON 구조 개요를 확인하세요.

노드 속도 테스트 결과만으로 실제 접속을 확인할 수 있나요?

개별 테스트 결과는 해당 테스트 대상과 요청 방식만 보여 줍니다. 테스트에 응답이 왔다고 해서 모든 앱, 도메인, 프로토콜이 정상이라는 뜻은 아닙니다. 연결을 선택한 뒤 실제 앱으로 접속하고 로그와 대조하세요. 연결 매개변수를 바꿔야 한다면 프로토콜 매개변수 안내를 먼저 확인하세요.

설정 필드를 읽을 때는 inbounds 인바운드에서 outbounds 아웃바운드까지 연결 경로를 따라간 뒤 routing, dns, policy를 확인하세요. 설정 예시는 필드 간 관계를 설명하기 위한 것입니다. 실제 포트, 태그, 서버 매개변수는 기기에 설정된 값을 기준으로 해야 합니다.

사용 상황에 맞는 가이드 보기

최근 설정 가이드

첫 연결을 마쳤다면 공유, 기기 이전, DNS 처리 방식을 차례로 확인하세요. 각 가이드는 하나의 작업 상황을 다룹니다. 적용 조건을 먼저 확인한 뒤 클라이언트 설정을 변경하세요. 인증 정보나 주소가 포함된 스크린샷은 민감한 내용을 가린 후 공유해야 합니다.

고급 설정

v2rayN LAN 연결 허용 설정: TV 셋톱박스 및 다른 컴퓨터와 프록시 포트 공유하기

v2rayN에서 LAN 연결을 허용한 뒤 로컬 주소와 포트를 확인하는 방법, TV 셋톱박스나 다른 컴퓨터에 프록시를 설정하는 방법, 방화벽 설정 시 주의 사항을 안내합니다.

먼저 연결할 기기가 지원하는 프록시 프로토콜을 확인한 다음 수신 포트와 네트워크 범위를 대조하세요. 공유하는 컴퓨터의 루프백 주소는 다른 기기에 입력할 수 없습니다.

공유 설정 보기 →
플랫폼

v2rayN·v2rayNG 기기 간 설정 동기화: 구독 공유, 설정 백업 및 QR 코드로 이전하기

컴퓨터와 Android 기기 간 설정을 동기화하는 여러 방법을 비교합니다. 구독 링크 공유, 설정 파일 내보내기, QR 코드로 노드 하나 공유하기를 살펴보고 각각 적합한 상황을 설명합니다.

원격 연결을 옮기는 작업과 로컬 규칙을 옮기는 작업은 다릅니다. 새 기기로 가져온 뒤에도 시스템 프록시, 앱 적용 범위, DNS 설정을 확인해야 합니다.

기기 이전 가이드 보기 →
문제 해결

V2Ray DNS 누출 테스트 및 방지 설정: dns 모듈, FakeDNS, 라우팅 연동

DNS 요청이 프록시를 우회했는지 확인하는 방법을 설명한 뒤, dns 모듈의 서버 그룹과 FakeDNS, 라우팅 규칙을 연동하는 누출 방지 설정을 안내합니다.

테스트 결과는 앱의 DNS 해석 방식과 함께 살펴봐야 합니다. 시스템 DNS와 코어 DNS를 먼저 구분한 뒤 어느 계층을 수정할지 결정하세요. 서버 주소만 바꾸고 질의 경로를 놓치지 않도록 주의해야 합니다.

DNS 문제 해결 가이드 보기 →