설정이 적용되는지는 가져온 내용, 트래픽 유입 경로, 아웃바운드 규칙이 서로 맞는지에 달려 있습니다. 각 계층의 역할을 먼저 파악한 뒤 세부 매개변수를 조정하세요.
v2rayN의 구독 그룹을 사용하면 출처가 다른 연결 설정을 나누어 관리할 수 있습니다. 먼저 그룹을 추가하고 구독 주소를 입력한 다음 해당 그룹을 업데이트해, 출처가 불분명한 항목이 기존 목록에 섞이지 않도록 하세요. 구독에는 보통 서버 연결 매개변수가 포함되지만 데스크톱의 시스템 프록시, TUN, 사용자 지정 라우팅 설정까지 제공된다는 보장은 없습니다. 업데이트 후에는 목록에 항목이 생겼는지만 볼 것이 아니라 프로토콜, 전송 방식, 보안 매개변수를 확인해야 합니다. 연결 공유 링크를 하나씩 붙여넣는 방식보다 구독 그룹을 이용하면 업데이트가 편리하지만, 직접 수정한 항목은 업데이트 과정에서 덮어써질 수 있으므로 중요한 변경 사항은 따로 기록해 두세요.
https://example.com/subscription출처와 형식을 먼저 확인한 다음 서버 목록을 업데이트하세요.
라우팅은 규칙 순서에 따라 아웃바운드를 결정합니다. 범위가 좁은 예외 규칙은 대개 포괄적인 규칙보다 앞에 두어야 합니다. 로컬 네트워크 주소의 직접 연결, 지정 도메인의 프록시 연결, 기본 아웃바운드를 각각 확인하세요. 프리셋 이름만으로 실제 동작을 판단해서는 안 됩니다. 도메인 규칙은 요청에 일치 여부를 판단할 도메인 정보가 남아 있어야 하며, IP 규칙은 대상 주소와 도메인 해석 정책에 따라 결과가 달라집니다. 모든 트래픽을 기본 아웃바운드에 맡기는 방식보다 사용자 지정 규칙이 세부 요구를 표현하기 좋지만, 변경 이유를 기록해 둘 필요도 커집니다. 문제를 확인할 때는 먼저 일치한 첫 규칙을 찾고, 해당 규칙이 가리키는 아웃바운드가 있는지 확인하세요. 조건이 같은 규칙을 중복 추가하지 않도록 주의해야 합니다.
geosite:category-ads-all → block
geoip:private → direct
geosite:cn → direct
geoip:cn → direct
기본 규칙 → proxy시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에 주로 적용되므로, 처음 설정할 때 시작점으로 적합합니다. 일부 터미널 도구나 자체 네트워크 설정을 사용하는 앱은 프록시를 별도로 지정해야 합니다. TUN은 가상 네트워크 어댑터를 통해 라우팅 범위에 포함된 트래픽을 처리합니다. 적용 범위는 시스템 라우팅, 제외 규칙, 권한 상태에 따라 달라지며, 켰다고 해서 모든 요청이 프록시를 통과하는 것은 아닙니다. 시스템 프록시와 달리 TUN은 DNS, 로컬 네트워크 접근, 다른 가상 네트워크 어댑터와의 충돌도 고려해야 합니다. 먼저 시스템 프록시 모드에서 연결을 확인한 다음 TUN을 활성화하고, 문제가 생기면 되돌릴 수 있도록 기본 설정을 보존하세요.
로컬 수신 포트: 10808. 실제 설정을 기준으로 확인하세요.
GUI 클라이언트는 설정을 관리하고, 코어는 설정을 해석해 연결을 구성합니다. 코어를 선택할 때는 프로토콜, 전송 계층, 보안 설정, 라우팅 필드의 지원 범위를 함께 확인해야 합니다. 코어를 바꾸는 것이 모든 문제의 해결책은 아닙니다. 같은 연결 공유 링크라도 코어에 따라 필드 변환이 필요할 수 있으며, 가져오기에 성공했다고 해서 모든 매개변수가 온전히 적용된 것은 아닙니다. 코어 설정을 직접 수정하는 것보다 GUI가 일상적인 관리에 편리하지만, 고급 옵션은 현재 클라이언트의 안내와 대조해야 합니다. 변경 전에 기존 설정을 보존하고 한 번에 하나의 항목만 바꾼 뒤, 시작 로그에서 설정이 올바르게 적용됐는지 확인하세요.
확인 순서: 프로토콜 → 전송 방식 → TLS / REALITY → 라우팅 필드.
로그를 확인할 때는 먼저 코어가 시작됐는지 확인하고, 이어서 요청이 어느 계층에서 실패했는지 살펴보세요. 포트 충돌, 설정 필드 오류, 규칙 리소스 누락은 시작에 영향을 줍니다. 이름 해석 실패, 핸드셰이크 실패, 연결 시간 초과는 대상과 발생 시점을 함께 고려해 분석해야 합니다. 설정을 계속 바꾸기보다 실패 전후의 연속된 로그를 보존하면 원인을 좁히기 쉽습니다. 기본 로그 수준과 설정으로 되돌린 뒤 필요한 경우 잠시 상세 로그를 켜고, 문제를 재현한 후에는 원래대로 복구하세요. 로그를 외부에 공유하기 전에 구독 주소, 인증 정보, 연결을 식별할 수 있는 매개변수를 삭제하고 오류 유형만 남기세요.
시작 설정 → 로컬 수신 → DNS 해석
→ 라우팅 일치 → 아웃바운드 연결
포트 충돌: address already in use
이름 해석 실패: failed to lookup위 화면은 설정 관계를 보여 주며 현재 실행 상태를 나타내지는 않습니다. 포트, 라우팅 프리셋, 코어 선택은 모두 설정 입력값입니다. 연결이 정상인지 판단하려면 앱 요청과 로그도 함께 확인해야 합니다. 데스크톱 환경에 따라 메뉴 위치가 달라질 수 있으므로 화면 위치를 외우기보다 각 옵션의 역할을 이해하는 편이 유용합니다. 처음 사용할 때는 구독 가져오기, 설정 선택, 시스템 프록시 설정만 완료하고 복잡한 분할 라우팅은 잠시 미뤄 두세요.
데스크톱에서는 v2rayN을 사용하고, Android에서는 Xray 코어 기반 v2rayNG를 우선 고려하세요. V2Fly 코어가 필요하다면 v2flyNG를 확인하면 됩니다. 먼저 운영체제를 선택한 뒤 CPU 아키텍처를 확인하세요.
데스크톱 버전은 여러 플랫폼에서 사용할 수 있는 인터페이스를 제공하며, WPF 버전은 클래식한 데스크톱 조작 환경을 유지합니다. 두 버전 모두 운영체제와 실행 환경의 요구 사항을 확인해야 하며, 설치 패키지 이름만으로 호환성을 판단해서는 안 됩니다. 기존 설정을 사용하는 경우 인터페이스 버전을 바꾸기 전에 구독 그룹과 사용자 지정 라우팅을 백업하세요.
처음 사용할 때는 시스템 프록시부터 설정하고 브라우저 접속과 로그가 정상인지 확인한 후 TUN이 필요한지 판단하세요. 설치를 마쳤다고 프록시가 활성화되는 것은 아닙니다. 현재 선택된 설정, 로컬 수신 포트, 앱이 시스템 프록시 설정을 따르는지 확인해야 합니다.
다운로드 Windows 클라이언트Apple 칩에서는 arm64, Intel 프로세서에서는 x64를 선택하세요. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. 아키텍처를 올바르게 선택하면 시작 오류와 의존성 문제를 줄일 수 있습니다. 잘못된 아키텍처로 인한 문제를 구독이나 서버 연결 오류로 오인하지 마세요.
처음 실행할 때 운영체제의 보안 알림과 네트워크 권한을 확인하세요. 시스템 프록시와 TUN은 권한을 부여하는 절차가 다르므로 먼저 기본 연결을 확인한 다음 가상 네트워크 어댑터 관련 설정을 진행하는 것이 좋습니다. 차단 메시지가 표시되면 앱 출처와 운영체제 안내를 확인하고 보안 설정을 여러 개 한꺼번에 변경하지 마세요.
다운로드 macOS 클라이언트v2rayNG는 Xray 코어를 사용하며 Android용으로 우선 고려할 수 있습니다. v2flyNG는 V2Fly 코어를 사용하므로 해당 코어의 동작이 필요한 설정에 적합합니다. 대부분의 arm64 기기에서는 해당 설치 패키지를 선택하고, 아키텍처를 확인하기 어렵다면 범용 패키지 안내를 확인하세요. 파일 크기만 보고 선택하지 마세요.
Android에서는 보통 시스템 VPN 인터페이스를 통해 로컬 트래픽 터널을 구성하므로 시스템 권한, 앱별 설정, 백그라운드 실행 제한을 확인해야 합니다. 데스크톱의 라우팅 프리셋을 휴대폰에 그대로 적용할 수 있다고 볼 수 없습니다. 같은 구독 주소를 사용하더라도 두 기기의 DNS, 분할 라우팅, 트래픽 처리 방식은 다를 수 있습니다.
다운로드 Android 클라이언트Debian·Ubuntu 계열 배포판에서는 보통 deb, Fedora 계열에서는 rpm을 선택하고 x64 또는 arm64 아키텍처도 확인하세요. 패키지 형식과 CPU 아키텍처는 서로 별개의 조건입니다. 둘 중 하나만 맞는다고 설치가 보장되지는 않으므로 배포판의 의존성 요구 사항도 살펴보세요.
데스크톱 환경마다 시스템 프록시 지원이 다르며, 일부 앱은 별도 설정이 필요합니다. 자동 시작을 설정해도 TUN 권한이 준비되는 것은 아닙니다. 먼저 수동으로 실행해 확인한 뒤 데스크톱 자동 시작 항목을 설정하고, 클라이언트를 종료했을 때 시스템 프록시가 정상적으로 복구되는지도 확인하세요.
다운로드 Linux 클라이언트설치 패키지는 클라이언트를 설치하고 구독은 연결 설정을 제공합니다. 두 항목은 별도로 준비해야 합니다. 다운로드 전에 기기 정보를 확인하고, 연결이 실패하면 설정과 로그를 점검하세요. 반복해서 재설치할 필요는 없습니다.
전체 클라이언트 보기 → 세 가지 클라이언트의 사용 범위 비교 →재현 가능한 기본 연결을 먼저 만든 다음 사용자 지정 규칙을 추가하세요. 단계마다 해당 계층의 문제만 확인하면 설정 간 간섭을 줄일 수 있습니다.
운영체제와 아키텍처에 맞게 설치한 다음 매개변수 설정에서 로컬 수신 포트를 기록하세요. 이어서 구독 그룹을 열고 신뢰할 수 있는 출처의 구독 링크를 추가합니다. 업데이트 후에는 항목의 프로토콜, 전송 방식, 보안 설정을 확인하고 실제로 사용할 설정을 선택하세요. 구독 업데이트에 실패하면 주소가 완전한지, 인증이 유효한지, 링크가 구독 데이터 대신 웹페이지 오류를 반환하는지부터 확인하세요.
공유 링크와 구독 링크는 용도가 다릅니다. 공유 링크는 보통 단일 연결을 나타내고, 구독 링크는 여러 항목을 일괄 업데이트하는 데 편리합니다. 인증 정보가 포함된 링크를 공개 댓글, 스크린샷, 변환 서비스에 붙여넣지 마세요. 기존 설정을 이전해야 한다면 먼저 백업한 뒤 덮어쓰거나 다시 가져오세요. 구독 가져오기에 성공한 후에도 사용할 설정을 직접 선택하고 코어가 정상적으로 시작되는지 확인해야 합니다.
데스크톱에서는 시스템 프록시 자동 설정을 먼저 활성화하고 기본 라우팅 프리셋을 사용하되, TUN은 잠시 꺼 두세요. 이렇게 하면 구독 매개변수와 아웃바운드 연결이 정상인지 먼저 확인할 수 있습니다. Android에서는 시스템 안내에 따라 VPN 연결을 허용하고 클라이언트의 앱별 적용 범위를 확인하세요. 시스템 트래픽을 처리하는 도구를 여러 개 동시에 실행하지 마세요. 프록시 설정이 서로 덮어써 생긴 문제를 연결 매개변수 오류로 오인할 수 있습니다.
‘전역’은 보통 클라이언트의 아웃바운드 정책을 뜻하며, 시스템의 모든 앱이 이미 트래픽을 클라이언트로 보내고 있다는 의미는 아닙니다. 먼저 요청이 프록시에 도달하는지 확인한 다음 직접 연결할지 프록시를 사용할지 결정하세요. TUN이 필요하다면 기본 연결이 정상인 것을 확인한 뒤 별도로 활성화하고 관리자 권한, DNS, 로컬 네트워크 제외 항목을 확인하세요. 문제가 생기면 검증이 끝난 시스템 프록시 설정으로 되돌리세요.
프록시가 필요한 앱에서 실제 요청을 보내고 로그를 확인해 코어 시작, 로컬 수신, 아웃바운드 연결 상태를 살펴보세요. 브라우저에서 페이지가 열린다는 것은 현재 경로로 접속할 수 있다는 뜻일 뿐, 터미널이나 게임 등 다른 앱도 같은 프록시를 사용한다고 단정할 수는 없습니다. 반대로 한 번의 연결 시간 초과만으로 클라이언트 전체의 문제라고 볼 수도 없습니다. 대상 서비스, 도메인 해석, 아웃바운드 핸드셰이크를 구분해 확인하세요.
기본 연결 확인을 마친 후 사용자 지정 라우팅을 추가하거나 TUN을 활성화하고 DNS를 조정하세요. 변경 목적과 되돌리는 방법을 매번 기록하면 여러 매개변수를 한꺼번에 바꿔 비교 기준을 잃는 일을 막을 수 있습니다. 사용을 마쳤으면 클라이언트를 정상 종료하고 시스템 프록시가 복구됐는지 확인하세요. 평소에는 모든 스위치를 자주 바꾸기보다 구독 출처, 설정 백업, 오류 로그를 관리하는 것이 중요합니다.
인터페이스는 설정을 관리하고 코어는 이를 실행합니다. 두 계층을 나누어 이해해야 동일한 연결 설정이 기기마다 다르게 작동하는 이유를 파악할 수 있습니다.
Project V는 프록시 통신과 네트워크 설정을 중심으로 형성된 도구 생태계이며, V2Ray는 그중 중요한 프로젝트입니다. 커뮤니티가 발전하면서 V2Fly는 V2Ray 관련 구현을 계속 유지하고, Xray는 관련 코드와 기술적 배경을 바탕으로 독자적인 구현 방향을 발전시켰습니다. 일부 개념을 공유하지만 서로 아무렇게나 바꿔 쓸 수 있는 동일한 프로그램은 아닙니다. 일반적인 검색에서 ‘V2Ray 클라이언트’는 폭넓은 의미로 쓰이기도 합니다. 실제로 다운로드할 때는 GUI 클라이언트와 사용하는 코어를 확인하세요.
이 관계를 이해하면 인터페이스 옵션의 위치, 설정 문법의 지원 여부, 서버 매개변수의 일치 여부라는 세 가지 문제를 구분하기 쉽습니다. 인터페이스에서 스위치가 사라졌다고 해서 프로토콜이 폐지된 것은 아닐 수 있습니다. 코어가 특정 프로토콜을 지원하더라도 현재 GUI에서 모든 고급 필드를 설정할 수 있다고 보장되지는 않습니다. 차이가 있다면 제품 이름만 비교하지 말고 클라이언트, 코어, 연결 매개변수 순으로 각각 확인하세요.
코어는 프로토콜 처리, 전송 연결, 라우팅 규칙 일치, 아웃바운드 연결을 담당합니다. 코어를 선택할 때는 서버 설정에 필요한 기능을 확인하세요. 예를 들어 VLESS, VMess의 매개변수와 TLS, REALITY 등 보안 설정의 호환성이 중요합니다. 두 코어가 같은 프로토콜을 지원한다는 이유만으로 전송 방식, 필드 값, 설정 변환의 차이를 간과해서는 안 됩니다. 연결 문제를 해결할 때는 코어를 계속 바꾸기보다 원래 매개변수 설명을 보존하는 편이 효과적일 수 있습니다.
라우팅과 DNS도 서로 대조해 확인해야 합니다. 도메인 목록, IP 데이터 리소스, 해석 정책에 따라 규칙 일치 여부가 달라집니다. 겉으로 같은 라우팅 프리셋도 리소스 내용이나 해석 방식이 바뀌면 결과가 달라질 수 있습니다. 먼저 클라이언트의 기본 설정으로 직접 연결, 프록시, 차단 아웃바운드의 의미를 파악한 다음 세부 규칙을 추가하세요. 로컬 네트워크 예외와 기본 아웃바운드를 명확히 설정하는 것이 규칙 수만 늘리는 것보다 관리하기 쉽습니다.
v2rayN은 데스크톱용으로 구독 관리, 라우팅 설정, 프록시 모드 등을 GUI에서 다루며 데스크톱에서 설정을 한곳에 모아 확인하려는 사용자에게 적합합니다. v2rayNG는 Android용 Xray 코어 클라이언트로 연결 설정과 시스템 VPN 권한을 함께 다룹니다. v2flyNG는 V2Fly 코어 기반의 Android 선택지입니다. 기기, 필요한 코어 기능, 사용 습관을 기준으로 선택하고 클라이언트 차이를 단순한 속도 순위로 축약하지 마세요.
오픈 소스 코드는 프로젝트 라이선스에 따라 확인·사용·연구할 수 있습니다. 재배포와 수정에 따르는 의무는 각 프로젝트의 라이선스를 기준으로 판단해야 합니다. 클라이언트, 코어, 포함된 리소스에는 서로 다른 조건이 적용될 수 있으므로 생태계 전체에 하나의 라이선스를 일괄 적용해서는 안 됩니다. 오픈 소스라는 점은 구현과 유지 관리 방식을 이해하는 데 도움이 되지만, 실제 연결은 서버, 네트워크 경로, 설정 내용, 기기 환경의 영향을 받으며 모든 사용 환경에서 성능을 보장하지는 않습니다.
GUI 클라이언트, 코어, 규칙 리소스는 각각 다른 주기로 관리됩니다. 업데이트로 인터페이스 배치, 설정 변환, 프로토콜 지원, 시스템 연동 방식이 바뀔 수 있으므로 동작이 달라졌다면 어느 계층이 바뀌었는지 확인해야 합니다. 업그레이드 전에 구독 그룹, 사용자 지정 라우팅, 필요한 매개변수 기록을 저장하세요. 업데이트 후에는 기존 앱과 접속 대상으로 기본 연결을 다시 확인한 뒤 고급 옵션을 복원해 환경 변화와 업데이트 효과를 혼동하지 않도록 하세요.
설정 두 가지를 비교할 때는 기기, 네트워크, 접속 대상을 가능한 한 동일하게 유지하고 시스템 프록시, TUN, DNS 상태를 기록하세요. 이 사이트의 설정 안내는 재현 가능한 작업 순서를 제시하기 위한 것이며, 맥락 없는 지연 시간 수치로 결론을 대신하지 않습니다. 새 필드, 권한 변경, 시작 오류가 발생하면 전체 설명서를 먼저 확인한 뒤 로그를 바탕으로 원인을 좁히세요. 용어를 확인할 때는 용어 설명서에서 클라이언트 인터페이스와 코어 설정을 연결해 볼 수 있습니다.
플랫폼 설치부터 설정 오류까지 구체적인 증상에 따른 해결 절차를 정리했습니다. 문제가 운영체제 권한, 프로그램 시작, 요청 연결 중 어느 단계에 해당하는지 먼저 판단한 뒤 관련 문서를 확인하세요.
macOS에서 v2rayN을 열 때 ‘개발자를 확인할 수 없음’ 알림으로 차단되는 문제를 해결하고, Apple 칩과 Intel 패키지의 차이, 시스템 프록시 및 네트워크 확장 권한 설정을 안내합니다.
Debian/Ubuntu 및 Fedora 계열 배포판에서 deb, rpm 패키지로 v2rayN을 설치하고 의존성을 해결하는 방법, 데스크톱 자동 시작 설정, 시스템 프록시와 TUN 권한 문제를 안내합니다.
코어 시작에 실패하면 먼저 로그를 확인하세요. 포트 충돌, JSON 형식 오류, 알 수 없는 프로토콜 필드, 규칙 파일 누락의 오류 특징과 항목별 수정 순서를 안내합니다.