V2Ray 전체 플랫폼 설치 및 설정

사전 준비: 플랫폼, 설정 및 연결 방식

클라이언트, 코어, 서버 설정을 구분하세요

V2Ray는 Project V 생태계의 기술 이름이며, 실제 설치와 일상적인 사용은 주로 GUI 클라이언트를 통해 이뤄집니다. 데스크톱에서는 v2rayN을 우선 고려하고, Android에서는 Xray 코어를 사용하는 v2rayNG를 권장합니다. V2Fly 코어가 필요하다면 v2flyNG를 선택할 수 있습니다. 클라이언트는 설정 저장, 구독 업데이트, 사용자 인터페이스를 담당하며 코어는 프로토콜 처리, 연결 및 라우팅을 담당합니다. 클라이언트를 설치해도 서버가 생기거나 사용할 수 있는 구독이 자동으로 만들어지지는 않습니다. 시작하기 전에 설정 제공자가 전달한 구독 주소, 공유 링크 또는 완전한 설정 파일을 준비하고 사용할 클라이언트와 호환되는지 확인하세요.

설정 호환성은 이름이 비슷한지만 보고 판단할 수 없습니다. VMess, VLESS, Trojan 등 각 프로토콜에 맞는 필드를 사용해야 하며 전송 방식과 TLS 설정도 일치해야 합니다. REALITY 매개변수가 포함된 설정은 대상 코어와 해당 구현이 관련 기능을 지원하는지 확인하세요. 기존 설정의 보안 옵션을 임의로 다른 방식으로 바꾸면 안 됩니다. 클라이언트 목록에 항목이 표시되는 것은 가져오기 프로그램이 일부 내용을 인식했다는 뜻일 뿐, 코어가 모든 매개변수를 받아들였다는 의미는 아닙니다. 구독 형식 설명이 불분명하면 코어를 바꿔 가며 추측하지 말고 제공자에게 출력 형식을 확인하세요.

시스템 아키텍처와 설치 위치 확인

다운로드하기 전에 시스템 설정에서 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. Windows 다운로드에는 데스크톱 버전과 클래식 WPF 버전이 있습니다. macOS는 Apple Silicon과 Intel용으로 나뉘고, Linux는 deb와 rpm 및 프로세서 아키텍처를 확인해야 합니다. Android는 arm64와 범용 패키지로 구분됩니다. 아키텍처가 맞지 않으면 설치 프로그램이 실행을 거부하거나 코어를 시작할 때 오류가 발생할 수 있습니다. 데스크톱 버전은 현재 사용자가 쓸 수 있는 일반 폴더에 설치하세요. 압축 파일 미리보기에서 바로 실행하지 말고, 임시 다운로드 캐시나 동기화 충돌이 잦은 폴더, 읽기 전용 위치에 실행 폴더를 두지 마세요.

네트워크 및 설정 자료 준비

프록시를 실행하지 않은 상태에서도 시스템 네트워크로 필요한 서비스에 정상적으로 접속할 수 있는지 확인하고, 시스템 날짜와 시간대도 올바르게 설정하세요. 구독 주소는 쿼리 매개변수, 대소문자, 마지막 문자까지 포함해 온전히 보관해야 합니다. 주소에 포함된 액세스 토큰은 자격 증명이므로 공개 게시판에 올리지 마세요. 문제를 해결할 때는 클라이언트 이름, 시스템 아키텍처, 선택한 코어, 오류 발생 시간을 기록하되 전체 구독 주소는 기록하지 마세요. 스크린샷을 공유해야 한다면 서버 주소, 사용자 식별 정보, 개인 계정을 가리세요. 기존 클라이언트를 옮기기 전에는 내보내기 기능으로 설정을 저장하고, 백업은 직접 관리할 수 있는 위치에 보관하세요.

시스템 프록시, TUN, VPN의 차이 이해하기

데스크톱 시스템 프록시는 시스템 설정을 따르는 앱에 로컬 프록시 주소를 알려 주며, 일반적으로 브라우저와 데스크톱 프로그램에 적합합니다. TUN은 가상 네트워크 인터페이스를 통해 더 많은 트래픽을 전달하므로 라우팅, DNS 및 추가 권한이 필요할 수 있습니다. Android 클라이언트는 보통 시스템 VPN 인터페이스를 사용해 앱 트래픽을 처리하며, 처음 실행하면 시스템 권한 요청이 표시됩니다. 이러한 방식은 트래픽을 코어로 전달하는 방법을 정하는 것이며 코어가 어떤 출구를 선택할지와는 별개입니다. 처음 설정할 때는 연결 방식 하나만 사용해 검증한 뒤 필요에 따라 다른 옵션을 추가하세요. 여러 프록시 도구가 동시에 네트워크 설정을 바꾸는 상황은 피해야 합니다.

이 가이드의 메뉴 이름은 기능을 찾기 위한 참고용이며 모든 클라이언트에서 문구가 똑같지는 않습니다. 업데이트로 메뉴 위치가 바뀔 수 있으므로 버튼 색상이나 고정된 위치보다 ‘구독 그룹’, ‘시스템 프록시’, ‘라우팅 설정’ 같은 기능 이름을 기준으로 찾으세요. 런타임, 권한, 드라이버 관련 안내는 현재 클라이언트의 릴리스 정보와 시스템 팝업을 확인하세요. 오래된 안내에 관리자 권한으로 실행하라고 적혀 있다고 해서 모든 일상 작업에 높은 권한을 적용하지 마세요. 준비가 끝나면 해당 플랫폼의 섹션을 따라 진행해 다른 운영체제의 절차를 혼용하지 않도록 하세요.

Windows: v2rayN 설치 및 시스템 프록시

데스크톱 버전과 클래식 WPF 버전 선택

Windows 다운로드에서 데스크톱 버전과 클래식 WPF 버전을 먼저 구분하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 Windows 인터페이스를 유지합니다. 메뉴 구성, 설정 위치, 종속성 요구 사항이 서로 다를 수 있습니다. 시스템 호환성과 익숙한 사용 방식을 기준으로 선택하고 두 프로그램을 같은 폴더에 덮어 설치하지 마세요. 다운로드 페이지에는 아키텍처별 항목이 안내되어 있습니다. 기기 아키텍처와 맞지 않는다면 현재 릴리스 정보를 확인하세요. Windows라는 이유만으로 어떤 설치 파일이든 기본 실행된다고 단정할 수 없습니다.

