데스크톱 클라이언트 · JSON 설정 참고

V2Ray 툴박스 v2rayN 다운로드 및 설정 매뉴얼

클라이언트 선택부터 구독 가져오기까지, 실제 설정 항목으로 라우팅과 DNS를 이해하고 config.json의 설정 범위와 앱 설정의 차이를 확인하세요.

  • VMess
  • VLESS
  • Trojan
  • REALITY

클라이언트 다운로드

운영체제에 맞는 설치 파일 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 먼저 확인하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 해당 다운로드 항목을 선택하면 됩니다.

클라이언트는 구독을 저장하고 서버 설정을 관리해 코어를 실행합니다. 설치 파일 자체가 원격 연결 서비스를 제공하는 것은 아닙니다. 구독 주소나 개별 설정을 준비한 다음 사용 가이드에 따라 가져오세요. 다른 기기로 옮길 때 호환되는 연결 설정을 계속 사용할 수 있지만, 로컬 포트와 시스템 프록시, 앱 권한은 새 기기에서 다시 확인해야 합니다.

Windows

v2rayN 추천

다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 선택할 수 있습니다. 데스크톱 버전은 여러 운영체제에서 비슷한 방식으로 사용할 수 있는 크로스 플랫폼 인터페이스를 제공합니다. 클래식 화면에 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 설정 위치가 다를 수 있지만, 가이드에서 설정 항목의 의미를 확인하는 방법은 동일합니다.

설치 전에 시스템 설정의 ‘시스템 → 시스템 정보’에서 운영체제 종류를 확인하세요. 처음 실행한 뒤 매개변수 설정에서 로컬 수신 포트를 확인하고 시스템 프록시를 설정합니다. 두 클라이언트가 같은 시스템 프록시를 동시에 제어하거나 동일한 포트를 수신하지 않도록 하세요. 그러면 구독을 가져왔더라도 앱 요청이 다른 설정으로 전달될 수 있습니다.

다운로드 Windows 클라이언트

macOS

v2rayN

‘이 Mac에 관하여’의 칩 정보를 확인해 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 칩 종류는 프로그램 아키텍처를 결정하며, 구독에서 사용하는 VMess·VLESS·Trojan과는 관계가 없습니다. 설치 후 클라이언트를 열어 설정 디렉터리와 실행 상태를 확인한 뒤 기존 연결 설정을 가져오세요.

데스크톱 앱이 프록시를 사용하는지는 시스템 프록시 설정을 따르는지에 따라 달라집니다. 브라우저가 정상적으로 접속된다고 해서 터미널 프로그램도 같은 경로를 이용하는 것은 아닙니다. 문제를 확인할 때는 먼저 시스템 프록시를 따르는 앱으로 테스트한 다음 다른 앱의 자체 프록시 설정을 점검하세요. 시스템에서 설치 권한 문제를 표시하면 구체적인 원인을 확인하고, 전체 보안 설정을 끄는 방식으로 해결하려 하지 마세요.

다운로드 macOS 클라이언트

Android

v2rayNG 추천

v2rayNG는 Xray 코어를 사용합니다. V2Fly 코어가 필요한 경우 대안으로 v2flyNG를 확인하세요. 최신 스마트폰은 대부분 arm64 아키텍처를 사용하며, 확인이 어려울 때는 범용 버전 안내를 참고하면 됩니다. 두 클라이언트의 프로토콜 지원 범위는 각 코어에 따라 다르므로 이름이 비슷하다는 이유만으로 모든 설정을 그대로 사용할 수 있다고 판단하지 마세요.

처음 연결할 때 시스템에서 VPN 연결 권한을 요청합니다. 이는 클라이언트가 기기의 네트워크 요청을 처리하도록 허용하는 절차로, 원격 서버의 사용 가능 여부와는 별개입니다. 화면을 잠근 뒤 연결이 자주 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 다른 앱이 VPN 연결을 사용 중인지도 살펴보세요. 구독 내용, 연결 권한, 백그라운드 정책을 각각 확인해야 합니다. 실제 문제 조건을 바꾸지 않은 채 앱을 반복해서 재설치하지 마세요.

다운로드 Android 클라이언트

Linux

v2rayN

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64 중 맞는 아키텍처를 고르세요. 배포판 종류와 프로세서 아키텍처는 별개의 조건입니다. deb를 사용하는 기기라도 필요한 아키텍처가 다를 수 있습니다. 다운로드 페이지에서 파일을 선택하기 전에 시스템 정보를 확인해 아키텍처 불일치를 프로그램 실행 오류로 오해하지 않도록 하세요.

