먼저 구독을 가져온 다음 시스템 프록시를 설정하고, 순서대로 라우팅을 구성하세요.
먼저 연결 정보를 가져온 뒤 어떤 앱을 프록시에 연결할지 정하세요. 아래 설정 화면은 메뉴 위치를 설명하기 위한 예시이며, 웹에서 직접 조작하는 클라이언트가 아닙니다.
구독은 변경될 수 있는 연결 설정을 묶어 관리할 때 유용합니다. v2rayN의 구독 그룹 설정에서 메모와 전체 주소를 입력하고 저장한 다음 구독 업데이트를 실행하세요. 클라이언트가 주소에서 내용을 가져와 서버 항목을 생성합니다. 공유 링크를 하나씩 붙여 넣는 것과 달리 구독은 이후에도 업데이트할 수 있지만, 주소 자체가 연결 매개변수는 아니므로 저장만으로 연결되지는 않습니다. 업데이트 후에는 그룹에 유효한 항목이 생성됐는지 확인하고 사용할 설정을 선택하세요. 결과가 비어 있다면 주소 만료 여부, 반환된 내용이 설정 텍스트인지, 현재 프록시 상태가 업데이트 요청에 영향을 주는지 확인하세요.
https://example.com/your-sub예시 주소는 형식을 설명하기 위한 것입니다. 이미 유효한 구독 주소를 사용하세요.
구독 업데이트(프록시 사용 안 함)시스템 프록시는 운영체제에 로컬 프록시 주소를 등록하므로 이 설정을 참조하는 브라우저와 앱에 적합합니다. TUN은 가상 네트워크 어댑터로 트래픽을 연결해 더 많은 앱을 대상으로 할 때 사용할 수 있습니다. 두 기능을 모두 켜는 것이 항상 좋은 것은 아닙니다. 처음에는 시스템 프록시 자동 설정을 선택하고 브라우저가 정상적으로 작동하는지 확인한 뒤, 대상 앱에 TUN이 필요한지 판단하세요. TUN을 켜기 전에 시스템 권한, 가상 네트워크 어댑터 구성요소, 다른 네트워크 도구의 실행 상태를 확인해야 합니다. 다른 프록시나 VPN 도구가 이미 라우팅을 처리하고 있다면 기능이 중복되지 않도록 먼저 종료하세요. 그래야 충돌을 구독 문제로 오인하지 않습니다.
설정 항목 이름은 인터페이스 구현에 따라 다를 수 있으므로 현재 사용 중인 클라이언트를 기준으로 확인하세요.
라우팅은 트래픽이 코어에 들어온 뒤 도메인, 대상 주소 등의 조건에 따라 아웃바운드를 선택합니다. 처음 설정할 때는 클라이언트 프리셋을 사용하고 기본 연결을 확인한 다음 사용자 지정 규칙을 추가하세요. 규칙은 대개 순서대로 매칭되므로 범위가 넓은 규칙을 앞에 두면 뒤에 있는 세부 조건이 적용되지 않을 수 있습니다. 오른쪽 예시는 지정된 도메인 목록을 direct 아웃바운드로 보내는 일부 설정일 뿐, 전체 설정 파일을 대체할 수 없습니다. 실제로 사용하려면 규칙 리소스에 해당 목록이 포함되어 있고 설정에 같은 이름의 아웃바운드가 있는지 확인하세요. 웹사이트의 경로가 예상과 다르면 먼저 규칙의 적용 순서를 확인하고, 그다음 도메인 확인 방식을 점검하세요.
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}이 예시는 기존 라우팅 규칙에 병합해야 합니다. 도메인 목록은 기기에 있는 규칙 리소스에 따라 달라집니다.
그래픽 클라이언트는 설정을 저장하고 서비스를 시작하며, 코어는 프로토콜, 전송 방식, 라우팅을 처리합니다. v2rayN은 여러 코어 관련 설정 메뉴를 제공하지만, 세부 옵션은 설치 패키지와 클라이언트 구현에 따라 다릅니다. 코어를 바꾸기 전 연결에 필요한 프로토콜, 전송 방식, 보안 매개변수를 확인하세요. 이름이 비슷하다는 이유만으로 호환된다고 판단해서는 안 됩니다. Android에서는 선택이 더 간단합니다. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 대안으로 제공합니다. 클라이언트 전체를 반복해서 바꾸기보다 현재 코어가 대상 설정을 지원하는지 먼저 확인하면 문제를 더 쉽게 파악할 수 있습니다. 인터페이스 프로그램을 업데이트한 뒤에도 실제 실행 중인 코어가 예상한 것인지 확인하세요.
VMess / VLESS이 다섯 가지 설정 메뉴는 각각 다른 역할을 합니다. 구독과 공유 링크는 설정을 가져오고, 시스템 프록시와 TUN은 앱 트래픽을 클라이언트에 연결하며, 라우팅은 아웃바운드를 선택하고, 코어는 실제 연결을 처리합니다. 문제를 확인할 때 여러 설정을 동시에 바꾸기보다 이 순서대로 점검하면 원인을 파악하기 쉽습니다. 설정을 성공적으로 가져왔다는 것은 클라이언트가 내용을 읽었다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다. 브라우저에서 웹페이지가 열려도 다른 앱이 같은 경로를 사용한다고 볼 수 없습니다.
관련 개념이 낯설다면 기본 설정을 유지하고 최소한의 구성으로 먼저 연결해 보세요. 연결이 안정적으로 재현된 후 도메인 예외를 추가하거나 다른 연결 방식을 활성화하세요. 한 번에 한 항목만 변경하고 전후 결과를 기록하세요. 용어는 용어 설명에서 확인할 수 있습니다. 플랫폼별 권한과 설치 절차를 점검하려면 사용 가이드를 참고하세요. 처음 실행할 때 모든 매개변수를 읽을 필요는 없습니다.
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 먼저 살펴보세요. 다운로드 페이지에서 프로세서 아키텍처와 설치 패키지 유형을 확인할 수 있습니다.
데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 데스크톱 방식의 조작 환경을 제공합니다. 처음 설치한다면 인터페이스 차이와 시스템 요구 사항을 확인하세요. 같은 구독을 사용하려고 두 버전을 모두 설치할 필요는 없습니다. 설정 메뉴 위치는 인터페이스마다 다를 수 있으므로 기능 이름을 기준으로 찾아보세요.
다운로드하기 전에 시스템 정보에서 프로세서 유형을 확인하세요. 설치 후에는 관리하기 편하고 쓰기 권한이 있는 위치에 설정을 저장하세요. 실행 환경이 없다는 안내가 나오면 설치 설명에 따라 필요한 구성요소를 추가한 다음 구독을 가져오세요.
다운로드 Windows 클라이언트 →먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인한 다음 Apple Silicon 또는 Intel용 설치 패키지를 선택하세요. 아키텍처에 따라 프로그램이 바로 실행될 수 있는지가 달라지며, 구독에서 사용하는 프로토콜과는 별개의 문제입니다.
처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정하세요. 시스템 프록시가 작동하는 것을 확인한 뒤 필요에 따라 TUN을 고려하세요. 네트워크 확장이나 관리자 권한이 필요한 경우 플랫폼 안내를 먼저 확인하고, 다른 데스크톱 운영체제의 절차를 그대로 적용하지 마세요.
다운로드 macOS 클라이언트 →v2rayNG는 Xray 코어를 사용하고, v2flyNG에서는 V2Fly 코어를 선택할 수 있습니다. 일반적인 기기에는 arm64 패키지를 사용할 수 있습니다. 아키텍처가 확실하지 않다면 다운로드 페이지의 설명을 확인한 뒤 범용 버전을 선택하세요. 설치 패키지 아키텍처와 코어 계열은 별도로 고려해야 합니다.
구독을 가져온 뒤 사용할 설정을 선택하고 연결을 시작할 때 시스템 VPN 권한을 허용하세요. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 관리와 백그라운드 실행 제한을 확인하세요. 다른 네트워크 도구가 연결 중이면 먼저 시스템 연결을 점유하는 앱을 정리하세요.
다운로드 Android 클라이언트 →배포판의 패키지 관리 방식에 맞춰 deb 또는 rpm을 선택하고 기기가 x64인지 arm64인지 확인하세요. 그래픽 인터페이스가 비슷해도 데스크톱 환경이 완전히 같지는 않습니다. 앱이 시스템 프록시를 읽는지는 앱 자체와 데스크톱 세션 구현에 따라서도 달라집니다.
먼저 일반 사용자 환경에서 실행하고 구독을 가져온 뒤, TUN에 필요한 추가 권한을 설정하세요. 웹브라우저와 다른 프로그램의 작동 방식이 다르면 각 앱이 사용하는 프록시 설정을 확인하세요. 데스크톱 프록시 설정을 모든 프로세스가 공유하는 네트워크 스위치로 오해하지 않도록 주의하세요.
다운로드 Linux 클라이언트 →클라이언트를 다운로드해도 연결 설정이 자동으로 제공되지는 않습니다. 시작하기 전에 유효한 구독 주소나 공유 링크를 준비하고 출처와 사용 범위를 확인하세요. 기기를 바꾸면 설정을 옮길 수 있지만, 로컬 프록시 스위치, 시스템 권한, 백그라운드 권한은 새 기기에서 다시 점검해야 합니다.
모든 클라이언트 보기 →먼저 설정을 가져왔는지 확인하고, 다음으로 앱이 프록시를 사용하는지 확인한 뒤, 마지막으로 라우팅을 점검하세요. 각 단계마다 확인할 수 있는 결과를 하나씩 정하세요.
먼저 받은 텍스트의 유형을 확인하세요. 구독 주소는 보통 구독 그룹에 추가한 뒤 업데이트해야 합니다. 개별 공유 링크는 클립보드나 QR 코드 메뉴에서 가져오세요. 웹페이지 안내 주소를 구독 주소로 쓰거나 대화 내용 전체를 주소 입력란에 붙여 넣지 마세요.
업데이트 후 그룹에 설정이 추가됐는지, 메모가 예상대로인지 확인한 다음 사용할 항목을 선택하세요. 전송 방식과 보안 매개변수는 당장 수정하지 말고 출처에서 제공한 설정을 그대로 유지하세요. 항목이 생성되지 않으면 프록시 스위치를 더 켜기보다 주소와 내용 형식부터 확인하세요.
데스크톱에서는 시스템 프록시 자동 설정으로 브라우저를 먼저 확인하고, Android에서는 연결을 시작할 때 시스템 권한을 허용하세요. 대상 앱에 자체 프록시 설정이 있다면 시스템 설정을 따르는지, 수동 설정을 사용하는지, 시스템 프록시를 무시하는지 별도로 확인해야 합니다.
TUN은 구독을 가져온 뒤 반드시 켜야 하는 기능이 아니라, 필요가 분명할 때 다음 단계로 고려하면 됩니다. 활성화 전에 권한을 확인하고 트래픽을 처리할 수 있는 다른 도구는 일시 중지하세요. LAN 공유는 별도의 기능이며, 개인 기기에서 사용하는 경우 연결을 위해 켤 필요가 없는 경우가 많습니다.
먼저 평소 사용하는 브라우저에서 접속 가능한 것으로 알고 있는 웹사이트를 열고, 실제로 프록시가 필요한 대상 앱도 확인하세요. 두 결과가 다르면 앱의 연결 방식을 먼저 살펴보세요. 둘 다 실패하면 사용 중인 설정, 시스템 시간, 클라이언트 로그의 오류 유형을 확인하세요.
연결이 정상이라면 라우팅 프리셋을 적용한 뒤 예외 규칙을 하나씩 추가하세요. 문제가 생기면 가장 최근 변경 사항부터 되돌리고 구독, 코어, 라우팅을 동시에 바꾸지 마세요. 사용을 마칠 때는 더 이상 필요하지 않은 시스템 프록시 설정을 복원해 클라이언트를 종료한 뒤에도 앱이 로컬 포트를 가리키지 않도록 하세요.
어느 단계에서 막히든 최소한의 설정을 유지하세요. ‘구독 업데이트 성공’, ‘코어 실행 성공’, ‘브라우저 접속 성공’은 각각 다른 점검 결과입니다. 어느 단계에서 문제가 생겼는지 기록해 두면 이후 문제 해결이 쉬워집니다. 로그를 공유하기 전에는 서버 주소, 사용자 식별 정보, 구독 매개변수를 가리고 필요한 오류 정보만 남기세요.
전체 가이드 보기 →프로젝트, 코어, 그래픽 클라이언트를 구분한 뒤 업데이트와 호환성을 살펴보세요. 이름이 비슷해도 같은 역할을 하는 것은 아닙니다.
Project V는 V2Ray의 배경을 이해하는 출발점으로, 모듈식 네트워크 프록시 기능에 초점을 둡니다. 인바운드는 트래픽을 받고, 아웃바운드는 연결을 수립하며, 라우팅 규칙은 트래픽을 어느 아웃바운드로 보낼지 결정합니다. 일상적으로 말하는 ‘V2Ray 클라이언트’는 특정 실행 코어 하나가 아니라 그래픽 인터페이스를 갖춘 관리 프로그램을 가리키는 경우가 많습니다. 그래픽 인터페이스는 직접 편집해야 했던 매개변수를 양식, 메뉴, 구독 그룹으로 정리해 설정을 더 쉽게 관리하도록 돕습니다.
이러한 계층 구조를 알면 같은 연결 정보가 여러 클라이언트에서 사용되는 이유를 이해할 수 있습니다. 공유 형식은 설정을 교환하고, 코어는 연결을 처리하며, 인터페이스는 설정을 관리합니다. 실제 매개변수가 호환되는지는 양쪽에서 프로토콜과 확장 필드를 지원하는지에 달려 있습니다. 이런 관계를 이해하면 가져오기에 실패했을 때는 형식을, 실행에 실패했을 때는 코어 매개변수를 먼저 살펴볼 수 있습니다. 클라이언트 이름만으로 원인을 판단할 필요가 없습니다.
V2Fly 커뮤니티는 V2Ray 관련 개발을 이어가고 있으며, Xray는 관련 기술을 바탕으로 발전한 별도의 코어 계열입니다. 두 프로젝트는 일부 개념과 프로토콜 기반을 공유하지만, 각각 개발되면서 기능과 호환 범위가 달라졌습니다. 구독 제공자가 표시한 프로토콜 이름은 확인을 시작하는 단서일 뿐입니다. 전송 방식, 보안 매개변수, 구체적인 구현 요구사항도 중요합니다. 한 코어에서 유효한 필드라고 해서 다른 코어에서도 그대로 받아들여지는 것은 아닙니다.
선택할 때는 먼저 서버에서 요구하는 설정을 확인하고 이를 올바르게 처리할 수 있는 클라이언트와 코어 조합을 고르세요. 코어 이름을 단순한 성능 순위로 보거나, 시간 초과 문제를 해결하려고 도구를 자주 바꾸지 마세요. 먼저 시스템 시간, 연결 방식, 현재 사용 중인 설정을 확인한 다음 프로토콜 지원 여부를 점검하면 결과를 비교하기 쉽습니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 클라이언트입니다. 오픈 소스란 각 프로젝트의 라이선스에 따라 코드를 열람하고 사용하거나 개선에 참여할 수 있다는 뜻이며, 모든 프로젝트가 같은 라이선스를 사용한다는 의미는 아닙니다. 클라이언트와 사용하는 코어, 함께 제공되는 구성요소에는 서로 다른 약관이 적용될 수 있습니다. 재배포하거나 수정할 때는 인터페이스 이름만 보고 판단하지 말고 해당 프로젝트에 포함된 라이선스 안내를 확인하세요.
클라이언트를 무료로 사용할 수 있다고 해서 연결 리소스까지 제공되는 것은 아닙니다. 구독 주소, 서버, 계정은 각각 별도의 설정 출처에서 제공되며, 사용 가능 여부와 클라이언트 코드의 오픈 소스 여부는 서로 다른 문제입니다. 이 사이트는 다운로드 선택과 설정 방법을 안내하며, 공개적으로 공유할 수 있는 구독 정보를 제공하지 않습니다. 사용 전에 설정 출처를 신뢰할 수 있는지 확인하고 거주 지역의 관련 규정과 네트워크 서비스 약관을 준수하세요.
오픈 소스 생태계는 커뮤니티의 참여로 호환성 문제를 해결하고 인터페이스를 개선하며 기능을 추가합니다. 클라이언트, 코어, 규칙 리소스는 각각 별도로 업데이트될 수 있으므로 무엇이 업데이트됐는지 확인해야 합니다. 새 인터페이스를 설치한 뒤 기존 설정을 옮길 수 있는지, 이전 코어가 계속 사용되는지, 규칙 리소스가 호환되는지 업데이트 안내를 항목별로 확인하세요. 인터페이스가 비슷해 보인다는 이유로 이전 설정 점검을 건너뛰지 마세요.
업데이트 전에 현재 연결 방식과 라우팅 선택을 기록하고 필요한 설정을 백업하세요. 업데이트 후에는 원래 정상 작동하던 환경부터 확인한 다음 새 옵션을 활성화하세요. 설정 백업에는 구독 정보와 인증 정보가 포함될 수 있으므로 민감한 파일로 취급해야 합니다. 동작이 달라졌다면 설정과 오류 정보를 비교한 뒤 되돌릴지 결정하세요. 플랫폼 권한, 설정 이전, 일반적인 충돌 문제는 전체 플랫폼 사용 가이드에서 확인할 수 있습니다.
실제 설정에서 헷갈리기 쉬운 메뉴, 버전 종류, 오류 상황을 다룹니다. 겪고 있는 문제에 맞는 글을 먼저 읽고 클라이언트에서 항목별로 확인하세요.
구독 업데이트 실패가 반드시 클라이언트 연결 문제를 의미하는 것은 아닙니다. 주소가 여전히 유효한지, 반환 내용이 인식 가능한 형식인지 확인한 뒤 Base64 인코딩과 업데이트 요청의 네트워크 경로를 점검하세요. ‘요청 실패’와 ‘파싱 결과 없음’을 구분해야 적절한 해결 단계를 선택할 수 있습니다.
노트 읽기 →데스크톱 버전과 WPF 버전 선택부터 설치 폴더와 실행 환경을 확인하고 구독 가져오기 및 시스템 프록시 설정까지 진행합니다. 실행, 가져오기, 연결의 세 단계로 흔한 문제를 정리하고 TUN을 추가로 시도해야 하는 경우도 설명합니다.
노트 읽기 →데스크톱 버전은 크로스 플랫폼 Avalonia 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 사용 방식에 맞춰 설계되었습니다. 실행 플랫폼, 외관, 의존성을 비교해 데스크톱 사용자에게 적합한 버전을 안내하고, 인터페이스가 달라도 구독의 개념은 바뀌지 않는 이유를 설명합니다.
노트 읽기 →