오픈 소스 그래픽 클라이언트를 다운로드하고, 플랫폼에 맞게 설정한 다음 구독을 가져오고 라우팅을 설정하세요.
먼저 연결 설정을 가져온 뒤 어떤 트래픽을 클라이언트로 보낼지 정하세요. 자주 쓰는 설정 다섯 가지를 실제 작업 순서에 따라 살펴봅니다.
구독은 여러 연결을 지속적으로 관리할 때 유용합니다. 구독 그룹에 주소를 추가하고 저장한 다음 업데이트를 실행해 서버 항목이 표시되는지 확인하세요. 단일 노드 공유 링크는 클립보드 가져오기를 사용해야 하며, 구독 주소 입력란에 넣으면 안 됩니다. 항목을 하나씩 직접 입력하는 것보다 수정 작업을 줄일 수 있지만, 업데이트 과정에서 기존 항목이 바뀔 수도 있습니다. 출처별로 그룹 이름을 지정하고 수동 설정은 별도 그룹에 보관하세요. 업데이트에 실패하면 안내 메시지를 확인합니다. 구독 주소에 접속 정보가 포함될 수 있으므로 화면을 공유하기 전에 전체 주소를 가리세요.
구독 그룹 → 구독 그룹 설정
추가 → 메모 / 주소 → 확인
구독 그룹 → 구독 업데이트분할 라우팅은 요청을 직접 연결, 프록시 또는 차단 중 어디로 보낼지 정하는 기능이며 서버를 바꾸는 설정이 아닙니다. 먼저 클라이언트에서 제공하는 라우팅 구성을 선택하고 자주 쓰는 사이트에 접속되는지 확인한 뒤, 필요한 규칙만 추가하세요. 대부분의 규칙은 순서대로 적용되므로 범위가 넓은 규칙을 앞에 두면 뒤의 구체적인 규칙이 적용되지 않을 수 있습니다. 특정 도메인의 연결 경로가 잘못됐다면 노드를 계속 바꾸기보다 도메인 확인 방식과 규칙 순서를 함께 살펴보세요. 모든 트래픽을 같은 경로로 보내는 것보다 유연하지만, 규칙을 명확하게 관리해야 합니다. 수정 전에 설정을 내보내 두면 복구하기 쉽습니다.
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}클라이언트는 화면과 설정을 관리하고, 코어는 실제 연결을 처리합니다. v2rayN은 여러 코어를 관리할 수 있지만, 선택 가능한 코어는 현재 빌드와 서버 설정에 따라 달라집니다. Android용 v2rayNG와 v2flyNG는 각각 Xray 및 V2Fly 생태계를 중심으로 합니다. 프로토콜 이름이 비슷해도 모든 설정 항목을 서로 바꿔 쓸 수 있는 것은 아닙니다. 특히 REALITY, 흐름 제어 및 전송 매개변수는 서버 측 요구 사항을 확인해야 합니다. 코어를 바꾸기 전에는 기존 설정을 기록하고 한 번에 한 가지만 변경한 뒤 연결을 다시 시작해 로그를 살펴보세요. 그래야 코어 차이를 구독 오류로 오해하지 않습니다.
설정 → 코어 유형
Xray
V2Fly시스템 프록시는 주로 시스템 프록시 설정을 참조하는 앱에 적용되므로 브라우저 연결을 먼저 확인할 때 적합합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 받아 더 넓은 범위에 적용되지만, 권한과 라우팅, 도메인 확인 설정이 필요합니다. 어느 쪽도 정상적인 서버 설정을 대신하지는 않습니다. 처음에는 시스템 프록시를 선택하고 연결을 확인한 다음, 앱에 필요한 경우 TUN을 사용해 보세요. 설정을 켠 뒤 로컬 기기에 접속할 수 없다면 사설 주소의 직접 연결 규칙을 확인하세요. 여러 프록시 도구를 동시에 사용하는 것보다 한 번에 하나의 연결 방식을 유지하는 편이 문제를 파악하기 쉽습니다.
시스템 프록시: 시스템 프록시 자동 설정
TUN 모드 사용: 끄기
LAN 연결 허용: 끄기데스크톱과 휴대전화에서 같은 구독을 사용할 수 있지만, 로컬 수신 포트와 시스템 프록시, TUN 권한, 라우팅 파일 경로는 기기마다 따로 설정해야 합니다. 새 기기에서 구독을 가져온 뒤 프로토콜 지원을 확인하고 해당 기기의 옵션을 조정하세요. 전체 설정을 그대로 옮기는 것보다 안전합니다. 일부 클라이언트의 가져오기·내보내기 또는 백업 기능은 다른 클라이언트에서 읽히지 않을 수도 있습니다. 기기를 옮길 때는 연결 설정과 기기별 설정을 구분하고 기존 기기의 백업을 보관하세요. 일부 항목만 누락됐다면 재설치를 서두르지 말고 구독 형식과 코어 호환성을 먼저 확인하세요.
연결 출처: 구독 주소 / 공유 링크
기기 설정: 수신 포트 / 시스템 프록시 / TUN
가져온 뒤: 그룹 업데이트 → 서버 선택 → 연결 확인이 세 가지 설정은 서로 다른 질문에 답합니다. 서버 설정은 어디에 어떤 프로토콜로 연결할지 정하고, 시스템 프록시나 TUN은 앱의 트래픽을 클라이언트로 전달하며, 라우팅 규칙은 들어온 트래픽을 어느 경로로 보낼지 결정합니다. 가져오기에 성공했다고 해서 앱이 프록시를 사용한다는 뜻은 아닙니다. 브라우저에서 접속할 수 있어도 모든 데스크톱 프로그램이 같은 시스템 설정을 읽는 것은 아닙니다. 각 설정의 역할을 구분하면 문제 해결에 불필요한 변경을 줄일 수 있습니다.
처음 사용할 때는 기본 수신 주소를 유지하고 LAN 공유를 켜지 말며 복잡한 규칙을 서둘러 추가하지 마세요. 연결 하나로 실제 요청이 완료되는지 확인한 뒤 설정을 하나씩 조정하세요. 변경할 때마다 이전 값을 기록해 두면 문제가 생겼을 때 직전 변경을 되돌릴 수 있습니다. 프로토콜과 코어, 라우팅을 한꺼번에 바꾸는 것보다 원인을 찾기 쉽습니다. 이 문서의 설정 창은 옵션 간 관계를 설명하기 위한 예시이며, 실제 메뉴 이름은 설치한 클라이언트에 따라 다를 수 있습니다.
데스크톱에서는 v2rayN부터 시작하고 Android에서는 v2rayNG를 우선 고려하세요. 설치 파일의 CPU 아키텍처와 패키지 형식, 시스템 요구 사항은 클라이언트 다운로드 페이지에서 확인할 수 있습니다.
구독 그룹과 라우팅을 관리하고 그래픽 설정을 사용하려는 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Desktop과 기존 WPF 버전을 모두 제공합니다. 전자는 크로스 플랫폼 인터페이스를 사용하고, 후자는 익숙한 데스크톱 조작 방식을 이어갑니다. 두 인터페이스가 서로 다른 프록시 프로토콜을 뜻하는 것은 아니며, 실제 연결 기능은 코어와 설정에 따라 달라집니다.
먼저 운영체제와 프로세서를 확인한 뒤 안내에 따라 설치하세요. 기존 설정이 있다면 백업하고, 두 인스턴스가 같은 수신 포트를 동시에 사용하지 않도록 주의하세요. 프로그램을 실행한 뒤 구독을 가져와 서버를 선택하고 시스템 프록시를 설정합니다. 창을 열기만 해서는 모든 앱이 자동으로 연결되지 않습니다.
다운로드 페이지로 이동 →macOS용 v2rayN을 다운로드할 때는 먼저 칩 종류를 확인하세요. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 다음 Apple Silicon이나 Intel에 맞는 설치 파일을 선택합니다. 파일 확장자가 같아도 아키텍처가 다를 수 있습니다. 잘못 선택하면 실행되지 않거나 별도의 호환 처리가 필요할 수 있습니다.
처음 실행할 때 시스템 보안 알림이 표시되면 다운로드 출처와 알림 내용을 확인한 다음 시스템 설정에 따라 처리하세요. 보안 기능 전체를 바로 끄지는 마세요. 기존 구독을 그대로 사용할 수는 있지만 시스템 프록시와 TUN 권한, 파일 경로는 해당 기기에서 다시 확인해야 합니다. 다른 데스크톱 운영체제의 설정을 그대로 적용할 수 없습니다.
다운로드 페이지로 이동 →Xray 코어 기반의 v2rayNG를 우선 사용하고, V2Fly 설정과 맞춰야 한다면 v2flyNG를 고려하세요. 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 확인하기 어렵다면 범용 패키지 안내를 살펴보세요. 기기가 지원하는 명령어 집합은 시스템 정보로 확인해야 하며, 휴대전화 출시 연도만으로 판단할 필요는 없습니다.
Android에서 연결을 시작하면 시스템 VPN 연결 권한을 요청합니다. 이는 클라이언트가 트래픽을 받기 위한 절차이며, 원격 서버가 소프트웨어에 포함되어 있다는 뜻은 아닙니다. 연결이 백그라운드에서 끊긴다면 배터리 절약 정책과 백그라운드 실행 권한을 확인하세요. v2rayNG에서 구독을 가져온 뒤에는 그룹을 업데이트하고 항목을 선택한 다음 연결을 시작해야 합니다.
다운로드 페이지로 이동 →먼저 배포판에 맞춰 deb 또는 rpm을 선택한 뒤 기기가 x64인지 arm64인지 확인하세요. 다운로드 페이지는 x64를 주요 항목으로 제공하며 arm64용 옵션도 함께 안내합니다. 그래픽 데스크톱 환경과 시스템 구성 요소, 권한 정책에 따라 실행 방식이 달라질 수 있으므로 파일을 다운로드할 수 있는지만 보지 말고 설치 전에 해당 플랫폼의 요구 사항을 읽어 보세요.
시스템 프록시가 적용되는 범위는 데스크톱 환경에 따라 다를 수 있고, 일부 앱은 프록시 주소를 별도로 지정해야 합니다. 먼저 브라우저로 기본 연결을 확인한 뒤 다른 프로그램을 설정하세요. TUN을 사용할 계획이라면 필요한 권한과 라우팅 설정도 확인해야 합니다. 화면을 띄우기 위해 프로그램 전체를 계속 높은 권한으로 실행하는 것은 권장하지 않습니다.
다운로드 페이지로 이동 →출처가 신뢰할 수 있고 현재 유효한 구독 주소나 공유 링크를 준비하세요. 클라이언트는 설정을 읽고 연결을 만드는 도구이며, 설치한다고 서버가 자동으로 생성되는 것은 아닙니다.
기기 플랫폼과 프로세서에 맞는 설치 파일을 선택하세요. 구독 주소는 구독 그룹에 입력하고, 단일 노드 링크는 클립보드 가져오기 기능을 이용합니다. 구독을 저장한 뒤 업데이트를 실행하고 서버 항목이 표시되는지 확인하세요. 목록이 비어 있다면 업데이트 안내와 주소 전체가 입력됐는지, 내용 형식이 맞는지 먼저 살펴보세요. 연결 시작 버튼을 반복해서 누르지 마세요.
사용할 항목을 선택하세요. 데스크톱에서는 먼저 시스템 프록시를 사용하고, Android에서는 안내에 따라 연결 권한을 허용합니다. 기본 라우팅 설정은 유지하고 DNS와 TUN, 사용자 지정 규칙을 한꺼번에 바꾸지 마세요. 다른 프록시 도구가 실행 중이면 먼저 종료해 포트 충돌이나 시스템 설정 덮어쓰기를 방지하세요.
자주 쓰는 사이트나 대상 앱을 열어 요청이 완료되는지 확인하세요. 지연 시간 테스트는 참고 자료일 뿐 실제 접속을 대신하지 않습니다. 일부 탐지 방식이 실패해도 실제 연결은 정상일 수 있습니다. 접속 문제가 있다면 구독 유효성, 코어 실행 상태, 앱의 트래픽 연결 방식, 라우팅 순서대로 확인하고 한 번에 설정 하나만 바꾸세요.
종료하기 전에 시스템 프록시를 원래대로 되돌리세요. 설정을 바꾸거나 클라이언트를 업그레이드하기 전에 현재 정상 작동하는 설정을 저장하세요. 문제를 알릴 때는 관련 오류만 캡처하고 구독 주소와 사용자 식별 정보, 서버 접속 정보는 가리세요.
전체 사용법 보기 →클라이언트와 코어, 프로토콜은 서로 다른 계층에 속합니다. 소프트웨어 이름만 보고 호환성을 추측하기보다 각 계층의 역할을 이해하는 편이 유용합니다.
v2rayN · v2rayNG · v2flyNG
Xray · V2Fly
VMess · VLESS · Trojan · Shadowsocks
V2Ray는 Project V에서 시작했으며 네트워크 연결을 처리하는 모듈형 기능을 제공합니다. 사용자가 보는 창과 구독 목록, 스위치는 대개 별도로 개발된 그래픽 클라이언트에서 제공됩니다. 클라이언트는 화면에서 선택한 옵션을 코어 설정으로 바꿔 코어에 전달합니다. 따라서 실제 사용에서 ‘V2Ray 다운로드’는 보통 기기에 맞는 클라이언트를 먼저 다운로드한다는 의미이지, 기반 프로그램의 모든 매개변수를 직접 편집한다는 뜻은 아닙니다. 이 사이트에서는 플랫폼 선택과 입문 단계를 먼저 안내하고, 프로토콜과 설정 세부 정보는 참고 문서에서 다뤄 필요에 따라 더 깊이 살펴볼 수 있도록 구성했습니다.
두 소프트웨어에서 같은 링크를 가져와도 메뉴가 다르게 표시되는 이유도 여기에 있습니다. 화면 구성은 클라이언트가 결정하지만 링크의 항목을 실제로 사용할 수 있는지는 코어 기능과 클라이언트의 파싱 구현에 따라 달라집니다. 기능이 보이지 않을 때는 화면 메뉴가 없는 것인지, 가져오기가 지원되지 않는 것인지, 코어 기능이 부족한 것인지 먼저 확인하면 해결 방향을 정하기 쉽습니다.
V2Fly는 V2Ray 커뮤니티의 유지 관리 흐름을 이어가고, Xray는 관련 코드 기반에서 자체 기능을 발전시켜 왔습니다. 두 프로젝트는 자주 쓰이는 프로토콜과 설정 개념을 공유하지만 전송 방식과 흐름 제어 항목, 구현은 계속 달라질 수 있습니다. REALITY는 전송 보안 메커니즘이므로 VMess나 VLESS와 나란히 놓이는 독립 프록시 프로토콜로 단순하게 분류해서는 안 됩니다. 실제로는 VLESS, REALITY와 특정 흐름 제어를 조합하는 경우가 많으며, 사용 가능 여부는 양쪽의 구현 지원을 확인해야 합니다.
코어는 성능 순위가 아니라 서버 설정에 맞춰 선택해야 합니다. 연결 시간과 리소스 사용량은 기기와 네트워크 경로, 서버 부하, 전송 매개변수에도 영향을 받습니다. 모바일 기기의 배터리 사용량도 백그라운드 연결 유지와 네트워크 전환, 요청 빈도에 따라 달라지므로 프로토콜 이름만으로 결론 내릴 수 없습니다. 설계상 차이를 비교하려면 프로토콜 및 코어 기술 참고 자료를 읽어 보세요.
v2rayN은 데스크톱에서 서버와 구독 그룹, 라우팅을 관리하는 데 중점을 두어 여러 연결을 한곳에서 관리하려는 사용자에게 적합합니다. v2rayNG는 Android용 그래픽 인터페이스를 제공하며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 생태계 기반의 Android 대안입니다. 세 프로젝트 모두 소스 코드를 공개하며, 구체적인 라이선스는 각 프로젝트에 포함된 라이선스를 확인하세요. 클라이언트와 통합된 코어는 서로 다른 라이선스를 사용할 수 있으므로 전체 생태계를 하나의 라이선스로 묶어 설명하는 것은 적절하지 않습니다.
오픈 소스는 구현을 살펴보고 변경 사항을 추적하는 데 도움이 되지만, 모든 설정이 자동으로 안전하게 작동한다고 보장하지는 않습니다. 구독 출처와 서버 관리 방식, 기기 권한은 각각 별도로 확인해야 합니다. 이 사이트는 클라이언트 다운로드 링크와 사용 안내를 제공할 뿐, 위 프로젝트의 개발팀이 아닙니다. 사이트 이름이 해당 프로젝트의 공식 조직과 제휴 관계를 의미하지도 않습니다. 연결 서비스를 사용하기 전에 적절한 이용 권한이 있는지 확인하고 적용되는 규정을 준수하세요.
클라이언트 업데이트는 주로 화면과 가져오기 로직, 관리 기능에 영향을 줍니다. 코어 업데이트는 실제 프로토콜 구현을 바꾸고, 구독 업데이트는 서버 항목을 다시 가져옵니다. 하나를 업데이트해도 나머지가 함께 업데이트되는 것은 아닙니다. 새 형식의 링크를 인식하지 못한다면 클라이언트를 업데이트해야 할 수 있습니다. 링크는 인식되지만 연결 오류가 발생한다면 구독을 반복해서 업데이트하기보다 코어 로그와 매개변수를 확인하세요. 정상적으로 작동하는 설정은 먼저 백업한 뒤 항목별로 변경하면 문제 해결 과정을 명확히 기록할 수 있습니다.
로그에 표시되는 연결 시간 초과, 도메인 확인 실패, 핸드셰이크 실패는 서로 다른 계층의 문제를 가리킵니다. 시간 초과는 서버 연결 가능 여부와 네트워크 경로를, 확인 실패는 DNS와 도메인을, 핸드셰이크 실패는 시간 설정과 전송 보안, 인증 매개변수를 확인하세요. 모든 오류를 ‘노드가 끊겼다’고 단정하지 마세요. 흔히 발생하는 V2Ray 연결 문제, 지연 시간 테스트 오류, 속도 테스트 결과 차이는 각 문제 안내에서 확인할 수 있습니다.
최근 게시일 순으로 정렬했습니다. 먼저 링크와 설정 구조를 이해한 뒤 프로토콜 원리를 살펴보세요. 게시일 순서대로 읽을 필요는 없습니다.
인바운드, 아웃바운드, 라우팅, 로그의 네 부분으로 나눠 설정을 설명하고, 각 항목이 클라이언트 화면의 어디에 해당하는지 안내합니다. 연결을 가져올 수 있고 실행 설정을 더 깊이 이해하고 싶은 사용자에게 적합합니다. 먼저 요청 하나가 로컬 수신 포트로 들어와 규칙과 일치한 뒤 출구로 전달되는 과정을 따라가 보세요. 모든 매개변수를 한꺼번에 외울 필요는 없습니다.
글 읽기 →공유 링크는 연결 하나를 설명하고, 구독 주소는 업데이트할 수 있는 설정 출처를 제공합니다. 각각 다른 메뉴로 가져와야 합니다. 이 글에서는 인코딩 구조와 업데이트 방식을 소개하고 v2rayN, v2rayNG에서 클립보드와 구독 그룹으로 가져오는 방법을 설명합니다. 붙여넣은 뒤 항목이 표시되지 않으면 먼저 어떤 종류의 링크인지 확인하세요.
글 읽기 →TLS 중첩 처리에 따른 오버헤드를 중심으로 Vision 흐름 제어와 REALITY 핸드셰이크가 각각 해결하는 문제, 함께 사용할 때 확인해야 할 항목을 설명합니다. 단일 메커니즘이 속도를 보장한다고 단정하지 않고 설계상의 선택과 설정 방법을 다룹니다. 기본적인 연결 경험을 쌓은 뒤 읽으면 프로토콜과 전송 보안, 흐름 제어의 차이를 이해하기 쉽습니다.
글 읽기 →