V2RAYN · V2RAYNG · V2FLYNG

V2Ray for Macv2rayN 다운로드 및 설정

기기에 맞는 오픈 소스 클라이언트를 선택하고, 한국어 가이드에 따라 구독 가져오기와 라우팅 설정을 진행하세요.

Xray V2Fly JSON 설정
클라이언트 목록운영체제별 검색

V2Ray 클라이언트 설치 파일

먼저 기기의 운영체제를 확인한 다음 프로세서 아키텍처와 설치 파일 형식을 살펴보세요. 앱을 기기에 설치할 수 있는지와 코어가 구독 설정을 실행할 수 있는지는 별개의 문제입니다. 처음 설치할 때는 설치 가능 여부부터 확인하고, 노드를 가져온 뒤 프로토콜과 전송 매개변수를 점검하세요.

첫 설치 및 기기 이전

기존 기기에서 옮기는 경우, 사용자 지정 규칙을 처음부터 하나씩 복사할 필요는 없습니다. 사용 중인 클라이언트, 구독 출처, 코어 종류, 적용 중인 라우팅 정책을 먼저 기록하세요. 새 기기에서 노드 그룹 하나를 가져오고, 정상 작동이 확인된 노드로 기준을 잡은 뒤 나머지 규칙을 복원하면 됩니다. 기존 기기의 시스템 프록시 주소와 포트, LAN 접근 설정이 새 기기에 적합하지 않을 수도 있습니다.

설치가 실패하면 오류가 어느 단계에서 발생했는지 먼저 확인하세요. 설치 프로그램이 열리지 않으면 프로세서와 패키지 형식을 점검하고, 앱은 열리지만 코어가 시작되지 않으면 시작 로그를 확인하세요. 특정 노드만 연결되지 않는 경우에는 해당 노드의 프로토콜과 매개변수를 살펴보면 됩니다. 이렇게 하면 설치 문제를 구독 만료로 오해하거나 노드 하나를 고치려고 클라이언트 전체를 다시 설치하는 일을 피할 수 있습니다.

모든 클라이언트 보기 →

설정 순서

구독 가져오기부터 프록시 사용까지

먼저 코어에서 노드 하나를 정상적으로 연결한 다음, 어떤 앱의 트래픽이 클라이언트로 전달되는지 확인하세요. 아래 5단계는 필요한 항목만 따로 살펴볼 수 있습니다. 오른쪽은 화면과 로그를 대조하기 위한 필드 및 설정 예시이며, 그대로 실행할 수 있는 완전한 설정은 아닙니다.

구독 그룹 유지

구독 주소를 별도의 구독 그룹에 입력한 뒤 직접 업데이트하세요. 업데이트 후 목록에 노드가 표시되는지 확인하고, 노드의 프로토콜과 이름도 점검합니다. 클립보드에서 노드 하나를 가져오는 방식과 달리 구독 그룹에는 이후 업데이트의 출처가 기록되므로 서비스 제공자의 변경 사항과 직접 기록한 내용을 구분하기 쉽습니다. 목록이 비어 있다면 시스템 프록시를 먼저 바꾸지 말고 구독 주소와 유효 기간, 클라이언트가 인식할 수 있는 응답 형식부터 확인하세요. 구독 링크에 접근 정보가 포함될 수 있으므로 화면을 캡처하거나 도움을 요청할 때는 전체 주소를 가리세요.

구독 가져오기 단계 보기

구독 그룹 설정
현재 구독 업데이트
클립보드에서 여러 URL 가져오기

프로젝트 관계 및 유지 관리

Project V, V2Fly 및 Xray

다운로드 페이지의 앱 이름, 구독에 표시된 프로토콜명, 로그의 코어 이름은 서로 다른 계층을 가리킵니다. 이 세 가지를 구분해야 설치 파일을 바꿀지, 코어를 바꿀지, 매개변수 하나만 수정할지 판단할 수 있습니다. 이 핸드북은 클라이언트 다운로드 경로와 설정 방법을 정리하며, 클라이언트와 코어의 개발 및 배포는 각 프로젝트 관리자가 담당합니다.

Project V와 V2Ray의 기원

