v2rayN데스크톱 클라이언트 · 구독 및 라우팅 설정

V2Ray 리소스클라이언트 다운로드 및 설정 가이드

데스크톱에서는 v2rayN, 모바일에서는 v2rayNG를 선택하세요. 구독 가져오기부터 라우팅 설정까지 단계별로 진행하면 됩니다.

영구 무료오픈 소스한국어 설정 가이드

v2rayN 주요 설정
구독, 라우팅 및 연결 모드

먼저 연결 정보를 관리하고 트래픽 경로를 설정하세요. 설정 항목을 선택해 관련 작업과 주의 사항을 확인할 수 있습니다.

구독 그룹 업데이트

구독 주소는 여러 연결 설정을 가져오는 주소이며, 개별 서버의 공유 링크와는 다릅니다. v2rayN의 구독 그룹 설정에서 이름과 주소를 입력하고 저장한 뒤 해당 그룹을 업데이트하세요. 서버 목록에 항목이 나타나는지도 확인합니다. 이후 회선 정보가 바뀌면 보통 다시 업데이트하면 되므로 그룹을 매번 삭제하고 새로 만들 필요는 없습니다. 업데이트에 실패하면 주소가 완전한지, 서비스 이용 기간이 남아 있는지 먼저 확인하고 현재 네트워크에 맞는 업데이트 방식을 선택하세요. 구독 문제를 코어 오류로 오인하지 않도록 주의합니다.

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

출처별로 그룹 정리

출처가 다른 구독은 각각 알아보기 쉬운 이름으로 구분해 두면 업데이트와 필터링, 문제 해결을 한 그룹 안에서 처리할 수 있습니다. 이름에는 용도를 적고 알아보기 어려운 약어만 쓰지 않는 것이 좋습니다. 구독 주소를 바꿀 때는 수정 중인 그룹이 맞는지 확인한 뒤 새 주소를 저장하고 업데이트 결과를 살펴보세요. 직접 추가한 연결은 구독 항목과 따로 관리해야 일괄 정리할 때 혼동을 줄일 수 있습니다. 여러 설정을 장기간 관리한다면 개별 항목을 하나씩 관리하는 것보다 그룹을 사용하는 편이 편리합니다. 다만 그룹이 트래픽 출구를 자동으로 결정해 주지는 않습니다.

구독 그룹 설정
이름 / 주소 / 업데이트 사용

공유 링크는 따로 가져오기

VMess, VLESS 또는 Trojan 공유 링크를 받았다면 구독 주소로 저장하지 말고 클립보드에서 가져오기를 사용하세요. 가져온 뒤 프로토콜, 전송 방식, 보안 설정이 모두 올바른지 확인하고 해당 항목을 활성 서버로 지정합니다. QR 코드는 설정 정보를 담는 또 다른 수단일 뿐, 설정 매개변수를 대신하지 않습니다. 제공처에서 구독과 개별 링크를 모두 제공한다면 일상적인 관리는 구독을 사용하는 편이 좋습니다. 개별 링크 가져오기는 임시 테스트나 특정 연결을 보관할 때 유용합니다.

서버 → 클립보드에서 가져오기
서버 → QR 코드 스캔

업데이트 후 연결 확인

업데이트 성공은 클라이언트가 구독 내용을 가져와 해석했다는 뜻이지, 모든 연결이 정상 작동한다는 뜻은 아닙니다. 먼저 항목 하나를 선택해 연결을 테스트하고 실제로 사용하는 웹사이트도 열어 보세요. 테스트 결과는 로컬 네트워크, 대상 서비스, 테스트 방식에 따라 달라질 수 있으므로 숫자 하나만으로 판단하지 않는 것이 좋습니다. 업데이트 후 기존 항목이 사라졌다면 목록을 바로 복구하기보다 서비스 제공처에서 설정을 변경했는지 확인하세요. 이미 만료된 매개변수를 계속 사용해도 연결 문제는 해결되지 않습니다.

서버 선택 → 활성 서버로 지정
로그 확인 → 웹페이지 접속 테스트

화면에 표시되는 이름은 플랫폼과 업데이트에 따라 조금씩 달라질 수 있습니다. 자세한 단계는 구독 가져오기 가이드부터 확인하세요. 연결에 문제가 있다면 문제 해결 절차에 따라 하나씩 점검하면 됩니다.

