config.json 클라이언트 다운로드 및 설정 색인

V2Ray 중문 다운로드 스테이션 v2rayN / v2rayNG 설정 안내서

v2rayN 및 v2rayNG 클라이언트, config.json 설정 방법, 라우팅 분기 설정을 한곳에 정리했습니다. 설치 패키지 선택부터 구독 가져오기, 프록시 모드 전환까지 실제 설정 경로에 따라 설명합니다.

  • 영구 무료
  • 오픈 소스
  • Xray · V2Fly
  • 중국어 설정 문서
platforms / 4 core / Xray · V2Fly config / JSON license / open source

routing / rules

하나의 연결이 인바운드, 라우팅, 아웃바운드를 거치는 과정

브라우저나 시스템 트래픽은 먼저 로컬 리스닝 포트로 들어온 뒤 routing 규칙에 따라 도메인, IP, 프로토콜 유형, 프로세스 출처를 확인하고 지정된 outbound로 전달됩니다. 이 흐름을 이해하면 시스템 프록시, 로컬 네트워크 우회, 직접 연결 규칙과 원격 연결의 관계를 더 명확히 파악할 수 있습니다.

download / platforms

V2Ray 클라이언트 플랫폼 안내

현재 사용하는 시스템에 맞는 영역으로 이동한 다음, 프로세서 아키텍처와 사용 환경에 따라 클라이언트를 선택하세요. 홈에서는 플랫폼 안내만 제공하며, 설치 패키지 종류와 시스템 요구 사항, 구체적인 다운로드 경로는 다운로드 페이지에서 통합해 설명합니다.

desktop / v2rayN

Windows

데스크톱에서는 먼저 v2rayN을 선택하는 것이 좋습니다. 다운로드 페이지에서 크로스 플랫폼 데스크톱 버전과 클래식 WPF 버전의 인터페이스 차이, 지원 시스템 및 설치 방법을 함께 안내하므로 최신 시스템과 기존 장비에 맞춰 선택할 수 있습니다.

다운로드로 이동 →

desktop / v2rayN

macOS

v2rayN 데스크톱 버전은 Apple Silicon과 Intel 아키텍처별 다운로드 경로를 제공합니다. 시스템 정보에서 칩 이름을 확인하면 쉽게 구분할 수 있으며, 다운로드 페이지에서 최초 실행, 설정 가져오기, 시스템 프록시 전환 위치도 안내합니다.

다운로드로 이동 →

mobile / v2rayNG

Android

Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 선택할 수 있으며, 코어 선호도에 따라 v2flyNG를 선택해도 됩니다. 대부분의 최신 기기는 arm64를 사용합니다. 아키텍처를 확인하기 어렵다면 다운로드 페이지의 범용 설치 패키지 선택 안내를 참고하세요.

다운로드로 이동 →

desktop / v2rayN

Linux

v2rayN은 주요 배포판용 패키지를 제공하며 x64와 arm64 아키텍처로 구분됩니다. 먼저 배포판이 deb와 rpm 중 어느 형식을 사용하는지 확인한 뒤 다운로드 페이지에서 해당 아키텍처를 선택하면 설치 중 형식 오류를 줄일 수 있습니다.

다운로드로 이동 →

config / anatomy

설정 필드 분석 도구

하나의 설정은 각 역할이 분명한 여러 최상위 필드로 구성됩니다. 왼쪽 목차에서 필드의 기능, 일반적인 값, 그래픽 클라이언트에서 해당 설정을 찾는 위치, 수정할 때 놓치기 쉬운 연동 관계를 확인할 수 있습니다.

config > inbounds

로컬 인바운드 리스닝

