platform.outbounds

기기에 맞는 클라이언트 선택

플랫폼에 따라 설치 패키지 형식이 결정되고, 노드 프로토콜에 따라 필요한 코어 기능이 달라집니다. 먼저 기기를 선택한 다음 구독에 Xray 또는 V2Fly가 필요한지 확인하세요. 다운로드 페이지에서 아키텍처, 칩, 설치 형식도 안내합니다.

데스크톱 추천

Windows · v2rayN

전체 시스템 프록시, 구독 그룹, 라우팅 규칙, 로그 분석이 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 차세대 크로스 플랫폼 인터페이스와 기존 WPF 인터페이스를 모두 제공합니다. 일반적인 최신 기기라면 데스크톱 버전부터 사용하고, 익숙한 설정 절차가 있다면 기존 인터페이스를 계속 선택할 수 있습니다.

다운로드 페이지로 이동

데스크톱 클라이언트

macOS · v2rayN

데스크톱 버전은 v2rayN의 설정 방식을 따르며 구독, 아웃바운드, 분기 규칙을 관리할 수 있습니다. 다운로드 전에 기기의 칩 유형을 확인하세요. Apple Silicon 기기는 arm64 패키지, Intel 기기는 x64 패키지를 선택합니다. 칩 유형은 시스템 정보에서 확인해야 하며 구입 연도만으로 추정해서는 안 됩니다.

다운로드 페이지로 이동

모바일 추천

Android · v2rayNG

v2rayNG는 Xray 코어를 사용하므로 VLESS, REALITY 등 Xray 기능이 필요한 구독에 적합하며 대부분의 모바일 기기에서 바로 선택할 수 있습니다. 최신 기기라면 일반적으로 arm64 패키지를 우선 선택하세요. 프로세서 아키텍처를 확인하기 어렵거나 더 넓은 호환성이 필요하면 다운로드 페이지에서 범용 패키지를 선택할 수 있습니다.

다운로드 페이지로 이동

패키지 설치

Linux · v2rayN

그래픽 인터페이스로 구독, 시스템 프록시, 라우팅 규칙을 관리하려는 데스크톱 Linux 배포판 사용자에게 적합합니다. 설치 형식은 배포판의 패키지 체계를 따라야 합니다. Debian 및 Ubuntu 계열은 보통 deb, Fedora 및 Rocky Linux 계열은 보통 rpm을 사용하며 x64와 arm64 아키텍처도 구분해야 합니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

routing.console

규칙 목록 및 설정 패널

V2Ray 클라이언트의 핵심 기능은 노드 연결에만 있지 않습니다. 구독, 코어, DNS, 라우팅이 함께 연결 결과를 결정합니다. 아래 설정 패널에서는 문제 유형별로 내용을 나누고 바로 이해할 수 있는 설정 예시를 제공합니다.

JSON 설정 보기 config/routing

프록시 · 직접 연결 · 차단

라우팅 규칙은 순서대로 매칭됩니다

라우팅 설정은 트래픽마다 다른 아웃바운드를 지정합니다. 프록시가 필요한 도메인은 프록시 아웃바운드로 보내고, 로컬 네트워크와 지정된 주소 범위는 직접 연결하며, 접근하지 않을 범주는 차단 아웃바운드로 보냅니다. 규칙은 위에서 아래로 확인하고 매칭되면 다음 규칙을 검사하지 않으므로, 더 구체적인 규칙을 앞에 두고 범위가 넓은 기본 규칙은 뒤에 배치하는 것이 일반적입니다. 전역 스위치만 제공하는 단순 도구와 달리 V2Ray의 규칙 객체는 도메인, 주소, 포트, 네트워크 유형, 인바운드 태그를 조합할 수 있어 사용 환경을 관리 가능한 목록으로 구성하기 좋습니다.

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

규칙을 수정한 뒤에는 먼저 태그가 outbounds의 아웃바운드 이름과 일치하는지 확인하고, 클라이언트 로그에서 실제 매칭 결과를 확인하세요.

