CLIENTS / ROUTING / DNS

v2rayNG 공식 사이트 클라이언트 다운로드

플랫폼에 맞는 v2rayN / v2rayNG / v2flyNG를 선택하고, 구독 가져오기부터 라우팅 및 DNS 설정까지 각 설정의 적용 범위를 알아보세요.

오픈 소스Xray / V2Fly한국어 설정 가이드

CONFIGURATION / 설정 안내

구독, 라우팅 및 실행 모드

그래픽 클라이언트는 서버를 관리하고 설정을 생성하며, 코어는 실제 트래픽을 전달합니다. 먼저 사용 중인 클라이언트와 코어를 확인한 뒤 해당 설정을 변경하세요. 아래에서는 설정을 목적별 다섯 가지 그룹으로 나누고, 오른쪽에는 각 설정의 사용 맥락을 안내합니다. 데스크톱과 Android 클라이언트의 옵션을 하나의 화면처럼 섞어 설명하지 않습니다.

출처별 구독을 그룹으로 나누면 업데이트, 필터링, 문제 해결이 쉬워집니다. v2rayN의 구독 그룹 설정에 주소를 입력한 다음 구독을 업데이트하세요. 목록이 비어 있다면 반복해서 재설치하기보다 다운로드 결과와 필터 조건을 먼저 확인하세요. 그룹 이름은 로컬에서 정리할 때만 사용되며 서버 프로토콜을 바꾸지 않습니다. 항목을 하나씩 붙여 넣는 것보다 구독으로 일괄 관리하는 편이 편리하지만, 업데이트하면 출처에 없는 기존 항목이 덮어써질 수 있으므로 직접 수정한 내용은 별도로 저장하세요. 구독 주소는 접근 자격 정보와 같으니 공개적으로 공유하지 마세요.

↗

라우팅은 코어에 전달된 연결을 직접 연결, 프록시 또는 차단 중 어디로 보낼지 결정합니다. v2rayNG 라우팅 설정에서 중국 본토 우회 같은 기본 규칙을 선택하고, 복잡한 요구가 있을 때 사용자 지정 규칙을 추가하세요. 규칙은 대개 위에서부터 순서대로 적용되므로 구체적인 도메인이나 주소 조건을 앞에 두고, 아웃바운드 태그가 실제로 존재하는지도 확인해야 합니다. 전역 프록시만 사용하는 것과 달리 규칙 모드에서는 로컬 네트워크나 지정 서비스의 직접 연결을 유지할 수 있습니다. 다만 시스템 프록시와 라우팅은 서로 다른 설정 단계이므로 클라이언트로 들어오지 않은 트래픽은 규칙을 바꿔도 자동으로 처리되지 않습니다.

↗

도메인 해석은 연결 대상뿐 아니라 주소를 이용하는 라우팅 판단에도 영향을 줍니다. 시스템 DNS, 코어 DNS, 브라우저 자체의 암호화 DNS를 구분한 뒤 어느 단계의 설정을 바꿀지 결정하세요. v2rayNG의 로컬 DNS와 FakeDNS는 실행 모드와 함께 이해해야 하며, 옵션을 켰다고 모든 앱에 적용되는 것은 아닙니다. DNS 주소 하나를 바꾸는 것보다 도메인별로 DNS 서버를 나누면 세밀한 라우팅에 유리합니다. 변경한 뒤에는 연결을 다시 설정하고 로그에서 DNS 처리 경로를 확인해 캐시된 결과를 새 설정의 효과로 오인하지 않도록 하세요.

↗

데스크톱 앱이 시스템 프록시를 따르지 않는다면 v2rayN의 TUN 모드를 고려할 수 있습니다. TUN은 가상 네트워크 인터페이스로 트래픽을 받아 처리하며 관리자 권한이 필요할 수 있고, 시스템 라우팅·방화벽·다른 가상 네트워크 어댑터의 영향을 받습니다. 시스템 프록시보다 더 많은 트래픽을 처리할 수 있지만 문제를 찾아가는 과정도 복잡해집니다. 먼저 시스템 프록시에서 노드가 작동하는지 확인한 뒤 TUN을 별도로 켜고 로컬 네트워크 접근과 DNS를 점검하세요. Android 클라이언트는 시스템 VPN 인터페이스로 트래픽을 처리하므로 권한과 실행 방식이 다릅니다. 데스크톱 네트워크 어댑터 문제 해결 절차를 그대로 적용하지 마세요.

↗