inbounds는 브라우저, 시스템 또는 다른 프로그램의 트래픽을 클라이언트가 수신하는 방식을 정의합니다. 일반적인 설정에는 listen, port, protocol, tag가 포함됩니다. 리스닝 주소는 연결 가능한 장치를 결정하고, 로컬 포트는 시스템 프록시 설정과 일치해야 하며, 프로토콜은 보통 SOCKS 또는 HTTP를 사용합니다. v2rayN에서는 매개변수 설정의 로컬 리스닝 포트에 해당하고, v2rayNG에서는 로컬 프록시 및 VPN 서비스 진입점에 해당합니다. 포트를 변경한 뒤에는 프록시 주소를 수동으로 설정한 브라우저나 앱도 함께 수정해야 합니다. 그렇지 않으면 클라이언트가 정상적으로 시작되어도 트래픽이 코어로 들어오지 않습니다.

시스템 가이드 보기 →

project v / ecosystem

Project V 생태계와 클라이언트의 역할

그래픽 클라이언트, 프록시 코어, 설정 데이터는 서로 다른 계층에 속합니다. 각 계층의 역할을 구분해야 클라이언트 업데이트, 코어 전환, 구독 내용, 라우팅 규칙 사이의 관계를 올바르게 이해할 수 있습니다.

Project V에서 코어 제품군으로

Project V는 V2Ray 설정 모델과 모듈형 네트워크 도구의 기본 구조를 마련했습니다. 설정 파일은 인바운드, 아웃바운드, 라우팅, DNS, 전송, 로그를 서로 연동되는 모듈로 나누며, 사용자는 tag를 이용해 여러 모듈을 명확한 데이터 경로로 조합할 수 있습니다. 이러한 구조는 config.json을 수동으로 관리하기에도 적합하고, 그래픽 클라이언트가 구독과 화면 옵션에 따라 설정을 생성하기에도 편리합니다. 따라서 그래픽 클라이언트에서 보는 서버, 프록시 모드, 라우팅 프리셋, 로컬 포트는 결국 해당 설정 필드로 연결됩니다.

V2Fly는 V2Ray의 핵심 기능을 이어받아 모듈형 설정과 프로토콜 구현을 유지하고 있습니다. Xray는 유사한 설정 체계를 바탕으로 독립적인 코어로 발전했으며 여러 클라이언트에서 연결과 라우팅 처리에 사용됩니다. 둘 다 그래픽 클라이언트 자체가 아니라 클라이언트가 호출하는 하위 코어입니다. 하나의 그래픽 클라이언트가 서로 다른 코어를 중심으로 기능을 구성할 수 있고, 같은 구독도 클라이언트와 코어의 지원 범위에 따라 전송 매개변수, 라우팅 기능, 설정 작성 방식에서 세부 차이가 나타날 수 있습니다.

오픈 소스 라이선스 및 검토 가능한 업데이트

v2rayN, v2rayNG, v2flyNG 및 관련 코어는 오픈 소스 커뮤니티에서 지속적으로 유지 관리됩니다. 오픈 소스 라이선스는 코드 사용, 수정, 재배포의 범위를 정하며 프로토콜 구현, 설정 해석, 문제 수정 과정을 개발자가 공개적으로 검토할 수 있게 합니다. 일반 사용자에게 더 실용적인 기준은 현재 시스템에 맞는 클라이언트를 다운로드하고, 업데이트 내용을 읽고, 정상 작동하는 설정을 보관하며, 업그레이드 후 시스템 프록시, 라우팅, 코어 상태를 확인하는 것입니다.

클라이언트 업데이트와 코어 업데이트가 항상 동시에 이루어지는 것은 아닙니다. 인터페이스 프로그램은 구독 관리, 설정 편집, 트레이 제어, 시스템 연동을 담당하고, 코어는 프로토콜 연결, DNS, 라우팅, 트래픽 처리를 담당합니다. 업데이트가 화면 구성만 변경한다면 기존 연결 방식은 대개 바뀌지 않습니다. 코어나 설정 형식이 변경되었다면 사용자 지정 라우팅, 전송 매개변수, 이전 설정과의 호환성을 중점적으로 확인해야 합니다. 일상적인 관리에서는 소프트웨어 이름 하나만 기록하기보다 클라이언트 종류, 사용 코어, 주요 설정을 함께 기록하는 것이 문제 원인을 찾는 데 도움이 됩니다.