설치 파일을 받은 뒤 파일 형식에 따라 설치하거나 압축 파일 전체를 해제하세요. 압축을 풀어야 하는 패키지는 모든 폴더를 풀고 클라이언트와 함께 제공된 코어 파일의 상대 경로를 유지한 다음 해제한 폴더에서 실행하세요. 처음 실행할 때 런타임이 없다는 메시지가 표시되면 현재 프로그램이 안내하는 이름과 아키텍처에 맞는 구성 요소를 설치하세요. 여러 런타임을 무작정 설치하지 마세요. 시스템이 실행을 차단하면 파일 출처, 시스템 안내의 구체적인 원인, 로컬 보안 기록부터 확인하세요. 보안 기능 전체를 바로 끄지 마세요. 인터페이스는 열리지만 코어가 실행되지 않는다면 코어 파일이 예상한 폴더에 그대로 있는지도 확인해야 합니다.

구독을 가져와 사용할 설정 선택

구독 그룹 설정에서 새 그룹을 만들고 알아보기 쉬운 이름을 지정한 뒤 전체 구독 주소를 붙여 넣고 저장하세요. 그룹 저장과 구독 내용 가져오기는 별개의 단계입니다. 저장한 다음 구독 업데이트를 실행하고 설정 항목이 목록에 표시될 때까지 기다리세요. 단일 공유 링크를 사용한다면 클라이언트의 클립보드 가져오기 기능으로 추가할 수 있으므로 단일 설정 때문에 원격 구독을 만들 필요는 없습니다. 가져온 뒤 프로토콜, 전송 방식, 보안 옵션이 제공자의 안내와 일치하는지 확인하고 설정 하나를 활성 항목으로 지정하세요. 목록에서 항목을 클릭해 강조 표시하는 것만으로 활성 설정이 바뀌는 것은 아닐 수 있으니 클라이언트 상태 안내를 확인하세요.

구독 목록이 비어 있다면 업데이트 안내에 연결 실패, 인증 실패, 파싱 실패 중 무엇이 표시되는지 먼저 확인하세요. 연결 실패는 구독을 내려받을 때 직접 연결했는지 기존 프록시를 사용했는지 살펴보세요. 인증 실패는 주소가 만료되었는지 확인해야 합니다. 파싱 실패라면 응답 내용이 클라이언트가 지원하는 구독 형식인지 확인하세요. 같은 이름의 그룹을 반복해서 추가하지 마세요. 중복 항목만 늘어나 문제를 파악하기 어려워집니다. 이미 사용 가능한 설정이 있다면 되돌아갈 수 있도록 남겨 두고 새 그룹을 따로 점검하세요. 설정을 모두 지운 뒤 사용할 수 있는 연결까지 잃지 않도록 주의하세요.

시스템 프록시를 켠 뒤 필요할 때 TUN 사용

먼저 활성 설정을 시작한 다음 시스템 프록시 자동 설정을 선택하세요. 시스템 프록시 설정에서 주소가 클라이언트가 실제로 수신 대기 중인 로컬 주소를 가리키고 포트도 클라이언트 설정과 일치하는지 확인하세요. HTTP, SOCKS, 혼합 포트는 서로 바꿔 쓸 수 있는 이름이 아닙니다. 앱에 직접 설정할 때는 포트 유형을 맞춰야 합니다. 브라우저에 별도의 프록시 확장 프로그램이 설치되어 있으면 시스템 설정을 따르지 않을 수 있으므로 확인하는 동안 해당 확장 프로그램의 프록시 기능을 꺼 두세요. 시스템 프록시를 따르지 않는 프로그램도 연결해야 한다면 그때 TUN을 검토하세요. 사용하기 전에 시스템 프록시를 해제해 두 경로가 겹치면서 생기는 문제를 줄이세요.

권한, 종료 후 복구 및 이전 처리

TUN은 권한 상승이나 관련 네트워크 구성 요소 설치가 필요할 수 있습니다. 장기간 프로그램 전체를 관리자 권한으로 실행하지 말고 현재 클라이언트 안내에 따라 처리하세요. 활성화 후 사내 네트워크, 프린터, 공유 폴더에 문제가 생기면 먼저 TUN을 끄고 라우팅 범위가 원인인지 확인한 다음 필요한 직접 연결 규칙을 추가하세요. 다른 VPN이나 기업용 네트워크 소프트웨어를 사용 중이라면 하나씩 테스트하세요. 여러 가상 네트워크 어댑터가 자동으로 조정된다고 가정하지 마세요. 절전 모드에서 깬 뒤 문제가 생기면 서비스를 중지했다가 다시 시작하고 가상 인터페이스와 DNS가 정상적으로 복구되는지 확인하세요.

정상적으로 종료하기 전 클라이언트의 시스템 프록시 해제 기능을 사용한 뒤 프로그램을 닫으세요. 클라이언트가 예기치 않게 종료되면 시스템에 로컬 포트를 가리키는 프록시 설정이 남을 수 있습니다. 이때 브라우저는 이미 수신 대기를 중단한 주소에 연결하려고 합니다. 클라이언트를 다시 열어 설정을 해제하거나 시스템 프록시 페이지에서 기존 상태로 복원하세요. 다른 폴더로 옮길 때는 프로그램을 종료하고 설정을 백업한 다음 전체 폴더를 이동하세요. 같은 설정 폴더를 공유하는 인스턴스를 두 개 실행하지 마세요. 데스크톱 인터페이스의 차이는 v2rayN Windows 설치 및 설정 전체 과정을 참고하되, 문제 해결은 현재 로그를 기준으로 진행하세요.

macOS: 칩 선택, 권한 및 네트워크 서비스

칩 유형에 맞는 v2rayN 선택

시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 macOS 다운로드에서 Apple Silicon 또는 Intel용 v2rayN 설치 파일을 선택하세요. 기기를 구매한 연도로 칩을 추측하거나 파일 이름의 아키텍처 표기를 무시하지 마세요. 다운로드가 끝나면 디스크 이미지를 열고 패키지 안내에 따라 앱을 일반적인 응용 프로그램 위치에 복사한 뒤 설치된 앱을 실행하세요. 실행 중인 앱은 다운로드한 디스크 이미지가 계속 마운트되어 있어야만 작동하는 상태로 두지 마세요. 이후 업데이트, 경로 참조, 제거 과정이 혼란스러워질 수 있습니다.

처음 열 때 시스템에서 앱 출처 확인을 요청하거나 실행을 차단할 수 있습니다. 먼저 시스템이 표시한 구체적인 이유를 읽고 출처와 설치 절차를 확인한 다음 시스템에서 허용하는 일회성 열기 절차를 사용하세요. 시스템 보호를 일괄 해제하는 명령을 사용하지 말고 ‘출처 제한’과 ‘앱이 손상됨’ 안내를 같은 문제로 취급하지 마세요. 클라이언트 인터페이스는 정상인데 코어가 종료된다면 아키텍처, 실행 권한, 로그에 표시된 파일 경로를 확인하세요. 앱 아이콘을 반복해서 옮겨도 코어 실행 환경의 불일치는 해결되지 않습니다.