노드 목록

구독 주소와 공유 링크는 별도로 관리하세요

구독 주소는 업데이트 가능한 노드 목록을 가리키며, 하나의 vmess:// 또는 vless:// 공유 링크는 보통 단일 노드만 설명합니다. 클라이언트에서 구독을 가져온 뒤 먼저 업데이트를 실행하고 해당 그룹에서 노드를 선택하세요. 공유 링크를 직접 가져오면 지속적으로 업데이트되는 구독 소스가 자동으로 만들어지지 않습니다. 출처별로 별도 그룹을 만들면 어느 주소에서 업데이트가 실패했는지 파악하기 쉽고 같은 이름의 노드가 섞이는 것도 막을 수 있습니다. 업데이트 전 기존 그룹을 보존하고, 업데이트가 성공한 뒤 지연 시간 테스트나 연결 확인을 진행하면 문제 해결 경로가 더 명확해집니다.

구독 그룹
├─ 업무용 설정
│  ├─ 수동 업데이트
│  └─ 자동 업데이트
└─ 임시 공유
   └─ 단일 노드 가져오기

구독 콘텐츠는 서비스 제공자가 생성합니다. 클라이언트는 이를 읽고 업데이트하고 표시하지만, 단일 노드 링크를 원격 구독으로 자동 변환하지는 않습니다.

Xray · V2Fly

프로토콜 기능에 따른 코어 선택

v2rayN은 데스크톱 그래픽 클라이언트로, 지원되는 코어와 함께 다양한 노드를 관리할 수 있습니다. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어를 기반으로 합니다. 선택할 때는 인터페이스 세부 기능보다 노드의 프로토콜, 전송 방식, 보안 매개변수를 먼저 확인하세요. REALITY 같은 Xray 확장 기능이 필요하면 해당 코어를 선택해야 하며, V2Fly가 지원하는 표준 설정을 사용한다면 V2Fly 계열을 선택할 수 있습니다. 클라이언트는 설정을 입력하는 창일 뿐이고, 실제로 프로토콜 필드를 해석해 연결을 수립하는 것은 코어입니다.

선택 순서
1. 노드 프로토콜 및 보안 매개변수 확인
2. 코어 지원 범위 확인
3. 해당 그래픽 클라이언트 선택
4. 가져온 후 로그 확인

코어와 클라이언트는 따로 판단해야 합니다. 클라이언트 이름이 비슷하다고 해서 내부에서 같은 코어 유지 관리 경로를 사용하는 것은 아닙니다.

DNS 조회 전략

DNS와 라우팅 매칭을 일치시키세요

연결은 성공으로 표시되지만 웹페이지가 열리지 않을 때는 DNS를 확인해야 합니다. 라우팅 규칙은 도메인으로 직접 매칭할 수도 있고, 도메인 규칙에 매칭되지 않으면 주소로 해석한 뒤 계속 판단할 수도 있습니다. 이 과정은 domainStrategy 등의 설정에 의해 제어됩니다. DNS 서버, 조회 경로, 라우팅 정책이 서로 충돌하면 도메인 조회는 성공했지만 예상과 다른 아웃바운드가 선택되거나 로그에 조회 실패가 계속 나타날 수 있습니다. 문제를 해결할 때는 먼저 간단한 설정으로 기본 연결을 확인한 뒤 사용자 지정 DNS와 복잡한 규칙을 하나씩 다시 적용하세요.

{
  "dns": {
    "servers": [
      "localhost"
    ]
  },
  "routing": {
    "domainStrategy": "IPIfNonMatch"
  }
}

DNS 설정은 시스템 네트워크 환경과 분리해서 판단하면 안 됩니다. 먼저 시스템 시간, 기본 네트워크, 노드 상태를 확인한 다음 조회 전략을 점검하세요.

setup.sequence

세 단계로 기본 연결 완료

