v2rayN · v2rayNG · v2flyNG 클라이언트

V2Ray 도움말 센터클라이언트 다운로드 및설정

플랫폼에 맞는 클라이언트를 선택하고 한국어 설정 가이드에 따라 구독을 가져온 뒤 라우팅과 연결 상태를 확인하세요.

클라이언트 선택 및 플랫폼별 다운로드

운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 클라이언트는 설정을 읽어 실행하며, 연결에 필요한 구독이나 서버 정보는 별도로 준비해야 합니다.

Windows

v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 데스크톱 구성을 유지합니다. 처음 사용하는 경우 다운로드 페이지 안내에 따라 데스크톱 버전을 설치하면 됩니다. 기존 설정이 있다면 먼저 내보내 백업한 뒤 인터페이스 버전을 바꿀지 결정하세요.

다운로드로 이동 →

macOS

v2rayN을 선택하고 ‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple Silicon과 Intel용 설치 파일을 구분하세요. 처음 실행할 때 보안 경고가 표시되면 앱 출처를 확인한 뒤 ‘개인정보 보호 및 보안’ 안내에 따라 실행 허용과 네트워크 권한을 설정하세요.

다운로드로 이동 →

Android

먼저 Xray 코어를 사용하는 v2rayNG를 확인하고, V2Fly 설정을 사용한다면 v2flyNG도 살펴보세요. 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 모른다면 범용 버전 안내를 확인하세요. 처음 연결할 때는 시스템의 VPN 연결 요청을 허용해야 합니다.

다운로드로 이동 →

Linux

v2rayN을 선택하고 배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 고른 다음, 기기가 x64인지 arm64인지 확인하세요. 데스크톱 환경의 시스템 프록시 설정은 앱마다 다르게 작동할 수 있으므로 설치 후 브라우저와 사용할 앱에서 각각 연결을 확인하세요.

다운로드로 이동 →

자주 쓰는 설정과 설정 경로

구독, 라우팅, DNS를 나눠 확인하세요. 한 번에 한 종류의 설정만 변경하고 원래 설정으로 되돌릴 수 있도록 보관하세요.

그룹을 추가한 뒤 구독 업데이트

구독 주소는 서버 설정을 가져오는 데 사용하며 서버 주소 입력란에 직접 넣는 값이 아닙니다. v2rayN의 ‘구독 그룹’에서 소스를 추가하고 알아보기 쉬운 메모를 입력해 저장한 뒤 ‘구독 업데이트’를 실행하세요. 목록이 비어 있으면 먼저 ‘전체’로 전환해 필터를 확인하고 업데이트 로그도 살펴보세요. 소스마다 그룹을 따로 만들면 나중에 업데이트하거나 비활성화·삭제할 때 편리합니다. 서버 정보를 하나씩 입력하는 대신 구독으로 한꺼번에 갱신할 수 있지만, 유효 기간과 내용은 제공 업체가 결정합니다. 구독 주소는 자격 증명처럼 안전하게 보관하세요.

설정 자세히 보기 →

화면 예시는 설정 간 관계를 설명하기 위한 것이며, 메뉴 위치는 클라이언트 빌드에 따라 다를 수 있습니다. 라우팅 예시는 전체 설정에 병합해 사용해야 합니다. 수정하기 전에 현재 사용 중인 코어와 설정 형식을 확인하세요.

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