구독 그룹 및 활성 설정 만들기

구독 관리 기능을 열고 별도 그룹을 만든 뒤 구독 주소를 입력해 업데이트하세요. 그룹 이름은 로컬에서 구분하기 위한 것이며 원격 콘텐츠를 결정하는 것은 주소와 매개변수입니다. 공유 링크를 가져올 때는 클립보드에 전체 링크만 있고 메신저의 설명, 따옴표, 줄바꿈이 포함되지 않았는지 확인하세요. 업데이트가 끝나면 활성 설정을 선택하고 코어가 정상적으로 실행되는지 확인한 뒤 시스템 프록시를 설정하세요. 데스크톱에서 가져온 설정에 규칙 파일이나 인증서처럼 다른 시스템의 로컬 경로가 포함되어 있을 수 있습니다. 이런 항목은 다시 지정해야 하며 기존 경로를 그대로 사용할 수 없습니다.

구독 업데이트가 어떤 네트워크 경로를 사용하는지는 클라이언트의 업데이트 옵션과 당시 연결 상태에 따라 달라집니다. 처음 실행해 사용 가능한 설정이 없는데 업데이트에 프록시가 필요하면 업데이트하려면 설정이 있어야 하고 설정을 받으려면 업데이트해야 하는 순환이 생깁니다. 이때는 제공자 안내에 따라 초기 설정을 확보하거나 구독 서버에 현재 네트워크로 직접 접속할 수 있는지 확인하세요. 이미 연결 가능한 설정이 있다면 구독 업데이트를 위해 기존 설정을 모두 삭제하지 마세요. 업데이트 후 활성 항목이 그대로 있는지 확인하세요. 원격 설정 이름이 바뀌면 클라이언트가 대체 항목을 자동으로 선택하지 못할 수 있습니다.

현재 네트워크 서비스의 프록시 상태 확인

macOS 프록시 설정은 네트워크 서비스별로 적용됩니다. 클라이언트에서 시스템 프록시를 켠 뒤 현재 실제로 사용 중인 네트워크 서비스에서 설정을 확인하세요. 예를 들면 연결된 Wi-Fi나 유선 네트워크가 있습니다. 네트워크를 바꾸거나 도킹 스테이션을 연결하거나 서비스 순서를 변경하면 기존 프록시 상태가 현재 연결 경로에 적용되지 않을 수 있습니다. 브라우저가 시스템 프록시를 읽는지는 자체 설정에도 영향을 받습니다. 별도 프록시 확장 프로그램을 쓰는 브라우저는 따로 확인하세요. 먼저 시스템 설정을 따르는 앱 하나로 검증하고 다른 앱을 점검하세요. 메뉴 막대 아이콘만 보고 시스템의 모든 트래픽이 연결되었다고 판단하지 마세요.

시스템 프록시는 정상인데 특정 앱만 직접 연결된다면 해당 앱이 시스템 설정을 무시하거나 자체 네트워크 스택을 사용하는 것일 수 있습니다. 연결 범위를 넓혀야 할 때 TUN을 고려하고 클라이언트 안내에 따라 권한을 설정하세요. 사용 전 기존 네트워크 프록시와 DNS 설정을 기록하고 다른 네트워크 제어 도구를 중지하세요. 기업 관리 기기에서는 정책으로 네트워크 설정 변경이 제한될 수 있습니다. 권한을 반복해서 요청해 정책 제한을 우회하지 마세요. 권한 승인이 끝났다고 코어가 트래픽을 처리하는 것은 아니므로 로그와 실제 앱 요청으로 확인해야 합니다.

절전 모드, 네트워크 전환 및 종료 후 남은 설정 처리

절전 모드에서 깨어난 뒤 연결 문제가 생기면 먼저 시스템 네트워크가 연결되었는지 확인한 다음 클라이언트 서비스를 중지했다가 다시 시작하세요. 네트워크를 바꾼 뒤에만 실패한다면 바로 프로토콜을 바꾸지 말고 현재 서비스의 프록시 설정, DNS, 이전 연결이 남아 있는지 확인하세요. 정상적으로 종료하기 전 시스템 프록시를 해제하세요. 앱이 갑자기 종료된 뒤 브라우저에서 프록시 서버에 연결할 수 없다는 메시지가 계속 표시되면 현재 네트워크 서비스가 로컬 주소를 가리키는지 확인하세요. 설정을 복구할 때 이번 클라이언트가 변경한 항목만 되돌리고 기업 네트워크에 필요한 다른 설정은 삭제하지 마세요.

클라이언트를 업데이트하기 전에 구독 그룹과 사용자 지정 라우팅을 저장하고 선택한 코어를 기록하세요. 앱을 교체한 뒤에는 기존의 간단한 설정으로 먼저 검증한 다음 복잡한 규칙을 복구하세요. 새 프로그램이 이전 폴더를 읽지 못하면 설정 저장 위치와 현재 사용자 권한을 확인하세요. 권한이 잘못 이어질 수 있으므로 캐시 폴더 전체를 바로 복사하지 마세요. 플랫폼 문제를 해결할 때는 앱 실행, 코어 실행, 시스템 연결 단계를 구분해야 합니다. 앱이 열리지 않으면 시스템 안내를, 코어가 종료되면 로그를 확인하세요. 업무 앱만 실패할 때는 프록시 경로를 살펴보세요. 단계별로 점검하면 반복해서 재설치하는 것보다 원인을 명확히 파악하기 쉽습니다.

Linux: 패키지 형식, 데스크톱 프록시 및 TUN 권한

배포판과 아키텍처에 맞는 설치 파일 선택

Linux 다운로드에서 먼저 배포판에 맞춰 deb 또는 rpm을 선택한 뒤 x64인지 arm64인지 확인하세요. deb는 Debian, Ubuntu 및 관련 배포판에서 자주 사용되고 rpm은 Fedora 등에서 사용되지만, 패키지 형식이 같아도 종속성이 모두 같은 것은 아닙니다. 설치 전에 현재 배포판의 패키지 설치 도구가 표시하는 종속성 안내를 확인하고 오류를 무시한 채 실행을 시도하지 마세요. GUI 클라이언트에는 데스크톱 세션이 필요합니다. 명령줄만 사용하는 서버는 이 페이지의 범위가 아니므로 데스크톱 자동 시작 및 시스템 프록시 절차를 그대로 적용할 수 없습니다.

