Project V 생태계 · GUI 클라이언트

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

기기에 맞는 오픈 소스 클라이언트를 선택하고 구독을 가져온 다음 규칙으로 라우팅을 설정하세요.

VMessVLESSTrojanREALITY
코어 계열
XrayV2Fly

코어에 따라 인식할 수 있는 프로토콜과 전송 매개변수가 달라집니다.

V2Fly / Xray 코어 라이선스
MPL 2.0

라이선스는 프로젝트별로 다르며, 코어와 인터페이스는 각각 관리됩니다.

01 운영체제별 다운로드

운영체제별 V2Ray 클라이언트 다운로드

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 살펴보세요. 설정이 V2Fly에 명확히 의존하는 경우에만 v2flyNG를 고려하면 됩니다.

v2rayN · Desktop / WPF

처음 설치한다면 Desktop 버전부터 시작해 보세요. 다른 데스크톱 플랫폼과 인터페이스가 비슷합니다. 기존 가이드가 클래식 인터페이스 화면을 기준으로 하거나 클래식 트레이 메뉴에 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 인터페이스 선택지이며 프록시 프로토콜이 서로 다른 것은 아닙니다.

다운로드 페이지로 이동

v2rayN · Apple Silicon / Intel

‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple 칩이면 arm64, Intel 프로세서면 x64를 선택하면 됩니다. 두 설치 파일에서 구독과 라우팅을 설정하는 방법은 같습니다. 기기 외관이나 구매 연도, 운영체제 이름이 아니라 칩을 기준으로 선택하세요.

다운로드 페이지로 이동

v2rayNG / v2flyNG

일상적인 사용에는 Xray 코어를 탑재한 v2rayNG를 우선 권장합니다. 기존 V2Fly 설정과 맞춰야 한다면 v2flyNG를 확인하세요. 시스템이 arm64를 지원하면 해당 경량 패키지를 선택할 수 있고, 아키텍처를 모르면 범용 패키지를 선택하세요. 범용 패키지는 더 많은 아키텍처를 지원하지만 대체로 용량이 큽니다.

다운로드 페이지로 이동

v2rayN · deb / rpm

먼저 배포판에 맞는 패키지 형식을 선택하세요. Debian 계열은 보통 deb, Fedora 계열은 rpm을 사용합니다. 그런 다음 시스템 아키텍처에 따라 x64 또는 arm64를 고르세요. 패키지 형식은 설치 방법만 결정하며 사용할 수 있는 노드 유형과는 관계없습니다. 설치 후 데스크톱 앱 메뉴에서 GUI 클라이언트를 실행하세요.

다운로드 페이지로 이동

전체 클라이언트 보기

02 설정 가이드

구독 가져오기, 프록시 모드와 라우팅

구독은 ‘사용할 수 있는 노드’를, 프록시 모드는 ‘어떤 트래픽이 클라이언트로 들어오는지’를, 라우팅은 ‘들어온 트래픽이 어떤 아웃바운드로 나가는지’를 결정합니다. 연결에 문제가 생기면 먼저 어느 단계의 문제인지 확인한 뒤 해당 설정을 점검하세요.

v2rayN / v2rayNG

구독 주소를 저장해 최신 목록으로 업데이트하기

v2rayN에서 ‘구독 그룹 설정’을 열고 그룹 이름과 구독 주소를 입력해 저장한 다음, 구독 메뉴에서 업데이트하세요. v2rayNG에서는 사이드 메뉴의 ‘구독 그룹 설정’에 주소를 추가하고 메인 화면 메뉴에서 업데이트하면 됩니다. 클립보드에서 공유 링크 하나를 가져오는 것과 달리, 구독은 같은 주소를 반복해서 불러옵니다. 업데이트 후 목록이 달라질 수 있습니다. 목록이 비어 있다면 주소가 로그인이 필요한 웹페이지가 아니라 구독 내용을 반환하는지 확인한 뒤, 현재 선택된 그룹도 살펴보세요.

구독 그룹 설정 → 구독 업데이트

연결에 성공해도 규칙이 적용된 것은 아닙니다

프록시가 켜졌다는 것은 클라이언트에서 연결 방식을 설정했다는 뜻일 뿐입니다. 특정 규칙의 적용 여부를 확인하려면 앱의 트래픽이 클라이언트로 들어오는지, 요청에서 도메인 이름과 IP 주소 중 무엇을 사용하는지, 앞선 광범위한 규칙이 먼저 일치하지 않았는지를 확인하세요. 직접 연결해야 하는 로컬 대상 하나와 프록시를 거쳐야 하는 대상 하나를 각각 테스트하면 웹페이지 한 번 열어 보는 것보다 문제를 찾기 쉽습니다.

정상 작동하는 설정부터 보존하기

현재 노드, 연결 방식, 라우팅 설정을 기록한 뒤 새 방법을 시도하세요. 노드 교체와 TUN 전환, DNS 변경을 동시에 하면 실패 원인을 찾기 어렵습니다. 되돌릴 때는 변경한 순서대로 하나씩 취소하세요. 기록에는 설정 이름과 결과를 남기되, 공개적으로 사용할 수 있는 구독 주소는 포함하지 마세요.