프로토콜 지원 여부는 클라이언트에 가져온 항목이 표시되는지만이 아니라 실제 실행 중인 코어에 따라 달라집니다. v2rayN에서는 설정 유형과 설치된 코어에 맞는 실행 구성 요소를 선택할 수 있습니다. 전환하기 전에 프로토콜, 전송 계층, 보안 매개변수가 서로 맞는지 확인하세요. v2rayNG는 Xray를 사용하고 v2flyNG는 V2Fly를 사용하는 별도의 Android 앱입니다. 같은 앱 안에서 전환하는 버튼이 아닙니다. 설정을 그대로 복사하는 것보다 코어별 지원 필드를 확인하면 호환성 차이를 찾기 쉽습니다. 특히 REALITY 같은 기능은 모든 코어에서 사용할 수 있다고 가정하지 마세요.

↗
v2rayN · 구독 그룹 설정 예시

그룹 관리 / SUBSCRIPTIONS

메모출처별 이름 지정
선택 주소(Url)구독 주소
별칭(Alias)필요에 따라 설정
구독 업데이트현재 그룹 업데이트

진행 순서: 그룹 저장 → 구독 업데이트 → 서버 목록 확인. 설정 구성을 보여 주는 예시이며 실제 실행 중인 클라이언트 화면은 아닙니다.

DOWNLOAD / 플랫폼별 다운로드

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

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. V2Fly 코어가 필요하다면 v2flyNG도 고려할 수 있습니다. 설치 패키지 형식과 프로세서 아키텍처는 별개의 기준이므로 먼저 운영체제를 확인한 뒤 칩 종류를 살펴보세요. 다운로드 페이지에서 플랫폼별 다운로드 링크, 설치 안내, 주의 사항을 확인할 수 있습니다. 홈페이지에는 선택 경로만 안내합니다.

Windows

v2rayN · 데스크톱 추천

시스템 프록시를 통해 브라우저와 데스크톱 앱을 관리할 때 적합합니다. 다운로드 페이지에서 크로스 플랫폼 기반의 최신 Desktop 버전과 기존 WPF 버전을 구분해 안내합니다. 사용 방식에 맞는 하나를 선택하고 두 클라이언트를 동시에 실행할 필요는 없습니다.

처음 실행할 때는 구독을 가져오기 전에 코어가 정상적으로 작동하는지 확인하세요. 실행 환경 안내나 로컬 포트 충돌이 나타나면 해당 오류에 맞게 해결하세요. 프로그램을 종료하기 전 시스템 프록시를 원래대로 돌려놓으면 클라이언트 종료와 프록시 설정 잔류로 인한 연결 문제를 구분하기 쉽습니다.

다운로드 페이지로 이동 →

macOS

v2rayN

먼저 ‘이 Mac에 관하여’에서 칩 종류를 확인하세요. Apple Silicon과 Intel은 설치 경로가 다릅니다. 특히 앱을 다른 기기에서 옮겨 온 경우 기기 외관이나 구입 연도만으로 아키텍처를 판단하지 마세요.

처음 실행할 때 시스템 설정에서 실행 권한을 확인해야 할 수 있습니다. 시스템 프록시와 네트워크 권한을 각각 점검하세요. 앱 화면이 열린다고 프록시까지 적용된 것은 아닙니다. TUN을 사용할 계획이라면 관련 권한을 따로 확인하고, 원인을 찾기 어려워지지 않도록 실행 모드와 노드 설정을 한꺼번에 바꾸지 마세요.

다운로드 페이지로 이동 →

Android

v2rayNG · 추천

v2rayNG는 Xray 코어를 사용하며 v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 비교적 최신 기기라면 보통 arm64를 선택합니다. 기기 아키텍처를 모르겠다면 범용 설치 패키지 안내를 확인하세요.

설정을 가져온 뒤 시스템 VPN 연결 요청을 승인해야 합니다. 백그라운드 배터리 절약 정책이 지속 연결에 영향을 줄 수 있으므로 연결이 안정된 다음 배터리 관리 설정을 확인하세요. 다른 VPN 앱이 실행 중이라면 먼저 인터페이스를 점유하고 있는지 확인하세요. 다른 클라이언트로 바꾸기 전에는 프로토콜과 전송 매개변수의 지원 범위도 다시 확인해야 합니다.

다운로드 페이지로 이동 →

Linux

v2rayN

배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 arm64 중 알맞은 아키텍처를 확인하세요. 그래픽 인터페이스 실행에 필요한 데스크톱 환경, 권한, 시스템 구성 요소도 설치 전에 점검해야 합니다.

데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다르며 일부 앱은 프록시 주소를 따로 설정해야 합니다. 먼저 프록시를 따르는 앱으로 연결을 확인한 뒤 TUN 권한과 라우팅 적용을 검토하세요. 터미널 프로그램과 브라우저의 동작이 다르더라도 노드가 작동하지 않는다고 단정하지 말고 각 프로그램의 프록시 설정을 따로 확인하세요.

다운로드 페이지로 이동 →

