설정 관리 · 화면 예시

설정을 가져온 다음 프록시를 켜세요

클라이언트는 설정을 관리하고 코어를 실행할 뿐, 서버나 구독을 자동으로 제공하지 않습니다. 신뢰할 수 있는 출처의 구독 링크를 준비하고 설정을 업데이트한 뒤 항목을 선택하세요. 마지막으로 현재 플랫폼에 맞는 트래픽 연결 방식을 활성화합니다.

화면의 ‘구독 업데이트’와 ‘서비스 시작’은 별개의 작업입니다. 앞 단계는 원격 설정을 가져오고, 뒤 단계는 로컬 코어를 실행합니다. 업데이트에 성공했다고 연결까지 완료된 것은 아닙니다.

구독 그룹라우팅 설정시스템 프록시
설정 출처구독 그룹 설정
가져오기 방식클립보드에서 가져오기
구독 작업현재 구독 업데이트
데스크톱 트래픽 연결시스템 프록시 자동 설정

설정 작업 공간

구독, 라우팅 및 코어 설정

설정 출처, 규칙에 따른 연결 결정, 트래픽 유입 경로를 먼저 구분한 뒤 세부 옵션을 조정하세요. 아래 이미지는 설정 항목을 설명하기 위한 예시이며 실제 클라이언트 화면이 아닙니다. 메뉴 위치는 사용 중인 클라이언트에 따라 다를 수 있습니다.

구독 그룹을 사용하면 출처가 다른 설정을 나누어 관리할 수 있습니다. 클라이언트에서 그룹을 추가하고 알아보기 쉬운 메모와 구독 주소를 입력해 저장한 다음 업데이트를 실행하세요. 이후 해당 그룹에서 항목을 선택하면 됩니다. 그룹 메모는 구분을 돕는 용도일 뿐 서버 매개변수를 바꾸지 않습니다. 설정을 하나씩 붙여 넣는 대신 구독을 사용하면 제공처에서 매개변수를 변경했을 때 한꺼번에 업데이트할 수 있지만, 원격에서 관리하는 항목이 덮어써질 수도 있습니다. 장기간 보관할 수동 수정 사항은 별도로 백업하세요. 구독 링크에는 보통 접근 자격 정보가 포함되므로 공개 스크린샷에 노출하거나 온라인 변환 서비스에 전달하지 마세요.

단계별 설정 문제 해결

구독 업데이트는 되지만 웹페이지가 열리지 않는다면 구독을 바로 바꾸기보다 트래픽이 로컬 클라이언트에 들어오는지부터 확인하세요. 코어가 정상적으로 시작했는지 확인한 다음 시스템 프록시가 로컬 포트를 가리키는지, 라우팅과 DNS는 정상인지 차례대로 점검합니다. 한 번에 조건 하나만 바꾸고 변경 전 설정을 보관해야 어떤 단계가 결과에 영향을 주었는지 파악할 수 있습니다. 여러 클라이언트가 동시에 시스템 프록시를 제어하거나 브라우저의 프록시 확장 기능을 별도로 사용하거나 다른 프로그램이 수신 포트를 점유하면 화면에 표시된 상태와 실제 접속 결과가 다를 수 있습니다.

‘전역 프록시’ 옵션을 찾았다면 먼저 어느 메뉴에 있는지 확인하세요. 시스템 프록시의 전역 설정, 클라이언트 라우팅의 전역 모드, TUN을 통한 트래픽 연결은 서로 다른 개념입니다. 시스템 프록시 설정은 앱이 요청을 프록시로 전달하는 방식에, 라우팅 모드는 전달된 요청의 경로에 영향을 줍니다. 용어가 헷갈린다면 먼저 용어집을 확인하세요. 항목별 설정 방법은 설정 가이드에서 최소 구성부터 따라 해볼 수 있습니다.

플랫폼별 안내

V2Ray 클라이언트 플랫폼별 다운로드

먼저 운영체제를 확인한 다음 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 코어 요구 사항에 따라 v2rayNG 또는 v2flyNG를 선택하면 됩니다. 설치 파일은 다운로드 센터에서 확인할 수 있으며, 홈페이지에는 버전 번호를 표시하지 않습니다.

Windows

v2rayN 추천

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고 WPF 버전은 익숙한 데스크톱 UI를 유지합니다. 시스템 요구 사항과 사용 습관에 맞춰 하나를 선택하고 두 클라이언트를 동시에 실행하지 마세요.