V2Ray 클라이언트
플랫폼별 다운로드 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 다운로드 페이지에서 프로세서 아키텍처와 설치 파일 형식에 맞는 파일을 고르면 됩니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 데스크톱 사용 방식을 유지합니다. 사용 방식에 따라 하나를 선택하면 되며, 연결을 위해 두 버전을 모두 설치할 필요는 없습니다.

다운로드하기 전에 운영체제를 확인하고 설치 파일의 아키텍처가 기기와 맞는지 살펴보세요. 처음 실행한 뒤 구독을 가져오고 활성 서버를 선택한 다음 시스템 프록시를 켭니다. 프로그램에서 실행 환경이 없다는 안내가 표시되면 안내에 따라 필요한 구성 요소를 설치하세요. 출처가 불분명한 곳에서 파일을 따로 내려받아 복사하지 마세요.

다운로드 Windows 클라이언트

macOS

v2rayN 데스크톱 클라이언트는 Apple Silicon용과 Intel용 설치 파일을 구분해 제공합니다. 먼저 ‘이 Mac에 관하여’에서 칩 또는 프로세서 이름을 확인해 알맞은 파일을 선택하세요. 설치 파일이 실행되는지는 파일 크기보다 아키텍처가 맞는지에 달려 있습니다.

처음 실행할 때 시스템 권한 안내를 확인하고 시스템 설정에서 앱의 출처와 필요한 권한을 검토하세요. 구독을 가져온 뒤에는 일반 시스템 프록시로 브라우저 접속을 먼저 테스트합니다. TUN이 필요하면 권한, 라우팅, DNS를 별도로 확인해 여러 설정을 한꺼번에 바꾸지 않도록 하세요.

다운로드 macOS 클라이언트

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. v2flyNG는 V2Fly 코어를 사용하며 명확한 호환성 요구가 있을 때 대안으로 고려할 수 있습니다. 일반적인 arm64 기기라면 해당 설치 파일을 선택하세요. 아키텍처를 모르겠다면 기기 사양을 확인하거나 범용 버전을 선택하면 됩니다.

설치 후 구독을 가져와 서버를 선택하고 시스템의 VPN 연결 요청을 허용하세요. 백그라운드로 전환한 뒤 연결이 자주 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인합니다. 구독 업데이트와 VPN 연결은 별개이므로 각각 확인하고 같은 설정을 반복해서 가져오지 마세요.

다운로드 Android 클라이언트

Linux

v2rayN은 데스크톱 환경에서 구독과 라우팅을 그래픽 인터페이스로 관리할 수 있습니다. 배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64 아키텍처를 확인하세요. 파일 확장자만 보고 선택하지 말고 설치 형식과 프로세서 아키텍처가 모두 맞는지 확인해야 합니다.

데스크톱 환경에 따라 시스템 프록시를 사용하는 방식이 다를 수 있습니다. 브라우저가 시스템 설정을 따르는지 먼저 확인한 다음 프록시를 따로 설정해야 하는 앱을 점검하세요. TUN을 사용하기 전에 필요한 권한과 기존 네트워크 도구의 관계를 확인합니다. 기기에 이미 가상 네트워크 어댑터나 VPN이 있다면 설정을 기록한 뒤 변경하세요.

다운로드 Linux 클라이언트

전체 클라이언트 보기 → 코어와 플랫폼 조합을 고민 중인가요? 세 가지 클라이언트 비교를 확인하고 현재 설정과 사용 환경에 맞게 선택하세요.

v2rayN 빠른 시작
구독 가져오기부터 접속 확인까지

먼저 연결 하나를 정상 작동시킨 뒤 사용자 지정 규칙을 추가하세요. 각 단계를 마칠 때마다 확인하면 문제를 쉽게 찾을 수 있습니다.

1단계 · 가져오기

구독 그룹 추가

유효한 구독 주소를 준비한 뒤 구독 그룹 설정을 열고 알아보기 쉬운 이름과 전체 주소를 입력하세요. 저장 후 그룹을 업데이트하고 목록에 연결 항목이 나타나는지 확인합니다. 클라이언트 자체는 원격 서버를 제공하지 않으므로 프로그램 설치와 연결 설정 확보는 별개의 단계입니다.

