V2RAY 데스크톱 클라이언트 · v2rayN

V2Ray PC버전 v2rayN 클라이언트 다운로드와 설정.

플랫폼 선택부터 구독 가져오기까지, 실제 설정을 바탕으로 라우팅과 로컬 프록시를 알아봅니다.

  • 오픈 소스
  • 다중 코어 설정
  • 한국어 설정 안내

작업 설정 안내 / CLIENT SETTINGS

v2rayN 설정 항목과 구성의 관계

먼저 트래픽이 클라이언트로 들어오는 방식을 확인한 다음, 클라이언트에서 나가는 경로를 정하세요.

클라이언트 화면의 모든 스위치가 설정 파일의 같은 이름을 가진 항목에 대응하는 것은 아닙니다. 시스템 프록시는 앱이 요청을 보내는 진입점이고, 라우팅 규칙은 사용할 아웃바운드를 고르며, 구독 그룹은 연결 정보를 정리합니다. 코어는 이렇게 만들어진 설정을 실행합니다. 각 단계를 나눠 보면 ‘실행했는데 연결되지 않는’ 문제도 진입점, 규칙, 아웃바운드 순서로 점검할 수 있어 모든 옵션을 한꺼번에 바꿀 필요가 없습니다. 아래 다섯 가지는 처음 설정할 때 자주 사용하는 항목입니다.

"listen": "127.0.0.1"

시스템 프록시는 브라우저로 연결을 먼저 확인할 때 유용합니다. 자동 설정을 선택하면 시스템 프록시를 따르는 앱이 요청을 로컬 인바운드로 전달합니다. 네트워크 연결을 자체 관리하는 앱은 직접 연결할 수도 있습니다. 위의 리스닝 주소는 코어의 인바운드 설정이며 시스템 프록시 스위치 자체를 뜻하지 않습니다. 앱마다 프록시를 직접 입력하는 것보다 한곳에서 켜고 끄기 쉽지만, 라우팅을 대신하지는 않습니다. 실제 리스닝 포트를 확인한 다음 웹페이지에 접속해 테스트하세요. 종료하기 전 시스템 프록시를 해제하면 중지된 로컬 서비스로 앱이 계속 접속하는 일을 막을 수 있습니다.

설정 참고 문서 보기 →

설치 파일 다운로드 / PLATFORM SELECTION

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

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 살펴보세요.

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 고르세요. 클라이언트 이름과 인터페이스 유형, 코어 이름은 서로 다른 계층을 가리킵니다. 인터페이스는 설정을 관리하고 코어는 연결을 처리하며, 설치 파일 형식은 운영체제의 설치 방식을 결정합니다. 다운로드 페이지에서 플랫폼별 다운로드 경로와 지원 정보를 확인할 수 있습니다. 처음에는 기본 설정을 유지하고 연결 정보 가져오기, 실행, 브라우저 테스트까지 한 번에 진행한 뒤 라우팅이나 가상 네트워크 설정을 하나씩 추가해 보세요.

Windows

v2rayN 추천

v2rayN은 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 여러 컴퓨터에서 비슷한 방식으로 사용하고 싶은 경우에 적합하며, WPF 버전은 기존 Windows 인터페이스에 익숙한 환경에 알맞습니다. 선택할 때는 운영체제 호환성을 먼저 확인하세요. 인터페이스 이름만 보고 두 버전을 모두 설치할 필요는 없습니다.

설치 후에는 로컬 리스닝 포트를 다른 프로그램이 사용 중인지 확인한 다음 연결 정보를 가져오세요. 브라우저에 프록시를 직접 입력한 적이 있다면 그 설정이 시스템 설정을 계속 덮어쓰는지도 확인해야 합니다. 두 인터페이스는 메뉴 위치가 다를 수 있으므로 문제를 해결할 때는 창 모양보다 실제 프록시 모드와 코어 상태, 로그 내용을 기준으로 살펴보세요.

macOS

v2rayN

컴퓨터의 칩에 따라 Apple Silicon 또는 Intel용 설치 파일을 선택하세요. 시스템의 ‘이 Mac에 관하여’에서 칩이나 프로세서 정보를 확인하는 편이 구매 연도로 추측하는 것보다 정확합니다. v2rayN 데스크톱 인터페이스는 구독과 설정을 관리하며, 시스템 프록시 권한과 네트워크 권한, 코어 실행 여부는 각각 따로 확인해야 합니다.

