데스크톱 및 Android · 초기 설정

v2rayN 다운로드와 구독 가져오기

먼저 구독을 가져오고, 시스템 프록시와 라우팅 설정을 차례로 마치세요. 클라이언트를 설치한 뒤 연결 설정을 하나씩 확인하면 됩니다.

오픈 소스 클라이언트 GUI 설정 한국어 사용 가이드
운영체제를 선택해 다운로드 페이지로 이동하세요
클라이언트 다운로드

운영체제에 맞는 설치 파일 선택

운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 확인하세요. V2Fly 코어가 필요하다면 v2flyNG도 살펴볼 수 있습니다.

Windows

v2rayN · 데스크톱 추천

데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 Windows 사용 방식을 유지합니다. 두 버전 모두 서버 설정, 구독 그룹, 라우팅 규칙을 관리할 수 있으며 함께 설치할 필요는 없습니다. 처음 설정할 때는 한 가지 인터페이스를 선택해 연결을 확인한 뒤, 필요하면 다른 버전으로 옮기세요.

설치 전에 시스템 요구 사항을 확인하세요. 클라이언트가 실행 직후 종료된다면 해당 빌드의 런타임 환경과 폴더 쓰기 권한을 먼저 살펴보세요. 설정 폴더를 임시 압축 해제 경로에 두면 업데이트나 파일 정리 중 설정이 사라질 수 있습니다. 기존 설정을 백업한 뒤 업그레이드하세요.

다운로드 페이지로 이동

macOS

v2rayN · 칩에 맞는 설치 파일

‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple Silicon은 arm64, Intel 프로세서는 x64를 선택하면 됩니다. 두 설치 파일은 아키텍처가 다르지만 구독 설정 절차는 같습니다. 설치가 끝나면 클라이언트를 실행하고 구독을 추가하세요. 설치 완료가 연결 완료를 뜻하지는 않습니다.

처음 실행할 때 시스템 알림을 확인하고 앱 출처를 검토한 뒤 시스템에서 허용하는 방식으로 진행하세요. 브라우저가 기존 연결을 계속 사용한다면 네트워크 서비스의 프록시 설정과 브라우저 확장 프로그램을 확인하세요. 시스템 프록시, 클라이언트 라우팅, 앱 자체 프록시는 서로 다른 설정이므로 각각 점검해야 합니다.

다운로드 페이지로 이동

Android

v2rayNG · Xray 코어

Android에서는 v2rayNG를 우선 살펴보세요. V2Fly 코어가 필요하면 대체 클라이언트인 v2flyNG를 확인할 수 있습니다. 최신 스마트폰은 대개 arm64를 사용합니다. 아키텍처를 모른다면 기기 정보를 확인하거나 다운로드 페이지의 범용 패키지를 선택하세요. 앱 이름만으로 두 클라이언트의 프로토콜 지원이 같다고 판단하지 마세요.

구독을 가져온 뒤에는 그룹을 업데이트하고 설정을 선택한 다음 서비스를 시작해야 합니다. 처음 실행할 때 시스템 VPN 권한을 허용해야 합니다. 이 권한은 기기에서 트래픽을 처리하기 위한 것으로, 원격 서버를 제공한다는 뜻은 아닙니다. 백그라운드에서 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하고, 프로토콜 매개변수부터 반복해서 바꾸지는 마세요.

다운로드 페이지로 이동

Linux

v2rayN · 배포판별 패키지

배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택하고, 기기 아키텍처가 x64인지 arm64인지 확인하세요. 패키지 형식과 프로세서 아키텍처가 모두 맞아야 합니다. 데스크톱 환경에 따라 시스템 프록시 설정 메뉴가 다를 수 있으므로, 설치 후 클라이언트가 정상적으로 실행되고 설정을 읽는지 먼저 확인하세요.

브라우저는 대개 데스크톱 환경의 프록시 설정을 사용할 수 있지만, 터미널 프로그램은 자동으로 따르지 않을 수 있습니다. 브라우저에서는 접속되지만 명령줄에서는 실패한다면 서버를 바꾸기 전에 프로그램의 프록시 지원 여부와 환경 변수를 확인하세요. 더 많은 앱의 트래픽을 처리해야 한다면 TUN 모드의 권한과 라우팅 안내를 살펴보세요.

다운로드 페이지로 이동

