Project V: 모듈형 프록시 설정의 배경
Project V는 V2Ray 생태계를 이해하는 출발점입니다. 모든 기능을 하나의 서버 주소에 담는 대신 연결 수신, 규칙 매칭, 아웃바운드 연결, DNS 처리를 각각 나눠 설정합니다. 하나의 실행 인스턴스에서 여러 인바운드와 아웃바운드를 구성하고 태그로 서로 연결할 수도 있습니다. 일상적으로 사용할 때는 그래픽 클라이언트가 설정 대부분을 감춰 주지만, 문제를 해결할 때는 각 기능의 경계가 단계별 점검 순서가 됩니다.
‘V2Ray 클라이언트’는 보통 앱의 한 범주를 가리킬 뿐, 모든 앱이 같은 코어와 설정 형식을 사용한다는 뜻은 아닙니다. 같은 공유 링크라도 클라이언트가 먼저 프로토콜과 추가 매개변수를 파악한 뒤 실제 실행 설정으로 변환해야 합니다. 가져오기에 실패했다면 공유 형식이 지원되는지 확인하세요. 가져오기는 성공했지만 실행에 실패한다면 코어가 생성된 필드를 인식하는지 점검하세요. 프록시 모드를 계속 바꾸는 것보다 문제 발생 지점에 가까운 확인 방법입니다.
V2Fly와 Xray: 공통된 뿌리, 서로 다른 발전
V2Fly는 V2Ray의 커뮤니티 유지보수 흐름을 이어가고, Xray는 관련 코드 기반에서 자체 구현과 확장을 발전시켰습니다. 인바운드, 아웃바운드, 라우팅 태그 같은 기본 개념은 상당 부분 공유하지만 프로토콜 확장, 전송 옵션, DNS 동작, 필드 지원이 항상 같은 시점에 맞춰지는 것은 아닙니다. 한 코어에서 실행되는 설정이 다른 코어에 그대로 복사해도 똑같이 작동한다고 보장할 수 없습니다.
예를 들어 REALITY 또는 XTLS Vision 관련 매개변수를 쓴다면 현재 코어가 해당 기능을 지원하는지, 서버가 요구하는 설정 조합과 일치하는지 확인해야 합니다. 코어 선택은 제품 이름만 볼 것이 아니라 필요한 기능과 클라이언트 연동 상태를 기준으로 하세요. 문제를 해결하기 전에 사용 중인 클라이언트, 실제로 실행된 코어, 설정 메뉴를 기록해 두면 한 구현의 문서로 다른 구현의 오류를 설명하는 일을 피할 수 있습니다.
세 가지 클라이언트: 플랫폼과 코어 조합
v2rayN, v2rayNG, v2flyNG는 모두 소스 코드가 공개된 그래픽 클라이언트입니다. 데스크톱에서는 v2rayN으로 서버, 구독, 라우팅을 관리하고, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려할 수 있습니다. v2flyNG는 V2Fly 코어가 필요한 경우에 적합합니다. 선택 기준은 먼저 운영체제, 다음으로 프로토콜 기능과 설정 호환성입니다. 세 앱을 같은 성능 기준으로 단순히 순위 매기는 문제는 아닙니다.
v2rayN의 인터페이스 설정은 실행에 사용할 구성 요소에도 영향을 줄 수 있습니다. 서버를 선택한 뒤 해당 프로토콜과 클라이언트가 실제로 호출하는 코어가 호환되는지 확인하세요. 모바일에서는 시스템 VPN 인터페이스, 앱별 트래픽 분기, 백그라운드 제한도 고려해야 합니다. 데스크톱의 로컬 SOCKS 포트를 휴대폰 설정에 그대로 옮겨도 모바일 운영체제의 트래픽 전달 과정을 대신할 수는 없습니다. 같은 서버 설정도 플랫폼별 네트워크 진입 방식에 맞게 사용해야 합니다.
클라이언트 선택 가이드에서 세 앱의 지원 플랫폼, 설정 방법, 사용 범위를 비교합니다. 이미 정상적으로 작동하는 설정이 있다면 인터페이스를 통일하려고 클라이언트, 코어, 라우팅 방식을 한꺼번에 바꿀 필요는 없습니다. 기존 설정을 보존하고 한 번에 한 항목씩 변경해야 결과가 달라진 원인을 파악할 수 있습니다.
오픈 소스 라이선스: 클라이언트와 코어를 따로 확인하세요
소스 코드 공개는 각 프로젝트의 라이선스와 사용 조건에 따라 코드를 제공한다는 뜻이지만, 클라이언트와 코어, 함께 포함된 구성 요소가 서로 다른 라이선스를 적용받을 수 있습니다. V2Fly 코어는 MIT 라이선스를, Xray 코어는 MPL-2.0을 사용합니다. 클라이언트는 배포 파일에 포함된 각 라이선스 안내도 확인해야 합니다. 개인 사용, 소스 수정, 재배포는 각각 다른 상황이므로 ‘오픈 소스’라는 이유만으로 모든 권리와 의무를 단정할 수 없습니다.
일반적인 설치와 사용에서는 소프트웨어 이름, 지원 플랫폼, 구성 요소 안내를 확인하세요. 재배포하거나 소스 코드를 수정하는 프로젝트라면 적용되는 라이선스를 항목별로 읽고, 유지해야 하는 고지도 보존해야 합니다. 오픈 소스 여부가 설정 점검을 대신하지는 않습니다. 트래픽이 어디로 전달되는지, 구독이 어떤 서버를 갱신하는지, 로컬 리스닝 포트에 어떤 주소가 접근할 수 있는지는 실제 설정으로 결정되므로 실행 환경에서 확인해야 합니다.
업데이트 관리: 프로그램·코어·구독·규칙을 따로 점검
클라이언트 업데이트는 인터페이스와 설정 생성 로직을, 코어 업데이트는 프로토콜 구현을 바꿉니다. 구독 업데이트는 서버 항목을 새로고침하고, 규칙 리소스 업데이트는 도메인 또는 주소 분류에 영향을 줍니다. 네 가지 작업은 해결하려는 문제가 서로 다릅니다. 새 프로토콜 필드를 인식하지 못하면 먼저 코어 지원 여부를 확인하세요. 구독 서버 주소가 바뀌었다면 해당 그룹을 업데이트하세요. 규칙 파일이 없다면 클라이언트만 재설치하지 말고 리소스 설정과 실행 로그를 확인하세요.
설정을 바꾸기 전에 기존 설정과 사용자 지정 규칙을 보존해 두세요. 업데이트 후에는 먼저 선택한 서버가 실행되는지 확인하고, 다음으로 시스템 프록시나 TUN이 예상대로 트래픽을 전달하는지 검증한 뒤 자주 쓰는 앱과 로컬 네트워크를 테스트하세요. 코어를 바꾸고 구독을 지운 다음 DNS까지 다시 작성하면 연결이 복구되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다. 관련 없는 스위치를 계속 바꾸기보다 순서를 정해 점검하는 편이 장기적인 관리에 유리합니다.
연결 확인: 속도 테스트·핸드셰이크·실제 요청 구분하기
서버 목록의 테스트 결과는 특정 조건에서만 확인한 결과입니다. 포트 연결에 성공해도 프로토콜 핸드셰이크가 성공한다는 뜻은 아니며, 핸드셰이크가 완료돼도 대상 사이트의 DNS와 라우팅이 올바르다는 보장은 없습니다. V2Ray 노드 속도 테스트를 할 때는 테스트 대상과 방식을 먼저 확인한 뒤 실제 요청 결과와 함께 판단하세요. 테스트 하나만으로 모든 앱에서 접속된다고 결론 내리지 마세요.
정해진 순서로 확인하세요. 먼저 클라이언트가 코어를 실행했는지 보고, 프록시를 명시적으로 설정한 앱에서 요청을 보낸 다음 시스템 프록시를 확인하고 마지막으로 TUN을 테스트합니다. 각 단계의 로그를 따로 보관하세요. 시간 초과가 발생하면 요청이 어느 단계에서 멈췄는지 확인하고, 핸드셰이크 오류가 나면 인증 정보, 보안, 전송 필드를 다시 점검하세요. 로그에 표시되는 로컬 포트, 아웃바운드 태그, 대상 도메인이 막연한 ‘연결 실패’ 메시지보다 문제를 찾는 데 더 유용합니다.
프록시 모드: 트래픽 적용 범위와 라우팅 정책은 다릅니다
시스템 프록시는 해당 설정을 따르는 앱이 연결을 로컬 프록시로 보낼지 결정합니다. 라우팅 정책은 코어에 들어온 트래픽을 어떤 아웃바운드로 보낼지 결정합니다. 인터페이스의 ‘전역’은 보통 특정 라우팅 선택을 뜻하며 모든 프로세스의 트래픽을 반드시 처리한다는 의미는 아닙니다. 시스템 프록시를 따르지 않는 앱은 전역 라우팅을 선택해도 코어에 연결을 보내지 않을 수 있습니다. 적용 범위를 넓혀야 한다면 분기 규칙만 반복해서 바꾸지 말고 TUN 사용을 검토하세요.
따라서 ‘브라우저는 되는데 다른 프로그램은 안 되는’ 문제는 먼저 트래픽이 프록시로 들어오는 경로를 확인하고, ‘일부 도메인이 잘못된 경로로 가는’ 문제는 규칙 순서와 DNS를 확인하세요. 데스크톱 사용법은 시스템 프록시와 전역 프록시 안내를, 모바일은 v2rayNG 사용 가이드를 참고해 시스템 권한과 적용 범위를 확인하세요. 자주 묻는 문제는 FAQ에서, 설정 필드의 기본값과 참조 관계는 설정 레퍼런스에서 단계별로 확인할 수 있습니다.