설치 전에 프로세서 아키텍처와 실행 환경을 확인하세요. 포터블 방식으로 사용할 때는 쓰기 권한이 있고 경로가 명확한 폴더에 프로그램을 압축 해제하세요. 압축 파일 안에서 바로 실행하면 안 됩니다. 처음에는 시스템 프록시를 사용해 브라우저 접속이 되는지 확인한 다음 TUN이나 다른 고급 옵션을 검토하세요.

macOS

v2rayN

v2rayN은 Apple Silicon과 Intel 프로세서용 다운로드를 각각 제공합니다. 먼저 ‘이 Mac에 관하여’에서 칩을 확인한 뒤 맞는 설치 파일을 선택하세요. 프로세서에 맞는 파일을 고르는 일과 구독 프로토콜은 별개이며, 설치 파일을 바꾼다고 설정이 자동 변환되지는 않습니다.

설치 후 시스템 안내에 따라 앱 권한을 설정하세요. 시스템 프록시를 활성화할 때는 현재 네트워크 서비스에 프록시 설정이 반영되었는지 확인합니다. 일부 앱에서만 문제가 생기면 해당 앱이 시스템 프록시 설정을 따르는지 먼저 살펴보세요. TUN이 필요하다면 가이드를 참고해 권한과 가상 인터페이스 상태를 확인하세요.

Android

v2rayNG 추천

v2rayNG는 Xray 코어를 사용해 관련 프로토콜을 지원하는 설정에 적합합니다. v2flyNG는 V2Fly 코어를 사용하며 설정 요구에 따라 선택할 수 있는 대안입니다. 대부분의 최신 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 모르겠다면 기기 정보를 확인하거나 범용 버전을 선택하세요.

처음 연결할 때 시스템 VPN 권한을 승인해야 합니다. 일반적으로 한 번에 하나의 앱만 해당 VPN 인터페이스를 사용할 수 있으므로 테스트 전에 다른 VPN 연결을 종료하세요. 앱을 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하고 같은 구독을 반복해서 가져오지는 마세요.

Linux

v2rayN

v2rayN은 deb 및 rpm 패키지를 제공하며 x64와 arm64 아키텍처를 구분합니다. 패키지 형식은 배포판의 패키지 관리 체계에 따라 달라지고, 프로세서 아키텍처는 기기에 따라 결정됩니다. 두 조건을 모두 맞춰야 하며 파일 확장자만 보고 호환 여부를 판단하면 안 됩니다.

데스크톱 환경과 브라우저, 앱마다 시스템 프록시를 사용하는 방식이 다를 수 있습니다. 먼저 그래픽 클라이언트에서 구독과 로컬 수신 설정을 마친 뒤 대상 앱의 프록시 설정을 확인하세요. TUN은 추가 권한과 네트워크 환경이 필요하며, 이미 가상 네트워크 인터페이스를 사용 중이라면 하나씩 점검해야 합니다.

전체 클라이언트 보기 →

트래픽 유입 경로 ≠ 라우팅 규칙

프록시 모드는 두 단계로 이해하기

앱은 먼저 시스템 프록시나 가상 인터페이스를 통해 요청을 클라이언트로 전달하고, 코어는 라우팅 규칙에 따라 연결 경로를 결정합니다. TUN을 켰다고 모든 요청이 원격 프록시를 거치는 것은 아니며, 분할 라우팅을 설정했다고 모든 앱의 트래픽이 자동으로 클라이언트에 들어오는 것도 아닙니다.

확인할 때는 대상을 하나 정하고 로그에 해당 요청이 나타나는지 살펴보세요. 요청 기록이 전혀 없다면 먼저 트래픽 유입 경로를 확인하고, 기록은 있지만 연결에 실패한다면 서버 설정, DNS 조회 결과와 아웃바운드 규칙을 점검하세요. 요청이 로그에 기록되는지는 현재 로그 수준에 따라 달라집니다.

설정 확인 순서
  1. 01
    앱 트래픽시스템 프록시 / TUN / VPN 모드
  2. 02
    코어 라우팅도메인 규칙 / 주소 규칙 / 기본 아웃바운드
  3. 03
    연결 방식직접 연결 / 프록시 / 차단

빠른 시작

구독 가져오기부터 연결 확인까지

