오픈 소스 GUI 클라이언트구독 가져오기 · 라우팅 분기

V2Ray GUI 클라이언트v2rayN 및 v2rayNG

v2rayN 다운로드 사용법 보기

구독 가져오기부터 라우팅 분기까지, 기기에 맞는 클라이언트를 선택하고 한국어 설정 가이드에 따라 연결을 완료하세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY
공유 링크 가져오기 vmess:// · vless:// · trojan:// · ss://

CONFIGURATION

구독·라우팅·프록시 설정

설정에서는 세 가지를 구분해야 합니다. 클라이언트는 조작 화면을 제공하고, 코어는 연결을 처리하며, 구독은 서버 정보를 제공합니다. 가져오기에 성공해도 설정을 인식했다는 뜻일 뿐입니다. 사용할 서버를 선택하고 트래픽 진입 방식과 라우팅을 확인해야 합니다. 아래 화면은 설정 예시이며 메뉴 이름은 클라이언트 버전에 따라 달라질 수 있습니다. 실제 조작은 설치된 버전을 기준으로 하세요.

v2rayN 구독 가져오기

구독 주소는 여러 서버 설정을 한 번에 가져오고 업데이트할 때 사용하며, 공유 링크는 대개 서버 설정 하나를 가리킵니다. 데스크톱에서는 먼저 구독 그룹에 주소를 저장한 뒤 업데이트를 실행하세요. Android에서는 구독 설정에 주소를 추가하거나 클립보드에서 공유 링크를 가져올 수 있습니다. 업데이트 실패를 쉽게 확인할 수 있도록 그룹 이름은 출처나 용도별로 구분하는 것이 좋습니다. 구독을 사용하면 항목을 하나씩 입력하는 수고를 줄일 수 있지만, 로컬 라우팅 설정까지 자동으로 동기화되지는 않습니다. 업데이트 후에는 프로토콜 유형과 활성 서버를 확인해 목록 갱신을 연결 성공으로 착각하지 않도록 하세요.

구독 가져오기 단계 보기 →

구독 그룹 설정

별칭출처를 기준으로 이름 지정
구독 주소구독 제공처의 주소 입력
업데이트 사용
구독 업데이트서버 설정 가져오기

구독과 단일 공유 링크는 서로 다른 가져오기 방식입니다. 원래 구독 주소를 보관해 두면 이후에도 같은 그룹으로 업데이트할 수 있습니다. 직접 수정한 서버 매개변수는 구독 업데이트 때 덮어써질 수 있으므로 중요한 사용자 설정은 따로 저장하세요.

도메인·IP 라우팅 분기

라우팅은 코어로 들어온 요청을 직접 연결, 프록시 연결, 차단 중 어떤 경로로 보낼지 결정합니다. 평소에는 적절한 프리셋을 선택한 다음 필요한 도메인 규칙만 추가하면 됩니다. 규칙은 보통 위에서부터 순서대로 적용되므로 특정 서비스 규칙을 포괄적인 분류보다 앞에 두세요. geosite는 도메인 분류에, geoip는 IP 주소 분류에 사용하며 서로 바꿔 쓸 수 없습니다. 시스템 프록시를 바꾸는 것과 달리 라우팅 분기는 코어 내부의 출구를 선택합니다. 규칙을 추가한 뒤 다시 불러오고 로그에서 예상한 출구가 선택됐는지 확인하세요.

라우팅 분기 가이드 보기 →

라우팅 규칙 · 위에서부터 적용

geosite:private→ direct
geoip:private→ direct
geosite:cn→ direct
geosite:geolocation-!cn→ proxy

규칙 문법 예시입니다. 분류 데이터 파일과 출구 태그는 실제 설정에 맞아야 합니다. 텍스트를 복사하는 것만으로 규칙이 적용되는 것은 아닙니다.

시스템 프록시 세 가지 옵션

시스템 프록시 설정은 해당 설정을 따르는 앱이 클라이언트에 연결되는 방식을 정합니다. v2rayN에서는 보통 시스템 프록시 해제, 시스템 프록시 자동 설정, 시스템 프록시 변경 안 함을 선택할 수 있습니다. 처음 사용할 때는 서버를 선택한 뒤 자동 설정을 켜세요. 종료하기 전에는 필요에 따라 남은 설정을 해제하면 됩니다. 변경 안 함은 현재 시스템 설정을 유지한다는 뜻이지 프록시를 끈다는 뜻은 아닙니다. 전체 라우팅과 달리 시스템 프록시가 모든 프로그램의 트래픽을 강제로 가져가지는 않습니다. 브라우저, 터미널, 개발 도구가 각각 별도의 프록시 설정을 사용할 수도 있습니다.

