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

v2flyNG 다운로드v2rayN 및 V2Ray 설정 가이드

오픈소스 클라이언트를 선택하고 한국어 안내에 따라 구독을 가져온 뒤 라우팅을 설정하세요.

구독 관리 로컬 프록시 Xray · V2Fly
socks/http 127.0.0.1:10808라우팅 중국 본토 우회

클라이언트 설정 예시 · 연결 버튼을 누르면 입문 가이드가 열립니다

운영체제에 맞는 클라이언트 선택

데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 살펴보세요. 기기 아키텍처를 확인한 다음 다운로드 페이지에서 설치 파일을 선택하면 클라이언트와 코어를 혼동하지 않을 수 있습니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 차세대 크로스 플랫폼 인터페이스와 클래식 인터페이스는 메뉴 구성이 다르지만, 구독 가져오기, 서버 선택, 시스템 프록시 설정 순서는 기본적으로 같습니다.

먼저 시스템 설정에서 기기 종류를 확인한 뒤 다운로드 페이지의 지원 안내에 따라 선택하세요. 설치 후에는 설정 파일 위치를 유지하고, 서로 다른 인터페이스 버전의 프로그램 파일을 한 폴더에 덮어쓰지 마세요. 문제 발생 시 출처를 구분하기 어려울 수 있습니다.

다운로드 페이지로 이동

macOS

v2rayN은 Apple Silicon과 Intel 칩에 맞는 다운로드 경로를 제공합니다. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인하고, 설치 파일의 아키텍처가 기기와 일치하는지 확인하세요.

처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정하세요. 클라이언트를 실행한 뒤 구독 내용과 시스템 프록시 설정을 각각 확인하세요. 브라우저에서 프록시를 사용할 수 있는지는 브라우저가 시스템 설정을 따르는지에 따라서도 달라집니다.

다운로드 페이지로 이동

Android

v2rayNG는 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어를 선택할 수 있습니다. 대부분의 최신 휴대전화에서는 먼저 arm64 설치 파일을 확인하고, 기기 아키텍처를 모를 때는 범용 버전 안내를 살펴보세요.

설정을 가져온 뒤 처음 실행할 때 시스템 VPN 권한을 허용해야 합니다. 같은 시스템 인터페이스를 사용하는 다른 앱이 실행 중이면 충돌 여부를 확인하세요. 백그라운드에서 연결이 끊긴다면 배터리 관리와 백그라운드 실행 권한도 점검해야 합니다.

다운로드 페이지로 이동

Linux

v2rayN은 deb 및 rpm 패키지를 제공합니다. 먼저 배포판의 패키지 형식을 확인하고 프로세서 아키텍처를 점검하세요. 데스크톱 환경과 시스템 종속성, 앱 자체의 프록시 설정도 실제 사용 방식에 영향을 줍니다.

그래픽 인터페이스 앱과 터미널 프로그램은 서로 다른 프록시 설정을 사용할 수 있습니다. 클라이언트를 설정한 뒤 시스템 프록시를 따르는 앱으로 먼저 확인하고, 프록시가 필요한 터미널 도구는 별도로 설정하세요. 트레이 아이콘만 보고 트래픽 경로를 판단하지 마세요.

다운로드 페이지로 이동

구독, 라우팅, 로컬 포트

클라이언트는 설정을 실제 연결에 필요한 구성으로 변환합니다. 다섯 개 주제를 차례로 살펴보고 각 항목의 역할을 이해한 뒤 해당 설정을 변경하세요.

구독 가져오기 및 그룹 업데이트

구독 주소는 여러 서버 설정을 가져오는 주소이며, 개별 서버 공유 링크와는 다릅니다. v2rayN의 구독 그룹에 주소를 추가하고 저장한 다음 업데이트를 실행해 사용 가능한 항목이 목록에 표시되는지 확인하세요. 출처가 여러 곳이면 그룹을 따로 만들어 업데이트와 필터링을 편하게 관리할 수 있습니다. 구독에는 접속 정보가 포함될 수 있으므로 공개된 페이지에 올리지 마세요. 업데이트 후에는 사용할 서버를 선택하고 시스템 프록시와 라우팅 설정도 확인해야 합니다. 서버 정보를 하나씩 입력하는 것보다 구독으로 관리하는 편이 편리하지만, 가져오기가 가능한지는 클라이언트가 해당 구독 형식을 지원하는지에 달려 있습니다.

  • 위치: 구독 그룹
  • 추가: 그룹 이름, 구독 주소
  • 업데이트: 서버 목록 가져오기
  • 선택: 활성 서버로 지정
  • 확인: 시스템 프록시, 라우팅 모드

