그래픽 클라이언트 및 설정 문서

V2Fly 공식 사이트
v2rayN 클라이언트

v2rayN 다운로드 가이드 보기

4개 플랫폼 클라이언트入口와 구독 가져오기 단계, 라우팅 분할 설정을 한곳에 정리했습니다. 메뉴 경로, 모드별 차이와 문제 해결 순서를 실제 작업 흐름에 맞춰 설명합니다.

영구 무료 오픈 소스 한국어 문서 Xray · V2Fly
플랫폼 선택 Windows Android macOS Linux
데스크톱 클라이언트

v2rayN

Windows·macOS·Linux 그래픽 인터페이스

코어 계열

Xray

V2Fly 생태계와 병렬로 발전

관리 방식

오픈 소스

설정 동작과 릴리스 기록을 공개적으로 검토 가능

플랫폼 Windows · macOS · Android · Linux 클라이언트 v2rayN · v2rayNG · v2flyNG 코어 Xray · V2Fly 특징 무료 · 오픈 소스 · 커뮤니티 유지보수
플랫폼별 다운로드

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

데스크톱에서는 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 아래 링크를 누르면 다운로드 페이지의 해당 플랫폼 패널이 열리며, 패키지 형식·아키텍처·시스템 요구 사항을 확인할 수 있습니다.

데스크톱 시스템

Windows · v2rayN

최신 데스크톱 인터페이스와 클래식 WPF 인터페이스를 제공합니다. 처음 사용하는 경우 데스크톱 버전을 우선 선택하고, 기존 작업 방식이나 클래식 메뉴 구조가 익숙하다면 다운로드 페이지에서 WPF 버전 안내를 확인하세요.

다운로드 페이지로 이동
데스크톱 시스템

macOS · v2rayN

기기 프로세서에 맞춰 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. 시스템의 “이 Mac에 관하여”에서 칩 유형을 확인할 수 있으며, 설치 후 구독 및 라우팅 메뉴는 다른 데스크톱 버전과 유사하게 구성됩니다.

다운로드 페이지로 이동
모바일 시스템

Android · v2rayNG / v2flyNG

v2rayNG는 Xray 코어를 사용해 일반적인 선택지로 적합하고, v2flyNG는 V2Fly 코어를 사용하므로 서버 설정과 사용 목적에 따라 선택할 수 있습니다. 대부분의 최신 기기는 arm64를 사용하며, 확실하지 않다면 범용 버전을 확인하세요.

다운로드 페이지로 이동
데스크톱 시스템

Linux · v2rayN

Debian·Ubuntu 등은 deb 패키지를, Fedora·Rocky Linux 등은 rpm 패키지를 선택하세요. 다운로드 페이지에서 x64와 arm64 아키텍처를 구분하고 설치 전 필요한 데스크톱 환경 조건도 안내합니다.

다운로드 페이지로 이동
모든 클라이언트 보기
설정 기능

구독부터 라우팅까지 전체 작업 흐름

클라이언트의 핵심 가치는 연결 하나를 가져오는 데서 끝나지 않습니다. 구독 업데이트 방식, 시스템 프록시가 제어하는 프로그램, 라우팅 규칙의 매칭 순서, TUN 모드를 활성화할 시점이 실제 사용 결과에 직접 영향을 줍니다. 이 영역에서는 실제 설정 항목을 기준으로 6가지 기능을 나누어, 먼저 조작 경로를 제시한 뒤 적용 범위와 확인 방법을 설명합니다.

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}
구독 관리

주소·그룹·업데이트 상태를 나누어 확인

v2rayN에서 “구독 그룹 → 구독 그룹 설정”으로 구독 주소를 저장한 뒤 “모든 구독 업데이트”를 실행해 서버 목록을 가져올 수 있습니다. 그룹 이름은 출처를 정리하는 용도이며 노드 매개변수는 바꾸지 않습니다. 업데이트 후 목록이 비어 있다면 주소가 완전한지, 반환된 내용을 클라이언트가 해석할 수 있는지, 현재 네트워크에서 요청이 허용되는지, 클라이언트 로그에 형식 관련 안내가 있는지 순서대로 확인하세요. 공유 링크를 하나씩 붙여 넣는 것보다 계속 변경되는 설정 묶음을 관리할 때 구독 방식이 더 적합합니다.

빠른 시작

설치·가져오기·활성화 3단계

