클라이언트 설치 구독 설정 라우팅 분기

V2Ray 공식 사이트: v2rayN·v2rayNG 클라이언트 및 설정 가이드

v2rayN 다운로드 가이드 보기

플랫폼 선택부터 일상적인 유지 관리까지 4개 플랫폼 설치 경로, 구독 가져오기 절차, 라우팅 분기 방법을 한곳에 정리했습니다. 기기에 맞는 클라이언트를 선택한 뒤 가이드에 따라 연결, 모드 설정, 업데이트를 진행하세요.

영구 무료 오픈 소스 Xray 및 V2Fly 코어 생태계 한국어 문서
핵심 기능

구독·라우팅·멀티플랫폼 클라이언트

그래픽 클라이언트는 코어 설정을 관리하기 쉬운 구독, 그룹, 라우팅 및 시스템 프록시 옵션으로 바꿔 보여 줍니다. 각 계층의 역할을 이해하면 버튼을 반복해서 전환하지 않아도 안정적인 설정을 유지하기 쉽습니다.

01 · 구독 관리

여러 구독 그룹과 노드 필터

구독 링크는 서버 설정을 일괄 전달하고, 클라이언트는 이를 업데이트·분류·선택합니다. v2rayN과 v2rayNG에서는 구독 소스마다 별도 메모를 지정할 수 있어 일상용, 업무용, 임시 설정을 나누어 관리하기 좋습니다. 업데이트 전에 현재 그룹을 확인하고, 업데이트 후에는 키워드 필터와 정렬 조건을 점검하면 “새 설정은 가져왔지만 목록에 보이지 않는다”는 오해를 줄일 수 있습니다. 구독은 설정의 출처일 뿐이므로 클라이언트의 라우팅 규칙, 시스템 프록시, 앱별 설정은 별도로 관리해야 합니다.

일상 구독자동 업데이트
필터 규칙자주 쓰는 태그 유지
정렬 방식이름순
02 · 라우팅 분기

도메인·주소·앱별 출구 선택

라우팅 규칙은 어떤 연결을 프록시로 보낼지, 직접 연결할지, 차단할지를 결정합니다. 규칙은 일반적으로 구체적인 조건에서 일반적인 조건 순서로 적용되므로, 더 정확한 도메인이나 주소 규칙을 앞에 배치해야 합니다. 수정 후 다시 연결해야 새 라우팅이 현재 세션에 적용됩니다. 접속 결과가 예상과 다르면 먼저 일치한 규칙을 확인한 다음 프록시 모드를 점검하여 구독 품질과 라우팅 설정을 혼동하지 않도록 하세요.

{
  "type": "field",
  "domain": ["geosite:cn"],
  "outboundTag": "direct"
}
03 · 플랫폼 지원

데스크톱과 Android에서 같은 설정 원칙 사용

Windows·macOS·Linux에서는 v2rayN을 사용할 수 있고, Android에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 인터페이스마다 메뉴 위치는 조금씩 다르지만 작업 흐름은 같습니다. 구독 가져오기, 설정 선택, 프록시 모드 결정, 연결 후 로그로 문제 확인 순서입니다. 기기를 옮길 때는 구독 소스와 필요한 라우팅만 우선 이전하고 로컬 옵션 전체를 그대로 복사하지 않으면 시스템 권한과 네트워크 인터페이스 차이로 인한 오류를 줄일 수 있습니다.

Windows v2rayN 데스크톱 버전과 클래식 인터페이스 macOS 프로세서 아키텍처에 맞는 설치 패키지 선택 Android v2rayNG 및 v2flyNG Linux 배포판과 아키텍처에 맞게 선택
04 · 코어 생태계

Xray 및 V2Fly 클라이언트 래퍼

그래픽 클라이언트는 인터페이스, 구독, 시스템 프록시, 설정 관리를 담당하고 실제 프로토콜과 전송을 처리하는 것은 하위 코어입니다. v2rayNG는 일반적으로 Xray 코어 기능을 중심으로 하고, v2flyNG는 V2Fly 유지 관리 노선에 대응하며, v2rayN은 데스크톱에서 코어와 설정을 통합 관리하는 진입점을 제공합니다. 클라이언트를 선택할 때 모든 프로토콜 세부 사항을 먼저 외울 필요는 없습니다. 설정 제공자가 요구하는 프로토콜·전송 계층·보안 계층을 현재 코어가 인식할 수 있는지 확인하고 클라이언트와 코어 구성 요소를 함께 최신 상태로 유지하면 됩니다.

