오픈 소스 클라이언트 · 설정 가이드

V2Ray for Windows v2rayN 다운로드 및 설정 가이드

구독 가져오기부터 라우팅 분기까지 실제 설정 항목을 따라 연결한 다음, 프록시 적용 여부를 확인해 트래픽 경로를 점검하세요.

  • 구독 관리
  • 시스템 프록시
  • TUN 모드

설정 목차 / 시작부터 트래픽 경로까지

v2rayN 설정 목차

먼저 노드 하나로 연결한 뒤 라우팅 분기와 트래픽 가로채기 기능을 하나씩 추가하세요. 아래 예시는 설정 항목과 코어 설정의 관계를 설명하기 위한 것으로, 전체 설정을 그대로 대체할 수 없습니다. 코어마다 사용하는 필드가 다르므로 서로 섞어 쓰지 마세요. 클라이언트 업데이트에 따라 화면의 항목 이름이 조금 달라질 수 있습니다.

구독 그룹 › 구독 그룹 설정 › 추가

구독 주소와 노드 목록을 따로 관리

‘구독 그룹 설정’에서 이름과 구독 주소를 입력하고 저장한 다음, ‘구독 그룹’에서 업데이트하세요. 우선 프록시 없이 업데이트해 보고, 해당 주소에 접속할 때 실제로 프록시가 필요한 경우에만 업데이트 방식을 바꾸세요. 구독 관리는 링크를 하나씩 가져오는 것보다 여러 항목을 관리하기 편리합니다. 다만 업데이트 성공은 내용을 가져왔다는 뜻일 뿐, 모든 노드에 연결할 수 있다는 의미는 아닙니다. 가져온 후 노드 하나를 선택해 활성 서버로 지정하고 실제 연결을 테스트하세요. 구독 주소에는 보통 접속 정보가 포함되므로 공개 스크린샷에 노출하거나 출처가 불분명한 변환 사이트에 입력하지 마세요.

{
  "outbounds": [
    { "tag": "proxy", "protocol": "vmess" }
  ]
}

예시는 Xray 아웃바운드 구조만 보여줍니다. 서버 주소, 사용자 정보, 전송 매개변수는 가져온 구독 내용으로 생성됩니다.

구독 가져오기 단계 보기 →

첫 설정 시 확인 순서

기존 설정을 먼저 저장한 다음 구독을 가져오고, 활성 서버를 선택해 실제 연결을 테스트한 뒤 시스템 프록시를 켜세요. 각 단계가 끝날 때마다 결과를 확인하면 구독 다운로드 실패, 노드 연결 실패, 브라우저가 프록시를 사용하지 않는 문제를 혼동하지 않을 수 있습니다. 이미 여러 설정을 바꿨다면 다른 프록시 도구를 종료하고 TUN을 끈 뒤, 노드 하나와 시스템 프록시만 사용하는 최소 테스트 환경으로 돌아가세요.

실제 연결 테스트는 노드를 통해 테스트 대상에 접속을 시도합니다. Tcping은 주로 서버 포트에 연결할 수 있는지를 확인합니다. 두 테스트는 대상이 다르므로 포트에 연결된다고 프로토콜 핸드셰이크까지 성공한 것은 아닙니다. 반대로 테스트 대상에 일시적으로 접속할 수 없어도 노드가 완전히 작동하지 않는다고 단정할 수 없습니다. 결과를 비교할 때는 네트워크, 대상, 테스트 방식을 동일하게 유지하세요. 그런 다음 실제로 사용하려는 사이트에 접속해 확인하고, 단일 수치만으로 전체 성능을 판단하지 마세요.

전체 가이드에 따라 첫 연결 설정하기 →

클라이언트 선택 / 운영체제 및 프로세서

4개 플랫폼 클라이언트 다운로드

데스크톱에서는 v2rayN을 사용하고 Android 기기에서는 v2rayNG를 우선 고려하세요. V2Fly 코어가 필요하다면 v2flyNG를 선택할 수 있습니다. 다운로드 페이지에서 운영체제와 프로세서별 설치 파일을 확인하세요. 클라이언트를 설치해도 유효한 노드 정보가 필요합니다. 설치 파일만으로 사용할 수 있는 서버가 제공되거나 구독이 자동 생성되지는 않습니다.

Windows

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 창 레이아웃을 유지합니다. 다운로드 페이지에 표시된 시스템 요구 사항을 확인해 선택하고, 인터페이스 차이를 노드 성능 차이로 오해하지 마세요.

설치하기 전에 실행 중인 이전 버전을 종료해 두 인스턴스가 로컬 수신 포트를 놓고 충돌하지 않도록 하세요. 설정을 이전해야 한다면 구독 그룹과 라우팅 설정을 먼저 백업하고, 작동하는 설정을 하나 남겨 새 환경에서 확인하세요. TUN 권한 문제는 일반 시스템 프록시 연결이 성공한 뒤 별도로 해결하는 것이 좋습니다.