인터페이스 옵션과 설정 필드 연결하기

구독 가져오기는 서버 설정의 출처에 관한 문제이고, 라우팅은 요청의 목적지에 관한 문제이며, 로컬 리스닝은 앱이 접속하는 방식에 관한 문제입니다. 이 세 가지는 따로 기록하세요. 연결에 문제가 생기면 먼저 어느 단계에서 발생했는지 파악한 다음 관련 설정을 확인하는 편이 여러 옵션을 한꺼번에 바꾸는 것보다 결과를 재현하기 쉽습니다.

설정 파일에서 inbounds는 인바운드를, outbounds는 아웃바운드를 정의하고 routing은 규칙을 매칭해 경로를 지정합니다. DNS와 정책 설정도 조회 및 연결 동작에 영향을 줍니다. 인터페이스가 생성하는 설정은 코어에 따라 달라질 수 있으므로 예시 조각을 일반 설정처럼 그대로 조합할 수 없습니다. 필드별 설명은 V2Ray 설정 전체 가이드에서 확인하세요.

처음 설정할 때 거치는 세 단계

클라이언트 설치는 준비의 시작일 뿐입니다. 유효한 서버 설정과 앱 동작에 맞는 프록시 설정도 필요합니다. 먼저 순서대로 연결을 확인한 뒤 자동 업데이트나 사용자 지정 규칙을 추가하세요.

  1. 1단계

    구독을 가져오고 목록 확인

    신뢰할 수 있는 출처에서 구독 주소를 받아 구독 그룹에 추가한 다음 업데이트하세요. 업데이트가 끝나면 서버 항목의 프로토콜 유형과 그룹을 확인하고 활성 서버를 선택합니다. 개별 공유 링크는 해당 가져오기 메뉴로 등록하고 구독 주소 입력란에 넣지 마세요.

    목록이 비어 있다면 먼저 클라이언트 메시지를 확인하고, 복사 과정에서 공백이 추가되지 않았는지, 주소가 완전한지, 구독이 아직 유효한지 살펴보세요. 이 단계에서는 아직 연결이 시작되지 않았으므로 라우팅 모드를 바꿔도 구독 형식 오류는 해결되지 않습니다.

  2. 2단계

    라우팅 확인 후 연결 시작

    데스크톱에서는 시스템 프록시 옵션을 확인하고 현재 필요에 맞는 라우팅 프리셋을 선택하세요. Android에서는 시스템 안내에 따라 연결 권한을 허용합니다. 로컬 포트가 정상적으로 리스닝하는지 확인한 다음 접속을 테스트하세요. 시작 중 오류가 발생하면 로그에서 처음 나타나는 구체적인 오류부터 확인하세요.

    ‘전역’은 일반적으로 라우팅 적용 범위를 뜻하며 모든 앱이 자동으로 클라이언트를 통과한다는 의미는 아닙니다. 일부 앱은 별도의 프록시 설정을 사용하고 터미널 도구는 환경 변수에 의존할 수도 있습니다. 연결 방식과 트래픽 분배 방식은 각각 확인해야 합니다.

  3. 3단계

    요청을 확인하고 유효한 설정 기록

    실제로 사용할 앱에서 대상 페이지를 열고 클라이언트 로그를 확인해 요청이 코어에 들어왔는지 살펴보세요. 지연 시간 테스트는 특정 방식으로 측정한 결과일 뿐입니다. 페이지 로딩, 다운로드, 장시간 연결 등 실제 사용 환경을 대신할 수는 없습니다.

    정상 작동을 확인했다면 클라이언트, 코어, 로컬 포트, 라우팅 모드를 기록하세요. 이후 설정을 바꿀 때는 한 번에 한 항목만 수정하고 기존 설정을 보관합니다. 테스트가 끝난 뒤 클라이언트를 사용하지 않는다면 시스템 프록시가 원하는 상태로 복구됐는지도 확인하세요.

Project V와 코어 생태계

프로젝트, 코어, 그래픽 클라이언트의 역할을 구분하면 기능을 어디서 찾아야 할지 판단하기 쉽습니다. 오픈소스 여부는 구현 방식과 라이선스를 설명하며, 실제 호환성은 설정과 실행 환경을 함께 확인해야 합니다.

생태계 이해

Project V

V2Ray의 모듈형 프록시 설계 이해

연결 처리

V2Fly / Xray

프로토콜, 전송, 조회, 라우팅 실행

그래픽 관리

v2rayN / v2rayNG / v2flyNG