Project V 생태계
Xray
V2Fly
v2rayN v2rayNG v2flyNG
플랫폼별 진입점

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

먼저 기기 플랫폼과 프로세서 아키텍처를 확인한 다음 해당 탭으로 이동하세요. 다운로드 페이지에서 같은 플랫폼의 클라이언트, 인터페이스 버전, 설치 패키지 유형을 함께 안내합니다.

Windows

데스크톱에서는 우선 v2rayN을 선택하세요. 최신 데스크톱 인터페이스는 여러 플랫폼에서 일관된 사용 경험을 원하는 사용자에게 적합하고, 클래식 WPF 인터페이스는 기존 조작 방식에 익숙한 사용자에게 알맞습니다. 설치 전에 시스템 아키텍처를 확인하고 클라이언트를 정상적인 읽기·쓰기 권한이 있는 위치에 두세요.

다운로드로 이동

macOS

macOS에서 v2rayN을 사용할 때는 먼저 프로세서 종류를 확인해야 합니다. Apple Silicon과 Intel 설치 패키지는 서로 바꿔 사용할 수 없으므로 시스템 정보에서 칩 이름을 확인하세요. 처음 실행할 때 시스템 권한 안내가 나타나면 지시에 따라 승인한 뒤 시스템 프록시 또는 TUN을 설정합니다.

다운로드로 이동

Android

Android에서는 Xray 코어를 사용하는 v2rayNG를 선택하거나 설정 요구 사항에 따라 v2flyNG를 사용할 수 있습니다. 최근 출시된 기기 대부분은 arm64 설치 패키지를 먼저 확인하면 되며, 아키텍처가 확실하지 않을 때는 범용 버전을 선택하세요. 처음 연결하려면 시스템 VPN 서비스 권한을 승인해야 합니다.

다운로드로 이동

Linux

Linux 데스크톱에서는 v2rayN을 사용할 수 있으며 배포판에 맞춰 deb 또는 rpm 설치 패키지를 선택합니다. x64와 arm64 아키텍처도 구분해야 합니다. 설치 후에는 먼저 데스크톱 환경, 시스템 프록시, 필요한 네트워크 권한을 확인한 다음 구독을 가져오면 권한이나 인터페이스 문제를 쉽게 찾을 수 있습니다.

다운로드로 이동
전체 클라이언트 보기 →
빠른 시작

설치부터 연결까지 세 단계

처음 설정할 때 모든 고급 옵션을 한꺼번에 조정할 필요는 없습니다. 먼저 기본 연결을 완료한 뒤 라우팅과 TUN을 단계적으로 추가하면 문제 발생 지점도 쉽게 찾을 수 있습니다.

  1. 01

    클라이언트 선택 및 설치

    데스크톱 기기에서는 해당 플랫폼의 v2rayN 다운로드 영역으로 이동하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 설치 패키지는 시스템 아키텍처와 일치해야 합니다. 처음 실행한 뒤에는 서브스크립션, 서버 목록, 시스템 프록시, 로그 메뉴 위치를 먼저 익히고 코어 매개변수 수정은 서두르지 마세요.

  2. 02

    구독 가져오기 및 설정 선택

    구독 관리에서 주소와 메모를 추가하고 업데이트한 뒤 설정이 예상한 그룹에 들어갔는지 확인하세요. 목록이 비어 있으면 구독 주소, 현재 그룹, 필터 키워드 순서로 점검합니다. 설정 하나를 선택한 뒤에는 먼저 기본 전송 매개변수를 유지하여 구독으로 내려온 내용을 수동 편집으로 덮어쓰지 않도록 하세요.

  3. 03

    연결·확인 및 일상 모드 저장

    연결한 뒤 클라이언트 상태와 시스템 프록시가 일치하는지 확인하고 로그를 열어 설정 로드 결과를 살펴보세요. 기본 연결이 정상인 것을 확인한 다음 우회 규칙, 앱별 프록시 또는 TUN을 설정합니다. 한 번에 한 종류의 설정만 변경하고 수정 후 다시 연결하면 문제 해결 과정을 명확하게 유지할 수 있습니다.

