Xray 코어 클라이언트 가이드 다운로드 및 설정 안내

Xray 공식 사이트 v2rayN 다운로드 및 라우팅 분할

공식 v2rayN 다운로드 사용 가이드 보기

운영체제에 맞는 GUI 클라이언트를 선택하고 구독 가져오기, 시스템 프록시, 라우팅 분할을 순서대로 설정하세요. Xray, V2Fly 코어와 클라이언트의 관계도 함께 설명합니다.

Xray-core 영구 무료 오픈 소스 한국어 사용 문서

CONFIGURATION FLOW

하나의 설정으로 네 가지 플랫폼 지원

클라이언트마다 화면은 달라도 핵심 순서는 같습니다. 운영체제에 맞는 프로그램을 선택하고, 유효한 구독을 가져온 다음, 프록시 적용 범위를 확인하고, 라우팅 규칙으로 연결 유형별 아웃바운드를 결정합니다.

Windows Android macOS Linux

INPUT

구독은 하나의 그룹으로 관리

구독 주소를 그룹에 저장한 뒤 업데이트하면 클라이언트가 설정을 읽고 서버 목록을 다시 만듭니다. 여러 출처의 구독도 그룹별로 관리할 수 있어 업데이트와 필터링이 뒤섞이지 않습니다.

CORE

Xray 및 V2Fly 코어

GUI 클라이언트는 가져오기, 선택, 상태 제어를 담당하고, 코어는 프로토콜 처리, DNS, 인바운드, 아웃바운드 및 라우팅 매칭을 담당합니다. 두 계층의 역할은 명확히 분리됩니다.

OUTPUT

규칙이 연결 출구를 결정

라우팅은 도메인, IP, 프로세스 등의 조건을 순서대로 매칭하며, 일치하면 direct, proxy 또는 block 아웃바운드로 처리합니다.

SUBSCRIPTION

주소를 먼저 저장한 다음 목록을 업데이트하세요

구독 가져오기는 웹 주소를 서버 연결로 바로 사용하는 작업이 아닙니다. 클라이언트가 먼저 구독 URL을 저장하고 설정 내용을 요청한 뒤, 파싱이 끝나야 선택 가능한 서버 항목이 생성됩니다. 처음에는 주소의 앞뒤가 완전한지 확인하고, 출처가 다른 구독은 해당 그룹에 나누어 저장하세요. 저장 후 “구독 업데이트”를 실행해 목록이 새로 고쳐져야 가져오기가 완료된 것입니다. 이후 설정을 업데이트할 때도 같은 메뉴를 사용하면 되며, 항목을 하나씩 다시 추가할 필요가 없습니다.

업데이트 후에도 목록이 비어 있다면 시스템 시간, 네트워크 접속 및 구독 유효기간을 먼저 확인한 뒤 클라이언트 로그에서 요청 결과를 살펴보세요. 주소, 네트워크, 파싱 문제를 분리해 원인을 찾을 수 있습니다.

구독 그룹
└─ 기본 그룹
   ├─ 구독 추가
   ├─ 구독 업데이트
   └─ 서버 필터링

URL 구조:
https://example.invalid/sub?token=xxxx

CLIENT DOWNLOADS

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

데스크톱 플랫폼에서는 v2rayN을 사용하고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 페이지에서 패키지 유형, 프로세서 아키텍처 및 시스템 요구 사항을 계속 안내합니다.

DESKTOP

Windows

v2rayN GUI 클라이언트를 사용하며 데스크톱 버전과 클래식 WPF 버전 중에서 선택할 수 있습니다. 처음 설치한 뒤 구독을 가져오고 시스템 프록시와 라우팅 방식을 설정하세요.

  • 일반적인 데스크톱 브라우징과 앱 프록시에 적합
  • 구독 그룹, 라우팅 및 TUN 설정 지원
다운로드하기

DESKTOP

macOS

기기 프로세서에 맞춰 v2rayN의 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. 처음 실행할 때는 시스템 안내에 따라 앱 실행 허용과 네트워크 권한 설정을 완료해야 합니다.

  • 설치 패키지는 프로세서 아키텍처와 일치해야 합니다
  • 시스템 프록시와 네트워크 권한을 각각 확인
다운로드하기

MOBILE

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하면 v2flyNG를 선택할 수 있습니다. 최근 출시된 대부분의 기기는 arm64를 지원하며, 확실하지 않다면 시스템 아키텍처 안내를 확인하세요.

  • 스캔, 클립보드 및 구독 가져오기 지원
  • 필요한 코어에 맞는 클라이언트 선택
다운로드하기

DESKTOP

Linux