라우팅 전체 안내서 보기

03 첫 연결

구독 가져오기부터 연결 확인까지

설정 하나, 연결 방식 하나, 테스트 대상 두 개로 첫 연결을 확인하세요. 먼저 같은 조건에서 반복할 수 있는 기준 상태를 만든 다음 노드와 규칙을 더 추가하면 됩니다.

  1. 가져온 뒤 노드 선택하기

    ‘구독 그룹 설정’을 열고 주소를 추가한 다음 업데이트하세요. 목록이 표시되면 메인 화면으로 돌아가 노드 하나를 선택하세요. vmess:// 또는 vless:// 공유 링크를 받았다면 구독 주소 입력란에 붙여 넣지 말고 클립보드에서 가져오세요.

    구독이 여러 개라면 그룹 이름을 지정하고 방금 업데이트한 그룹으로 전환해 이전 설정을 테스트하지 않도록 하세요. 공유 링크 하나만 가져온 경우 나중에 매개변수가 바뀌면 다시 가져오거나 직접 수정해야 합니다. 구독 업데이트만으로 자동 반영되지는 않습니다.

  2. 테스트할 앱 연결하기

    v2rayN에서는 먼저 트레이 메뉴에서 시스템 프록시를 설정한 뒤 브라우저로 테스트할 수 있습니다. v2rayNG에서는 설정을 선택하고 연결 버튼을 누른 다음 운영체제의 네트워크 연결 요청을 확인하세요. 두 클라이언트의 연결 방식은 다르지만, 먼저 사용할 노드를 선택해야 합니다.

    데스크톱 브라우저에서는 연결되지만 다른 앱이 연결되지 않는다면 해당 앱에 별도의 프록시 설정이 있는지 확인하세요. 모바일 기기에서 다른 앱이 가상 네트워크 인터페이스를 사용 중이라면, 현재 어떤 앱이 네트워크를 제어하는지 확인한 뒤 다시 연결하세요.

  3. 직접 연결과 프록시 연결을 각각 확인하기

    먼저 평소에 접속할 수 있는 대상을 열어 앱이 요청을 보낼 수 있는지 확인하세요. 그런 다음 직접 연결해야 하는 로컬 서비스와 규칙에 따라 프록시를 거쳐야 하는 대상을 하나씩 확인하세요. 클라이언트 로그를 비교해 두 요청이 코어에 전달되고 예상한 아웃바운드 규칙에 일치하는지 살펴보세요.

    두 대상 모두 실패하면 먼저 연결이 수립됐는지 확인하세요. 하나만 실패한다면 해당 대상의 규칙과 DNS 해석 상태를 점검하세요. 연결을 끊은 뒤 다시 테스트하면 페이지 캐시로 인한 오판을 줄이고 운영체제의 네트워크 설정이 원래대로 복구됐는지도 확인할 수 있습니다.

전체 사용법 보기

04 프로젝트 생태계

Project V, V2Fly와 Xray

GUI 클라이언트는 설정을 편집하고 코어는 설정을 읽어 연결을 처리합니다. 두 계층을 구분해야 인터페이스, 프로토콜 매개변수, 규칙 처리 결과 중 어디를 확인할지 판단할 수 있습니다.

클라이언트설정 편집, 구독 관리, 상태 표시
코어인바운드 수신, 규칙 매칭, 아웃바운드 연결
원격 설정상대 서버가 허용하는 프로토콜, 전송 방식, 보안 매개변수 결정

프로젝트 소개 보기

Project V에서 커뮤니티 유지보수까지

Project V는 원래 프로젝트 생태계의 이름이며 V2Ray는 그중 하나인 프록시 코어입니다. 초기 프로젝트는 인바운드, 아웃바운드, 라우팅을 통해 ‘연결 수신’, ‘경로 선택’, ‘연결 시작’을 분리해 하나의 설정으로 다양한 요청을 처리할 수 있도록 했습니다. 이후 V2Fly 커뮤니티가 핵심 개발과 문서 관리를 이어 왔습니다. 일상적으로 말하는 ‘V2Ray 설치’는 실제로 특정 GUI 클라이언트를 설치하는 것을 가리키는 경우가 많습니다. 문제를 확인할 때는 정확한 프로그램 이름부터 파악하세요. 같은 규칙도 코어에 전달되기 전에 클라이언트 인터페이스에 따라 생성되거나 수정될 수 있습니다.

V2Fly와 Xray의 호환 범위

Xray는 V2Ray 코어에서 파생되어 독립적으로 개발되는 코어입니다. 도메인이나 주소로 규칙을 매칭한 뒤 정의된 아웃바운드 태그를 참조하는 등 V2Fly와 공유하는 설정 개념이 많지만, 사용할 수 있는 매개변수가 모두 같지는 않습니다. VMess, VLESS, Trojan은 프로토콜 이름이고 REALITY는 전송 보안 방식이므로 앞의 세 프로토콜과 서로 바꿔 쓸 수 있는 노드 유형이 아닙니다. 설정을 받았다면 프로토콜, 전송 방식, 보안 계층을 각각 대조하세요. 드롭다운에 특정 프로토콜이 표시된다는 이유만으로 원격 설정의 요구사항을 모두 충족한다고 판단해서는 안 됩니다.