클라이언트 다운로드, 원격 서비스, 구독은 서로 다른 요소입니다. 설치 파일은 로컬에서 사용하는 도구만 제공합니다. 연결에 필요한 서버 주소, 인증 정보, 전송 매개변수는 사용자가 적법하게 확보해 안전하게 보관해야 합니다.

전체 클라이언트 보기
설정 순서와 주요 기능

구독 관리부터 라우팅 설정까지

먼저 설정 하나로 연결이 되는지 확인한 뒤 프록시 적용 범위를 조정하세요. 아래 화면은 설정 예시이며, 메뉴 이름과 옵션 위치는 클라이언트나 코어에 따라 달라질 수 있습니다. 실제 화면을 기준으로 설정하세요.

구독 그룹 설정 · 예시
그룹 메모
일반 설정
구독 주소
서비스 제공자가 안내한 전체 주소 붙여넣기
업데이트 방식
현재 구독 업데이트(프록시 사용 안 함)
주소를 저장한 뒤 구독 업데이트 필요

구독은 서버 설정을 한곳에서 가져오고 업데이트하는 기능으로, 매개변수를 주기적으로 동기화해야 할 때 유용합니다. v2rayN에서 구독 그룹을 추가하고 메모를 입력한 뒤 전체 주소를 붙여넣으세요. 저장 후 현재 구독을 업데이트합니다. Android에서도 구독 그룹과 개별 링크 가져오기를 구분해야 합니다. 그룹 주소만 추가한다고 사용 가능한 서버가 되는 것은 아니므로 실제 내용을 가져와야 합니다. 처음 설정할 때는 프록시를 사용하지 않고 업데이트해 보세요. 실패하면 주소, 네트워크, 로그를 확인하세요. 수동 설정은 업데이트 전에 보관하고, 화면을 공유할 때는 주소의 인증 정보를 가리세요.

구독 가져오기 단계 보기

연결 확인: 설정은 한 번에 하나씩 변경

구독 업데이트를 마친 뒤 설정 하나를 선택하고 코어를 시작하세요. 로그에 설정 파싱 오류나 포트 충돌이 없는지 확인한 다음 시스템 프록시를 켭니다. 프록시를 지원하는 브라우저로 테스트할 대상을 열고, 기존에 직접 접속되던 사이트와 로컬 네트워크 기기도 확인하세요. 테스트 결과는 상황에 맞게 해석해야 합니다. 구독 업데이트 성공은 구독 주소에 접근할 수 있다는 뜻이고, 코어 시작 성공은 설정을 불러올 수 있다는 뜻입니다. 브라우저 접속이 된다고 모든 앱이 프록시를 사용한다고 볼 수는 없습니다.

실패하면 방금 바꾼 항목과 오류를 기록하고 가장 최근 변경부터 되돌리세요. 코어를 바꾸고, TUN을 켜고, DNS를 수정하고, 라우팅을 다시 작성하는 일을 한꺼번에 하면 원인을 찾기 어렵습니다. 시스템 프록시를 사용하지 않는 프로그램까지 처리해야 할 때 TUN 전체 안내를 확인하세요. 일반적인 브라우저 사용이라면 시스템 프록시부터 시작하면 됩니다.

단계별 전체 가이드 읽기
Project V 생태계와 유지 관리

클라이언트·코어·서비스 구분하기

이 세 요소의 관계를 이해하면 프로그램 이름 하나만 외우는 것보다 도움이 됩니다. 클라이언트를 다운로드하면 로컬에서 설정할 수 있고, 코어를 선택하면 설정 호환성을 결정할 수 있습니다. 원격 서비스는 연결 매개변수를 어디서 가져오는지 결정합니다.

Project V V2Fly Xray

Project V: 생태계 배경 이해하기

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 널리 알려진 프로젝트 중 하나입니다. 검색할 때 ‘V2Ray’는 코어를 가리키기도 하고, 호환 설정이나 전체 사용 방식을 뜻하기도 합니다. 따라서 이 이름만 보고 어떤 설치 파일을 받아야 할지 결정할 수는 없습니다. GUI 클라이언트는 하위 설정을 메뉴, 그룹, 스위치로 정리해 매번 전체 설정을 직접 작성하지 않아도 되게 합니다. 다만 프로토콜, 전송 방식, 인증 정보는 원격 서버의 요구 사항에 맞아야 합니다.