처음 설정할 때는 고급 옵션을 한꺼번에 많이 변경하지 마세요. 먼저 구독 가져오기와 기본 연결을 완료한 뒤 실제 필요에 따라 라우팅 및 DNS 규칙을 추가하세요. 그러면 각 변경 사항을 명확한 결과와 연결할 수 있습니다.

전체 가이드 보기 →

01

구독 또는 공유 링크 가져오기

전체 구독 주소를 복사한 다음 클라이언트의 구독 그룹에 새 소스를 추가하고 업데이트를 실행하세요. 단일 vmess:// 또는 vless:// 링크를 받은 경우에는 ‘클립보드에서 가져오기’와 같은 메뉴를 사용합니다. 가져온 뒤 목록에 노드 이름, 프로토콜, 주소 정보가 표시되는지 확인하세요. 목록이 비어 있으면 복사한 내용이 완전한지, 구독에 계속 접근할 수 있는지, 업데이트 중 오류가 표시되었는지를 먼저 확인하세요.
02

노드 및 프록시 모드 선택

구독 그룹에서 노드를 하나 선택한 다음 클라이언트가 제공하는 시스템 프록시 또는 해당 연결 모드를 활성화하세요. 처음 테스트할 때는 간단한 규칙 세트를 사용하여 사용자 지정 차단, 복잡한 DNS, 다단계 아웃바운드가 결과에 동시에 영향을 주지 않도록 하는 것이 좋습니다. 노드 사용 가능 여부와 네트워크 환경은 변할 수 있으므로 지연 시간은 참고 자료일 뿐입니다. 실제 판단 기준은 대상 연결이 수립되는지, 로그에 핸드셰이크·조회·라우팅 오류가 나타나는지입니다.
03

연결 확인 후 규칙을 하나씩 추가

기본 연결이 수립되면 일반 웹페이지, 직접 연결 주소, 특정 아웃바운드가 필요한 대상을 각각 테스트하여 프록시와 직접 연결 경로가 예상대로 작동하는지 확인하세요. 그런 다음 사설 주소 직접 연결, 특정 도메인 프록시 등의 규칙을 추가하고 매번 한 그룹의 설정만 변경한 뒤 되돌릴 수 있는 설정을 저장하세요. 문제가 발생하면 ‘노드, DNS, 라우팅, 시스템 프록시’ 순서로 확인하는 편이 클라이언트를 반복해서 재설치하는 것보다 원인을 찾기 쉽습니다.

project.v / ecosystem

Project V, 코어, 클라이언트의 관계

생태계의 계층을 이해하는 것이 클라이언트 이름 하나를 기억하는 것보다 중요합니다. 설정의 정상 작동 여부는 그래픽 클라이언트, 코어, 프로토콜 필드, 구독 내용이 올바르게 맞물리는지에 달려 있습니다.

Project V 프로토콜 및 프록시 도구 생태계

코어 계열

V2Fly

V2Fly는 Project V의 커뮤니티 유지 관리 흐름을 이어가며 설정을 해석하고 프로토콜을 구현하고 인바운드, 아웃바운드, DNS, 라우팅 등의 하위 기능을 처리합니다. 설정 파일의 inbounds, outbounds, routing, dns 객체는 코어 계층의 개념이며 특정 그래픽 클라이언트의 인터페이스 옵션과 동일하지 않습니다.

코어 계열

Xray

Xray는 유사한 생태계 기반에서 독립적인 유지 관리 경로로 발전했으며 VLESS, REALITY 등의 기능을 확장했습니다. 구독 노드에 특정 확장 필드가 포함되어 있다면 해당 필드를 지원하는 코어가 해석해야 합니다. Xray를 선택하는 핵심 이유는 프로토콜과 설정 기능의 적합성이며, 모든 클라이언트 이름을 같은 구현으로 보는 것은 적절하지 않습니다.

생태계의 역사: 핵심 기능에서 그래픽 인터페이스까지

