클라이언트 다운로드 / Xray 설정 가이드

v2rayN 클라이언트 다운로드 및 설정

오픈 소스 클라이언트 다운로드 경로를 모아 한국어 사용 설명으로 구독 가져오기, 시스템 프록시, 라우팅을 안내합니다. 주요 4개 플랫폼을 지원합니다.

Xray 코어 구독 관리 무료 사용
클라이언트 / 운영체제별 선택

V2Ray 클라이언트 다운로드

데스크톱에서는 v2rayN을 선택하세요. Android에서는 v2rayNG를 먼저 살펴보고, 코어 요구사항에 따라 v2flyNG도 고려할 수 있습니다.

Android

v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 기기 아키텍처에 맞는 버전을 선택하세요.

다운로드 페이지로 이동 →

Linux

v2rayN은 deb 및 rpm 패키지를 제공합니다. 배포판의 패키지 형식과 프로세서 아키텍처를 확인해 선택하세요.

다운로드 페이지로 이동 →

설치 파일을 고를 때는 운영체제와 프로세서 아키텍처를 차례로 확인하세요. 데스크톱 컴퓨터라고 모두 x64인 것은 아닙니다. ARM 프로세서를 사용하는 기기에는 해당 아키텍처용 패키지가 필요하며, 파일 확장자만으로 호환 여부를 판단할 수도 없습니다. 다운로드 페이지에서는 같은 클라이언트의 옵션을 한 카드에 모아 비교하기 쉽도록 했습니다. 처음 설치한다면 기기에 맞는 일반 버전을 사용하세요. 인터페이스 차이 때문에 여러 버전을 동시에 설치할 필요는 없습니다.

클라이언트를 설치했다고 해서 원격 연결까지 바로 사용할 수 있는 것은 아닙니다. 다음 단계로 직접 확보했고 사용 권한이 있는 구독 주소나 공유 링크를 가져와야 합니다. 구독 주소는 여러 연결 설정을 가져오는 데 쓰이고, 공유 링크는 보통 하나의 연결 정보를 담습니다. 클라이언트에서 가져오는 메뉴도 서로 다릅니다. 링크를 준비한 뒤 사용법을 확인하면 빈 목록과 설정 창을 오가며 헤매는 시간을 줄일 수 있습니다.

기존 설정을 사용 중이라면 업데이트 전에 클라이언트에서 구독 그룹, 사용자 지정 라우팅, 필요한 설정을 저장하세요. 데스크톱 버전과 클래식 인터페이스는 메뉴 위치가 다를 수 있으므로, 이전한 뒤 현재 서버와 수신 포트, 시스템 프록시 상태를 다시 확인해야 합니다. 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 하세요. 브라우저가 사용하는 포트와 실행 중인 클라이언트의 포트가 달라질 수 있습니다.

모든 클라이언트 보기 →
설정 / 메뉴부터 연결까지

v2rayN 주요 설정

먼저 트래픽이 들어오는 경로를 설정하고, 다음으로 라우팅을 확인하세요. 한 번에 하나씩 변경하면 연결에 문제가 생겼을 때 이전 상태로 되돌리기 쉽습니다.

앱이 로컬 프록시를 사용하도록 설정

시스템 프록시는 운영체제 설정을 따르는 앱이 클라이언트를 통해 연결할지 결정합니다. v2rayN을 처음 사용한다면 메인 화면의 시스템 프록시 메뉴에서 “시스템 프록시 자동 설정”을 선택한 다음 브라우저로 확인하세요. “시스템 프록시 해제”는 직접 연결 상태로 되돌리고, “시스템 프록시 변경 안 함”은 현재 설정을 유지합니다. 후자는 트래픽을 클라이언트로 보내는 설정이 아닙니다. 브라우저에 프록시를 별도로 입력하는 것과 달리, 시스템 프록시의 적용 범위는 앱이 운영체제 설정을 따르는지에 따라 달라집니다. 특정 프로그램이 계속 직접 연결된다면 구독을 반복해서 바꾸기보다 해당 프로그램의 네트워크 설정부터 확인하세요.

시스템 프록시 설정 방법 보기 →

각 설정은 서로 다른 단계에서 작동합니다. 구독은 연결 매개변수를 제공하고, 코어는 연결을 구성하며, 시스템 프록시나 TUN은 앱 트래픽을 클라이언트로 전달합니다. 라우팅은 각 연결의 출구를 결정합니다. 목록에 서버가 표시된다는 것은 가져오기가 완료됐다는 뜻일 뿐입니다. 브라우저로 접속하려면 트래픽 진입과 프로토콜 연결 단계도 거쳐야 합니다. 이 순서대로 점검하면 모든 스위치를 켜는 것보다 문제 지점을 찾기 쉽습니다.

