클라이언트 · 프로토콜 · 설정 참고 자료

V2Ray 리소스 사이트 v2rayN 다운로드

사용 설명서를 참고해 운영체제에 맞는 오픈소스 클라이언트를 선택하고, 구독 가져오기부터 라우팅까지 연결 설정을 단계별로 살펴보세요.

  • 프로토콜 참고 자료
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

클라이언트 다운로드

운영체제에 맞는 설치 파일 선택

전체 클라이언트 보기 →

클라이언트는 설정을 저장하고 구독을 관리하며 프록시 코어를 실행합니다. 클라이언트를 설치한 뒤에도 사용할 서버 설정이 필요합니다. 먼저 기기의 운영체제와 프로세서 아키텍처를 확인하고 해당 플랫폼의 설치 안내를 살펴보세요. 데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG를 먼저 확인하고 V2Fly 코어가 필요하다면 v2flyNG를 고려할 수 있습니다.

Windowsv2rayN 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 기존 레이아웃을 유지합니다. 설정 메뉴 위치가 서로 다를 수 있으니 설치 전에 해당 버전의 안내를 확인하세요. 이전할 때는 구독 주소와 사용자 지정 라우팅을 보관해 두세요. 다운로드 페이지로 이동 → macOSv2rayN Apple Silicon 또는 Intel 프로세서에 맞는 설치 파일을 선택하세요. 칩 정보는 ‘이 Mac에 관하여’에서 확인할 수 있습니다. 처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정하세요. 시스템 프록시가 적용되는지는 브라우저와 앱의 네트워크 설정도 함께 확인해야 합니다. 다운로드 페이지로 이동 → Androidv2rayNG / v2flyNG v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 선택할 수 있는 대안입니다. 대부분의 최신 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 모른다면 범용 패키지 안내를 확인하세요. 처음 연결할 때는 시스템 VPN 권한을 허용하고 다른 네트워크 도구가 연결을 점유하고 있지 않은지 확인하세요. 다운로드 페이지로 이동 → Linuxv2rayN 배포판에 맞춰 deb 또는 rpm을 선택하고 x64와 arm64를 구분하세요. 그래픽 데스크톱의 시스템 프록시 지원 여부는 환경마다 다릅니다. 앱이 데스크톱 프록시 설정을 사용하지 않는다면 서버 설정을 계속 바꾸기보다 앱 안에 로컬 프록시 주소를 입력해 보세요. 다운로드 페이지로 이동 →

설정 가이드

v2rayN 자주 쓰는 설정

사용 설명서 보기 →

구독부터 로컬 포트까지 다섯 가지 설정은 각각 다른 단계에 영향을 줍니다. 구독은 사용할 서버 목록을 정하고, 시스템 프록시는 앱이 연결되는 방식을 결정하며, 라우팅은 연결된 트래픽을 어디로 보낼지 정합니다. 문제를 진단할 때는 원래 값을 기록해 두고 한 번에 한 종류의 설정만 바꾸세요. 그래야 설정, 진입 경로, 아웃바운드 중 어디에서 문제가 생겼는지 구분할 수 있습니다.

구독 그룹을 사용하면 출처가 다른 설정을 나누어 관리할 수 있습니다. ‘구독 그룹 설정’에서 그룹을 추가하고 주소를 입력해 저장한 다음 구독을 업데이트해야 서버 목록이 기기에 반영됩니다. 구독 주소와 개별 노드 링크는 용도가 다르므로 링크 길이만으로 유형을 판단할 수 없습니다. 업데이트에 실패하면 먼저 주소가 온전한지, 만료되지는 않았는지 확인하고 요청에 사용된 연결 방식도 살펴보세요. 노드를 하나씩 직접 추가하는 방식보다 그룹 업데이트가 서버 변경 사항을 반영하기 편하지만, 사용자 지정 메모와 필터 결과는 업데이트 후 다시 확인해야 합니다.

↗

구독 그룹 설정

그룹 관리
추가 / 수정
구독 주소
제공업체 주소 입력
업데이트 작업
현재 그룹 구독 업데이트
업데이트 후 확인
서버 및 프로토콜 항목

작업 순서

설치부터 연결 확인까지 3단계

전체 가이드 보기 →

