CLIENT ROUTING / 한국어 설정 문서

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

v2rayN 다운로드 가이드 보기

v2rayN 및 v2rayNG 클라이언트 안내, 구독 가져오기 절차, 라우팅 문제 해결을 한곳에서 다루며, 데스크톱과 모바일 화면에 맞춰 설정 순서를 설명합니다.

Xray / V2Fly VMess / VLESS 구독 및 라우팅 한국어 문서

LINK INSPECTION

연결 점검실: 가져오기부터 아웃바운드까지 단계별 확인

클라이언트 연결 문제는 보통 하나의 설정만으로 발생하지 않습니다. 먼저 설정이 클라이언트에 들어왔는지 확인한 뒤, 코어가 시작되는지, 라우팅 규칙이 적용되는지, 시스템 트래픽이 로컬 포트로 들어오는지를 차례로 점검해야 합니다. 아래에서는 실제 연결 순서에 따라 각 단계를 나누고, 바로 실행할 수 있는 화면 조작을 함께 안내합니다.

INPUT / SUBSCRIPTION

먼저 구독이 올바른 그룹에 들어갔는지 확인

v2rayN 데스크톱 버전과 v2rayNG Android 버전은 모두 구독 주소와 단일 노드 공유 링크를 지원하지만, 메뉴 위치와 그룹 개념, 업데이트 방식은 완전히 같지 않습니다. 가져온 뒤에는 노드가 대상 그룹에 표시되는지 먼저 확인하고, 구독 업데이트를 수동으로 한 번 실행한 다음 사용할 노드를 현재 서버로 선택하세요. 주소를 구독 설정에 저장했다고 해서 노드가 기본 목록에 추가된 것은 아닙니다. 업데이트에 실패해도 클라이언트를 반복해서 삭제하기보다 주소의完整성, 기기 시간, 현재 네트워크, 로그 내용을 순서대로 확인해야 합니다.

이 사이트의 가이드는 ‘구독 저장’, ‘그룹 업데이트’, ‘노드 선택’을 별도 단계로 나눠 세 동작을 혼동하지 않도록 합니다. 버튼 위치만 알려 주는 짧은 설명보다 이런 순서가 입력, 파싱, 선택 중 어느 단계에서 문제가 발생했는지 명확히 보여 주며, 클라이언트가 달라져도 설정 절차를 적용하기 쉽습니다.

PLATFORM ENTRY

운영체제별 클라이언트 다운로드 페이지로 이동

플랫폼마다 설치 파일 형식과 권한 방식이 다릅니다. 데스크톱에서는 v2rayN을 우선 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 플랫폼 메뉴는 다운로드 페이지의 해당 탭을 바로 열며, 홈페이지에서 설치 파일 직링크를 제공하지는 않습니다.

DESKTOP

Windows

v2rayN으로 구독 그룹, 노드 선택, 시스템 프록시, 라우팅 규칙을 관리할 수 있습니다. 다운로드 페이지에서는 최신 데스크톱 UI와 기존 WPF UI를 제공합니다. 전자는 여러 플랫폼에서 일관된 조작을 원하는 사용자에게, 후자는 전통적인 Windows 메뉴 구조에 익숙한 사용자에게 적합합니다. 설치 후에는 먼저 시스템 아키텍처를 확인하고 가이드에 따라 첫 구독 업데이트를 완료하세요.

다운로드 페이지로 이동

DESKTOP

macOS

v2rayN 데스크톱 버전은 프로세서 아키텍처에 맞는 설치 파일을 제공합니다. 시스템 정보에서 기기가 Apple Silicon인지 Intel인지 확인할 수 있으며, 아키텍처를 잘못 선택하면 설치 파일이 정상적으로 실행되지 않을 수 있습니다. 처음 실행할 때는 시스템 안내에 따라 앱 확인 절차를 완료하고, 클라이언트에서 필요한 시스템 프록시 모드를 명확히 활성화하세요.

다운로드 페이지로 이동

MOBILE

Android

v2rayNG는 Xray 프로토콜 지원과 앱별 프록시가 필요한 사용자에게 적합하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 처음 연결할 때 시스템에서 로컬 VPN 서비스 권한을 요청합니다. 이 권한은 앱 트래픽을 클라이언트로 전달하는 역할만 합니다. 백그라운드 연결 끊김을 줄이려면 시스템 배터리 절전 정책을 확인하고 클라이언트가 백그라운드에서 실행되도록 허용 목록에 추가하세요.

다운로드 페이지로 이동

DESKTOP

Linux

