화면 예시: 구독 그룹은 주소를 관리하고 라우팅 규칙은 아웃바운드를 선택합니다. 구성 요소를 겹쳐 배치한 것은 설정 간 관계를 나타내며, 클라이언트에서 드래그 앤 드롭하는 동작을 의미하지 않습니다.
설정 패널 살펴보기
먼저 클라이언트에서 서버 설정을 가져온 다음, 앱 트래픽이 어떤 경로로 클라이언트에 들어오고 어떤 아웃바운드로 전송될지 정합니다. 구독 업데이트에 성공했다는 것은 설정을 가져왔다는 뜻일 뿐, 시스템 프록시가 켜졌다는 의미는 아닙니다. 프록시 모드를 바꿔도 만료된 구독 주소가 복구되지는 않습니다. 아래 네 항목은 각각 설정 출처, 매칭 규칙, 앱의 진입 경로, 가상 네트워크 어댑터에 해당합니다. 문제를 확인할 때는 각 계층을 차례로 살펴보고 모든 설정을 한꺼번에 바꾸지 마세요.
v2rayN의 ‘구독 그룹 설정’에서 새 그룹을 만들고 알아보기 쉬운 별칭과 전체 구독 주소를 입력하세요. 저장한 뒤 ‘구독 업데이트’를 실행하고 서버가 목록에 표시되는지 확인한 다음 사용할 서버를 선택합니다. 자동 업데이트 간격은 분 단위이므로 먼저 수동 업데이트가 정상적으로 되는지 확인하세요. 구독 주소는 설정을 가져오는 데 사용하고, 단일 공유 링크는 설정 하나를 가져오는 데 사용하므로 서로 혼동하지 마세요. 서버를 하나씩 직접 입력하는 것보다 구독 그룹을 업데이트하는 편이 서버 변경 사항을 계속 동기화하기 쉽습니다. 다만 업데이트만으로 연결 테스트를 대신할 수는 없으며 서버 측 설정이 자동으로 수정되지도 않습니다.
가이드 보기 →라우팅은 연결을 직접 연결, 프록시 또는 차단 중 어떤 방식으로 내보낼지 결정합니다. ‘라우팅 설정’에 들어가 현재 활성화된 규칙 세트를 확인한 다음 규칙 순서를 살펴보세요. 위쪽 규칙과 이미 일치한 연결은 보통 뒤쪽의 포괄적인 규칙에서 다시 처리되지 않습니다. 예시의 geosite:cn은 도메인 목록을, direct는 직접 연결 아웃바운드를 뜻하며 구독 주소의 일부가 아닙니다. 모든 연결을 하나의 아웃바운드로 보내는 대신 대상별로 나눠 처리할 수 있지만, 규칙 데이터와 매칭 조건이 올바르게 설정되어야 합니다. 설정을 바꿀 때는 한 번에 하나씩 변경하고 같은 대상으로 다시 테스트하세요.
가이드 보기 →프록시 진입 경로와 라우팅 규칙은 별개의 설정입니다.
데스크톱에서 ‘시스템 프록시 자동 설정’을 선택하면 로컬 프록시 주소가 시스템 설정에 등록되어 해당 설정을 따르는 앱에서 사용됩니다. ‘시스템 프록시 지우기’는 이 주소를 삭제하고, ‘시스템 프록시 변경 안 함’은 현재 설정을 그대로 유지합니다. 이 설정은 라우팅을 전체 프록시로 바꾸는 것과 다릅니다. 시스템 프록시는 트래픽이 클라이언트로 들어올지를 정하고, 라우팅은 들어온 트래픽의 아웃바운드를 정합니다. TUN보다 시스템 프록시가 브라우저 같은 일반 앱을 먼저 테스트하기에 적합하며, 필요한 권한과 트래픽 처리 범위도 다릅니다. 특정 앱에서 적용되지 않으면 먼저 해당 앱이 시스템 프록시를 사용하는지 확인하세요.
가이드 보기 →권한 확인 → DNS 확인 → 앱 연결 테스트
TUN은 가상 네트워크 어댑터로 지정된 네트워크 트래픽을 받아 시스템 프록시를 사용하지 않는 앱에도 적용할 수 있습니다. 사용 전에 일반 프록시 방식으로 서버 설정이 정상인지 확인한 뒤 플랫폼 안내에 따라 필요한 권한을 부여하세요. 시스템 프록시보다 라우팅과 DNS에 관여하는 범위가 넓어 다른 가상 네트워크 어댑터나 네트워크 도구와 충돌할 수 있습니다. 연결에 문제가 생기면 먼저 TUN을 끄고 비교 테스트를 하면서 로그에 표시된 오류를 기록하세요. 구독, 서버 프로토콜, 네트워크 어댑터 설정을 동시에 바꾸지 마세요. 데스크톱과 Android의 권한 설정 위치는 다르므로 해당 플랫폼 안내를 따르세요.
가이드 보기 →운영체제별 안내
데스크톱에서는 v2rayN을 선택하고, Android에서는 v2rayNG를 먼저 살펴보세요. 기존에 V2Fly 설정을 사용하고 있다면 v2flyNG도 확인할 수 있습니다. 다운로드 페이지에서 프로세서 아키텍처와 설치 패키지 형식을 확인한 뒤 해당 플랫폼 안내를 읽으세요. 클라이언트를 설치한 뒤에도 유효한 구독이나 서버 설정이 필요하며, 설치 패키지에 바로 사용할 수 있는 원격 서비스가 포함되어 있지는 않습니다.
데스크톱 GUI에서 구독을 관리하고 서버를 전환하거나 라우팅을 설정하려는 경우에 적합합니다. 다운로드 페이지에는 데스크톱 버전과 클래식 WPF 버전이 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 환경을 유지합니다. 시스템 요구 사항과 실행 환경, 기존 사용 경험을 기준으로 선택하고 두 인터페이스의 설정 경로를 혼동하지 마세요.
처음 실행하면 로그에서 의존성 누락이나 포트 사용 중 메시지가 있는지 확인한 뒤 구독을 가져오세요. 설정 파일은 정상적으로 쓸 수 있는 위치에 두고, 업그레이드 전에 클라이언트를 종료한 다음 기존 설정을 백업하세요. 클라이언트를 종료한 뒤에도 브라우저에서 프록시 연결 오류가 표시된다면 서버를 전부 삭제하기보다 시스템 프록시가 이미 종료된 로컬 포트를 가리키고 있는지 확인하세요.
데스크톱에서 구독 그룹과 프록시 설정을 한곳에서 관리하기에 적합합니다. 먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하세요. Apple 칩에는 Apple Silicon 버전을, Intel 프로세서에는 Intel 버전을 선택합니다. 두 설치 패키지는 서로 다른 아키텍처용이므로 파일 크기만 보고 선택하거나 다른 운영체제의 설치 방법을 그대로 따라 해서는 안 됩니다.
설치 후 일반 프록시 연결을 확인한 다음 TUN을 고려하세요. 시스템 프록시 적용 여부는 현재 네트워크 서비스와 앱 자체 설정에도 영향을 받으며, 터미널 프로그램이 데스크톱 프록시를 자동으로 사용하는 것은 아닙니다. 시스템 보안 경고가 표시되면 설치 안내에서 출처와 처리 방법을 확인하고, 문제를 피하려고 시스템 보호 기능을 무작정 끄지 마세요. 네트워크를 바꾼 뒤에는 DNS와 프록시 진입 경로를 다시 확인하세요.
v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하며 다운로드 페이지에는 이 순서로 두 클라이언트가 나열되어 있습니다. 최근 출시된 스마트폰 대부분은 arm64 패키지를 선택할 수 있습니다. 기기 아키텍처를 모르겠다면 시스템 정보를 확인한 뒤 범용 버전 사용 여부를 판단하세요. 프로토콜과 전송 방식은 서버 설정에 맞아야 하며 클라이언트 이름이 비슷하다고 설정을 그대로 공유할 수 있는 것은 아닙니다.
구독을 가져와 업데이트한 뒤 서버를 선택하고 연결을 시작한 다음 시스템 VPN 권한을 확인하세요. 앱을 백그라운드로 보냈을 때 연결이 끊기면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 일부 앱만 프록시를 거치지 않는다면 앱별 프록시 설정을 살펴보세요. 시스템에서는 보통 VPN 서비스를 하나만 활성화할 수 있으므로 다른 유사 도구를 동시에 켜면 현재 연결이 대체될 수 있습니다. 우선 클라이언트 하나만 켜고 테스트하세요.
GUI가 있는 배포판에서 구독과 라우팅을 관리하려는 경우에 적합합니다. 배포판에 맞춰 deb 또는 rpm을 선택하고 x64와 arm64 아키텍처를 확인하세요. 패키지 형식은 설치 방식을, 프로세서 아키텍처는 실행할 하드웨어를 나타내므로 두 조건이 모두 맞아야 합니다. 데스크톱 환경과 시스템 구성 요소, 권한 정책은 배포판마다 다르며 설치에 성공해도 모든 프로그램에서 시스템 프록시를 자동으로 사용하는 것은 아닙니다.
먼저 클라이언트에서 코어가 실행되고 로컬 수신 포트를 사용할 수 있는지 확인한 뒤 브라우저로 연결을 테스트하세요. 터미널 프로그램, 샌드박스 앱, 데스크톱 앱은 서로 다른 프록시 설정을 사용할 수 있으므로 각각 확인해야 합니다. TUN을 켜기 전에 권한 안내를 읽고 기존 가상 네트워크 어댑터 규칙과 충돌하지 않도록 하세요. 업데이트 후 문제가 생기면 배포판, 데스크톱 환경, 로그 오류를 기록하고 플랫폼별 안내에 따라 최근 변경 사항을 하나씩 되돌려 보세요.
하나의 구독에 여러 프로토콜 설정이 포함될 수 있습니다. 사용할 수 있는지는 설치 패키지 이름이 아니라 클라이언트가 실제로 사용하는 코어와 해당 코어의 기능에 따라 달라집니다. 기기를 바꾼 뒤에는 시스템 권한, 프록시 진입 경로, 로컬 포트를 다시 확인하세요. 같은 구독을 가져와도 기기별 로컬 설정까지 자동으로 동일해지지는 않습니다.
전체 클라이언트 보기 →오픈 소스 생태계와 설정 범위
GUI 클라이언트, 프록시 코어, 원격 서버는 서로 다른 계층입니다. 클라이언트는 메뉴와 설정 관리를 제공하고, 코어는 프로토콜 처리와 트래픽 전달을 담당하며, 서버는 원격 연결 지점을 제공합니다. 이 세 계층을 구분해야 설치, 설정 호환성, 앱 트래픽 처리, 원격 연결 중 어디에서 문제가 생겼는지 파악할 수 있습니다.
Project V는 네트워크 통신 도구를 중심으로 형성된 프로젝트 생태계이며, V2Ray는 그 핵심 프로젝트입니다. V2Fly는 커뮤니티의 V2Ray 유지 관리와 개발을 이어가고 있습니다. Xray는 V2Ray에서 출발한 뒤 독자적인 기능 개발 방향을 갖추었습니다. 일상적으로 말하는 ‘V2Ray 클라이언트’는 이 생태계의 GUI 도구를 통칭하는 경우가 많습니다. 그렇다고 모든 클라이언트가 같은 코어를 사용하거나 설정 항목이 완전히 동일하다는 뜻은 아닙니다.
가이드를 읽을 때는 먼저 클라이언트 이름을 확인하고 실제 사용 중인 코어를 파악하세요. 서버에서 특정 프로토콜, 전송 방식, 보안 설정을 요구한다면 실제 지원 여부를 확인해 입력해야 합니다. 특히 VLESS와 REALITY 설정은 코어의 기능과 서버 매개변수를 먼저 확인하세요. 필드 이름을 임의로 바꾸는 것만으로 호환성을 확보할 수는 없습니다. 구독을 가져오면 설정이 클라이언트에 전달되어 해석될 뿐, 해당 매개변수를 지원하는 코어가 필요합니다.
v2rayN은 데스크톱 플랫폼용 오픈 소스 GUI 클라이언트로 서버 관리, 구독 업데이트, 라우팅 및 프록시 설정을 지원합니다. 사용할 수 있는 코어와 기능은 설치 패키지 및 현재 설정에 따라 다릅니다. v2rayNG는 Xray 코어를 사용하는 Android용 오픈 소스 클라이언트입니다. v2flyNG도 Android용이며 V2Fly 코어를 사용하므로 관련 설정이 필요한 경우에 적합합니다. 기기 플랫폼과 설정 호환성을 기준으로 클라이언트를 선택하세요.
이 세 도구는 구독 서비스 자체가 아닙니다. 클라이언트 다운로드, 구독 주소 발급, 원격 서비스 이용 가능 여부는 각각 별개의 문제입니다. 클라이언트를 바꿔도 구독 유효 기간이 자동으로 연장되거나 서버의 트래픽 및 연결 제한이 달라지지는 않습니다. 구독을 업데이트해도 서버가 표시되지 않으면 그룹 주소와 업데이트 결과를 확인하세요. 서버 목록은 있지만 연결되지 않는다면 선택한 설정, 프로토콜 매개변수, 로그를 확인하세요. 같은 주소를 반복해서 가져오기보다 문제 계층을 좁혀 살펴보는 편이 효과적입니다.
오픈 소스란 해당 라이선스에 따라 코드가 공개되어 있다는 의미이며, 사용·수정·배포 시에는 프로젝트의 라이선스 조건을 따라야 합니다. V2Fly의 V2Ray 코어는 MIT 라이선스를, Xray-core는 MPL-2.0을 사용합니다. 클라이언트에는 별도의 라이선스 안내가 있으므로 코어 라이선스를 설치 패키지와 모든 종속 구성 요소에 그대로 적용해서는 안 됩니다. 재배포하거나 수정할 때는 클라이언트, 코어, 포함된 구성 요소의 라이선스를 각각 확인하세요.
커뮤니티 유지 관리로 버그 수정과 기능 개발이 이어지지만, 오픈 소스라고 해서 실제 설정 점검이 필요 없다는 뜻은 아닙니다. 구독 주소에는 접근 자격 정보가 포함되는 경우가 많으므로 스크린샷을 공유하기 전에 전체 주소와 사용자 식별 정보, 민감한 매개변수를 가리세요. 문제를 확인할 때는 메뉴 위치, 오류 유형, 이미 시도한 작업을 우선 제공하고 자격 정보가 포함된 설정 파일 전체를 공개하지 마세요. 사이트의 예시 주소는 필드 형식을 설명하기 위한 것이며 실제 서비스에 사용할 수 없습니다.
구독을 업데이트하면 서버 설정을 다시 가져옵니다. 클라이언트를 업데이트하면 GUI와 함께 제공되는 구성 요소가 변경됩니다. 라우팅 데이터를 업데이트하면 도메인 목록이나 주소 목록의 매칭 결과가 달라집니다. 각 작업은 서로 다른 대상을 처리합니다. 연결에 문제가 있다고 세 가지를 한꺼번에 업데이트하면 원격 설정, 코어 동작, 라우팅 결과 중 무엇이 원인인지 파악하기 어렵습니다. 현재 설정을 보존하고 오류를 기록한 뒤 문제에 맞는 업데이트만 선택하세요.
클라이언트를 업그레이드하기 전에 실행 중인 프로그램을 종료하고 구독 그룹과 사용자 지정 라우팅 규칙을 백업하세요. 업그레이드 후에는 기존에 연결되던 서버부터 확인한 다음 새 기능을 테스트합니다. 구독 자동 업데이트 간격은 실제 사용 빈도와 서비스 제공자 요구에 맞추세요. 자주 요청한다고 이용 가능성이 높아지는 것은 아니며 요청 제한이 적용될 수 있습니다. 구독 주소가 이미 만료되었다면 간격을 조정해도 복구되지 않으므로 먼저 주소 문제를 해결해야 합니다.
서버 테스트에 결과가 나와도 모든 앱이 프록시를 거친다는 뜻은 아닙니다. 먼저 브라우저로 대상에 접속해 보고, 클라이언트 로그에 해당 연결이 표시되는지 확인한 다음 라우팅 결과가 예상과 맞는지 살펴보세요. 실제 연결 테스트, TCPing, 웹페이지 로딩은 서로 다른 구간을 확인하므로 테스트 숫자 하나만으로 전체 연결 상태를 판단해서는 안 됩니다. 네트워크 변경, DNS 캐시, 대상 사이트 상태도 결과에 영향을 줄 수 있습니다.
특정 앱 하나만 실패한다면 앱 자체의 프록시 옵션과 트래픽 처리 범위를 먼저 확인하세요. 모든 앱에서 실패한다면 코어가 실행 중인지, 서버가 선택되었는지, 로컬 포트가 수신 대기 중인지 확인합니다. 전체 프록시가 필요하더라도 ‘앱 트래픽을 프록시로 보내는 것’과 ‘들어온 연결을 프록시 아웃바운드로 보내는 것’은 구분해야 합니다. 전자는 보통 시스템 프록시나 TUN이, 후자는 라우팅 규칙이 결정합니다. 구체적인 설정 순서는 입문 가이드를 참고하고, 플랫폼별 권한 차이는 사용 설명서에서 확인하세요.
설정 가이드
현재 겪는 문제에 맞는 항목부터 확인하세요. 서버 목록이 없다면 구독 가져오기를, 클라이언트가 제대로 실행되지 않는다면 최초 설치를 먼저 살펴보세요. 연결은 되지만 서버를 고르고 싶다면 노드 테스트와 선택 방법을 확인하세요. 서버, 프록시 모드, 라우팅 규칙을 동시에 바꾸지 말고 매번 확인할 항목을 하나씩 정하세요.
데스크톱의 구독 그룹 설정 경로와 Android의 구독 그룹 메뉴 경로를 각각 안내하고 Base64 구독, 단일 공유 링크, 클립보드 가져오기의 차이를 설명합니다.
압축 해제 위치, 런타임 종속성, 최초 실행 시 코어 선택, 로컬 수신 포트, 시스템 프록시 모드를 다룹니다. 처음 실행할 때 갑자기 종료되거나 프록시를 설정할 수 없는 문제의 해결 방법도 정리했습니다.
실제 연결 지연 시간과 TCPing의 차이, 트래픽 배수가 데이터 사용량 계산에 미치는 영향, 사용 목적에 맞는 지역 선택, 네트워크 환경에 따른 VLESS·VMess·Trojan 선택 방법을 설명합니다.