처음 설정할 때는 확인 가능한 연결부터 만든 다음 라우팅과 자동 업데이트를 단계적으로 추가하세요. 프록시 클라이언트를 여러 개 동시에 실행하지 말고, ‘가져오기 성공’, ‘코어 실행 성공’, ‘대상 페이지 접속 가능’을 같은 결과로 보지 마세요. 각각 설정 해석, 로컬 서비스, 실제 연결을 확인하는 단계입니다.

  1. 01

    설치 및 환경 확인

    다운로드 페이지에서 운영체제에 맞는 설치 파일을 선택하세요. 설치 후 설정 화면을 열어 로컬 리스닝 주소와 포트를 확인합니다. 데스크톱에서는 다른 프록시 도구가 실행 중인지 살펴보고, 안드로이드에서는 다른 앱이 VPN 연결을 사용 중인지 확인하세요. 우선 기본 라우팅을 유지하고 현재 시스템 프록시 상태를 기록해 두면 테스트가 끝난 뒤 복원하기 쉽습니다.

    프로그램이 시작되지 않으면 구독부터 수정하지 말고 시스템 요구 사항, 실행 환경, 권한 안내를 차례로 확인하세요. 인터페이스가 열려도 코어가 정상 실행된다는 뜻은 아닙니다. 필요한 경우 로그에서 설정 해석 또는 포트 바인딩 오류를 확인하세요. 설치 디렉터리와 설정 디렉터리가 다를 수도 있으므로 설정을 옮기기 전에 실제 저장 위치를 확인해야 합니다.

  2. 02

    구독 가져오기 및 설정 선택

    구독 그룹에 출처를 추가하고 전체 주소를 붙여 넣은 뒤 업데이트하세요. 개별 공유 링크를 받은 경우에는 해당 링크를 클립보드에서 가져오는 기능을 사용합니다. 목록에 항목이 나타나면 프로토콜 유형, 서버 주소, 포트, 보안 계층이 모두 있는지 확인하고 사용할 설정을 선택하세요. 구독 주소에 접속 정보가 포함될 수 있으므로 공개 화면 캡처에 노출하지 않는 것이 좋습니다.

    v2rayNG는 데스크톱 버전과 구독 그룹 및 업데이트 메뉴의 배치가 다르지만, 먼저 출처를 저장한 뒤 내용을 업데이트해야 합니다. 목록이 비어 있다면 반환된 형식이 클라이언트에서 지원되는 구독 형식인지 확인하세요. 가져오기는 성공했지만 연결되지 않는다면 노드 항목과 코어 지원 여부를 살펴보세요. 업데이트 버튼을 반복해서 누르는 것만으로는 항목 호환성 문제가 해결되지 않습니다.

  3. 03

    앱 연결 및 트래픽 확인

    데스크톱에서는 로컬 서비스를 실행한 뒤 시스템 프록시를 설정하고, 안드로이드에서는 시스템 권한을 허용한 다음 연결을 시작하세요. 먼저 시스템 프록시를 사용하는 앱으로 테스트 페이지에 접속하고 로그에서 연결 및 라우팅 결과를 확인합니다. 앱에 별도의 프록시 설정이 있다면 시스템 설정을 덮어쓰고 있는지 살펴보세요. 특히 SOCKS와 HTTP 진입점은 임의로 바꿔 쓸 수 없습니다.

    문제가 생기면 로컬 포트, 시스템 프록시, 라우팅, 도메인 이름 확인, 시스템 시간, 서버 상태 순으로 점검하세요. 지연 시간 테스트는 특정 측정 방식에서의 응답만 보여 주며 다운로드 속도나 모든 사이트의 접속 가능성을 뜻하지 않습니다. 연결을 확인한 다음 사용자 지정 규칙을 활성화하고, 설정을 바꿀 때마다 같은 테스트를 반복해 결과를 비교할 수 있도록 기록하세요.

오픈소스 생태계

Project V, V2Fly 및 Xray

프로토콜 매뉴얼 읽기 →

PROJECT V / CORE / CLIENT

인터페이스·코어·프로토콜의 역할

생태계 배경
Project V · V2Ray
코어 계열
V2Fly · Xray
데스크톱 클라이언트
v2rayN
안드로이드 클라이언트
v2rayNG · v2flyNG

기기와 사용 방식에 따라 클라이언트를 고르고, 설정 호환성에 따라 코어를 선택하세요. 프로토콜은 서버가 실제로 제공하는 연결 매개변수를 기준으로 확인해야 합니다.

코어 및 클라이언트 용어 보기 →

Project V와 V2Ray의 관계

Project V는 V2Ray의 기술적 배경을 이해하는 출발점입니다. V2Ray는 로컬 인바운드, 원격 아웃바운드, 라우팅, 도메인 이름 확인을 조합 가능한 설정으로 구성합니다. 따라서 특정 그래픽 인터페이스와 같은 뜻도 아니고 하나의 프로토콜만 가리키는 것도 아닙니다. 일상적으로 말하는 ‘V2Ray 설치’는 이러한 설정을 관리하는 클라이언트를 설치한다는 뜻인 경우가 많습니다. 인터페이스, 코어, 프로토콜의 이름을 구분하면 같은 공유 링크를 여러 클라이언트에서 가져올 수 있어도 특정 코어에서는 실행에 실패하는 이유를 이해하기 쉽습니다.

이러한 계층 구조는 문제 해결 방식에도 영향을 줍니다. 인터페이스에 노드가 표시되는 것은 일부 정보를 인식했다는 뜻일 뿐입니다. 실제 연결을 만들 때는 코어가 해당 프로토콜, 전송 방식, 보안 계층을 처리해야 합니다. 가이드를 읽을 때는 설명하는 내용이 인터페이스 조작인지 코어 동작인지 먼저 구분하세요. 사이트의 사용 설명서는 조작 경로를, 프로토콜 매뉴얼은 호환성과 설계상의 차이를 다룹니다. 용어집은 설정 항목의 의미를 확인하는 데 도움이 되므로 실제 문제에 따라 함께 참고하세요.