v2rayN은 주요 소프트웨어 패키지 체계에 맞는 데스크톱 설치 파일을 제공합니다. Debian, Ubuntu 등에서는 deb를, Fedora, Rocky Linux 등에서는 rpm을 선택하고 x64와 arm64 아키텍처도 구분해야 합니다. 연결 후 브라우저는 작동하지만 터미널이 작동하지 않는다면 프록시 환경 변수나 적절한 트래픽 연결 방식을 추가로 설정하세요.

다운로드 페이지로 이동
전체 클라이언트 보기 → v2rayN, v2rayNG, v2flyNG 비교 →

QUICK START

구독 가져오기부터 연결 확인까지, 세 단계 순서

처음부터 모든 고급 옵션을 동시에 조정할 필요는 없습니다. 먼저 최소한의 작동 경로를 만든 뒤 애플리케이션 범위에 맞춰 라우팅과 분기 규칙을 추가하면 문제가 설정, 노드, 시스템 트래픽 진입점 중 어디에 있는지 더 빠르게 판단할 수 있습니다.

  1. STEP 01 / IMPORT

    구독 가져오기 및 그룹 업데이트

    v2rayN에서 ‘구독 그룹’ 관리 메뉴를 열고 구독 이름과 전체 주소를 추가한 뒤 저장하고 기본 화면으로 돌아가 업데이트를 실행하세요. v2rayNG에서는 구독 설정으로 들어가 주소를 저장한 다음 메뉴에서 구독 업데이트를 실행합니다. 업데이트가 끝나면 노드 수와 이름이 바뀌었는지 먼저 확인하고, 노드 하나를 현재 서버로 선택하세요. 목록이 비어 있다면 바로 시스템 프록시 설정으로 가지 말고 업데이트 알림과 로그를 확인해야 합니다. 아직 클라이언트에 사용할 수 있는 원격 설정이 없기 때문입니다.

  2. STEP 02 / CONNECT

    코어 시작 및 트래픽 진입점 선택

    데스크톱에서는 먼저 선택한 노드를 시작하고 로그에 로컬 프록시 포트가 수신 대기 중으로 표시되는지 확인한 뒤 사용 환경에 맞게 시스템 프록시를 켜세요. 브라우저와 시스템 프록시를 읽는 데스크톱 프로그램만 사용한다면 시스템 프록시로 충분한 경우가 많습니다. 터미널 도구, 특정 앱, 시스템 설정을 읽지 않는 프로그램은 별도로 프록시 환경 변수를 설정하거나 더 폭넓은 연결 방식을 사용해야 합니다. Android에서는 노드를 선택한 뒤 연결을 시작하고 시스템에 표시되는 로컬 VPN 서비스 권한을 허용하세요.

  3. STEP 03 / VERIFY

    로그와 실제 요청으로 연결 경로 확인

    연결 버튼에 ‘시작됨’이 표시되는 것은 클라이언트 절차가 시작됐다는 뜻일 뿐입니다. 이제 실제로 인터넷 연결이 필요한 앱을 열어 요청이 클라이언트 로그에 들어오는지 확인하고, 라우팅 규칙이 예상한 아웃바운드를 선택했는지 살펴보세요. 로그에 요청이 전혀 없다면 시스템 프록시, 앱 프록시 설정, Android 앱별 프록시 범위를 우선 확인합니다. 요청은 있지만 핸드셰이크에 실패한다면 기기 시간, 주소, 포트, TLS, serverName 등 노드 필드를 점검하세요.

전체 가이드 보기 문제 해결 문서 열기

OPEN ECOSYSTEM

Project V, V2Fly, Xray의 생태계 관계

클라이언트 이름, 코어 이름, 프로토콜 이름은 자주 함께 등장하지만 서로 다른 계층에 속합니다. 세 요소의 관계를 이해해야 플랫폼, 노드 설정, 기능 요구 사항에 맞는 클라이언트를 선택할 수 있습니다.

Project V는 프로토콜 및 설정 체계의 기반이 되는 맥락을 제공합니다

Project V는 V2Ray 생태계가 형성되는 과정에서 기반이 된 프로젝트 맥락입니다. V2Ray Core는 인바운드, 아웃바운드, 라우팅, DNS, 전송, 정책 등의 모듈을 중심으로 조합 가능한 설정 방식을 구축했습니다. 그래픽 클라이언트는 이러한 네트워크 기능 자체가 아니라 설정 관리, 시스템 연결, 실행 상태를 조작 가능한 화면으로 정리하는 역할을 합니다. 클라이언트에서 보이는 서버 주소, 포트, 사용자 식별자, 전송 방식, 라우팅 규칙은 결국 코어가 읽을 수 있는 설정으로 변환되어야 합니다.

