v2rayN / 데스크톱 클라이언트

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

구독 가져오기부터 시작해 메뉴에서 시스템 프록시와 TUN 모드를 설정하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 선택하면 됩니다.

영구 무료오픈 소스한국어 설정 문서

v2rayN 주요 설정
트래픽 처리 방식을 구분한 뒤 규칙을 조정하세요

구독을 가져오면 연결에 필요한 매개변수가 준비됩니다. 앱이 프록시를 사용할지는 시스템 프록시, 가상 네트워크 인터페이스, 라우팅 규칙에 따라 달라집니다. 각 계층을 나눠 살펴봐야 “노드 테스트는 성공했는데 웹페이지가 열리지 않는” 상황에서 클라이언트를 반복해서 재설치하는 대신 확인할 메뉴를 찾을 수 있습니다.

시스템 프록시: 브라우저부터 연결하기

시스템 프록시는 클라이언트의 로컬 프록시 주소를 운영체제에 전달하므로 시스템 설정을 읽는 브라우저와 데스크톱 앱에 적합합니다. 처음 사용할 때는 트레이 메뉴에서 “시스템 프록시 자동 설정”을 선택한 다음 웹페이지를 열어 확인하세요. “시스템 프록시 해제”는 설정을 되돌리는 기능입니다. “시스템 프록시 변경 안 함”은 클라이언트가 현재 설정을 직접 바꾸지 않는다는 뜻이지, 프록시를 해제한다는 뜻은 아닙니다. TUN과 달리 전체 네트워크 인터페이스를 제어할 필요는 없지만 모든 프로그램이 시스템 설정을 따르는 것은 아닙니다. 명령줄 도구는 별도 설정이 필요한 경우가 많습니다.

  • 시스템 프록시 자동 설정
  • 시스템 프록시 해제
  • 시스템 프록시 변경 안 함

클라이언트 인터페이스가 바뀌면 메뉴 이름도 달라질 수 있습니다. 플랫폼별 설정 절차는 전체 설치 및 설정 문서 →를 확인하세요.

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

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. V2Fly 커널이 필요한 경우 v2flyNG를 고려할 수 있습니다. 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 페이지에서 설치 파일을 선택하세요.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 기존 데스크톱 사용 방식을 유지합니다. 화면 구성이 다를 수 있으므로 가이드를 따라 하기 전에 다운로드한 버전을 확인하세요. 같은 버튼을 찾으려고 버전을 반복해서 바꿀 필요는 없습니다.

설치 전에 시스템 설정에서 프로세서와 시스템 종류를 확인하세요. 처음 실행한 뒤 구독을 가져오고 트레이 메뉴에서 시스템 프록시를 설정합니다. 기본 창을 닫아도 프로그램이 종료되지 않을 수 있습니다. 사용을 마치기 전에 프록시 설정을 복구해 브라우저가 종료된 로컬 포트에 계속 연결하지 않도록 하세요.

다운로드 Windows 클라이언트→

macOS

v2rayN은 Apple Silicon과 Intel용 다운로드를 따로 제공합니다. “이 Mac에 관하여”에서 “칩”이 표시되면 칩 모델에 맞춰 선택하고, “프로세서”가 표시되면 Intel인지 확인하세요. 구입 연도만으로 아키텍처를 판단하지 말고, 같은 구독을 가져오기 위해 서로 다른 설치 파일을 섞어 쓸 필요도 없습니다.

처음 실행할 때 시스템 보안 경고가 표시되면 먼저 파일 출처를 확인한 뒤 시스템 설정의 실제 안내에 따라 처리하세요. 시스템 프록시와 TUN은 권한을 허용하는 경로가 다릅니다. 브라우저 연결을 확인한 다음 다른 앱을 테스트하고, 특정 앱만 문제가 생기면 해당 앱에 자체 프록시 설정이 있는지 살펴보세요.

다운로드 macOS 클라이언트→

Android