전체 가이드 보기 →
생태계 및 유지 관리

Project V·V2Fly·Xray의 관계

클라이언트, 코어, 프로토콜은 서로 다른 계층입니다. 이 세 계층을 나누어 이해하면 소프트웨어를 더 정확히 선택할 수 있고 인터페이스 문제를 프로토콜 문제로 잘못 판단하는 일도 줄어듭니다.

Project V 생태계로 이해하는 클라이언트

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙, 설정 형식을 중심으로 한 오픈 소스 생태계를 구축했습니다. V2Ray는 이 생태계를 통칭하는 이름으로 자주 쓰이지만 실제 사용자가 마주하는 것은 대개 그래픽 클라이언트, 하위 코어, 구독 설정의 세 부분입니다. 그래픽 클라이언트는 인터페이스와 시스템 연동을 관리하고, 코어는 프로토콜을 해석해 연결을 처리하며, 구독 서비스는 가져올 수 있는 설정 묶음을 제공합니다. 세 요소의 업데이트 주기가 서로 다르므로 문제가 생기면 먼저 어느 계층에서 발생했는지 판단해야 합니다.

V2Fly와 Xray는 서로 다른 코어 유지 관리 노선

V2Fly는 Project V 커뮤니티의 유지 관리 방향을 이어가며 성숙한 설정 체계와 프로토콜 지원을 유지합니다. Xray는 유사한 설정 방식을 바탕으로 프로토콜·전송·보안 계층 기능을 계속 확장합니다. 두 제품은 단순한 인터페이스 버전 차이가 아니라 하위 구현과 기능 발전 방향이 다릅니다. 설정에 VMess, VLESS, TLS, REALITY 또는 특정 전송 방식이 포함되어 있다면 현재 클라이언트가 사용하는 코어가 해당 필드를 인식할 수 있는지 먼저 확인하세요.

오픈 소스 라이선스와 커뮤니티 업데이트 방식

v2rayN·v2rayNG·v2flyNG 및 관련 코어는 커뮤니티에서 지속적으로 유지 관리하며 소스 코드와 라이선스 정보를 공개합니다. 개방적인 개발 방식 덕분에 설정 형식, 변경 기록, 문제 논의를 검토할 수 있고 클라이언트도 하위 기능 변화에 맞춰 조정할 수 있습니다. 일반 사용자에게 실용적인 유지 관리 방법은 안정 버전을 확인하고 변경 사항을 읽으며 사용 가능한 설정을 백업하는 것입니다. 대규모 수정 전에는 기존 프록시 모드와 라우팅 선택도 기록해 두세요.

클라이언트 업데이트 시 설정 경계 유지

클라이언트 업그레이드, 코어 업그레이드, 구독 업데이트는 해결하는 문제가 서로 다릅니다. 클라이언트 업그레이드는 주로 인터페이스·시스템 연동·설정 관리를 바꾸고, 코어 업그레이드는 프로토콜 호환성과 실행 동작에 영향을 줄 수 있으며, 구독 업데이트는 서버 설정을 새로 고칩니다. 일상적인 유지 관리에서는 세 업데이트를 나누어 실행하고 각각 완료한 뒤 기본 연결을 테스트하세요. 클라이언트·코어·구독을 동시에 바꾸면 오류 발생 시 원인을 특정하기 어렵습니다.

데스크톱 클라이언트

v2rayN

Windows·macOS·Linux용 그래픽 클라이언트로 구독, 서버, 시스템 프록시, 라우팅, TUN을 한곳에서 관리합니다. 데스크톱에서 여러 설정 그룹을 유지 관리하거나 로그를 통해 연결 문제를 단계별로 확인하려는 사용자에게 적합합니다.

Android · Xray

v2rayNG

Android에서 널리 사용하는 Xray 코어 클라이언트로 구독 관리, 앱별 프록시, 라우팅 설정, 시스템 VPN 서비스 연동을 제공합니다. 모바일에서 안정적으로 실행하려면 시스템 절전 정책, 백그라운드 권한, 제조사별 프로세스 관리 설정도 영향을 줍니다.

Android · V2Fly

v2flyNG