다운로드 페이지로 이동 Windows 클라이언트

macOS

v2rayN은 Apple Silicon과 Intel용 다운로드를 제공합니다. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인한 뒤 알맞은 설치 파일을 선택하세요. 컴퓨터 외관이나 구매 연도로 아키텍처를 추측하지 마세요.

처음 실행할 때는 시스템 보안 안내를 확인하고 앱 출처와 필요한 권한을 승인하세요. 먼저 브라우저에서 연결을 확인한 다음 시스템 프록시 설정을 점검하세요. TUN을 사용하려면 네트워크 권한과 다른 네트워크 확장도 별도로 확인해야 합니다. Wi-Fi를 바꾼 뒤 연결에 문제가 생기면 기본 네트워크 경로를 다시 점검하세요.

다운로드 페이지로 이동 macOS 클라이언트

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요하면 v2flyNG를 고려하세요. 대부분의 최신 기기는 arm64를 선택하면 됩니다. 아키텍처를 확인할 수 없거나 설치 호환성 문제가 발생하면 다운로드 페이지의 범용 버전 안내를 확인하세요.

노드를 가져온 뒤 시스템의 VPN 연결 요청을 승인해야 합니다. 일반적으로 시스템은 이러한 연결을 하나만 활성 상태로 유지하므로 다른 네트워크 가로채기 앱을 켜면 현재 연결이 끊길 수 있습니다. 앱을 화면에 띄워 두었을 때는 정상인데 화면을 잠그면 연결이 끊긴다면 노드보다 배터리 최적화와 백그라운드 실행 제한을 먼저 확인하세요.

다운로드 페이지로 이동 Android 클라이언트

Linux

v2rayN은 deb 및 rpm 설치 파일을 제공하며 x64와 arm64로 구분됩니다. 먼저 배포판의 패키지 관리 방식을 확인하고 프로세서 아키텍처를 점검하세요. 패키지 형식과 아키텍처는 서로 별개의 조건입니다.

그래픽 데스크톱의 시스템 프록시 설정이 터미널 프로그램에 적용되지 않을 수 있습니다. 브라우저 연결에 성공했더라도 대상 앱이 데스크톱 프록시 설정을 읽는지, 별도의 프록시 진입점이 설정되어 있는지 확인하세요. TUN은 네트워크 권한과 라우팅에도 영향을 줍니다. 원격으로 관리하는 환경이라면 먼저 기존 네트워크 설정을 복원할 방법을 준비하세요.

다운로드 페이지로 이동 Linux 클라이언트

설치 파일 선택 및 설정 이전

하나의 구독에 여러 프로토콜이 포함될 수 있지만 클라이언트와 코어가 모든 프로토콜을 지원하는 것은 아닙니다. 설치 후 일부 노드를 가져올 수 없다면 오류에 표시된 프로토콜이나 전송 필드를 확인한 뒤 클라이언트 또는 코어를 변경해야 하는지 판단하세요. 노드 하나의 문제를 해결하려고 시스템 전체를 반복해서 재설치하거나, 백업하지 않은 라우팅 설정을 덮어쓰지 마세요.

설정을 이전할 때는 필요한 데이터만 보존하세요. 구독 주소, 노드 링크, 내보낸 설정 파일에는 계정 정보가 포함될 수 있으므로 로그를 공유하기 전에 해당 내용을 삭제하세요. 홈에서는 클라이언트 선택과 설정 흐름을 안내하고, 구체적인 설치 파일과 업데이트 정보는 다운로드 페이지에서 확인할 수 있습니다.

모든 클라이언트 보기 →

오픈 소스 생태계 / 클라이언트와 코어의 차이

Project V, V2Fly, Xray

그래픽 인터페이스
v2rayN / v2rayNG / v2flyNG

연결 코어
Xray / V2Fly

설정 항목
인바운드 / 아웃바운드 / 라우팅 / DNS

Project V는 생태계의 배경이지 단일 설치 파일이 아닙니다

V2Ray는 Project V의 모듈형 네트워크 도구 생태계에서 시작했습니다. 일상적인 검색에서 ‘V2Ray 클라이언트’는 그래픽 인터페이스와 연결 코어를 모두 가리키는 경우가 많지만, 실제로는 두 계층을 구분해야 합니다. 그래픽 인터페이스는 구독을 저장하고 노드를 관리해 설정을 생성하며, 코어는 설정을 읽어 인바운드, 라우팅, 아웃바운드를 처리합니다. 브라우저 접속 여부는 운영체제와 앱이 요청을 해당 진입점으로 보내는지에 따라서도 달라집니다.

