클라이언트 설정 안내

V2Ray 가이드:v2rayN 클라이언트 다운로드와 설정

v2rayN 다운로드 사용법 보기

그래픽 클라이언트 선택부터 구독 가져오기, 라우팅 및 시스템 프록시 확인까지 화면의 항목을 하나씩 설정하세요.

프로토콜
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
플랫폼

설정 / 자주 쓰는 항목

설정 항목을 먼저 찾고, 변경 방법을 정하세요

구독, 라우팅, 시스템 프록시, DNS는 각각 다른 역할을 합니다. 연결에 문제가 생기면 노드를 계속 바꾸기보다 어느 단계에서 문제가 발생했는지 먼저 확인하는 편이 원인을 찾기 쉽습니다.

01 / SUBSCRIPTION

구독 주소, 업데이트 및 그룹

구독은 변경될 수 있는 서버 목록을 관리할 때 유용합니다. v2rayN의 ‘구독 그룹’에서 이름과 구독 주소를 추가한 다음 구독을 업데이트하세요. 업데이트 후에는 서버 목록에서 사용할 항목을 직접 선택해야 합니다. 용도별로 그룹 이름을 구분하고, 구독 업데이트와 현재 서버 변경을 같은 작업으로 혼동하지 마세요. 서버 설정이 한 세트뿐이라면 직접 추가하는 편이 간편합니다. 별칭은 로컬에서 서버를 구분할 때만 사용됩니다.

목록에 변화가 없다면 주소가 완전한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지, 올바른 그룹을 선택했는지 차례로 확인하세요. 여러 구독을 함께 쓴다면 먼저 그룹을 확인한 뒤 키워드로 필터링하면 이름이 비슷한 서버를 잘못 고를 가능성을 줄일 수 있습니다. 오래된 항목을 삭제하기 전에는 유효한 구독에서 계속 관리되는 항목인지 확인하세요.

화면에서 확인구독 그룹 → 추가 → 구독 업데이트 → 서버 선택

다운로드 / 기기별 선택

운영체제별 다운로드 경로

먼저 기기의 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드 페이지에서 맞는 설치 파일을 선택하세요. 데스크톱에서는 v2rayN을 주로 사용하며, Android에는 서로 다른 코어를 사용하는 그래픽 클라이언트가 제공됩니다.

전체 클라이언트 보기

Windows

v2rayN을 사용하세요. 다운로드 페이지에서 크로스 플랫폼 UI를 사용하는 데스크톱 버전과 기존 WPF 버전을 제공합니다. 익숙한 인터페이스를 선택한 다음 설치 및 실행 안내를 확인하세요.

구독을 가져온 뒤 선택된 서버, 시스템 프록시 상태, 라우팅 모드를 확인하세요. 브라우저에서는 접속되지만 다른 앱에서는 안 될 경우 서버 항목을 바로 수정하기보다 해당 앱이 시스템 프록시를 사용하는지 먼저 살펴보세요.

다운로드 페이지로 이동

macOS

v2rayN을 사용하세요. 기기의 칩에 맞춰 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 칩 종류를 모른다면 시스템의 ‘이 Mac에 관하여’에서 확인한 뒤 다운로드 페이지의 아키텍처 표시와 비교하면 됩니다.

처음 실행한 뒤 서버를 가져오고 연결을 테스트한 다음 시스템 프록시를 설정하세요. 설치 파일의 아키텍처, 서버 프로토콜, 코어 유형은 서로 다른 항목입니다. 각각 기기, 설정, 프로토콜 처리 방식에 해당합니다.

다운로드 페이지로 이동

Android

먼저 Xray 코어를 사용하는 v2rayNG를 확인하고, V2Fly 코어를 사용해야 한다면 v2flyNG를 살펴보세요. 두 앱 모두 그래픽 클라이언트이며 구독과 서버 정보는 실제로 제공된 설정을 기준으로 해야 합니다.

