클라이언트·코어·설정 문서

Xray 코어 스테이션
v2rayN 클라이언트 다운로드

v2rayN 다운로드 가이드 보기

운영체제에 맞는 클라이언트 페이지로 이동해 구독 가져오기, 프로토콜 선택, 라우팅 설정의 전체 절차를 확인하세요.

영구 무료 오픈 소스 한국어 문서 Xray · V2Fly
PLATFORMS Windows · macOS · Android · Linux CLIENTS v2rayN · v2rayNG · v2flyNG CORES Xray · V2Fly LICENSE 오픈 소스 소프트웨어 생태계

운영체제별 선택

네 가지 플랫폼의 클라이언트 링크

홈에서는 플랫폼별로 안내합니다. 설치 패키지 유형, 시스템 아키텍처, 클라이언트별 차이는 클라이언트 페이지에서 통합해 설명하므로, 기기 환경을 확인하기 전에 잘못된 패키지를 선택하는 일을 줄일 수 있습니다.

데스크톱 플랫폼

Windows

Windows 사용자는 v2rayN을 이용할 수 있으며, 최신 크로스 플랫폼 데스크톱 인터페이스와 기존 WPF 방식 중에서 선택할 수 있습니다. 다운로드 페이지에서는 두 버전의 사용 조건, 최초 실행 위치, 시스템 프록시 메뉴와 일반적인 실행 의존성을 각각 설명합니다. 기존 인터페이스에 익숙하다면 그대로 사용하고, 새로 설치한다면 데스크톱 버전 안내를 먼저 확인한 뒤 선택하세요.

다운로드 페이지로 이동

데스크톱 플랫폼

macOS

macOS에서는 v2rayN 데스크톱 클라이언트를 사용하며, 설치 전에 프로세서 아키텍처를 확인해야 합니다. Apple Silicon과 Intel은 서로 다른 설치 패키지를 사용하므로 운영체제 이름만 보고 판단할 수 없습니다. 클라이언트 페이지에서 칩 확인 경로, 패키지 선택 기준, 최초 실행 권한 안내와 시스템 프록시 활성화 후 기본 점검 방법을 제공합니다.

다운로드 페이지로 이동

모바일 플랫폼

Android

Android에서는 코어 계열에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. v2rayNG는 Xray 코어를 사용해 Xray 관련 프로토콜과 전송 기능이 필요한 설정에 적합하고, v2flyNG는 V2Fly 코어를 사용해 기존 V2Fly 설정 체계에 활용할 수 있습니다. 최근 기기의 대부분은 arm64 패키지를 우선 확인하고, 아키텍처를 모를 때는 범용 버전 안내를 참고하세요.

다운로드 페이지로 이동

데스크톱 플랫폼

Linux

Linux 데스크톱에서는 v2rayN을 사용하며, 배포판에 맞춰 deb 또는 rpm 패키지를 선택한 뒤 x64와 arm64 아키텍처도 확인해야 합니다. 설치 후에는 클라이언트 프로세스, 데스크톱 환경의 프록시 설정, 애플리케이션의 시스템 프록시 인식 여부를 각각 점검하세요. 플랫폼 페이지에서 패키지 선택과 실행 확인을 연속 단계로 안내합니다.

다운로드 페이지로 이동

모든 클라이언트 및 설치 안내 보기 →

클라이언트 설정 경로

구독 가져오기부터 라우팅 적용까지

네 가지 설정 그룹은 실제 사용 과정의 서로 다른 단계에 해당합니다. 탭을 선택하면 설정 목표, 작업 순서와 화면 예시를 확인할 수 있습니다.

규칙 우선순위

라우팅 프리셋 및 사용자 지정 분기

라우팅 설정은 각 연결을 어떤 출구로 처리할지 결정합니다. 처음에는 클라이언트의 프리셋 규칙부터 시작해 보세요. 예를 들어 “중국 본토 우회”를 선택해 저장한 다음 메인 화면에서 현재 라우팅 모드를 확인합니다. 세밀하게 제어하려면 domain, ip, geosite, geoip 조건으로 규칙을 추가하고, 규칙은 보통 화면에 표시된 순서대로 매칭된다는 점에 유의하세요.