Project V는 프록시 도구 생태계의 프로젝트 이름이며, V2Ray는 그중 연결을 처리하고 전달하는 핵심 프로그램입니다. 인바운드, 아웃바운드, 라우팅을 각각 별도의 설정 영역으로 나눕니다. 인바운드는 연결을 수신하고, 아웃바운드는 연결을 내보내는 방식을 정하며, 라우팅은 두 영역 사이에서 경로를 선택합니다. 그래픽 클라이언트는 자주 사용하는 항목을 양식으로 정리하고 현재 노드와 규칙에 맞춰 설정을 생성할 수도 있습니다. 따라서 화면에 표시된 내용이 실제 실행되는 설정과 한 글자씩 똑같지는 않을 수 있습니다.

예전 가이드를 볼 때는 설명하는 내용이 인터페이스 조작인지 코어 필드인지 먼저 구분하세요. 예를 들어 ‘시스템 프록시’를 켜라는 안내는 앱 트래픽을 로컬 인바운드로 보내는 설정입니다. 설정에 routing.rules가 있다면 코어가 트래픽을 받은 뒤 적용하는 규칙입니다. 시스템 설정이 적용됐다고 해서 특정 라우팅 규칙이 일치한다는 뜻은 아닙니다. 반대로 규칙이 올바르더라도 프록시를 거치지 않는 앱의 트래픽은 받을 수 없습니다. 예전 화면을 그대로 따라 하기보다 이 두 경계를 기준으로 문제를 나누는 편이 더 정확합니다.

V2Fly와 Xray의 분기

V2Fly 커뮤니티는 V2Ray의 유지 관리를 이어가고 있습니다. Xray는 V2Ray 코드에서 포크된 뒤 독자적으로 발전하면서 REALITY와 XTLS Vision 등의 기능을 추가했습니다. 두 코어는 설정 구조 일부가 비슷하지만, 필드명이나 프로토콜, 전송 방식이 같다고 해서 서로 호환되는 것은 아닙니다. 이전할 때는 서버 설정이나 구독 안내에서 필요한 프로토콜, 전송 방식, 보안 계층을 확인하고 클라이언트 시작 로그에서 해당 조합을 지원하는 코어가 실행됐는지 확인하세요.

프로토콜은 연결 양쪽이 데이터를 주고받는 방식을 정하고, 전송 방식은 프로토콜 메시지를 전달하는 방식을 정합니다. 보안 계층에는 별도의 핸드셰이크와 인증 조건이 있습니다. 예를 들어 노드가 VLESS를 사용한다는 정보만으로는 어떤 클라이언트를 선택할지 결정할 수 없습니다. 특정 보안 계층이나 흐름 제어가 필요한지도 확인해야 합니다. 설정이 시작 전에 거부되면 인식되지 않는 필드를 먼저 살펴보세요. 설정은 통과했지만 핸드셰이크가 실패한다면 서버에서 제공한 매개변수를 하나씩 대조하세요. 두 오류 모두 연결 실패로 나타날 수 있지만 해결 방법은 다릅니다.

세 가지 오픈 소스 클라이언트의 역할

v2rayN은 구독 관리, 노드 선택, 로컬 프록시 설정을 한 화면에서 다루는 오픈 소스 데스크톱 클라이언트입니다. v2rayNG는 Xray 코어를 사용하는 오픈 소스 모바일 클라이언트이며, v2flyNG도 V2Fly 코어가 필요한 설정을 위한 오픈 소스 클라이언트입니다. 오픈 소스 라이선스는 코드를 사용하고 수정하며 배포하는 방법을 정합니다. 관련 프로젝트와 배포 자료의 라이선스를 확인하고, 클라이언트 라이선스와 코어 또는 다른 의존성의 라이선스를 혼동하지 마세요.

앱을 바꾸기 전에 실제로 코어 차이가 원인인지 먼저 확인하세요. 예를 들어 컴퓨터에서는 연결되지만 휴대전화에서는 앱이 화면에 떠 있을 때만 작동한다면 시스템의 VPN 권한과 백그라운드 실행 제한을 먼저 살펴보세요. 한 기기에서 일부 도메인만 실패한다면 DNS 해석과 라우팅을 확인하세요. 앱을 바꾸면 기본 라우팅, 포트, 트래픽 처리 방식이 함께 달라질 수 있습니다. 반복 가능한 테스트를 유지하지 않으면 연결이 복구된 이유가 코어 변경인지 기존 시스템 설정의 초기화인지 판단하기 어렵습니다.