v2rayN 데스크톱 클라이언트를 사용하고 배포판에 따라 deb 또는 rpm 패키지를 선택하세요. 프로세서가 ARM 아키텍처라면 해당 arm64 빌드도 선택해야 합니다.

  • 설치 패키지 유형은 배포판과 일치해야 합니다
  • 시스템 프록시는 데스크톱 환경별로 확인할 수 있습니다
다운로드하기
전체 클라이언트 보기 →

OPEN SOURCE ECOSYSTEM

Project V, V2Fly 및 Xray 코어의 관계

클라이언트, 코어, 프로토콜 및 구독 서비스는 서로 다른 계층에 속합니다. 이 개념을 분리해 이해해야 설치, 설정, 연결 문제가 각각 어디에서 발생했는지 정확히 판단할 수 있습니다.

Project V에서 코어 제품군으로

Project V는 네트워크 프록시 프로토콜과 조합 가능한 설정을 중심으로 형성된 오픈 소스 기술 생태계입니다. 초기에는 V2Ray라는 이름이 코어 프로그램을 가리키는 동시에 관련 프로토콜, 클라이언트 및 설정 형식을 넓게 지칭하는 데 사용되었습니다. 프로젝트가 발전하면서 V2Fly는 v2ray-core의 커뮤니티 유지보수 흐름을 이어갔고, Xray는 일반적인 설정 방식을 호환하는 기반 위에서 독립적인 코어로 발전했습니다. 두 코어 모두 인바운드, 아웃바운드, 라우팅, DNS, 전송 및 정책 모듈을 포함하지만 구체적인 기능, 설정 필드 및 업데이트 주기는 다를 수 있습니다.

GUI 클라이언트는 코어와 같지 않습니다. v2rayN, v2rayNG, v2flyNG는 메뉴, 구독 관리, 서버 선택, 로그 확인 및 시스템 적용 기능을 제공하고, 실제 프로토콜 연결과 라우팅 매칭은 클라이언트가 호출하는 코어가 처리합니다. 따라서 화면 조작 문제가 발생하면 클라이언트 설정을 확인하고, 설정 파싱, 프로토콜 핸드셰이크 또는 라우팅 동작에 문제가 있으면 코어 로그를 함께 확인해야 합니다.

세 클라이언트의 용도

v2rayN은 Windows, macOS 및 Linux 데스크톱 환경을 대상으로 하며 구독 그룹, 시스템 프록시, 라우팅 규칙 및 TUN 기능이 필요한 사용자에게 적합합니다. v2rayNG는 Android용으로, 일반적으로 Xray 코어와 함께 사용하며 모바일 환경에서 가져오기, 선택, 실행 및 앱 적용에 초점을 둡니다. v2flyNG 역시 Android용이지만 V2Fly 코어를 사용하므로 해당 코어의 동작이나 설정 호환성이 필요한 경우에 활용할 수 있습니다.

세 프로그램 모두 커뮤니티에서 유지보수하는 오픈 소스 클라이언트입니다. 오픈 소스는 코드, 변경 기록 및 라이선스 조항을 검토할 수 있다는 뜻이며, 프로젝트마다 유지관리자의 계획에 따라 업데이트가 배포된다는 뜻이기도 합니다. 클라이언트와 코어는 서로 다른 오픈 소스 라이선스를 적용할 수 있으므로 설치하거나 재배포할 때는 제품명만 보고 권한 범위를 추정하지 말고 각 프로젝트에 포함된 라이선스 문서를 확인해야 합니다.

업데이트 방식과 설정 호환성

클라이언트 업데이트에는 보통 화면, 시스템 통합, 구독 처리 및 코어 관리의 변경 사항이 포함됩니다. 코어 업데이트는 프로토콜 구현, 전송 동작, 라우팅 규칙, DNS 및 하위 네트워크 처리와 관련되는 경우가 많습니다. 두 요소를 같은 날 업데이트해야 하는 것은 아닙니다. 다운로드 페이지에서는 최신 클라이언트 설치 진입점을 제공하고, 프로그램 내부의 코어 관리 기능에서는 클라이언트가 호출하는 핵심 구성 요소를 확인하고 전환할 수 있습니다.

설정 호환성도 계층별로 판단해야 합니다. 기본 인바운드, 아웃바운드 및 라우팅 구조는 비슷할 수 있지만 특정 프로토콜 매개변수나 확장 기능은 다른 코어에서 그대로 재사용되지 않을 수 있습니다. 설정을 이전하기 전에는 원본을 보존하고 최소한의 작동 설정부터 테스트하세요. 기본 연결이 정상인지 확인한 뒤 DNS, 분할 및 TUN 설정을 단계적으로 추가하면 어떤 필드가 파싱 실패나 동작 차이를 일으켰는지 명확히 알 수 있습니다.