이 사이트에서는 설치와 연결을 나누어 설명합니다. 먼저 기기에 맞는 GUI 클라이언트를 선택하고, 구독에 어떤 매개변수가 포함되는지 확인한 다음, 시스템 프록시와 라우팅이 앱 트래픽에 미치는 영향을 안내합니다. 이 순서대로 살펴보면 문제 발생 지점을 구체적으로 찾기 쉽고, ‘클라이언트가 켜져 있다’는 사실을 ‘모든 네트워크 요청이 예상대로 전달된다’고 오해하지 않을 수 있습니다.

V2Fly와 Xray: 관련은 있지만 서로 다릅니다

V2Fly 커뮤니티는 V2Ray의 유지 관리와 개발을 이어 가고 있습니다. Xray는 관련 코드에서 발전해 자체 기능을 계속 확장하고 있습니다. 두 프로젝트는 일부 기술적 배경을 공유하지만 프로토콜 확장, 설정 필드, 업데이트 주기는 다릅니다. VMess, VLESS, Trojan은 각각 구분해서 이해해야 하는 프로토콜이며, REALITY는 연결 보안 계층의 구체적인 방식입니다. 이 이름들을 서로 바꿔 쓸 수 있는 스위치처럼 취급하지 마세요.

설정을 선택할 때는 먼저 제공자가 요구하는 프로토콜, 전송 방식, 코어 지원 여부를 확인한 뒤 TLS 서버 이름 등의 필드를 살펴보세요. 한 코어에서 사용할 수 있는 기능이 다른 코어에서도 자동으로 호환되는 것은 아닙니다. 오래된 가이드의 기본값도 현재 빌드에 맞지 않을 수 있습니다. 모르는 매개변수가 있다면 원래 설정을 보존하고 해당 설명을 확인하세요. 이름이 비슷하다는 이유로 직접 바꾸는 것보다 안전합니다.

오픈 소스 클라이언트 3종: 사용 목적에 따라 선택

v2rayN은 데스크톱용으로 서버 관리, 구독 그룹, 시스템 프록시, 라우팅 설정 등을 GUI에서 제공합니다. 크로스 플랫폼 빌드와 클래식 인터페이스는 메뉴 위치가 다를 수 있지만, 먼저 설정을 가져온 뒤 코어와 프록시 적용 범위를 확인하는 순서는 같습니다. 데스크톱에서는 로컬 수신 포트와 종료 후에도 남아 있는 시스템 프록시 설정에 특히 주의하세요. 포트를 변경할 때는 해당 포트를 사용하는 앱의 설정도 함께 바꿔야 합니다.

v2rayNG는 Android 기기용이며 Xray 코어를 사용합니다. 클립보드, QR 코드, 구독 그룹 설정 등으로 설정을 가져올 수 있습니다. Android에서는 시스템 VPN 인터페이스로 트래픽을 처리하므로 권한 알림, 앱별 프록시, 백그라운드 실행 설정이 사용 결과에 영향을 줄 수 있습니다. QR 코드는 설정 내용을 전달하는 방법일 뿐입니다. 스캔에 성공해도 원격 설정이 유효하거나 구독 업데이트가 완료됐다는 뜻은 아닙니다.

v2flyNG는 V2Fly 코어를 사용하는 Android용 대체 클라이언트로, 해당 코어의 동작이나 설정 호환성이 필요한 경우에 적합합니다. 여러 클라이언트를 동시에 실행하는 방식으로 문제를 해결하려 하지 말고 실제 설정 요구 사항에 따라 선택하세요. 일반적으로 VPN 서비스는 한 번에 하나만 활성화할 수 있습니다. 클라이언트를 바꾸기 전에 기존 연결을 중지하고 새 클라이언트에서 가져온 설정과 프록시 적용 범위를 다시 확인하세요.

오픈 소스 라이선스: 코드와 사용 조건 이해하기

세 클라이언트는 모두 오픈 소스 프로젝트로 코드를 제공합니다. v2rayN은 GPL-3.0 라이선스를 사용하고, v2rayNG와 v2flyNG는 GPL-3.0 계열 라이선스를 사용합니다. V2Fly와 Xray 코어는 MPL-2.0 라이선스를 사용합니다. 사용, 수정, 재배포 의무는 실제로 사용하는 빌드에 포함된 라이선스와 의존성 안내를 기준으로 확인하세요. 클라이언트, 코어, 포함된 구성 요소를 모두 같은 라이선스로 간주해서는 안 됩니다.