다운로드 페이지에서 arm64와 범용 설치 파일을 구분해 제공합니다. 가져온 뒤 서버를 선택하고 연결을 시작하세요. 구독 목록을 업데이트했는데도 이전 항목을 사용하고 있다면 앱을 다시 설치하지 말고 현재 선택된 항목을 확인하세요.

다운로드 페이지로 이동

Linux

v2rayN을 사용하세요. 먼저 배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 다음 프로세서 아키텍처를 확인하세요. 다운로드 페이지에서 일반 데스크톱 기기와 arm64 기기에 맞는 다운로드 경로를 제공합니다.

설치가 끝나면 그래픽 인터페이스에서 구독이나 서버 설정을 가져오세요. 클라이언트에 연결됨으로 표시되는데 앱이 예상대로 접속하지 못한다면 데스크톱 환경의 프록시 설정, 클라이언트 라우팅, DNS를 각각 확인하세요. 하나씩 조정하면 문제를 찾기 쉽습니다.

다운로드 페이지로 이동

Project V / 코어와 클라이언트

그래픽 인터페이스와 코어는 서로 다른 역할을 합니다

Project V, V2Fly, Xray의 관계를 이해하면 프로토콜 매개변수나 호환성 문제가 생겼을 때 클라이언트 화면을 확인할지, 연결을 처리하는 코어를 살펴볼지 판단할 수 있습니다.

Project V: 생태계의 출발점

Project V는 V2Ray 관련 프로토콜과 설정 방식의 기반을 마련했습니다. 이후 커뮤니티는 코어, 그래픽 클라이언트, 문서를 각각 관리해 왔습니다. 일상적으로 말하는 ‘V2Ray 클라이언트’는 서버 목록과 프록시 스위치가 있는 그래픽 앱을 가리키기도 하고, 앱이 호출하는 코어를 통칭하기도 합니다. 문제를 진단할 때 이 두 계층을 구분하면 더 정확하게 파악할 수 있습니다.

예를 들어 서버 편집 창에서는 주소, 포트, 사용자 ID, 전송 프로토콜 등의 항목을 입력합니다. 확인을 누르면 설정이 저장되고, 실제 연결을 만들 때는 코어가 이 매개변수를 읽습니다. 화면에 설정 항목이 보인다는 사실만으로 현재 코어가 해당 기능을 지원한다고 판단할 수는 없습니다.

V2Fly와 Xray: 각자의 발전 방향

V2Fly는 V2Ray의 커뮤니티 관리 노선을 이어가고 있으며, Xray는 이 생태계에서 분기해 독립적으로 발전했습니다. 두 프로젝트는 일부 개념과 설정 방식을 공유하지만 지원하는 전송 기능, 항목의 해석, 업데이트 주기는 다를 수 있습니다. VLESS, 흐름 제어, REALITY 매개변수가 포함된 서버 정보를 받았다면 실제 요구사항을 파악한 뒤 클라이언트에서 선택한 코어와 비교하세요.

코어 변경은 모든 연결 문제에 통하는 해결책이 아닙니다. 주소나 포트를 잘못 입력했거나 구독 주소에 접속할 수 없거나 시스템 프록시가 켜져 있지 않은 경우에는 코어를 바꿔도 해결되지 않습니다. 가져오기, 실행, DNS 해석, 앱의 트래픽 전달 중 어느 단계에서 오류가 발생하는지 먼저 확인한 뒤 코어 호환성을 살펴보세요.

세 가지 클라이언트: 기기와 설정에 맞춰 선택

v2rayN은 Windows, macOS, Linux용 데스크톱 그래픽 클라이언트로 서버 관리, 구독 업데이트, 라우팅, 시스템 프록시 및 관련 코어 설정을 한곳에서 제공합니다. Android용 v2rayNG는 Xray 코어를 사용하며 v2flyNG는 V2Fly 코어를 사용합니다. 세 앱 모두 커뮤니티가 관리하는 오픈 소스 그래픽 클라이언트지만 인터페이스 구성과 제공 기능은 앱마다 다릅니다.