이러한 계층 구조 때문에 메인 창과 구독 목록은 정상적으로 표시되더라도 포트 충돌이나 설정 오류로 코어가 시작되지 않을 수 있습니다. 따라서 ‘프로그램이 열림’만으로 ‘프록시가 적용됨’을 확인할 수는 없습니다. 먼저 코어 로그를 확인하고 로컬 수신과 시스템 프록시를 점검한 뒤 사이트 접속 결과를 확인하세요. 같은 작업을 반복하며 재설치하는 일을 줄일 수 있습니다.

V2Fly와 Xray는 같은 뿌리에서 출발했지만 설정은 점차 달라졌습니다

V2Fly는 V2Ray의 커뮤니티 유지 관리 흐름을 이어가고, Xray는 V2Ray에서 파생된 별도의 코어로 발전했습니다. 두 프로젝트는 공통 기술 기반을 공유하지만 프로토콜 지원, 전송 기능, 설정 세부 항목은 각기 발전해 왔습니다. 공통 개념을 이해하면 설정을 읽는 데 도움이 되지만 새 필드를 모두 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 프로토콜 기능, 트래픽 탐지, DNS 동작이 다를 때는 현재 실제로 실행 중인 코어를 기준으로 판단하세요.

v2rayN의 다중 코어 관리 기능을 사용하면 다양한 설정을 그래픽 인터페이스에서 관리할 수 있지만, 사용할 수 있는 조합은 클라이언트 구현과 코어 지원 범위에 따라 달라집니다. 코어를 선택할 때는 노드가 요구하는 프로토콜과 전송 매개변수를 우선 확인한 다음 기존 라우팅 규칙과의 호환성을 살펴보세요. 연결이 정상 작동하다가 코어를 바꾼 뒤 실패한다면 서버가 작동하지 않는다고 단정하기 전에 설정 호환성을 확인하세요.

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

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. v2rayN과 v2rayNG는 GPL-3.0 라이선스를 사용하고 v2flyNG도 GPL-3.0 라이선스를 사용합니다. V2Fly와 Xray 코어는 MPL-2.0 라이선스를 사용합니다. 클라이언트와 코어는 별개의 프로젝트이므로 라이선스 적용 범위를 각각 확인해야 합니다. 오픈 소스란 코드와 관련 라이선스 조건을 검토할 수 있다는 뜻이지, 출처가 불분명한 재패키징 버전도 동일한 수준으로 관리된다는 의미는 아닙니다.

데스크톱 버전은 구독 관리, 시스템 프록시, 다중 코어 설정이 중심이며 Android 버전은 시스템 VPN 인터페이스와 백그라운드 실행 정책도 고려해야 합니다. v2rayNG는 Xray 코어 설정을 대상으로 하고 v2flyNG는 V2Fly 코어를 사용합니다. 클라이언트 이름을 속도 순위처럼 여기지 말고 기기, 프로토콜, 기존 설정을 기준으로 선택하세요. 같은 클라이언트도 노드와 네트워크에 따라 성능이 달라집니다.

인터페이스, 코어, 규칙 데이터 업데이트는 각각 따로 확인하세요

클라이언트 업데이트, 코어 업데이트, 라우팅 분류 데이터 업데이트는 서로 다른 문제를 해결합니다. 인터페이스 업데이트는 설정 메뉴 위치를 바꿀 수 있고, 코어 업데이트는 프로토콜 동작에 영향을 줄 수 있으며, 분류 데이터 업데이트는 도메인이나 주소의 규칙 일치 결과를 바꿀 수 있습니다. 업데이트 전에 현재 활성 서버, 시스템 프록시 상태, 라우팅 프리셋을 기록하고 필요한 설정을 저장하세요. 업데이트 후에는 새 기능을 사용하기 전에 기존 연결부터 확인하세요.

한 번의 문제 해결 과정에서 구독, 코어, DNS, 전체 라우팅 설정을 동시에 바꾸지 않는 것이 좋습니다. 작동하는 기준 상태를 유지하고 설정을 한 종류씩 변경해야 결과를 비교할 수 있습니다. 업데이트 후 일부 도메인에만 문제가 생긴다면 규칙 적용 결과와 DNS를 확인하세요. 코어가 시작되지 않으면 로그의 필드 오류와 포트 충돌을 점검하세요. 문제가 계속되면 문제 진단 페이지에서 증상별 항목을 차례로 확인할 수 있습니다.

v2rayN 문제 진단 보기 →

설정 가이드 / 최신 글

DNS 설정 및 연결 문제 해결

먼저 ‘노드 연결이 되지 않는 문제’와 ‘연결은 됐지만 요청이 잘못된 경로로 전송되는 문제’를 구분하세요. 최신 가이드 세 편에서는 DNS 누출, DNS 분기, 웹페이지 접속 실패를 다룹니다. 로그와 시스템 프록시, 라우팅 결과를 차례로 확인해 클라이언트 상태 표시만 보고 결론을 내리지 않도록 하세요.

전체 글 보기 →