클라이언트 안내 및 설정 참고
v2rayN 데스크톱 클라이언트와 v2rayNG / v2flyNG 안드로이드 클라이언트의 플랫폼별 안내입니다. 구독 가져오기, 라우팅 설정, JSON 설정 필드도 함께 설명합니다.
CONFIGURATION / FIELD INDEX
앱 진입점, 커널 설정, 원격 서버를 구분한 뒤 수정할 필드를 찾아보세요.
클라이언트 창에서는 서버 정보를 저장하고 구독 그룹을 관리하며 실행 설정을 생성합니다. 커널은 들어오는 연결을 받고 라우팅을 판단해 나가는 연결을 만듭니다. 두 설정은 서로 다른 계층에 속합니다. 시스템 프록시를 바꿔도 라우팅 규칙이 바뀌는 것은 아니며, 구독을 업데이트해도 커널이 업데이트되지는 않습니다. 문제가 생기면 먼저 어느 계층에서 발생했는지 파악한 다음 해당 설정 화면이나 로그를 확인하세요. 여러 옵션을 한꺼번에 바꾸거나 반복해서 재설치하는 일을 줄일 수 있습니다.
REFERENCE CATALOGUE
JSON은 설정 구조를 이해하는 공통 출발점이지만, 같은 파일을 서로 다른 커널에서 그대로 사용할 수 있다는 뜻은 아닙니다. 클라이언트와 커널, 프로토콜마다 적용 범위가 다르므로 필드 이름이 같더라도 값과 버전별 문서를 확인해야 합니다.
처음 사용할 때는 그래픽 인터페이스에서 구독과 시스템 프록시를 설정하면 됩니다. 도메인별 라우팅, 로컬 리스닝, 이름 조회 방식을 조정해야 한다면 생성된 설정을 필드 설명서와 대조해 보세요. 전체 실행 설정을 일반 구독 링크처럼 가져오거나 클라이언트 백업 파일을 커널 설정 파일로 사용하지 마세요.
JSON 설명서 보기 →라우팅은 커널에 들어온 트래픽을 처리합니다. 먼저 아웃바운드에 명확한 태그를 지정한 다음, 도메인·주소·포트에 따라 규칙이 해당 출구를 선택하도록 설정하세요. 여러 규칙이 겹친다면 범위가 좁은 예외를 앞에 배치해야 합니다. 시스템 프록시는 해당 설정을 따르는 앱에만 영향을 주며 라우팅 규칙을 대신하지 않습니다. 웹사이트가 잘못된 경로로 연결된다면 우선 어떤 규칙이 적용됐는지 확인하고, 기본 아웃바운드와 도메인 조회 정책을 살펴보세요. 서버를 하나씩 바꾸는 대신 규칙별로 트래픽을 분기하면 경로를 일관되게 유지할 수 있지만, 규칙 데이터는 계속 관리해야 합니다.
구독을 가져오면 링크에서 서버 정보를 읽어옵니다. 정기적으로 동기화할 설정을 관리할 때 적합합니다. 먼저 그룹을 만들고 구독 주소를 저장한 다음 업데이트를 실행하세요. 서버 목록에 실제 항목이 추가됐는지 확인한 뒤 사용할 서버를 선택합니다. 업데이트에 실패하면 링크 만료, 응답 형식 오류, 연결 실패를 구분해야 합니다. 같은 주소를 반복해서 가져오지는 마세요. 구독은 보통 서버 정보만 업데이트하며 로컬 설정 전체를 관리하지는 않습니다. 리스닝 포트, 시스템 프록시, 사용자 지정 라우팅은 별도로 확인해야 합니다. 구독 주소에는 접근 권한이 포함되므로 공개하지 마세요.
클라이언트 화면에 표시된 프로토콜 유형이 현재 실행 중인 커널에서 해당 항목의 모든 옵션을 지원한다는 뜻은 아닙니다. 프로토콜, 전송 방식, 보안 계층, 커널 기능을 함께 확인하세요. 특히 특정 보안 메커니즘이 포함된 설정은 주의가 필요합니다. v2rayNG는 주로 Xray 커널을 사용하고, v2flyNG는 V2Fly 커널을 사용합니다. 데스크톱 클라이언트의 실제 동작은 선택한 커널과 설정에 따라 달라집니다. 서버 이름만 보는 것보다 설정의 구조적 필드를 확인하는 편이 가져오기는 성공했지만 연결되지 않는 문제를 찾는 데 효과적입니다. 커널을 바꾸기 전에는 원래 설정을 보관해 네트워크 문제와 호환성 문제를 혼동하지 않도록 하세요.
인바운드는 로컬 리스닝 주소와 포트, 연결을 받는 프로토콜을 정의합니다. 내 기기에서만 사용할 때는 루프백 주소를 유지하는 것이 좋습니다. 로컬 네트워크에서 접근해야 한다면 방화벽과 접근 제어도 함께 설정하세요. 트래픽 식별 기능은 일부 연결에 대상 도메인 정보를 보완해 라우팅 매칭을 도울 수 있지만, 전체 도메인 조회 설정을 대신하지는 않습니다. 시스템 프록시와 달리 인바운드는 커널이 연결을 받는 계층에 해당합니다. 포트가 이미 사용 중이면 클라이언트 창이 열려도 연결 입구가 만들어지지 않을 수 있습니다. 리스닝 포트를 바꾼 뒤에는 해당 포트를 직접 입력한 앱의 설정도 업데이트해야 합니다.
DNS 설정은 커널의 도메인 조회 방식을 결정하지만, 앱이나 시스템은 별도의 조회 경로를 사용할 수 있습니다. 조회에 실패하면 먼저 요청을 보낸 주체를 파악하고, DNS 서버에 연결할 수 있는지와 현재 네트워크에 적합한 조회 정책인지 확인하세요. 라우팅의 도메인 정책은 매칭 과정에서 조회를 시도할지에 영향을 줍니다. 아웃바운드 대상의 조회 방식은 별도로 설정될 수도 있으므로 서버 주소 하나만 바꿨다고 모든 트래픽이 바뀌었다고 단정할 수 없습니다. 주소 대신 도메인을 유지하면 도메인 규칙을 활용하기 쉽지만, 실제 설정과 커널 동작을 확인해 선택해야 합니다.
전송 방식, 보안 계층, 서버 인증은 각각 별도의 설정 항목입니다. TLS를 사용할 때는 서버 이름, 인증서 체인, 시스템 시간을 확인하세요. REALITY를 사용할 때는 서버에서 제공한 정보를 기준으로 해당 매개변수를 입력해야 합니다. TLS 예제를 통째로 가져다 쓰면 안 됩니다. 인증서 오류가 발생하면 구체적인 오류를 기록하고 이름과 시간을 확인하세요. 검증을 건너뛰는 방법을 일반적인 해결책으로 사용하지 마세요. 프로토콜 이름만 바꾸는 것보다 전송 설정을 하나씩 확인하는 편이 설정 불일치를 찾기 쉽습니다. 문제를 해결한 뒤에는 로그를 다시 살펴 실제로 의도한 설정이 사용되는지도 확인하세요.
CLIENTS / PLATFORM DIRECTORY
운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트와 설치 파일 형식을 선택하세요.
데스크톱에서는 v2rayN을 사용하고, 안드로이드에서는 필요한 커널에 따라 v2rayNG 또는 v2flyNG를 선택하세요. 다운로드 센터에서 설치 파일과 선택 기준을 확인할 수 있으며, 이 페이지에는 특정 버전이 나열되지 않습니다. 처음 설치하기 전에 시스템 정보에서 아키텍처를 확인하는 것이 좋습니다. 패키지 형식, 프로세서 종류, 그래픽 인터페이스 종류는 서로 다른 기준입니다. 파일을 다운로드할 수 있다고 해서 현재 기기에서 사용할 수 있는 것은 아닙니다.
v2rayN은 데스크톱 버전과 클래식 WPF 버전, 두 가지 인터페이스를 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 기존 데스크톱 방식을 유지합니다. 사용할 인터페이스와 현재 시스템 환경을 고려해 선택하세요. 두 버전이 서로 다른 프로토콜을 사용하는 것은 아닙니다. 설치한 뒤 그래픽 인터페이스에서 구독을 가져오고 사용할 서버를 선택한 다음 로컬 리스너와 시스템 프록시를 확인하세요.
기존 설정이 있는 기기는 먼저 클라이언트에서 정보를 백업한 뒤 인터페이스를 옮길지 결정하세요. 처음 실행할 때 종속 항목 안내가 표시되면 안내에 따라 실행 환경을 확인합니다. 포트 충돌이 발생하면 로그와 리스닝 설정을 확인하고 바로 재설치하지 마세요. 클라이언트를 종료하기 전에 시스템 프록시를 끄면 앱이 중지된 로컬 입구를 계속 가리키는 문제를 방지할 수 있습니다. 설치 방법은 첫 사용 가이드를 확인하세요.
다운로드 페이지로 이동v2rayN 설치 파일은 Apple Silicon과 Intel용으로 나뉩니다. 먼저 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 해당 다운로드 페이지로 이동하세요. 기기 외관이나 구입 연도만으로 판단하지 마세요. 설치 후 앱이 예상한 폴더에 있는지 확인하고, 처음 열 때는 시스템 안내에 따라 보안 확인을 진행하세요. 실행에 실패했다고 해서 모두 네트워크 연결 문제인 것은 아닙니다.
구독을 가져온 뒤 먼저 사용할 서버가 선택되어 있는지 확인하고 필요한 프록시 방식을 설정하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용되며, 일부 앱은 자체 설정에서 프록시를 지정해야 합니다. 절전 모드에서 깨어난 뒤, 네트워크를 바꾼 뒤 또는 클라이언트를 종료한 뒤 연결 문제가 생기면 프록시 스위치와 로컬 입구 설정이 일치하는지 먼저 확인하세요. 그다음 원격 연결 로그를 살펴보면 여러 계층을 동시에 바꾸지 않고도 원인을 찾을 수 있습니다.
다운로드 페이지로 이동v2rayNG는 Xray 커널을 사용하며 다운로드 센터에서 안드로이드용 우선 클라이언트로 안내합니다. v2flyNG는 V2Fly 커널을 사용하는 대안입니다. 최근 출시된 일반적인 기기에서는 보통 arm64를 선택합니다. 기기 아키텍처를 확인할 수 없다면 범용 패키지 안내와 시스템 정보를 확인하세요. 두 클라이언트는 사용하는 커널이 다르므로 같은 정보를 가져와도 프로토콜과 전송 옵션이 지원되는지 확인해야 합니다.
처음 연결할 때는 시스템 VPN 권한을 확인해야 합니다. 기기에서 다른 VPN 앱이 실행 중이라면 서비스 충돌이 있는지 먼저 살펴보세요. 구독 업데이트에 성공했다는 것은 정보를 가져왔다는 뜻일 뿐, 사용할 서버가 선택됐거나 연결이 수립됐다는 의미는 아닙니다. 연결한 뒤에도 로그와 실제 접속 상태를 확인해야 합니다. 백그라운드에서 연결이 끊긴다면 시스템의 배터리 관리 설정을 확인하세요. 지연 시간 테스트 결과만으로 연결이 계속 유지된다고 판단하지 마세요.
다운로드 페이지로 이동v2rayN은 deb 및 rpm 패키지를 제공하며 프로세서에 따라 x64와 arm64로 나뉩니다. 배포판의 패키지 체계와 기기 아키텍처를 모두 확인해 선택하세요. 어느 한쪽만 확인해서는 안 됩니다. 데스크톱 그래픽 클라이언트에는 사용 가능한 그래픽 환경도 필요합니다. 패키지 관리자가 종속 항목 누락을 알리면 현재 배포판 안내에 따라 환경을 먼저 갖춘 뒤 앱을 실행하세요.
데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다를 수 있고, 브라우저와 다른 앱도 개별 프록시 설정을 사용할 수 있습니다. 설정을 가져온 뒤 대상 앱에서 로컬 입구 주소와 포트를 확인하고 시스템 설정을 차례로 점검하세요. 리스너는 기본적으로 로컬 기기에서만 접근할 수 있도록 설정합니다. 로컬 네트워크에서 접근해야 할 때만 방화벽과 권한을 조정하세요. 설치 성공 여부, 커널 실행 여부, 앱 트래픽이 프록시로 전달되는지는 각각 확인해야 합니다.
다운로드 페이지로 이동PROJECT V / CORE FAMILY
오픈 소스 프로젝트, 실행 커널, 그래픽 클라이언트는 각각 설정의 출처, 연결 처리 방식, 사용자가 조작하는 위치를 설명합니다.
Project V는 프록시와 네트워크 도구를 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 그 안에서 널리 쓰이는 이름입니다. 설정 구조는 인바운드, 아웃바운드, 라우팅, 도메인 조회, 정책을 구분해 설명합니다. 인바운드는 로컬 앱의 연결을 받고, 아웃바운드는 대상에 연결하는 방식을 정의하며, 라우팅은 그 사이에서 경로를 선택합니다. 버튼 위치를 외우는 것보다 이 계층 구조를 이해하면 여러 클라이언트의 설정을 읽기 쉽고, 문제가 로컬 연결을 받는 단계에서 생겼는지 원격 서버에 연결하는 단계에서 생겼는지도 파악할 수 있습니다.
그래픽 클라이언트는 보통 인터페이스 설정을 바탕으로 커널 실행 설정을 생성하므로, 저장 방식을 모른 채 생성된 파일을 직접 편집하는 것은 권장하지 않습니다. 다시 시작하거나 서버를 바꾸거나 설정을 업데이트하면 수정 내용이 덮어써질 수 있습니다. 사용자 지정 규칙을 계속 유지하려면 클라이언트의 규칙 관리 기능이나 사용자 지정 설정 메뉴를 먼저 사용하고, 설정을 어느 계층에서 관리하는지 기록하세요. 설명서를 읽을 때는 예시 조각과 전체 파일을 구분해야 합니다. 필드 하나만으로 전체 연결 절차를 구성할 수는 없습니다.
V2Fly 커뮤니티는 V2Ray 핵심 프로젝트의 개발과 유지 관리를 이어가고 있으며, Xray는 관련 코드 기반에서 발전한 별도의 커널 계열입니다. 두 커널의 설정 구조에는 공통점이 있지만 프로토콜 지원, 필드 세부 사항, 신규 기능이 언제나 일치하는 것은 아닙니다. REALITY 같은 특정 기능은 실제 커널의 지원 여부를 확인해야 합니다. 클라이언트에 이름이 표시된다는 이유만으로 다른 커널에서도 모든 매개변수가 유효하다고 가정하지 마세요.
호환성 문제를 확인할 때는 클라이언트 이름, 실행 커널, 프로토콜, 보안 계층, 전송 방식을 함께 기록하세요. ‘V2Ray 사용’이라는 설명만으로는 문제를 재현하기 어렵습니다. 가져온 뒤 항목이 나타나지 않으면 내용 형식을 확인하고, 커널이 시작되지 않으면 필드와 종속 항목을 살펴보세요. 시작은 됐지만 연결되지 않는다면 서버 매개변수와 네트워크 환경을 확인해야 합니다. 단계별로 점검하면 로그와 조작 내용을 연결하기 쉬워지고 모든 오류를 같은 원인으로 취급하는 일을 막을 수 있습니다.
v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 그래픽 클라이언트입니다. 오픈 소스란 각 프로젝트의 라이선스에 따라 코드가 제공된다는 뜻이며, 사용·수정·재배포 시 해당 조건을 따라야 합니다. 클라이언트 코드, 커널 코드, 패키지에 포함된 구성 요소에는 서로 다른 라이선스가 적용될 수 있으므로 한 프로젝트의 라이선스로 모든 구성 요소를 설명할 수는 없습니다. 오픈 소스라고 해서 어떤 설정이든 사용 환경에 적합한 것은 아닙니다. 네트워크 접근 권한과 서비스 이용 규칙도 별도로 확인해야 합니다.
세 클라이언트는 설정과 연결 작업을 그래픽 인터페이스에서 처리하며 원격 서버 자체를 제공하지는 않습니다. 소프트웨어를 설치한 뒤에도 합법적으로 사용할 수 있는 서버 정보나 구독이 필요합니다. 구독 제공자는 서버 주소와 유효 기간, 접근 권한을 관리하고 클라이언트는 해당 정보를 읽어 사용합니다. 이 사이트는 다운로드와 기술 정보를 정리하며 연결 자격 증명을 제공하지 않습니다. 설정 화면이나 로그를 공유하기 전에는 구독 주소, 사용자 식별 정보와 기타 접근 정보를 삭제하세요.
클라이언트 업데이트는 주로 인터페이스와 설정 생성 방식, 통합 기능에 영향을 줍니다. 커널 업데이트는 연결 처리와 프로토콜 구현을 바꾸고, 구독 업데이트는 서버 항목을 동기화합니다. 세 작업은 서로 다른 작업이며 대신할 수 없습니다. 구독이 만료됐을 때 클라이언트를 업그레이드해도 해결되지 않을 수 있습니다. 커널에서 특정 필드를 지원하지 않는다면 구독을 반복해서 새로고침해도 기능이 추가되지 않습니다. 업데이트 전에 해결할 문제를 먼저 확인하고 알맞은 메뉴를 선택하세요.
환경을 바꾸기 전에 복구할 수 있도록 설정을 백업하고, 기존에 선택한 서버와 라우팅 모드, 리스닝 설정을 기록하세요. 업데이트한 뒤에는 먼저 정상적으로 시작되는지 확인하고, 다음으로 구독을 읽고 실제 접속이 되는지 테스트합니다. 사용자 지정 JSON은 필드 변경과 기본 동작의 변화를 특히 주의해서 살펴보세요. 오류가 발생하면 구체적인 로그를 확인하고 모든 검증을 한꺼번에 끄거나 규칙을 전부 삭제하지 마세요. 다운로드 센터에서는 설치 파일 선택 정보를 제공하며, 사용 절차와 필드 설명은 가이드 및 JSON 설명서에서 확인할 수 있습니다.
추천 순서: 처음 설치할 때는 가이드를 보고, 낯선 용어는 용어집에서 찾으세요. 설정을 바꿀 때는 해당 필드를 설명하는 문서를 확인하면 됩니다. 연결 문제에 여러 계층이 얽혀 있다면 설정을 계속 바꾸기보다 재현에 필요한 최소 단계를 기록하는 편이 원인을 찾기 쉽습니다.
TECHNICAL NOTES / RECENT ENTRIES
프록시 모드, 서버 선택, 로컬 포트부터 설정 문제와 연결 문제를 구분해 보세요.
기술 노트는 실제 작업 상황별로 구성되어 있어 설정 필드를 처음부터 모두 읽을 필요가 없습니다. 오류가 어느 단계에서 발생했는지 먼저 확인한 뒤 관련 문서를 선택하세요. 앱 트래픽이 프록시로 전달되지 않는다면 프록시 모드를, 일부 서버만 다르게 동작한다면 서버 선택 방법을, 커널에서 리스닝할 수 없다는 메시지가 나오면 포트 문제를 살펴보세요. 한 번의 테스트 결과는 당시 환경만 반영합니다. 설정을 바꾼 뒤에는 같은 방법으로 다시 테스트하고 변경 전후의 차이를 기록하세요.
운영체제에 기본 제공되는 명령어로 로컬 리스닝 포트를 점유한 프로세스를 찾는 방법을 안내합니다. 매개변수 설정에서 socks 및 http 포트를 바꾼 뒤 시스템 프록시와 브라우저에서 함께 변경해야 하는 부분도 설명합니다.
기술 노트 읽기 →실제 연결 지연 시간과 TCP 지연 시간 테스트의 차이를 설명하고, 배율 과금, 지역 간 거리, VLESS·VMess·Trojan 프로토콜 특성을 고려한 노드 선택 순서를 정리합니다.
기술 노트 읽기 →시스템 프록시 스위치와 라우팅 모드는 서로 다른 계층의 설정입니다. 전역, 중국 본토 우회, 직접 연결의 트래픽 경로를 비교하고 사용 사례별 조합 방법을 설명합니다.
기술 노트 읽기 →