오픈 소스 클라이언트 안내

V2Ray 중문 사이트v2rayN 다운로드 및 설정

플랫폼에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 시작해 라우팅 설정과 코어 설정을 확인하세요.

01 설정 예시

클라이언트 설정과 JSON 필드

클라이언트에서는 구독을 관리하고 코어를 실행하며, 설정 파일은 코어가 트래픽을 수신·해석·전달하는 방식을 정의합니다. 아래 예시는 필드를 이해하기 위한 것으로, 완성된 설정 파일로 바로 사용할 수 없습니다.

구독 항목과 로컬 인바운드

구독은 노드 목록을 일괄 업데이트하는 데 사용합니다. v2rayN을 예로 들면 먼저 구독 주소를 추가하고 해당 그룹을 업데이트한 다음, 갱신된 목록에서 노드를 선택합니다. 목록에 항목이 표시된다는 것은 클라이언트가 설정을 읽었다는 뜻일 뿐, 서버 연결이 확인됐다는 의미는 아닙니다. 구독 주소는 클라이언트에서 관리하는 데이터이며 코어의 JSON 필드가 아닙니다. 아래 SOCKS 인바운드는 코어를 실행한 뒤 로컬 앱에서 사용하는 프록시 진입점으로, 원격 구독 주소와는 별개입니다. 앱에 프록시를 직접 입력할 때는 현재 설정에 표시된 포트를 확인하세요.

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks"
    }
  ]
}

JSON 매뉴얼 보기

02 설치 파일

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

먼저 기기의 운영체제를 확인한 뒤 프로세서 아키텍처를 살펴보세요. 데스크톱에는 v2rayN을, 모바일 기기에는 설정 요구사항에 따라 v2rayNG 또는 v2flyNG를 선택하면 됩니다.

v2rayN 다운로드 항목에는 x64 데스크톱 버전과 클래식 WPF 버전이 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 인터페이스를 유지합니다. 서로 다른 그래픽 프로그램일 뿐 노드 프로토콜이 다른 것은 아닙니다. 먼저 시스템의 「정보」 페이지를 열어 시스템 종류를 확인하고 해당 아키텍처의 프로그램을 실행할 수 있는지 살펴보세요.

기존 설치에서 옮기는 경우 기존 인스턴스를 종료한 다음 새 프로그램을 실행하세요. 한 기기에서 두 클라이언트가 같은 로컬 수신 포트를 사용하면 나중에 실행한 쪽에서 포트가 사용 중이라는 오류가 날 수 있습니다. 전환 후에는 시스템 프록시가 현재 프로그램의 실제 수신 주소와 포트를 가리키는지도 확인하세요. 실행에 실패했다면 먼저 인터페이스 프로그램이 실행되지 않은 것인지, 인터페이스는 열렸지만 코어가 시작되지 않은 것인지 구분한 뒤 해당 오류 메시지를 확인하세요.

시스템의 「이 Mac에 관하여」에서 칩 또는 프로세서 정보를 확인하세요. Apple 칩으로 표시되는 기기에는 Apple Silicon용 arm64 설치 파일을, Intel 프로세서로 표시되는 기기에는 x64 설치 파일을 선택하세요. 두 항목의 차이는 프로세서 아키텍처이므로 구독 프로토콜에 따라 고를 필요는 없으며, 기기의 외관만 보고 판단해서도 안 됩니다.

디스크 이미지가 열리면 앱을 「응용 프로그램」으로 옮긴 뒤 실행하세요. 이후에도 고정된 위치에서 편리하게 열 수 있습니다. 처음 테스트할 때는 시스템 프록시를 사용하는 브라우저 하나만 이용해 네트워크 옵션을 여러 개 동시에 바꾸지 않는 것이 좋습니다. Wi-Fi와 유선 네트워크의 프록시 설정은 서로 다른 네트워크 서비스에 적용될 수 있습니다. 네트워크를 바꾼 뒤 동작이 달라지면 구독을 다시 가져오기 전에 현재 사용 중인 네트워크 서비스의 설정부터 확인하세요.

최근 기기는 대부분 arm64 패키지를 선택할 수 있지만, 시스템에서 해당 아키텍처의 앱 실행을 지원해야 합니다. 확실하지 않다면 범용 패키지를 확인하세요. 범용 패키지에는 보통 여러 아키텍처용 네이티브 라이브러리가 포함되어 있지만, 클라이언트 자체의 시스템 요구사항은 여전히 충족해야 합니다. v2rayNG는 Xray 코어를 사용하며 V2Fly 동작을 비교하려면 v2flyNG를 선택하세요.

