기기에 맞는 오픈 소스 클라이언트를 선택하고, 구독 가져오기부터 라우팅 규칙까지 설정 항목을 확인해 구성하세요.
v2rayN과 v2rayNG는 그래픽 인터페이스를 제공하고, Xray와 V2Fly 코어는 연결을 처리합니다. 먼저 기기에 맞는 클라이언트를 고른 다음 구독 매개변수, 프록시 모드, 라우팅 규칙을 확인하면 화면 설정과 코어 설정 항목을 혼동하지 않을 수 있습니다.
트래픽이 들어오는 지점부터 나가는 경로까지, 실제 사용 순서에 따라 다섯 가지 설정을 살펴봅니다. 아래 예시는 항목 설명용이며 원격 서버에 바로 연결할 수 있는 완성된 설정은 아닙니다.
시스템 프록시는 시스템 설정을 따르는 앱의 요청을 클라이언트로 보낼지 결정합니다. 구독을 가져오고 서버를 선택한 뒤 트레이 메뉴에서 시스템 프록시를 설정하고 브라우저에서 연결을 확인하세요. 시스템 프록시와 라우팅 모드는 서로 다른 설정입니다. 전자는 트래픽이 로컬 리스너로 들어올지 결정하고, 후자는 들어온 트래픽을 어떤 출구로 보낼지 정합니다. 일부 앱은 별도의 프록시 설정을 사용하므로 리스닝 주소와 포트를 따로 입력해야 합니다. 문제가 생기면 코어가 실행 중인지, 포트가 일치하는지 먼저 확인하세요. 클라이언트를 종료하기 전 시스템 프록시를 해제해야 앱이 종료된 리스닝 포트를 계속 가리키는 일을 막을 수 있습니다.
설정 항목 확인
로컬 혼합 리스닝 포트: 10808
로컬 앱 프록시 주소: 127.0.0.1
시스템 프록시: 시스템 프록시 자동 설정
클라이언트 종료 전: 시스템 프록시 해제
주의: 실제 설정된 포트를 기준으로 사용하세요.라우팅 규칙은 트래픽이 코어에 들어온 뒤 출구를 선택합니다. 주로 도메인, 대상 주소, 포트를 조건으로 사용합니다. 규칙은 보통 순서대로 확인하며 먼저 일치하는 규칙이 최종 경로에 영향을 주므로, 구체적인 조건을 포괄적인 조건보다 앞에 두어야 합니다. 예시에서는 사설 주소를 direct라는 출구로 보내며, 이 출구는 아웃바운드 설정에도 정의해야 합니다. 클라이언트의 기본 라우팅 설정으로 기준을 잡은 뒤 예외를 하나씩 추가하는 방식이 좋습니다. 시스템 프록시와 달리 라우팅은 앱의 트래픽을 가로채지 않습니다. 규칙이 올바르더라도 코어에 들어오지 않은 요청에는 적용되지 않습니다.
{
"routing": {
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}그래픽 클라이언트와 프록시 코어는 별도로 관리됩니다. 인터페이스에서 특정 공유 링크를 가져올 수 있다고 해서 현재 코어가 그 안의 모든 설정을 처리할 수 있는 것은 아닙니다. 먼저 프로토콜, 전송 방식, 보안 계층을 확인한 뒤 사용할 코어를 선택하세요. REALITY 연결에는 해당 설정을 지원하는 Xray 코어를 선택하고 서버 설정과 일치하는지 확인해야 합니다. Android에서는 v2rayNG가 Xray 생태계에, v2flyNG가 V2Fly 생태계에 대응합니다. 코어를 바꾸기 전 기존 설정을 보관하고, 시작 오류가 나면 로그에 표시된 항목을 확인하세요. 여러 매개변수를 한꺼번에 변경하지 마세요.
선택 전 확인
프로토콜: VMess / VLESS / Trojan
전송 방식: 서버의 실제 설정에 따름
보안 계층: TLS / REALITY 등
코어: 위 조합을 지원하는지 확인
클라이언트: 해당 설정을 생성할 수 있는지 확인구독 주소는 여러 설정을 가져오는 데 사용되며, 업데이트 후 생성된 서버 항목이 실제 연결 대상입니다. 구독 그룹 설정에서 이름과 주소를 추가하고 저장한 뒤 해당 그룹을 업데이트하고 목록에서 사용할 서버를 선택하세요. 업데이트에 실패하면 주소에 연결할 수 없는 경우, 응답 형식이 올바르지 않은 경우, 클라이언트가 해석하지 못하는 경우를 구분해 확인하세요. 기존 그룹을 보관하면 변경 전후를 비교하기 쉽습니다. 구독에는 접속 정보가 포함될 수 있으므로 공개 스크린샷에 올리거나 출처가 불분명한 변환 서비스에 제공하지 마세요. 여러 기기에서 사용할 때는 라우팅과 프록시 모드도 각각 확인해야 하며 구독과 함께 동기화되지 않을 수 있습니다.
구독 관리 순서
1. 구독 그룹 추가
2. 신뢰할 수 있는 출처의 구독 주소 입력
3. 현재 그룹 업데이트
4. 서버 항목 확인
5. 사용할 서버 선택
6. 로컬 프록시 모드 확인TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시를 따르지 않는 앱도 처리할 수 있지만, 추가 권한과 라우팅 및 DNS 설정이 필요합니다. 먼저 시스템 프록시로 서버 연결을 확인한 다음 TUN을 켜는 것이 좋습니다. 그래야 연결 매개변수 문제와 트래픽 처리 문제를 분리할 수 있습니다. 데스크톱에서는 권한 상승이 필요할 수 있고, 기존 가상 네트워크 어댑터나 네트워크 도구와 라우팅 충돌이 발생할 수도 있습니다. Android 클라이언트의 VPN 모드는 시스템 권한을 받아 트래픽 처리 경로를 설정하므로 앱별 목록도 확인해야 합니다. 문제가 생기면 먼저 트래픽 가로채기를 끄고 일반 네트워크가 복구되는지 확인하세요.
사용 전 확인
시스템 프록시 모드에서 연결이 정상적으로 작동함
시스템 권한 안내를 확인함
다른 트래픽 가로채기 도구가 실행 중이지 않음
DNS 및 라우팅 정책이 일치함
트래픽 가로채기를 끄고 네트워크를 복구하는 방법을 알고 있음먼저 '앱이 트래픽을 프록시에 전달하는지'와 '코어가 트래픽을 어떻게 처리하는지'를 분리해 생각하세요. 브라우저에서 접속이 안 된다고 해서 서버 설정이 잘못된 것은 아닙니다. 브라우저가 시스템 프록시를 따르지 않거나 리스닝 포트를 다른 프로그램이 사용 중일 수 있고, 클라이언트가 시작된 직후 코어가 종료됐을 수도 있습니다. 한 번에 하나의 설정만 바꾸고 같은 대상에 다시 접속해 보면 모든 스위치를 계속 바꾸는 것보다 원인을 찾기 쉽습니다.
로그도 단계별로 확인하세요. 시작 단계에서는 설정 파싱과 포트 리스닝을, 연결 단계에서는 도메인 조회와 핸드셰이크 및 시간 초과를 살펴봅니다. 필요할 때만 로그 수준을 일시적으로 높이고 문제 해결 후에는 평소 수준으로 되돌리세요. 로그를 공유하기 전 구독 주소, 인증 정보, 서버 식별 정보를 삭제하세요. 전체 구조를 파악하려면 설정 항목에서 인바운드, 아웃바운드, 라우팅 간 참조 관계를 확인하세요.
데스크톱에서는 v2rayN을, Android에서는 코어에 따라 v2rayNG 또는 v2flyNG를 확인하세요. 여기서 플랫폼별 설치 패키지 목록으로 이동할 수 있으며, 최신 릴리스 정보와 파일은 다운로드 페이지에서 확인할 수 있습니다.
트레이 메뉴에서 시스템 프록시, 구독 그룹, 라우팅 모드를 관리하려는 데스크톱 사용자에게 적합합니다. 다운로드 페이지에는 크로스 플랫폼 인터페이스 버전과 클래식 WPF 버전이 구분되어 있습니다. 선택하기 전에 운영체제와 프로세서 아키텍처를 확인하고 파일 확장자만으로 판단하지 마세요.
처음 설정할 때는 일반 권한으로 실행하고 구독을 가져오세요. 로컬 리스너가 정상 작동하는지 확인한 뒤 시스템 프록시를 설정하세요. 추가 권한이 필요한 트래픽 가로채기 기능을 켤 계획이라면 권한 안내가 무엇을 의미하는지 먼저 확인해야 합니다. 다른 네트워크 도구가 설치되어 있다면 두 클라이언트가 시스템 설정을 반복해서 덮어쓰지 않도록 기존 프록시 가로채기를 먼저 종료하세요.
다운로드로 이동칩에 맞춰 Apple Silicon 또는 Intel 설치 패키지를 선택하세요. 시스템의 '이 Mac에 관하여'에서 칩 정보를 확인한 다음 다운로드하면 아키텍처가 맞지 않아 실행되지 않는 문제를 막을 수 있습니다. 데스크톱에서 구독과 라우팅의 기본 개념은 같지만 메뉴 위치는 실제 인터페이스에 따라 다를 수 있습니다.
처음 실행할 때 개발자 확인이나 네트워크 권한 안내가 표시되면 시스템 설정에서 안내 내용을 확인하고 해당 앱에 필요한 조치만 적용하세요. 클라이언트를 실행하려고 시스템 보호 기능 전체를 끄지 마세요. 설치 후 시스템 프록시가 클라이언트 리스닝 주소를 가리키는지 확인하세요. 클라이언트를 종료한 뒤에도 네트워크에 접속할 수 없다면 남아 있는 프록시 설정부터 확인하세요.
다운로드로 이동Xray 설정이 필요하다면 v2rayNG를 먼저 확인하고, V2Fly 설정을 사용해야 할 때 v2flyNG를 고려하세요. 대부분의 최신 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 확인하기 어렵다면 범용 패키지 안내를 살펴보세요. 두 클라이언트의 설정은 각각 관리해야 하며 이름이 비슷하다고 해서 매개변수까지 완전히 호환되는 것은 아닙니다.
구독을 가져온 뒤 서버를 선택하고 첫 연결 시 시스템 VPN 권한을 확인하세요. 앱별 프록시 목록에 따라 트래픽을 처리할 앱이 달라지므로 테스트할 때는 목록에 명확히 포함된 앱을 사용하세요. 백그라운드로 전환한 뒤 연결이 끊기면 클라이언트를 다시 설치하기보다 시스템의 배터리 관리와 백그라운드 실행 제한을 확인하세요.
다운로드로 이동배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택한 뒤 x64와 arm64 아키텍처를 확인하세요. 그래픽 클라이언트는 데스크톱 환경에서 구독을 관리하고 로그를 확인하는 데 적합하지만, 설치했다고 모든 앱이 자동으로 로컬 프록시를 사용하는 것은 아닙니다.
데스크톱 환경에 따라 시스템 프록시를 처리하는 방식이 다를 수 있습니다. 브라우저, 터미널 프로그램, 백그라운드 서비스가 각각 별도의 프록시 설정을 사용할 수도 있으므로 앱 유형별로 확인하세요. 특정 앱 하나의 접속 성공만으로 모든 트래픽이 처리된다고 판단하면 안 됩니다. 가상 네트워크 인터페이스를 사용하려면 권한, 시스템 라우팅, 기존 네트워크 관리 도구 간의 관계를 먼저 확인하세요.
다운로드로 이동데스크톱용 v2rayN과 Android용 v2rayNG를 중심으로 안내합니다. 설치, 설정, 트래픽 처리를 단계별로 진행하면 문제가 생겼을 때 확인할 지점을 쉽게 찾을 수 있습니다.
먼저 운영체제와 아키텍처에 맞는 설치 패키지를 선택하고 클라이언트를 실행한 뒤 구독 그룹 메뉴를 찾으세요. 구독을 구분하기 쉬운 이름으로 지정하고 신뢰할 수 있는 출처에서 받은 주소를 입력해 저장한 다음 해당 그룹을 업데이트하세요. 주소 전체를 그대로 입력해야 하며 특히 끝부분의 매개변수를 빠뜨리지 마세요. 메신저에서 복사할 때 불필요한 공백이나 줄바꿈이 들어가지 않았는지도 확인하세요.
업데이트가 끝나면 목록에 서버 항목이 표시되는지 확인하세요. 그룹 이름만 있고 서버가 없다면 업데이트 안내를 확인해 네트워크 가져오기 실패인지 내용 해석 실패인지 구분하세요. 클라이언트에는 원격 서버가 포함되어 있지 않으므로 설치 후에도 사용할 권한이 있는 설정이 필요합니다. 구독 주소에 민감한 매개변수가 있다면 스크린샷에 전체 주소를 표시하지 마세요.
서버 목록에서 사용할 항목을 고르고 프로토콜과 코어의 호환성을 확인하세요. 데스크톱에서는 먼저 시스템 프록시를 설정하고 Android에서는 VPN 모드와 시스템 권한을 확인하세요. 처음에는 클라이언트의 기본 라우팅을 유지하고 기본 연결이 된 뒤 사용자 지정 도메인 규칙이나 앱별 목록을 추가하는 것이 좋습니다.
서버 목록의 테스트 결과는 특정 테스트 방식에서의 연결 상태만 보여 줄 뿐 모든 웹사이트와 앱에서 작동한다는 뜻은 아닙니다. 특정 항목을 사용할 수 없다면 연결 로그를 확인한 다음 서버 주소와 포트, 인증 정보, 기기 시간을 점검하세요. 전송 방식과 보안 계층을 계속 바꾸면 기존에 작동하던 설정의 조합이 맞지 않게 될 수 있습니다.
실제로 사용할 앱으로 명확한 대상에 접속해 클라이언트 로그에 관련 연결이 기록되는지 확인하세요. 기록이 없으면 먼저 앱이 프록시를 사용하는지 확인하세요. 기록은 있지만 연결에 실패하면 도메인 조회, 핸드셰이크, 시간 초과 정보를 살펴보세요. 한 번에 하나의 요소만 조정하고 변경 전후 결과를 기록하세요.
정상 작동을 확인한 뒤 필요에 따라 라우팅 예외, 백그라운드 실행, 시작 시 자동 실행을 설정하세요. 컴퓨터와 휴대폰에서 같은 구독 출처를 사용할 수 있지만 시스템 프록시, VPN 권한, 앱별 목록은 각각 설정해야 합니다. 데스크톱 클라이언트를 종료하기 전에 시스템 프록시를 해제하세요. 네트워크 문제가 생기면 일반 네트워크를 먼저 복구한 뒤 트래픽 가로채기를 하나씩 다시 켜세요.
프로젝트 생태계, 프록시 코어, 그래픽 클라이언트를 구분하면 설정을 어디로 가져오고 어떤 구성 요소가 실행하는지 판단하기 쉽습니다.
Project V는 V2Ray 기술 생태계를 이해하는 출발점입니다. 모듈형 프록시와 인바운드, 아웃바운드, 라우팅을 중심으로 범용적인 설정 방식을 갖추고 있습니다. V2Fly는 V2Ray 코어의 커뮤니티 개발을 이어가고, Xray는 관련 코드 기반에서 분기해 프로토콜과 전송 기능을 자체적으로 발전시켜 왔습니다. 공통된 역사가 있다고 해서 모든 설정 항목과 기본 동작, 프로토콜 조합을 서로 바꿔 쓸 수 있는 것은 아닙니다. 가이드를 읽을 때는 먼저 어떤 코어를 다루는지 확인하세요.
v2rayN은 구독과 서버 선택, 로그, 시스템 프록시를 데스크톱 그래픽 인터페이스에서 관리합니다. v2rayNG는 Android용으로 Xray 코어에 맞춰 설정을 구성하고, v2flyNG는 V2Fly 코어를 위한 Android 그래픽 인터페이스를 제공합니다. 세 클라이언트는 오픈 소스 프로젝트이며 인터페이스와 코어 프로젝트의 개발 일정은 서로 다를 수 있습니다. 기능을 사용할 수 있는지 판단할 때는 클라이언트가 해당 설정을 생성할 수 있는지와 실제 실행 중인 코어가 이를 지원하는지 모두 확인해야 합니다.
오픈 소스는 해당 라이선스에 따라 소스 코드가 공개되고 사용, 수정, 배포 조건이 정해져 있다는 뜻입니다. 모든 구성 요소에 같은 라이선스가 적용되는 것은 아닙니다. 예를 들어 v2rayN의 GPL-3.0, v2rayNG의 GPL-3.0, V2Fly 코어의 MIT 라이선스는 각각 다르므로 재배포하기 전에 관련 구성 요소의 라이선스 조건을 따로 확인해야 합니다. 일반 사용자는 클라이언트의 출처와 설정을 사용할 권한이 있는지, 프록시 및 네트워크 트래픽 처리 기능을 이해하고 켰는지 확인하세요.
클라이언트를 업데이트하면 인터페이스나 설정 생성 방식, 함께 제공되는 코어가 바뀔 수 있으며 코어 업데이트도 설정 항목의 호환성에 영향을 줄 수 있습니다. 다운로드 페이지에서 현재 릴리스 경로를 확인할 수 있으며 홈페이지는 특정 릴리스 번호로 고정되지 않습니다. 업데이트 전에 구독 그룹과 필요한 설정을 보관하고, 업데이트 후에는 기존 모드로 먼저 테스트한 다음 새 기능을 사용해 보세요. 문제가 생기면 로그와 설정 차이를 비교하세요. 근거 없이 특정 코어 계열을 원인으로 단정하지 마세요.
V2Ray 릴리스 페이지는 클라이언트 다운로드와 중국어 설정 참고 자료를 제공하며, 사이트 이름은 상위 프로젝트와의 공식 관계를 뜻하지 않습니다. 사이트 안내는 조작 순서와 설정 항목의 의미에 중점을 두며 서버 계정이나 구독 서비스를 제공하지 않습니다. 프로토콜의 구체적인 지원 여부는 사용 중인 클라이언트와 코어, 서버 설정을 함께 확인해야 합니다. 사이트의 방향과 콘텐츠 관리 원칙은 사이트 소개에서 확인하세요.
설정 구조와 데스크톱 인터페이스부터 여러 기기 간 동기화까지 실제 사용 사례에 맞춰 살펴봅니다. 문서에 나오는 메뉴와 항목은 사용 중인 클라이언트 화면과 대조해 확인하세요.
구독 링크, 공유 QR 코드, 클립보드 가져오기, 설정 파일 내보내기의 네 가지 방법을 비교하고 v2rayN과 v2rayNG에서 노드를 동일하게 유지할 수 있는 상황과 주의사항을 안내합니다.
동기화 방법 보기 →v2rayN 메인 창의 주요 영역을 살펴봅니다. 서버 목록의 마우스 오른쪽 버튼 메뉴, 구독 그룹 전환, 하단 로그 읽는 법, 설정 메뉴와 트레이의 주요 기능을 안내합니다.
화면 안내 보기 →클라이언트에서 내보낸 완성된 설정을 예시로 인바운드 리스너, 아웃바운드 프록시, 라우팅 규칙의 각 항목과 서로 tag로 연결되는 방식을 설명합니다.
설정 노트 읽기 →