오픈 소스 클라이언트 및 설정 가이드

V2Fly 공식 사이트v2rayN 클라이언트

운영체제에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 시작하세요. 그런 다음 라우팅을 설정하고 연결을 확인하세요.

프로토콜
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

기기에 맞는 설치 파일 선택

데스크톱에서는 v2rayN을, 스마트폰과 태블릿에서는 v2rayNG 또는 v2flyNG를 사용할 수 있습니다. 먼저 운영체제를 확인하고 프로세서 아키텍처에 맞는 파일을 선택하세요. 같은 클라이언트라도 운영체제별 설치 방법은 다릅니다. 기기를 바꿀 때는 기존 구독 주소를 다시 가져오면 됩니다. 이전 기기의 포트, 프록시 모드, 규칙까지 그대로 옮길 필요는 없습니다.

Windows

v2rayN을 설치할 때는 데스크톱 버전과 클래식 WPF 버전 중 하나를 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용합니다. 오래된 가이드의 메뉴를 찾을 때는 먼저 스크린샷이 어느 인터페이스 기준인지 확인한 뒤 구독 그룹과 시스템 프록시 메뉴를 찾으세요.

포터블 폴더를 옮기기 전에 실행 중인 프로그램을 종료하고 설정을 백업한 다음 기존 로컬 수신 포트를 기록하세요. 이전 버전과 새 버전을 동시에 실행하면 두 번째 프로그램이 같은 포트를 사용할 수 없습니다. 버전을 바꾸기 전에 포트 충돌부터 확인하세요.

다운로드로 이동

macOS

‘이 Mac에 관하여’에서 칩을 확인한 다음 알맞은 v2rayN 설치 파일을 선택하세요. Apple 칩이라고 표시되면 Apple Silicon을, Intel 프로세서라고 표시되면 Intel을 선택합니다. 설치 후에는 디스크 이미지에서 계속 실행하지 말고 응용 프로그램 폴더에서 실행하세요.

브라우저가 클라이언트 설정을 따르지 않으면 현재 네트워크 서비스의 프록시 설정과 브라우저 자체 프록시 설정을 확인하세요. 클라이언트를 종료한 뒤 접속에 문제가 생기면 기존 네트워크 설정을 복원하고 같은 페이지에서 다시 테스트하세요.

다운로드로 이동

Android

우선 Xray 코어를 사용하는 v2rayNG를 확인하세요. 설정에서 v2fly 코어를 명시적으로 요구하는 경우에는 v2flyNG를 선택하면 됩니다. 최근 스마트폰 대부분은 arm64 패키지를 사용할 수 있습니다. 기기의 아키텍처를 모르면 범용 패키지와 시스템 요구 사항을 확인하세요.

처음 연결할 때 시스템에 표시되는 VPN 권한 요청을 확인하세요. 같은 사용자 환경에서는 기존 VPN 앱이 새 연결로 대체될 수 있습니다. 화면을 끈 뒤 연결이 끊기는 문제라면 설정을 바꾸기 전에 백그라운드 실행과 배터리 최적화부터 확인하세요.

다운로드로 이동

Linux

배포판에 맞는 v2rayN 패키지 형식을 선택하세요. Debian·Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 사용합니다. 패키지 형식과 아키텍처는 별도로 확인해야 합니다. 같은 형식이라도 x64와 arm64용 파일이 나뉠 수 있습니다.

설치했다고 해서 모든 앱이 데스크톱 프록시 설정을 따르는 것은 아닙니다. 그래픽 앱과 터미널에서 실행하는 도구는 각각 별도 설정이 있을 수 있습니다. 특정 프로그램만 연결되지 않는다면 클라이언트를 재설치하기 전에 해당 프로그램의 프록시 설정을 확인하세요.

다운로드로 이동

v2rayN 설정 항목

구독은 설정 목록을 업데이트하고, 라우팅은 요청이 이동할 경로를 정하며, 시스템 프록시와 TUN은 어떤 요청을 클라이언트로 보낼지 결정합니다. 여러 설정을 한꺼번에 바꾸기보다 각 항목을 나눠 확인해야 문제를 찾기 쉽습니다.

구독 출처마다 그룹을 따로 만들고 출처를 알아보기 쉬운 별칭으로 저장하세요. 주소를 붙여 넣은 뒤 현재 그룹을 직접 업데이트해 목록이 제대로 추가됐는지 확인하고, 이후 자동 업데이트를 설정할지 결정하세요. 링크를 하나씩 가져오는 것보다 그룹 단위로 업데이트하면 어느 출처의 내용이 바뀌었는지 확인하기 쉽습니다. 다만 업데이트 성공은 클라이언트가 설정을 읽었다는 뜻일 뿐, 목록의 모든 항목에 연결할 수 있다는 의미는 아닙니다. 목록이 비어 있다면 현재 선택된 그룹을 확인한 다음 구독 주소가 만료됐는지, 응답 내용을 클라이언트가 인식할 수 있는지 살펴보세요. 화면을 공유할 때는 전체 주소를 가리세요.