주소에 개인 접속 정보가 포함될 수 있으므로 공개된 게시판에 올리지 마세요. 복사할 때 앞뒤에 공백, 줄바꿈, 설명 문구가 섞이지 않았는지 확인하세요. 개별 공유 링크를 받은 경우에는 클립보드에서 가져오기를 사용합니다. 먼저 입력 정보의 유형을 구분하면 구독 업데이트에 실패했을 때 불필요한 시도를 줄일 수 있습니다.

구독 가져오기 단계 보기 →
2단계 · 설정

서버와 모드 선택

설정 하나를 활성 서버로 지정하고 시스템 프록시 자동 설정을 켠 뒤 내장 라우팅 설정부터 사용하세요. 시스템 프록시는 이를 지원하는 앱의 트래픽을 받아들이고 라우팅 규칙은 출구를 결정하므로 두 설정을 각각 확인해야 합니다. ‘전역’이라고 해서 모든 앱이 자동으로 연결되는 것은 아닙니다.

처음 설정할 때는 TUN과 복잡한 DNS 규칙을 잠시 보류하는 것이 좋습니다. 일반 프록시로 안정적인 접속을 확인한 뒤 필요한 앱에 따라 적용 범위를 넓히세요. 모바일에서 v2rayNG를 사용할 때는 시스템 안내에 따라 VPN 연결을 허용하고, 기존 VPN 서비스가 실행 중인지 확인합니다.

연결 모드 설명 보기 →
3단계 · 확인

웹페이지와 앱 테스트

자주 사용하는 웹사이트를 열어 실제 접속을 확인하고 프록시가 필요한 앱도 점검하세요. 목록의 테스트 결과는 참고용이며 실제 요청을 대신할 수 없습니다. 브라우저는 정상인데 다른 앱에 문제가 있다면 앱의 프록시 설정부터 확인하세요. 모든 대상에 접속할 수 없다면 코어 로그, 연결 매개변수, 로컬 네트워크를 점검합니다.

문제를 해결할 때는 DNS를 바꾸면서 서버도 바꾸는 식으로 여러 조건을 동시에 변경하지 말고 한 번에 하나만 바꾸세요. 오류 메시지의 핵심 문구와 변경 전후 결과를 기록하면 재설치를 반복하는 것보다 원인을 좁히기 쉽습니다. 사용을 마치면 정상 종료하고 필요에 따라 시스템 프록시가 해제됐는지 확인하세요.

증상별 해결 방법 찾기 →

전체 가이드 보기 → 시스템 프록시를 따르지 않는 앱도 연결해야 하나요? TUN 모드와 권한 안내를 먼저 확인한 뒤 사용 여부를 결정하세요.

Project V 오픈 소스 생태계
클라이언트와 코어의 역할

인터페이스와 코어, 서버의 관계를 이해하면 클라이언트를 올바르게 선택하고 연결 오류도 더 쉽게 파악할 수 있습니다.

Project VV2FlyXray

Project V는 생태계의 배경이며 통합 인터페이스가 아닙니다

V2Ray는 Project V의 모듈형 네트워크 도구 체계에서 시작했으며 프로토콜 처리, 전송, 라우팅 기능은 코어가 담당합니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 관련 코드에서 발전한 별도의 코어 분기입니다. 기술적 배경의 일부를 공유하지만 프로토콜 지원, 설정 항목, 개발 방향에는 차이가 있으므로 두 이름을 서로 완전히 바꿔 쓸 수 있는 것으로 보면 안 됩니다.

사용자가 일상적으로 실행하는 v2rayN, v2rayNG, v2flyNG는 그래픽 클라이언트입니다. 클라이언트는 구독과 인터페이스 설정을 코어 설정으로 정리한 뒤 코어를 실행해 연결을 만듭니다. 서버는 연결에 필요한 접속 지점을 제공하고 구독은 매개변수를 전달합니다. 각 계층이 함께 작동하지만 어느 한 계층이 정상이라고 해서 전체 연결 경로가 사용 가능하다고 단정할 수는 없습니다.

세 클라이언트의 오픈 소스 특징

