데스크톱 및 Android 클라이언트, 한국어 설정 단계와 고급 활용 라우팅 안내를 한곳에 정리했습니다. 먼저 운영체제에 맞는 클라이언트를 선택한 뒤 구독을 가져오고 프록시 모드를 확인하세요.
전체 설정 과정을 다섯 개의 연결 지점으로 나눴습니다. 각 단계에서 한 가지 문제만 처리하면 클라이언트, 구독, 프록시 모드와 라우팅 규칙 사이에서 추측을 반복하지 않아도 됩니다.
데스크톱 운영체제에서는 먼저 v2rayN을 확인하세요. 서버 목록, 구독 그룹, 시스템 프록시, 라우팅 규칙과 코어 로그를 하나의 인터페이스에서 관리할 수 있어 Windows, macOS, Linux 사용자도 비슷한 방식으로 사용할 수 있습니다. Android 기기는 보통 v2rayNG를 선택하며, V2Fly 코어 계열이 필요할 때 v2flyNG를 고려하면 됩니다. 선택 전 운영체제와 프로세서 아키텍처를 확인하세요. 설치 가능 여부를 나중에 확인하려고 파일부터 받으면 패키지 유형을 잘못 고르거나 설정을 옮기는 번거로움이 생길 수 있습니다.
구독 주소는 서버 자체가 아니라 서비스 제공자가 관리하는 설정 목록입니다. 주소를 복사한 뒤 클라이언트의 구독 관리 메뉴에서 새 항목을 추가하고 수동 업데이트를 한 번 실행해야 서버 항목이 로컬 목록에 기록됩니다. 여러 구독은 각각 이름을 지정하고 출처별로 그룹을 나누면 나중에 작동하지 않는 주소를 더 쉽게 찾을 수 있습니다. 업데이트 후 목록이 비어 있다면 먼저 주소가 완전한지, 그룹 필터 조건이 너무 엄격하지 않은지 확인한 뒤 구독 업데이트 로그를 살펴보세요. 클라이언트를 계속 삭제할 필요는 없습니다.
코어가 성공적으로 시작되었다는 것은 로컬 프록시 포트가 수신 대기 중이라는 뜻일 뿐입니다. 브라우저나 다른 프로그램이 해당 포트를 사용하는지는 시스템 프록시, 앱 자체의 프록시 설정과 TUN 모드에 따라 달라집니다. 처음 설정할 때는 서버 하나를 선택하고 시스템 프록시를 활성화한 뒤 브라우저로 확인하는 것이 좋습니다. 터미널 프로그램은 데스크톱 시스템의 프록시 설정을 자동으로 읽지 않는 경우가 많으므로 환경 변수나 앱 옵션을 별도로 설정해야 합니다. ‘코어가 실행 중인가’와 ‘트래픽이 프록시로 들어가는가’를 나누어 확인하면 문제 범위를 빠르게 좁힐 수 있습니다.
라우팅 분할은 도메인, IP 또는 앱 트래픽을 프록시, 직접 연결 또는 차단 중 어디로 보낼지 결정합니다. 처음 사용하는 경우 클라이언트에 내장된 기본 규칙부터 적용하고 연결이 정상인지 확인한 뒤 사용자 규칙을 추가하세요. 규칙 순서는 매칭 결과에 영향을 줍니다. 더 구체적인 도메인과 네트워크 대역은 일반 규칙보다 앞에 두어 먼저 매칭되지 않도록 하는 것이 보통입니다. 수정 후에는 코어를 재시작하고 실제 접속 결과를 확인하세요. 단일 스위치만 제공하는 도구와 달리 V2Ray 생태계에서는 인바운드, 아웃바운드, DNS와 라우팅을 조합해 관리할 수 있지만, 설정 경계를 명확히 유지해야 합니다.
연결되지 않을 때는 먼저 클라이언트 상태 표시줄과 코어 로그를 확인하고 구독, 포트, DNS와 라우팅을 동시에 바꾸지 마세요. 로그의 포트 사용 중 메시지는 대개 로컬 프로그램 충돌을 가리키고, 설정 파싱 오류는 필드 형식이나 매개변수가 불완전하다는 뜻입니다. 연결 시간 초과가 발생하면 서버 상태, 네트워크 경로와 DNS 해석을 나누어 확인해야 합니다. 한 번에 변수 하나만 바꾸고 재시작한 뒤 결과를 기록하세요. 이 방식은 서버를 계속 바꾸는 것보다 조금 느리지만 재사용할 수 있는 결론을 남기며, 문제가 클라이언트 인터페이스에 있는지 하위 코어에 있는지도 판단하기 쉽습니다.
홈페이지에서는 플랫폼만 구분합니다. 설치 패키지 유형, 프로세서 아키텍처와 클라이언트 차이는 다운로드 페이지에 모아 여러入口에서 같은 판단을 반복하지 않도록 했습니다.
새로운 데스크톱 인터페이스와 기존 WPF 인터페이스 중에서 선택할 수 있습니다. 전자는 새로 설치하는 경우에 적합하고, 후자는 익숙한 메뉴와 설정 절차를 이어서 사용하려는 경우에 적합합니다.
다운로드 페이지로 이동기기 프로세서에 맞춰 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. 설치 후에는 다른 데스크톱 운영체제와 비슷한 구독 및 라우팅 관리 인터페이스를 사용할 수 있습니다.
다운로드 페이지로 이동대부분의 기기에서는 arm64 패키지를 선택합니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 프로토콜 설정과 사용 방식에 따라 결정하면 됩니다.
다운로드 페이지로 이동배포판의 패키지 체계에 맞춰 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처도 구분하세요. 구독 그룹과 시각적 라우팅 관리가 필요한 환경에는 데스크톱 인터페이스가 적합합니다.
다운로드 페이지로 이동먼저 검증 가능한 가장 짧은 경로를 구성한 다음 라우팅, DNS와 TUN을 조정하세요. 문제가 생겼을 때 어떤 단계의 변경으로 결과가 달라졌는지 명확히 알 수 있습니다.
전체 가이드 보기다운로드 페이지에서 운영체제와 프로세서 아키텍처에 맞는 설치 패키지를 선택하세요. 데스크톱에서는 v2rayN을 사용하고, Android에서는 먼저 v2rayNG와 v2flyNG의 코어 계열을 비교한 뒤 설치할 클라이언트를 결정합니다. 설치가 끝나면 먼저 클라이언트를 열어 인터페이스가 정상적으로 표시되는지 확인하고 고급 설정은 나중에 변경하세요.
서비스 제공자가 전달한 전체 구독 주소를 복사한 뒤 클라이언트의 구독 관리에서 새 항목을 추가하고 알아보기 쉬운 메모를 입력하세요. 저장 후 업데이트를 실행하고 서버 항목이 목록에 들어올 때까지 기다립니다. 여러 구독은 각각 이름을 지정하고 출처가 다른 항목을 추적하기 어려운 하나의 기록으로 합치지 마세요.
설정 하나를 선택해 코어를 시작한 다음 시스템 프록시를 활성화하세요. 먼저 브라우저로 기본 접속을 확인하고, 별도의 프록시 설정이 필요한 터미널이나 앱을 테스트합니다. 기본 경로가 안정된 뒤에야 라우팅 규칙, DNS 또는 TUN 모드를 조정해 한 번에 너무 많은 변수를 추가하지 않도록 하세요.
클라이언트는 설정을 입력하는 창구일 뿐입니다. 프로토콜, 전송, 라우팅과 DNS를 실제로 처리하는 부분은 코어 계층에 있습니다. 이 관계를 이해하면 클라이언트 선택과 로그 확인이 모두 간단해집니다.
Project V는 V2Ray 설정 모델을 중심으로 한 네트워크 도구 생태계를 구축했습니다. 설정은 보통 인바운드, 아웃바운드, 라우팅, DNS, 전송과 정책 등으로 구성됩니다. 그래픽 클라이언트는 이러한 구조를 메뉴, 양식과 스위치로 바꾸어 일상적인 관리 부담을 줄이지만, 기본 개념은 그대로입니다. ‘클라이언트가 설정을 생성하고 코어가 설정을 실행한다’는 경계를 이해하면 시작 실패 시 인터페이스 저장 문제인지, 설정 필드 문제인지, 코어 실행 단계의 문제인지 먼저 판단할 수 있습니다.
VMess, VLESS, Trojan 등 프로토콜 이름은 연결 방식을 설명하고, TCP, WebSocket, gRPC 등은 전송 계층의 조합을 설명합니다. TLS와 REALITY는 연결 핸드셰이크와 인증에 관련됩니다. 이들은 서로를 대체하는 단일 선택지가 아니라 설정의 서로 다른 계층에 배치될 수 있는 요소입니다. 이 사이트의 용어집은 계층별로 개념을 설명해 약어만 기억하고 어떤 필드에 넣어야 하는지 모르는 상황을 피하도록 돕습니다.
V2Fly는 V2Ray Core의 커뮤니티 유지보수 노선을 이어가며 비교적 완전한 설정 체계와 프로토콜 구현을 유지합니다. Xray는 유사한 설정 모델을 바탕으로 전송 기능, 프로토콜 구현과 실행 옵션을 확장해 왔습니다. 두 코어에는 공통 개념이 많지만 지원 범위, 필드 세부 사항과 업데이트 주기는 완전히 같지 않습니다. 공유 링크나 구독을 가져올 때 클라이언트는 보통 자체 코어에 맞게 설정을 변환합니다. 최신 프로토콜 매개변수를 사용할 때는 서버, 공유 형식, 클라이언트와 코어가 호환되는 경로에 있는지 확인해야 합니다.
코어 계열은 운영체제로 나뉘지 않습니다. 데스크톱의 v2rayN은 코어와 그래픽 설정을 관리하고, Android에서는 v2rayNG와 v2flyNG가 각각 해당 방향의 구현을 제공합니다. 선택할 때 기능 이름이 가장 많은 제품을 찾기보다 현재 구독에서 사용하는 프로토콜, 복잡한 라우팅의 필요 여부, 여러 기기에서 비슷한 설정 방식을 재사용할 필요가 있는지를 확인하세요.
v2rayN은 Windows, macOS와 Linux 데스크톱 환경을 대상으로 구독 관리, 서버 필터링, 시스템 프록시, 라우팅 규칙, DNS, TUN과 로그 확인 기능을 제공합니다. 데스크톱에서는 운영체제 프록시와 앱 프록시를 함께 처리해야 하므로 v2rayN의 가치는 코어를 시작하는 데 그치지 않습니다. 시스템 설정, 설정 생성과 실행 상태를 확인 가능한 절차로 묶어 주는 데에도 의미가 있습니다.
v2rayNG는 Android에서 널리 사용되는 Xray 코어 클라이언트로, 구독이나 공유 링크로 설정을 관리하고 앱별, 라우팅 및 로컬 프록시 관련 옵션도 제공합니다. v2flyNG는 V2Fly 코어 노선을 대상으로 하며 해당 코어 계열이 필요할 때 선택할 수 있습니다. 세 클라이언트 모두 오픈 소스 커뮤니티에서 지속적으로 유지보수하며, 기능 변경은 대체로 코어 호환성, 플랫폼 대응, 구독 파싱과 인터페이스 관리에 초점을 둡니다.
클라이언트 업데이트는 인터페이스만 바꿀 수도 있고 코어, 설정 변환 또는 시스템 연동까지 함께 조정할 수도 있습니다. 업데이트 전에는 현재 사용하는 구독 그룹, 라우팅 규칙과 주요 설정을 기록하세요. 업데이트 후에는 먼저 코어 시작을 확인하고 시스템 프록시, DNS와 TUN 등의 기능을 점검합니다. 기존 설정이 바로 실행되지 않는다면 모든 서버 항목을 다시 가져오기보다 오류 로그를 먼저 읽고 폐기되었거나 이름이 바뀐 필드를 확인하세요.
오픈 소스 유지보수의 장점은 명확한 코드와 버전 변경을 중심으로 설정 동작과 문제를 논의할 수 있다는 점입니다. 하지만 사용자는 상위 코어, 클라이언트 래퍼와 구독 서비스의 책임을 구분해야 합니다. 이 사이트의 다운로드 안내는 플랫폼별 클라이언트를 정리하고, 튜토리얼은 사용 절차를, 고급 매뉴얼은 구독 그룹, 라우팅, DNS, TUN, FakeDNS와 사용자 지정 아웃바운드를 설명합니다. 문서를 세 종류로 나누면 문제를 확인할 때 구체적인 계층까지 쉽게 좁힐 수 있습니다.
다음 네 가지 질문은 새 설정에서 가장 자주 뒤섞이는 단계를 다룹니다. 프로토콜, 라우팅과 클라이언트에 관한 더 자세한 용어는 용어집에서 확인할 수 있습니다.
용어집 열기Windows, macOS와 Linux 데스크톱에서는 우선 v2rayN을 사용하세요. Android 기기는 보통 Xray 코어를 사용하는 v2rayNG를 먼저 선택하고, V2Fly 코어 계열이 명확히 필요할 때 v2flyNG를 선택합니다. 이름은 비슷하지만 플랫폼 대상과 코어 노선이 다릅니다.
구독 항목을 추가한 뒤에도 업데이트를 실행해야 합니다. 목록이 계속 비어 있다면 주소가 완전한지, 구독이 그룹 필터에서 제외되었는지, 업데이트 로그에 파싱 오류가 반환되었는지 확인하세요. 로그를 확인하기 전에 구독을 계속 삭제하고 다시 만들지 마세요.
많은 터미널 도구는 데스크톱 시스템 프록시를 자동으로 읽지 않으므로 앱 매개변수나 프록시 환경 변수를 설정해야 합니다. 먼저 로컬 프록시 포트를 확인한 뒤 브라우저와 터미널을 각각 테스트하세요. 두 결과를 같은 경로로 간주하지 마세요.
앱이 프록시 설정을 지원하지 않거나 더 넓은 범위의 시스템 트래픽을 가로채야 하는 경우, 또는 일반 시스템 프록시로 대상 프로그램을 처리할 수 없는 경우 TUN을 검토할 수 있습니다. 활성화하기 전에 기본 프록시 연결을 먼저 확인하고 DNS, 라우팅과 권한 변경 사항을 이해해 문제가 생겼을 때 되돌릴 수 있도록 하세요.
로그, 시스템 프록시와 구독 그룹이라는 세 가지 구체적인 문제에서 출발합니다. 각 글은 한 가지 유형의 문제만 다루므로 증상에 따라 쉽게 찾을 수 있습니다.
v2rayN 로그 창을 열어 포트 사용 중, 설정 문법 오류와 프로토콜 매개변수 누락을 확인하고 오류 키워드에 따라 하나씩 수정하세요.
전체 글 읽기 →브라우저의 시스템 프록시 인식 방식과 터미널 환경 변수를 각각 확인해 트래픽이 프록시 경로의 어느 단계에서 벗어났는지 판단하세요.
전체 글 읽기 →구독 그룹, 출처 메모와 키워드 필터를 활용해 여러 구독을 지역과 용도별로 찾기 쉬운 서버 목록으로 정리하세요.
전체 글 읽기 →