CONFIGURATION NOTES
클라이언트 화면에서는 복잡한 설정을 입력 폼으로 나누지만, 필드 사이에는 엄격한 대응 관계가 있습니다. 아래에서는 사용 순서에 따라 프로토콜, 구독, 라우팅, 전송 및 코어를 설명합니다. 왼쪽 키 이름을 선택하면 해당 필드의 용도, 확인 방법, 혼동하기 쉬운 경계를 확인할 수 있습니다.
01 / PROTOCOL
프로토콜은 클라이언트와 원격 서버가 데이터를 해석하는 기본 규칙입니다. VMess는 자체 식별 및 시간 확인 메커니즘을 사용하고, VLESS는 더 간결한 인증 구조를 채택해 다양한 보안 계층과 함께 쓰입니다. Trojan은 보통 비밀번호, 서버 이름, 인증서 관련 설정이 핵심이며, Shadowsocks는 암호화 방식과 비밀번호로 연결 방식이 결정됩니다. 노드를 가져온 뒤에는 이름만 보고 판단하지 말고 프로토콜 유형과 필수 필드를 먼저 확인하세요.
프로토콜과 TCP, WebSocket, gRPC 같은 전송 유형은 서로 다른 계층에 속합니다. 프로토콜을 바꿔도 전송 매개변수가 자동으로 수정되지는 않습니다. 클라이언트에서 형식 오류가 표시되면 프로토콜, 포트, 사용자 식별자, 전송 및 보안 계층을 한 묶음으로 하나씩 대조하세요.
프로토콜 선택 가이드 읽기 →02 / SUBSCRIPTION
구독 주소는 여러 노드와 업데이트 결과를 가져오는 데 사용됩니다. 주소를 추가한 뒤 구독 업데이트를 실행해야 클라이언트가 원격 내용을 읽어 로컬 목록에 반영합니다. 업데이트 성공은 형식을 읽을 수 있다는 뜻일 뿐, 목록의 모든 노드가 연결된다는 의미는 아닙니다. 노드를 선택한 뒤 실제 연결 테스트를 실행하고, 웹페이지 접속이나 외부 IP 조회로 시스템 프록시 적용 여부를 확인하세요.
여러 구독은 각각 이름을 지정해 관리할 수 있습니다. 업데이트 전에 주소의 앞뒤가 완전한지 확인하고, 복사 과정에서 공백이나 줄바꿈이 섞이지 않았는지 살펴보세요. 구독 만료, 빈 응답, 현재 클라이언트에서 지원하지 않는 형식은 노드가 추가되지 않거나 기존 노드가 바뀌지 않는 증상으로 나타납니다. 이 세 가지를 순서대로 점검하세요.
구독 가져오기 단계 보기 →03 / ROUTING
라우팅 규칙은 노드 자체를 바꾸지 않고, 연결을 프록시로 보낼지 직접 연결할지 차단할지를 판단합니다. 흔한 조건으로 도메인, IP, 포트, 네트워크 유형 및 프로세스가 있습니다. 규칙은 보통 순서대로 매칭되므로 앞의 포괄적인 조건이 트래픽을 먼저 처리하면 뒤의 세부 규칙은 실행되지 않습니다. 따라서 분배 결과를 점검할 때는 규칙 내용뿐 아니라 배열 순서와 연결된 아웃바운드 태그도 확인해야 합니다.
처음 사용하는 경우 먼저 클라이언트의 기본 모드를 사용해 기본 연결이 안정적인지 확인하세요. 이후 사용자 지정 규칙을 추가하고, 변경 후에는 대상 웹사이트, 자주 쓰는 앱 및 로컬 네트워크 리소스를 각각 확인해야 합니다. 한 페이지의 결과만으로 전체 트래픽 상태를 판단하지 마세요.
라우팅 및 트래픽 분배 용어 보기 →04 / STREAM SETTINGS
streamSettings는 하위 네트워크 유형, 보안 계층 및 추가 매개변수를 설명합니다. TCP, WebSocket, gRPC는 필드 구조가 서로 다릅니다. TLS 또는 REALITY를 활성화하면 서버 이름, 지문, 공개 키, 짧은 식별자 또는 경로 등의 설정도 추가됩니다. 이 중 하나라도 노드 자료와 다르면 핸드셰이크 실패, 연결 직후 종료 또는 지속적인 시간 초과가 발생할 수 있습니다.
확인할 때는 네트워크 유형, 보안 유형, 서버 이름, 경로 또는 서비스 이름, 추가 식별자 순서로 진행하는 것이 좋습니다. 한 번에 여러 필드를 바꾸지 마세요. 연결이 복구되더라도 어떤 항목이 원인이었는지 확인하기 어려워집니다.
전송 계층 비교 읽기 →05 / CORE
v2rayN, v2rayNG, v2flyNG는 그래픽 클라이언트이며, 실제로 설정을 해석하고 연결을 수립하고 라우팅을 실행하는 것은 연결된 코어입니다. Xray와 V2Fly는 공통된 기술 계보를 가지며 기본 설정 개념은 매우 비슷하지만, 최신 프로토콜 지원, 전송 확장 및 일부 필드 구현은 완전히 같지 않습니다. 노드를 가져올 수 있는지와 실행할 수 있는지는 별도로 판단해야 합니다. 클라이언트가 링크 형식을 인식하더라도 현재 코어가 해당 기능을 지원하지 않을 수 있습니다.
클라이언트를 선택할 때는 먼저 플랫폼을 확인하고, 그다음 노드에 필요한 프로토콜을 살펴보세요. 클라이언트를 업데이트하면 코어 기능 범위도 달라질 수 있습니다. 새 환경에서 이전 설정의 동작이 바뀌었다면 다른 코어의 고급 매개변수를 그대로 복사하기보다 필드 호환성을 확인하세요.
코어 계열 설명 보기 →PLATFORM ENTRY
플랫폼에 따라 설치 패키지 형식과 권장 클라이언트가 달라집니다. 데스크톱에서는 v2rayN을 주로 사용하고, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택할 수 있습니다. 홈페이지는 플랫폼별 경로만 안내하며, 구체적인 패키지 형식과 아키텍처 설명은 다운로드 센터에 정리되어 있습니다.
DESKTOP / X64
v2rayN 사용을 권장합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 Windows 조작 방식을 유지합니다. 두 버전 모두 구독 관리, 시스템 프록시, 라우팅 규칙 및 로그 확인 기능을 제공하므로 인터페이스 선호도에 따라 선택하세요.
다운로드 페이지로 이동DESKTOP / ARM64 · X64
v2rayN 데스크톱 버전을 사용하세요. 다운로드 전에 프로세서 아키텍처를 확인해야 합니다. Apple Silicon 기기는 arm64, Intel 프로세서 기기는 x64를 선택하세요. 설치 후에는 데스크톱 버전과 동일한 구독, 노드 선택 및 시스템 프록시 절차를 이용할 수 있습니다.
다운로드 페이지로 이동MOBILE / ARM64
Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요하면 v2flyNG를 선택하세요. 최신 스마트폰 대부분은 arm64 패키지를 사용하며, 아키텍처를 확인하기 어렵다면 범용 패키지를 이용할 수 있습니다. 두 클라이언트의 구독 메뉴와 연결 절차는 비슷합니다.
다운로드 페이지로 이동DESKTOP / DEB · RPM
v2rayN 데스크톱 버전을 사용하세요. Debian 및 Ubuntu 계열 배포판은 보통 deb, Fedora 및 RHEL 계열은 보통 rpm을 선택합니다. 또한 기기 프로세서에 따라 x64 또는 arm64를 확인해야 합니다. 설치 후 데스크톱 세션과 시스템 프록시 설정을 먼저 점검하세요.
다운로드 페이지로 이동QUICK START
처음 설정할 때 모든 고급 옵션을 동시에 바꿀 필요는 없습니다. 먼저 구독, 노드, 시스템 프록시 세 가지 기본 작업을 완료해 연결을 확인한 뒤 필요에 따라 라우팅을 설정하거나 프로토콜을 변경하세요.
노드 서비스 자료에서 구독 주소 전체를 복사하세요. v2rayN에서는 구독 그룹 설정으로, v2rayNG에서는 구독 관리로 이동해 이름과 주소를 입력하고 저장합니다. 저장은 출처를 기록하는 단계일 뿐이므로 이후 구독 업데이트도 실행해야 합니다. 업데이트가 끝나면 노드 목록에 새 항목이 나타나는지 확인하고, 프로토콜, 서버, 포트 등 기본 정보가 정상적으로 표시되는지 점검하세요.
목록이 바뀌지 않으면 먼저 주소를 다시 복사하고 앞뒤 공백과 줄바꿈을 확인한 다음 구독 내용이 아직 유효한지 점검하세요. 단일 vmess:// 또는 vless:// 노드 링크를 구독 주소만 허용하는 입력란에 잘못 넣지 마세요.
업데이트된 목록에서 노드 하나를 활성 서버로 선택하세요. 먼저 클라이언트의 실제 연결 테스트로 요청이 실제로 완료되는지 확인하고, 단순한 네트워크 도달성 테스트만 믿지 마세요. 이후 필요에 따라 규칙 모드 또는 전역 모드를 선택합니다. 규칙 모드는 라우팅 조건에 따라 트래픽을 분배하고, 전역 모드는 더 많은 연결을 현재 아웃바운드로 전달합니다. 두 모드의 차이는 트래픽 처리 범위에 있으며 노드 설정 자체를 바꾸지는 않습니다.
처음에는 클라이언트 기본 라우팅을 유지해 변수를 줄이는 것이 좋습니다. 모든 노드가 시간 초과되면 먼저 기기 시간, 구독 상태 및 전송 매개변수를 확인하세요. 특정 노드만 실패한다면 우선 다른 노드로 바꿔 결과를 비교하세요.
클라이언트 연결을 시작한 뒤 시스템 프록시 또는 클라이언트가 요구하는 로컬 트래픽 인계 방식을 활성화하세요. 연결 아이콘이 바뀌었다고 해서 모든 앱이 프록시를 사용하는 것은 아닙니다. 웹페이지에 실제로 접속한 뒤 현재 외부 IP를 조회해 교차 확인하세요. 브라우저에서는 작동하지만 다른 프로그램에서 작동하지 않는다면 해당 프로그램이 시스템 프록시를 따르는지, 별도로 프록시 주소와 포트를 설정해야 하는지 확인하세요.
확인이 끝난 뒤 부팅 시 자동 실행, 구독 자동 업데이트 및 사용자 지정 라우팅을 설정하세요. 매번 한 종류의 설정만 조정하고 결과를 기록하면 문제가 생겨도 이전의 정상 상태로 빠르게 되돌릴 수 있습니다.
OPEN SOURCE CONTEXT
기술 생태계의 계보
V2Ray는 처음부터 조합 가능한 프록시, 전송 및 라우팅 설계를 발전시켜 왔습니다. 설정의 인바운드, 아웃바운드, 라우팅 및 전송 계층을 각각 정의한 뒤 코어가 이를 조합해 실행할 수 있습니다. 따라서 Project V는 일련의 기술 개념과 구현 생태계로 이해하는 편이 적절합니다. 사용자가 일상적으로 접하는 v2rayN, v2rayNG, v2flyNG는 이러한 코어 기능 위에 그래픽 조작 화면을 제공하는 클라이언트입니다.
클라이언트와 코어를 구분하는 것은 중요합니다. 클라이언트는 구독 관리, 화면 상호작용, 시스템 프록시 전환 및 로그 표시를 담당하고, 코어는 설정 해석, 연결 수립, 프로토콜 처리 및 라우팅 실행을 담당합니다. 화면이 비슷해 보여도 하위 계층의 지원 범위가 완전히 같다는 뜻은 아닙니다.
코어 계열
V2Fly는 V2Ray의 커뮤니티 중심 유지보수 방향을 이어받아 인바운드, 아웃바운드, 라우팅 및 다양한 전송 조합 기능을 유지합니다. Xray는 같은 기술 계보 위에서 일부 프로토콜, 보안 계층 및 전송 구현을 확장했습니다. 주소, 포트, 사용자 식별자, 라우팅 규칙 및 전송 네트워크 같은 기본 필드는 서로 이해할 수 있지만, REALITY, XTLS Vision 또는 특정 확장 필드를 사용할 때는 실제 코어의 기능을 기준으로 판단해야 합니다.
설정 호환성은 파일을 가져올 수 있는지만으로 판단할 수 없습니다. 클라이언트가 공유 링크를 인식했다는 것은 링크 형식을 해석했다는 뜻일 뿐입니다. 실제로 연결을 시작할 때는 현재 코어가 모든 필드를 처리해야 합니다. ‘가져오기는 되지만 연결되지 않는’ 경우에는 코어 기능, 필드 이름 및 전송 조합도 점검 대상에 포함하세요.
유지보수 방식
V2Fly, Xray 및 관련 그래픽 클라이언트는 서로 다른 커뮤니티와 유지관리자가 개발하므로 출시 주기가 완전히 같지 않습니다. 기능 업데이트에는 프로토콜 구현, 의존 구성 요소, 플랫폼 대응 및 화면 변경이 함께 포함될 수 있습니다. 업그레이드할 때는 먼저 대상 클라이언트의 지원 플랫폼과 코어 방향을 확인한 뒤 설정 이전이 필요한지 결정하세요. 장기적으로 사용할 설정은 구독 주소, 라우팅 규칙 및 필요한 사용자 지정 매개변수를 기록해 두면 재설치나 클라이언트 변경 시 환경을 다시 구성하기 쉽습니다.
코드가 공개되어 있다는 것은 구현과 변경 과정을 기술 커뮤니티가 점검하고 논의하고 개선할 수 있다는 의미입니다. 하지만 실제 연결 품질은 노드 매개변수, 네트워크 환경, 서버 설정 및 로컬 시스템 설정에 따라 달라집니다. 문제를 판단할 때는 클라이언트 이름만으로 결론 내리지 말고 로그와 재현 가능한 절차를 근거로 삼으세요.
TECHNICAL NOTES
기술 노트에서는 반복해서 적용할 수 있는 작업 순서를 중심으로 다룹니다. 각 글은 문제를 정의하고 필드나 화면 메뉴를 설명한 다음 확인 방법을 제시하므로, 서로 다른 클라이언트에서도 비교하며 따라 할 수 있습니다.
세 클라이언트의 지원 플랫폼, 구독 링크의 역할, 전역 모드와 규칙 모드의 차이, 클라이언트 업데이트 후 기존 설정을 유지하는 방법을 한곳에서 설명합니다. 처음 설치하기 전에 기본 개념과 순서를 빠르게 익히기에 적합합니다.
전체 글 읽기 →시스템 시간, 로컬 프록시 포트, 노드 필드, 전송 설정 및 구독 상태를 정해진 순서로 확인합니다. 각 단계마다 해당 검증을 수행해 여러 매개변수를 동시에 바꿨을 때 생기는 판단 혼선을 줄입니다.
전체 글 읽기 →데스크톱과 Android에서 구독을 추가하는 메뉴 위치를 각각 안내하고, 저장·업데이트·노드 선택 세 단계의 관계를 설명합니다. Base64, vmess, vless 등 자주 접하는 콘텐츠 형식도 함께 다룹니다.
전체 글 읽기 →