v2rayN은 여러 데스크톱 운영체제에서 구독, 라우팅, 프록시 설정을 관리할 수 있는 오픈 소스 클라이언트입니다. v2rayNG는 Xray 코어를 사용하는 오픈 소스 Android 클라이언트이며, v2flyNG는 V2Fly 코어를 사용해 모바일에서 또 다른 선택지를 제공합니다. 운영체제를 먼저 확인하고 기존 연결에 필요한 프로토콜과 코어 기능을 기준으로 선택하세요.

그래픽 인터페이스의 차이는 주로 사용 방식에 영향을 주고, 코어 지원 범위는 설정의 작동 여부에 영향을 줍니다. 특정 보안 메커니즘을 사용하는 설정이라면 프로토콜, 전송 방식, 코어를 함께 확인해야 합니다. 클라이언트 이름이 비슷하다는 이유로 고급 설정을 그대로 복사하면 호환되지 않는 항목이나 서로 다른 동작으로 문제가 생길 수 있습니다.

오픈 소스 라이선스와 사용 범위

각 프로젝트는 오픈 소스 라이선스를 통해 코드 사용, 수정, 배포 조건을 안내합니다. V2Ray 및 Xray 코어는 주로 MPL 2.0을 사용하고 세 클라이언트 프로젝트는 GPL 계열 라이선스를 사용합니다. 재배포할 때는 소프트웨어 이름만 확인하지 말고 해당 배포본에 포함된 라이선스 문서와 의존성 고지를 기준으로 판단하세요.

클라이언트는 무료로 사용할 수 있지만 원격 서버, 구독 서비스, 네트워크 리소스는 다른 사업자가 제공할 수 있습니다. 코드가 공개되어 있다고 해서 모든 구독 출처를 신뢰할 수 있는 것은 아니며, 클라이언트가 원격 회선의 품질을 보장하는 것도 아닙니다. 이 경계를 이해하면 프로그램 오류, 구독 상태, 서버 문제를 나누어 살펴볼 수 있습니다.

커뮤니티 업데이트와 설정 호환성

커뮤니티에서는 인터페이스를 개선하고 문제를 수정하며 코어 기능을 꾸준히 반영합니다. 클라이언트 업데이트와 구독 업데이트는 서로 다른 문제를 해결합니다. 전자는 로컬 프로그램을 변경하고 후자는 원격 연결 매개변수를 새로 가져옵니다. 구독 업데이트에 실패하면 주소와 서비스 상태를 먼저 확인하세요. 코어에서 지원하지 않는 항목이라는 오류가 나오면 로컬 프로그램과 설정 요구 사항이 맞는지 살펴봅니다.

업데이트 전에 구독과 사용자 지정 라우팅을 보관하고, 업데이트 후 기존 설정으로 다시 테스트하세요. 한 번에 클라이언트를 바꾸고 코어를 이전하고 규칙까지 새로 작성하지 마세요. 변경 전후 상태를 비교할 수 있어야 어떤 변경이 문제를 해결했는지 판단하고 이상이 생겼을 때 근거를 가지고 되돌릴 수 있습니다.

설정과 로그에 포함된 민감 정보

구독 주소, 사용자 식별 정보, 접속 인증 정보가 설정이나 로그에 포함될 수 있습니다. 도움을 요청할 때는 필요한 오류 문구와 설정 항목 이름만 남기고 주소의 식별 매개변수와 개인 인증 정보를 먼저 삭제하세요. 구독 그룹 이름은 용도를 설명하는 이름으로 정하고 개인 계정 정보를 스크린샷에 노출하지 않는 것이 좋습니다.

TLS 핸드셰이크 오류가 발생하면 시스템 시간과 서버에서 요구하는 이름을 먼저 확인하세요. 연결 시간이 초과되면 네트워크, 서버 상태, 라우팅을 점검합니다. 오류 유형마다 해결 방법이 다릅니다. 전체 절차는 문제 해결에서 확인하고 용어는 용어집에서 살펴보세요.

서버 선택과 연결 문제 해결
최신 기술 문서

회선 선택부터 코어 이해, 웹페이지 접속 오류까지 일상적인 사용에서 자주 헷갈리는 부분을 하나씩 살펴봅니다.

전체 글 보기 →