V2Fly와 Xray 계열의 차이

V2Fly는 V2Ray 커뮤니티의 유지 관리 체계를 이어가고 있으며, Xray는 관련 기술을 바탕으로 발전한 별도의 코어 계열입니다. 공통된 개념과 프로토콜 지원이 일부 있지만 기능 발전 방향, 설정 항목, 기본 동작이 완전히 같지는 않습니다. 특히 REALITY, XTLS Vision 같은 설정은 Xray의 지원 여부를 확인해야 합니다. 코어 프로그램만 교체한다고 기존 설정 항목이 모두 같은 방식으로 작동하는 것은 아닙니다.

코어를 선택할 때는 서버가 제공한 설정을 기준으로 필요한 기능을 파악한 다음, 클라이언트에서 해당 항목을 빠짐없이 설정할 수 있는지 확인하세요. 구독을 가져오는 과정에서 보안 계층이나 전송 매개변수가 누락되면 익숙한 프로토콜 이름이 표시되어도 연결에 실패할 수 있습니다. 일반 사용자라면 코어를 자주 바꾸기보다 이미 작동을 확인한 설정을 보관하는 편이 문제를 찾기 쉽습니다. 비교가 필요할 때는 서버, 대상 사이트, 테스트 방식을 동일하게 유지하고 코어별 시작 로그와 접속 결과를 확인하세요.

세 클라이언트의 오픈소스 라이선스

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 그래픽 클라이언트입니다. v2rayN은 데스크톱용으로 서버 목록, 구독 그룹, 프록시 설정을 관리합니다. v2rayNG는 안드로이드 기기용이며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어를 기반으로 한 안드로이드 클라이언트입니다. 이들 앱은 설정을 관리하기 쉬운 인터페이스를 제공하지만 서버 서비스 자체는 아니며, 설치만으로 사용할 수 있는 구독이 생기지도 않습니다.

오픈소스란 해당 라이선스에 따라 코드를 열람하고 사용하거나 재배포할 수 있다는 뜻이지, 모든 설정이 모든 기기에 적합하다는 뜻은 아닙니다. V2Fly-core의 주된 라이선스는 MIT이고 Xray-core의 주된 라이선스는 MPL-2.0입니다. 클라이언트와 종속성에도 각각 적용되는 라이선스 조건이 있습니다. 일반 사용자는 출처, 유지 관리 안내, 실제 기능을 확인하면 됩니다. 코드를 수정하거나 재배포하려면 생태계 전체를 하나의 라이선스로 묶어 판단하지 말고 해당 프로젝트와 종속성의 라이선스 원문을 확인하세요.

업데이트 방식 및 호환성 확인

클라이언트, 코어, 구독, 라우팅 규칙 세트는 각각 별개의 업데이트 대상입니다. 클라이언트를 업데이트하면 메뉴 위치나 설정 생성 방식이 달라질 수 있고, 코어 업데이트는 프로토콜 기능이나 설정 항목 지원에 영향을 줄 수 있습니다. 구독 업데이트는 서버 매개변수를 동기화하고 규칙 세트 업데이트는 도메인 및 주소의 일치 결과를 바꿀 수 있습니다. 따라서 ‘업데이트했다’는 설명만으로는 문제를 진단하기 어렵습니다. 어떤 항목을 업데이트했는지, 전후에 설정이 어떻게 달라졌는지 기록하세요.

정기적으로 관리할 때는 구독 출처, 사용자 지정 라우팅, 로컬 리스닝 설정을 먼저 저장한 다음 업데이트 안내를 읽고 항목별로 테스트하세요. 홈페이지에서는 주요 메뉴와 설정 관계를 확인하고, 구체적인 설치 정보는 다운로드 페이지에서 살펴보세요. 이렇게 하면 오래된 버전 정보를 실제 작업에 적용하는 일을 줄일 수 있습니다. 업데이트 뒤 일부 앱에서만 문제가 생기면 시스템 프록시와 앱 자체 설정을 먼저 확인하고, 코어가 시작되지 않는다면 설정 해석 정보를 살펴보세요. 각 계층을 나누어 기록하면 무작정 재설치하는 것보다 유효한 단서를 찾기 쉽습니다.

기술 문서

설정 문제 해결 및 프로토콜 선택

전체 글 보기 →

문제가 생기면 먼저 앱 연결, 코어 호환성, 서버 선택 중 어느 부분에 해당하는지 확인하세요. 아래 세 글은 연결 문제 해결, 코어 차이, 노드 평가를 각각 다룹니다. 작업을 시작하기 전에 현재 프록시 모드와 활성 설정을 기록하고, 글을 읽은 뒤에는 한 번에 하나의 가설만 검증하세요. 여러 설정을 동시에 바꾸면 원인을 파악하기 어렵습니다.

v2rayN 다운로드