이러한 계층 구조를 보면 같은 구독을 여러 클라이언트에서 가져올 수 있어도 코어의 지원 범위, 필드 매핑, 클라이언트 업데이트 주기에 따라 결과가 달라질 수 있는 이유를 이해할 수 있습니다. 문제를 해결할 때는 화면에서 설정이 저장되지 않은 것인지, 구독 파싱이 불완전한 것인지, 코어가 특정 프로토콜 매개변수를 인식하지 못하는 것인지 먼저 구분해야 합니다. 모든 문제를 ‘노드 사용 불가’로 묶어서는 안 됩니다.

V2Fly와 Xray는 연관되어 있지만 독립적으로 발전한 코어 계열입니다

V2Fly는 V2Ray Core의 커뮤니티 유지보수 방향을 이어 가며 모듈식 프록시 기능과 라우팅·전송 조합에 집중합니다. Xray는 유사한 설정 체계 위에서 프로토콜과 전송 기능을 계속 확장해 왔습니다. 두 코어는 인바운드, 아웃바운드, 라우팅 규칙, DNS, 정책 설정 등 많은 개념을 공유하지만 지원 항목, 필드 세부 사항, 업데이트 주기는 완전히 같지 않습니다. 구독에 특정 프로토콜이나 전송 조합이 포함되어 있다면 대상 클라이언트가 현재 사용하는 코어가 해당 필드를 처리할 수 있는지 확인해야 합니다.

코어가 다르다고 해서 모든 사용자가 복잡한 설정을 직접 편집해야 하는 것은 아닙니다. 대부분의 경우 클라이언트가 구독 내용을 바탕으로 설정을 생성하고 해당 코어를 시작합니다. 로그에 지원되지 않는 필드가 표시되거나, 구독 변환 과정에서 매개변수가 누락되거나, 사용자 지정 라우팅을 작성해야 할 때만 코어와 설정 구조를 자세히 살펴보면 됩니다. 관련 가이드에서는 어떤 단계가 클라이언트 화면에서 수행되는지, 어떤 판단에 코어 로그가 필요한지 명확히 구분합니다.

LICENSE

오픈 소스 라이선스 및 코드 검토

v2rayN, v2rayNG, v2flyNG와 관련 코어는 모두 오픈 소스 프로젝트로 유지 관리됩니다. 오픈 소스 라이선스는 코드 사용·수정·배포의 기본 경계를 정하며, 커뮤니티 참여자는 프로토콜 호환성, 플랫폼 지원, UI 기능, 버그 수정에 관한 개선을 제안할 수 있습니다. 일반 사용자에게 오픈 소스라는 특성의 가장 직접적인 의미는 클라이언트와 코어의 역할, 설정 구조, 변경 논의를 공개적으로 확인할 수 있다는 점입니다. 모든 동작이 하나의 폐쇄형 인터페이스에 의해 결정되는 구조가 아닙니다.

MAINTENANCE

클라이언트와 코어는 별도로 업데이트됩니다

그래픽 클라이언트와 프록시 코어는 서로 다른 출시 주기를 사용할 수 있습니다. 클라이언트 업데이트는 보통 화면, 구독 관리, 시스템 프록시, 플랫폼 호환성을 다루고, 코어 업데이트는 프로토콜 구현, 전송 조합, 라우팅, DNS 동작과 더 밀접합니다. 따라서 새 프로토콜을 인식하지 못한다면 클라이언트가 해당 설정을 지원하는지와 코어에 필요한 기능이 포함되어 있는지를 함께 확인해야 합니다. 업그레이드 전에는 현재 구독 그룹과 사용자 지정 라우팅을 기록해 두면 업데이트 후 설정을 단계별로 복원하기 쉽습니다.

SELECTION

플랫폼과 코어 요구 사항에 맞춰 선택

데스크톱에서는 v2rayN을 우선 사용하면 Windows, macOS, Linux 설정을 비슷한 조작 방식으로 관리할 수 있습니다. Android에서는 v2rayNG를 많이 사용하며 V2Fly 코어가 필요하면 v2flyNG를 선택할 수 있습니다. 선택 기준은 클라이언트 이름만이 아니라 구독에 사용된 프로토콜, 기기 아키텍처, 시스템 권한, 앱별 프록시 필요 여부까지 고려해야 합니다. 클라이언트 비교 페이지에서 세 제품의 용도, 지원 플랫폼, 기능 범위를 확인할 수 있습니다.

COMMON CHECKS

자주 묻는 질문

아래에는 처음 설치하거나 일상적으로 사용할 때 자주 겪는 네 가지 상황을 정리했습니다. 각 항목에서 점검 방향을 먼저 확인하고, 자세한 절차는 빠른 시작, 자주 묻는 질문, 문제 해결 페이지에서 이어서 살펴보세요.