그래픽 데스크톱의 시스템 프록시 설정은 해당 설정을 따르는 앱에만 적용되는 경우가 많으며, 모든 프로그램의 환경 변수를 자동으로 설정하지는 않습니다. 처음 사용할 때는 루프백 주소 수신을 유지하고 데스크톱 브라우저에서 연결을 확인하세요. 다른 프로그램에 프록시를 따로 설정해야 한다면 실제 프로토콜과 포트를 입력합니다. 서비스가 시작되지 않으면 포트 충돌, 권한 또는 설정 오류를 로그에서 먼저 확인하고 수신 범위를 바로 넓히지 마세요.

다운로드 Linux 클라이언트

전체 클라이언트 보기 → 코어와 사용 방법을 비교하려면 클라이언트 선택 가이드를 참고하세요.

설정 항목별 안내

JSON 키로 설정 찾기

인바운드는 요청을 받고, 라우팅은 경로를 선택하며, 아웃바운드는 연결을 처리합니다. 먼저 세 항목이 tag로 연결되는 방식을 확인한 다음 DNS와 정책을 설정하세요.

아래는 일부 설정 예시이며 원격 서비스에 바로 연결할 수 있는 완성 파일이 아닙니다. 일반적인 V2Ray 설정 구조를 사용했으며, 특정 프로토콜이나 확장 필드가 포함된 경우 실제 실행 중인 코어의 지원 여부를 확인해야 합니다. 화면의 final은 기본 처리 방식을 나타내며, 여기서 새로 추가한 최상위 JSON 필드가 아닙니다.

inbounds: 로컬 앱의 진입점

인바운드는 코어가 요청을 받을 주소와 포트, 사용할 프록시 프로토콜을 정의합니다. 이 기기의 앱은 보통 루프백 주소에 연결해 프록시 포트가 로컬 네트워크에 노출되지 않도록 합니다. 예시의 SOCKS와 HTTP는 서로 다른 포트를 수신하므로 앱에서도 해당 프로토콜을 맞춰 입력해야 합니다. 포트 번호는 고정된 표준이 아니므로 클라이언트 설정의 실제 값을 기준으로 삼으세요. 시스템 프록시와 달리 인바운드 설정만으로 브라우저에 프록시 사용을 알리지는 않습니다. 양쪽 설정이 모두 맞아야 요청이 코어에 전달됩니다.

{
  "inbounds": [
    {
      "tag": "socks-in",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "auth": "noauth", "udp": true }
    },
    {
      "tag": "http-in",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ]
}

JSON 설정 매뉴얼 전체 보기 →

빠른 시작 미리보기

구독 가져오기, 프록시 모드와 연결 확인