처음 설정은 세 단계로 진행하세요. 먼저 기본 구성을 완성한 뒤 규칙, 자동 업데이트, TUN 같은 옵션을 추가합니다. 메뉴와 플랫폼별 차이는 전체 가이드에서 확인할 수 있습니다.

  1. 클라이언트 설치 및 구독 준비

    운영체제와 아키텍처를 확인한 다음 알맞은 클라이언트를 설치하고, 신뢰할 수 있는 출처의 구독 링크나 개별 설정을 준비하세요. 구독 주소는 일반 안내 페이지 주소와 다릅니다. 복사할 때 공백이나 줄바꿈, 설명 문구가 섞이지 않도록 주의하세요. 기존 설정이 있다면 먼저 백업하고, 백업에 구독 그룹과 라우팅, 앱 설정이 포함되는지 확인하세요. 노드만 들어 있는 파일을 전체 설정 백업으로 착각하지 않도록 주의해야 합니다.

    클라이언트는 설정을 관리할 수 있지만 유효한 서버 매개변수를 대신 만들어주지는 않습니다. 주소, 포트, 사용자 식별자와 전송 옵션은 하나의 완전한 설정에서 가져와야 합니다. 서로 다른 가이드의 항목을 조합해서 사용하지 마세요.

  2. 구독을 가져오고 설정 선택

    구독 관리에서 그룹을 추가하고 주소를 저장한 뒤 업데이트를 실행해 설정 항목이 표시되는지 확인하세요. 개별 공유 링크는 클라이언트의 가져오기 메뉴를 사용하면 됩니다. 사용할 항목을 선택하고 프로토콜이 현재 코어와 호환되는지 확인하세요. 업데이트에 실패하면 구독 주소가 여전히 유효한지, 현재 네트워크에서 구독 정보를 가져올 수 있는지 먼저 확인하세요. 모든 설정을 곧바로 삭제하지 마세요.

    구독 형식을 인식하지 못한다면 먼저 제공처에 호환되는 출력 형식을 문의하세요. 변환 도구는 지원하는 형식만 처리할 수 있으며, 누락된 매개변수를 복구하거나 코어가 지원하지 않는 프로토콜 기능을 추가할 수는 없습니다. 자격 정보가 포함된 주소는 출처가 불분명한 온라인 변환 서비스에 입력하지 마세요.

  3. 연결을 활성화하고 단계별로 확인

    데스크톱에서는 시스템 프록시를 켜고 Android에서는 VPN 권한을 승인한 뒤, 확인할 대상을 정해 접속하세요. 클라이언트에 실행 중이라고 표시되어도 로컬 서비스가 실행 중이라는 뜻일 뿐입니다. 실제 접속 결과와 로그도 확인해야 합니다. 문제가 있으면 코어 시작, 로컬 포트, 앱의 트래픽 유입 경로, DNS, 라우팅, 서버 설정 순으로 범위를 좁히세요. 여러 설정을 한꺼번에 바꾸지 마세요.

    테스트가 끝나면 클라이언트의 중지 및 시스템 프록시 해제 기능을 사용해 종료하세요. 브라우저가 이미 중지된 로컬 포트를 계속 가리키면 일반 웹페이지도 열리지 않을 수 있습니다. 원래 상태로 복구하려면 먼저 시스템 네트워크 설정을 확인한 뒤 클라이언트를 다시 실행할지 결정하세요.

전체 가이드 보기 →

Project V · V2Fly · Xray

오픈소스 생태계와 클라이언트별 역할

클라이언트 이름, 코어 이름, 프로토콜 이름은 서로 다른 계층에 속합니다. 플랫폼을 먼저 고려한 다음 설정에 필요한 프로토콜과 코어 기능을 확인하세요. 이름이 다른 모든 항목을 별개의 연결 서비스로 볼 필요는 없습니다.

Project V와 코어 계열

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈소스 생태계이며 V2Ray는 그중 주요 프로젝트입니다. V2Fly는 V2Ray 관련 개발을 이어왔고, Xray는 공통 기반을 바탕으로 자체 프로토콜 확장과 구현 방향을 발전시켰습니다. 두 프로젝트는 각자의 속도로 발전하고 있습니다. 이름이 비슷하다고 설정 필드가 항상 같다고 볼 수 없으며, 단순히 ‘새 버전이 이전 버전을 대체한다’고 설명하기도 어렵습니다.

사용자에게 중요한 차이는 결국 실제 기능에 있습니다. 설정에서 사용하는 프로토콜과 전송 방식, 보안 메커니즘을 현재 코어가 지원하는지 확인해야 합니다. 예를 들어 REALITY 설정을 사용하려면 해당 Xray 코어와 클라이언트가 설정 가져오기를 지원하는지 확인하세요. 로그에 알 수 없는 프로토콜이나 필드가 표시되면 네트워크 불안정으로 단정하기보다 호환성을 먼저 점검하세요. 자세한 차이는 선택 가이드에서 확인할 수 있습니다.