가능하면 시스템의 그래픽 소프트웨어 설치 도구로 설치 파일을 열어 패키지 관리자가 종속성과 파일 등록을 처리하도록 하세요. 설치 도구에서 종속성 누락을 알리면 구성 요소 이름과 시스템 버전을 기록하고 현재 배포 패키지가 시스템에 맞는지 확인하세요. 출처가 불분명한 위치에서 동적 라이브러리를 복사해 시스템 폴더에 넣지 마세요. 종속성 누락과 실행 권한 부족도 혼동하지 마세요. 설치가 끝나면 데스크톱 앱 메뉴에서 v2rayN을 실행해 GUI, 설정 폴더, 로그 기능이 정상인지 확인하세요. 클라이언트와 코어 실행 파일은 패키지에 포함된 구조를 유지해야 합니다. 주 프로그램만 바탕 화면에 복사하면 안 됩니다.

일반 사용자 계정으로 가져오기 및 실행

처음 실행할 때는 평소 사용하는 데스크톱 계정을 사용해 구독 그룹을 추가하고 업데이트하거나 공유 링크 하나를 가져오세요. 설정 폴더에는 현재 사용자가 정상적으로 쓸 수 있어야 합니다. 이전에 높은 권한으로 실행한 적이 있으면 일반 사용자가 수정할 수 없는 파일이 남았을 수 있습니다. 저장에 실패하면 먼저 폴더 권한과 남은 공간을 확인하고 프로그램 전체의 권한을 계속 높이지 마세요. 활성 설정을 선택한 뒤 코어 로그를 확인해 포트 사용 중, 파일 누락, 미지원 필드 문제가 없는지 살펴보세요. 데스크톱 버전의 설정 위치가 Windows와 비슷할 수는 있지만 로컬 경로, 권한, 네트워크 제어 방식은 다른 플랫폼의 절차를 그대로 적용할 수 없습니다.

사용자 지정 규칙, 인증서, 외부 리소스 파일은 안정적이고 읽을 수 있는 위치에 저장한 뒤 클라이언트 설정에서 지정하세요. 이동식 저장 장치의 임시 경로를 사용하거나 다른 컴퓨터에서 내보낸 절대 경로가 그대로 존재한다고 가정하지 마세요. 구독의 원격 서버 매개변수는 보통 시스템에 종속되지 않지만 추가 파일과 로컬 수신 설정은 환경에 따라 달라지므로 이전 후 항목별로 확인해야 합니다. 설정을 가져왔는데 실행되지 않는다면 인터페이스의 ‘시작 실패’ 요약만 보지 말고 로그에서 처음 나타난 구체적인 오류를 찾으세요.

데스크톱 시스템 프록시의 적용 범위 이해

Linux 시스템 프록시는 데스크톱 환경과 앱 구현에 따라 달라지므로 모든 프로그램이 따르는 단일 스위치로 볼 수 없습니다. 클라이언트가 데스크톱 프록시를 설정하면 브라우저는 이를 사용할 수 있지만 일부 앱은 자체 설정이나 환경 변수만 읽습니다. 브라우저, 대상 앱, 클라이언트 로그를 각각 확인하세요. 앱 하나가 작동한다고 모든 트래픽이 연결된 것은 아닙니다. 대상 프로그램에 수동 프록시 설정이 있다면 HTTP 또는 SOCKS 유형을 올바르게 선택하고 클라이언트가 실제로 수신 대기 중인 포트를 입력하세요. 환경 변수와 그래픽 데스크톱 설정은 서로 별개일 수도 있습니다.

수신 유형을 확인하기 전에 같은 주소를 모든 프록시 항목에 복사하는 것은 권장하지 않습니다. HTTP 프록시 포트, SOCKS 포트, 혼합 포트는 동작이 서로 다르며 UDP 지원 여부도 연결 방식과 코어 설정에 따라 달라집니다. 로컬 프록시를 사용할 때는 보통 루프백 주소를 유지하세요. 앱 하나가 프록시를 인식하게 하려고 수신 주소를 모든 인터페이스로 바꾸지 마세요. LAN에서 접속해야 하는 경우는 별도의 설정이며 인증, 방화벽, 접근 범위를 함께 고려해야 합니다. 일반적인 데스크톱 설치에서 기본 단계로 설정하지 마세요.

필요할 때 TUN을 사용하고 권한과 정책 구분하기

TUN 연결에는 가상 네트워크 장치, 라우팅 테이블, DNS가 관련되며 필요한 권한 설정은 배포 패키지와 시스템에 따라 다릅니다. 클라이언트에서 제공하는 기능에 따라 권한을 설정하고 앱 폴더 전체에 광범위한 권한을 부여하지 마세요. 활성화에 실패하면 로그에 장치 생성, 라우팅 작업, 권한 거부 중 무엇이 표시되는지 확인한 다음 시스템 정책 기록을 살펴보세요. 방화벽과 시스템 접근 제어가 네트워크 연결에 영향을 줄 수 있지만 모든 정책을 끄지 말고 구체적인 규칙을 확인해야 합니다. 컨테이너 네트워크, 기업 VPN, 다른 가상 인터페이스가 있다면 먼저 한 가지 연결 방식만 남겨 최소 상태로 테스트하세요.

데스크톱 로그인 시 자동 시작과 시스템 서비스는 서로 다릅니다. GUI 클라이언트는 보통 사용자 세션에 의존합니다. 자동 시작을 설정했다면 로그아웃 후 다시 로그인해 확인하고 장기간 높은 권한으로 실행되는 시스템 서비스로 잘못 등록하지 마세요. 시스템 업그레이드 뒤 TUN만 작동하지 않는다면 클라이언트 호환성보다 권한, 가상 인터페이스, 라우팅 복구를 먼저 확인하세요. 정상 종료 전에는 연결 설정을 해제하고 재시작 후에도 문제가 남으면 시스템에 수동 프록시가 남아 있는지 살펴보세요. 문제 해결 기록에는 데스크톱 환경, 배포판, 아키텍처, 연결 모드를 함께 적어야 앱 문제와 시스템 환경 차이를 구분할 수 있습니다.

Android: 설정 가져오기 및 VPN 모드

v2rayNG를 우선 사용하고 필요에 따라 v2flyNG 선택

Android 다운로드에는 먼저 v2rayNG가 제공되며 Xray 코어를 사용하는 설정에 적합합니다. v2flyNG는 V2Fly 코어가 필요한 경우 선택할 수 있는 대안입니다. 이름이 비슷하다는 이유로 두 앱이 완전히 같다고 보지 말고 설정 프로토콜과 코어 기능을 기준으로 선택하세요. 최신 주요 기기의 대부분은 arm64를 먼저 고려할 수 있습니다. 아키텍처를 확인할 수 없거나 설치 프로그램에서 호환되지 않는다고 안내하면 기기 정보를 확인한 뒤 범용 패키지를 검토하세요. 프로세서가 해당 기능을 지원해도 시스템 실행 환경이 완전히 같다고 볼 수 없으므로 기기 시스템과 설치 파일 요구 사항을 기준으로 판단하세요.

