v2rayN · v2rayNG · v2flyNG 질문과 답변

V2Ray 클라이언트 질문과 답변 v2rayN 다운로드와 설정

클라이언트 선택부터 구독 가져오기까지, 실제 메뉴를 따라 라우팅과 프록시 설정을 안내합니다.

  • VMess
  • VLESS
  • Trojan
  • REALITY
커널 계열

Xray
V2Fly

GUI와 커널의 역할

클라이언트 설정 질문과 답변

질문으로 설정 항목 찾기

주소, 프로토콜, 프록시 연결 방식을 먼저 구분한 뒤 설정을 변경하세요. 아래 메뉴 이름은 기능을 찾는 데 참고할 수 있습니다. 실제 메뉴 구성은 클라이언트 업데이트에 따라 달라질 수 있으니, 같은 이름의 항목이 없다면 데스크톱 버전인지 Android 버전인지 먼저 확인하세요.

프로토콜과 전송 방식

서버 설정에 맞는 클라이언트 선택

프로토콜은 서버 설정에 따라 결정되므로 이름만 VLESS로 바꾼다고 연결되는 것은 아닙니다. VMess, VLESS, Trojan 공유 링크를 가져올 때는 주소, 포트, 인증 정보, 전송 방식과 보안 설정을 그대로 유지해야 합니다. REALITY는 보안 메커니즘이며 독립적인 노드 프로토콜이 아닙니다. 처음 설정할 때는 링크를 통째로 가져오고 항목을 추측해 입력하지 마세요. 링크에 클라이언트가 인식하지 못하는 필드가 있다면 커널 호환성을 확인하세요. GUI 클라이언트를 사용하면 설정 항목을 비교하기 편하지만, 서버에서 제공한 정확한 값을 사용해야 합니다.

프로토콜vless
streamSettings.securityreality
프로토콜 용어 설명 보기 →

클라이언트 다운로드

운영체제와 아키텍처에 맞는 설치 파일 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. 기기 아키텍처를 확인한 뒤 설치 형식을 선택해야 합니다. 프로토콜 이름이 같아도 모든 클라이언트가 같은 추가 매개변수를 읽을 수 있는 것은 아닙니다. 아래 링크를 누르면 다운로드 페이지의 해당 플랫폼 섹션으로 이동하며, 다운로드가 바로 시작되지는 않습니다.

Windows

v2rayN은 Desktop 버전과 클래식 WPF 버전을 제공합니다. Desktop은 크로스 플랫폼 인터페이스를 사용하고, WPF는 기존 데스크톱 사용 방식을 유지합니다. 처음이라면 다운로드 페이지에서 추천하는 순서에 따라 선택하고 두 버전을 모두 설치할 필요는 없습니다. 설치 전에 운영체제 버전과 실행 환경 요구 사항을 확인하세요. 압축 해제형 프로그램은 고정된 폴더에 두어 다운로드 폴더를 정리할 때 설정 파일까지 함께 옮기거나 삭제하지 않도록 하세요.

실행한 뒤 먼저 구독을 가져오고 유효한 설정을 선택한 다음 시스템 프록시를 설정하세요. 창을 닫아도 프로그램이 종료되지 않고 시스템 트레이로 최소화될 수 있으므로, 종료하기 전에 프록시 상태를 확인해야 합니다. 종료 후 브라우저에서 인터넷에 연결되지 않는다면 시스템 프록시가 중지된 로컬 포트를 계속 가리키는지 먼저 확인하세요.

Windows 다운로드 페이지로 이동

macOS

v2rayN 설치 파일은 Apple Silicon과 Intel용으로 나뉩니다. 시스템 메뉴의 ‘이 Mac에 관하여’를 열어 칩 이름이 표시되면 보통 arm64, Intel 프로세서라고 표시되면 x64를 선택하세요. 컴퓨터를 구입한 연도만으로 아키텍처를 판단하거나, 아키텍처가 다른 설치 파일을 기능이 다른 버전으로 생각하지 마세요.

앱을 ‘응용 프로그램’ 폴더에 넣은 뒤 실행하세요. 처음 열 때 시스템 보안 알림이 나타나면 출처를 확인하고 시스템 안내를 읽으세요. 앱 하나를 실행하기 위해 전체 보안 보호를 해제하는 것은 권장하지 않습니다. 시스템 프록시와 TUN에 필요한 권한은 서로 다르므로 실제 필요한 권한만 각각 허용하세요. 연결에 문제가 있으면 일반 프록시 모드로 돌아가 먼저 확인하세요.