이 설정은 시스템 프록시와 같은 스위치가 아닙니다. 시스템 프록시는 애플리케이션이 연결을 클라이언트에 넘기도록 하고, 라우팅 규칙은 클라이언트가 연결을 받은 뒤 처리 방향을 결정합니다. 두 기능을 구분하면 라우팅만 바꿨는데 브라우저가 프록시 절차를 거치지 않거나, 시스템 프록시는 켜졌지만 특정 도메인이 기존 규칙으로 처리되는 문제를 피할 수 있습니다.

프로토콜 및 라우팅 참고 자료 보기 →
라우팅 설정프리셋 규칙
중국 본토 우회현재 선택
전역 프록시선택 가능
전역 직접 연결선택 가능
사용자 지정 규칙편집

빠른 시작

구독·모드·연결 3단계 점검

처음 설정할 때는 정해진 순서대로 진행하세요. 각 단계를 완료한 뒤 다음 단계로 넘어가면 구독 내용, 클라이언트 상태와 애플리케이션 적용 범위를 각각 확인할 수 있습니다.

  1. 01

    구독 그룹 추가 및 업데이트 실행

    클라이언트의 구독 그룹 관리 화면을 열고 새 그룹을 추가한 뒤 식별하기 쉬운 메모와 전체 구독 주소를 입력하세요. 저장 후 구독 업데이트를 실행하고 클라이언트가 해석을 완료할 때까지 기다린 다음 서버 목록으로 돌아가 해당 그룹에 사용 가능한 설정이 나타나는지 확인합니다. 목록이 비어 있다면 현재 그룹 필터, 주소 복사 범위와 업데이트 알림을 먼저 점검하고 라우팅이나 시스템 프록시를 바로 변경하지 마세요.

    구독은 설정 묶음을 배포하는 방식이며 클라이언트나 특정 프로토콜과는 다릅니다. 클라이언트는 자체적으로 지원하는 필드와 프로토콜 조합만 읽습니다. 여러 구독 출처는 각각 그룹을 만들고 명확한 메모를 사용하는 것이 좋습니다. 그러면 업데이트 후 차이가 생겼을 때 혼합 목록을 하나씩 확인하지 않고 특정 출처로 범위를 좁혀 문제를 찾을 수 있습니다.

  2. 02

    서버 및 라우팅 모드 선택

    서버 목록에 설정이 나타나면 먼저 사용할 항목을 선택한 뒤 라우팅 설정을 열어 처리 모드를 확인하세요. 일반적인 환경에서는 프리셋 규칙으로 시작하고, 연결 경로를 이해한 후 사용자 지정 domain, ip, geosite 또는 geoip 조건을 추가하면 됩니다. 규칙 순서는 매칭 결과에 영향을 주므로 새 규칙을 추가할 때 용도를 기록하고 서로 겹치는 광범위한 조건을 동시에 만들지 않도록 하세요.

    프로토콜 유형은 설정 내용과 일치해야 합니다. 서버를 직접 추가할 때는 실제 설정에 따라 VMess, VLESS, Trojan 또는 Shadowsocks 등의 항목을 선택하고 주소, 포트, 인증 정보와 전송 매개변수를 하나씩 입력하세요. 구독 가져오기는 보통 이러한 필드를 포함합니다. 필드의 의미를 확실히 알지 못한다면 시험 삼아 전송 계층 옵션을 임의로 바꾸지 않는 것이 좋습니다.

  3. 03

    시스템 프록시 활성화 및 애플리케이션 확인

    데스크톱 클라이언트에서 설정을 선택한 후 시스템 프록시를 시스템 프록시 자동 설정으로 전환하고, 확인에 사용할 브라우저나 애플리케이션을 다시 여세요. Android 클라이언트는 시스템 연결 확인 화면에서 권한을 완료하고 클라이언트를 연결 상태로 유지해야 합니다. 확인할 핵심은 버튼 색상이 아니라 대상 애플리케이션이 현재 연결 경로를 실제로 읽는지 여부입니다.

    연결할 수 없다면 “구독 업데이트 여부—설정 선택 여부—코어 호환 여부—시스템 프록시 적용 여부—애플리케이션의 시스템 설정 인식 여부” 순서로 단계별 점검을 진행하세요. 로그는 프로토콜 핸드셰이크, 도메인 확인과 라우팅 매칭 단계의 문제를 확인하는 데 유용하지만, 먼저 앞선 기본 점검을 완료해야 합니다. 한 번에 하나의 변수만 바꿔야 조정이 실제로 효과가 있었는지 판단할 수 있습니다.

