v2rayN / v2rayNG / v2flyNG 클라이언트

V2Ray 홈클라이언트 다운로드 및 설정

기기에 맞는 오픈소스 클라이언트를 선택하고 구독 가져오기부터 라우팅 규칙 확인까지 차례로 설정하세요.

노드 관리DNS 설정
01 시작 가이드

클라이언트, 구독 및 라우팅

먼저 세 가지 역할을 구분하세요. 클라이언트는 조작 화면이고, 코어는 연결을 처리하며, 구독은 노드 목록을 업데이트하는 방법 중 하나입니다. 클라이언트를 다운로드하는 것만으로 사용할 수 있는 노드가 자동으로 생기지는 않습니다.

처음 설치하기

다운로드 페이지에서 운영체제, 프로세서, 설치 파일 형식을 확인하세요. 기기를 바꾸면 새 기기에 맞는 파일을 다시 선택해야 합니다. 이전 기기의 설치 파일을 그대로 사용하지 마세요.

구독 주소가 있는 경우

구독은 노드 목록을 업데이트하는 주소입니다. 가져온 뒤에는 목록을 업데이트하고 노드를 선택해야 합니다. 공유 링크 하나만 받은 경우에는 단일 노드로 가져오면 되므로 구독 그룹을 만들 필요가 없습니다.

연결 문제

먼저 목록이 업데이트되지 않은 것인지, 코어가 시작되지 않은 것인지, 특정 앱만 열리지 않는 것인지 구분하세요. 문제가 발생한 단계를 기록한 뒤 해당 항목을 확인하면 재설치보다 원인을 찾기 쉽습니다.

02 핵심 설정

라우팅, 구독 및 DNS

문제를 나누어 살펴보세요. 라우팅은 연결 경로를 정하고, 구독은 노드의 출처를 정하며, DNS는 도메인 이름을 어떻게 해석할지 결정합니다.

특정 연결의 경로 지정

아웃바운드는 코어가 연결을 처리할 때 사용하는 출구로, 직접 연결하거나 프록시로 전달할 수 있습니다. 모든 연결을 하나의 출구로 보내는 대신 라우팅 규칙을 사용하면 도메인이나 주소에 따라 경로를 나눌 수 있습니다. 예를 들어 로컬 서비스는 직접 연결하고, 프록시가 필요한 연결은 선택한 노드로 보낼 수 있습니다. 먼저 미리 설정된 규칙으로 기본 구성을 잡고, 필요한 규칙을 하나씩 추가하세요. 저장한 뒤 직접 연결되어야 하는 대상과 프록시를 거쳐야 하는 대상을 각각 열고 로그에서 어떤 규칙이 적용됐는지 확인하세요. 실제 경로가 다르면 구체적인 규칙이 더 포괄적인 규칙보다 뒤에 배치되지 않았는지 먼저 살펴보세요.

설정 항목: 아웃바운드 태그

{ "protocol": "freedom", "tag": "direct" }

직접 연결 아웃바운드 설정의 일부입니다. 라우팅 규칙은 outboundTag에서 같은 이름의 태그를 참조합니다.

03 설치 파일

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

먼저 운영체제를 확인하고 프로세서 아키텍처를 살펴보세요. 패키지 이름의 x64와 arm64는 서로 다른 하드웨어 아키텍처를 뜻합니다. 기능 차이나 버전 차이를 나타내는 것이 아니므로 이름만 보고 임의로 바꿔 사용할 수 없습니다.

Windows

v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 기존 인터페이스를 사용합니다. 처음 설치하기 전에 시스템의 ‘정보’ 페이지에서 시스템 종류를 확인하고 다운로드 페이지의 요구 사항과 대조하세요.

기존 환경에서 옮기는 경우 현재 구독 그룹, 라우팅 모드, 시스템 프록시 상태를 먼저 기록하세요. 두 클라이언트가 동시에 시스템 프록시를 관리하게 하면 어떤 클라이언트가 설정을 변경했는지 파악하기 어렵습니다.