다운로드한 설치 파일은 시스템 파일 관리자로 열고 안내에 따라 현재 출처에서 이번 설치를 허용하세요. 권한을 부여할 대상은 브라우저나 파일 관리자일 수 있으므로 어떤 앱에 권한을 주는지 확인하고 관계없는 프로그램에는 설치 권한을 허용하지 마세요. 설치 후 클라이언트를 열고 설정과 로그 위치를 확인한 다음 구성을 가져오세요. 업데이트 중 서명 충돌이나 덮어쓰기 실패가 표시되면 기존 그룹과 설정을 먼저 백업하고 이전 앱의 출처와 새 패키지가 일치하는지 확인하세요. 앱 내부에만 저장된 설정을 잃을 수 있으므로 백업 전에 바로 제거하지 마세요.

구독, 공유 링크 및 QR 코드 가져오기

구독 관리에서 그룹을 추가하고 전체 주소를 입력해 저장한 다음 업데이트하세요. 주소를 복사할 때 채팅 말풍선의 설명 문구가 함께 들어가지 않도록 주의하세요. 제공자가 공유 링크를 전달했다면 구독 주소 입력란에 붙여 넣지 말고 해당 링크 가져오기 기능을 사용하세요. QR 코드는 설정 하나를 가져올 때 편리하지만 스캔 결과에서 프로토콜과 매개변수를 확인해야 합니다. 붙여 넣은 뒤 항목이 추가되지 않으면 클라이언트 안내와 클립보드 내용을 확인하세요. 가져오기 버튼을 연속으로 눌러 중복 항목을 만들지 마세요. 구독 업데이트가 끝나면 활성 설정을 선택하고 연결을 시작하세요.

v2rayNG와 v2flyNG 사이에서 설정을 옮길 때는 양쪽이 지원하는 표준 공유 형식을 사용하거나 제공자에게 호환되는 구독을 다시 요청하세요. 한 클라이언트의 내부 데이터를 다른 클라이언트의 데이터 폴더에 통째로 덮어쓰지 마세요. 같은 프로토콜 이름이라도 보안 매개변수, 전송 옵션, 코어 확장 기능은 다를 수 있습니다. 특히 특정 코어 기능을 사용하는 설정은 주의가 필요합니다. 가져온 뒤 일부 항목만 표시된다면 누락된 항목의 프로토콜과 형식을 확인하세요. 목록의 항목 수만으로 원격 구독이 완전한지 판단하지 마세요.

VPN 인터페이스 권한을 허용하고 연결 확인

처음 실행하면 Android VPN 연결 요청이 표시되는 경우가 많습니다. 현재 클라이언트가 요청한 것이 맞는지 확인한 뒤 허용하세요. 권한을 허용한다는 것은 앱이 시스템 VPN 인터페이스를 만들 수 있다는 뜻이지 원격 연결이 성공했다는 뜻은 아닙니다. 실행 후 클라이언트에서 코어가 정상적으로 작동하는지 확인한 다음 실제 대상 앱으로 테스트하세요. 상태 표시줄의 VPN 아이콘은 인터페이스가 연결 상태라는 뜻일 뿐 원격 서버, DNS, 라우팅은 여전히 실패할 수 있습니다. 다른 VPN이 연결되어 있다면 먼저 연결을 끊고 테스트하세요. 두 인터페이스 사이에서 시스템이 전환하거나 새 인터페이스 생성을 거부할 수 있습니다.

앱 분할 설정은 어떤 앱의 트래픽을 VPN 인터페이스로 보낼지 정합니다. ‘선택한 앱만 허용’과 ‘선택한 앱 제외’는 서로 반대되는 방식일 수 있습니다. 활성화하기 전에 현재 화면의 설명을 읽고 테스트할 앱을 선택하세요. 앱 트래픽이 인터페이스에 들어간 다음에도 코어 라우팅에 따라 직접 연결하거나 프록시를 사용할 수 있으므로 앱을 선택했다고 모든 요청이 같은 출구를 사용하는 것은 아닙니다. 처음에는 복잡한 앱 필터를 끄고 간단한 설정으로 전체 연결을 확인한 뒤 항목을 하나씩 추가하세요. 제외된 브라우저 하나 때문에 서버가 작동하지 않는다고 오해할 수 있습니다.

백그라운드 제한, 비공개 DNS 및 네트워크 전환 처리

화면이 꺼진 뒤 연결이 끊긴다면 시스템이 클라이언트의 백그라운드 활동, 배터리 사용, 자동 시작을 제한하는지 먼저 확인하세요. 기기마다 설정 위치가 다르므로 특정 제조사 경로를 그대로 따르기보다 앱의 백그라운드 실행 권한을 찾아보세요. 백그라운드 활동을 허용한 다음 다시 연결하고 전면 실행 알림이 계속 표시되는지 살펴보세요. 클라이언트는 실행 중인데 도메인 요청만 실패한다면 시스템 비공개 DNS, 클라이언트 DNS, 네트워크 조건이 충돌하는지 확인하세요. 한 번에 하나만 바꾸고 기존 설정을 기록한 뒤 검증 결과에 따라 유지 여부를 결정하세요.

Wi-Fi와 모바일 네트워크를 전환하면 기존 연결이 끊길 수 있으며 보통 클라이언트가 다시 연결해야 합니다. 잠깐 재연결되는 현상을 설정 오류로 단정하지 마세요. 계속 실패하면 연결을 중지하고 시스템 네트워크가 정상인지 확인한 뒤 서비스를 다시 시작하세요. 같은 설정이 특정 네트워크에서만 실패한다면 해당 네트워크에서 구독 서버와 대상 서버에 접속할 수 있는지 확인하고 구체적인 오류를 제공자에게 전달하세요. 클라이언트를 종료하기 전에 VPN을 직접 중지하세요. 연결을 장시간 유지해야 한다면 항상 연결 및 연결 차단 옵션도 확인하세요. 클라이언트가 멈춘 뒤 시스템 정책 때문에 기기가 인터넷에 연결되지 않을 수 있습니다.

구독 관리: 형식, 업데이트 및 설정 이전

구독 주소, 공유 링크, 전체 설정 구분하기