QUICK START / 사용 순서

가져오기, 연결, 확인

클라이언트 자체는 서버를 제공하지 않습니다. 시작하기 전에 사용할 수 있는 구독 주소나 단일 노드 공유 링크를 준비하고 사용 권한도 확인하세요. 처음에는 기본 설정을 유지해 서버 연결부터 확인하는 등 꼭 필요한 설정만 적용하세요. 이후 라우팅, DNS, 트래픽 처리 방식을 차례로 추가하면 됩니다.

STEP 01

구독 또는 단일 노드 가져오기

데스크톱에서는 구독 그룹에 출처 주소를 저장한 뒤 업데이트하세요. Android에서는 메뉴에서 클립보드 내용을 가져오거나 구독을 추가한 다음 업데이트할 수 있습니다. 구독 링크와 단일 노드 링크는 용도가 다릅니다. 올바르지 않은 메뉴에 입력하면 URL처럼 보이는 내용이어도 서버 항목이 생성되지 않을 수 있습니다.

가져온 뒤 서버 유형, 주소, 포트, 전송 방식이 모두 입력되었는지 확인하세요. 항목 하나만 누락됐다면 해당 항목의 형식을 먼저 살펴보세요. 그룹 전체가 비어 있다면 구독 요청 결과와 필터 조건을 확인하세요. 전체 구독 주소가 보이도록 공개 스크린샷을 찍지 말고, 문제를 알릴 때는 오류 내용과 필드 이름만 남기세요.

STEP 02

노드와 실행 방식 선택

사용할 서버를 활성 구성으로 지정한 다음 연결을 시작하세요. 데스크톱용 v2rayN에서는 해당 설정을 따르는 앱이 로컬 프록시 포트로 연결되도록 보통 시스템 프록시를 설정해야 합니다. Android용 v2rayNG는 시스템 VPN 권한으로 트래픽을 받습니다. 두 클라이언트의 화면은 다르지만 ‘구성을 선택한 상태’와 ‘서비스가 실행 중인 상태’는 구분해야 합니다.

처음에는 이해하기 쉬운 라우팅 기본 설정을 선택하고 사용자 지정 DNS, 복잡한 규칙, TUN을 한꺼번에 추가하지 마세요. 문제를 이전에 작동하던 상태와 비교할 수 있도록 노드, 트래픽 처리 방식, 라우팅은 한 번에 하나씩 바꾸세요. 다른 프록시 프로그램을 실행 중이라면 포트와 시스템 설정이 서로 덮어쓰이지 않도록 하나를 먼저 종료하세요.

STEP 03

실제 요청으로 확인

대상 앱을 열어 실제로 접속해 보고 클라이언트 로그도 확인하세요. 목록의 테스트 결과는 특정 테스트 경로의 상태만 보여 주므로 실제 앱의 접속을 대신할 수 없습니다. 브라우저는 자체 프록시 확장 프로그램이나 DNS 설정을 사용할 수 있으니 각각 따로 점검하세요.

연결에 실패하면 ‘구독 업데이트 여부, 코어 실행 여부, 앱의 프록시 진입 여부, 원격 서버 연결 여부’ 순서로 확인하세요. 모든 옵션을 반복해서 바꾸기보다 오류 유형을 기록하는 편이 문제 해결에 도움이 됩니다. 기본 연결을 확인한 다음 로컬 네트워크 접근, 도메인 해석, 앱 호환성에 맞춰 가이드에서 세부 규칙을 설정하세요.

PROJECT V / V2FLY / XRAY

클라이언트와 오픈 소스 코어

이름이 비슷해도 역할은 다릅니다. 그래픽 클라이언트, 프록시 코어, 서버 설정의 관계를 알면 설치 문제를 프로토콜 문제로, DNS 문제를 노드 문제로 잘못 판단하는 일을 줄일 수 있습니다.

Project V의 모듈형 구조

V2Ray는 Project V 프록시 도구 생태계에서 시작했으며 설정은 인바운드, 아웃바운드, 라우팅, DNS 등의 모듈로 구성됩니다. 로컬 앱의 트래픽은 먼저 인바운드로 들어온 뒤 규칙에 따라 해당 아웃바운드로 전달됩니다. 도메인 해석과 트래픽 식별 정보는 규칙을 판단하는 데 쓰입니다. 모듈형 구조 덕분에 그래픽 클라이언트는 자주 사용하는 작업을 설정으로 변환할 수 있어 사용자가 매번 전체 JSON을 직접 작성할 필요가 없습니다.