구독을 저장했는데 노드가 표시되지 않는 이유는?

주소를 저장하는 것은 구독 소스를 등록하는 단계일 뿐이며, 구독 업데이트를 직접 실행해야 합니다. 업데이트 후에도 비어 있다면 주소의 누락 문자를 확인하고 시스템 시간, 현재 네트워크, 업데이트 로그를 점검하세요. 일부 오류는 요청 실패, 파싱 실패, 예상과 다른 응답 형식을 직접 알려 줍니다. 오류가 발생한 단계에 맞춰 처리하는 것이 반복해서 가져오는 것보다 효과적입니다.

구독 가져오기 단계 보기 →

클라이언트는 연결됐는데 브라우저가 접속되지 않는다면?

먼저 브라우저 요청이 클라이언트 로그에 표시되는지 확인하세요. 요청이 없다면 시스템 프록시가 활성화되지 않았거나 브라우저가 별도 프록시 설정을 사용하거나, 로컬 수신 포트와 시스템 설정이 일치하지 않는 경우가 많습니다. 요청이 있다면 DNS, 라우팅 일치, 원격 핸드셰이크를 계속 확인하세요. 두 상황은 해결 방향이 다릅니다.

인터넷 연결 문제 해결 보기 →

브라우저는 되는데 터미널 명령은 왜 프록시를 사용하지 않나요?

많은 브라우저는 시스템 프록시를 읽지만 터미널 프로그램은 자체 설정이나 환경 변수에 의존하는 경우가 많습니다. 클라이언트의 로컬 HTTP·SOCKS 포트를 확인한 뒤 각 도구가 지원하는 방식으로 프록시 변수를 설정하세요. 더 많은 프로그램에 적용해야 한다면 시스템에 적합한 트래픽 연결 모드를 검토할 수 있습니다. 브라우저가 작동한다는 이유만으로 모든 앱이 연결됐다고 판단하지 마세요.

시스템 프록시 문제 해결 보기 →

노드 속도 측정은 정상인데 실제 연결이 실패하면 어떻게 하나요?

기본 연결 테스트는 일부 네트워크 조건만 보여 줍니다. 완전한 연결에는 프로토콜 인증, TLS, serverName, 전송 방식, 라우팅 아웃바운드도 관련됩니다. 실제 요청을 보내 코어 로그를 확인하고, 파싱·연결·핸드셰이크·인증 중 어느 단계에서 실패했는지 파악한 뒤 해당 필드를 점검하세요. 많은 노드를 계속 바꾸는 방식은 피하는 것이 좋습니다.

자주 묻는 질문 페이지 열기 →

RECENT NOTES

프로토콜 선택 및 클라이언트 문제 해결 글

최근 글에서는 프로토콜 비교, TLS 인증서 오류, Android 백그라운드 연결 설정을 다룹니다. 구체적인 증상이나 설정 작업을 출발점으로 삼아 확인 가능한 필드와 조작 순서를 제시합니다.

프로토콜 해설

VMess, VLESS, Trojan, Shadowsocks 차이와 선택법: 네 가지 프록시 프로토콜 비교

암호화 방식, 전송 오버헤드, 위장 기능, 코어 지원이라는 네 가지 기준으로 프로토콜 차이를 정리하고 가정용 인터넷, 모바일 네트워크, 성능이 제한된 기기별 선택 조건을 설명합니다. 프로토콜 계층과 TLS, WebSocket 같은 전송 계층 설정을 나누어 판단해 보세요.

전체 글 읽기 →
문제 해결

V2Ray TLS 핸드셰이크 실패 및 인증서 오류 해결: 시간 불일치와 SNI 설정 점검

TLS 오류가 발생하면 먼저 기기의 시스템 시간을 확인하고, serverName과 인증서 도메인이 일치하는지 점검한 다음 관련 보안 옵션과 지문 설정을 살펴봐야 합니다. 핸드셰이크 단계별로 자주 발생하는 오류를 설명해 인증서 문제를 곧바로 노드 장애로 판단하지 않도록 안내합니다.

전체 글 읽기 →
안드로이드 팁

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

첫 연결 시 권한의 역할, 시스템 배터리 절전 정책이 백그라운드 연결에 미치는 영향, 앱별 프록시에서 ‘우회’와 ‘프록시만’ 범위의 차이를 설명합니다. 앱 전환 후 연결이 끊기거나 일정 시간 뒤 백그라운드 연결이 멈추는 Android 문제에 유용합니다.

전체 글 읽기 →
전체 글 보기 →