구독 주소는 클라이언트가 설정 목록을 요청하는 원격 접속 경로이며 콘텐츠는 제공자가 변경할 수 있습니다. 공유 링크는 보통 설정 하나를 설명하며 가져온 뒤 원격 업데이트와 연동되지 않을 수 있습니다. 전체 설정 파일에는 인바운드, 아웃바운드, DNS, 라우팅 등 여러 항목이 포함될 수 있습니다. 세 가지는 겉으로 보이는 텍스트만으로 서로 바꿔 사용할 수 없습니다. 웹페이지 주소를 구독 입력란에 넣으면 클라이언트가 설정 데이터가 아닌 웹페이지 내용을 가져올 수 있습니다. 전체 JSON을 공유 링크로 가져오려고 해도 인식되지 않을 수 있습니다. 먼저 전달받은 자료의 유형을 확인하고 맞는 기능으로 가져오면 대부분의 가져오기 오류를 피할 수 있습니다.

구독의 인코딩 및 컨테이너 형식은 외부 형식일 뿐 실제 호환성은 내부 프로토콜과 필드에 따라 달라집니다. 디코딩에 성공해도 모든 항목이 실행되는 것은 아닙니다. 구독 변환으로 원본에 없는 공개 키, 서비스 이름, 경로를 만들어 낼 수도 없습니다. 변환이 꼭 필요하다면 출처가 명확하고 관리 가능한 방법을 우선 사용하세요. 변환 과정에서 구독 자격 증명이 처리된다는 점도 알아 두어야 합니다. 데이터 처리 방식이 불분명한 도구에 개인 구독 주소를 입력하지 마세요. 설정이 특정 코어 기능에 의존한다면 형식을 변환하기 전에 대상 클라이언트가 지원하는지 확인하세요. 변환으로 호환성을 억지로 맞추려 하지 마세요.

업데이트 과정을 네 단계로 나누기

구독 업데이트는 주소 읽기, 네트워크 요청, 콘텐츠 파싱, 목록 반영의 네 단계로 나눌 수 있습니다. 주소 읽기 실패는 공백, 잘림, 인코딩 오류가 원인인 경우가 많습니다. 네트워크 요청 실패는 DNS, 연결 경로, 인증, 서버 상태와 관련될 수 있습니다. 콘텐츠 파싱 실패는 응답 형식이 예상과 다르다는 뜻입니다. 목록 반영에 문제가 있으면 필터 조건, 중복 규칙, 현재 그룹을 확인하세요. 로그에 전체 실패만 표시되면 그보다 앞선 구체적인 안내부터 찾으세요. 오류가 발생할 때마다 코어를 바꾸기보다 단계별로 확인하는 것이 효과적입니다. 구독 요청이 현재 사용하는 프로토콜 연결을 거치지 않을 수도 있기 때문입니다.

업데이트 전에 클라이언트가 선택한 다운로드 경로를 확인하세요. 직접 연결, 현재 프록시 사용 등 어떤 옵션을 쓸 수 있는지는 인터페이스를 기준으로 판단해야 합니다. 현재 설정이 작동하지 않는데 구독 업데이트도 해당 설정에 의존하면 문제가 서로 겹칠 수 있습니다. 사용 가능하다고 확인된 설정 하나는 되돌아갈 수 있도록 남겨 두고 필요하면 먼저 업데이트 경로를 복구하세요. 인증 실패가 발생하면 계속 새로 고치지 말고 구독이 재설정되었는지, 계정 상태가 바뀌었는지, 주소 매개변수가 온전한지 확인하세요. 요청은 성공했는데 목록이 비어 있다면 원격에 사용할 수 있는 항목이 없을 수도 있습니다. 안내를 확인하고 새 그룹을 반복해서 만들지 마세요.

그룹, 활성 항목 및 로컬 변경 사항 관리

출처가 다른 설정은 그룹을 따로 만들고 용도나 출처를 알아볼 수 있도록 이름을 지정하세요. 모든 항목을 기본 목록에 몰아넣지 마세요. 구독을 업데이트하면 원격에서 관리하는 항목이 교체될 수 있으며 로컬에서 바꾼 이름과 일부 매개변수가 유지되지 않을 수 있습니다. 사용자 지정 설정을 계속 보관해야 한다면 클라이언트의 복사 또는 별도 설정 기능을 사용하세요. 이렇게 만든 설정은 원래 구독에 따라 자동으로 업데이트되지 않는다는 점을 기억하세요. 원격 설정 이름이 바뀌거나 삭제되면 기존 활성 항목이 작동하지 않을 수 있습니다. 업데이트 후 선택한 항목이 여전히 존재하는지 확인하고 코어 상태를 다시 검증하세요.

이전할 때 데이터 복구 후 시스템 연결 설정

새 기기로 옮길 때는 이전 기기의 데이터를 백업한 다음 새 기기에 최소한의 설정부터 만드세요. 구독 또는 공유 항목을 먼저 복원하고 코어가 실행되는지 확인한 뒤 라우팅, 앱 필터, 자동 시작을 복구하세요. 시스템 프록시 포트, 네트워크 인터페이스 이름, 로컬 파일 경로, 권한은 기기 환경에 종속되므로 그대로 복사하면 안 됩니다. 비슷한 환경에서는 전체 클라이언트 백업을 복원에 활용할 수 있지만 코어 선택과 연결 설정은 다시 확인해야 합니다. 동기화 도구로 두 기기가 같은 활성 데이터베이스를 동시에 수정하지 않도록 하세요. 덮어쓰기나 잠금 문제가 생길 수 있습니다.

구독 주소, 내보낸 파일, 연결 매개변수가 포함된 스크린샷은 모두 자격 증명처럼 취급해야 합니다. 공개적으로 도움을 요청할 때는 오류 유형, 프로토콜 이름, 필요한 필드 구조만 남기고 사용자 식별 정보, 서버 정보, 액세스 토큰은 삭제하세요. 주소가 이미 공개되었다면 게시물을 삭제하는 것만으로 자격 증명이 무효화되지는 않습니다. 제공자가 지원하는 관리 기능으로 주소를 재설정한 다음 각 기기에 저장된 주소도 업데이트하세요. 형식 관련 문제는 FAQ를 참고하세요. 구독과 설정 필드의 차이를 확인하려면 용어집과 함께 살펴보세요. 업데이트 실패와 연결 실패를 혼동하지 않도록 주의하세요.

프록시 및 트래픽 분기: 연결, 라우팅, DNS

트래픽 흐름에 따라 설정 이해하기