먼저 확인 가능한 요청 경로를 만든 뒤 분기 규칙을 추가하세요. 단계마다 점검 지점을 분명히 두면 좋습니다.

  1. 단계 01 · 설정 가져오기

    구독 그룹을 만들고 연결 정보를 가져오기

    v2rayN의 구독 그룹에 기존 구독 주소를 추가하고 알아보기 쉬운 이름을 입력한 다음 구독을 업데이트하세요. 단일 공유 링크를 사용하는 경우에는 클라이언트의 클립보드 가져오기 기능을 이용하세요. 단일 링크를 구독 주소로 취급해 반복해서 업데이트하면 안 됩니다. v2rayNG에서는 구독 그룹 설정이나 메인 화면 메뉴에서 작업할 수 있습니다. 기본 순서는 동일합니다. 출처를 저장하고 내용을 가져온 뒤 가져오기 결과를 확인하세요.

    가져온 뒤 목록에 선택할 수 있는 설정이 실제로 표시되는지 확인하고 프로토콜 종류도 점검하세요. 구독 결과가 비어 있거나 형식 오류 또는 접근 실패가 발생하면 로컬 라우팅을 조정하기 전에 내용 가져오기 문제부터 해결해야 합니다. 구독에는 접근 자격 증명이 포함될 수 있습니다. 문제를 확인하는 스크린샷에서는 전체 주소와 사용자 식별 정보, 인증 항목을 가리세요. 도움을 요청할 때는 오류 유형과 작업 절차만 공유하면 됩니다.

    연결에 사용할 설정 하나를 선택하세요. 목록에 설정이 있다고 해서 활성화된 것은 아니며, 업데이트 성공이 원격 서버에 연결할 수 있음을 뜻하지도 않습니다. 다음 연결 테스트를 명확히 하려면 ‘내용을 가져왔는지’와 ‘현재 설정을 선택했는지’를 따로 확인하세요.

  2. 단계 02 · 요청 경로 설정

    로컬 포트를 확인하고 시스템 프록시 선택

    데스크톱에서는 매개변수 설정의 수신 주소와 포트를 확인한 다음 ‘시스템 프록시 자동 설정’을 선택하세요. 이 설정은 시스템 프록시를 따르는 앱의 요청을 로컬 클라이언트로 전달합니다. 라우팅 모드는 요청이 코어에 들어온 뒤 어떤 아웃바운드를 사용할지 결정합니다. 두 설정은 서로 다른 계층이므로 둘 다 ‘전체’라는 말로 혼동하면 안 됩니다. 라우팅을 바꿔도 시스템 프록시를 무시하는 앱이 자동으로 프록시를 사용하지는 않습니다.

    일상적인 트래픽 분기는 클라이언트의 사전 설정 모드로 시작하고, 기본 연결을 확인한 뒤 사용자 지정 규칙을 추가하세요. 브라우저 프록시 확장 프로그램을 사용하는 경우 확장 프로그램의 프로토콜과 포트를 클라이언트 설정에 맞춰 시스템 설정과 충돌하지 않도록 하세요. Android에서는 먼저 시스템 연결 권한을 확인한 다음 앱별 분기 범위를 살펴 테스트할 앱이 예상 범위에 포함되어 있는지 확인합니다.

    컴퓨터에 다른 프록시 프로그램이 남아 있다면 먼저 종료하거나 서로 다른 포트를 사용하도록 설정하세요. 포트가 이미 사용 중이면 화면에 설정이 표시되더라도 코어가 정상적으로 수신하지 못할 수 있습니다. 이 문제는 구독을 바꾸는 대신 시작 로그에서 원인을 찾으세요.

  3. 단계 03 · 단계별 연결 확인

    웹페이지를 열고 로그에서 요청 경로 확인

    연결을 시작한 뒤 브라우저에서 접속 가능한 페이지를 열어 DNS 조회와 페이지 로딩이 되는지 확인하고, 클라이언트 로그에서 연결 오류를 살펴보세요. 한 번의 지연 시간 테스트는 특정 대상과 측정 방식의 결과일 뿐 실제 앱 테스트를 대신하지 못합니다. 페이지가 열리지 않으면 ‘앱 프록시 설정 → 로컬 수신 → 라우팅 규칙 적용 → 원격 연결 → DNS 조회’ 순서로 확인하세요. 여러 설정을 동시에 바꾸지 않는 것이 좋습니다.

    일부 사이트에서만 문제가 생기면 해당 사이트에 적용되는 도메인 및 주소 규칙을 비교하세요. 모든 앱에서 문제가 발생하면 코어 실행 상태와 시스템 프록시를 먼저 확인합니다. 인증이나 핸드셰이크 실패가 발생하면 기기 시간과 연결 설정도 확인하세요. 로그에 대상 도메인이나 설정 식별 정보가 포함될 수 있으므로 공개적으로 질문하기 전에 문제와 관계없는 민감 정보를 삭제하세요.

    연결 확인이 끝나면 현재 작동하는 모드와 포트를 기록하고, 이후에는 한 번에 한 종류의 설정만 변경하세요. 데스크톱 클라이언트를 종료하기 전에 필요에 따라 시스템 프록시를 해제해 앱이 종료된 로컬 포트로 계속 요청을 보내지 않도록 하세요. 전체 가이드에서는 각 점검 항목의 구체적인 절차를 안내합니다.

전체 사용 가이드 보기 →

Project V · V2Fly · Xray

그래픽 클라이언트가 설정을 관리합니다.
프록시 코어가 연결을 처리합니다.

Project V와 코어 생태계

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈소스 생태계이며, V2Ray는 그중 중요한 구성 요소입니다. V2Fly 커뮤니티는 V2Ray의 유지 관리와 발전을 이어 왔습니다. Xray는 관련 기술을 바탕으로 발전해 독자적인 프로토콜 구현과 기능 확장을 갖추었습니다. 공통된 설정 개념이 있지만 서로 같은 실행 프로그램은 아니므로 코어 이름을 서로 바꿔 쓸 수 있는 단순한 표기로 취급해서는 안 됩니다.

설정을 확인할 때는 현재 실행 중인 코어 종류를 먼저 확인한 다음 해당 코어가 지원하는 필드와 프로토콜 조합을 살펴보세요. 예를 들어 VLESS는 프록시 프로토콜이고 REALITY는 연결 보안 관련 설정으로, 서로 다른 계층에 속합니다. 클라이언트가 공유 링크를 인식하더라도 선택한 코어가 모든 매개변수를 지원한다는 뜻은 아닙니다. 생성된 설정과 실행 결과도 확인해야 합니다.

세 클라이언트의 역할

v2rayN, v2rayNG, v2flyNG는 모두 오픈소스로 코드를 공개합니다. v2rayN은 데스크톱용으로 구독, 서버 선택, 라우팅, 시스템 프록시를 그래픽 인터페이스에서 관리합니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어 기반의 Android 클라이언트입니다. 오픈소스라는 점은 코드와 라이선스 방식을 뜻하며 모든 클라이언트의 기능이 같다는 의미는 아닙니다.