VPN 모드를 처음 사용할 때는 시스템에서 연결 권한을 확인하라는 메시지가 표시됩니다. 기기에서 다른 앱이 이미 VPN 연결을 설정했다면 서로 충돌하는지 먼저 확인하세요. 연결이 설정된 뒤 특정 앱만 다르게 동작한다면 클라이언트에서 앱별 필터링을 켰는지 확인하고, 해당 앱이 포함 목록이나 제외 목록에 있는지 살펴보세요. 이 단계에서는 설치 아키텍처가 보통 주요 점검 대상이 아닙니다. 아키텍처 문제는 주로 설치하거나 네이티브 라이브러리를 불러올 때 발생합니다.

먼저 배포판에 맞는 패키지 형식을 고르고, 이어서 기기에 맞는 아키텍처를 선택하세요. Debian 패키지 체계를 사용하는 배포판에는 보통 deb를, RPM 패키지 체계를 사용하는 배포판에는 보통 rpm을 선택합니다. 두 형식 모두 x64와 arm64 항목이 있으므로 패키지 형식과 아키텍처를 각각 확인해야 합니다. 패키지 형식이 맞다고 해서 아키텍처까지 맞는 것은 아닙니다.

패키지 관리자가 누락된 의존성이나 호환성 문제를 알리면 메시지를 기록하고 설치 단계에서 문제를 해결한 다음 v2rayN을 실행하세요. 실행 후 데스크톱 앱이 시스템 프록시를 사용하는지는 데스크톱 환경과 앱 자체에 따라 달라집니다. 브라우저는 되는데 터미널은 되지 않는다면 터미널 도구의 프록시 매개변수나 환경 설정을 따로 확인하세요. 터미널이 프록시를 사용하지 않는 것을 설치 실패로 오해하지 마세요.

전체 클라이언트 보기

03 첫 설정

가져오기·분기·연결 확인

처음에는 노드 하나, 라우팅 규칙 하나, 앱 하나만 테스트하세요. 기본 연결을 확인한 다음 다른 접속 방식을 사용하거나 DNS 설정을 조정하세요.

  1. 01 데이터 가져오기

    구독 가져오기

    구독 주소를 받으면 구독 그룹에 항목을 추가해 저장하고 해당 그룹을 직접 업데이트하세요. 주소 저장과 노드 가져오기는 별개의 단계입니다. 목록이 비어 있다면 방금 추가한 그룹을 선택했는지 확인한 뒤 업데이트 결과를 살펴보세요. 노드 공유 링크 하나만 있다면 단일 노드 가져오기 기능을 사용하세요.

    가져온 뒤에는 프로토콜과 전송 매개변수가 명확한 항목 하나를 먼저 선택하세요. 업데이트 오류가 발생하면 주소가 잘렸거나 불필요한 공백이 붙었는지 확인하세요. 업데이트는 성공했지만 일부 노드만 보이지 않는다면 해당 노드의 형식이 클라이언트에서 지원되는지 확인하세요. 문제를 설명하기 위해 화면을 공유할 때는 구독 주소, 계정 정보, 노드 인증 정보를 가리세요.

  2. 02 아웃바운드 규칙

    라우팅 모드 선택

    어떤 연결은 직접 연결하고 어떤 요청은 프록시 노드로 보낼지 먼저 정하세요. 클라이언트의 사전 설정 규칙을 사용할 때는 실제로 선택된 규칙이 무엇인지 확인하고 직접 연결 대상과 프록시 대상의 조건을 살펴보세요. 사내 네트워크나 LAN 서비스를 직접 연결 테스트 대상으로 삼고, 프록시 테스트에는 안정적으로 접속되는 것으로 확인된 대상을 선택하세요.

    시스템 프록시 스위치는 일부 앱이 트래픽을 로컬 진입점으로 보낼지 결정하고, 라우팅 모드는 코어가 받은 연결을 어디로 보낼지 정합니다. 두 설정은 서로 대체할 수 없습니다. 규칙을 바꾼 뒤 LAN 접속이 달라졌다면 기존 노드는 그대로 두고 원래 규칙으로만 되돌려 테스트하세요. 조건 일치 방식이 바뀐 것인지 앱이 아예 다른 진입점을 사용하게 된 것인지 구분하기 쉽습니다.

  3. 03 실제 요청

    연결 및 확인

    데스크톱에서는 노드를 선택하고 코어의 수신 준비가 완료됐는지 확인한 뒤 필요에 따라 시스템 프록시를 켜세요. 모바일에서는 노드를 선택한 뒤 VPN 연결을 설정하고 시스템 권한을 확인하세요. 실제 앱으로 직접 연결 대상과 프록시 대상을 각각 접속하고, 클라이언트 로그에 해당 요청이 표시되는지도 확인하세요. 목록에 표시된 지연 시간이나 연결 상태만으로는 이를 확인할 수 없습니다.

    두 대상 모두 접속되지 않으면 먼저 로컬 진입점이나 VPN 상태를 확인하세요. 프록시 대상만 실패한다면 노드, 라우팅 규칙 일치 여부, 원격 핸드셰이크를 점검하세요. 브라우저 접속을 확인한 뒤 명령줄도 사용하려면 대상 도구에서 별도로 테스트하세요. 클라이언트를 종료하기 전에 시스템 프록시를 끄거나 지워야 다른 프로그램이 중지된 로컬 포트로 계속 연결하지 않습니다.