전체 흐름은 앱의 요청 발생, 로컬 진입점으로 트래픽 전달, 코어의 규칙 확인, 아웃바운드 선택, 대상 연결 순서로 볼 수 있습니다. 시스템 프록시와 TUN은 앞부분에서 트래픽을 연결하는 방식을 정하고 라우팅 규칙은 뒷부분에서 직접 연결, 프록시, 차단 중 무엇을 선택할지 결정합니다. 클라이언트에 ‘전역’이라고 표시되어 있다면 시스템 프록시의 적용 범위를 말하는지, 연결된 트래픽을 모두 프록시 아웃바운드로 보내는지 먼저 확인하세요. 인터페이스마다 같은 용어를 다르게 사용할 수 있습니다. 로컬 진입점으로 들어오지 않은 요청은 코어 라우팅 모드를 바꿔도 자동으로 처리되지 않습니다. 일부 프로그램이 계속 직접 연결되는 이유가 여기에 있습니다.

일반적인 브라우저 사용에는 시스템 프록시부터 적용하고 더 많은 프로그램이나 프로토콜을 처리해야 할 때만 TUN을 켜세요. 시스템 프록시를 사용하는 앱이 로컬 주소를 우회한다면 앱 자체 예외 목록이 원인일 수 있습니다. TUN에서 직접 연결된다면 코어 규칙이나 제외된 네트워크 대역 때문일 수 있습니다. 문제를 해결할 때는 요청이 코어에 들어왔는지 먼저 확인하고 어떤 규칙이 적용되었는지 살펴보세요. 문제가 흐름의 어느 단계에서 발생했는지 모르는 상태에서 TUN 활성화, DNS 수정, 전역 모드 전환, 서버 변경을 동시에 하지 마세요. 연결이 복구되어도 어떤 변경이 효과가 있었는지 알 수 없습니다.

라우팅 규칙의 우선순위부터 정하기

대부분의 규칙은 순서대로 적용되며 먼저 일치한 규칙이 최종 아웃바운드에 영향을 줍니다. LAN, 특정 서비스 도메인, 기본 아웃바운드의 위치를 각각 명확히 정하세요. 범위가 지나치게 넓은 규칙을 앞에 두면 뒤의 세부 규칙이 적용되지 않을 수 있습니다. 반대로 기본 동작이 없으면 일치하지 않은 요청이 예상하지 못한 아웃바운드로 갈 수 있습니다. 다음 예시는 Xray 형식의 라우팅 일부로, 사설 주소 직접 연결과 특정 도메인 접미사 일치만 보여 줍니다. 완전한 연결 설정이 아니며 기존 아웃바운드에 해당 태그가 정의되어 있어야 합니다. 이 조각을 전체 서버 설정으로 가져오지 마세요.

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "proxy"
      }
    ]
  }
}

예시의 domain:example.com은 해당 도메인과 하위 도메인을 일치시키는 표현이며 실제 서비스 연결을 확인하는 주소가 아닙니다. direct와 proxy는 아웃바운드 태그이므로 실제 설정의 태그와 일치해야 합니다. 사설 주소 분류에는 코어가 관련 규칙 데이터를 읽을 수 있어야 합니다. GUI 클라이언트가 태그와 규칙을 자동으로 생성할 수 있으므로 라우팅 편집기를 사용할 때는 현재 필드 규칙을 따르세요. 서로 다른 코어의 문법을 섞어 붙여 넣지 마세요. 변경 전 기존 규칙을 저장하고 변경 후 설정이 시작되는지 확인한 다음 규칙이 실제로 적용되는지 테스트하세요.

DNS 해석과 도메인 일치의 상호 영향

DNS는 도메인을 주소로 변환하지만 요청이 앱, 로컬 시스템, 코어를 지나는 동안 도메인 정보가 계속 유지되는 것은 아닙니다. 앱이 먼저 도메인을 조회한 뒤 IP만 전달하면 코어가 원래 도메인을 기준으로 바로 규칙을 적용하지 못할 수 있습니다. 도메인 정보를 복원할 수 있는지는 연결 방식과 관련 기능에 따라 달라집니다. DNS 서버를 선택할 때는 해당 서버에 어떤 경로로 접속할 수 있는지도 고려하세요. 현재 연결 경로로 접근할 수 없는 주소를 유일한 DNS 서버로 설정하지 마세요. 알려진 연결은 성립하는데 도메인 접속만 안 된다면 프로토콜이 호환되지 않는다고 단정하지 말고 DNS 경로부터 확인하세요.

FakeDNS는 가상 주소 매핑으로 도메인 관계를 보존하며 트래픽 연결 및 도메인 복원 기능과 함께 작동해야 합니다. DNS 주소만 바꾸면 단독으로 작동하는 기능이 아니며 활성화하면 LAN 서비스, 앱 캐시, 네트워크 전환에 영향을 줄 수 있습니다. 설정을 빠짐없이 갖추려는 이유만으로 처음부터 켜는 것은 권장하지 않습니다. 도메인 기반 트래픽 분기가 꼭 필요하다면 일반 DNS 상태를 먼저 기록하고 클라이언트가 지원하는 방식으로 설정한 뒤 테스트하세요. 문제가 생겼을 때 완전히 되돌릴 수 있어야 합니다. 원리와 적용 범위는 FakeDNS 작동 원리 자세히 보기를 참고하세요.

최소한의 변수로 트래픽 분기 검증

한 번에 대상 앱 하나와 연결 방식 하나만 검증하세요. 요청이 코어에 들어온 것을 확인한 다음 아웃바운드와 DNS를 점검하세요. LAN 접속에 문제가 있다면 먼저 사설 네트워크 대역과 이름 해석을 확인하고 원격 서비스 문제는 프로토콜과 서버 연결을 점검하세요. 규칙 데이터를 업데이트해야 한다면 규칙 리소스 업데이트와 구독 업데이트를 구분하세요. 서로 다른 기능이며 같은 버튼이 아닙니다. Xray와 V2Fly는 지원하는 설정 기능이 완전히 같지 않으므로 코어를 바꾼 뒤 사용자 지정 규칙을 다시 확인하세요. 생태계 및 기능 차이는 Xray와 V2Fly 코어 차이를 참고하세요. 이름을 바꿔 호환성을 맞추려 하지 마세요.

설정 관련 자주 묻는 문제: 장애 단계별 확인

설치 실패와 코어 실행 실패를 구분해 해결

설치 프로그램이 실행되지 않으면 시스템 아키텍처, 패키지 형식, 설치 프로그램 안내를 확인하세요. GUI는 열리지만 서비스가 시작되지 않는다면 코어 로그를 살펴보세요. 포트 사용 중, 파일 경로 없음, 권한 부족, 알 수 없는 필드 등은 코어 종료의 원인이 될 수 있지만 해결 방법은 서로 다릅니다. 로그에서는 마지막 실패 요약보다 처음 표시된 구체적인 오류가 더 중요할 때가 많습니다. 포트 사용 중 오류가 발생하면 이전 인스턴스나 다른 프로그램이 같은 포트를 사용 중인지 확인한 뒤 충돌 프로그램을 종료하거나 수신 포트를 바꾸세요. 변경 후에는 새 연결 실패를 방지하기 위해 앱과 시스템 프록시 설정도 함께 맞춰야 합니다.