처음 실행할 때는 시스템 안내에 따라 앱 권한을 설정하세요. 한 번 설치하려고 시스템 보안 설정을 계속 낮춰 두는 것은 권장하지 않습니다. 일부 앱에서만 연결된다면 해당 앱이 시스템 프록시를 사용하는지 먼저 확인하세요. 더 많은 트래픽을 처리해야 한다면 Tun 모드와 시스템 라우팅 안내를 살펴보세요.

Android

v2rayNG 추천

Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 살펴보고, V2Fly 코어를 사용하는 v2flyNG를 대안으로 고려하세요. 비교적 최신 기기는 arm64 설치 파일을 사용할 수 있습니다. 아키텍처를 확인하기 어렵다면 다운로드 페이지의 범용 버전 안내를 참고하세요. 두 앱은 연결 정보를 각각 관리하므로 한쪽에 가져온 정보가 다른 앱에 자동으로 동기화되지는 않습니다.

연결을 시작할 때는 시스템 VPN 권한을 확인하세요. 이 권한은 앱이 로컬 가상 네트워크 인터페이스를 만들도록 허용하는 것이며, 사용 가능한 서비스에 연결됐다는 뜻은 아닙니다. 백그라운드에서 자주 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 특정 앱을 프록시에서 제외하거나 포함해야 한다면 앱별 프록시를 설정하고 목록이 포함 방식인지 제외 방식인지 확인해야 합니다.

Linux

v2rayN

배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 뒤 프로세서가 x64인지 arm64인지 확인하세요. 그래픽 데스크톱에서 v2rayN을 사용할 경우 데스크톱 환경이 시스템 프록시를 저장하는 방식도 살펴봐야 합니다. 같은 컴퓨터에서도 브라우저와 터미널 도구, 백그라운드 서비스가 서로 다른 프록시 설정을 사용할 수 있습니다.

설정을 시작할 때는 수동 프록시를 지원하는 앱 하나를 로컬 인바운드에 연결해 데스크톱 설정 문제와 코어 연결 문제를 나눠 확인하세요. Tun이 필요할 때 가상 인터페이스 권한과 라우팅 충돌을 점검하면 됩니다. 네트워크 관리 도구를 바꾼 뒤 연결이 간헐적으로 끊긴다면 DNS가 향하는 곳과 기본 경로가 달라졌는지도 함께 확인하세요.

전체 클라이언트 보기 →

빠른 시작 / FIRST CONNECTION

v2rayN 설정 안내: 먼저 세 단계부터

연결 정보를 가져오고, 진입 방식을 선택한 뒤 연결을 확인하세요. 한 번에 한 단계만 변경하세요.

STEP 01 / IMPORT

구독 또는 단일 연결 가져오기

클라이언트를 설치한 뒤에는 사용할 권한이 있는 연결 정보가 필요합니다. 구독 주소는 여러 항목을 가져오는 경로이고, 단일 공유 링크는 하나의 연결 정보를 담습니다. 둘은 일반 웹 주소처럼 임의로 바꿔 쓸 수 없습니다. 구독 그룹에 주소를 추가해 업데이트하거나 클립보드에서 단일 링크를 가져오세요. 완료되면 서버 주소와 포트, 프로토콜, 전송 설정이 출처의 정보와 일치하는지 확인하세요.

구독 링크를 공개 게시판에 올리지 말고, 도움을 요청할 때 캡처한 화면에 전체 접속 매개변수가 보이지 않도록 주의하세요. 목록에 항목이 나타났다는 것은 정보가 해석됐다는 뜻일 뿐, 서버를 현재 사용할 수 있다는 의미는 아닙니다. 목록이 비어 있다면 복사한 내용이 온전한지, 구독 업데이트가 필요한지 먼저 확인한 다음 프록시 모드를 살펴보세요. 정보 가져오기 실패를 라우팅 문제로 오해하지 않도록 주의해야 합니다.

가져오기 방법 보기 →

STEP 02 / MODE

연결과 프록시 모드 선택

사용할 연결 항목을 고르고 코어를 실행한 다음 현재 앱에 맞는 프록시 진입 방식을 켜세요. 처음에는 시스템 프록시부터 시험해 시스템 설정을 따르는 브라우저가 로컬 서비스에 연결되는지 확인하면 됩니다. 라우팅 모드는 요청이 연결된 뒤 어떻게 처리될지 정하고, 시스템 프록시는 앱이 요청을 넘기는 방식을 정합니다. 서로 다른 문제를 해결하는 설정이므로 앱이 프록시에 연결되지 않는 문제를 라우팅 전환으로 해결할 수는 없습니다.