Xray 커널 기반 v2rayNG를 우선 사용하세요. V2Fly 커널과의 호환 설정이 필요한 경우 v2flyNG를 선택할 수 있습니다. 최신 기기는 대체로 arm64를 선택하면 됩니다. 아키텍처를 모르면 기기 정보를 확인하거나 다운로드 페이지의 안내에 따라 범용 설치 파일을 선택하세요. 두 클라이언트의 설정 항목이 완전히 같을 필요는 없습니다.

구독을 가져와 목록을 업데이트한 뒤 노드를 선택하고 연결을 시작하면, 시스템 안내에 따라 VPN 연결 생성을 허용하세요. 다른 VPN 앱이 이미 실행 중이라면 먼저 트래픽 처리 충돌을 해결해야 합니다. 백그라운드 연결이 끊기는 원인은 절전 제한일 수도 있습니다. 연결 버튼만 반복해서 누르지 말고 앱의 배터리 정책과 실제 로그를 함께 확인하세요.

다운로드 Android 클라이언트→

Linux

v2rayN의 Linux 다운로드는 deb·rpm 패키지와 프로세서 아키텍처에 따라 구분됩니다. Ubuntu와 Debian 등에서는 대체로 deb, Fedora 등에서는 대체로 rpm을 선택합니다. 프로세서가 x64인지 arm64인지는 별도로 확인해야 합니다. 패키지 형식과 프로세서 아키텍처는 서로 독립된 조건입니다.

설치 후 데스크톱 환경에 트레이 아이콘이 표시되는지 확인한 다음 브라우저에서 시스템 프록시를 사용할 수 있는지 테스트하세요. 프록시 설정 처리 방식은 데스크톱 환경마다 다를 수 있으며 터미널 프로그램은 설정을 따르지 않을 수도 있습니다. TUN이 필요하다면 해당 권한과 가상 인터페이스 상태를 확인하세요. 처음부터 시스템 라우팅, DNS, 여러 프록시 도구를 동시에 바꾸는 것은 권장하지 않습니다.

다운로드 Linux 클라이언트→

다운로드 페이지에서 설치 파일 종류와 시스템 요구 사항을 확인할 수 있습니다. 이 사이트는 클라이언트 다운로드와 설정 문서를 제공하며, 연결에 필요한 유효한 구독 또는 노드 매개변수는 별도로 준비해야 합니다.

모든 클라이언트 보기 →

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

먼저 가장 간단한 연결 하나를 성공시킨 다음 라우팅이나 TUN을 추가하세요. 설정은 한 번에 하나씩 바꾸면 문제가 생겼을 때 이전 단계로 돌아가기 쉽습니다.

  1. 구독 추가 및 업데이트 확인

    v2rayN에서 “구독 그룹”을 열고 알아보기 쉬운 그룹 이름을 입력한 뒤 전체 구독 주소를 붙여 넣으세요. 저장하고 “구독 업데이트(프록시 사용 안 함)”를 실행해 선택 가능한 노드가 목록에 나타나는지 확인한 다음 다음 단계로 넘어갑니다. 복사할 때 링크 앞뒤에 공백이 들어갔는지, 메신저가 주소를 잘라 보내지 않았는지도 확인하세요.

    업데이트 실패가 클라이언트 설치 실패를 뜻하지는 않습니다. 먼저 네트워크 오류인지, 인증 오류인지, 콘텐츠 형식을 인식하지 못한 것인지 구분하세요. 이미 사용 가능한 연결이 있을 때만 프록시를 통한 업데이트를 고려하면 됩니다. 단일 공유 링크와 구독 주소는 서로 다른 입력입니다. 전자는 연결 매개변수 한 묶음을 가져오고, 후자는 노드 목록을 가져와 업데이트합니다.

  2. 노드를 선택하고 트래픽 처리 방식 결정

    사용할 노드를 선택해 활성 설정으로 지정하세요. 데스크톱에서는 먼저 “시스템 프록시 자동 설정”을 사용해 시스템 설정을 따르는 브라우저를 연결합니다. Android에서는 클라이언트 안내에 따라 연결을 시작하고 시스템의 VPN 생성을 허용하세요. 처음 확인하는 동안 다른 네트워크 도구는 꺼 두어 설정이 서로 덮어쓰일 가능성을 줄이세요.

    더 많은 앱의 트래픽을 커널로 전달해야 할 때 TUN을 별도로 테스트하세요. 트래픽 처리 방식은 트래픽이 클라이언트에 들어오는 경로를 결정하고, 라우팅 규칙은 들어온 트래픽의 목적지를 결정합니다. 따라서 “TUN 활성화”와 “전역 프록시”는 같은 뜻이 아닙니다. 사용 가능한 설정을 기록해 두면 나중에 DNS나 라우팅을 바꿀 때 비교하기 쉽습니다.

  3. 웹페이지·앱·연결 종료 확인

    먼저 접속 가능한 것으로 확인된 웹사이트를 브라우저에서 연 다음 실제로 사용할 앱을 테스트하세요. 클라이언트가 실행 중이라고 표시되는 것은 프로세스나 인터페이스가 시작됐다는 뜻일 뿐, 전체 연결이 확인된 것은 아닙니다. 브라우저는 되는데 특정 앱만 실패한다면 해당 앱이 시스템 프록시를 읽는지, 자체 네트워크 설정을 사용하는지 먼저 확인하세요.

    노드 테스트 결과만으로 파일 다운로드나 동영상 재생 품질을 판단할 수는 없습니다. 속도에 문제가 생기면 노드, 회선, 로컬 설정 순으로 나누어 살펴보고 특정 대상에서만 문제가 발생하는지도 확인하세요. 마지막으로 연결을 중지해 테스트합니다. 더 이상 사용하지 않는 시스템 프록시를 해제하고 일반 네트워크에 접속되는지 확인하면 다음에 상태 변화를 추적하기 쉽습니다.