시스템 프록시와 라우팅 모드 차이 보기 →

시스템 프록시

시스템 프록시 해제시스템 프록시 설정 제거
시스템 프록시 자동 설정로컬 클라이언트로 연결
시스템 프록시 변경 안 함현재 설정 유지
라우팅 모드트래픽 출구는 별도로 설정

먼저 트래픽이 클라이언트로 들어오는지 확인한 다음 출구 규칙을 점검하세요. 라우팅 모드만 바꿔서는 앱이 프록시 진입점을 사용하지 않는 문제를 해결할 수 없습니다.

TUN 모드와 코어 선택

TUN 모드는 가상 네트워크 인터페이스를 통해 트래픽을 전달하므로 시스템 프록시 설정을 따르지 않는 앱에 적합합니다. 다만 권한, 라우팅, DNS 설정도 함께 고려해야 합니다. 먼저 시스템 프록시로 기본 연결을 확인한 뒤 필요에 따라 TUN을 켜면 여러 설정을 동시에 바꾸는 일을 피할 수 있습니다. 코어 선택은 프로토콜과 전송 매개변수의 호환성에도 영향을 줍니다. 전환하기 전에 현재 설정과 클라이언트 지원 여부를 확인하세요. TUN은 트래픽을 전달하는 방식이지 별도의 노드 프로토콜이 아니며, 지연 시간을 줄여 주는 것도 아닙니다. 문제가 생기면 먼저 검증된 기본 설정으로 되돌리세요.

TUN 설정과 점검 순서 보기 →

TUN 및 코어 설정 예시

TUN 모드 사용
자동 라우팅
코어 유형
XrayV2Fly
DNS 설정라우팅 구성과 함께 확인

클라이언트마다 선택할 수 있는 코어와 TUN 구현이 다릅니다. 그림의 옵션은 설정 항목의 관계를 설명하기 위한 것으로, 세 클라이언트에 같은 설정 메뉴가 있다는 뜻은 아닙니다.

CLIENT SELECTION

운영체제에 맞는 V2Ray 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 고려하고 V2Fly 코어가 필요하다면 v2flyNG를 살펴보세요. 먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 사용할 수 있는 프로토콜은 클라이언트에 포함된 코어와 서버 매개변수에 따라서도 달라집니다. 클라이언트는 설정을 관리하는 프로그램이며 구독 주소나 원격 서버를 제공하지 않습니다.

Windows

v2rayN: 데스크톱 버전과 클래식 WPF 버전. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존의 익숙한 조작 방식을 유지합니다. 처음 설치한다면 두 버전의 화면 구성과 시스템 요구 사항을 확인한 뒤 사용 습관에 맞게 선택하세요.

설정을 가져온 뒤 사용할 서버를 선택하고 시스템 프록시 자동 설정을 켜세요. 브라우저는 연결되지만 개발 도구가 연결되지 않는다면 해당 도구의 프록시 옵션을 확인하세요. 인터페이스 버전을 바꾸기 전에 설정을 백업하고, 두 인스턴스를 동시에 실행해 포트가 충돌한 문제를 서버 장애로 오인하지 않도록 주의하세요.

다운로드 페이지로 이동 →

macOS

v2rayN: 칩에 맞는 설치 파일 선택. Apple Silicon과 Intel은 서로 다른 아키텍처의 설치 파일을 사용합니다. 이 Mac에 관하여에서 칩 또는 프로세서 정보를 확인하세요. 컴퓨터 외형이나 구입 연도만으로 판단하지 마세요.

앱을 처음 실행할 때는 시스템 안내에 따라 앱 출처와 권한을 확인하세요. 먼저 일반 프록시 방식으로 구독과 서버 매개변수가 올바른지 확인한 다음, 추가 권한이 필요한 기능을 설정하세요. 데스크톱 클라이언트의 화면 구성은 다른 운영체제와 비슷하지만 시스템 프록시와 네트워크 권한은 해당 운영체제가 관리합니다.

다운로드 페이지로 이동 →

Android

먼저 v2rayNG를 고려하고, v2flyNG는 대안으로 선택하세요. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 V2Fly 코어 생태계를 위한 클라이언트입니다. 비교적 최신 휴대전화는 대부분 arm64를 선택할 수 있습니다. 기기 아키텍처를 모르겠다면 다운로드 페이지의 안내를 확인한 뒤 범용 설치 파일을 고려하세요.