처음에는 기본 라우팅과 DNS 설정을 유지하고 Tun을 켜거나 사용자 규칙을 대량으로 가져오지 마세요. 컴퓨터에서 다른 프록시나 VPN, 네트워크 가로채기 도구를 함께 실행 중이라면 시스템 프록시와 리스닝 포트, 기본 경로를 서로 차지하고 있지 않은지 확인하세요. 설정 파일을 대조할 때는 인바운드 주소와 포트, 아웃바운드 태그, 라우팅 규칙이 참조하는 태그가 서로 일치하는지 중점적으로 살펴보세요.

라우팅 설정 대조하기 →

STEP 03 / VERIFY

실제 요청으로 연결 확인

같은 브라우저에서 같은 테스트 대상으로 접속한 뒤 클라이언트 로그에 해당 요청이 나타나는지 확인하세요. 포트 테스트 성공은 연결의 한 단계가 성립했다는 뜻일 뿐, 전체 프록시 경로가 동작한다는 보장은 아닙니다. 실제 접속에는 프로토콜과 보안 협상, DNS, 라우팅도 영향을 줍니다. 테스트에 실패하면 로그에서 처음 나타나는 명확한 오류를 확인한 뒤 연결 정보와 서버, 로컬 진입점 중 어디를 점검할지 판단하세요.

특정 앱에서만 실패한다면 해당 앱의 프록시 설정을 먼저 비교하세요. 모든 요청이 실패한다면 코어가 실행 중인지, 선택한 연결 항목이 유효한지 확인해야 합니다. 설정을 하나 바꿀 때마다 같은 테스트를 반복하고 정상 작동하는 기준 상태를 유지하세요. 문제 해결 정보를 공유할 때는 운영체제와 클라이언트 인터페이스 유형, 선택한 코어, 오류 로그 일부를 기록하되 구독 주소와 사용자 식별 정보, 인증 정보는 삭제하세요.

문제 해결 FAQ 보기 →
전체 설정 안내 보기 →

오픈 소스 생태계 / PROJECT V

V2Ray, V2Fly, Xray 코어의 차이

클라이언트는 조작 화면, 코어는 연결 엔진, 프로토콜은 서로 간의 약속입니다.

‘V2Ray 공식 사이트’를 검색하면 프로젝트 문서와 코어 릴리스, 클라이언트 다운로드 페이지를 혼동하기 쉽습니다. 이 사이트는 그래픽 클라이언트의 다운로드 경로와 사용 안내를 정리하며, 프로토콜이나 코어 프로젝트의 공식 배포처가 아닙니다. 각 프로젝트의 역할을 이해하면 필요한 정보를 찾기 쉽습니다. 설치 문제는 클라이언트 안내를, 설정 항목의 동작은 해당 코어 문서를, 연결 매개변수는 서비스 제공자가 전달한 설정을 참고하세요.

Project V의 모듈식 설정 구조

Project V 생태계의 V2Ray는 인바운드와 아웃바운드, 라우팅 등의 모듈로 연결 처리를 구성합니다. 인바운드는 로컬이나 다른 프로그램에서 들어오는 요청을 받고, 아웃바운드는 요청을 다음 단계로 전달하는 방식을 설명하며, 라우팅은 둘을 연결합니다. 따라서 ‘서버 하나 선택하기’만으로 설정이 끝나지 않습니다. 앱 트래픽을 받아들이는 진입점과 요청을 올바른 아웃바운드로 보내는 규칙도 필요합니다. 그래픽 클라이언트는 자주 쓰는 기능을 한 화면에 모아 설정을 쉽게 하지만, 기반이 되는 구성 요소 간의 관계는 그대로 적용됩니다.

JSON을 읽을 때는 각 모듈의 태그와 참조를 먼저 찾은 뒤 프로토콜 매개변수를 확인하세요. 문법 오류가 없더라도 요청이 의도한 경로를 따른다고 볼 수는 없습니다. 예를 들어 규칙이 잘못된 아웃바운드 태그를 참조하거나 앱이 로컬 인바운드에 연결되지 않으면 접속할 수 없는 것처럼 보일 수 있습니다. 설정 참고 문서는 모듈별 항목의 용도를 설명하므로 기본 연결을 마친 뒤 필요한 부분을 차례로 살펴보세요. 작동 중인 설정 파일 전체를 한 번에 교체하는 방식은 피하는 것이 좋습니다.

V2Fly와 Xray의 발전 관계