desktop

v2rayN

Windows, macOS, Linux용 데스크톱 그래픽 클라이언트로 구독 관리, 서버 선택, 시스템 프록시, 라우팅 프리셋, TUN 모드, 로그 보기를 지원합니다. 데스크톱에서 시스템 네트워크 설정을 폭넓게 제어해야 한다면 v2rayN부터 시작하는 것이 좋습니다.

android / xray

v2rayNG

Xray 코어를 사용하는 Android 클라이언트로 QR 코드 스캔, 클립보드 가져오기, 구독 업데이트, 앱별 프록시, 라우팅 설정을 제공합니다. Xray 관련 매개변수를 이미 사용하거나 해당 프로토콜 기능이 필요하다면 모바일 기본 선택지로 사용할 수 있습니다.

android / v2fly

v2flyNG

V2Fly 코어 기반의 Android 대안 클라이언트로, 인터페이스와 일반적인 구독 절차가 익숙한 편입니다. V2Fly 설정 체계를 유지하거나 코어별 동작 차이를 확인해야 할 때 실제 설정 요구 사항에 따라 선택할 수 있습니다.

workflow / checklist

클라이언트 업데이트 전 기록할 네 가지 설정

  1. 활성 설정: 현재 사용하는 구독 그룹과 서버 항목을 확인해 업데이트 후 다른 설정을 잘못 선택하지 않도록 합니다.
  2. 프록시 모드: 시스템 프록시, PAC, 전역, 규칙, TUN의 현재 상태를 기록해 기존 경로를 쉽게 복원할 수 있도록 합니다.
  3. 로컬 포트: SOCKS와 HTTP 리스닝 포트를 확인합니다. 브라우저에서 수동 프록시를 설정할 때는 같은 값을 사용해야 합니다.
  4. 사용자 지정 규칙: 직접 추가한 도메인, IP, 프로세스, 출구 tag를 별도로 저장하고 업데이트 후 매칭 결과를 하나씩 확인합니다.

quick answers

자주 묻는 질문

구독을 가져온 뒤 서버가 보이지 않는 이유는 무엇인가요?

먼저 구독 업데이트를 한 번 실행한 다음 구독 그룹이 활성화되어 있는지, 링크가 완전한지, 클라이언트 로그에 해석 오류가 없는지 확인하세요. 전체 절차는 구독 가져오기 단계를 참고할 수 있습니다.

시스템 프록시와 TUN 모드는 어떻게 다른가요?

시스템 프록시는 시스템 프록시 설정을 따르는 앱의 트래픽을 주로 처리하고, TUN 모드는 가상 네트워크 인터페이스를 통해 더 넓은 범위의 트래픽을 처리합니다. 선택하기 전에 TUN 모드 섹션을 먼저 읽어 보세요.

포트가 사용 중일 때 어떤 항목을 변경해야 하나요?

먼저 로컬 리스닝 포트를 점유한 프로세스를 찾은 다음 클라이언트의 SOCKS 또는 HTTP 포트를 변경하고 브라우저와 다른 앱의 프록시 설정도 함께 수정하세요. 포트 충돌 문제 해결에서 자세히 확인할 수 있습니다.

데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?

최신 시스템이라면 크로스 플랫폼 데스크톱 버전을 먼저 고려하고, 클래식 인터페이스와 기존 사용 방식이 중요하다면 WPF 버전과 비교해 보세요. 구체적인 차이는 클라이언트 비교 페이지에 정리되어 있습니다.

notes / latest

V2Ray 사용 팁과 설정 기록

문서는 재현 가능한 문제를 중심으로 구성합니다. 먼저 발생 조건을 설명한 뒤 설정 경로, 확인 방법, 복구 절차를 제시합니다. 설정 구조를 다룰 때는 각 필드의 역할도 함께 설명해 그래픽 인터페이스의 조작을 코어 설정과 연결해 이해할 수 있도록 합니다.