연결할 때 시스템 VPN 권한을 확인해야 합니다. 다른 VPN 앱이 동시에 실행 중이면 현재 연결과 충돌할 수 있습니다. 백그라운드 연결이 자주 끊긴다면 배터리 최적화와 백그라운드 실행 권한을 확인하세요. 데스크톱과 휴대전화에서 같은 구독 출처를 사용할 수 있지만 앱별 프록시, 라우팅, DNS 설정은 각각 확인해야 합니다.

다운로드 페이지로 이동 →

Linux

v2rayN: 배포판에 맞춰 deb 또는 rpm 선택. 먼저 배포판의 패키지 형식을 확인한 다음 x64 또는 arm64 아키텍처를 선택하세요. 설치 파일 형식은 프로그램 설치 방식을 결정할 뿐, 지원 프로토콜이나 연결 성능을 의미하지 않습니다.

데스크톱 환경에 따라 시스템 프록시를 처리하는 방식이 다를 수 있으며, 터미널 프로그램은 자체 환경 설정을 사용하는 경우가 많습니다. TUN이 필요하다면 관련 권한과 라우팅 변경 사항도 확인하세요. 앱이 실행됐지만 트래픽이 전달되지 않는다면 클라이언트를 바로 재설치하기보다 로컬 진입점과 앱 설정부터 점검하세요.

다운로드 페이지로 이동 →

모든 클라이언트 보기 →시스템 요구 사항, 아키텍처 선택, 설치 안내는 다운로드 페이지에서 확인할 수 있습니다.

PROJECT V / V2FLY / XRAY

오픈 소스 클라이언트와 코어 생태계

‘V2Ray’는 여러 클라이언트와 프로토콜을 통칭하는 말로 자주 쓰이지만 인터페이스, 코어, 프로토콜, 서버 서비스는 서로 다른 대상입니다. 각각의 차이를 알아두면 어떤 구성 요소를 업데이트할지, 어느 설정을 확인할지, 클라이언트 변경만으로 해결할 수 없는 문제가 무엇인지 판단하기 쉽습니다.

Project V: 설정 모델의 기반

Project V는 모듈형 프록시 도구를 중심으로 하며, V2Ray는 널리 사용되는 구현체 중 하나입니다. 인바운드, 아웃바운드, 라우팅은 설정을 이해하는 기본 틀입니다. 인바운드는 로컬 앱의 요청을 받고, 아웃바운드는 대상에 연결하는 방식을 정하며, 라우팅은 그 사이에서 경로를 선택합니다. GUI 클라이언트는 설정 항목을 메뉴와 목록, 스위치로 정리해 전체 설정 파일을 직접 다루지 않고도 일상적인 작업을 할 수 있게 해줍니다.

이 때문에 ‘구독 가져오기 성공’과 ‘웹페이지 접속 가능’은 서로 다른 점검 항목입니다. 구독은 연결 매개변수를 제공할 뿐입니다. 앱이 로컬 진입점을 사용하는지, 코어가 시작되는지, 원격 서버에 접속할 수 있는지는 각각 확인해야 합니다. 설정 가이드는 모든 문제를 연결 버튼 하나로 설명하지 않고 이 순서에 따라 안내합니다.

V2Fly와 Xray: 공통점과 차이점

V2Fly 커뮤니티는 V2Ray의 개발과 유지 관리를 이어가고 있으며, Xray는 관련 코드 기반에서 시작해 자체 프로토콜과 전송 기능을 발전시켜 왔습니다. 기본 개념은 상당 부분 공유하지만 설정 세부 사항과 새로운 기능 지원은 완전히 같지 않습니다. 익숙한 프로토콜 이름이 보여도 전송 방식, 보안 기능, 코어 지원 여부를 확인하세요. 파일 확장자만으로 호환성을 판단할 수는 없습니다.

예를 들어 REALITY는 TLS 핸드셰이크와 관련된 보안 기능이며, 임의로 바꿔 쓸 수 있는 프로토콜 이름이 아닙니다. 사용하려면 서버가 제공한 매개변수와 클라이언트 코어의 기능이 맞아야 합니다. 핸드셰이크 오류가 발생하면 화면에 표시된 이름만 바꾸지 말고 주소, 포트, 서버 이름, 관련 인증 매개변수를 확인하세요.

세 가지 클라이언트: 인터페이스와 오픈 소스 라이선스

v2rayN은 데스크톱용으로 서버 목록, 구독 그룹, 프록시 모드 등을 관리합니다. v2rayNG는 Android용으로 Xray 코어 기반의 모바일 GUI 설정을 제공합니다. v2flyNG는 V2Fly 코어를 사용하는 Android 클라이언트입니다. 세 클라이언트 모두 오픈 소스 소프트웨어이며, 구체적인 라이선스와 타사 구성 요소, 재배포 조건은 각 프로젝트에 포함된 문서를 확인하세요.