기기를 바꿀 때는 이전 기기의 스위치 상태를 그대로 따라 하기보다 구독 주소나 서버 설정부터 확인하세요. 데스크톱의 시스템 프록시와 모바일 기기의 연결 권한은 운영체제마다 방식이 다릅니다. 같은 서버 설정을 사용할 수 있더라도 연결을 시작하는 단계는 각 앱의 화면에 맞춰 진행해야 합니다.

오픈 소스 유지 관리: 실제 변경 사항 확인

코어와 클라이언트는 각각의 커뮤니티에서 지속적으로 관리합니다. 오픈 소스는 구현과 변경 사항을 공개적으로 논의할 수 있다는 뜻이며, 그래픽 인터페이스와 코어, 설치 파일의 출시 일정이 서로 다를 수도 있습니다. 안내서에서 본 항목 위치가 현재 화면과 다르다면 필드 이름으로 해당 설정을 찾고 클라이언트의 코어 정보를 확인하세요. 스크린샷만 보고 기능이 삭제됐다고 판단하지 마세요.

앱을 업데이트하기 전에 사용 중인 구독 그룹, 라우팅 모드, DNS 설정을 기록해 두세요. 업데이트 후 동작이 달라졌다면 ‘서버 선택 여부 → 코어 실행 여부 → 시스템 프록시 또는 TUN 작동 여부 → 라우팅 및 DNS 결과’ 순서로 확인하세요. 설정 변경과 소프트웨어 업데이트로 인한 차이를 구분하는 데 도움이 됩니다.

증상별 자주 묻는 질문

  • 구독을 업데이트했는데 새 서버가 보이지 않나요? 먼저 업데이트한 그룹과 목록의 키워드 필터를 확인하세요. 그런 다음 구독 관련 질문과 답변을 살펴보세요.
  • 클라이언트는 연결됐는데 브라우저에서 웹페이지가 열리지 않나요? 시스템 프록시 상태를 확인한 뒤 라우팅과 DNS를 살펴보세요. 문제 진단 안내에 따라 단계별로 점검할 수 있습니다.
  • 처음 사용해서 어떤 순서로 설정할지 모르겠나요? 설정 가져오기, 서버 선택, 연결 확인 순서로 빠른 시작 안내를 따라 진행하세요.
  • 어떤 Android 클라이언트를 선택할지 모르겠나요? 설정에 필요한 코어 기능을 먼저 확인하고 클라이언트 비교를 참고하세요. 이름이 비슷하다는 이유만으로 판단하지 마세요.

노트 / 기술 메모

설정의 원리 더 알아보기

아래 세 글에서는 DNS, 구독 정리, 코어 차이를 살펴봅니다. 고급 설정을 변경해야 한다면 적용 조건을 먼저 확인한 다음 클라이언트에서 항목별로 설정하세요.

전체 글 보기
고급 설정 · 2026-09-24

V2Ray DNS 라우팅 설정 가이드: 도메인별 DNS 해석과 DNS 오염 대응

DNS 업스트림, 도메인 규칙, 라우팅이 적용되는 순서를 단계별로 살펴봅니다. DNS 해석 결과가 어디서 비롯되는지 확인하려는 사용자에게 적합합니다.

글 읽기 → 구독 관리 · 2026-09-09

v2rayN 여러 구독 그룹 관리: 제공업체별 분류, 키워드 필터링, 서버 일괄 정리

그룹 만들기부터 필터링, 정렬, 정리까지 여러 서버 목록을 관리하는 일상적인 절차를 알아봅니다.

글 읽기 → 고급 설정 · 2026-08-22

V2Ray FakeDNS 원리: 가상 IP 할당, 트래픽 스니핑 연동, 활용 환경

가상 주소로 도메인 정보를 유지하는 방식과 TUN 설정에서 FakeDNS를 사용할 때를 설명합니다.

글 읽기 →