다운로드 페이지로 이동

macOS

‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple 칩에는 arm64 패키지를, Intel 프로세서에는 x64 패키지를 선택하세요. 두 패키지 모두 v2rayN 데스크톱용입니다.

프록시를 처음 사용하기 전에 클라이언트와 코어가 실행되는지 확인하세요. 시스템에서 권한이나 호환성 문제가 표시되면 안내에 따라 설치 요구 사항을 확인하세요. 시작 실패와 노드 연결 실패를 같은 문제로 보고 점검하지 마세요.

다운로드 페이지로 이동

Android

Xray 코어를 사용하는 v2rayNG를 먼저 살펴보세요. V2Fly 생태계에 맞춘 설정이 필요하다면 v2flyNG와 비교해 보세요. 기기가 arm64를 지원하는 것이 확실하면 해당 패키지를 선택하고, 확실하지 않다면 먼저 범용 패키지의 요구 사항을 확인하세요.

두 클라이언트의 설치 파일은 서로 덮어써서 업데이트할 수 없습니다. 전환하기 전에 노드 출처와 앱별 라우팅 범위를 기록하고, 전환 후 자주 쓰는 앱을 다시 테스트하세요. 이전 클라이언트의 설정이 자동으로 이어진다고 가정하지 마세요.

다운로드 페이지로 이동

Linux

먼저 배포판에 맞는 패키지 형식을 고른 다음, 시스템 아키텍처에 맞는 v2rayN 패키지를 선택하세요. Debian 및 Ubuntu 계열 배포판은 보통 deb를, Fedora 계열 배포판은 보통 rpm을 사용합니다.

그래픽 클라이언트와 게이트웨이에서 코어만 별도로 실행하는 방식은 용도가 다릅니다. 데스크톱에 설치한 뒤에는 프록시 설정을 따르는 앱으로 먼저 테스트하세요. 터미널 프로그램과 백그라운드 서비스는 데스크톱 환경의 설정을 따르지 않을 수 있습니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

04 빠른 시작

구독 가져오기부터 연결 확인까지

처음 설정할 때는 확인 가능한 연결 경로 하나만 만드세요. 같은 테스트 대상을 이용해 단계별로 확인하고, 기본 연결이 작동한 뒤 앱별 라우팅이나 사용자 지정 DNS를 추가하세요.

  1. 목록 가져오기 및 업데이트

    클라이언트의 구독 관리에서 새 그룹을 만들고 주소를 추가한 뒤 해당 그룹을 업데이트하세요. 업데이트 전에 그룹 이름을 확인하고, 업데이트가 끝나면 해당 그룹을 다시 선택해 결과를 살펴보세요. 목록이 비어 있다면 선택한 그룹을 먼저 확인한 다음 주소를 복사할 때 공백이나 줄바꿈이 포함됐는지, 구독이 아직 유효한지 점검하세요.

    서비스 제공자가 노드 링크 하나만 제공했다면 공유 링크 가져오기를 이용하세요. 단일 노드 링크를 구독으로 업데이트하면 예상한 목록을 얻지 못할 수 있습니다. 구독 주소에 접속 정보가 포함될 수 있으니, 도움을 요청할 때 오류 내용을 설명하되 전체 주소를 그대로 올리지 마세요.

  2. 노드 선택 및 트래픽 처리 활성화

    가져온 목록에서 필요한 정보가 모두 있는 노드를 골라 현재 노드로 설정하세요. 데스크톱에서는 시스템 프록시를 활성화한 뒤 시스템 프록시를 따르는 앱으로 먼저 테스트할 수 있습니다. 모바일에서는 클라이언트 안내에 따라 시스템 VPN 연결을 설정하세요. 코어가 실행되는 것과 프록시가 트래픽을 처리하는 것은 별개입니다. 코어가 정상적으로 시작돼도 테스트 중인 앱이 이를 사용한다는 보장은 없습니다.

    라우팅 기본값을 유지하고 여러 트래픽 처리 방식을 동시에 켜지 마세요. 기기에서 이미 다른 프록시를 실행 중이거나 조직에서 네트워크 설정을 배포했다면 변경 가능한 설정을 먼저 확인하고 기존 상태를 기록하세요.

  3. 접속 및 종료 상태 확인

    먼저 평소 직접 연결되는 대상을 열고, 다음으로 규칙에 따라 프록시를 거쳐야 하는 대상을 확인하세요. 로그가 있다면 테스트 시각과 대상을 맞춰 연결이 코어에 도달했는지, 예상한 아웃바운드 규칙이 적용됐는지 살펴보세요. 노드 속도 측정은 비교에 참고할 수 있지만 앱에서 실제 요청을 보내는 테스트를 대신할 수는 없습니다.

    테스트가 끝나면 클라이언트를 종료하고 네트워크 상태를 다시 확인하세요. 종료 후 브라우저에서 웹 페이지가 열리지 않는다면 시스템 프록시가 이미 중지된 로컬 포트를 가리키는지 먼저 확인한 뒤 노드나 DNS를 조정할지 결정하세요.