먼저 재현 가능한 기본 연결을 하나 만든 뒤 자동 업데이트, 라우팅, TUN을 단계적으로 추가하세요. 처음 설정할 때 한 번에 옵션 하나만 변경하면 문제가 어느 단계에서 발생했는지 더 쉽게 판단할 수 있습니다.

  1. 01

    운영체제와 클라이언트 선택

    데스크톱에서는 v2rayN의 해당 플랫폼 패널로 이동하고, Android에서는 필요한 코어에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 설치 전에 프로세서 아키텍처와 패키지 형식을 확인해 아키텍처 불일치를 프로그램 시작 실패로 오해하지 않도록 하세요. 처음 실행한 뒤에는 기본 라우팅과 기본 포트를 유지하고 고급 매개변수는 서둘러 변경하지 않는 것이 좋습니다.

  2. 02

    구독 가져오기 및 목록 업데이트

    클라이언트의 구독 그룹 설정에서 주소를 추가하고 저장한 후 업데이트를 실행하세요. 서버 목록이 표시되면 설정 하나를 선택해 활성 서버로 지정합니다. 목록이 비어 있다면 먼저 구독 업데이트 로그를 확인하고, 노드는 있지만 시작되지 않는다면 코어 로그를 확인하세요. 두 문제를 한 번에 섞어 진단하지 않는 것이 좋습니다.

  3. 03

    코어 시작 및 트래픽 제어 방식 선택

    활성 서버를 확인한 뒤 코어를 시작하고 앱 유형에 따라 시스템 프록시를 선택하세요. 일반 브라우저는 먼저 시스템 프록시를 테스트하고, 시스템 프록시를 읽지 않는 프로그램은 TUN을 검토합니다. 기본 연결이 안정된 후 LAN 우회, 도메인 매칭, 특정 출구 등의 라우팅 규칙을 추가하세요.

전체 가이드 보기
오픈 소스 생태계

Project V, V2Fly 및 Xray의 관계

클라이언트, 코어, 프로토콜 설정, 구독 서비스는 각각 다른 역할을 담당합니다. 이러한 경계를 이해하면 문제가 인터페이스 조작, 설정 내용, 코어 호환성, 원격 서비스 중 어디에 속하는지 판단하는 데 도움이 됩니다.

Project V에서 병렬 유지보수 코어 계열로

Project V는 V2Ray 설정 체계의 기본 구조를 마련했습니다. 인바운드는 로컬 트래픽을 받고, 아웃바운드는 전달 대상을 정의하며, routing은 둘 사이에서 매칭을 수행하고, dns와 log는 도메인 해석 및 실행 기록을 제공합니다. V2Fly 커뮤니티는 V2Ray Core와 관련 규격을 계속 유지보수하고 있으며, Xray는 같은 기술 흐름에서 독립적인 코어로 발전했습니다. 두 코어는 많은 설정 개념을 공유하지만 구체적인 필드, 프로토콜 확장과 릴리스 주기는 다를 수 있습니다.

따라서 “클라이언트가 특정 공유 링크를 지원한다”는 판단과 “현재 코어가 해당 매개변수를 완전히 처리할 수 있다”는 판단은 서로 다릅니다. 그래픽 클라이언트는 구독을 해석하고 설정을 생성하며 프로세스를 관리하지만, 실제 프로토콜 핸드셰이크와 라우팅·전달을 수행하는 것은 코어입니다. 서버 매개변수가 바뀌면 화면에 서버 이름이 표시되는지만 확인하지 말고 클라이언트의 해석 능력과 코어의 지원 범위를 함께 점검해야 합니다.

오픈 소스 라이선스와 공개 협업 방식

v2rayN, v2rayNG, v2flyNG 및 관련 코어는 모두 오픈 소스 방식으로 유지보수됩니다. 소스 코드, 설정 형식, 변경 기록은 각 프로젝트에서 공개적으로 관리하며, 기능 논의·버그 수정·호환성 조정은 유지보수 담당자와 커뮤니티 참여자가 계속 진행합니다. 오픈 소스이므로 개발자는 설정 생성 방식을 이해할 수 있고, 고급 사용자는 로그와 필드 정의를 바탕으로 동작 차이를 추적할 수 있습니다.

구성 요소마다 적용되는 오픈 소스 라이선스가 다를 수 있습니다. 라이선스는 코드의 복사·수정·재배포 방식을 규정할 뿐, 모든 클라이언트를 같은 팀이 관리한다는 뜻은 아닙니다. 문서를 사용할 때는 대상을 분명히 하세요. v2rayN의 메뉴 경로를 모바일 클라이언트에 그대로 적용할 수 없고, Xray의 확장 필드가 모든 V2Fly 설정에서 사용된다고 가정해서도 안 됩니다. 구성 요소별 안내를 확인하면 개념을 혼동하는 일을 줄일 수 있습니다.

업데이트 방식과 호환성 판단

클라이언트 업데이트에는 보통 인터페이스 조정, 구독 파싱 변경, 설정 생성 수정, 코어 관리 기능이 포함됩니다. 코어 업데이트는 프로토콜 구현, 전송 동작, 라우팅, DNS에 더 집중합니다. “업데이트 전에는 작동했지만 후에는 이상해진” 경우 먼저 변경된 대상이 클라이언트인지 코어인지 구독 내용인지 기록한 뒤 로그를 계층별로 다시 확인하세요. 여러 구성 요소를 동시에 교체하면 실제 영향을 준 변수를 판단하기 어렵습니다.

일상적인 유지보수는 일정한 순서로 진행하는 것이 좋습니다. 먼저 구독을 업데이트하고 노드 목록을 확인한 다음, 현재 알고 있는 설정으로 시작하고, 마지막에 프록시 모드와 라우팅을 조정하세요. 장기간 사용하는 규칙에는 목적, 매칭 조건, 출구 태그를 기록해 두는 것이 좋습니다. 그러면 인터페이스 메뉴가 바뀌어도 특정 버튼 위치에 의존하지 않고 설정의 의미를 바탕으로 기존 동작을 복원할 수 있습니다.