macOS 다운로드 페이지로 이동

Android

Xray 커널을 사용하는 v2rayNG를 우선 추천하며, V2Fly 커널을 사용하는 v2flyNG도 대안으로 제공합니다. 최신 스마트폰 대부분은 arm64 패키지를 사용할 수 있습니다. 기기 아키텍처를 모른다면 시스템 정보를 확인하거나 다운로드 페이지의 범용 패키지를 이용하세요. 두 클라이언트의 설정과 기능 범위는 각각 확인해야 하며, 내보낸 파일이 완전히 호환된다고 가정해서는 안 됩니다.

처음 연결할 때 시스템 VPN 권한을 확인해야 합니다. 같은 사용자 공간에서 실행 중인 다른 VPN 앱이 연결 자원을 두고 충돌할 수 있습니다. 백그라운드에서 한동안 실행한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 활동 권한을 먼저 확인하고 클라이언트 로그를 살펴보세요. 연결 끊김을 모두 구독 만료 탓으로 돌리지 마세요.

Android 다운로드 페이지로 이동

Linux

v2rayN은 deb와 rpm 설치 형식을 제공하며, 각각 x64와 arm64로 나뉩니다. Ubuntu·Debian 계열 데스크톱에서는 보통 deb를, Fedora 등에서는 보통 rpm을 선택하세요. 설치 형식은 배포판에, 프로세서 아키텍처는 기기에 맞춰야 합니다. 그래픽 패키지 설치 프로그램에서 해당 파일을 열기 전에 다운로드 페이지에 적힌 데스크톱 환경 및 의존성 안내를 확인하세요.

데스크톱 환경의 시스템 프록시 설정을 모든 앱이 사용하는 것은 아닙니다. 브라우저에서는 연결되지만 다른 프로그램에서 실패한다면 클라이언트를 바로 다시 설치하지 말고 해당 프로그램의 프록시 설정을 확인하세요. 로그인 후 자동 실행을 설정하려면 먼저 수동 실행과 종료가 정상적으로 되는지 확인하세요. 그렇지 않으면 백그라운드에서 프로그램이 중복 실행될 수 있습니다.

Linux 다운로드 페이지로 이동

빠른 시작 미리보기

가져오기, 선택, 확인의 세 단계

클라이언트 다운로드를 마쳐도 사용할 수 있는 서버 설정이나 구독 주소가 필요합니다. 클라이언트 자체가 서버 연결 정보를 만들어 주지는 않습니다. 출처가 확실한 링크를 준비한 뒤 아래 순서대로 진행하세요. 문제가 생기면 해당 단계에서 멈춰 확인하고 여러 설정을 동시에 변경하지 마세요.

1단계 · 주소 추가

구독 주소를 구독 그룹에 추가

데스크톱에서는 v2rayN의 ‘구독 그룹’을 열고 알아보기 쉬운 이름과 전체 주소를 입력한 뒤 저장하고 업데이트를 실행하세요. Android에서는 v2rayNG의 ‘구독 그룹 설정’으로 이동해 그룹을 추가하고 활성화한 다음 홈으로 돌아와 업데이트하세요. 주소를 저장하는 것만으로 서버 항목을 가져온 것은 아닙니다. 다음 단계로 넘어가기 전에 목록에 해당 그룹의 설정이 나타났는지 확인하세요.

vmess:// 또는 vless://로 시작하는 단일 공유 링크를 받았다면 구독 주소 입력란이 아니라 클립보드 가져오기나 QR 코드 스캔을 이용하세요. 구독 링크에는 접근 자격 정보가 포함될 수 있으므로, 화면을 캡처하거나 도움을 요청할 때는 전체 주소를 가려 사용 가능한 설정이 공개되지 않도록 하세요.

v2rayNG 메뉴 경로

구독 그룹 설정

그룹 추가 → 메모와 주소 입력 → 저장

홈으로 돌아가기 → 구독 업데이트 → 그룹 항목 확인

2단계 · 연결 설정

설정을 선택한 다음 프록시 활성화

서버 목록에서 사용할 설정을 선택하세요. v2rayN에서는 먼저 ‘시스템 프록시 자동 설정’을 선택하고, 사용 목적에 맞는 프리셋으로 라우팅을 시작할 수 있습니다. v2rayNG에서는 연결 버튼을 누른 뒤 시스템에 표시되는 VPN 권한 요청을 확인하세요. 프록시 연결 방식은 트래픽을 클라이언트로 보내고, 라우팅 규칙은 클라이언트에 들어온 뒤 어느 출구로 보낼지 결정합니다. 두 설정을 따로 확인해야 합니다.