전체 가이드 보기 →

05 오픈소스 생태계

Project V, V2Fly 및 Xray

클라이언트, 코어, 서비스 출처를 구분해야 가이드의 메뉴, 설정 필드, 업데이트 안내가 사용 중인 기기에 적용되는지 판단할 수 있습니다.

연결 처리 순서
  1. 앱에서 연결 요청
  2. 클라이언트가 코어 설정
  3. 코어가 규칙에 따라 아웃바운드 선택

코어 및 생태계 용어 보기 →

  1. Project V: 프로젝트 이름으로 코어 이해하기

    Project V는 네트워크 프록시를 구축하기 위한 도구 모음이며, V2Ray는 그중 연결을 처리하는 핵심 구성 요소입니다. 설정에서 ‘인바운드’는 코어가 연결을 받아들이는 경로를, ‘아웃바운드’는 받은 연결을 처리하는 방식을 뜻하며 라우팅은 둘 사이에서 경로를 선택합니다. 그래픽 클라이언트는 이러한 설정을 노드 목록, 프록시 스위치, 라우팅 화면으로 구성해 설정 파일을 일일이 편집하는 수고를 덜어 줍니다.

    ‘V2Ray 설정’이라는 표현을 보면 먼저 전체 코어 설정인지, 특정 필드인지, 클라이언트로 가져오는 링크인지 구분하세요. 세 가지는 용도가 다릅니다. 예를 들어 가이드에 아웃바운드 일부만 나와 있다면 기존 인바운드 및 라우팅 설정과 함께 사용해야 합니다. 일부 설정을 전체 파일처럼 덮어쓰면 기존 수신 포트와 규칙도 함께 사라집니다.

  2. V2Fly와 Xray: 같은 계보에서 독립적으로 발전

    V2Fly는 V2Ray 코어의 커뮤니티 유지 관리를 이어 왔고, Xray는 관련 코드에서 갈라져 독립적인 코어로 발전했습니다. 두 코어는 많은 설정 개념을 공유하지만 지원하는 프로토콜 기능, 전송 옵션, 설정 필드는 완전히 같지 않습니다. 양쪽에 같은 프로토콜 이름이 표시되더라도 전송 방식, 보안 설정, 서버 매개변수를 함께 확인해야 합니다. 이름만으로 호환 여부를 판단할 수는 없습니다.

    예를 들어 같은 VMess를 사용하는 두 노드라도 전송 방식은 다를 수 있습니다. 가져오기에 성공했다는 것은 클라이언트가 링크를 읽었다는 뜻일 뿐입니다. 실제 연결을 위해서는 선택한 코어가 해당 필드를 지원하고 양쪽 설정이 일치해야 합니다. 가져오기는 되지만 연결되지 않는 경우 현재 코어와 노드 설정부터 확인하고 클라이언트 교체는 그다음에 고려하세요.

  3. 클라이언트 3종: 인터페이스와 기본 코어의 역할

    v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 그래픽 클라이언트입니다. 데스크톱용 v2rayN은 클라이언트가 지원하는 범위에서 노드별로 코어 유형을 선택할 수 있습니다. 모바일용 v2rayNG는 Xray 클라이언트이며, v2flyNG는 V2Fly 코어를 사용하므로 설정이 해당 코어를 명시적으로 요구할 때 고려할 수 있습니다. 클라이언트는 조작 기능을 제공하고 코어는 연결을 처리하므로 두 가지 설정을 혼동하지 마세요.

    클라이언트를 고를 때는 먼저 기기와 기존 설정을 살펴보세요. 데스크톱에서 그룹별 관리가 필요하면 v2rayN부터 시작하고, 모바일에서는 노드 요구 사항을 확인해 두 클라이언트를 비교하세요. 다른 클라이언트로 옮길 때는 기존 구독으로 새 클라이언트에서 노드 목록을 다시 만든 뒤 사용자 지정 규칙을 하나씩 재구성하는 편이 간편합니다. 다른 클라이언트의 설정 파일 전체를 그대로 복사하지 마세요.

  4. 오픈소스 라이선스: 코드, 구독, 서비스는 별개

    오픈소스 라이선스는 코드를 열람하고 수정하며 재배포하는 방법을 규정합니다. 사용자에게 원격 노드를 제공하거나 타사 서비스의 트래픽 한도, 이용 시간, 가용성을 정하지는 않습니다. 클라이언트 라이선스 안내와 서비스 제공자의 이용 조건은 따로 확인하세요. 구독이 작동하지 않으면 주소와 서비스 상태를 점검하고, 인터페이스가 시작되지 않으면 먼저 클라이언트 실행 조건을 확인하세요.

    웹 페이지 캡처, 설정 내보내기 파일, 로그에는 구독 주소나 노드 주소, 개인 접속 기록이 포함될 수 있습니다. 문제를 설명할 때는 클라이언트 이름, 오류 종류, 재현 단계, 필요한 비식별 정보만 남기면 충분합니다. 문제가 반복된다면 전체 화면의 설정 캡처를 공유하기보다 어떤 네트워크에서 어떤 테스트 대상으로 재현했는지 기록하는 편이 도움이 됩니다.

  5. 업데이트 관리: 클라이언트, 코어, 구독을 따로 기록

    커뮤니티에서 관리하는 클라이언트, 함께 제공되는 코어, 구독 목록은 업데이트 주기가 서로 다릅니다. 클라이언트 업데이트는 메뉴나 가져오기 방식을 바꿀 수 있고, 코어 업데이트는 프로토콜 호환성에 영향을 줄 수 있으며, 구독 업데이트는 노드를 교체하거나 이름을 바꿀 수 있습니다. 세 항목이 한꺼번에 바뀌면 문제가 생겼을 때 무엇을 되돌려야 할지 파악하기 어렵습니다.

    업데이트 전에 현재 사용 중인 클라이언트와 코어 유형, 노드, 시스템 프록시 모드를 기록하고 클라이언트에서 지원하는 방법으로 필요한 설정을 백업하세요. 업데이트 후에는 이전에 확인했던 테스트 대상으로 다시 점검해 직접 연결, 프록시 연결, 종료 상태를 살펴보세요. 일부 노드 그룹에만 문제가 있다면 해당 구독부터 확인하고, 모든 앱의 연결이 끊겼다면 코어 시작 여부와 시스템 트래픽 처리 상태를 다시 점검하세요.

06 기술 노트

구독 관리 및 배포 노트

기본 연결이 작동하면 현재 필요한 내용부터 이어서 살펴보세요. 노드 목록이 너무 길다면 구독을 정리하고, 트래픽 처리 범위를 넓히려면 라우터 배포 방법을 확인하세요.

전체 글 보기 →