전체 사용법 보기

04 오픈 소스 생태계

Project V, V2Fly, Xray

먼저 인터페이스, 코어, 프로토콜을 구분하세요. 클라이언트 이름은 사용할 소프트웨어를 선택할 때, 프로토콜과 전송 설정은 연결 호환성을 판단할 때 확인합니다.

클라이언트
구독과 노드를 관리하고 설정을 생성하거나 불러옵니다
코어
설정을 읽고 이름 해석·라우팅·전달을 처리합니다
프로토콜
연결된 양쪽이 데이터를 주고받는 방식을 정합니다

프로젝트 소개 보기

  1. Project V와 클라이언트의 역할

    Project V는 초기 V2Ray 프로젝트를 이해하기 위한 출발점입니다. V2Ray는 트래픽을 받는 인바운드, 트래픽을 내보내는 아웃바운드, 매칭 규칙을 각각 정의합니다. 하나의 인바운드에서 받은 요청도 라우팅을 통해 서로 다른 아웃바운드로 보낼 수 있습니다. 이 구조에서는 트래픽을 받는 단계와 보낼 곳을 정하는 단계를 나눠 점검할 수 있으며, 다양한 그래픽 클라이언트가 공통 설정 개념을 활용할 수 있습니다.

    v2rayN·v2rayNG·v2flyNG는 노드 관리, 설정, 실행 기능을 제공하는 오픈 소스 그래픽 클라이언트입니다. 데스크톱 클라이언트의 인터페이스 설정은 코어 설정 파일과 다르며, 모바일에서 VPN 권한을 승인하는 것도 운영체제의 동작입니다. 자료를 찾을 때는 문제가 인터페이스, 운영체제, 코어 중 어디에서 발생했는지 먼저 판단하세요. 예를 들어 프로그램 인터페이스가 정상적으로 열려도 코어가 수신 대기 중이라는 뜻은 아니며, 시스템에서 VPN 권한을 허용해도 원격 핸드셰이크 성공이 보장되지는 않습니다.

  2. V2Fly와 Xray의 공통 문법과 차이점

    V2Fly 커뮤니티는 V2Ray 코어를 이어서 유지 관리하고 있으며, Xray는 V2Ray 코드에서 분기되어 발전했습니다. 두 코어는 인바운드·아웃바운드와 여러 라우팅 필드의 개념이 비슷하지만 각각 독립적으로 구현됩니다. 같은 이름의 필드라도 현재 코어에서 지원하는 범위를 확인해야 합니다. 특히 새로운 전송 방식과 보안 옵션은 한쪽 설정의 매개변수를 다른 쪽에 그대로 적용할 수 없습니다.

    클라이언트를 선택할 때는 노드에서 요구하는 매개변수를 먼저 확인하고, 클라이언트가 어떤 코어를 호출할 수 있는지 살펴보세요. 기존 환경에서 작동하던 설정이 새 환경에서 알 수 없는 필드나 지원되지 않는 옵션 오류를 낸다면 로그에서 필드 이름을 확인한 뒤 클라이언트가 잘못된 매개변수를 생성했는지, 대상 코어가 이를 인식하지 못하는지 판단하세요. 민감한 정보가 없는 간단한 설정으로 확인하면 반복해서 재설치하는 것보다 문제를 찾기 쉽습니다. 자주 쓰는 이름은 코어 용어에서 비교할 수 있습니다.

  3. 프로토콜·전송·보안 계층을 각각 확인하세요

    VMess·VLESS·Trojan은 이 생태계에서 모두 사용되지만 인증 방식, 연결 매개변수, 보안 계층 요구사항은 서로 다릅니다. 프로토콜 항목과 전송 항목은 서로 다른 기준을 설명합니다. 클라이언트가 특정 프로토콜을 인식하더라도 해당 노드의 모든 전송 조합을 지원한다는 뜻은 아닙니다. 원격 주소와 포트가 정확해도 전송 매개변수나 서버 이름이 일치하지 않으면 연결에 실패할 수 있습니다.

    예를 들어 VLESS 자체는 콘텐츠를 암호화하지 않습니다. 관련 설정을 확인할 때는 실제로 사용하는 보안 계층도 살펴봐야 하며, 프로토콜 이름만으로 연결 특성을 단정해서는 안 됩니다. 클라이언트와 코어의 소스 코드가 공개되어 있어도 프로그램으로 가져온 서드파티 노드를 해당 프로젝트에서 운영한다는 뜻은 아닙니다. 소프트웨어 출처, 연결 설정, 노드 운영자는 각각 따로 확인해야 합니다. 용어의 자세한 의미는 프로토콜 빠른 안내에서 확인하세요.

  4. 클라이언트·코어·구독은 각각 별도로 업데이트됩니다

    클라이언트 업데이트는 인터페이스나 설정 생성 방식을 바꿀 수 있고, 코어 업데이트는 지원 필드에 영향을 줄 수 있으며, 구독 업데이트는 그룹의 노드 목록을 새로 고칩니다. 세 항목을 동시에 업데이트할 필요는 없습니다. 최근 변경으로 문제가 발생했다면 증상이 어느 단계부터 나타났는지 먼저 기록하세요. 소프트웨어 업데이트 후 실행되지 않는다면 코어 로그를 확인하고, 구독 업데이트 후 특정 노드만 작동하지 않는다면 먼저 해당 노드의 새 매개변수를 확인하세요.

    규칙을 직접 관리한다면 현재 라우팅 설정, 주요 태그, 로컬 포트를 기록해 변경 전후를 비교할 수 있습니다. 먼저 작동이 확인된 노드 하나로 프록시 진입점과 원격 연결을 점검한 뒤 사용자 지정 라우팅과 DNS 설정을 하나씩 되돌리세요. 구독과 사용자 지정 설정을 옮겨야 한다면 인증 정보가 포함된 자료는 관리되는 안전한 위치에 보관하세요. 문제를 보고할 때는 일반적으로 오류 유형과 관련 필드 이름만 제공하면 됩니다.

  5. 오류가 발생한 위치에 따라 자료를 찾아보세요

    구독 목록이 비어 있다면 가져오기 메뉴, 그룹, 업데이트 오류부터 확인하세요. 목록은 정상인데 모든 앱에서 접속할 수 없다면 코어가 실행 중인지, 포트가 수신 대기 중인지, 앱 요청이 로컬 진입점으로 전달되는지 확인하세요. 일부 대상만 실패한다면 라우팅 규칙 일치 여부, 도메인 이름 해석, 원격 연결을 살펴보세요. 이런 순서를 따르면 로컬 접속 문제를 노드 교체로 해결하려 하거나, 노드가 이미 작동하지 않는데 시스템 프록시만 계속 바꾸는 일을 피할 수 있습니다.

    화면 조작 방법은 시작 가이드에서, 필드 값과 구조는 JSON 매뉴얼에서 확인하세요. 매뉴얼의 인바운드와 아웃바운드 예시는 해당 예제가 다루는 부분만 보여 줍니다. 기존 설정과 합칠 때는 이름이 같은 태그를 참조하는지와 기본 아웃바운드 순서를 먼저 확인한 뒤 실제 요청으로 테스트하세요.

05 사용 팁

설치·프록시 모드·노드 선택

현재 겪는 문제에 맞는 항목을 확인하세요. 클라이언트 실행 여부를 먼저 확인하고, 요청이 코어에 도달하는지 살펴본 다음 노드별 동작을 비교하세요.

전체 글 보기