최소한의 설정으로 연결을 먼저 구성한 뒤 라우팅과 트래픽 처리 기능을 차례로 켜세요. 문제가 생기면 이전 단계로 돌아가 결과를 확인하세요.

  1. 설정 준비 및 가져오기

    클라이언트를 설치한 뒤 구독 주소, 공유 링크, 전체 설정 파일 중 무엇을 가지고 있는지 확인하세요. 구독 주소는 구독 그룹에 저장하고 공유 링크는 클라이언트의 클립보드 가져오기 메뉴로 처리하세요. 웹페이지 안내 주소를 구독 주소로 착각하지 말고, 공개 화면에 전체 링크가 보이지 않도록 주의하세요.

    v2rayN에서 그룹을 저장한 뒤 ‘구독 업데이트’를 실행하고 서버 목록에 항목이 표시되는지 확인하세요. Android에서는 v2rayNG의 추가 또는 가져오기 메뉴로 기존 설정을 불러올 수 있습니다. 가져오기에 실패하면 먼저 로그의 요청 오류를 확인해 링크 만료, 응답 형식 불일치, 네트워크 요청 실패를 구분한 뒤 대응하세요.

  2. 서버 및 프록시 방식 선택

    가져온 목록에서 서버를 선택하고 v2rayN에서 ‘활성 서버로 설정’을 누르세요. 브라우저가 시스템 프록시를 사용해야 한다면 데스크톱에서 ‘시스템 프록시 자동 설정’을 선택하세요. Android에서는 연결을 시작한 뒤 시스템 안내에 따라 VPN 요청을 허용하세요. 먼저 클라이언트의 기본 라우팅을 사용하고 사용자 지정 규칙을 서둘러 추가하지 마세요.

    시스템 프록시를 모든 앱이 따르는 것은 아닙니다. 브라우저는 연결되지만 특정 앱이 연결되지 않는다면 먼저 해당 앱의 프록시 설정을 확인하세요. 이런 트래픽을 직접 처리해야 할 때만 TUN 설정 안내를 살펴보세요. 그래야 권한 문제와 서버 문제를 혼동하지 않습니다.

  3. 연결 테스트 및 정상 상태 보관

    ‘실제 연결 지연 시간 테스트’를 실행한 뒤 실제 사용하는 웹사이트나 앱도 열어 확인해야 합니다. 목록의 테스트 결과는 지정된 테스트 대상의 연결 상태만 보여 주며 모든 도메인, 전송 프로토콜, 앱의 사용 가능 여부를 보장하지 않습니다. 가능한 한 같은 대상을 사용하고 프록시 모드와 라우팅 설정을 기록하세요.

    연결이 정상인 뒤 설정을 백업하고 라우팅 예외, DNS, TUN 설정을 하나씩 추가하세요. 항목을 바꿀 때마다 다시 테스트하고 문제가 생기면 직전의 정상 상태로 되돌리세요. 문제 해결 기록에는 오류 유형과 발생 시간을 남기되 구독 주소, 사용자 식별 정보 및 기타 접근 자격 증명은 삭제하세요.

Project V · V2Fly · Xray

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

인터페이스, 코어, 서비스 설정을 구분하면 같은 구독이 환경에 따라 다르게 작동하는 이유를 이해할 수 있습니다.

오픈 소스GUI 관리커뮤니티 유지 관리

Project V와 코어 계열

Project V는 네트워크 프록시 기술을 중심으로 형성된 오픈 소스 프로젝트 생태계이며 V2Ray는 그 주요 구성 요소 중 하나입니다. V2Fly 커뮤니티는 관련 코어를 이어서 유지 관리하고, Xray는 관련 기술 기반에서 발전한 별도의 코어 계열입니다. 일부 프로토콜 개념과 설정 방식은 공유하지만 기능 발전, 확장 필드, 지원 범위가 완전히 같지는 않습니다. 따라서 ‘V2Ray 설정’이라는 표현만 보고 호환성을 판단하지 말고 실제 사용 중인 코어를 확인해야 합니다.

프로토콜 이름은 연결 조건의 일부일 뿐입니다. 같은 VLESS 또는 VMess 설정도 전송 방식, 보안 계층, 라우팅 설정에 따라 달라질 수 있습니다. REALITY 같은 특정 기능을 사용할 때는 코어 지원 여부와 서버 측 요구 사항을 확인하세요. 매개변수를 추측으로 채우면 안 됩니다. 로그에 인식할 수 없는 필드가 표시되면 모든 네트워크 설정을 기본값으로 되돌리기보다 호환성과 설정 출처부터 확인하세요.

세 클라이언트의 역할

