클라이언트 및 설정 문서

V2Ray 문서 및 클라이언트

v2rayN 다운로드 설정 가이드 보기

클라이언트 설치·구독 가져오기·라우팅 분할 방법을 한곳에 정리했습니다. 플랫폼 선택부터 연결 확인까지 순서대로 살펴보세요.

영구 무료 오픈 소스 한국어 문서 Xray · V2Fly

client workflow

구독 가져오기부터 라우팅 분할까지

클라이언트 설정은 단순히 스위치 하나를 켜는 작업이 아닙니다. 구독, 프록시, 라우팅, 확인의 네 단계를 차례로 점검하면 설정 문제를 더 빠르게 찾고 여러 기기에서 일관된 사용 방식을 유지할 수 있습니다.

subscription

구독 가져오기 및 업데이트 순서

구독 링크는 클라이언트가 인식할 수 있는 설정을 한곳에서 전달하는 데 사용됩니다. 처음에는 전체 주소를 복사한 뒤 구독 그룹에 새 소스를 추가하고 업데이트를 실행하세요. 목록에 설정이 표시되면 현재 사용할 항목도 선택해야 합니다. '가져오기 성공'이 곧 '연결 완료'를 의미하지는 않습니다. 이후 업데이트는 기존 그룹에서 실행해야 같은 이름의 항목이 중복 생성되는 것을 막을 수 있습니다. 업데이트에 실패하면 먼저 주소가 잘리지 않았는지와 시스템 시간이 정확한지 확인한 다음 네트워크 상태와 구독 소스의 정상 여부를 점검하세요.

구독 가져오기 단계 보기
구독 그룹 소스별 관리
구독 추가 주소 입력
구독 업데이트 수동 실행
설정 선택 활성 항목으로 지정

platforms

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

데스크톱 플랫폼에서는 v2rayN을 사용하고, 모바일 기기에서는 v2rayNG와 v2flyNG 중에서 선택할 수 있습니다. 다운로드 센터는 운영체제와 프로세서 유형별로 파일을 안내하므로 플랫폼 설명을 건너뛰지 않고 확인할 수 있습니다.

desktop

Windows

v2rayN 그래픽 클라이언트가 적합합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 Windows 사용 방식을 유지합니다. 두 버전 모두 구독 그룹·시스템 프록시·라우팅 모드·연결 테스트를 지원합니다. 다운로드 페이지에서 원하는 인터페이스에 따라 선택하세요.

다운로드로 이동

desktop

macOS

v2rayN 데스크톱 클라이언트를 사용하세요. 다운로드하기 전에 시스템 정보에서 칩 유형을 확인한 뒤 Apple Silicon 또는 Intel에 맞는 설치 파일을 선택합니다. 구독 가져오기와 라우팅 설정은 다른 데스크톱 플랫폼과 비슷하므로 설정을 옮길 때 같은 이름의 옵션을 쉽게 대조할 수 있습니다.

다운로드로 이동

mobile

Android

Xray 코어를 사용하는 v2rayNG를 우선 선택하고, 설정 소스와 코어 요구 사항에 따라 v2flyNG를 선택할 수도 있습니다. 대부분의 최신 기기에는 arm64 파일이 적합합니다. 프로세서 아키텍처를 모르겠다면 시스템 정보를 확인한 뒤 범용 설치 파일 사용 여부를 결정하세요.

다운로드로 이동

desktop

Linux

v2rayN은 Debian, Ubuntu, Fedora 등 주요 배포판에 맞는 패키지를 제공합니다. 다운로드 전 패키지 관리 방식과 프로세서 아키텍처를 확인하고, 설치 후 데스크톱 트레이·시스템 프록시·로그인 시 자동 시작을 설정하세요. 배포판 차이와 클라이언트 오류를 혼동하지 않도록 주의해야 합니다.

다운로드로 이동
모든 클라이언트 보기 →

quickstart

세 단계로 기본 설정 완료

먼저 재현 가능한 기본 절차를 만든 뒤 라우팅과 고급 전송 매개변수를 조정하세요. 문제가 생겼을 때 구독, 클라이언트, 시스템 프록시 중 어느 단계에서 어긋났는지 명확히 판단할 수 있습니다.