Project V, 코어 및 클라이언트

설정 안내에서는 클라이언트, 코어, 프로토콜을 통틀어 V2Ray라고 부르는 경우가 많습니다. 문제를 해결할 때는 이 세 계층을 구분하세요. 인터페이스는 설정을 관리하고, 코어는 설정을 해석해 연결하며, 프로토콜은 통신하는 양쪽이 데이터를 주고받는 방식을 정합니다. 먼저 문제가 발생한 계층을 찾은 뒤 무엇을 바꿀지 결정하세요.

클라이언트 3종 비교 →

Project V와 V2Fly

Project V는 이 생태계를 이해하는 출발점이며, V2Ray는 프록시 연결과 라우팅을 처리하는 핵심 프로그램입니다. V2Fly 커뮤니티는 관련 코어와 문서의 유지 관리를 이어가고, 데스크톱 및 모바일 그래픽 클라이언트는 각 프로젝트에서 관리합니다. 코어 관련 문서를 볼 때 그래픽 인터페이스에서 같은 이름의 항목을 그대로 찾을 필요는 없습니다. 같은 설정이 클라이언트에서는 구독, 라우팅 또는 전송 설정에 포함될 수도 있고 별도 항목이 없을 수도 있습니다.

문서가 현재 환경에 맞는지 확인하려면 먼저 그래픽 인터페이스 설명인지 코어 설정 설명인지 살펴본 다음 운영체제와 코어 계열이 일치하는지 확인하세요. 예를 들어 코어 문서의 인바운드 포트는 클라이언트가 로컬에서 요청을 받는 포트이지 구독 설정에 있는 원격 서버 포트가 아닙니다. 두 값을 잘못 설정하면 웹 페이지가 열리지 않는 증상은 비슷해도 로그를 확인할 위치는 다릅니다. 전자라면 로컬 수신 포트를, 후자라면 연결 매개변수를 먼저 점검하세요.

V2Fly와 Xray의 호환성 범위

Xray는 V2Ray 생태계에서 시작해 이후 독자적인 방향으로 개발되고 있습니다. 두 코어는 일부 프로토콜과 설정 개념을 공유하지만 전송 및 보안 기능은 서로 다를 수 있습니다. 설정 이름만으로 호환성을 판단할 수는 없습니다. 같은 프로토콜을 사용하더라도 전송 방식이 다르거나 보안 계층 필드가 다를 수 있습니다. 구독에서 제공한 원래 매개변수를 유지하고 제공자가 안내한 조합에 맞춰 코어를 선택하세요. 다른 연결의 매개변수를 섞어 쓰지 마세요.

코어를 바꾼 뒤에도 앱이 네트워크에 연결되지 않으면 시작 로그에서 처음 나타난 오류를 확인하세요. 필드를 인식하지 못한다는 오류라면 호환성 문제일 수 있고, 로컬 주소를 바인딩할 수 없다는 오류라면 포트 사용 여부부터 살펴보세요. 코어가 정상적으로 시작되고 요청이 실제로 코어를 통과하는지 확인한 뒤 원격 연결과 핸드셰이크를 점검하세요. 이렇게 하면 서로 다른 세 단계의 문제를 구독 오류 하나로 오해하지 않을 수 있습니다.

프로토콜 이름과 실제 연결 조건

오픈 소스 클라이언트와 코어를 사용하면 설정 필드와 프로토콜 구현을 공개적으로 확인할 수 있습니다. VMess, VLESS, Trojan, Shadowsocks는 프로토콜 이름이며 어떤 설정에서든 서로 바꿔 쓸 수 있는 옵션이 아닙니다. 연결 여부는 통신 양쪽이 프로토콜, 전송 방식, 필요한 보안 매개변수에 합의하는지에 달려 있습니다. 특히 VLESS라는 이름 자체를 암호화 방식으로 보면 안 됩니다. 실제 보안 계층은 각 설정을 확인해야 합니다.

처음 연결할 때는 설정 제공자가 지정한 조합을 그대로 사용해 기준 상태를 확인하세요. 핸드셰이크 오류가 발생하면 주소, 포트, 전송 방식, 보안 매개변수를 먼저 확인하고 기기 시간도 점검하세요. 프로토콜을 바꾸려면 상대편에서도 해당 프로토콜 설정을 제공해야 합니다. 클라이언트에서 옵션 하나만 바꾼다고 기존 연결이 다른 프로토콜로 바뀌지는 않습니다. 현재 기기에 맞는 조합을 알아보려면 먼저 코어 지원 범위를 비교한 뒤 네트워크와 기기 조건을 고려하세요.

오픈 소스 클라이언트 3종의 차이