구독, 서버, 앱 설정 관리

생태계의 발전과 모듈형 설정

Project V는 V2Ray 생태계를 이해하는 출발점입니다. 설정 구조는 로컬 접속, 원격 연결, 라우팅 처리를 서로 다른 모듈로 나누어 필요에 따라 조합할 수 있게 합니다. V2Fly 커뮤니티는 V2Ray 관련 개발과 유지 관리를 이어 왔으며, Xray는 같은 기술 계보에서 발전해 별도의 구현을 갖추었습니다. 두 프로젝트는 공통된 배경이 있지만 기능 발전 방향은 서로 다르므로 설정 모양이 비슷하다는 이유만으로 서로 대체할 수 있다고 판단하면 안 됩니다.

사용자라면 모든 필드를 외우기보다 인바운드, 아웃바운드, 라우팅의 관계부터 이해하는 편이 도움이 됩니다. 프로토콜은 양쪽이 사용하는 연결 규약이고 전송은 연결을 전달하는 방식이며 TLS 등의 설정은 또 다른 계층에 속합니다. 문제를 해결할 때 계층별로 점검하면 도메인 조회 실패를 프로토콜 비호환으로 오해하는 일을 줄이고 불필요한 코어 변경도 피할 수 있습니다.

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

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 그래픽 클라이언트입니다. v2rayN은 데스크톱 환경에서 구독, 서버, 코어 설정을 관리하며, v2rayNG는 Android에서 Xray 코어를 사용합니다. v2flyNG는 Android에서 V2Fly 기반의 대안을 제공합니다. 인터페이스에 표시되는 옵션은 클라이언트가 구현한 기능이며, 실제로 사용할 수 있는 프로토콜과 확장 기능은 코어에도 좌우됩니다.

오픈소스 프로젝트는 각각의 라이선스로 사용, 수정, 재배포 조건을 정합니다. 클라이언트와 코어, 함께 제공되는 구성 요소의 라이선스가 서로 같지 않을 수 있으므로 관련 안내를 각각 확인해야 합니다. 프로젝트 배경을 살펴보면 구성 요소의 출처를 이해하는 데 도움이 되지만 소프트웨어 라이선스는 서버 서비스 약관과 다르며 외부 구독의 품질을 보장하지 않습니다.

업데이트 전 호환성 확인

클라이언트 업데이트로 메뉴, 설정 저장 방식, 코어 관리 로직이 바뀔 수 있고 코어 업데이트로 지원 필드와 기본 동작이 달라질 수 있습니다. 업데이트 전에 정상 작동하는 설정을 백업하고 현재 라우팅과 로컬 포트를 기록하세요. 사용자 지정 설정을 사용하는 경우 필드 변경을 특히 주의 깊게 확인하세요. 프로그램이 실행된다는 이유만으로 이전이 완료됐다고 판단하면 안 됩니다.

업데이트 후에는 같은 앱, 같은 대상, 같은 라우팅 모드로 비교 테스트하세요. 차이가 발생하면 로그와 생성된 설정을 먼저 확인한 뒤 이전 버전으로 되돌릴지 판단합니다. 구독 업데이트와 클라이언트 업데이트는 서로 다른 작업입니다. 전자는 서버 목록을 새로 고치고 후자는 소프트웨어 기능을 갱신합니다. 두 작업을 구분하면 문제를 더 정확히 설명할 수 있습니다.

설정 자료와 서비스 범위

이 사이트는 클라이언트 다운로드 경로, 사용 절차, 설정 참고 자료를 정리하며 서버 구독은 제공하지 않습니다. 문서의 로컬 주소는 리스닝 구조를 설명하기 위한 것이고 JSON 조각은 설정 구조를 안내하기 위한 것으로, 바로 사용할 수 있는 원격 연결 정보가 포함되어 있지 않습니다. 실제 사용 시에는 현재 클라이언트 인터페이스, 코어 문서, 설정 제공자의 안내를 따르세요.

네트워크 도구를 사용할 때는 해당 지역의 관련 법률과 네트워크 서비스 규정을 준수하세요. 설정 필드의 의미는 설정 전체 가이드에서, 클라이언트 선택은 클라이언트 비교에서 확인할 수 있습니다. 프로젝트 배경과 사이트에서 다루는 내용은 소개 페이지를 참고하세요.

설정 활용 및 문제 해결

구체적인 증상에 맞는 글부터 살펴보세요. 서버 선택, 그룹 관리, 앱 프록시는 각각 점검 방법이 다르므로 먼저 문제 범위를 파악한 다음 조치하세요.