처음 연결할 때는 기본 DNS와 기본 라우팅을 유지하고 필요한 매개변수만 확인하는 것이 좋습니다. 처음부터 수신 포트, DNS, 규칙 세트, TUN을 모두 바꾸면 오류 원인을 찾기 어렵습니다. 다른 프록시나 VPN 도구가 실행 중이라면 충돌할 수 있는 연결을 먼저 중지한 뒤 확인하세요.

v2rayN 첫 연결 순서

사용할 설정 → 시스템 프록시

서버 선택 → 시스템 프록시 자동 설정

먼저 브라우저 연결을 확인하고, 필요할 때 TUN 모드를 고려하세요.

3단계 · 연결 확인

실행 성공과 실제 연결 구분하기

버튼에 연결됨이라고 표시되어도 일반적으로 로컬 프록시 서비스가 시작되었다는 뜻일 뿐, 원격 서버에 연결할 수 있다는 보장은 아닙니다. 평소 접속할 수 있는 웹페이지를 열어 기본 네트워크를 확인한 뒤 현재 설정으로 접속해야 하는 서비스를 테스트하세요. 로그에서 인증 실패, 도메인 확인 실패, 연결 시간 초과가 있는지도 확인해야 합니다. 오류 유형에 따라 점검할 항목이 다르므로 모든 문제를 포트 변경으로 해결하려 해서는 안 됩니다.

브라우저에서는 연결되지만 특정 앱에서만 실패한다면 해당 앱이 시스템 프록시를 따르는지 먼저 확인하세요. 모든 앱에서 실패한다면 활성 설정, 구독 유효성, 네트워크 상태를 점검하세요. 데스크톱 클라이언트를 종료하기 전에는 시스템 프록시를 해제하고, Android에서는 연결을 직접 끊으세요. 한 번에 한 가지 항목만 변경하면 이후 문제를 더 쉽게 해결할 수 있습니다.

문제 점검 순서

로컬 연결 지점 → 원격 연결

기본 네트워크 → 활성 설정 → 프록시 연결 방식 → 로그

오류 유형을 기록하고, 다른 사람과 공유하기 전에 주소와 인증 정보를 가리세요.

오픈소스 생태계와 유지 관리

클라이언트, 커널, 구독의 역할

이름에 V2Ray가 들어가도 같은 계층의 소프트웨어라는 뜻은 아닙니다. 각 구성 요소의 역할을 먼저 파악해야 클라이언트 선택과 문제 해결이 뒤섞이지 않습니다.

Project VXrayV2Fly

Project V와 커널 계열

V2Ray는 Project V 생태계에서 시작했으며, 핵심 역할은 설정에 따라 인바운드, 라우팅, 아웃바운드 연결을 처리하는 것입니다. V2Fly는 V2Ray 코어 개발을 이어가는 커뮤니티 프로젝트입니다. Xray는 관련 코드 기반에서 발전해 자체 기능과 개발 방향을 갖추었습니다. 두 프로젝트는 공통된 배경이 있지만 새로운 기능, 설정 필드, 호환 범위가 항상 일치하는 것은 아닙니다. 같은 프로토콜을 사용한다는 가이드를 보더라도 어떤 커널을 쓰는지, 전송 및 보안 설정은 무엇인지 확인해야 합니다. 프로토콜 이름만 비교해서는 충분하지 않습니다.

세 가지 GUI 클라이언트의 특징

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스 클라이언트로, 설정을 가져와 정리하고 커널에서 실행할 수 있도록 편리한 인터페이스를 제공합니다. v2rayN은 데스크톱용으로 구독, 시스템 프록시, 라우팅을 한곳에서 관리하기 좋습니다. v2rayNG는 Android에서 Xray를 사용하는 대표적인 선택지이며, v2flyNG는 V2Fly 계열의 Android 대안입니다. 클라이언트 화면에 특정 옵션이 표시되더라도 모든 커널이나 서버에서 사용할 수 있다는 뜻은 아닙니다. 연결에 필요한 조건이 모두 맞는지 확인해야 합니다.

오픈소스와 서비스 제공처는 별개