세 가지 그래픽 클라이언트의 역할

v2rayN은 데스크톱용 클라이언트로, 설정 목록과 구독 그룹, 라우팅, 시스템 프록시 기능을 그래픽 인터페이스에 모아 제공합니다. v2rayNG는 Android용이며 Xray 코어를 사용하고 시스템 VPN 인터페이스를 통해 앱 트래픽을 연결합니다. v2flyNG도 Android용으로 V2Fly 코어를 선택할 수 있습니다. 모두 오픈소스 클라이언트지만 화면 구성이나 메뉴 이름, 설정 백업 형식이 서로 호환된다는 뜻은 아닙니다.

데스크톱 가이드가 v2rayN을 기준으로 구성되어 있어 데스크톱에서는 v2rayN을 권장합니다. Android에서는 먼저 v2rayNG를 확인하고 코어 요구 사항에 따라 v2flyNG를 고려하세요. 대체 클라이언트는 기존 설정이 특정 코어 동작을 요구하는 등 분명한 이유가 있을 때 선택하는 것이 좋습니다. 여러 클라이언트를 동시에 실행해 효과를 더하려 하지 마세요. 여러 프로그램이 프록시 설정이나 VPN 인터페이스를 놓고 경쟁하면 문제 해결이 더 어려워집니다.

오픈소스 라이선스와 설정 출처는 별개

오픈소스란 각 프로젝트의 코드가 해당 라이선스에 정해진 조건에 따라 열람, 사용 또는 재배포될 수 있다는 뜻입니다. 구체적인 권리와 의무는 프로젝트에 포함된 라이선스를 확인하세요. 클라이언트 인터페이스와 코어, 포함된 구성 요소에 서로 다른 라이선스가 적용될 수 있으며, 한 구성 요소의 라이선스가 배포 패키지 전체의 라이선스를 대신하지는 않습니다. 오픈소스 클라이언트를 사용한다고 구독이나 서버 서비스가 자동으로 제공되는 것도 아닙니다.

구독 제공자는 설정 내용을 제공하고, 클라이언트는 이를 읽어 실행하며, 웹사이트 문서는 사용 방법과 개념을 안내합니다. 각 역할을 구분해서 이해하세요. 사용자 식별 정보가 포함된 구독 링크와 QR 코드, 내보낸 파일은 민감한 설정으로 취급해야 합니다. 문제를 해결하기 위해 로그를 공유할 때는 필요한 오류 내용만 남기고 서버 주소와 사용자 식별자, 구독 인증 정보는 먼저 삭제하세요. 전체 접속 정보를 공개된 게시판에 올리지 않도록 주의하세요.

클라이언트 업데이트와 코어 변경 사항 확인

클라이언트 업데이트는 인터페이스와 설정 생성 방식, 시스템 연동을 바꿀 수 있고, 코어 업데이트는 프로토콜 지원과 매개변수 처리에 영향을 줄 수 있습니다. 업그레이드 전에 현재 정상 작동하는 모드를 기록하고 설정을 백업하세요. 업그레이드 후에는 기존 설정으로 먼저 확인한 다음 기본 구성이 정상임을 확인하고 새 기능을 시도하세요. 문제가 생기면 재설치를 반복하기보다 시작 로그와 설정 변경 사항을 비교하는 편이 원인을 찾기 쉽습니다.

구독 업데이트, 규칙 데이터 업데이트, 프로그램 업데이트는 서로 다른 작업입니다. 구독 업데이트는 원격 설정을 새로 가져오고, 규칙 데이터 업데이트는 매칭 범위에 영향을 주며, 프로그램 업데이트는 클라이언트나 관련 실행 구성 요소를 교체합니다. 다운로드는 다운로드 센터에서 확인할 수 있습니다. 설치와 이전, 플랫폼별 문제는 전체 플랫폼 설치 및 설정 가이드에서 살펴보세요. 이미 증상이 분명하다면 다음 단계를 정하기 전에 자주 묻는 질문을 확인할 수도 있습니다.

설정 가이드

설치 과정과 코어 원리

기본 설정을 마친 다음 현재 문제와 관련된 가이드를 살펴보세요. 플랫폼 가이드는 설치와 설정 순서를 안내하고, 코어 비교는 호환성을 판단하는 데 도움을 주며, 원리 설명은 고급 옵션의 역할과 한계를 이해하는 데 유용합니다.

전체 글 보기 →

v2rayN 다운로드