클라이언트 선택 및 설정 가이드

V2Ray 클라이언트 다운로드 및 설정

v2rayN 다운로드 가이드 보기

v2rayN 데스크톱 버전부터 모바일 버전까지, 실제 메뉴를 따라 구독을 가져오고 라우팅 규칙을 설정하는 방법을 안내합니다.

오픈소스 한국어 설정 안내

기기별 선택

V2Ray 클라이언트 다운로드

전체 클라이언트 보기 →

데스크톱에서는 v2rayN, 모바일에서는 v2rayNG를 먼저 확인하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택해야 합니다. 클라이언트는 설정을 읽어 연결을 처리하므로, 구독이나 노드는 별도로 준비해야 합니다.

Windows

v2rayN은 데스크톱 버전과 기존 WPF 버전을 제공합니다. 처음 설치한다면 데스크톱 버전을 먼저 살펴보세요. 기존 인터페이스에 익숙하다면 두 버전의 시스템 요구 사항과 조작 방식 차이를 확인한 뒤 선택하면 됩니다.

다운로드 페이지로 이동

macOS

v2rayN 데스크톱 버전을 사용하세요. ‘이 Mac에 관하여’에서 칩 이름을 확인한 뒤 Apple Silicon 또는 Intel용 다운로드를 선택합니다. 처음 실행할 때는 macOS의 보안 알림을 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN 데스크톱 버전을 사용하세요. 배포판에 맞는 deb 또는 rpm 파일을 선택하고 x64와 arm64 아키텍처를 확인합니다. 앱에서 시스템 프록시를 사용할 수 있는지는 데스크톱 환경과 앱 설정에 따라서도 달라집니다.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 우선 추천합니다. V2Fly 코어가 필요하다면 v2flyNG를 확인하세요. 최신 휴대전화는 대부분 arm64를 선택하면 되며, 아키텍처가 확실하지 않다면 범용 버전 안내를 먼저 읽어보세요.

다운로드 페이지로 이동

설치 파일과 연결 설정은 따로 준비하세요

설치 후 서버 목록이 비어 있는 것은 정상입니다. 클라이언트에 사용 가능한 노드가 포함되어 있거나 기기에 맞춰 구독이 자동으로 생성되는 것은 아닙니다. 이용 권한이 있는 서비스의 관리 페이지에서 설정을 받아 구독 유효 기간을 확인하세요. 안내에 나오는 example.com 예시 주소는 입력 형식을 보여주기 위한 것이므로 실제 구독 주소로 사용하면 안 됩니다.

데스크톱과 모바일 설정을 그대로 맞출 필요는 없습니다

구독을 여러 클라이언트에서 사용할 수 있는지는 구독 형식, 프로토콜 매개변수, 코어 지원 여부에 따라 달라집니다. 컴퓨터의 ‘시스템 프록시 자동 설정’과 휴대전화의 VPN 연결 권한은 서로 다른 방식입니다. 기기를 바꿀 때 유효한 서비스 매개변수는 그대로 쓸 수 있지만, 로컬 포트와 앱의 트래픽 처리 방식, 배터리 설정은 기기마다 따로 확인해야 합니다.

자주 쓰는 설정 네 가지

구독, 프록시, 라우팅

먼저 설정을 클라이언트에 가져온 다음, 프록시가 필요한 앱이 올바른 경로로 연결되도록 설정하세요. 아래 내용은 v2rayN에서 흔히 볼 수 있는 메뉴를 기준으로 설명합니다. 실제 메뉴 위치는 인터페이스에 따라 다를 수 있으니 현재 클라이언트 화면을 기준으로 확인하세요.

유효한 설정 먼저 준비하기
구독 그룹 설정화면 예시
구독 URL · 예시https://example.com/sub프록시를 사용하지 않고 구독 업데이트