전체 가이드 보기

오픈 소스 생태계

Project V, V2Fly 및 Xray

클라이언트, 코어, 프로토콜과 구독은 각각 다른 역할을 담당합니다. 소프트웨어 이름만 외우는 것보다 이러한 계층을 구분하는 편이 선택과 문제 해결에 도움이 됩니다.

Project V에서 두 코어 계열로

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙과 설정 구조를 중심으로 한 오픈 소스 기술 생태계를 형성했습니다. 초기 사용자들은 V2Ray를 프로젝트, 코어와 전체 도구를 가리키는 말로 함께 사용했지만, 실제로는 개념을 구분해야 합니다. 그래픽 클라이언트는 설정 관리와 시스템 통합을 담당하고, 코어는 연결을 처리하며, 프로토콜은 통신 방식을 정의하고, 구독은 설정 묶음을 배포합니다.

V2Fly는 V2Ray의 커뮤니티 유지보수 흐름을 이어가며 널리 사용된 설정 모델과 프로토콜 기능을 유지합니다. Xray는 유사한 설정 체계를 바탕으로 독립적인 코어 계열로 발전했고 VLESS, REALITY 관련 기능 등을 확장했습니다. 두 계열에는 공통 개념이 많지만 모든 필드, 전송 조합과 새 기능이 바로 호환되는 것은 아닙니다. 클라이언트에 표시되는 Core 유형은 설정 호환 관계를 판단하는 중요한 정보입니다.

설정 선택은 특정 이름을 먼저 정하는 것이 아니라 서버에서 실제로 제공하는 매개변수에서 출발해야 합니다. 구독에 VLESS와 REALITY 조합이 포함되어 있다면 해당 필드를 인식할 수 있는 코어와 클라이언트를 사용해야 합니다. 기존 설정 체계가 V2Fly를 기반으로 한다면 구독 형식과 프로토콜 필드가 해당 코어의 지원 범위에 속하는지 확인하세요. 프로토콜 참고 페이지에서는 인증 설계, 연결 수립, 리소스 사용량과 모바일 사용 조건도 비교합니다.

데스크톱 클라이언트

v2rayN

v2rayN은 서버 목록, 구독 그룹, 라우팅 설정, 시스템 프록시와 로그 등의 그래픽 메뉴를 제공하며 Windows, macOS와 Linux 데스크톱 플랫폼을 지원합니다. 데스크톱 설치 패키지는 운영체제, 프로세서 아키텍처와 인터페이스 유형에 따라 구분되므로 다운로드 전에 기기 조건을 확인해야 합니다.

Android · Xray

v2rayNG

v2rayNG는 Xray 코어를 사용하는 Android 그래픽 클라이언트로, Xray 생태계의 프로토콜과 전송 필드가 포함된 설정을 가져오기에 적합합니다. 구독, 라우팅과 연결 스위치는 모두 모바일 화면에서 관리하며, 설치 패키지를 선택할 때 기기 아키텍처도 고려해야 합니다.

Android · V2Fly

v2flyNG