전체 가이드 보기
  1. 01

    해당 클라이언트 설치

    데스크톱 기기는 v2rayN 다운로드 영역으로 이동하고, Android 기기는 v2rayNG 또는 v2flyNG를 선택하세요. 설치 전에 운영체제, 프로세서 아키텍처, 패키지 형식을 확인합니다. 처음 실행한 뒤에는 구독 그룹·서버 목록·라우팅 모드·시스템 프록시의 위치를 먼저 익히고 고급 옵션은 서둘러 변경하지 마세요.

  2. 02

    구독 가져오기 및 업데이트

    전체 구독 주소를 복사한 뒤 클라이언트의 구독 관리에서 새 그룹을 추가하고 업데이트를 실행하세요. 목록에 설정이 나타나면 사용할 항목을 선택하고 프로토콜·주소·포트·전송 방식·TLS 등의 필드가 구독에서 올바르게 제공되었는지 확인합니다. QR 코드는 기기 간 임시 이동에 편리하지만, 장기 관리는 통일된 구독 소스를 유지하는 편이 좋습니다.

  3. 03

    연결 후 단계별 확인

    코어를 시작하고 필요한 프록시 모드를 켠 다음, 로그에 포트 충돌이나 설정 해석 오류가 없는지 확인하세요. 이어서 실제 연결 테스트를 하고 마지막으로 브라우저에서 접속을 확인합니다. 기본 경로가 안정된 뒤 사용자 지정 라우팅과 DNS 설정을 추가하세요. 한 번에 한 종류의 매개변수만 변경해야 되돌리거나 결과를 비교하기 쉽습니다.

open ecosystem

Project V, V2Fly 및 Xray

클라이언트·코어·프로토콜·설정 형식은 서로 다른 계층에 속합니다. 이 관계를 이해하면 특정 화면의 버튼을 외우는 것보다 설정을 옮기거나 호환성 문제를 처리하는 데 더 도움이 됩니다.

생태계 구조

Project V는 프록시 프로토콜, 전송 방식, 라우팅 규칙, 클라이언트 도구를 중심으로 오픈 소스 생태계를 형성했습니다. V2Ray는 이 기술 체계를 통칭하는 말로 자주 사용되지만, 실제로는 그래픽 클라이언트와 하위 코어를 구분해야 합니다. 그래픽 클라이언트는 구독을 가져오고 설정을 생성하며 시스템 프록시를 관리하고 로그를 표시합니다. 코어는 설정을 해석하고 연결을 수립하며 라우팅을 실행하고 인바운드·아웃바운드 트래픽을 처리합니다. 두 계층을 나누어 이해하면 같은 구독을 여러 클라이언트가 읽을 수 있는 이유와 특정 매개변수가 특정 코어에서만 적용되는 이유를 설명할 수 있습니다.

코어 계열

V2Fly는 V2Ray의 커뮤니티 유지 방향을 이어 가며 VMess, VLESS, 라우팅, DNS 및 다양한 전송 조합을 지원합니다. Xray는 유사한 설정 체계에서 계속 발전하면서 더 많은 전송 및 프로토콜 기능을 추가했습니다. 둘은 클라이언트 이름이 아니라 그래픽 클라이언트가 호출할 수 있는 핵심 프로그램입니다. 클라이언트를 선택할 때는 기본 코어, 구독에서 제공하는 프로토콜 매개변수, 서버 설정을 함께 확인해야 합니다. 화면 모양만 비교해서는 설정이 완전히 로드되는지 판단할 수 없습니다.

세 클라이언트의 역할

v2rayN은 Windows·macOS·Linux 데스크톱 환경을 대상으로 구독 그룹·라우팅 설정·시스템 프록시·로그 확인 등의 그래픽 기능을 제공하므로 통합된 데스크톱 작업 흐름이 필요한 사용자에게 적합합니다. v2rayNG는 Android용으로, 보통 Xray 코어와 함께 사용하며 모바일 네트워크 전환·앱 프록시·QR 코드 가져오기를 중점적으로 처리합니다. v2flyNG도 Android용이며 V2Fly 코어를 주로 선택하므로 해당 코어의 동작이 필요할 때 대안이 될 수 있습니다. 세 제품 모두 커뮤니티에서 유지되는 오픈 소스 클라이언트지만 플랫폼과 코어 조합은 완전히 같지 않습니다.

오픈 소스 라이선스 및 업데이트 방식