Project V는 처음에 프로토콜 구현, 설정 구조, 프록시 기능의 집합으로 형성되었습니다. 데스크톱과 모바일 사용 수요가 늘면서 커뮤니티는 여러 운영 체제에 맞는 그래픽 클라이언트를 제작했습니다. 그래픽 클라이언트는 구독 관리, 노드 선택, 시스템 프록시, 로그 표시, 설정 편집을 담당하고, 코어는 연결 수립, 라우팅 실행, 프로토콜 세부 처리를 담당합니다. 두 계층을 분리하면 인터페이스는 플랫폼에 맞춰 발전하고 하위 기능도 각자의 유지 관리 경로를 따라 계속 업데이트될 수 있습니다.

따라서 ‘V2Ray 클라이언트’는 일반적으로 생태계를 가리키는 표현이지 단일 설치 프로그램을 뜻하지 않습니다. v2rayN은 데스크톱 시스템용이고 v2rayNG와 v2flyNG는 Android용이며, 인터페이스·코어 경로·사용 환경이 완전히 같지는 않습니다. 다운로드 전에 기기 플랫폼을 확인하고 노드 프로토콜을 살펴보면 잘못된 아키텍처나 코어 선택으로 인한 가져오기 실패를 줄일 수 있습니다.

오픈 소스 라이선스: 코드, 문서, 변경 이력 추적

Project V 관련 코어와 클라이언트는 오픈 소스 방식으로 유지 관리되며 각 프로젝트가 명시한 오픈 소스 라이선스에 따라 코드가 배포됩니다. 오픈 소스 라이선스는 복제, 수정, 배포, 라이선스 고지 유지 시 지켜야 할 조건을 규정합니다. 일반 사용자에게 중요한 점은 릴리스 기록, 문서, 커뮤니티 논의를 통해 기능 변화를 지속적으로 검토할 수 있다는 사실입니다. 2차 개발자는 배포 전에 해당 프로젝트의 라이선스 원문을 확인해야 합니다.

오픈 소스라고 해서 모든 클라이언트가 같은 팀에서 같은 일정으로 출시되는 것은 아닙니다. v2rayN, v2rayNG, v2flyNG는 각각 인터페이스 적용과 릴리스 과정을 독립적으로 관리하며 하위 코어도 별도의 변경 주기를 가집니다. 설정 차이가 발생하면 먼저 클라이언트 이름, 코어 계열, 프로토콜 매개변수를 확인한 뒤 현재 조합에 맞는 안내를 읽어야 합니다.

세 가지 클라이언트: 플랫폼과 코어 경로에 따른 역할

v2rayN은 데스크톱의 주요 그래픽 클라이언트로 Windows, macOS, Linux를 지원하며 여러 구독 관리, 라우팅 편집, 시스템 프록시 전환, 실행 로그 확인에 적합합니다. v2rayNG는 Android에서 널리 사용하는 Xray 계열 클라이언트로 Xray 프로토콜 확장 기능이 필요한 노드에 적합합니다. v2flyNG는 V2Fly 코어를 사용하며 V2Fly 계열의 모바일 선택지로 활용할 수 있습니다.

세 클라이언트 모두 유사한 노드 설정과 구독 사용 환경을 중심으로 하지만 이름만으로 기능이 완전히 같다고 판단할 수는 없습니다. 일부 필드는 코어 지원 범위의 영향을 받고, 일부 작업은 시스템 권한과 그래픽 인터페이스 구현에 따라 달라집니다. 가장 안정적인 선택 순서는 기기 플랫폼, 노드 프로토콜, 프로세서 아키텍처, 클라이언트 인터페이스를 차례로 확인하는 것입니다.

업데이트 방식: 클라이언트, 코어, 구독은 각각 변경됩니다