전체 가이드 보기 →

Project V, V2Fly, Xray

클라이언트·커널·프로토콜은 각각 다른 역할을 담당합니다. 이 관계를 이해하면 모든 네트워크 문제를 “노드 오류”로만 돌리지 않고 원인을 찾는 데 도움이 됩니다.

OPEN SOURCE

오픈 소스 생태계
와 설정 범위

사이트 소개 →

Project V: 도구 모음으로 이해하는 생태계

Project V는 V2Ray 생태계를 이해하는 출발점입니다. 일상적으로 “V2Ray”는 커널을 가리키기도 하고 여러 클라이언트를 통칭하기도 해, 가이드에서 서로 다른 계층의 설정을 혼동하기 쉽습니다. 실제 사용에서는 그래픽 인터페이스를 설정 관리 계층, 커널을 연결 실행 계층으로 나눠 볼 수 있습니다. 전자는 구독 저장, 활성 노드 선택, 설정 정리를 담당하고 후자는 설정 해석, 연결 수립, 라우팅 처리를 담당합니다. 브라우저나 다른 앱은 그 바깥에 있으며 시스템 프록시, 앱 내 프록시 또는 가상 인터페이스를 통해 트래픽을 전달해야 합니다.

따라서 같은 구독을 여러 클라이언트에서 사용할 수 있어도 모든 옵션이 그대로 옮겨지는 것은 아닙니다. 인터페이스에 일부 커널 기능만 표시될 수 있고 구독 변환 과정에서 설정 필드가 달라질 수도 있습니다. 문제를 해결할 때는 “V2Ray가 연결되지 않는다”고만 하기보다 클라이언트 이름, 사용 중인 커널, 트래픽 처리 방식을 기록하면 해당하는 안내를 더 쉽게 찾을 수 있습니다.

V2Fly와 Xray: 관련은 있지만 설정 매개변수는 호환되지 않을 수 있습니다

V2Fly 커뮤니티는 V2Ray 관련 개발을 이어가고 있으며, Xray는 관련 코드에서 발전한 별도의 커널 분기입니다. 두 프로젝트는 기술적 배경을 공유하지만 프로토콜 지원, 전송 기능, 설정 구현은 각자 발전해 왔습니다. 한쪽이 다른 쪽의 인터페이스 스킨이라고 단순화할 수 없으며, 이름만으로 모든 상황에서 어느 쪽이 더 빠른지 판단해서도 안 됩니다. 실제 연결 여부는 대개 서버 매개변수, 프로토콜 지원, 로컬 설정이 서로 맞는지에 달려 있습니다.