화면에 표시되는 ‘서버’는 보통 원격 연결 매개변수 모음이며, 로컬 연결이 이미 설정됐다는 뜻은 아닙니다. ‘시스템 프록시’는 운영체제 단계의 연결 설정이지 코어의 라우팅 모드가 아닙니다. 가이드를 읽을 때 각 단계를 구분해야 가져오기에 성공한 뒤에도 활성 구성을 선택하고 코어를 실행한 다음 앱의 트래픽 진입 경로를 확인해야 하는 이유를 이해할 수 있습니다.

V2Fly와 Xray의 지원 범위

V2Fly 커뮤니티는 V2Ray 관련 구현을 유지 관리하며 Xray는 같은 기술 생태계의 또 다른 코어 개발 계열입니다. 일부 프로토콜과 설정 개념은 공유하지만 새 기능, 필드 작성법, 호환 범위가 항상 같은 것은 아닙니다. REALITY 같은 기능을 사용할 때는 Xray의 지원 여부를 확인하세요. 클라이언트에서 필드를 저장할 수 있다고 해서 어떤 코어에서든 실행된다고 볼 수는 없습니다.

VMess, VLESS, Trojan, Shadowsocks는 프로토콜 선택지입니다. TCP, WebSocket, gRPC 등은 전송 계층 조합이며 TLS와 REALITY는 연결 보안 방식과 관련됩니다. 문제를 해결할 때 이 항목들을 각각 서버 설정과 대조하세요. 프로토콜 이름만 바꾸고 전송 및 보안 매개변수를 맞추지 않으면 연결되지 않는 경우가 많습니다.

세 그래픽 클라이언트의 역할

v2rayN은 데스크톱용 클라이언트로 서버 관리, 구독 업데이트, 시스템 프록시, 라우팅 기능을 제공하며 사용 가능한 코어로 설정을 실행할 수 있습니다. v2rayNG는 Android용으로 Xray 코어를 사용하고 시스템 VPN 인터페이스를 통해 기기 트래픽을 받습니다. v2flyNG도 Android용이지만 V2Fly 코어를 사용하며 해당 코어와의 호환성이 필요한 경우에 적합합니다.

세 클라이언트는 모두 오픈 소스 소프트웨어입니다. 클라이언트 프로젝트, 포함된 코어, 기타 구성 요소에는 서로 다른 오픈 소스 라이선스가 적용될 수 있으므로 구체적인 권리와 의무는 각 구성 요소에 포함된 라이선스 전문을 확인하세요. 선택할 때는 이름이 비슷한지만 보지 말고 플랫폼, 설정 호환성, 사용 목적을 우선 고려하세요. Android용 대체 앱이 다른 앱의 설정을 모두 자동으로 이어받는 것도 아닙니다.

업데이트와 설정 이전 순서

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 주로 인터페이스와 설정 생성 방식에 영향을 줍니다. 코어 업데이트는 프로토콜 지원과 실행 동작을 바꿀 수 있습니다. 구독 업데이트는 출처에서 제공하는 서버 항목만 동기화합니다. 구독 업데이트에 실패하면 클라이언트 설치 문제로 단정하기보다 요청 오류, 출처 상태, 그룹 설정을 먼저 살펴보세요.

설정을 바꾸기 전에 현재 작동하는 구성을 보관하고, 업데이트 후에는 활성 서버, 프록시 진입 경로, 기본 접속을 먼저 확인한 다음 사용자 지정 규칙을 복원하세요. 로그에서 필드 호환성, 권한 부족, 포트 충돌을 확인할 수 있지만 서버 주소나 접속 기록이 포함될 수 있습니다. 오류 내용을 공유하기 전에 개인 설정을 삭제하세요. 이 사이트는 소프트웨어 다운로드 경로와 기술 문서를 제공하며 서버 서비스와 사용 권한은 직접 확인하고 거주 지역에 적용되는 규정을 준수해야 합니다.

TECHNICAL NOTES / 기술 노트

설정 구조와 플랫폼별 설정

빠른 시작에서는 기본 연결을 설정하고, 기술 노트에서는 설정이 그렇게 구성된 이유를 설명합니다. 아래에는 최신 글 세 편을 발행일 역순으로 소개합니다. JSON 모듈 관계, 첫 설치 점검, DNS 라우팅 해석을 다루며 구체적인 문제에서 관련 내용을 찾아볼 수 있습니다.

입문 가이드

v2rayN 첫 설치와 초기 설정: Windows·macOS 공통 절차와 주의 사항

압축을 풀거나 설치한 뒤 처음 실행하는 단계부터 코어 파일, 로컬 수신 포트, 시스템 프록시, 구독 가져오기를 차례로 확인합니다. 실행 환경 누락, 권한 안내, 포트 충돌을 각각 해결해 클라이언트가 정상적으로 시작되기 전에 원격 노드 설정을 반복해서 바꾸지 않도록 안내합니다.

첫 설치 노트 읽기 →