코드가 공개되어 있다는 것은 구현을 살펴보고 논의할 수 있다는 뜻이지, 모든 원격 서비스를 신뢰해도 된다는 뜻은 아닙니다. 구독 주소에 인증 정보가 포함될 수 있고 로그에서 서버 정보가 노출될 수도 있습니다. 도움을 요청할 때는 필요한 오류 내용만 남기고 인증 정보, 구독 주소, 개인 정보를 가리세요. 클라이언트의 오픈 소스 여부와 서비스 제공자의 운영 방식은 별개의 문제이므로 각각 판단해야 합니다.

업데이트 관리: 먼저 백업하고 변경 사항 확인

클라이언트, 코어, 라우팅 리소스, 구독 내용은 각각 업데이트 경로와 주기가 다릅니다. 구독 업데이트는 원격 설정을 동기화하는 기능이며 클라이언트 업그레이드를 대신하지 않습니다. 클라이언트를 업데이트해도 구독 주소가 계속 유효하다는 보장은 없습니다. 연결 문제가 생기면 최근에 어느 부분이 바뀌었는지 먼저 확인한 뒤 업데이트 여부를 결정하세요. 업그레이드 전에는 현재 프록시 모드, 라우팅 선택, 사용자 지정 포트를 기록하고 설정을 백업하세요. 업그레이드와 여러 설정 변경을 동시에 진행하지 않는 것이 좋습니다.

커뮤니티에서 유지 관리하면 기능이 조정되고 문제가 수정될 수 있지만 메뉴 이름이나 기본 동작이 바뀌기도 합니다. 따라서 이 가이드는 각 버튼의 위치보다 작업 목적을 중심으로 설명합니다. 업데이트 후에는 먼저 정상적으로 시작되는지 확인한 다음 자주 사용하는 앱과 직접 연결 대상을 점검하세요. 새 설정이 안정적으로 동작하는 것을 확인한 뒤 이전 백업을 정리하면 됩니다. 문제가 계속되면 로그에서 설정 파싱, DNS, 연결 수립, TLS 오류를 구분해 살펴보세요.

이 사이트의 콘텐츠 안내
기술 노트 · 최근 업데이트

증상별 문제 해결 단계

기본 설정을 마친 뒤 구체적인 문제가 생겼다면 해당 증상에 맞는 노트를 확인하세요. 오류 메시지를 먼저 저장한 다음 로컬에서 원격으로 범위를 좁혀 가면 모든 연결 문제를 하나의 설정 탓으로 돌리지 않고 원인을 찾을 수 있습니다.

시스템 프록시를 켰는데도 작동하지 않을 때: 브라우저 확장 프로그램과 터미널 환경 변수 확인

브라우저에서는 프록시 확장 프로그램과 시스템 프록시 설정을, 터미널에서는 http_proxy 및 https_proxy 환경 변수를 확인합니다. 명령줄 프로그램이 기본적으로 시스템 프록시를 사용하지 않는 이유도 설명합니다.

브라우저와 명령줄의 접속 결과가 다를 때 참고하세요. 프로그램이 어떤 프록시 설정을 읽는지 확인한 뒤 로컬 포트를 점검하면 불필요하게 서버를 바꾸는 일을 줄일 수 있습니다.

노트 읽기

FakeDNS 작동 원리: 가상 IP와 도메인 라우팅의 관계 및 사용 시점

FakeDNS가 예약된 주소 대역을 반환하고 도메인 매핑을 저장하는 방식을 설명합니다. TUN 모드와 도메인 라우팅에서의 역할, 직접 연결 앱과 충돌할 때 고려할 점도 살펴봅니다.

먼저 DNS 확인과 연결의 두 단계를 이해한 뒤 필요한지 판단하세요. 기본 설정이 정상적으로 작동한다면 매핑이 유지되는 방식을 이해한 다음 한 항목씩 테스트해도 됩니다.

노트 읽기

v2rayN 시작 직후 종료·v2rayNG 실행 즉시 종료: 런타임, 권한, 설정 초기화 해결법

데스크톱에서는 .NET 데스크톱 런타임, 폴더 쓰기 권한, 손상된 설정 파일을 확인합니다. Android에서는 VPN 권한과 앱 데이터를 점검하고 순서대로 따라 할 수 있는 해결 방법을 안내합니다.

먼저 클라이언트 프로세스가 종료된 경우와 서비스 시작이 실패한 경우를 구분하세요. 설정을 백업한 뒤 런타임 환경과 앱 데이터를 차례로 확인하면 초기화 과정에서 직접 입력한 정보를 잃지 않을 수 있습니다.

노트 읽기