클라이언트, 코어 및 규칙 업데이트

클라이언트 업데이트는 인터페이스, 패키징 방식, 설정 생성 로직을 바꿀 수 있습니다. 코어 업데이트는 필드 지원, 기본 동작, 로그 내용을 바꿀 수 있고, 지리 데이터나 사이트 규칙 업데이트는 라우팅 규칙의 일치 범위를 바꿀 수 있습니다. 이 세 가지 업데이트가 항상 동시에 배포되는 것은 아닙니다. 문제를 기록할 때 앱, 코어, 구독, 규칙 데이터 중 무엇을 변경했는지 적어야 새 증상과 해당 변경 사항을 비교할 수 있습니다.

사용자 지정 인바운드나 라우팅에 의존하는 기존 설정이 있다면 업데이트 전에 로컬 백업을 만들고 평소 연결 확인에 사용하는 항목도 기록하세요. 업데이트 후에는 코어가 시작되는지 확인한 다음 로컬 수신, 핸드셰이크, 도메인 해석, 라우팅이 예상대로 동작하는지 점검하세요. 특히 업무 네트워크의 내부 도메인과 직접 연결해야 하는 서비스는 노드 속도 테스트 한 번으로 전체 동작을 확인할 수 없습니다. 필드 계층을 대조하려면 JSON 핸드북을 참고하세요.

설치 및 연결 관련 자주 묻는 질문

처음 설정할 때는 문제가 어느 계층에서 발생했는지 먼저 확인하세요. 아래 질문을 점검 순서로 활용할 수 있습니다.

구독을 가져왔으면 바로 사용할 수 있나요?

목록에 노드가 표시된다는 것은 클라이언트가 구독 내용을 읽었다는 뜻일 뿐입니다. 노드를 선택한 뒤 코어가 정상적으로 시작됐는지 확인하고, 로컬 프록시를 사용하는 앱에서 요청을 보내야 합니다. 클라이언트의 속도 테스트는 되지만 브라우저 트래픽이 기록되지 않는다면 구독을 다시 가져오기 전에 브라우저가 현재 시스템 프록시를 사용하는지 확인하세요. 노드 목록은 표시되는데 시작 중 필드 오류가 발생하면 DNS를 조정하지 말고 코어 호환성을 확인하세요. 가져오기 및 확인 단계 보기.

시스템 프록시와 V2Ray 전체 프록시는 같은 설정인가요?

아닙니다. 시스템 프록시는 해당 설정을 따르는 앱이 접속할 로컬 주소를 정하고, 전체 라우팅은 일반적으로 코어에 들어온 트래픽을 어떤 아웃바운드 정책으로 처리할지 정합니다. 앱이 직접 연결하면 코어의 전체 라우팅 규칙에는 해당 연결이 전달되지 않습니다. 프록시 연결 방식 보기.

연결은 되는데 일부 도메인만 열리지 않는 이유는 무엇인가요?

같은 앱에서 접속 가능한 도메인 하나와 실패하는 도메인 하나를 비교하면서 DNS 응답 여부, 예상한 규칙의 일치 여부, 선택된 아웃바운드가 적절한지 각각 확인하세요. 테스트할 때는 노드와 네트워크 환경을 유지하고 설정 하나만 변경하세요. 가이드에 따라 하나씩 확인하기.

기존 기기의 설정을 그대로 복사해도 되나요?

구독과 꼭 필요한 규칙부터 옮긴 뒤 새 환경에 맞게 코어, 수신 주소, 포트, 시스템 프록시를 확인하세요. 기존 기기의 네트워크 어댑터, LAN 주소, 예외 목록을 보편적인 기본값으로 간주하지 마세요. 클라이언트 설정 순서 보기.

사용 팁

코어 선택 및 연결 문제 해결

증상별로 확인하세요. 노드가 시작하자마자 오류를 내면 코어와 필드를 먼저 확인하고, 코어는 실행 중인데 노드 속도 테스트가 시간 초과되면 연결 조건을 살펴보세요. 노드 속도 테스트는 통과하지만 웹페이지가 열리지 않는다면 앱 요청이 로컬 프록시로 전달되는지 먼저 확인하세요.