세 가지 GUI 클라이언트의 역할

v2rayN은 데스크톱용 클라이언트로, 노드 목록과 구독 그룹, 프록시 설정을 한 화면에서 관리합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고, v2flyNG도 Android용이지만 V2Fly 코어를 사용합니다. 세 클라이언트는 모두 오픈 소스로 관리되며, 지원 기능은 코어와 클라이언트의 설정 항목 지원 범위에 따라 달라집니다. 사용할 수 있는 노드가 있다면 노드 매개변수에 맞는 코어부터 확인한 뒤 앱을 바꿀지 결정하세요. 가이드와 메뉴 위치만 다르다면 서버를 다시 설정하기보다 해당 클라이언트의 인터페이스를 먼저 살펴보세요.

오픈 소스 라이선스와 다운로드 범위

V2Fly와 Xray의 핵심 코드는 Mozilla Public License 2.0을 따릅니다. 라이선스는 코드의 사용, 수정, 배포 조건을 규정하며 실행 환경이나 프로토콜 호환성을 설명하지는 않습니다. 클라이언트와 코어는 별도의 프로젝트이므로 각각의 라이선스를 확인해야 합니다. 클라이언트를 다운로드해도 원격 서비스가 제공되는 것은 아닙니다. 설치 파일은 설정과 연결 도구를 제공하며, 구독이나 노드는 별도의 출처에서 받아야 합니다. 가져오기 전에 링크의 내용을 확인하고, 화면을 공유할 때는 인증 정보와 구독 식별자, 비공개 주소를 가리세요.

네 가지 변경 사항을 따로 기록하기

클라이언트를 업데이트하면 메뉴 위치가 바뀌거나 기본 설정이 조정될 수 있습니다. 코어 업데이트는 허용되는 매개변수 범위에 영향을 줄 수 있고, 규칙 데이터 업데이트는 같은 대상의 아웃바운드를 바꿀 수 있으며, 구독 새로고침은 선택할 수 있는 노드 목록을 바꿀 수 있습니다. 각각 다른 시점에 발생할 수 있습니다. ‘어제는 됐는데’ 문제가 생기면 최근 어느 계층을 업데이트했는지 먼저 떠올려 보세요. 작동하던 설정을 보존하고 같은 네트워크와 같은 대상으로 다시 테스트하세요. 설정 구문 오류라면 설정 항목을 먼저 확인하고, 연결은 됐지만 잘못된 아웃바운드로 나간다면 규칙 순서와 매칭 조건부터 확인하세요.

05 기술 노트

V2Ray 속도 문제 해결 및 설정 가이드

연결 후 웹페이지가 느리게 열리는 문제와 연결 자체가 수립되지 않는 문제는 서로 다릅니다. 아래 글에서는 성능, LAN 접근, 프로토콜 설정 항목을 다룹니다. 증상에 맞는 항목을 찾아보세요.

V2Ray 속도 저하 해결 체크리스트: 노드, 회선, 로컬 설정을 단계별로 점검

‘노드 부하 → 회선 품질 → 전송 설정 → 로컬 프록시 모드와 DNS’ 순서로 원인을 좁히고, 각 단계에서 클라이언트로 바로 확인할 방법을 안내합니다.

먼저 연결 수립 지연, 도메인 이름 해석 지연, 지속적인 전송 속도 저하를 구분하세요. 세 증상의 원인이 같다고 단정할 수는 없습니다. 한 번에 한 항목만 바꾸고 테스트 대상과 연결 방식을 기록한 뒤 결과를 비교하세요.

v2rayN에서 LAN 연결 허용하기: 휴대폰, TV, 태블릿에서 PC 프록시 포트 공유

LAN 연결을 허용한 뒤에는 PC의 내부 IP와 SOCKS/HTTP 포트를 확인해 다른 기기에 프록시로 입력하세요. 방화벽 허용 규칙과 보안 범위도 함께 설정해야 합니다.

먼저 두 기기가 서로 통신할 수 있는지 확인하세요. 프록시 수신 범위와 방화벽 규칙은 사용할 신뢰할 수 있는 로컬 네트워크에만 허용하세요.

VMess와 VLESS 차이, 빠르게 이해하기: 암호화, UUID, 전송 계층

복잡한 세부 사항은 덜어내고 일반 사용자가 궁금해하는 내용에 집중합니다. 두 프로토콜의 암호화, 인증, 전송 계층 조합 차이와 클라이언트에서 선택하는 방법을 설명합니다.

노드 유형은 원격 설정을 기준으로 선택하세요. 두 설정에서 같은 형식의 UUID를 사용하더라도 프로토콜이나 보안 매개변수를 서로 바꿔 쓸 수 있다는 뜻은 아닙니다.

전체 글 보기

v2rayN 다운로드