데스크톱 추천

v2rayN

Windows·macOS·Linux용 그래픽 클라이언트로 구독 그룹, 서버 목록, 시스템 프록시, 라우팅 규칙, TUN과 코어 로그를 한곳에서 관리합니다. 데스크톱에서 여러 설정을 유지하고 실행 상태를 확인하려는 사용자에게 적합합니다.

Android

v2rayNG

Xray 코어를 주요 구현으로 사용하는 모바일 클라이언트로, QR 코드·클립보드·구독 방식으로 설정을 가져올 수 있습니다. 주요 작업은 설정 목록, 활성 노드, 라우팅 설정, 연결 로그를 중심으로 이루어집니다.

V2Fly 코어

v2flyNG

V2Fly 코어 계열을 사용하는 모바일 선택지로, 인터페이스 조작과 일반적인 구독 절차를 명확하게 구분합니다. V2Fly 코어의 호환 범위를 분명히 알고 있거나 두 코어의 동작을 비교하려는 상황에 적합합니다.

자주 묻는 질문

구독·코어·프록시 모드를 먼저 구분

대부분의 설정 문제는 발생 단계에 따라 먼저 분류할 수 있습니다. 목록에 내용이 없으면 구독 요청과 파싱을, 프로그램이 시작되지 않으면 코어 로그를, 일부 앱에서만 적용되지 않으면 트래픽 제어 방식을 중점적으로 확인하세요.

구독 업데이트 후 서버 목록이 비어 있음

먼저 저장한 주소가 완전한 구독 주소인지 확인한 다음 업데이트 로그의 네트워크 요청과 파싱 안내를 살펴보세요. 주소를 열 수 있다고 해서 반환된 내용이 클라이언트가 지원하는 구독 형식이라는 뜻은 아닙니다. 최근 구독 출처를 변경했다면 그룹에 이전 주소가 남아 있는지도 확인하세요.

구독 가져오기 단계 보기 →

시작 후에도 브라우저가 기존 연결을 사용함

활성 서버가 선택되었는지, 코어가 실행 중인지, 트레이 메뉴의 시스템 프록시 상태가 올바른지 확인하세요. 일부 프로그램은 별도 프록시 설정을 사용하거나 시스템 설정을 읽지 않으므로 따로 설정하거나, 권한과 충돌을 확인한 뒤 TUN을 사용해야 합니다.

연결 및 확인 단계 보기 →

코어 시작 직후 종료됨

로그에서 첫 번째 명확한 오류를 찾으세요. 일반적인 단서는 포트 사용 중, 존재하지 않는 아웃바운드 태그, 잘못된 설정 필드 형식, 누락된 전송 매개변수입니다. 한 항목을 수정한 뒤 다시 시작하고 포트·라우팅·코어를 동시에 변경하지 마세요.

전체 문제 해결 과정 보기 →

전역 프록시와 라우팅 분할 중 무엇을 선택할까

전역 프록시는 짧은 시간 동안 노드와 코어가 정상 작동하는지 확인할 때 적합합니다. 기본 연결을 확인한 뒤 라우팅 분할로 전환하고 규칙을 하나씩 추가하세요. 기본 출구를 먼저 검증한 다음 LAN·도메인·IP 규칙을 추가하면 매칭 순서 문제를 더 빠르게 찾을 수 있습니다.

라우팅 분할 섹션 보기 →
설정 정보

최신 v2rayN 사용법 및 문제 해결 글

메인 화면 영역, 로그 확인 방법, JSON 설정 구조를 중심으로 구체적인 사용법을 정리했습니다. 글마다 하나의 문제를 다루므로 기본 가이드를 마친 뒤 필요한 내용을 이어서 확인하기 좋습니다.

시작 가이드

v2rayN 메인 화면 기능별 상세 안내: 서버 목록·구독 그룹·로그 창·설정 메뉴

메인 창을 위에서 아래로 살펴보며 서버 목록 열 제목, 구독 그룹 탭, 하단 로그 창과 자주 쓰는 설정 메뉴를 설명해 명확한 작업 지도를 제공합니다.

전체 글 읽기
문제 해결

v2rayN 코어가 시작되지 않을 때: 로그 창에서 설정 오류를 찾는 문제 해결 과정

포트 충돌, 설정 필드 누락, 전송 매개변수 불일치, 코어 파일 이상 등 대표적인 단서를 정리하고 항목별 수정 순서를 안내합니다.

전체 글 읽기
고급 설정

V2Ray 설정 파일 구조별 해설: inbounds·outbounds·routing의 역할 구분

간결한 JSON 설정을 바탕으로 인바운드·아웃바운드·라우팅의 관계를 설명하고 log와 dns가 전체 설정에서 어떤 위치를 차지하는지 안내합니다.

전체 글 읽기
모든 글 보기