V2Fly 코어 유지 관리 노선을 사용하는 Android 클라이언트로, 인터페이스 조작 방식은 v2rayNG와 비슷합니다. 구독 설정에서 V2Fly 동작을 명확히 요구하거나 두 코어 노선 사이의 호환성을 비교해야 하는 경우에 적합합니다.

자주 묻는 질문

설치와 설정 전에 확인할 네 가지

처음 사용할 때 발생하는 문제는 대부분 플랫폼 선택, 구독 업데이트, 프록시 모드, 시스템 권한에 집중됩니다. 먼저 점검 순서를 정해 두면 반복해서 재설치하는 것보다 효과적으로 해결할 수 있습니다.

v2rayN과 v2rayNG는 어떻게 선택하나요?

Windows·macOS·Linux 데스크톱에서는 v2rayN을 선택하고, Android에서는 일반적으로 v2rayNG를 사용합니다. 설정에서 V2Fly 코어 노선을 명확히 지정했다면 v2flyNG도 확인할 수 있습니다. 클라이언트 이름은 다르지만 구독 가져오기, 설정 선택, 연결, 로그 확인의 기본 흐름은 비슷합니다. 자세한 단계는 빠른 시작 가이드에서 확인하세요.

구독 업데이트는 성공했는데 서버 목록이 왜 바뀌지 않나요?

먼저 현재 구독 그룹을 업데이트했는지 확인한 다음 목록 상단의 필터 키워드, 정렬 방식, 숨김 조건을 점검하세요. 일부 클라이언트는 현재 검색 상태를 유지하므로 새 설정이 저장되었어도 필터링되면 목록이 바뀌지 않은 것처럼 보입니다. 필터를 지우고 그룹에 다시 들어간 뒤 구독 업데이트 시간과 로그 안내를 확인하세요.

시스템 프록시와 TUN 모드는 어떻게 다른가요?

시스템 프록시는 운영체제의 프록시 설정을 따르는 프로그램의 연결을 주로 처리하며 설정이 직관적이어서 처음 연결할 때 적합합니다. TUN은 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 처리하므로 적용 범위가 넓지만 추가 권한이 필요하고 다른 네트워크 소프트웨어와 인터페이스 충돌이 발생할 수 있습니다. 먼저 시스템 프록시를 확인한 뒤 실제 필요에 따라 TUN을 활성화하세요.

연결에 실패하면 구독과 라우팅 중 무엇부터 확인해야 하나요?

먼저 로그에서 설정이 정상적으로 로드되었는지, 현재 설정으로 기본 연결을 만들 수 있는지 확인하세요. 기본 연결이 아직 되지 않았다면 구독 내용, 시간 설정, 프로토콜 필드, 네트워크 권한을 우선 점검합니다. 연결은 정상이지만 특정 도메인이나 앱의 경로가 예상과 다를 때만 라우팅 순서, 프록시 모드, 앱별 설정을 추가로 확인하세요.

가이드 업데이트

최근 설정 및 문제 해결 글

Android 권한 승인, 백그라운드 실행, 여러 구독 관리에 필요한 반복 가능한 절차를 정리했습니다. 각 글은 하나의 문제에 집중하므로 기본 설정을 마친 뒤 필요한 내용만 찾아보기 좋습니다.

플랫폼 가이드

v2rayNG Android 사용 핵심: VpnService 권한, 배터리 절전 예외, 앱별 프록시 설정

처음 연결할 때의 권한 승인, 백그라운드 실행 권한, 앱별 프록시라는 세 가지 핵심 단계를 정리하고 설정별 영향 범위도 설명합니다.

전체 글 읽기
문제 해결

v2rayNG 배터리가 너무 빨리 줄어들 때: 백그라운드 유지와 배터리 최적화 점검법

시스템 백그라운드 제한, 연결 유지, 로그 수준, 실행 시간을 기준으로 정상적인 배터리 사용과 비정상적인 지속 깨우기를 구분합니다.

전체 글 읽기
고급 활용

여러 구독 그룹 관리 실전: 서버 필터 규칙과 노드 선택 방법

여러 구독 소스의 메모 명명, 그룹 경계, 키워드 필터, 정렬 방식을 설명하여 일상적인 목록을 깔끔하게 유지하는 방법을 안내합니다.

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