알 수 없는 프로토콜이나 필드 오류가 표시되면 설정에 필요한 코어부터 확인하고 오류 필드를 임의로 삭제하지 마세요. 보안 필드를 지우면 파싱은 통과해도 연결 동작이 제공자의 요구와 달라질 수 있습니다. 파일이 없다는 오류는 설치 폴더, 리소스 경로, 보안 기록을 확인하세요. 권한 오류는 해당 파일이나 네트워크 작업의 권한을 살펴보고 프로그램 전체의 권한을 일괄적으로 높이지 마세요. 전체 설정 파일은 불필요한 쉼표, 따옴표 짝, 필드 유형 등 JSON 문법도 확인해야 합니다. 오류 유형에 대한 자세한 내용은 v2rayN 코어 시작 실패 로그 진단을 참고하세요.

연결됨으로 표시되지만 웹페이지가 열리지 않음

‘연결됨’은 코어나 시스템 연결 인터페이스가 시작되었다는 뜻일 뿐 모든 대상 요청이 성공했다는 의미는 아닐 수 있습니다. 먼저 실제 앱의 트래픽이 로컬 진입점에 들어오는지 확인하세요. 데스크톱에서는 시스템 프록시와 브라우저의 별도 프록시 설정을, Android에서는 VPN이 계속 실행 중인지와 앱이 제외되었는지 확인하세요. 다음으로 수신 포트를 확인하고 DNS와 라우팅을 점검한 뒤 원격 연결을 살펴보세요. 로그에 대상 요청이 전혀 없다면 연결 단계부터 해결해야 합니다. 로그에 요청은 표시되지만 시간 초과가 발생한다면 아웃바운드, 네트워크, 서버를 확인하세요. 앞 단계를 건너뛰고 모든 문제를 원격 서버 장애로 돌리지 마세요.

일부 웹사이트만 실패한다면 도메인 규칙, DNS 응답, 대상 서비스 자체, 사용 중인 전송 방식과 관련된 문제일 수 있습니다. 클라이언트 전체가 작동하지 않는다고 단정할 수 없습니다. 같은 앱으로 여러 대상을 비교하고 다른 앱으로 같은 대상을 비교하면 앱 설정 문제와 대상 경로 문제를 구분하는 데 도움이 됩니다. 테스트 중에는 여러 설정을 연속으로 바꾸지 말고 연결 결과나 오류가 나타날 때까지 기다리세요. 시스템 프록시, DNS, 라우팅의 자세한 점검 순서는 연결되었지만 인터넷이 안 될 때 점검 목록을 참고하세요. 결과를 기록한 뒤 계속 수정해 임시 설정이 서로 덮어쓰이지 않도록 하세요.

구독 실패, 핸드셰이크 실패 및 시간 문제

구독 업데이트에 실패하면 요청 경로와 응답 유형부터 확인하세요. 원격 연결의 핸드셰이크가 실패하면 서버 주소, 포트, 사용자 식별 정보, 전송 경로, 보안 매개변수를 확인하세요. TLS 오류는 시스템 날짜와 시간대, 서버 이름 필드도 점검해야 합니다. 검증을 끄는 방식으로 문제를 숨기지 마세요. 설정에서 요구하는 서비스 이름, 호스트 이름, 서버 주소는 서로 다를 수 있으므로 제공자 자료를 기준으로 각각 입력하세요. 비슷해 보이는 값을 경험만으로 바꾸지 마세요. 공유 링크의 인코딩 매개변수를 수정하면 문법이 깨질 수 있습니다. 원본 전체 링크를 다시 가져온 다음 로컬 설정과 비교하는 방법을 우선 사용하세요.

같은 설정이 다른 기기에서 정상 작동한다는 사실은 해당 테스트 조건에서 원격 연결을 사용할 수 있다는 뜻일 뿐, 현재 기기 클라이언트에 결함이 있다는 증거는 아닙니다. 두 기기의 코어, 시스템 시간, 연결 방식, DNS, 네트워크 환경, 앱 필터를 비교해 조건을 최대한 맞추세요. 특정 네트워크에서만 실패한다면 구독 서버에 접속할 수 있는지와 구체적인 오류, 발생 단계를 기록하세요. 설정 폴더가 손상되었거나 설치 파일에 문제가 있다고 확인된 경우에만 재설치를 고려하세요. 네트워크 경로와 코어 오류를 살펴보는 대신 재설치하면 같은 문제를 다시 가져오게 될 수 있습니다.

업데이트 되돌리기, 네트워크 복구 및 효과적인 문제 문의

업데이트 전에 설정을 내보내고 현재 코어, 연결 모드, 사용자 지정 라우팅을 기록하세요. 업데이트 후에는 간단한 설정으로 먼저 확인한 뒤 추가 기능을 복구하세요. 이전 버전으로 되돌려야 한다면 백업을 보관하고 이전 프로그램이 새 설정 형식을 읽을 수 있는지 확인하세요. 서로 다른 프로그램이 같은 폴더에 번갈아 기록하게 하지 마세요. 클라이언트를 중지한 뒤에도 시스템 전체에서 인터넷이 되지 않으면 데스크톱 시스템 프록시가 남아 있는지 확인한 다음 TUN, VPN, 수동 DNS가 해제되었는지 살펴보세요. Android에서는 VPN을 사용할 수 없을 때 연결을 차단하는 시스템 정책이 활성화되었는지도 확인하세요. 복구할 때 이번 클라이언트와 관련된 항목만 변경하세요.

문제 해결을 요청할 때는 플랫폼, 아키텍처, 클라이언트 이름, 선택한 코어, 장애 발생 단계, 마지막 변경 사항, 민감 정보를 삭제한 오류 내용을 포함하세요. 한 앱에서만 실패하는지, 네트워크 전환 후 발생했는지, 클라이언트를 중지하면 복구되는지도 설명하면 ‘연결이 안 돼요’라는 한마디보다 원인을 찾기 쉽습니다. 전체 구독 주소, 연결 QR 코드, 정리하지 않은 설정 파일을 공개하지 마세요. 수정한 뒤에는 같은 테스트 조건으로 다시 검증하고 더는 필요 없는 임시 설정을 해제하세요. 최소 연결 절차를 다시 진행하려면 빠른 시작 가이드로 돌아가세요. 특정 개념이나 일반적인 증상을 확인하려면 FAQ를 참고해 설치, 검증, 문제 해결을 마무리하세요.