처음 연결을 확인할 때는 정상 작동하는 설정을 기준으로 남겨 두세요. 먼저 서버를 선택하고 시스템 프록시를 활성화한 뒤, 브라우저로 원하는 사이트에 접속하면서 클라이언트 로그를 확인합니다. 특정 앱만 문제라면 시스템 프록시를 따르는지 먼저 확인하세요. 모든 앱에서 연결이 실패한다면 원격 연결과 로컬 포트를 점검합니다. 자세한 방법은 v2rayN 설정 가이드에서 확인하고, 플랫폼별 차이는 전체 설정 문서를 참고하세요.

생태계 / 클라이언트와 코어

Project V, V2Fly, Xray

클라이언트는 조작 인터페이스를 제공하고 코어는 프로토콜과 라우팅을 처리합니다. 이 관계를 이해하면 설치, 업데이트, 설정 순서를 정하기 쉽습니다.

Project V V2Fly Xray
프로젝트 배경

V2Ray에서 두 코어 계열로

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 프로젝트이며, V2Ray는 그중 널리 사용되는 핵심 구현입니다. 검색할 때 “V2Ray”는 코어를 가리키기도 하고 관련 프로토콜을 사용하는 클라이언트를 통칭하기도 합니다. 다운로드 전에는 두 의미를 구분하세요. 코어 자체에는 구독 목록, 트레이 메뉴, 설정 창이 포함된 완성형 데스크톱 앱이 없습니다. 그래픽 클라이언트가 이런 기능을 인터페이스로 제공하고 코어를 호출해 실행합니다.

V2Fly 커뮤니티는 V2Ray 관련 개발과 유지 관리를 이어가고 있으며, Xray는 이 기술 계보에서 갈라져 발전했습니다. 두 코어는 일부 역사와 설정 방식을 공유하지만, 각자 개발한 기능과 필드에는 차이가 있습니다. 오래된 가이드의 설정은 코어 이름만 바꾼다고 다른 계열에서 그대로 작동하지 않습니다. 특히 전송 방식, 보안 매개변수, 최신 프로토콜 기능은 실제 코어의 지원 여부를 확인해야 합니다.

따라서 어느 코어가 “더 강한지”부터 따질 필요는 없습니다. 현재 연결에 필요한 기능을 먼저 확인하세요. REALITY 등 Xray 기능을 사용하는 설정이라면 해당 코어를 실행할 수 있는 클라이언트를 선택해야 합니다. V2Fly용 설정이 있다면 대상 클라이언트가 필요한 매개변수를 유지할 수 있는지 먼저 확인하세요. 프로토콜 이름이 같더라도 전송 방식과 보안 옵션을 살펴봐야 하며, 목록에 표시된 약칭만 보고 판단해서는 안 됩니다.

그래픽 클라이언트

세 클라이언트의 역할

v2rayN은 데스크톱 운영체제용 오픈 소스 그래픽 클라이언트입니다. 컴퓨터에서 구독을 관리하고 서버를 선택하며 라우팅을 설정하는 데 적합합니다. 자주 쓰는 기능을 인터페이스로 제공하지만 실제 연결은 선택한 코어가 처리합니다. 인터페이스에 설정 항목이 보인다고 모든 코어 조합에서 같은 매개변수를 지원하는 것은 아닙니다. 코어를 바꾼 뒤 실행에 실패하면 먼저 로그를 확인하고 연결의 프로토콜과 필드 요구사항을 점검하세요.

v2rayNG는 Android용 클라이언트이며 Xray 코어를 사용합니다. 설정을 가져온 뒤 Android 시스템의 VPN 연결 권한을 허용하면 트래픽이 클라이언트로 전달됩니다. 데스크톱의 시스템 프록시 메뉴와는 작동 방식이 다릅니다. 처음 실행할 때는 시스템 권한 안내를 끝까지 읽고, 다른 앱이 이미 VPN 연결을 사용 중인지 확인하세요. 데스크톱 튜토리얼의 트레이 조작은 휴대폰에서 그대로 사용할 수 없습니다.

v2flyNG도 오픈 소스 Android 클라이언트이며, V2Fly 코어를 선택할 수 있습니다. 기존 설정이 이 코어에 맞거나 같은 코어 계열을 계속 사용하려는 경우에 적합합니다. v2rayNG와 v2flyNG는 이름만 다른 같은 프로그램이 아니므로 가져오기 전에 설정 호환성을 확인하세요. 전환을 시험할 때는 실행 중인 연결부터 중지해야 합니다. 두 클라이언트의 기본 사용 개념은 일부 비슷하지만 메뉴와 지원 매개변수는 각각 확인해야 합니다.

오픈 소스와 라이선스