COMMON QUESTIONS

설정 시작 전 확인할 네 가지 질문

다음 질문은 클라이언트 선택, 구독 업데이트, 시스템 프록시 및 라우팅 순서를 다룹니다. 더 자세한 설치와 문제 해결 절차는 튜토리얼, 고급 매뉴얼 및 자주 묻는 질문 페이지에서 각각 확인할 수 있습니다.

데스크톱 시스템에는 어떤 클라이언트를 선택해야 하나요?

Windows, macOS, Linux 모두 v2rayN으로 시작할 수 있습니다. 다운로드할 때 운영체제와 프로세서 아키텍처를 먼저 확인한 뒤 알맞은 설치 패키지를 선택하세요. 설치가 끝나면 “구독 추가—목록 업데이트—서버 선택—시스템 프록시 설정” 순서로 진행하면 됩니다. 사용 가능한 설정이 없는 상태에서 복잡한 라우팅부터 수정하지 마세요.

클라이언트 비교 보기 →
구독 주소를 추가했는데 서버 목록이 비어 있는 이유는 무엇인가요?

주소를 추가하는 것은 저장만 완료한 상태이므로 구독 업데이트를 실행해야 합니다. 업데이트 후에도 비어 있다면 주소가 완전한지, 시스템 시간이 정확한지, 구독이 유효한지, 로그에 네트워크 요청 또는 콘텐츠 파싱 오류가 있는지 순서대로 확인하세요. 원인에 따라 해결 방법이 다르므로 클라이언트를 반복해서 삭제하고 다시 설치하는 것은 권장하지 않습니다.

구독 가져오기 단계 보기 →
시스템 프록시를 켰는데 일부 프로그램이 연결되지 않는 이유는 무엇인가요?

시스템 프록시는 운영체제의 프록시 설정을 읽는 프로그램에만 영향을 줍니다. 일부 앱은 독립적인 네트워크 스택을 사용하거나 자체 프록시 주소를 저장하며, TUN 모드로 연결을 적용해야 할 수도 있습니다. 먼저 브라우저와 같은 일반 프로그램이 정상인지 확인한 뒤 대상 앱의 네트워크 설정을 점검하여 앱 적용 문제를 서버 연결 문제로 오해하지 않도록 하세요.

시스템 프록시 문제 해결 보기 →
라우팅 규칙의 direct, proxy, block은 각각 무엇을 의미하나요?

direct는 연결을 직접 아웃바운드로 보내고, proxy는 설정된 프록시 아웃바운드로 전달하며, block은 연결을 차단합니다. 규칙은 보통 위에서 아래로 확인하고 먼저 일치한 결과를 적용합니다. 규칙을 추가할 때는 매칭 내용뿐 아니라 포괄적인 기본 규칙보다 앞에 배치되었는지도 확인해야 합니다.

라우팅 분할 장 읽기 →

LATEST GUIDES

최근 설정 및 문제 해결 문서

권한 처리, 구독 그룹 및 DNS 경로를 중심으로 재현 가능한 작업 절차를 정리했습니다. 각 문서는 하나의 구체적인 문제에 집중하므로 증상에 맞는 점검 과정으로 바로 이동할 수 있습니다.

플랫폼 노트

v2rayN macOS가 실행되지 않을 때: 확인되지 않은 개발자와 네트워크 권한 단계별 해결

시스템 차단 알림부터 시작해 개인정보 보호 및 보안에서의 실행 허용, 네트워크 확장 승인, 권한 요청을 순서대로 설명하고, 앱 실행 불가와 네트워크 기능 권한 미승인 문제를 구분합니다.

전체 글 읽기 →
고급 설정

v2rayN 여러 구독 그룹 관리: 키워드로 서버 필터링 및 그룹 정렬

여러 구독을 함께 사용할 때 출처를 분리하고 업데이트 주기를 설정하는 방법, 지역 키워드로 서버를 필터링하는 방법, 그룹 선택과 라우팅 방식을 명확히 연결하는 방법을 설명합니다.

전체 글 읽기 →
문제 해결

V2Ray DNS 유출 테스트 방법과 dns 모듈 유출 방지 설정 실습

DNS 요청이 예상한 경로를 벗어날 수 있는 이유를 설명하고 단계별 점검 방법을 제시하며, dns 아웃바운드와 domainStrategy 등의 설정 항목으로 DNS 트래픽 방향을 조정하는 방법을 안내합니다.

전체 글 읽기 →
전체 글 보기 →
v2rayN 다운로드