구독은 여러 노드의 주소와 연결 매개변수를 한곳에서 관리하므로 설정을 주기적으로 갱신할 때 편리합니다. ‘구독 그룹 설정’에서 그룹을 만들고 전체 주소를 입력해 저장한 다음, ‘구독 그룹’ 메뉴에서 업데이트하세요. 처음 연결을 설정하기 전이라면 ‘프록시를 사용하지 않고 구독 업데이트’를 먼저 시도할 수 있습니다. 가져온 뒤 노드 이름, 프로토콜, 그룹이 올바른지 확인하세요. 목록이 비어 있으면 같은 그룹을 반복해서 만들지 말고 업데이트 로그부터 살펴보세요. 구독을 사용하면 노드를 하나씩 입력할 때보다 관리하기 편하지만, 주소에 접근 정보가 포함될 수 있으므로 공개적으로 공유하지 않는 것이 좋습니다.

구독 가져오기 단계 보기

설치부터 연결 확인까지

v2rayN 빠른 시작

전체 가이드 보기 →

처음 설정할 때는 확인 가능한 연결 하나를 먼저 만든 다음 자동 시작, 세부 라우팅, 공유 기능을 설정하세요. 아래 세 단계는 필요한 순서대로 정리했으며, 서버 목록이 비어 있는 상태에서 시작할 때 유용합니다.

1

설치하고 구독 가져오기

기기 플랫폼에 맞는 클라이언트를 다운로드해 설치한 뒤 메인 화면을 엽니다. v2rayN의 ‘구독 그룹 설정’에서 주소를 추가하고 저장한 다음 구독을 업데이트하세요. 클립보드에서 노드를 가져온다면 복사한 내용이 온전한지 확인하고 알맞은 가져오기 메뉴를 사용하세요. 일반 웹페이지 주소를 노드 링크로 사용하면 안 됩니다.

업데이트가 끝나면 서버 목록에 설정이 표시되어야 합니다. 먼저 그룹과 프로토콜을 확인한 뒤 사용할 노드를 선택하세요. 파싱 오류가 발생하면 로그에 표시된 원인을 기록하고 설정을 받은 곳에서 형식을 확인하세요. 구독 주소가 만료된 경우 클라이언트를 다시 설치해도 문제가 해결되지 않습니다.

2

노드와 프록시 방식 선택하기

사용할 노드를 활성 서버로 지정하고 코어가 시작될 때까지 기다리세요. 데스크톱에서는 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하고 라우팅은 기본값으로 유지합니다. 여러 클라이언트에서 시스템 프록시를 동시에 켜지 마세요. 나중에 실행된 프로그램이 먼저 실행된 프로그램의 주소와 포트를 덮어쓸 수 있습니다.

v2rayNG를 사용하는 모바일에서는 연결을 시작한 뒤 시스템 안내에 따라 VPN 연결을 허용하세요. 이 과정은 컴퓨터의 프록시 메뉴와 다릅니다. 비슷한 방식으로 트래픽을 처리하는 앱이 있다면 어느 앱이 연결을 담당할지 먼저 정한 뒤 테스트하세요. 연결 충돌을 노드 오류로 오해하지 않도록 주의해야 합니다.

3

연결 확인 후 원래 설정으로 되돌리기

접속할 수 있다고 확인된 페이지를 열어 정상적으로 표시되는지 확인하고, 클라이언트 로그를 살펴 요청이 로컬 연결로 들어왔는지 확인하세요. 지연 시간 테스트 결과는 특정 테스트 방식에 따른 값일 뿐, 실제 웹페이지나 다운로드, 대상 앱의 접속 여부를 대신하거나 사용 가능한 대역폭을 직접 나타내지는 않습니다.

연결에 실패하면 먼저 로컬 수신 상태와 시스템 프록시를 확인한 뒤 노드 매개변수와 서버 연결 가능 여부를 점검하세요. 테스트가 끝나면 데스크톱에서 시스템 프록시를 해제하고 클라이언트를 종료한 다음 평소 네트워크 연결이 복구됐는지 확인하세요. 이 과정을 익혀두면 노드를 바꿀 때 설정 변경 문제와 시스템에 남은 설정 문제를 구분할 수 있습니다.