v2flyNG는 V2Fly 코어 설정 체계를 대상으로 하는 Android 클라이언트로, 다른 코어 계열을 선택할 수 있는 방법입니다. v2rayNG와의 주요 차이는 화면 색상이 아니라 하위 코어, 프로토콜 기능과 설정 호환 범위에 있습니다.

오픈 소스 프로토콜 및 코드 검토

세 클라이언트와 관련 코어는 오픈 소스 소프트웨어 생태계에 속하며, 공개 프로젝트 자료와 커뮤니티 문서를 통해 소프트웨어 동작, 설정 구조와 기능 변경을 지속적으로 검토할 수 있습니다. 오픈 소스라는 특성은 점검·논의·재현 가능한 엔지니어링 기반을 제공할 뿐, 사용자를 대신해 설정을 판단해 주는 것은 아닙니다. 사용자는 다운로드 플랫폼, 코어 유형, 구독 출처와 서버 매개변수가 서로 맞는지 확인해야 합니다.

업데이트 방식 및 설정 마이그레이션

클라이언트 업데이트에는 보통 인터페이스 조정, 코어 호환 작업, 프로토콜 기능 변경과 문제 수정이 포함됩니다. 큰 폭의 업데이트 후 마이그레이션할 때는 먼저 구독 그룹, 라우팅 규칙과 시스템 프록시 모드를 기록한 뒤 다운로드 페이지와 관련 기술 노트를 확인하세요. 구독 주소는 다시 가져올 수 있지만 로컬 사용자 지정 규칙, 수동 서버와 애플리케이션 수준의 네트워크 설정은 각각 확인해야 합니다.

문서와 소프트웨어의 역할 범위

Xray 코어 스테이션은 클라이언트 선택과 그래픽 인터페이스 사용을 중심으로 자료를 정리합니다. 다운로드 페이지에서는 플랫폼과 소프트웨어 패키지 선택을, 시작 가이드에서는 구독부터 연결까지의 순서를, 프로토콜 참고 자료에서는 코어와 프로토콜의 호환 관계를 다루며, 도움말에서는 설치·설정·문제 해결 질문을 모읍니다. 문서는 클라이언트 프로젝트 자체의 기능 설명을 대신하지 않으며, 차이가 있을 때는 실제 화면과 현재 설정 필드를 기준으로 판단해야 합니다.

기술 노트

플랫폼, 라우팅 규칙 및 클라이언트 비교

각 글은 구체적인 설정 항목을 중심으로 설명하며, 시작 가이드에서 자세히 다루기 어려운 배포판별 차이, 규칙 조합과 클라이언트 비교 내용을 보충합니다.

고급 설정

v2rayN 중국 본토·해외 분기 설정 실전: 프리셋 규칙, 화이트리스트와 블랙리스트

v2rayN 라우팅 설정 화면을 기준으로 “중국 본토 우회” 같은 프리셋 규칙의 실제 처리 범위를 설명하고, 화이트리스트와 블랙리스트 방식의 분기 전략을 비교합니다. 규칙 조합, 우선순위 확인과 애플리케이션 검증 절차도 함께 안내합니다.

글 읽기 →
플랫폼

v2rayN Linux 데스크톱 설치: deb/rpm 패키지 및 로그인 시 자동 시작 설정

Ubuntu, Debian과 Fedora 데스크톱 사용자를 대상으로 deb·rpm 패키지 선택, 시스템 의존성, 사용자 단위 자동 시작과 데스크톱 환경의 시스템 프록시 점검 순서를 정리합니다.

글 읽기 →
클라이언트 비교

v2rayN·v2rayNG·v2flyNG 선택 가이드: 세 클라이언트의 기능 및 코어 차이 비교

플랫폼 지원 범위, 코어 계열, 프로토콜 지원, 구독 관리와 라우팅 기능을 기준으로 세 클라이언트를 비교하고, 데스크톱에서는 v2rayN을 선택하는 방법과 Android에서 Xray 또는 V2Fly 설정 체계에 따라 결정하는 방법을 설명합니다.

글 읽기 →

모든 글 보기 →