V2Fly 커뮤니티는 V2Ray의 오픈 소스 개발과 유지보수를 이어가고 있습니다. Xray는 관련 코드 기반에서 출발해 독자적으로 발전한 코어 프로젝트로, 프로토콜과 보안, 전송 기능을 자체적으로 구현합니다. 두 코어는 일부 개념과 설정 방식을 공유하지만 프로그램 이름만 바꾸면 완전히 호환되는 것은 아닙니다. 연결에 필요한 코어를 고를 때는 ‘V2Ray’ 같은 분류명만 보지 말고 프로토콜과 전송 방식, 보안 옵션을 함께 확인하세요.

예를 들어 VLESS 프로토콜을 사용한다면 특정 보안 방식과 함께 쓰는지, 선택한 클라이언트가 현재 코어에 맞는 매개변수를 제대로 생성하는지도 확인해야 합니다. 코어가 기능을 지원하더라도 모든 클라이언트 인터페이스에 같은 설정 항목이 제공되는 것은 아닙니다. 가져오기는 성공했지만 실행되지 않는다면 계속 다시 가져오기보다 생성된 설정과 코어 요구 사항을 대조한 뒤 연결 항목을 조정하거나 코어를 바꾸는 편이 효과적입니다.

오픈 소스 클라이언트 세 가지의 역할

v2rayN은 데스크톱 환경에서 연결 정보 관리와 시스템 프록시, 라우팅, 다중 코어 설정 기능을 제공합니다. v2rayNG는 Android용 클라이언트로, 주로 Xray 코어와 함께 연결 및 로컬 VPN 진입을 처리합니다. v2flyNG는 Android에서 V2Fly 코어를 사용하는 대안입니다. 세 클라이언트 모두 오픈 소스 프로젝트로 관리되지만 클라이언트 코드와 호출하는 코어는 서로 다른 소프트웨어 구성 요소입니다. 각각의 출시 주기와 설정 지원, 라이선스 범위를 따로 확인해야 합니다.

v2rayN과 v2rayNG 클라이언트는 GPL 계열 오픈 소스 라이선스를, V2Fly와 Xray 코어는 MPL 계열 오픈 소스 라이선스를 사용합니다. 구체적인 적용 범위는 각 프로젝트에 포함된 라이선스 문서를 확인하세요. 오픈 소스란 코드와 라이선스 조건을 검토할 수 있다는 뜻이지, 모든 구독 출처를 신뢰할 수 있다는 뜻은 아닙니다. 클라이언트에 서버를 대체할 연결 리소스가 포함되는 것도 아니며, 실제 사용 가능 여부는 연결 정보와 네트워크 환경, 서버 설정에 달려 있습니다.

업데이트할 때는 인터페이스와 코어, 규칙을 따로 확인하세요

클라이언트 업데이트는 인터페이스와 가져오기 방식, 설정 생성 방식을 바꿀 수 있습니다. 코어 업데이트는 프로토콜 지원과 설정 항목의 동작에 영향을 줄 수 있으며, 규칙 리소스 업데이트는 대상 일치 결과를 바꿀 수 있습니다. 영향을 받는 계층이 서로 다르므로 ‘전부 업데이트했다’는 말만으로는 문제를 추적하기 어렵습니다. 업데이트 전에 정상 작동하는 설정과 필요한 옵션을 보관하고, 업데이트 후 기존 연결부터 다시 시험한 다음 새 기능을 활성화하세요. 동작이 달라졌다면 각 계층을 하나씩 비교해야 원인을 찾기 쉽습니다.

마찬가지로 구독 업데이트는 출처에서 연결 정보를 새로 가져오는 작업일 뿐, 클라이언트 프로그램이나 코어, 로컬 사용자 규칙을 반드시 업데이트하는 것은 아닙니다. 문제를 공유할 때 어느 계층을 업데이트했는지 설명하면 ‘업데이트 후 작동하지 않는다’고만 하는 것보다 도움이 됩니다. 안정적으로 작동하는 환경이라면 변경 안내를 먼저 읽고 현재 사용하는 프로토콜과 운영체제에 영향을 주는지 확인한 뒤 업데이트와 검증을 진행하세요. 여러 변경 사항을 한 번의 테스트에 겹치지 않는 것이 좋습니다.

최근 문서 / READING NOTES

클라이언트 선택과 라우팅 심화

기본 연결을 마쳤다면 실제 필요에 따라 관련 내용을 더 살펴보세요. 인터페이스 차이는 설치 파일 선택에, 규칙 순서는 트래픽 경로에 영향을 줍니다. 라우터 배포에는 전체 로컬 네트워크의 게이트웨이와 DNS 설정이 필요합니다. 아래 문서에서 각 주제를 자세히 다루므로 단일 기기 설정에서 구체적인 사용 환경으로 이어서 읽을 수 있습니다.

전체 글 보기 →