오류가 발생하면 당시 정보를 기록하세요

문제를 살펴보기 전에 구독 업데이트, 코어 시작, 대상 웹페이지 접속 중 어느 단계에서 오류가 발생했는지 기록하세요. 로그의 ‘파싱 실패’, ‘연결 거부’, ‘연결 시간 초과’는 서로 다른 단계의 문제를 가리키므로 해결 방법도 다릅니다. 오류가 발생한 시각과 안내 문구는 남겨도 되지만, 외부에 문의하기 전 구독 주소, 사용자 식별 정보, 노드 인증 정보는 가리세요. 전체 가이드는 작업 순서에 따라 설명하고 문제 해결 페이지는 증상별로 정리합니다. 설정을 처음 구성할 때는 전체 가이드를, 원인을 좁힐 때는 문제 해결 페이지를 참고하세요.

증상별 해결 방법 찾기 →

클라이언트와 코어의 역할

Project V 오픈소스 생태계

V2Ray는 생태계에서 사용되는 기술 이름이고, v2rayN과 v2rayNG는 사용자가 직접 조작하는 클라이언트입니다. 이름만 보고 프로그램을 선택하기보다 인터페이스, 코어, 프로토콜, 서비스 설정을 구분해 이해하는 편이 도움이 됩니다.

Project V와 V2Fly의 관계

Project V는 프록시 통신을 위한 모듈식 도구를 제공하며, V2Ray는 널리 사용되는 핵심 프로젝트 중 하나입니다. V2Fly 커뮤니티는 V2Ray 관련 구현과 문서를 계속 관리하고 있습니다. 따라서 클라이언트 안내, 설정 참고 자료, 오류 로그에서 Project V, V2Ray, V2Fly 이름을 함께 볼 수 있습니다. 이 이름들은 서로 바꿔 누를 수 있는 다운로드 버튼 세 개를 뜻하지 않습니다. 문서를 읽을 때는 프로젝트 배경, 코어 구현, 구체적인 그래픽 인터페이스 중 무엇을 설명하는지 먼저 확인하세요.

그래픽 클라이언트는 자주 쓰는 설정을 메뉴와 입력 양식으로 제공하고, 코어는 설정을 해석해 연결을 처리합니다. 서버 목록의 항목을 수정하면 대개 클라이언트가 생성하는 실행 설정이 바뀝니다. 코어 관련 옵션을 바꾸면 프로토콜 지원, 도메인 이름 조회, 라우팅 동작에 영향을 줄 수 있습니다. 이 관계를 이해하면 오류가 발생했을 때 인터페이스 조작과 연결 매개변수 중 무엇을 먼저 확인할지 판단할 수 있습니다.

Xray와 V2Fly 코어의 차이

Xray는 V2Ray 기술 계보에서 분리되어 발전한 독립 코어 프로젝트입니다. V2Fly가 관리하는 구현과 공통된 배경은 있지만 이후 기능과 설정 지원은 완전히 같지 않습니다. VLESS나 VMess를 사용하는 노드라도 전송 방식, 보안 계층, 확장 매개변수가 다를 수 있습니다. 사용할 수 있는지 판단할 때는 프로토콜 이름만 보지 말고 전체 매개변수와 현재 클라이언트에 포함된 코어를 함께 확인하세요.

코어 선택에서 우선 고려할 것은 막연한 속도 순위가 아니라 호환성입니다. 서버가 요구하는 기능, 클라이언트가 실제로 지원하는 필드, 네트워크 환경이 모두 연결 결과에 영향을 줄 수 있습니다. 한 기기에서는 작동하고 다른 기기에서는 작동하지 않는다면 먼저 코어와 매개변수의 지원 범위를 비교한 뒤 복사나 구독 변환 과정에서 필드가 빠지지 않았는지 확인하세요. 기기 성능이 부족하다고 바로 단정하지 마세요.

오픈소스 클라이언트 세 가지의 역할