v2rayN은 데스크톱에서 구독, 라우팅, 프록시 설정을 그래픽 인터페이스로 관리합니다. v2rayNG는 Xray를 주로 사용하는 모바일 클라이언트로, 시스템 VPN 인터페이스를 통해 트래픽을 연결합니다. v2flyNG는 v2fly 코어를 명시적으로 사용하는 설정을 위한 또 다른 오픈 소스 그래픽 클라이언트입니다. 사용할 클라이언트는 기기에서 실행할 수 있는지와 현재 설정의 코어 요구 사항을 기준으로 선택하세요. 아이콘이나 이름이 비슷하다는 이유로 여러 클라이언트를 함께 설치할 필요는 없습니다.

같은 구독을 여러 기기에서 사용하더라도 다시 가져온 뒤 플랫폼별 프록시 연결 방식을 확인하는 것이 좋습니다. 데스크톱의 시스템 프록시 설정은 구독과 함께 스마트폰으로 옮겨지지 않으며, 스마트폰의 VPN 권한과 앱별 설정도 데스크톱에 적용되지 않습니다. 한 기기에서만 연결된다면 양쪽에서 같은 설정을 선택하고 현재 코어와 네트워크 환경을 비교하세요. 그룹 이름이 같다는 이유만으로 두 기기가 같은 연결을 사용한다고 단정하지 마세요.

클라이언트, 코어, 구독은 각각 업데이트

인터페이스 업데이트, 코어 업데이트, 구독 새로 고침은 서로 다른 작업입니다. 인터페이스 업데이트는 메뉴 위치나 설치 요구 사항을 바꿀 수 있고, 코어 업데이트는 인식 가능한 필드를 바꿀 수 있습니다. 구독을 새로 고치면 기존 주소에서 설정 목록을 다시 가져옵니다. 설치 파일을 바꾸기 전에 그룹, 라우팅, 추가 설정을 백업하세요. 업데이트 후에는 한 번에 한 가지 변경 사항만 확인하세요. 먼저 프로그램이 실행되는지 확인하고, 이미 연결된 적 있는 설정 하나로 테스트한 다음 사용자 지정 라우팅을 복원하세요.

업데이트 직후 문제가 생겼다면 변경 시점, 사용 중인 플랫폼, 오류가 발생한 작업을 기록하고 관련 로그를 수집하세요. 로그를 공유할 때는 첫 번째 오류와 주변 몇 줄을 남기고 구독 주소, 인증 정보, 공개하지 않을 대상 주소는 삭제하세요. 특정 구독 그룹만 영향을 받았다면 해당 그룹의 업데이트 결과를 확인하면 됩니다. 정상적으로 사용하는 다른 그룹까지 삭제할 필요는 없습니다.도움말 센터 보기 →

기술 노트

클라이언트 선택, 문제 해결, 설치는 각각 확인 순서가 다릅니다. 연결은 됐지만 특정 앱에 문제가 있다면 로그부터 확인하세요. 클라이언트를 아직 설치하지 않았다면 첫 설치 체크리스트부터 살펴보세요. 설정과 클라이언트가 모두 같은 프로토콜 매개변수를 지원하는지 확인한 뒤 프로토콜을 비교해야 합니다.

선택 가이드

VMess·VLESS·Trojan·Shadowsocks 비교: 차이점과 사용 환경별 선택 가이드

암호화 방식, 핸드셰이크 오버헤드, 전송 계층 조합, 클라이언트 호환성 기준으로 네 가지 프록시 프로토콜을 비교하고 일반 웹 브라우징, 모바일 네트워크, 저사양 기기 등 사용 환경별 선택 방법을 안내합니다.

읽을거리: 사용 가능한 클라이언트와 서버 조합부터 범위를 좁힌 뒤 네트워크가 바뀔 때 연결이 어떻게 달라지는지 확인하세요.

문제 해결

V2Ray 실행 로그 확인법: 자주 발생하는 오류와 단계별 원인 파악

클라이언트 로그를 여는 방법과 로그 수준을 조정하는 방법을 안내하고 핸드셰이크 실패, 연결 시간 초과, 포트 충돌, 시간 불일치 등 대표적인 오류를 하나씩 설명합니다. 가까운 원인부터 확인하는 문제 해결 순서도 함께 소개합니다.

읽을거리: 시간순으로 첫 실패 지점을 찾고 시작, DNS 조회, 핸드셰이크 단계를 구분하세요. 마지막 오류 한 줄만 보지 마세요.

입문 가이드

v2rayN 첫 설치 설정 체크리스트: Windows·macOS 공통 절차와 주의사항

압축 해제 폴더, 실행 환경, 코어 유형, 로컬 포트, 시스템 프록시, 첫 구독 가져오기까지 v2rayN을 처음 사용할 때 필요한 설정을 순서대로 정리하고 초보자가 자주 놓치는 점도 안내합니다.

읽을거리: 처음에는 연결 하나를 완료하고 실제 사용 중인 포트와 프록시 모드를 확인한 다음 사용자 지정 규칙을 추가하세요.