그래픽 클라이언트는 조작과 설정 관리를 담당하고, 코어는 프로토콜 처리와 연결 전달을 맡습니다. 화면 조작 문제는 클라이언트 설정을 먼저 확인하고, 지원되지 않는 필드나 프로토콜은 코어 기능을 살펴보세요. 두 계층을 구분하면 구독 형식, 화면 옵션, 코어 문법을 혼동하는 일을 줄일 수 있습니다. 같은 연결 정보가 클라이언트마다 다르게 표시되는 이유도 이해하기 쉬워집니다.

오픈소스 라이선스와 커뮤니티 유지 관리

V2Fly의 V2Ray 코어와 Xray 코어는 MPL 2.0 라이선스를 사용합니다. 각 클라이언트 프로젝트에는 별도의 오픈소스 라이선스가 적용되므로 배포·수정·결합해 사용할 때는 해당 라이선스 문서를 각각 확인해야 합니다. 코어 라이선스로 클라이언트 라이선스를 대신할 수는 없습니다. 일반 사용자는 기능 안내와 릴리스 기록, 실제 기기에서의 호환성을 확인하는 것이 좋습니다.

커뮤니티 유지 관리에는 운영체제 호환성, 프로토콜 지원, 문제 수정 등이 포함됩니다. 업데이트할 때마다 기존 설정을 변경해야 하는 것은 아닙니다. 변경 사항을 확인할 때 기본값 변경, 기존 필드 제거, 가져오기 동작 변경 여부를 살펴보세요. 안정적으로 사용하는 설정이 있다면 복구할 수 있는 사본을 보관한 뒤 필요한 새 기능을 테스트하세요. 필드를 일괄 교체하는 방식을 일반적인 업그레이드 절차로 사용하지 마세요.

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

클라이언트 업데이트는 그래픽 인터페이스와 설정 관리 기능을 바꾸고, 코어 업데이트는 프로토콜 처리 기능을 바꿉니다. 구독 업데이트는 원격에서 제공하는 새 연결 정보를 가져옵니다. 각 항목은 서로 다른 메뉴에서 업데이트되거나 주기가 다를 수 있습니다. 구독 업데이트가 성공해도 로컬 포트 충돌이 해결되는 것은 아니며, 클라이언트를 업그레이드해도 만료된 원격 인증 정보가 다시 유효해지지는 않습니다.

이 매뉴얼은 특정 화면 캡처에 의존하지 않고 설정 항목과 JSON 키를 기준으로 내용을 구성했습니다. 화면이 바뀌더라도 수신 주소, 아웃바운드 tag, 라우팅 조건, DNS 서버 같은 개념으로 설정을 찾을 수 있습니다. 설치 파일이 필요하면 다운로드 페이지를, 설정 간 관계를 이해하려면 JSON 매뉴얼을 확인하세요. 실행은 되지만 접속할 수 없다면 가이드의 단계별 점검 순서에 따라 원인을 좁혀 나가면 됩니다.

사용 사례와 문제 해결

노드 선택과 구독 문제 안내

목록의 설정 항목부터 앱의 요청 경로까지, 문제별로 설정을 살펴보고 모든 오류를 하나의 설정 탓으로 돌리지 마세요.

V2Ray 노드 선택 방법: 지연 시간·트래픽 배율·지역·프로토콜 비교

노드 목록의 지연 시간, 트래픽 배율, 지역 표시, 프로토콜 유형이 무엇을 뜻하는지 설명하고 웹 브라우징·동영상·게임 등 용도별 선택 기준을 안내합니다. 측정 기준을 먼저 확인하고 실제 앱에서의 성능을 살펴보세요. 숫자 하나만으로 순위를 정하지 않는 것이 좋습니다.

노드 선택 가이드 보기 →

구독 업데이트 실패 원인과 v2rayN·v2rayNG 자동 업데이트 설정

구독 주소 만료, 프록시를 통한 업데이트, 인증서 및 형식 오류 등 주요 실패 원인을 정리하고 두 클라이언트의 정기 자동 업데이트 설정을 설명합니다. 주소에 접속할 수 없는 문제와 내용을 해석하지 못하는 문제를 구분해 오류가 발생한 단계에 맞는 설정을 확인하세요.

구독 업데이트 가이드 보기 →

v2rayN은 연결됨으로 표시되지만 웹페이지가 열리지 않을 때: 시스템 프록시·포트·라우팅 점검

시스템 프록시 모드, 로컬 포트 사용 여부, 시간 동기화, 라우팅 규칙, 노드 상태를 순서대로 확인해 연결은 됐지만 인터넷에 접속할 수 없는 문제를 단계별로 좁혀갑니다. 여러 옵션을 한꺼번에 바꾸기보다 재현 가능한 테스트 조건을 유지해야 원인을 찾기 쉽습니다.

연결 문제 점검 목록 보기 →

전체 글 보기 →

v2rayN 다운로드