v2rayN은 데스크톱용 클라이언트로 서버 목록, 구독 그룹, 시스템 프록시, 라우팅 메뉴를 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, 기존 WPF 버전은 이전 인터페이스에 익숙한 사용자를 위한 선택지입니다. v2rayNG는 모바일 기기용이며 Xray 코어를 사용하므로 휴대전화에서 우선 고려할 수 있습니다. v2flyNG는 V2Fly 코어 기반의 대안으로, 해당 코어 기능이 필요한 설정에 적합합니다.

세 클라이언트는 모두 오픈소스로 코드를 제공하지만, 재배포와 수정 조건은 각 프로젝트에 포함된 라이선스를 확인해야 합니다. 클라이언트와 코어의 라이선스도 각각 살펴봐야 합니다. 오픈소스는 구현 방식과 커뮤니티의 유지 관리 과정을 확인하는 데 도움이 되지만, 구독 출처와 실행 권한, 로컬 설정을 판단하는 일을 대신하지 않습니다. 이 사이트의 다운로드 안내와 사용 설명은 노드 서비스나 연결 가능성을 보장하지 않습니다.

업데이트 전에 어느 구성 요소가 바뀌는지 확인하세요

클라이언트 업데이트는 인터페이스 배치, 설정 생성 방식, 포함된 코어를 바꿀 수 있습니다. 구독 업데이트는 주로 서버 목록과 매개변수를 새로 고치므로 두 작업은 서로 다릅니다. 메뉴 위치가 바뀌었다면 이전 화면을 그대로 따라 하려 하기보다 기능 이름으로 찾아보세요. 정상적으로 작동하는 설정까지 바꿀 필요는 없습니다. 다운로드 페이지에서는 설치 경로와 플랫폼 요구 사항을 안내하며, 홈에서는 특정 릴리스 번호를 선택 기준으로 삼지 않습니다.

업데이트 전에 사용 중인 노드 그룹, 프록시 방식, 사용자 지정 규칙을 기록하고 필요하다면 클라이언트의 설정 저장 기능을 이용하세요. 업데이트 후에는 기본 연결을 먼저 확인한 다음 사용자 지정 라우팅과 LAN 공유를 점검합니다. 업데이트 뒤에만 문제가 발생했다면 로그와 설정 변화를 비교해 원인을 찾으세요. 구독을 바꾸고 코어를 전환하고 규칙까지 다시 작성하는 일을 한꺼번에 하면 실제 원인을 확인하기 어렵습니다.

궁금한 내용별로 살펴보기

설정 및 문제 해결 가이드

전체 글 보기 →

기본 연결을 설정한 다음 기기와 사용 환경에 맞는 주제를 살펴보세요. 프로토콜 선택, 시스템 권한, 공유 설정에는 각각 필요한 조건이 있습니다. 모든 고급 옵션을 한꺼번에 바꾸기보다 먼저 해결할 문제를 정하면 결과를 확인하기 쉽습니다.

프로토콜 해설

VMess·VLESS·Trojan·Shadowsocks 선택 가이드: 네 가지 프록시 프로토콜의 특징과 사용 환경

자주 쓰이는 네 가지 프로토콜의 암호화 방식, 전송 조합, 클라이언트 지원 여부를 비교하고 웹 브라우징, 모바일 네트워크, 구형 기기 등 사용 환경별 선택 기준을 안내합니다. 먼저 서버에 어떤 설정이 있는지 확인한 뒤 클라이언트에 필요한 기능을 살펴보세요.

프로토콜 비교 보기 →
플랫폼 가이드

macOS에 v2rayN 설치 시 개발자를 확인할 수 없다는 경고가 표시될 때: 보안 설정에서 앱 허용 및 네트워크 권한 설정

v2rayN을 처음 실행할 때 차단을 해제하는 방법과 시스템 프록시, 네트워크 확장 권한을 허용하는 위치 및 자주 막히는 지점을 설명합니다. 앱이 열리지 않는 문제와 앱은 열리지만 연결되지 않는 문제를 구분해 불필요한 설정 변경을 피하세요.

권한 안내 읽기 →