Windows
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 평소 사용할 인터페이스를 고려한 뒤 다운로드 페이지의 버전 설명을 확인해 선택하세요. 설치 후에는 트레이 메뉴에서 시스템 프록시를 관리할 수 있습니다.
다운로드 페이지로 이동운영체제에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 라우팅 설정, 시스템 프록시를 차례로 설정하세요.
your-server.example가이드 / START HERE
v2rayN은 Windows, macOS, Linux 데스크톱용이며 v2rayNG와 v2flyNG는 Android용입니다. 설치만으로 설정이 끝나는 것은 아닙니다. 사용할 서버 정보나 구독 링크를 준비하고, 서버를 선택한 뒤, 어떤 앱에서 프록시를 사용할지 정하고 코어가 정상적으로 실행되는지 확인해야 합니다. 이 페이지에서는 각 설정이 어떻게 연결되는지 먼저 살펴봅니다. 화면별 설정 방법은 시작 가이드에서 확인할 수 있습니다.
구독 링크는 서버 설정을 가져오는 방법이지 클라이언트 설치 파일이 아닙니다. 라우팅 모드는 트래픽을 어디로 보낼지 정하고, 시스템 프록시는 해당 설정을 따르는 앱이 요청을 클라이언트로 전달할 수 있게 합니다. 개념을 구분해 두면 연결 문제를 하나씩 점검할 수 있어 클라이언트를 반복해서 다시 설치할 필요가 없습니다.
클라이언트 설정 / SETTINGS
아래 화면은 설정 항목 이름과 알아보기 쉬운 예시 값을 보여줍니다. 실제 서버 설정이 아니라 메뉴 위치를 안내하기 위한 예시입니다. 주제를 선택하고 오른쪽 설명을 읽은 다음 해당 가이드에서 설정을 진행하세요.
작업 설정https://example.com/sub‘구독 그룹’에서 새 그룹을 만들고 서비스 제공자가 안내한 V2Ray 구독 링크를 입력한 다음 ‘구독 업데이트’를 실행하세요. 그룹 이름은 이 기기에서 구분하기 위한 것이며, 연결에 필요한 링크는 서비스 제공자가 제공해야 합니다. 화면에 표시된 예시 주소로는 연결할 수 없습니다. 업데이트가 끝나면 해당 그룹에서 서버를 선택하세요. 목록이 바뀌지 않으면 링크가 온전한지, 올바른 그룹을 선택했는지 확인한 뒤 클라이언트 로그를 살펴보세요. 여러 곳의 구독은 그룹을 따로 만들어 두면 나중에 업데이트하거나 필터링할 때 변경된 설정의 출처를 쉽게 찾을 수 있습니다.
구독 가져오기 가이드 보기 →LAN 우회도메인 / IP라우팅 설정은 요청을 어디로 보낼지 정하는 기능이지 서버 계정 설정이 아닙니다. 처음에는 제공되는 모드 중 하나를 선택한 뒤 실제 사용 방식에 맞춰 도메인 또는 IP 규칙을 조정하면 됩니다. ‘LAN 우회’를 사용하면 프린터나 공유 폴더 같은 로컬 기기에 직접 연결할 수 있습니다. 규칙이 적용되려면 앱 트래픽이 클라이언트로 전달되어야 하므로 문제를 확인할 때 시스템 프록시 상태도 함께 살펴보세요. 도메인 유형별로 다르게 조회해야 한다면 DNS 라우팅 안내를 확인하세요. 라우팅 규칙과 도메인 조회 설정은 서로 다른 기능입니다.
DNS와 라우팅 안내 보기 →데스크톱에서 서버를 선택한 다음 트레이 메뉴에서 ‘시스템 프록시 자동 설정’을 선택해야 시스템 설정을 따르는 앱의 요청이 클라이언트로 전달됩니다. 종료하기 전에 원래 상태로 되돌리려면 ‘시스템 프록시 해제’를 선택하세요. 터미널 프로그램은 그래픽 환경의 시스템 프록시 설정을 읽지 않을 수 있고, 브라우저 확장 프로그램이나 자체 프록시 설정이 있는 앱은 다른 경로를 사용할 수도 있습니다. 브라우저와 명령줄의 동작이 다르다면 서버 항목을 바로 수정하기보다 각 환경의 프록시 설정 출처를 확인한 다음 클라이언트 연결을 점검하세요.
시스템 프록시 문제 해결 →VLESStcprealityVMess, VLESS, Trojan, Shadowsocks는 클라이언트에서 선택할 수 있는 서로 다른 프로토콜 유형입니다. REALITY는 주로 전송 계층 보안 관련 설정에 표시되며 서버 주소나 독립적인 라우팅 모드가 아닙니다. 서버를 직접 추가할 때는 프로토콜, 포트, 전송 방식, 보안 설정을 서버 측 구성과 하나씩 대조해야 합니다. 구독으로 가져온 설정에는 보통 해당 항목이 이미 포함되어 있으므로 수정하기 전에 원본 정보를 저장해 두세요. 프로토콜 선택은 이름만 보고 결정하기보다 기존 서비스 설정과 기기 호환성을 기준으로 해야 합니다.
프로토콜 기술 참고 자료 보기 →XrayV2Fly그래픽 클라이언트는 구독과 설정, 연결 메뉴를 관리하고 코어는 설정을 읽어 실제 연결을 처리합니다. v2rayNG는 주로 Xray 코어와 함께 사용하며 v2flyNG는 V2Fly 계열 코어를 사용합니다. 데스크톱용 v2rayN에서 선택할 수 있는 코어는 현재 클라이언트 설정을 기준으로 확인하세요. 코어를 전환하기 전에 필요한 프로토콜과 전송 기능을 지원하는지 살펴본 뒤 로그와 실제 앱 연결을 확인하세요. 시작 오류가 나타나면 포트 충돌, 항목 이름 오타, 설정 호환성부터 확인해야 합니다. 화면에 표시된 상태만으로 서버 사용 가능 여부를 판단해서는 안 됩니다.
코어 관계와 선택 기준 보기 →설정에는 정해진 순서가 있습니다. 먼저 구성을 가져와 서버를 선택하고, 코어가 해당 구성을 읽을 수 있는지 확인한 다음 라우팅과 시스템 프록시를 설정하세요. Android에서는 클라이언트 자체의 연결 제어와 앱별 프록시 옵션을 사용할 수 있습니다. 데스크톱 트레이 메뉴의 설정 이름이나 조작 방법을 휴대전화에 그대로 적용할 수는 없습니다. 문제가 발생하면 여러 항목을 한꺼번에 바꾸기보다 클라이언트, 운영체제, 프로토콜 항목, 로그 메시지를 기록해 하나씩 확인하는 편이 원인을 찾기 쉽습니다.
플랫폼별 다운로드 / DOWNLOADS
데스크톱에서는 v2rayN을 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 다운로드 페이지에서 프로세서 아키텍처와 설치 파일 형식을 확인하세요. 운영체제가 다른 파일은 서로 바꿔 사용할 수 없으므로 다운로드 전에 기기 정보를 확인해야 합니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 평소 사용할 인터페이스를 고려한 뒤 다운로드 페이지의 버전 설명을 확인해 선택하세요. 설치 후에는 트레이 메뉴에서 시스템 프록시를 관리할 수 있습니다.
다운로드 페이지로 이동v2rayN은 Apple Silicon과 Intel용 다운로드를 따로 제공합니다. 시스템의 칩 정보를 확인해 해당 설치 파일을 선택하세요. 사용할 때는 브라우저와 터미널의 프록시 설정이 일치하는지도 살펴보세요.
다운로드 페이지로 이동먼저 Xray 코어를 사용하는 v2rayNG를 확인하세요. V2Fly 계열 코어가 필요하다면 v2flyNG와 비교해 선택하면 됩니다. 두 클라이언트 모두 기기 아키텍처에 맞는 설치 파일을 제공합니다.
다운로드 페이지로 이동v2rayN은 패키지 형식과 기기 아키텍처에 따라 다운로드 항목이 다릅니다. 배포판에서 deb와 rpm 중 어떤 형식을 사용하는지 확인하고 프로세서 아키텍처도 대조하세요. 설치를 마친 뒤 구독을 가져오면 됩니다.
다운로드 페이지로 이동오픈 소스 생태계 / CONTEXT
세 가지 계층을 이해하고 프로토콜과 클라이언트를 선택하세요.
Project V는 V2Ray 관련 소프트웨어와 프로토콜이 발전해 온 중요한 배경입니다. 프로젝트와 커뮤니티가 발전하면서 V2Fly와 Xray는 서로 다른 코어 개발 경로를 형성했습니다. 두 코어 모두 설정을 해석하고 인바운드·아웃바운드 연결을 처리하며 라우팅 규칙을 적용하지만, 지원 기능과 설정 항목이 항상 똑같지는 않습니다. 서버 설정을 살펴볼 때는 ‘어떤 프로토콜을 사용하는가’와 ‘어떤 코어로 실행하는가’를 구분하세요. 그래픽 인터페이스에 특정 옵션이 보인다고 해서 모든 코어가 그 옵션을 같은 방식으로 처리하는 것은 아닙니다.
v2rayN, v2rayNG, v2flyNG는 기기에 따라 선택하는 오픈 소스 그래픽 클라이언트입니다. 서버 편집, 구독 업데이트, 라우팅 선택, 연결 제어를 사용하기 쉬운 화면에 모아 설정 파일을 직접 편집할 일을 줄여 줍니다. v2rayN은 데스크톱 운영체제용이고 v2rayNG와 v2flyNG는 Android용이며, 두 Android 클라이언트는 사용하는 코어 계열이 다릅니다. 클라이언트 이름, 프로토콜 이름, 코어 이름은 서로 다른 계층입니다. 설치 파일을 고를 때는 운영체제를, 설정 호환성을 확인할 때는 코어와 프로토콜을 살펴보세요.
이 클라이언트와 관련 코어는 오픈 소스 커뮤니티에서 유지 관리합니다. 공개된 코드는 개발자가 구현을 검토하고 개선 사항을 제안하며 프로토콜 기능의 변화를 따라가는 데 도움이 됩니다. 오픈 소스라고 해서 일상적인 설정 확인이 필요 없어지는 것은 아닙니다. 구독 제공자가 서버 설정을 바꿀 수 있고 코어 업데이트에 따라 항목 처리 방식이 달라질 수도 있습니다. 원본 구독 정보를 보관하고 클라이언트 업데이트 안내를 확인하며 문제가 생기면 로그를 살펴보는 것이 연결 아이콘만 확인하는 것보다 안전한 관리 방법입니다. 여러 기기에서 같은 구독을 사용하더라도 각 클라이언트가 해당 프로토콜과 전송 옵션을 지원하는지 따로 확인해야 합니다.
주로 컴퓨터에서 사용한다면 운영체제에 맞는 v2rayN을 선택하고 기기 아키텍처에 맞는 설치 파일을 받으세요. 휴대전화에서는 v2rayNG부터 살펴보고, 현재 설정에 V2Fly 계열 코어가 필요한 경우 v2flyNG를 고려할 수 있습니다. 기존 구독을 사용하는 경우에는 구독에 실제로 포함된 프로토콜과 전송 설정부터 확인하세요. 이름이 더 새로워 보인다는 이유만으로 정상 작동하는 서버 설정을 바꿀 필요는 없습니다. VMess, VLESS, Trojan, Shadowsocks 및 REALITY의 차이와 역할을 자세히 비교하려면 기술 참고 자료를 확인하세요.
프로토콜 및 코어 기술 참고 자료 보기 →자주 묻는 질문 / QUICK ANSWERS
아래 답변은 설치와 연결 과정에서 자주 헷갈리는 내용을 다룹니다. 전체 설정 절차나 더 많은 문제 해결 방법은 시작 가이드와 자주 묻는 질문 페이지에서 확인하세요.
데스크톱에서는 v2rayN의 ‘구독 그룹’에서 새 그룹을 만들고 링크를 입력한 다음 해당 그룹을 업데이트하세요. 구독 주소를 개별 서버 편집 창의 서버 주소 칸에 입력하면 안 됩니다. 설정 단계 보기 →
먼저 코어가 정상적으로 실행되는지 확인한 다음 ‘시스템 프록시 자동 설정’과 앱 자체의 프록시 설정을 살펴보세요. 터미널 명령줄과 브라우저는 서로 다른 설정을 참조할 수 있습니다. 문제 해결 순서 보기 →
REALITY는 설정에서 전송 계층 보안과 관련된 옵션이며 별도로 설치하는 클라이언트가 아닙니다. 직접 설정을 입력할 때는 프로토콜 유형, 전송 방식, 서버 매개변수를 각각 확인하세요. 개념 빠르게 보기 →
대체로 각 기기의 클라이언트에서 구독을 가져온 뒤 양쪽 모두 구독에 포함된 프로토콜과 전송 설정을 지원하는지 확인해야 합니다. 연결 제어와 시스템 프록시 설정 위치는 기기마다 다르므로 각각 설정하세요. 클라이언트 비교 →
사용 팁 / ARTICLES
시스템 프록시, 코어 로그, 구독 그룹 등 겪고 있는 문제에 맞춰 관련 설정을 찾아보세요. 글에 나오는 명령과 주소는 설정 위치를 설명하기 위한 예시이며, 실제 값은 기기와 서비스 설정을 기준으로 해야 합니다.