설정 항목 한눈에 보기
시스템 프록시는 앱이 트래픽을 클라이언트로 전달하는 방식을 정하고, 라우팅은 전달받은 트래픽을 어디로 보낼지 정합니다. 두 설정을 구분해 이해하면 문제를 해결할 때 스위치를 반복해서 바꿀 필요가 없습니다.
처음 설정할 때는 시스템 프록시로 브라우저 접속을 확인한 다음 TUN 모드를 고려하세요. 문제를 클라이언트의 로컬 포트 수신, 원격 연결, 앱의 프록시 연결 등 세 부분으로 나눠 살펴볼 수 있습니다. 노드 테스트 성공은 테스트 요청의 연결 경로가 작동했다는 뜻일 뿐, 컴퓨터의 모든 앱이 프록시를 사용한다는 의미는 아닙니다.
아래 다섯 항목은 일상에서 자주 사용하는 설정입니다. 떠 있는 창은 설정의 의미를 보여 주는 예시이며 기기를 변경하지 않습니다. 클라이언트마다 메뉴 이름이 조금 다를 수 있으니 실제 화면을 기준으로 진행하세요. 낯선 용어가 나오면 먼저 용어 안내를 확인한 뒤 설정 단계를 이어가세요.
10808사용 가능한 구성을 선택한 뒤 시스템 프록시를 자동 설정으로 바꾸세요. 시스템 프록시 설정을 따르는 앱은 요청을 로컬 리스닝 포트로 보내고, 코어가 이어서 처리합니다. 처음 연결을 확인하기 좋은 방법이며 변경 범위도 쉽게 파악할 수 있습니다. TUN과 달리 시스템 프록시는 앱이 설정을 따르는 경우에만 작동하므로 일부 게임, 터미널, 자체 프록시 설정이 있는 앱은 별도로 설정해야 합니다. 테스트가 끝났거나 클라이언트를 종료하기 전에는 더 이상 사용하지 않는 시스템 프록시 설정을 해제해 앱이 중지된 포트에 계속 연결하지 않도록 하세요.
라우팅 분기는 연결을 직접 연결할지, 프록시로 보낼지, 차단할지 결정합니다. 먼저 클라이언트에 포함된 규칙을 사용해 자주 방문하는 사이트의 연결을 확인한 다음, 필요한 규칙만 추가하세요. 복잡한 규칙을 한꺼번에 가져오는 것보다 문제를 찾기 쉽습니다. 규칙은 일반적으로 위에서부터 순서대로 적용되므로 구체적인 도메인 규칙을 포괄적인 규칙보다 앞에 두고, 규칙에서 지정한 아웃바운드가 실제로 있는지도 확인하세요. 시스템 프록시와 달리 라우팅은 앱을 클라이언트에 연결하지 않고 코어에 들어온 트래픽만 처리합니다. 따라서 전역 프록시 라우팅으로 바꿔도 모든 앱의 트래픽이 자동으로 프록시를 거치는 것은 아닙니다.
앱이 시스템 프록시 설정을 따르지 않는다면 TUN 모드를 고려할 수 있습니다. TUN은 가상 네트워크 인터페이스로 트래픽을 전달하므로 관련 권한이 필요하고 라우팅 및 DNS 설정에도 영향을 줍니다. 활성화하기 전에 같은 구성으로 일반 프록시 연결이 되는지 확인하고, 시스템 라우팅을 변경하는 다른 도구는 잠시 종료하세요. TUN은 시스템 프록시보다 더 많은 트래픽을 처리할 수 있지만 문제를 확인할 범위도 넓습니다. 활성화 후 네트워크 전체에 문제가 생기면 먼저 TUN을 끄고 기본 연결을 복구한 다음 권한, 도메인 이름 확인, 기존 가상 네트워크 어댑터를 각각 확인하세요. 여러 설정을 동시에 바꾸지 않는 것이 좋습니다.
구독 그룹을 사용하면 같은 출처의 구성을 한곳에 모아 업데이트하고 확인하기 편리합니다. 그룹을 만들 때 알아보기 쉬운 이름을 입력하고 전체 구독 주소를 붙여 넣은 뒤 저장하고 업데이트하세요. 개별 공유 링크와 달리 구독은 출처의 구성 변경 사항을 반영할 수 있지만, 업데이트 성공만으로 모든 구성이 연결된다고 단정할 수는 없습니다. 가져온 뒤 목록이 비어 있으면 주소가 유효한지, 응답 형식이 클라이언트에서 지원되는지 확인한 다음 업데이트 요청의 네트워크 경로를 점검하세요. 구독 링크에는 접근 정보가 포함될 수 있으므로 화면 캡처나 공개 로그에 노출하지 마세요.
코어는 구성을 해석하고 연결을 설정하며 라우팅을 수행하고, 그래픽 인터페이스는 이를 관리하고 조작하는 역할을 합니다. v2rayN에서 사용할 코어는 프로토콜, 전송 방식, 현재 배포판의 지원 여부를 함께 고려해 선택하세요. 안드로이드에서는 필요에 따라 v2rayNG와 v2flyNG 중에서 고를 수 있습니다. 코어마다 지원하는 설정 항목이 다를 수 있으므로 전환 전에 기존 구성을 기록하고 호환성을 확인하세요. 인터페이스 테마를 바꾸는 것과 달리 코어 변경은 DNS, 라우팅, 전송 매개변수에 영향을 줄 수 있어 구성 이름만 같다고 호환되는 것은 아닙니다. 실행에 실패하면 오류 메시지를 확인하고 누락된 구성 요소나 지원되지 않는 항목이 있는지 살펴보세요.
순서대로 배우고 싶으신가요? 시스템 가이드에서 핵심 개념부터 설치, 구독, 프록시 모드와 유지 관리까지 단계별로 알아보세요.
클라이언트 다운로드
데스크톱에서는 v2rayN, 안드로이드에서는 v2rayNG부터 살펴보세요. 운영체제와 프로세서 종류를 확인한 뒤 다운로드 센터에서 알맞은 항목을 선택하세요. 클라이언트 설치 후에는 사용 권한이 있는 유효한 구성을 가져와야 합니다.
다운로드 센터에서 Desktop 버전과 기존 WPF 버전을 받을 수 있습니다. Desktop은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF는 익숙한 데스크톱 조작 방식을 이어갑니다. 시스템 요구 사항과 사용 습관을 기준으로 고르세요. 화면 차이만을 이유로 두 버전을 모두 설치할 필요는 없습니다.
처음 실행한 뒤 코어가 정상적으로 작동하는지 확인하고 구독을 가져온 다음 시스템 프록시를 켜세요. 압축 파일을 사용한다면 먼저 전체 압축을 푼 뒤 실행해야 합니다. 압축 프로그램 안에서 바로 실행하지 마세요. 일반 브라우저 연결을 확인할 때 TUN을 먼저 켤 필요는 없습니다. 가상 네트워크 어댑터를 사용하는 경우에만 권한과 시스템 구성 요소를 확인하세요.
먼저 ‘이 Mac에 관하여’를 열어 기기가 Apple Silicon인지 Intel 프로세서인지 확인한 다음 해당 설치 파일을 선택하세요. 화면이 같아도 설치 파일의 아키텍처는 다를 수 있습니다. 아키텍처에 맞는 파일을 선택하면 실행 및 구성 요소 호환성 문제를 줄일 수 있습니다.
설치 후 시스템 안내에 따라 필요한 권한을 허용하고 네트워크 설정에서 프록시 상태를 확인하세요. 다른 네트워크 도구를 함께 사용 중이라면 먼저 종료한 뒤 테스트해 설정이 서로 덮어쓰지 않도록 하세요. 특정 앱만 연결되지 않는다면 클라이언트를 다시 설치하기보다 해당 앱이 시스템 프록시를 사용하는지 먼저 확인하세요.
먼저 Xray 코어 기반의 v2rayNG를 고려하세요. V2Fly 코어와의 호환성이 필요한 경우 v2flyNG를 확인하면 됩니다. 최신 스마트폰은 대체로 arm64를 선택합니다. 기기 아키텍처를 알기 어렵다면 범용 버전 안내를 확인하고, 휴대폰 브랜드만으로 판단하지 마세요.
구성을 가져온 뒤 연결을 시작하고, 처음 사용할 때는 시스템 VPN 권한을 허용하세요. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 안드로이드는 데스크톱의 시스템 프록시와 다른 VPN 인터페이스를 사용합니다. 같은 구독을 양쪽에서 사용하더라도 라우팅과 앱별 분기 설정을 각각 확인해야 합니다.
배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택하고, 프로세서가 x64인지 arm64인지 확인하세요. 여기서는 구독 관리, 구성 전환, 연결 로그 확인에 적합한 그래픽 클라이언트를 제공합니다.
데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다르고, 터미널 앱은 별도 설정이 필요할 수도 있습니다. 설치한 뒤 브라우저에서 프록시 연결을 먼저 확인하고 다른 앱은 하나씩 연결하세요. TUN을 사용하기 전에는 배포판의 권한 요구 사항과 같은 라우팅을 관리하는 다른 네트워크 서비스가 있는지 확인하세요.
첫 연결 · 3단계 미리보기
먼저 작동하는 최소한의 연결 경로를 만든 뒤 규칙을 추가하세요. 한 번에 설정 하나만 바꾸고 직전의 정상 상태를 기록해 두면 문제가 생겼을 때 원인을 파악하기 쉽습니다.
구독 그룹에 출처 이름과 전체 링크를 추가하고 저장한 뒤 업데이트하세요. 안드로이드에서는 구독 그룹 설정에서 같은 작업을 할 수 있습니다. 업데이트가 끝나면 목록에 항목이 있는지, 프로토콜과 서버 주소, 필수 매개변수가 제대로 불러와졌는지 확인하세요. 구독 링크와 개별 공유 링크는 용도가 다르므로 서로 바꿔 입력하면 안 됩니다.
목록이 비어 있다면 링크가 만료되지 않았는지, 주소에 공백이 들어가지 않았는지, 응답이 웹페이지로 반환되지는 않았는지 먼저 확인하세요. 비교에 필요한 정보가 사라지지 않도록 기존 그룹은 남겨 두고 반복해서 삭제하거나 다시 만들지 마세요. 클라이언트 자체는 원격 서비스를 제공하지 않으므로 설치 성공과 구독 유효 여부는 별개의 조건입니다.
후보 구성의 실제 연결 지연을 테스트한 뒤 요청을 완료할 수 있는 구성을 선택하세요. 데스크톱에서는 시스템 프록시 자동 설정을 켜고, 안드로이드에서는 연결을 시작해 시스템 권한을 허용하세요. 테스트 수치는 같은 환경에서 대략 비교할 때만 참고하세요. 한 번 낮게 나온 지연 시간이 안정성이나 다운로드 속도를 보장하지는 않습니다.
처음에는 기본 설정이나 자주 쓰는 분기 규칙을 그대로 사용하세요. 여러 프록시 클라이언트를 동시에 실행하거나 처음부터 TUN, 사용자 지정 DNS, 복잡한 라우팅을 함께 설정하지 마세요. 코어가 시작되지 않으면 로그에 표시된 오류부터 해결해야 합니다. 브라우저 설정을 계속 바꿔도 수신 대기 중이 아닌 포트가 작동하는 것은 아닙니다.
확인하려는 페이지를 열면서 클라이언트의 연결 로그나 트래픽 기록을 살펴보세요. 필요하면 프록시를 켰을 때와 껐을 때의 접속 결과를 비교해 요청 경로가 예상대로 바뀌었는지 확인하세요. 브라우저에서 접속된다고 해서 터미널, 게임, 다른 백그라운드 앱도 같은 네트워크 경로를 사용한다고 볼 수는 없습니다.
일부 사이트에 문제가 있다면 앱 설정, DNS, 라우팅 규칙, 원격 구성 순으로 범위를 좁혀 보세요. 설정을 바꾼 뒤에는 같은 테스트를 반복하고 매번 다른 대상을 시험하지 마세요. 연결이 정상화되면 사용할 구성과 연결 방식, 로컬 포트를 기록해 두세요. 클라이언트를 업데이트하거나 네트워크를 바꿀 때 비교 기준으로 활용할 수 있습니다.
Project V · V2Fly · Xray
먼저 세 가지 이름의 역할을 구분해 보세요. V2Ray는 Project V 프록시 도구 생태계에 속하고, V2Fly와 Xray는 관련 코어 프로젝트입니다. v2rayN, v2rayNG, v2flyNG는 사용자가 조작하는 그래픽 클라이언트입니다. 클라이언트 다운로드는 조작 도구를 선택하는 일이고, 코어 선택은 구성을 실행하는 방식과 관련됩니다.
Project V는 프록시 통신을 위한 모듈형 도구를 제공합니다. V2Ray 코어는 인바운드, 아웃바운드, 전송, 라우팅 등을 처리합니다. 그래픽 클라이언트는 이러한 기능을 메뉴, 그룹, 설정 화면으로 구성해 전체 설정 파일을 직접 작성하지 않아도 사용할 수 있게 합니다. 인터페이스에서 저장한 설정은 코어가 읽는 매개변수로 반영되는 경우가 많습니다.
따라서 클라이언트가 정상적으로 열려도 코어가 제대로 시작되었다는 뜻은 아니며, 코어가 시작되더라도 원격 구성이 유효하다고 단정할 수 없습니다. 이 가이드는 인터페이스, 코어, 네트워크를 나눠 점검하는 방식을 기본으로 합니다. 각 계층의 관계를 이해하면 오류가 발생했을 때 설정, 시작 로그, 연결 로그 중 무엇을 확인할지 먼저 판단할 수 있습니다.
V2Fly는 V2Ray 커뮤니티 생태계의 흐름을 이어가고, Xray는 관련 코드 기반에서 갈라져 지속적으로 발전해 왔습니다. 두 프로젝트는 기술적 배경을 공유하면서도 기능과 설정이 서로 다르게 바뀔 수 있습니다. 프로토콜 이름이 같더라도 전송 옵션, 확장 필드, 기본 동작까지 같다는 뜻은 아니므로 클라이언트와 코어의 지원 여부를 함께 확인해야 합니다.
예를 들어 REALITY와 같은 기능을 사용한다면 공유 링크를 가져오는 데 성공했다는 사실만으로 호환된다고 판단하지 말고, 코어와 클라이언트가 필요한 매개변수를 모두 인식하는지 확인하세요. 코어를 바꾸기 전에는 현재 라우팅과 DNS 설정을 기록해 두세요. 구성이 시작되지 않으면 구체적인 필드 오류부터 확인하고 모든 연결 실패를 원격 서비스 문제로만 돌리지 마세요.
v2rayN은 데스크톱용으로 구성, 구독, 프록시 모드를 한곳에서 관리하는 데 적합합니다. v2rayNG는 안드로이드용이며 주로 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어 기반의 안드로이드 선택지를 제공합니다. 모두 오픈 소스 프로젝트지만 같은 인터페이스의 이름만 바꾼 제품은 아닙니다. 메뉴, 설정 지원 범위, 업데이트 주기를 각각 확인하세요.
오픈 소스 라이선스는 코드 사용, 수정, 배포 조건을 정하며 클라이언트와 포함된 코어가 서로 다른 라이선스를 사용할 수도 있습니다. 오픈 소스는 코드를 검토하고 협업할 수 있는 기반이지, 모든 실행 환경과 구독 출처, 구성이 신뢰할 만하다는 뜻은 아닙니다. 프로젝트 유지 관리 상태, 권한 요구 사항, 현재 구성이 대상 클라이언트와 호환되는지 확인하세요.
커뮤니티에서는 문제를 수정하고 의존성을 조정하며 기능을 추가합니다. 다만 새 인터페이스나 코어에서는 설정 위치와 매개변수 동작이 달라질 수 있습니다. 업데이트 전에 필요한 로컬 구성을 저장하고, 배포 안내에서 플랫폼, 실행 환경, 호환성과 관련된 내용을 확인하세요. 문제를 해결하는 동안 클라이언트, 코어, 구독, 규칙을 한꺼번에 바꾸지 마세요.
업데이트 후에는 코어 시작, 구독 불러오기, 일반 프록시, 자주 사용하는 라우팅을 다시 확인한 뒤 필요에 따라 TUN도 점검하세요. 구독 업데이트는 원격 구성을 다시 가져오는 작업이며 클라이언트 프로그램 업데이트를 대신하지 않습니다. 이 사이트는 다운로드 경로와 한국어 사용 안내를 정리하지만 제3자 구독 내용이나 원격 서비스의 가용성을 보장하지 않습니다. 거주 지역의 법률과 사용하는 네트워크의 관리 정책을 준수하세요.
생태계와 유지 관리 범위를 더 알아보려면 사이트 소개를 확인하세요. 설정을 차근차근 배우려면 시스템 가이드 읽기를 참고하세요.
최신 기술 문서
현재 겪는 증상에 맞는 문서를 선택하세요. 설치 단계에서는 실행 환경을, 구독 단계에서는 가져온 내용을, 코어 시작 단계에서는 포트를 먼저 확인하세요. 원본 오류 메시지를 보관하면 구성을 계속 바꾸는 것보다 문제를 찾기 쉽습니다.
다른 프로그램이 로컬 리스닝 포트를 사용 중이면 코어가 시작되지 않을 수 있습니다. 시스템 명령으로 포트를 점유한 프로세스를 찾고 환경 설정에서 포트를 변경하는 방법을 단계별로 안내합니다.
포트 문제 해결 방법 보기 →압축 파일 버전 선택과 압축 해제 위치, 런타임 의존성부터 첫 실행, 구독 가져오기, 시스템 프록시 설정까지 Windows 설정 과정을 단계별로 안내하고 자주 놓치는 부분을 정리합니다.
설치 및 설정 안내 보기 →구독 링크 만료, 형식 비호환, 업데이트 요청의 프록시 미사용, 인코딩 오류 등이 가져오기 실패의 원인일 수 있습니다. 증상별 점검 방법을 정리해 어느 단계에서 문제가 생겼는지 확인하도록 돕습니다.
구독 점검 목록 보기 →