CLIENT / PLATFORM
Mac, Windows, Linux 데스크톱에서는 v2rayN을 사용하고, Android에서는 먼저 v2rayNG를 확인한 뒤 커널에 따라 v2flyNG를 고려하세요. 클라이언트는 서버 정보를 관리하고 기기의 프록시 설정을 제어하며, 실제 연결은 커널이 처리합니다. 클라이언트를 설치해도 서버가 자동으로 제공되지는 않습니다. 시작하기 전에 신뢰할 수 있는 출처의 구독 링크나 완전한 서버 연결 정보를 준비해야 합니다.
다운로드는 운영체제별로 구분되어 있습니다. 파일명에 '데스크톱 버전'이라고 적혀 있다고 기기에 적합하다고 단정하지 말고, 프로세서 아키텍처와 설치 파일 형식도 확인하세요. 기존 설정이 있다면 업데이트 전에 구독 그룹, 라우팅, 사용자 지정 DNS 설정을 보관하세요. 처음 설치하는 경우 기본 설정에서 시작해 반복해서 확인할 수 있는 연결을 먼저 만든 뒤 규칙을 하나씩 추가하는 것이 좋습니다.
최신 크로스 플랫폼 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 먼저 시스템 요구 사항을 확인하고 원하는 인터페이스를 선택하세요. 두 버전은 메뉴 위치가 다를 수 있지만 구독, 서버, 시스템 프록시가 주요 설정 항목입니다.
설치 후 구독 그룹을 추가하고 서버 목록을 업데이트하세요. 브라우저에서 별도의 프록시 확장 프로그램을 사용하고 있었다면 프록시를 어느 쪽에서 제어할지 먼저 정해야 합니다. 시스템 설정을 바꾼 뒤에도 브라우저가 다른 연결 경로를 계속 사용할 수 있습니다.
Apple 메뉴의 '이 Mac에 관하여'에서 칩을 확인하세요. Apple 칩이면 Apple Silicon 다운로드를, Intel 프로세서이면 Intel 다운로드를 선택합니다. 설치 후 앱을 '응용 프로그램' 폴더로 옮기고 고정된 위치에서 실행하세요.
처음 실행할 때 시스템 경고가 표시되면 파일 출처를 확인한 뒤 시스템 보안 설정 안내에 따라 처리하세요. 네트워크 연결 문제를 확인할 때는 현재 네트워크 서비스의 프록시 상태도 점검하고, 앱을 종료하기 전에는 시스템 프록시가 원래대로 복구되었는지 확인하세요.
v2rayNG는 Xray 커널을 사용하는 Android 클라이언트로 우선 추천됩니다. v2flyNG는 V2Fly 커널을 사용하는 선택지입니다. 대부분의 arm64 기기에서는 해당 아키텍처용 패키지를 고르고, 아키텍처를 확인하기 어렵다면 범용 설치 패키지의 지원 안내를 확인하세요.
구독을 가져온 뒤 내용을 업데이트하고 서버를 선택하세요. 연결을 시작할 때 시스템 VPN 권한을 허용해야 합니다. 다른 VPN 연결 앱이 실행 중이면 현재 연결과 충돌할 수 있습니다. 백그라운드에서 연결이 끊기면 배터리 최적화와 앱의 백그라운드 실행 권한을 먼저 확인하세요.
배포판에 맞춰 deb 또는 rpm을 고른 다음 x64와 arm64 중에서 선택하세요. 그래픽 클라이언트는 데스크톱 환경에 적합합니다. 설치 후 앱이 실행되고 커널이 로드되는지 확인한 뒤 데스크톱 프록시나 TUN 권한을 설정하세요.
데스크톱 환경마다 시스템 프록시 지원 방식이 다릅니다. 브라우저, 명령줄 도구, 독립 실행형 앱이 각자 별도의 프록시 설정을 읽을 수도 있습니다. 따라서 특정 웹페이지가 열린다고 해서 모든 프로그램이 같은 연결 경로를 사용한다고 볼 수는 없습니다.
CONFIGURATION / WORKSPACE
구독은 사용할 수 있는 서버를 결정하고, 라우팅은 요청을 어느 아웃바운드로 보낼지 정하며, 시스템 프록시나 TUN은 어떤 요청을 커널에 전달할지 결정합니다. 서로 연관된 설정이지만 문제를 진단할 때는 구분해야 합니다. 먼저 서버 목록이 정상적으로 로드되는지 확인하고, 다음으로 기기의 트래픽 진입 경로를 점검한 뒤 규칙과 DNS 응답을 확인하세요.
아래 패널에는 클라이언트 화면과 대조할 수 있도록 설정 항목 이름만 표시했습니다. 플랫폼이나 배포 버전에 따라 메뉴 이름이 조금 다를 수 있으니 실제 메뉴는 현재 인터페이스를 기준으로 확인하세요. 항목을 하나씩 바꿀 때마다 결과를 확인해야 여러 설정을 동시에 변경해 원인을 놓치는 일을 줄일 수 있습니다.
구독 링크는 서버 설정을 한곳에서 가져오는 데 사용하며, 단일 공유 링크와는 용도가 다릅니다. 구독 그룹 설정에서 주소를 입력하고 그룹을 저장한 뒤 업데이트해야 서버 목록에 항목이 추가됩니다. 여러 출처를 그룹별로 관리하면 업데이트에 실패한 그룹을 찾기도 쉽습니다. 업데이트 후 목록이 비어 있다면 링크가 온전한지, 구독이 아직 유효한지 먼저 확인한 다음 적절한 업데이트 방식을 선택하세요. 서버 정보를 제공처에 맞춰 갱신할 수 있다는 점은 수동으로 하나씩 추가하는 것보다 편리하지만, 기기의 라우팅 설정까지 자동으로 동기화되지는 않습니다.
더 알아보기: 구독 가져오기 단계 →서버 목록에는 연결 정보가 저장되며, 현재 사용하는 설정은 활성 서버로 지정된 항목입니다. 가져오기가 끝나면 프로토콜, 주소, 포트, 전송 옵션을 확인한 뒤 활성 서버로 설정하세요. 공유 링크를 사용하면 직접 입력할 항목을 줄일 수 있지만, 전송 및 보안 매개변수가 빠짐없이 포함되어 있는지 확인해야 합니다. 목록에 서버가 표시된다고 연결까지 완료된 것은 아닙니다. 서버 선택과 기기의 프록시 모드를 따로 점검하면 앱을 반복해서 삭제하고 다시 설치하는 것보다 문제를 쉽게 찾을 수 있습니다. 여러 기기에서 재사용할 때는 연결 정보와 기기별 수신 설정도 구분해서 관리하세요.
더 알아보기: 서버 설정 확인 →라우팅은 커널에 들어온 요청을 적절한 아웃바운드로 보냅니다. 특정 도메인, 주소 또는 규칙 세트는 직접 연결하고 나머지는 프록시로 보내는 방식이 일반적입니다. 규칙은 순서대로 적용되므로 범위가 좁은 예외 규칙을 포괄적인 규칙보다 앞에 두세요. 규칙을 편집할 때는 지정한 아웃바운드 태그가 실제로 존재하는지, 도메인 전략에 따라 언제 DNS 조회가 이루어지는지 확인해야 합니다. 전역 모드만 전환하는 것과 달리 라우팅 규칙을 사용하면 목적지별로 연결 방식을 다르게 적용할 수 있습니다. 규칙을 추가한 뒤에는 실제로 규칙이 적용되는지 확인하고, 웹페이지가 열리는지만으로 적용 여부를 판단하지 마세요.
더 알아보기: geosite 및 geoip 라우팅 규칙 →시스템 프록시 자동 설정은 현재 시스템에서 지원하는 프록시 설정을 클라이언트로 지정합니다. 시스템 프록시 해제는 관련 설정을 되돌리고, 시스템 프록시 변경 안 함은 현재 상태를 유지합니다. 마지막 옵션은 직접 연결로 전환한다는 뜻이 아닙니다. 시스템 프록시는 보통 시스템 설정을 따르는 브라우저와 앱에 적합하며 모든 프로그램의 트래픽을 처리한다고 볼 수는 없습니다. TUN보다 적용 범위가 명확하므로 기본 연결을 먼저 확인하기 좋습니다. 네트워크를 바꾸거나 클라이언트를 종료한 뒤에는 시스템 프록시가 중지된 로컬 수신 주소를 계속 가리키지 않는지 확인하세요. 남아 있는 설정을 서버 문제로 오인할 수 있습니다.
더 알아보기: 프록시 모드 선택 →TUN은 가상 네트워크 인터페이스를 통해 조건에 맞는 트래픽을 처리하며, 시스템 프록시 설정을 따르지 않는 프로그램에 사용할 수 있습니다. 활성화하기 전에 일반 프록시 연결이 정상인지 확인하고, 클라이언트에 필요한 권한과 다른 네트워크 트래픽 제어 도구의 실행 여부를 점검하세요. 자동 라우팅, 네트워크 스택, DNS 설정은 서로 맞춰야 하므로 여러 옵션을 한꺼번에 변경하지 않는 것이 좋습니다. 시스템 프록시보다 더 넓은 트래픽을 처리하는 만큼 LAN 접속과 네트워크 서비스 간 충돌에 유의해야 합니다. 인터넷 연결이 끊기면 먼저 TUN을 끄고 기본 경로를 복구한 다음 권한, 라우팅, DNS를 차례로 확인하세요.
더 알아보기: TUN 설정 및 권한 →DNS는 도메인을 IP 주소로 변환하므로 조회 요청의 경로가 라우팅 정책과 일치해야 합니다. 직접 연결과 프록시 아웃바운드에 서로 다른 DNS 경로가 필요할 수 있으며, 브라우저의 암호화 DNS가 시스템 설정을 우회하기도 합니다. 설정을 바꿀 때는 정상적으로 작동하는 기본값을 유지하고, DNS 조회 실패나 규칙 적용 문제가 명확할 때만 조정하세요. DNS 서버 주소 하나만 바꾸기보다 쿼리 전략, 연결 경로, 앱 자체 설정을 함께 확인하는 편이 정확합니다. 문제를 확인할 때는 도메인 조회 결과와 연결 로그를 모두 살펴보고, 인증서 오류나 서버 연결 불가를 DNS 문제로 잘못 판단하지 않도록 하세요.
더 알아보기: DNS 설정 및 문제 해결 →QUICKSTART / THREE STEPS
처음 설정할 때는 연결 경로 하나를 확실하게 구성하는 데 집중하세요. 데스크톱에서는 v2rayN 메뉴를, Android에서는 v2rayNG의 구독 메뉴를 이용합니다. 두 클라이언트의 메뉴 위치는 다르지만 연결 정보를 확인하고 테스트하는 방법은 비슷합니다.
먼저 완전한 구독 주소를 준비하세요. 복사할 때 공백, 줄바꿈, 설명 문구가 포함되지 않도록 주의합니다. v2rayN에서는 구독 그룹 설정에 주소를 저장한 다음 업데이트를 실행해야 합니다. v2rayNG에서는 구독 그룹 관련 메뉴에서 주소를 추가한 뒤 구독 내용을 업데이트하세요. 받은 것이 구독이 아니라 단일 프로토콜 공유 링크라면 공유 링크 가져오기 기능을 사용해야 합니다. 구독 링크로 취급해 반복해서 업데이트하지 마세요.
목록이 로드되면 그룹, 메모, 프로토콜을 확인하세요. 구독 주소에 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷에 노출하거나 출처가 불분명한 온라인 변환 사이트에 붙여 넣지 마세요. 업데이트에 실패하면 주소 형식, 네트워크 연결, 구독 제공처의 응답 중 어떤 문제인지 오류 내용을 먼저 확인해야 합니다. 구독 제공처에 연결할 수 있는지 확인한 뒤에야 프록시 모드 점검이 의미가 있습니다.
사용할 서버를 활성 설정으로 지정한 다음 시스템 프록시나 TUN을 선택하세요. 데스크톱에서 처음 테스트할 때는 권한과 가상 인터페이스의 영향을 줄일 수 있도록 시스템 프록시를 먼저 사용하는 것이 좋습니다. Android에서는 연결을 시작할 때 시스템 안내에 따라 VPN 권한을 허용하세요. 라우팅 모드는 커널에 들어간 트래픽의 처리 방식을 정하며, 시스템 프록시 사용 여부와는 별개의 설정입니다.
특정 앱만 연결되지 않는다면 해당 앱이 시스템 프록시를 따르는지, 자체 프록시나 별도 DNS를 사용하는지 먼저 확인하세요. 앱 하나의 문제를 해결하려고 모든 트래픽 처리 옵션을 바로 켜지 마세요. TUN이 필요하다면 안내에 따라 권한, 라우팅, LAN 접속을 점검하세요. 다른 네트워크 연결 도구를 사용 중인 경우에도 각 도구가 처리하는 트래픽 범위를 먼저 확인해야 합니다.
접속 가능한 것으로 확인된 웹사이트를 열고 클라이언트 로그에서 커널이 시작되었는지, 요청이 예상한 아웃바운드로 전달되었는지 확인하세요. 테스트 도구는 테스트 당시의 대상과 네트워크 상태만 보여주므로 실제 앱에서의 연결 확인을 대신할 수 없습니다. 라우팅 규칙도 직접 연결해야 하는 대상과 프록시를 거쳐야 하는 대상을 각각 테스트해 예외 규칙이 앞선 포괄 규칙에 가려지지 않았는지 확인하세요.
테스트가 끝나면 연결을 끄고 일반 네트워크가 복구되었는지 확인하세요. 클라이언트를 종료한 뒤 모든 웹페이지가 열리지 않는다면 시스템 프록시에 로컬 수신 주소가 남아 있는지 먼저 살펴보세요. 문제가 생기면 오류 문구와 작업 순서를 기록하고 설정은 한 번에 하나씩 변경하세요. 서버를 계속 바꾸는 것보다 서버 장애, 기기의 트래픽 처리 문제, DNS 조회 문제를 구분하기 쉽습니다.
PROJECT V / CORES / CLIENTS
클라이언트는 설정을 관리하고, 커널은 연결을 처리하며, 프로토콜은 통신 방식을 정의합니다. 이 세 계층을 이해하면 호환성, 업데이트 범위, 문제 발생 지점을 파악할 수 있습니다.
구독, 서버, 프록시 모드 및 설정 메뉴
인바운드, 아웃바운드, 전송, 라우팅 및 도메인 조회
Project V는 V2Ray의 기술적 배경을 이해하는 데 중요한 출발점입니다. V2Ray는 로컬 트래픽 진입, 원격 연결, 라우팅 처리를 별도 모듈로 나누므로 설정 파일에 inbounds, outbounds, routing 등의 구조가 포함됩니다. V2Fly 커뮤니티는 V2Ray의 유지 관리와 발전을 이어가지만, 관련 구현체가 특정 데스크톱 앱과 같은 것은 아닙니다.
사용자가 인터페이스에서 서버를 저장하고 라우팅을 변경하면 클라이언트가 이를 커널에 필요한 설정으로 변환하는 경우가 많습니다. 오른쪽 첫 화면의 창은 인바운드 포트, 아웃바운드 태그, 규칙 간의 관계를 보여주는 설정 일부이며, 그대로 연결할 수 있는 완전한 설정이 아닙니다. 실제로 연결하려면 서버 주소와 인증 정보, 일치하는 전송 매개변수도 필요합니다.
Xray는 V2Ray에서 파생된 기술을 바탕으로 같은 프록시 생태계 안에서 발전한 또 다른 커널입니다. 공통 개념이 있지만 기능과 설정 방식에는 차이가 있습니다. 프로토콜 이름이 같다고 해서 모든 전송 방식, 보안 옵션, 확장 필드를 서로 그대로 사용할 수 있는 것은 아닙니다. 클라이언트 인터페이스와 실제로 사용하는 커널이 해당 기능을 지원하는지 함께 확인하세요.
VLESS, VMess, Trojan, Shadowsocks는 서로 다른 연결 방식을 설명합니다. 실제 사용 가능 여부는 서버 설정과 로컬 구현에 달려 있습니다. 구독으로 매개변수를 가져올 수는 있지만 지원하지 않는 기능을 새로 추가할 수는 없습니다. 클라이언트를 선택할 때는 커널 이름만 비교하기보다 실제 연결 요구 사항, 플랫폼, 사용 환경을 먼저 확인하세요.
v2rayN은 Windows, macOS, Linux용 오픈소스 데스크톱 클라이언트로 서버 관리, 구독 업데이트, 기기의 프록시 설정 등을 담당합니다. 데스크톱 인터페이스와 커널은 별개의 구성 요소입니다. 인터페이스에서 지원하는 설정과 호출할 수 있는 커널은 해당 버전의 릴리스 안내를 확인하세요. Mac 사용자는 칩에 맞는 설치 파일을 선택한 다음 공통된 구독 및 라우팅 설정 방법을 적용하면 됩니다.
v2rayNG는 Xray 커널을 사용하는 오픈소스 Android 클라이언트이고, v2flyNG는 V2Fly 커널을 사용하는 오픈소스 Android 대안입니다. 두 앱은 일부 사용 방법이 비슷하지만 메뉴, 설정 지원, 업데이트 일정이 같다고 볼 수는 없습니다. 세 클라이언트는 각각 별도의 오픈소스 라이선스를 따르며, 클라이언트와 커널, 함께 제공되는 리소스의 라이선스도 따로 확인해야 합니다. 프로젝트 이름 하나로 모든 구성 요소의 라이선스를 대신할 수는 없습니다.
오픈소스 프로젝트는 각 커뮤니티에서 관리하며 클라이언트와 커널은 서로 다른 시점에 업데이트될 수 있습니다. 클라이언트 업데이트가 서버 매개변수의 변경을 뜻하지 않으며, 구독을 업데이트해도 기기의 DNS와 라우팅 규칙이 자동으로 이전되지는 않습니다. 먼저 어떤 구성 요소를 업데이트하는지 구분한 뒤 설정 내보내기, 커널 재시작, 시스템 권한 재확인이 필요한지 판단하세요.
안정적으로 작동하는 설정을 기록해 두고, 업데이트 전에는 설정 변경 사항을 확인한 뒤 업데이트 후 구독, 활성 서버, 라우팅, 종료 후 복구 상태를 점검하세요. 이 사이트는 다운로드 경로와 중국어 사용 안내를 제공하며 서버나 구독 서비스는 운영하지 않습니다. 구독의 유효 기간과 사용 범위, 연결 매개변수는 해당 제공처에서 결정합니다. 설정을 캡처하거나 공유할 때는 주소, 인증 정보, 개인 정보를 가리세요.
NOTES / CONFIGURATION
기본 연결을 완료한 다음 여러 기기에서의 사용과 고급 네트워크 설정을 다루세요. 기술 노트에서는 각 문제를 구체적으로 설명하고 설정의 영향 범위, 조작 방법, 확인 절차를 안내합니다. 서버 매개변수, 클라이언트 설정, 시스템 네트워크 설정을 한데 섞지 않도록 구성했습니다.
중국 본토에서는 직접 연결하고 해외에서는 프록시를 사용하는 경우를 예로 들어 geosite·geoip 규칙 작성법, domainStrategy 선택, 규칙 순서에서 자주 발생하는 실수를 설명합니다.
가이드 읽기 →Mac, Windows, Linux, Android 기기 간에 서버와 라우팅 설정을 동기화하는 몇 가지 방법을 비교하고, 각각의 사용 상황과 유의 사항을 살펴봅니다.
가이드 읽기 →v2rayN에서 LAN 연결을 활성화하는 방법, 수신 주소와 포트의 의미, macOS 방화벽 허용 방법, 다른 기기에서 프록시를 수동으로 설정하는 방법을 안내합니다.
가이드 읽기 →