VMess와 VLESS는 연결 설정에서 확인해야 하는 프로토콜 이름입니다. REALITY는 연결 보안 메커니즘과 관련되므로 자유롭게 바꿔 쓸 수 있는 일반 노드 태그로 취급해서는 안 됩니다. 구독에 낯선 옵션이 있다면 먼저 해당 커널의 지원 여부를 확인한 뒤 클라이언트를 조정하세요. 프로토콜에 관한 추가 설명은 전체 문서의 공통 준비 섹션에서 확인할 수 있습니다. 설정 필드 하나를 이해하려고 소프트웨어 전체를 다시 설치할 필요는 없습니다.

세 가지 클라이언트: 플랫폼과 커널에 맞춰 선택

v2rayN은 구독·시스템 프록시·라우팅 설정을 한곳에서 관리하기 좋은 데스크톱용 오픈 소스 그래픽 클라이언트입니다. v2rayNG는 Xray 커널을 사용하는 Android 클라이언트이며, v2flyNG도 Android 그래픽 클라이언트로 V2Fly 커널을 선택할 수 있습니다. 세 프로젝트 모두 오픈 소스 클라이언트입니다. 배포 및 재배포 시 각 프로젝트에 적용되는 GPL-3.0 등의 라이선스와 포함된 의존성의 라이선스를 준수해야 합니다. 오픈 소스라는 사실은 코드와 라이선스에 관한 것이며, 구독 서비스의 이용 가능성을 보장하지 않습니다.

데스크톱 사용자는 먼저 v2rayN을 선택하고 운영체제와 프로세서에 맞는 설치 파일을 고르면 됩니다. Android 사용자는 노드 매개변수가 v2rayNG에 적합한지 확인하고, 호환성이 필요한 경우에만 v2flyNG를 고려하세요. 클라이언트에는 일반적으로 사용할 수 있는 연결 정보가 포함되어 있지 않으며 서버 계정, 유효 기간, 트래픽 상태를 대신 확인해 주지도 않습니다. 차이점을 비교하려면 실제 플랫폼과 매개변수를 기준으로 세 가지 클라이언트 비교를 확인하세요. 이름이 비슷하다는 이유로 선택하지 마세요.

업데이트 방식: 클라이언트·커널·구독을 구분해서 확인

클라이언트 업데이트는 주로 인터페이스와 설정 관리 기능에 영향을 주고, 커널 업데이트는 프로토콜 지원이나 동작 방식에 변화를 줄 수 있습니다. 구독 업데이트는 서비스 제공처에서 노드 목록을 다시 가져옵니다. 서로 다른 세 가지 유지 관리 경로입니다. 구독을 업데이트해도 클라이언트가 자동으로 업그레이드되지는 않으며 클라이언트를 바꿔도 만료된 계정이 복구되지 않습니다. 규칙 데이터베이스는 도메인·IP 분류와 라우팅 매칭에 쓰이는 별도 데이터입니다. 일부 사이트에서만 문제가 생기면 모든 구성 요소를 한꺼번에 교체하기보다 규칙과 이름 확인 결과를 함께 살펴보세요.

업그레이드 전에 기존 프록시 방식, 활성 노드, 사용자 지정 규칙을 기록하세요. 업그레이드 후에는 기본 연결부터 다시 확인하고 복잡한 설정을 하나씩 복원합니다. 로그를 공유할 때는 문제를 파악하는 데 필요한 정보만 남기고 구독 주소, 계정 식별 정보, 연결 키는 숨기세요. 이 사이트에서는 다운로드 경로와 설정 절차를 안내하지만, 실제 메뉴와 사용 가능한 기능은 설치된 클라이언트에 따라 다릅니다. 시스템 안내, 클라이언트 로그, 실제 접속 결과를 함께 살펴 판단해야 합니다.

V2Ray 설정 및 문제 해결 글

기본 연결을 확인한 다음 설정 구조, DNS, 규칙 데이터베이스를 살펴보세요. 문제에 맞는 글을 찾아 읽으면 모든 설정을 한꺼번에 바꿀 필요가 없습니다.