오픈소스란 해당 라이선스가 정한 조건에 따라 소스 코드를 공개한다는 뜻입니다. 허용되는 범위는 각 프로젝트와 의존성의 라이선스를 따릅니다. 클라이언트를 무료로 사용할 수 있다고 해서 원격 서버 자원까지 클라이언트 프로젝트가 제공하는 것은 아닙니다. 구독은 여러 서버 정보를 업데이트 가능한 하나의 주소로 배포하는 방식입니다. 구독 제공자, GUI 클라이언트 개발자, 커널 유지 관리자는 서로 다른 주체일 수 있습니다. 서비스를 선택할 때는 제공자의 정책을 별도로 확인하고, 클라이언트 이름을 서비스 품질이나 이용 가능성의 보증으로 여겨서는 안 됩니다.

업데이트 전에 복구할 수 있는 설정 백업

GUI, 커널, 규칙 데이터는 각각 별도로 업데이트될 수 있습니다. GUI 업데이트는 기능 메뉴와 설정 관리에 영향을 주고, 커널 업데이트는 지원하는 설정 필드를 바꿀 수 있습니다. 규칙 데이터 업데이트는 도메인이나 IP가 규칙과 일치하는 범위를 변경합니다. 업데이트 전에 필요한 설정을 백업하고 기존 프록시 모드를 기록하세요. 업데이트가 끝나면 ‘실행, 가져오기, 연결, 라우팅’ 순서로 하나씩 다시 확인하세요. 정상적으로 사용하는 설정에서 모든 구성 요소를 한꺼번에 교체하지 마세요. 호환성 문제가 생겼을 때는 변경 내역을 명확히 기록해 두면 반복해서 재설치하는 것보다 해결에 도움이 됩니다.

자주 묻는 질문

다운로드 전후 자주 헷갈리는 네 가지 개념을 먼저 정리하고, 필요한 용어를 더 살펴보세요.

클라이언트를 다운로드하면 바로 사용할 서버도 생기나요?

사용할 수 있는 서버 설정이나 구독 주소를 별도로 준비해야 합니다. GUI 클라이언트는 설정을 관리하고 연결을 처리할 뿐, 설치 파일이 원격 서비스를 만들어 주지는 않습니다. 링크를 받으면 단일 공유 링크인지 업데이트할 수 있는 구독 주소인지 먼저 구분한 뒤 알맞은 메뉴로 가져오세요. 두 링크의 형식은 용어 설명에서 확인할 수 있습니다.

구독 업데이트에 성공했는데도 연결되지 않는 이유는 무엇인가요?

업데이트 성공은 클라이언트가 구독 내용을 가져와 해석했다는 뜻일 뿐입니다. 원격 서버에 연결할 수 있는지, 인증 정보가 유효한지, 로컬 프록시 연결이 활성화되어 있는지는 각각 확인해야 합니다. 업데이트된 설정을 선택한 뒤 연결 로그를 살펴보세요. 설정을 가져온 것과 연결이 완료된 것을 혼동하지 마세요. 용어 설명에서 구독, 노드, 아웃바운드의 차이를 확인할 수 있습니다.

REALITY와 VLESS는 같은 설정인가요?

아닙니다. VLESS는 프로토콜이고 REALITY는 호환되는 프로토콜과 조합할 수 있는 보안 메커니즘입니다. 하나의 연결에는 전송 방식, 서버 이름, 기타 인증 필드도 포함될 수 있습니다. 이름 하나만 입력해서는 설정을 완료할 수 없습니다. 서버에서 제공한 매개변수를 모두 가져오고 프로토콜과 전송 용어에서 각 항목의 역할을 확인하세요.

TUN을 켜도 라우팅 규칙이 필요한가요?

대부분 필요합니다. TUN은 트래픽이 클라이언트로 들어오는 방식을 바꾸고, 라우팅은 들어온 트래픽을 어느 출구로 보낼지 결정합니다. TUN을 켠다고 모든 앱에 맞는 분할 라우팅 규칙이 자동으로 적용되는 것은 아니며 DNS 동작도 함께 고려해야 합니다. 클라이언트 기능과 라우팅 용어에서 두 기능의 차이를 이해한 뒤 현재 모드를 조정하세요.

블로그 · 설정 가이드

최신 가이드 3편

헷갈리기 쉬운 내용을 따로 살펴보세요. 설치 패키지 형식, 공유 링크 입력 메뉴, DNS 규칙은 각각 점검 방법이 다릅니다. 기본 연결을 먼저 확인한 뒤 필요한 주제를 읽고, 아직 검증하지 않은 설정에 고급 예제를 그대로 적용하지 마세요.