오픈 소스 프로젝트의 코드, 라이선스, 릴리스 기록은 유지 관리 과정을 추적할 수 있는 근거를 제공합니다. 클라이언트 업데이트에는 보통 인터페이스 수정·시스템 호환성 조정·코어 연동·설정 형식 변경이 포함되며, 코어 업데이트는 프로토콜 구현·라우팅 기능·전송 동작에 영향을 줄 수 있습니다. 업데이트 전에 변경 내용을 읽고 현재 작동하는 설정을 보관하세요. 새로 설치한 뒤 문제가 생기면 모든 원인을 구독 탓으로 돌리지 말고 클라이언트 설정과 코어 로그를 각각 확인해야 합니다. 다운로드 센터는 플랫폼별 진입점을 제공하고 문서는 작업 단계별로 변경 사항의 영향을 설명합니다.

common questions

자주 묻는 질문

아래 질문은 처음 설정할 때 가장 자주 헷갈리는 단계들을 다룹니다. 전체 과정이 필요하다면 문제 해결 문서로 이동하거나 증상별 문제 해결 매뉴얼을 확인하세요.

구독을 가져온 뒤 설정이 표시되지 않으면 무엇부터 확인해야 하나요?

먼저 전체 구독 주소를 복사했는지 확인한 다음 해당 그룹에서 수동으로 업데이트를 실행하세요. 그래도 비어 있다면 시스템 시간, 로컬 네트워크, 클라이언트 로그의 응답 내용을 확인합니다. 같은 그룹을 여러 개 연속으로 만들면 실제로 어느 소스가 업데이트되었는지 확인하기 어려우므로 피하세요. 자세한 순서는 문제 해결에서 확인할 수 있습니다.

클라이언트가 실행 중인데 브라우저로 접속할 수 없는 이유는 무엇인가요?

먼저 코어가 정상적으로 시작되었는지 확인한 뒤 시스템 프록시가 켜져 있는지 점검하세요. 일부 브라우저나 앱은 자체 프록시 설정을 사용하므로 로컬 수신 주소와 포트를 별도로 입력해야 합니다. 로그에 포트 충돌이 표시되면 점유 중인 프로세스를 처리하거나 수신 포트를 변경하세요. 자세한 단계는 시스템 프록시 문제 해결에서 확인할 수 있습니다.

전역 모드와 라우팅 모드는 어떻게 선택해야 하나요?

처음 설정할 때는 비교적 단순한 모드로 기본 연결을 확인한 뒤 기본 라우팅으로 전환하세요. 라우팅 모드는 도메인·주소·규칙 집합에 따라 트래픽 출구를 결정하므로 장기간 사용에 더 적합합니다. 사용자 지정 규칙은 기본 경로가 안정된 뒤 추가하고 위에서 아래로 적용되는 순서를 주의하세요. 전체 과정은 설정 가이드에서 확인할 수 있습니다.

지연 시간 테스트를 통과하면 모든 설정이 정상이라는 뜻인가요?

테스트 통과는 해당 테스트 방식으로 응답을 받았다는 뜻일 뿐, 실제 접속 확인을 대신할 수 없습니다. 시스템 프록시·DNS·라우팅 규칙·대상 앱이 올바른 출구를 사용하는지도 확인해야 합니다. '코어 시작, 연결 테스트, 실제 접속' 순서로 각 단계를 확인하고, 실패하면 현재 단계만 처리하는 것이 좋습니다.

latest notes

최근 설정 문서

플랫폼 설치, 라우팅 규칙, 여러 기기 간 설정 이동을 중심으로 정리한 상세 문서입니다. 각 글은 하나의 구체적인 사용 상황에 집중해 필요한 문제를 바로 찾아볼 수 있습니다.

플랫폼

v2rayN Linux 데스크톱 버전 설치 가이드: deb/rpm 패키지 설치 및 systemd 부팅 시 자동 시작

Debian·Ubuntu·Fedora 계열 배포판의 패키지 선택, 의존성 처리, 트레이 표시, 사용자 서비스 설정을 설명하고 설치 후 점검 순서도 안내합니다.

전체 글 읽기 →
고급 설정

V2Ray 사용자 지정 라우팅 규칙 작성법: domain·ip·geosite 문법과 매칭 우선순위

도메인·완전 일치·정규식·주소·규칙 집합의 작성법을 분석하고, 규칙 순서가 최종 출구에 미치는 영향과 관리하기 쉬운 그룹화 방법을 정리합니다.

전체 글 읽기 →
플랫폼

V2Ray 여러 기기 설정 동기화 방식 비교: 구독 링크·설정 내보내기·QR 코드 이동

통합 구독, 설정 파일 내보내기, QR 코드 이동의 세 가지 방식을 비교하고 자동 업데이트·임시 이동·여러 기기 관리에 적합한 상황을 설명합니다.

전체 글 읽기 →
전체 글 보기 →