오픈 소스란 코드와 라이선스를 공개하는 방식을 뜻합니다. 모든 설정이 현재 기기에 적합하다는 의미도, 구독 출처를 판단할 필요가 없다는 의미도 아닙니다. 구독 주소에는 접근 자격 증명이 포함될 수 있으므로 화면 캡처나 로그를 공유하기 전에 주소, 계정 식별 정보, 인증 매개변수를 가리세요. 클라이언트 이름이 비슷하다고 해서 로컬 백업 파일을 그대로 덮어쓸 수 있는 것은 아닙니다.

업데이트와 유지 관리: 먼저 백업하고 확인하기

인터페이스 프로그램, 프록시 코어, 규칙 데이터는 각각 업데이트될 수 있습니다. 인터페이스 업데이트는 조작 위치에 영향을 주고, 코어 업데이트는 프로토콜 처리 방식을 바꿀 수 있으며, 규칙 데이터 업데이트는 도메인과 IP 주소 분류에 영향을 줍니다. 업데이트 전에 구독 정보와 로컬 사용자 규칙을 저장하고 변경 사항을 확인하세요. 업데이트 후에는 작동이 확인된 설정 하나로 먼저 검증한 다음 복잡한 라우팅을 복원하면 어느 구성 요소에서 변화가 생겼는지 파악하기 쉽습니다.

이 사이트는 다운로드 경로와 한국어 사용 안내를 정리하며, 상위 프로젝트 개발팀을 대변하거나 노드 및 구독 서비스를 제공하지 않습니다. 가이드에 나온 설정 화면은 조작 원리를 설명하기 위한 예시이며 실제 메뉴는 달라질 수 있습니다. 연결 문제가 발생하면 먼저 발생 조건과 관련 로그를 기록한 뒤 로컬 진입점, 코어 실행, 원격 매개변수 순서로 점검하세요. 모든 설정을 한꺼번에 초기화하는 것보다 원인을 찾기 쉽습니다.

READING NOTES

V2Ray 속도 테스트, 로그, 설정 동기화

기본 연결을 마친 뒤에는 테스트 결과 해석, 로그를 통한 문제 추적, 여러 기기에서 일관된 설정 출처를 유지하는 방법을 주로 살펴보게 됩니다. 각 글은 관찰된 현상을 먼저 설명하고 점검 순서를 제시해, 한 번의 테스트 결과를 장기적인 결론으로 여기지 않도록 돕습니다.

고급 활용

V2Ray 지연 시간 테스트: TCPing, 실제 연결 지연 시간, 다운로드 속도 측정의 차이

v2rayN과 v2rayNG의 세 가지 속도 테스트 방식을 살펴봅니다. TCPing은 핸드셰이크만 측정하고 실제 연결 지연 시간은 전체 프록시 경로를 거치며, 다운로드 속도 측정은 처리량을 확인합니다. 각 방식의 용도와 흔한 오해도 설명합니다.

핸드셰이크 응답이 있다고 해서 대상 웹사이트에 접속할 수 있는 것은 아니며, 다운로드 속도만으로 실제 사용감을 판단할 수도 없습니다. 결과를 비교하려면 먼저 테스트 대상과 경로를 확인하세요.

글 읽기 →
문제 해결

v2rayN 로그 읽는 법: 자주 나오는 오류와 단계별 원인 파악

로그 수준 설정부터 connection refused, i/o timeout, failed to handshake 등 자주 발생하는 오류의 의미까지 설명하고, 로컬 포트에서 원격 설정까지 점검하는 순서를 안내합니다.

같은 오류 로그도 서로 다른 단계에서 발생할 수 있습니다. 마지막 오류 문구만 검색하기보다 발생 시점, 대상 주소, 앞뒤 로그를 함께 확인하는 편이 효과적입니다.

글 읽기 →
플랫폼

v2rayN·v2rayNG 여러 기기 설정 동기화: 구독, 공유 링크, 백업 및 이전 방법

구독 주소를 통합 관리하는 방법, 공유 링크와 QR 코드로 설정을 주고받는 방법, 설정 파일을 백업하고 이전하는 방법을 비교합니다. PC와 Android 휴대전화에서 서버와 라우팅 설정을 일치시키는 요령도 안내합니다.

구독 출처를 동기화해도 모든 로컬 설정이 함께 동기화되는 것은 아닙니다. 이전하기 전에 서버 매개변수, 라우팅 규칙, 기기 권한을 구분해 설정이 덮어써지는 일을 줄이세요.

글 읽기 →

모든 글 보기 →프록시 모드 선택과 프로토콜 차이도 확인해 보세요.