소스 코드 공개 여부와 서비스 출처는 별개

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트이며, 각 프로젝트가 관련 코드를 관리합니다. 오픈 소스는 라이선스 범위 안에서 코드를 읽고 사용하고 연구할 수 있다는 뜻이지, 프로젝트마다 라이선스 조건이 같다는 뜻은 아닙니다. 클라이언트와 프록시 코어, 함께 제공되는 구성 요소에 서로 다른 라이선스가 적용될 수 있습니다. 수정하거나 재배포할 때는 해당 프로젝트에 포함된 라이선스 안내를 확인하세요.

클라이언트 소프트웨어와 원격 서비스는 별개입니다. 무료 클라이언트를 설치해도 구독이 자동으로 생성되거나 기존 구독의 이용 기간이 바뀌지는 않습니다. 구독의 주소, 포트, 인증 정보, 전송 설정은 해당 서비스 제공처에서 안내하며, 클라이언트는 이 정보를 읽고 사용하는 역할을 합니다. 구독이 만료됐거나 원격 주소에 연결할 수 없다면 소프트웨어를 재설치하기보다 제공처의 상태부터 확인하세요.

이 사이트는 클라이언트 다운로드와 그래픽 인터페이스 설정을 안내합니다. 예시 화면은 설정의 의미를 설명하기 위한 것으로, 원격 연결이 이미 구성됐다는 뜻은 아닙니다. 설정 제공처를 직접 선택할 때는 권한과 이용 조건을 확인하세요. 구독 링크는 접근 권한이 포함될 수 있는 정보로 취급해야 합니다. 로그를 공개하기 전 주소와 인증 정보, 전체 링크를 가리되 문제 해결에 필요한 오류 유형은 남겨 두세요.

유지 관리와 업데이트

인터페이스를 업데이트하고 설정 변화도 확인

그래픽 클라이언트와 코어는 서로 다른 주기로 업데이트될 수 있습니다. 클라이언트 업데이트는 메뉴, 구독 파싱, 플랫폼 지원을 바꿀 수 있고, 코어 업데이트는 프로토콜 기능과 설정 요구사항을 변경할 수 있습니다. 문제를 확인할 때는 클라이언트 이름, 사용 중인 코어, 오류 메시지를 따로 기록하세요. 인터페이스 변경을 구독 만료로 오해하거나 프로토콜 비호환성을 네트워크 연결 문제로 혼동하지 않도록 합니다.

안정적으로 작동하는 설정이 있다면 업데이트 전에 필요한 항목을 저장하세요. 업데이트 후에는 기존 연결 경로부터 테스트한 뒤 새 기능을 하나씩 활성화합니다. 클라이언트 교체, 코어 전환, 라우팅 재작성은 동시에 하지 마세요. 한 번에 여러 항목을 바꾸면 연결이 복구되더라도 어떤 변경이 해결에 도움이 됐는지 알기 어렵습니다. 직접 수정한 설정이 있다면 클라이언트가 실행하거나 저장할 때 런타임 파일을 다시 생성하는지도 확인하세요.

config.json에서 inbounds는 로컬 진입점을, outbounds는 출구를 정의하고 routing은 두 항목을 연결하는 규칙을 지정합니다. 그래픽 인터페이스는 보통 현재 선택에 따라 이 내용을 생성합니다. 초보자는 먼저 메뉴에서 설정을 마친 뒤 각 항목의 의미를 이해하고 생성된 결과를 살펴보세요. 임시 런타임 파일을 직접 수정하면 다음에 서버를 바꿀 때 내용이 덮어써질 수 있습니다.

문제 원인을 찾기 어렵다면 먼저 자주 묻는 질문에서 설치와 설정, 사용 팁, 문제 해결 항목을 살펴보세요. 처음부터 전체 과정을 다시 진행하려면 시작 가이드를 참고하세요. 플랫폼별 권한, 프록시, 설치 차이는 전체 플랫폼 설치 및 설정 문서에서 확인할 수 있습니다. 해당 단계부터 점검한 뒤 설정을 바꾸는 편이 같은 구독을 반복해서 가져오는 것보다 효과적입니다.

문서 / 설정과 문제 해결

V2Ray 설정 문서

구독 가져오기부터 설정 파일 생성까지, 필요한 주제를 골라 읽어 보세요. 아래 세 문서는 설정 구조, 목록 정리, 업데이트 실패를 각각 다룹니다.

구독 업데이트에 실패하면 먼저 점검 목록을 확인하세요. 라우팅을 바로 바꿀 필요는 없습니다. 연결은 되지만 목록 관리가 어렵다면 그룹과 필터 문서를 참고하세요. 설정 구조 문서는 기본 연결을 확인한 뒤 읽으면 클라이언트 메뉴가 어떤 항목을 생성하는지 이해하는 데 도움이 됩니다. 세 문서는 서로 다른 문제를 다루므로 현재 막힌 단계에 맞춰 선택하세요.

모든 문서 보기 →