업데이트는 보통 세 계층으로 나뉩니다. 클라이언트 업데이트는 인터페이스, 시스템 호환성, 설정 관리 방식을 바꾸고, 코어 업데이트는 프로토콜 구현, 라우팅 동작, 하위 호환성을 조정합니다. 구독 업데이트는 구독 소스가 새로운 노드 목록을 반환하는 과정입니다. 이 세 가지 업데이트는 서로 독립적이므로 구독 새로 고침 실패가 클라이언트 재설치를 의미하지 않으며, 클라이언트 인터페이스 업데이트가 노드 설정을 자동으로 바꾸지도 않습니다.

업데이트 문제를 해결할 때는 현재 설정을 먼저 기록하고 로그를 확인하세요. 구독 실패는 주소와 네트워크 경로를, 프로토콜 오류는 코어 지원 여부를, 시스템 프록시가 작동하지 않는 문제는 클라이언트 모드와 시스템 설정을 중점적으로 확인합니다. 문제를 올바른 계층으로 분류하는 것이 모든 설정을 한꺼번에 교체하는 것보다 효과적입니다.

quick.checklist

자주 묻는 질문

아래 질문은 처음 사용할 때 가장 혼동하기 쉬운 과정을 다룹니다. 전체 작업 경로와 문제 해결 순서는 가이드 페이지에 정리되어 있습니다.

v2rayN에서 구독을 가져온 뒤 노드가 표시되지 않는 이유는 무엇인가요?

먼저 잘린 텍스트가 아닌 전체 구독 주소를 가져왔는지 확인하세요. 그런 다음 해당 구독 그룹을 수동으로 업데이트하고 업데이트 알림이나 로그를 확인합니다. 주소에 접근할 수 있는데도 목록이 비어 있다면 반환된 내용이 클라이언트가 지원하는 구독 형식인지 확인해야 합니다. 모든 설정을 서둘러 삭제하지 말고 그룹을 유지하면 문제가 주소, 네트워크 경로, 조회 과정 중 어디에서 발생했는지 판단하기 쉽습니다. 구독 가져오기 단계 보기 →

vmess:// 및 vless:// 링크와 구독 주소는 어떻게 다른가요?

공유 링크 하나는 보통 하나의 노드에 대응하며 주소, 포트, 식별자, 전송 매개변수를 포함합니다. 구독 주소는 업데이트 가능한 노드 목록을 반환합니다. 공유 링크는 단일 노드 가져오기에, 구독은 여러 노드를 지속적으로 관리하는 데 적합합니다. 클라이언트에서 사용하는 메뉴가 다를 수 있으며, 단일 노드 링크를 구독 업데이트 입력란에 넣고 원격 목록이 자동 생성되기를 기대해서도 안 됩니다. 가져오기 방식 보기 →

클라이언트는 연결되었다고 표시되지만 웹페이지가 열리지 않을 때 무엇을 먼저 확인해야 하나요?

노드, DNS, 라우팅, 시스템 프록시 순서로 확인하세요. 먼저 사용 가능한 것으로 확인된 노드로 바꾸고 도메인 조회 오류가 있는지 살펴봅니다. 그다음 간단한 라우팅으로 임시 전환하여 규칙에 의한 오차단을 배제하고, 마지막으로 시스템 프록시 모드가 실제로 활성화되어 있는지 확인합니다. 매번 한 가지 설정만 변경하고 로그 변화를 관찰해야 문제가 어느 계층에 있는지 파악할 수 있습니다. 연결 확인 절차 보기 →

v2rayNG와 v2flyNG는 어떻게 선택해야 하나요?

먼저 구독 노드의 프로토콜 요구 사항을 확인하세요. Xray 확장 기능이 필요하면 Xray 코어를 사용하는 v2rayNG를 선택합니다. 설정이 V2Fly 지원 범위에 속하고 V2Fly 코어 경로를 사용하려면 v2flyNG를 선택할 수 있습니다. 인터페이스가 비슷해도 하위 기능이 같은 것은 아니므로 가져오기 전에 프로토콜, 보안 매개변수, 전송 방식을 확인하는 것이 안전합니다. 클라이언트 선택 안내 보기 →

technical.notes