v2rayN은 데스크톱 환경에서 서버 목록, 구독 그룹, 라우팅, 시스템 프록시 등을 GUI로 관리할 수 있게 해 여러 구독 소스를 정리하려는 사용자에게 적합합니다. 클라이언트는 인터페이스 설정을 코어 실행에 필요한 설정으로 변환하며 실제 연결은 선택한 코어가 처리합니다. 인터페이스에서 설정을 저장할 수 있다고 해서 서버가 해당 매개변수를 반드시 받아들이는 것은 아닙니다. 시작 로그와 실제 접속 결과를 함께 확인해야 합니다.

v2rayNG는 Android 기기를 대상으로 하며 Xray 코어를 사용하고 시스템 VPN 인터페이스를 통해 프록시 연결을 처리합니다. 구독 관리와 앱별 설정도 제공합니다. v2flyNG 역시 Android용으로 V2Fly 코어를 사용하며 이에 맞는 설정을 위한 대안이 될 수 있습니다. 구독 요구 사항과 필요한 기능을 먼저 확인하고 인터페이스 사용 편의성을 살펴보세요. 이름이 비슷하다고 확장 매개변수, 설정 내보내기 형식, 작동 방식까지 모두 같다고 가정하지 마세요.

오픈 소스 라이선스와 사용 범위

세 클라이언트 모두 공개된 오픈 소스 코드가 있으며, 클라이언트와 통합된 코어는 각각 별도의 오픈 소스 라이선스를 따릅니다. 라이선스는 코드의 사용, 수정, 배포 조건을 설명할 뿐 외부 구독 내용이나 네트워크 서비스 품질을 보장하지 않습니다. 관련 정보를 확인할 때는 클라이언트 프로젝트, 코어 프로젝트, 구독 제공 업체를 구분해서 살펴보세요. 인터페이스가 같아도 전혀 다른 서비스 환경에 연결될 수 있습니다.

구독 링크, 공유 링크, 내보낸 설정 파일에는 계정 식별 정보, 액세스 토큰, 키 자료가 포함될 수 있습니다. 도움을 요청할 때는 오류 문구, 작업 단계, 모드 이름만으로 충분한 경우가 많으므로 전체 설정을 공개하지 마세요. 이 사이트의 문서는 클라이언트 설정과 기술 개념을 다루며 서비스 유효 기간, 서버 권한, 구독 내용은 해당 제공 업체에 확인해야 합니다.

클라이언트, 코어, 규칙은 따로 업데이트

클라이언트 업데이트는 주로 관리 인터페이스와 통합 기능에 영향을 줍니다. 코어 업데이트는 프로토콜 지원과 작동 방식에 영향을 줄 수 있고 GeoIP·GeoSite 데이터베이스 업데이트는 분류 규칙의 적용 범위를 바꿉니다. 이 세 가지를 한 번에 처리하지 마세요. 일부 도메인의 라우팅만 잘못된다면 먼저 규칙 순서와 데이터베이스를 확인하고, 코어가 시작되지 않는다면 설정 필드와 코어 지원 여부를 점검하세요.

업데이트 전에 정상 작동하는 설정을 내보내고 현재 프록시 방식과 라우팅 프리셋을 기록하세요. 업데이트 후에는 기본 연결을 먼저 확인한 다음 사용자 지정 아웃바운드, DNS, TUN을 점검하세요. 여러 설정을 한꺼번에 새로 추가하지 마세요. 구독을 업데이트하면 서버 목록도 바뀔 수 있으므로 중요한 수동 수정 사항을 따로 기록해 다음 새로고침 후에도 복원할 수 있게 하세요. 이처럼 점검 순서를 정해 두면 업데이트 횟수에만 집중하는 것보다 설정을 파악하고 관리하기 쉽습니다.

설정 문제별 상세 안내

증상에 맞는 글을 읽어 구독, DNS, 프로토콜 차이 중 원인을 먼저 좁힌 뒤 관련 설정을 확인하세요. 아래는 최근 게시한 글 세 편입니다.