사용 설명서 · 설치부터 문제 해결까지

V2Ray 사용 설명서

첫 연결만 빠르게 완료하려면 빠른 시작 가이드의 순서대로 진행하세요. 설정이 작동하는 원리를 이해하거나 적용 범위를 조정하고 문제를 해결하려면 이 설명서의 관련 장을 참고하면 됩니다. 처음 설정한다면 순서대로 읽고, 이미 설정을 마쳤다면 확인이 필요한 항목부터 살펴보세요.

핵심 개념: 앱, 클라이언트, 코어

요청이 거치는 경로에 따라 설정 이해하기

화면의 옵션을 살펴보기 전에 요청이 이동하는 경로부터 나눠 보세요. 앱에서 요청이 발생하면 직접 인터넷에 연결하거나 로컬 프록시로 전달할 수 있습니다. 데스크톱에서는 보통 코어가 루프백 주소에서 요청을 수신하고, Android에서는 클라이언트가 시스템 VPN 인터페이스를 통해 트래픽을 받을 수 있습니다. 요청을 받은 코어는 라우팅 설정에 따라 직접 대상에 연결하거나 선택한 프록시 서버에 연결합니다. 앱에 표시되는 것은 최종 결과뿐이므로, 시간 초과 메시지만으로 중간의 어느 단계에서 실패했는지 판단할 수 없습니다.

GUI 클라이언트는 노드를 관리하고 구독을 가져오며, 설정을 생성하거나 불러오고 코어를 실행·종료합니다. 코어는 수신, 라우팅, 전달을 담당합니다. 창이나 트레이 아이콘이 보인다고 코어가 작동 중인 것은 아니며, 노드를 선택했다고 브라우저 트래픽이 코어로 전달되는 것도 아닙니다. 문제를 해결할 때는 코어가 정상적으로 시작됐는지, 앱이 예상한 진입점을 사용하는지, 요청이 코어에 들어온 뒤 예상한 출구에 도달했는지 각각 확인하세요. 연결 상태 표시 하나로 모든 문제를 판단하지 말고, 각 단계마다 별도의 근거를 확인해야 합니다.

프로토콜·전송 방식·보안 계층 구분하기

노드 설정의 프로토콜은 클라이언트와 서버가 프록시 요청을 주고받는 방식을 결정합니다. 전송 방식은 데이터를 전달하는 연결 형태를 정하고, 보안 계층은 양측 설정에 따라 연결 보호와 인증을 처리합니다. 서로 다른 필드이므로 같은 의미로 볼 수 없습니다. 예를 들어 VLESS 노드라도 전송 방식이나 보안 설정은 다를 수 있으므로 프로토콜 이름만 보고 설정을 서로 바꿔 쓸 수 있다고 판단하면 안 됩니다. 다른 클라이언트에서 노드가 표시되더라도 해당 코어가 노드의 모든 매개변수를 지원한다는 뜻은 아닙니다.

노드를 비교할 때는 먼저 서버 주소, 포트, 프로토콜을 확인한 뒤 전송 방식과 보안 계층, 관련 필드를 살펴보세요. 연결은 됐지만 협상에 실패한 경우와 도메인 이름이 아직 해석되지 않았거나 연결 자체가 성립하지 않은 경우는 서로 다른 단계의 문제입니다. 오류를 없애려고 보안 검증을 끄지 마세요. 서버 이름, 인증서, 기기 시간이 맞지 않는다면 해당 설정을 바로잡아야 합니다. 생소한 필드는 용어 간편 안내를 먼저 확인한 뒤, 제공자가 안내한 설정과 비교하세요. 다른 노드에서 매개변수를 가져와 섞어 쓰지 마세요.

구독 업데이트와 실제 연결은 별도로 확인하기

구독은 설정 제공처에서 노드 정보를 가져오는 방법이지 프록시 프로토콜이 아닙니다. 업데이트 성공은 클라이언트가 내용을 가져와 처리했다는 뜻일 뿐, 모든 노드에 연결할 수 있다는 의미는 아닙니다. 반대로 저장된 노드로 연결할 수 있어도 구독 서버에 일시적으로 접속하지 못할 수 있습니다. 두 요청은 서로 다른 주소를 사용하는 경우가 많습니다. 문제를 진단할 때 구독 업데이트가 실패했는지, 특정 앱의 접속 요청이 실패했는지 먼저 구분하세요. 모든 시간 초과 문제를 구독 변경으로 해결하려고 하지 마세요.

도메인 이름은 한 번만 해석되는 것이 아닙니다. 클라이언트가 프록시 서버에 연결하기 전에 서버 도메인을 해석할 수 있고, 앱이 접속하는 웹사이트 도메인은 앱, 운영체제 또는 코어에서 처리할 수 있습니다. 숫자 주소로 연결된다고 모든 도메인에 문제가 없다는 뜻은 아닙니다. 웹 서비스는 올바른 호스트 이름도 필요로 하는 경우가 많습니다. 테스트할 때는 오류가 발생한 대상이 구독 도메인인지, 프록시 서버 도메인인지, 접속하려는 도메인인지 구체적으로 기록하세요. 그래야 어느 단계의 로그를 확인할지 알 수 있습니다.

클라이언트 선택: 운영체제·아키텍처·코어

데스크톱에서는 v2rayN 권장

먼저 클라이언트를 실제로 실행할 운영체제와 프로세서 아키텍처를 확인한 다음 클라이언트 다운로드 페이지에서 패키지를 선택하세요. 가상 머신에서 실행한다면 호스트가 아니라 게스트 운영체제의 정보와 아키텍처를 기준으로 삼아야 합니다. 업무용 기기라면 클라이언트 설치, 시스템 프록시 변경, 가상 네트워크 인터페이스 생성이 허용되는지도 확인하세요. 파일을 다운로드할 수 있다고 설치 권한이 있다는 뜻은 아니며, 이후 TUN을 사용할 수 있다는 의미도 아닙니다.

플랫폼클라이언트선택 기준
Windowsv2rayN다운로드 페이지의 요구 사항에 따라 x64와 실행 환경을 확인한 뒤 데스크톱 버전 또는 WPF 버전을 선택하세요.
macOSv2rayNApple Silicon 또는 Intel 프로세서에 맞는 디스크 이미지 파일을 선택하세요.
Androidv2rayNG 우선, v2flyNG 대안먼저 필요한 코어에 맞는 앱을 선택하고, 시스템에서 지원하는 앱 아키텍처에 따라 arm64 또는 범용 패키지를 선택하세요.
Linuxv2rayN배포판의 패키지 형식과 아키텍처를 모두 확인한 뒤 deb 또는 rpm을 선택하세요.

Windows 데스크톱 버전은 크로스 플랫폼 UI 프레임워크를, WPF 버전은 기존 Windows UI 프레임워크를 사용합니다. 처음 설치한다면 데스크톱 버전부터 시작해 보세요. 기존 WPF 환경을 관리 중이라면 익숙한 조작 방식, 설정 경로, 런타임 조건을 우선 고려하세요. 두 버전의 차이만으로 연결 속도를 판단할 수는 없습니다. 비교하려면 같은 노드와 네트워크, 요청 방식을 사용하고 두 인스턴스가 동시에 로컬 진입점을 사용하지 않는지 확인하세요. UI, 트레이, 패키지 이름의 차이는 데스크톱 버전과 WPF 버전 선택 안내를 참고하세요.

macOS에서는 시스템의 기기 정보에서 칩 또는 프로세서 항목을 확인하세요. Apple 칩이 표시되면 해당 네이티브 패키지를, Intel 프로세서가 표시되면 x64 패키지를 선택합니다. Linux에서는 패키지 관리 체계와 하드웨어 아키텍처를 각각 확인해야 합니다. 예를 들어 Debian 또는 Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 선택합니다. 터미널에 표시되는 x86_64와 aarch64는 다운로드 페이지의 x64와 arm64에 각각 해당합니다. 패키지 형식이 맞더라도 필요한 의존성이 모두 충족되는 것은 아니므로 설치 전에 배포판 지원 범위를 확인하세요.

Android에서는 코어에 맞는 앱을 고른 뒤 아키텍처에 맞는 패키지 선택

Android에서는 기본적으로 Xray 코어를 사용하는 v2rayNG부터 시작하세요. 설정 제공처에서 V2Fly 코어를 명시적으로 요구할 때 v2flyNG를 고려하면 됩니다. 제공받은 것이 일반 노드 정보인지, 구독 내용인지, 특정 코어용 전체 설정 파일인지 먼저 확인하세요. 일반 노드 정보는 보통 앱에서 코어 설정으로 변환하지만, 전체 설정 파일은 특정 코어 전용 필드를 직접 참조할 수 있습니다. 이름이 비슷하다고 호환되는 것은 아니며, 클라이언트만 바꾸면 사용자 지정 매개변수도 그대로 옮겨 쓸 수 있다고 가정하지 마세요.

Android 설치 패키지는 시스템이 지원하는 앱 아키텍처와 일치해야 합니다. 프로세서 설명에 64비트라고 적혀 있는지만 보면 안 됩니다. 시스템에서 arm64 앱을 지원하는 것이 확인되면 해당 패키지를 선택하세요. 확실하지 않다면 기기 정보를 먼저 확인한 뒤 다운로드 페이지의 범용 패키지를 고려할 수 있습니다. 범용 패키지도 별도의 시스템 요구 사항이 있으므로 모든 기기에서 사용할 수 있는 것은 아닙니다. 시스템에서 앱과 기기가 호환되지 않는다고 안내하면 같은 파일을 반복해서 다운로드하지 말고 시스템 버전과 지원되는 앱 아키텍처를 확인하세요.

기기를 교체할 때는 사용 중인 코어, 구독 그룹, 사용자 지정 라우팅 규칙을 먼저 기록하고 앱에서 지원하는 내보내기 방법으로 설정을 백업하세요. 새 기기에서는 그룹 하나만 복원해 노드 하나가 정상인지 확인한 뒤 나머지 설정을 단계적으로 복원하세요. 이전 기기의 로컬 포트, 실행 경로, 시스템 프록시 상태는 해당 환경에 종속되므로 그대로 복사하지 않는 편이 좋습니다. 같은 기기에서 다른 빌드로 바꾸는 경우에는 이전 인스턴스를 종료하고 복원 가능한 설정을 남긴 뒤 새 빌드가 단독으로 실행되는지 확인하세요.

설치와 첫 실행: 코어가 작동하는지 먼저 확인

데스크톱 운영체제에 설치하기

먼저 다운로드 카드와 시스템 안내에 따라 설치를 완료하세요. 전체 설정을 서둘러 가져오지 않아도 됩니다. Windows에서 설치 프로그램을 받았다면 설치 프로그램으로 지정된 디렉터리에 설치하고, 압축 패키지를 받았다면 압축을 완전히 푼 뒤 실행하세요. 압축 파일 미리보기 창에서 바로 실행하지 마세요. 필요한 런타임은 선택한 빌드의 요구 사항과 실제 오류 메시지를 기준으로 확인해야 합니다. 데스크톱 런타임이 없다는 안내가 표시되면 데스크톱 런타임과 일반 런타임을 구분하고 아키텍처도 일치하는지 확인하세요. 프로그램을 반복해서 클릭해도 의존성이 설치되지는 않습니다.

처음 실행할 때는 일반 사용자 권한을 사용하세요. 압축을 풀어 실행하는 빌드라면 현재 사용자가 관리할 수 있고 동기화 서비스가 파일을 반복해서 덮어쓰지 않는 디렉터리를 선택하세요. 창은 열리지만 설정이 저장되지 않는다면 클라이언트 전체를 항상 관리자 권한으로 실행하기보다 설정 디렉터리의 쓰기 권한을 먼저 확인하세요. 업그레이드 후 실행 직후 종료된다면 오류 메시지와 이전 설정을 보존하고 시작 직후 종료 문제 해결을 참고해 런타임, 디렉터리 권한, 설정 파싱 문제를 구분하세요.

macOS에서는 해당 디스크 이미지를 열고 이미지에 포함된 안내에 따라 앱을 배치한 뒤, 실제 설치 위치에서 실행하세요. 마운트된 이미지를 장기 실행 디렉터리로 사용하지 마세요. 시스템에서 아키텍처 불일치, 파일 손상, 기기 정책에 따른 앱 제한을 안내하면 전체 메시지를 기록한 뒤 원인에 맞게 처리하세요. 업무용 기기에서는 승인 절차를 따르세요. 앱 하나를 실행하려고 시스템의 전반적인 보호 기능을 끄지 마세요. 앱을 종료한 뒤에도 프록시 문제가 계속되면 앱을 반복해서 복사하지 말고 시스템 네트워크 설정을 따로 확인하세요.

Linux에서는 배포판의 패키지 관리 도구로 호환되는 소프트웨어 패키지를 설치하는 것을 권장합니다. 패키지 관리 도구에서 의존성과 충돌을 확인할 수 있습니다. 설치가 끝나면 데스크톱 앱 메뉴에서 실행하거나 현재 데스크톱 세션에서 실행 오류를 진단하세요. 명령줄 프로그램이 실행된다고 그래픽 창과 트레이가 정상 표시되는 것은 아닙니다. 트레이 아이콘이 보이지 않는다고 프로세스가 실행되지 않는 것도 아닙니다. 프로그램을 열었는데 창이 나타나지 않으면 여러 인스턴스가 남지 않도록 프로세스, 앱 로그, 데스크톱 세션 상태를 먼저 확인하세요.

Android 앱 설치와 네트워크 권한은 따로 확인하기

Android에서는 다운로드 페이지에서 해당 설치 패키지를 받은 뒤 시스템 설치 화면에서 여세요. 현재 다운로드 경로에 설치 권한이 필요하다면 기기 정책에 따라 실제 사용하는 경로에만 권한을 부여하세요. 업데이트 설치에 실패하면 먼저 시스템 안내를 확인하세요. 아키텍처나 시스템 버전이 요구 사항을 충족하지 않는 경우와 기존 앱 위에 설치할 수 없는 경우는 서로 다른 문제입니다. 기존 앱을 먼저 삭제해야 한다면 구독과 필요한 설정을 복원할 수 있도록 백업하세요. 삭제하면 앱에 저장된 데이터가 함께 지워지는 경우가 많습니다.

설치 후에는 목록이 정상적으로 열리고 설정이 저장되는지 먼저 확인하세요. 첫 연결 때 시스템 VPN 권한 대화상자가 나타나는 것은 시스템이 해당 트래픽을 클라이언트에 전달하도록 요청하는 단계입니다. 구독이 업데이트됐거나 원격 서버에 연결할 수 있다는 뜻은 아닙니다. 기기에서 이미 VPN을 사용 중이라면 전환이 업무 연결에 영향을 주는지 확인하세요. 시스템에서 관리하는 연결은 직접 중단하지 마세요. 연결을 켠 뒤 실제 앱으로 테스트하고, 테스트가 끝나면 정상적으로 연결을 끊을 수 있는지도 확인하세요.

첫 실행의 확인 기준 정하기

먼저 UI를 사용할 수 있는지, 설정이 저장되는지, 프로세스가 정상적으로 종료되는지 확인하세요. 데스크톱에서는 지원되는 설정 하나를 가져온 뒤 코어가 실행되어 예상한 주소와 포트에서 수신하는지 확인하세요. 포트가 사용 중이라는 사실만 확인해서는 부족하므로 시스템의 프로세스 정보로 해당 포트를 사용하는 프로세스도 확인해야 합니다. Android에서는 시스템 권한을 승인한 뒤 연결 상태가 앱 설정과 일치하는지 확인하세요. 이러한 점검을 마치기 전에는 그룹을 한꺼번에 가져오거나 시작 시 자동 실행을 켜고 여러 네트워크 옵션을 바꾸지 마세요. 설치 문제만 있었는데 재현하기 어려운 실행 순서 문제까지 생길 수 있습니다.

구독 가져오기: 그룹·업데이트·검증

먼저 설정의 종류 확인하기

구독 주소는 여러 노드를 가져오는 경로이고, 단일 공유 링크는 노드 하나를 설명합니다. 전체 설정 파일에는 인바운드, 아웃바운드, DNS, 라우팅이 포함될 수 있습니다. 셋 다 텍스트로 전달될 수 있지만 같은 입력란에 넣을 수 있는 것은 아닙니다. 설정 제공처가 안내한 형식과 지원 코어를 확인한 뒤 구독 관리, 클립보드에서 노드 가져오기, 앱의 설정 가져오기 기능 중 적절한 방법을 선택하세요. 브라우저에서 주소가 열린다고 구독 주소라는 뜻은 아닙니다. 계정 페이지일 수도 있습니다.

구독 주소에는 접근 권한 정보가 포함되는 경우가 많으므로 계정 정보처럼 안전하게 보관하세요. 실제 주소를 공개 게시판, 온라인 변환 사이트, 공유 스크린샷에 올리지 마세요. 복사하기 전에 불필요한 공백, 줄바꿈, 설명 문구가 섞이지 않았는지 확인하고 쿼리 매개변수를 임의로 삭제하거나 수정하지 마세요. 문제를 정리할 때는 오류 유형과 발생 시각만 기록하면 됩니다. https://example.com/sub?token=xxxx처럼 주소 구조만 예시로 표시하고, 이를 실제 구독 주소로 사용하지 마세요.

먼저 그룹 하나를 수동으로 업데이트하기

v2rayN에서 구독 그룹 설정을 열고 그룹을 추가하세요. 용도를 구분할 수 있는 별칭을 입력하고 전체 구독 주소를 주소란에 붙여넣은 뒤 저장하고 해당 그룹을 수동 업데이트합니다. 별칭은 UI에서 구분하기 위한 이름일 뿐 접속 서버를 결정하지 않습니다. 업데이트가 끝나면 해당 그룹으로 이동해 가져온 내용이 적절한지 확인하고 지원되는 노드 하나를 선택해 테스트하세요. 두 번째 제공처를 추가할 때는 별도 그룹을 만들어 정상 작동이 확인된 주소를 다른 구독 주소로 잘못 바꾸지 않도록 하세요.

v2rayNG 또는 v2flyNG에서 구독 그룹 관리로 이동해 이름과 주소를 추가한 뒤 저장하고 목록으로 돌아와 업데이트를 실행하세요. 메뉴 이름은 빌드에 따라 다를 수 있습니다. 중요한 순서는 먼저 주소를 저장하고, 내용을 가져온 다음, 사용할 노드를 선택하는 것입니다. 구독 관리와 연결 시작은 별개의 작업입니다. 목록에 노드가 보여도 시스템 VPN이 시작된 것은 아니며, VPN이 연결된 상태라고 방금 업데이트한 내용이 현재 선택한 노드에 적용됐다는 뜻도 아닙니다.

첫 업데이트가 성공한 뒤 자동 업데이트를 설정하세요. 업데이트 간격은 제공처의 갱신 안내와 기기 사용 패턴에 맞추고, 짧을수록 좋다고 생각하지 마세요. 문제를 진단하는 동안에는 해당 그룹의 자동 업데이트를 끄거나 업데이트 시간을 피하세요. 테스트 중 노드 정보가 바뀌는 일을 막을 수 있습니다. 일부 클라이언트는 구독 내용에 따라 그룹을 다시 생성해 수동 수정 내용을 덮어쓸 수 있습니다. 장기간 보관할 테스트 노드는 수동 그룹에 따로 두고 구독 노드와 구분해 기록하세요.

실패 단계에 따라 다른 방식으로 대응하기

로그에 이름 해석 또는 연결 실패가 표시되면 현재 네트워크에서 구독 서버에 접속할 수 있는지, 업데이트 요청 경로를 선택할 수 있도록 앱이 지원하는지 먼저 확인하세요. 아직 검증되지 않은 출구에 업데이트 요청을 고정하지 마세요. 노드가 작동하지 않을 때 업데이트 요청까지 함께 실패할 수 있습니다. 서버가 인증을 요구하거나 접근을 거부하면 주소가 만료됐는지, 계정에 여전히 권한이 있는지 확인하세요. 짧은 간격으로 반복 요청해도 해결되지 않습니다. 서버가 응답했지만 클라이언트가 노드를 하나도 가져오지 못했다면 응답 형식, 해당 프로토콜 지원 여부, 응답 내용이 로그인 페이지인지 확인하세요.

가져온 뒤에는 사용 가능 여부가 확인된 대상을 하나 테스트하고 다른 변수는 그대로 두세요. 노드 테스트 결과는 해당 테스트 방법이 확인한 단계만 보여 주며, 실제 앱의 요청을 대신 검증하지는 않습니다. 특정 노드만 실패하면 같은 그룹의 다른 노드와 비교하세요. 그룹 전체가 실패한다면 코어 실행 여부, 로컬 진입점, 네트워크 변경 여부를 다시 확인하세요. 화면을 보며 순서대로 설정하려면 빠른 시작의 구독 가져오기 단계를 참고하세요. 그룹을 바꿔도 연결되지 않으면 연결 문제 해결을 이어서 확인하세요.

프록시 모드: 로컬 포트와 시스템 프록시

범위를 좁혀 로컬 진입점 확인하기

데스크톱에서 처음 확인할 때는 앱 하나를 지정해 로컬 프록시에 직접 연결하는 방법이 좋습니다. 설정을 열어 실제 수신 주소, 포트, 유형을 확인하세요. HTTP와 SOCKS 프록시 포트가 별도로 제공될 수도 있고 혼합 포트 하나를 사용할 수도 있습니다. 포트 번호만으로 유형을 추측하지 마세요. 현재 기기에서만 사용할 경우 루프백 수신을 유지하는 것이 좋습니다. 로컬 설정 오류를 해결하려고 LAN 접근을 허용하지 마세요. 루프백 주소로 연결되는 트래픽은 원격 노드를 선택했다고 다른 기기에서 자동으로 들어올 수 있는 것이 아닙니다.

아래 예시는 해당 매개변수를 지원하는 curl에서 사용할 수 있습니다. 먼저 v2rayN의 로컬 HTTP 또는 혼합 수신 포트가 예시의 포트와 일치하는지 확인하고, 다르면 설정에 표시된 값으로 바꾸세요. Windows PowerShell에서는 curl.exe를 명시적으로 실행할 수 있습니다. 예시는 공개된 예제 도메인에 요청을 한 번 보내며 시스템 설정을 지속적으로 변경하지 않습니다. 현재 네트워크에서 해당 도메인에 접속할 수 없다면 접근이 허용된 테스트 대상으로 바꾸세요.

curl --noproxy "" --proxy http://127.0.0.1:10809 --max-time 15 -I https://example.com/

여기에 지정한 프록시 매개변수는 현재 명령에서만 유효합니다. 비어 있는 제외 목록은 기존 프록시 제외 설정으로 인해 대상에 직접 연결되는 것을 방지합니다. 로컬 포트 연결이 거부되면 먼저 수신 중인지, 주소 체계가 일치하는지 확인하세요. 예를 들어 IPv4 루프백에서만 수신하는데 다른 주소로 연결하려는 상황일 수 있습니다. 로컬 프록시에서 오류를 반환하면 연결 대상이나 원격 서버의 로그를 확인하세요. 대상 응답이 도착하면 이번 요청이 설정된 로컬 진입점을 통과했다는 뜻입니다. 다만 코어가 직접 연결했는지 프록시를 사용했는지는 라우팅 결과를 별도로 확인해야 합니다.

시스템 프록시의 실제 적용 범위 이해하기

시스템 프록시를 설정하면 시스템 설정을 따르는 앱에 지정된 프록시 진입점을 사용하도록 알리는 것입니다. 운영체제의 모든 패킷을 대신 처리하는 기능은 아닙니다. 브라우저는 보통 시스템 설정을 읽지만 설정 파일, 브라우저 확장 프로그램, 기기 정책에 따라 실제 동작이 달라질 수 있습니다. 터미널 프로그램이 시스템 설정이나 환경 변수를 읽는지는 구현에 따라 다릅니다. 두 명령이 같은 웹사이트에 접속되더라도 같은 프록시를 사용했다고 단정할 수 없습니다. 브라우저와 명령줄의 결과가 다르면 각각의 실제 적용 설정을 확인하세요.

일부 시스템이나 클라이언트는 앱이 지원하는 경우 자동 설정 스크립트를 제공해 요청별로 로컬 프록시를 사용할지 앱이 직접 연결할지 결정할 수 있습니다. 이는 코어 라우팅과는 별도의 판단 단계입니다. 앱이 요청을 코어에 전달하지 않으면 코어의 분기 규칙은 적용되지 않습니다. 문제를 해결할 때는 먼저 위의 명시적 프록시 설정으로 로컬 진입점을 확인한 뒤 시스템 프록시를 원래 방식으로 복구하세요. 명시적 연결은 되지만 시스템 프록시는 작동하지 않는다면 노드를 바꾸기보다 시스템이나 앱 단계부터 확인하세요.

프록시 해제와 프로그램 종료를 각각 확인하기

테스트가 끝나면 클라이언트에서 시스템 프록시를 지우거나 복원한 뒤 필요한 경우 앱을 종료하세요. 원래 업무용 프록시를 사용했다면 모든 프록시를 끄는 방식으로 복구하지 말고 기존 주소, 포트, 자동 설정 방식을 되돌리세요. 관리되는 기기에서는 시스템 정책을 통해서만 값을 변경할 수 있습니다. 프록시를 끈 뒤에는 이전에 시스템 프록시에 의존하던 앱에서 다시 테스트하세요. 이미 설정된 요청 세션을 재사용하지 않도록 필요하면 앱을 재시작하세요.

Android에서는 보통 시스템 VPN과 앱 범위 설정으로 트래픽을 처리하므로 데스크톱의 시스템 프록시 절차를 그대로 적용하면 안 됩니다. Android 앱을 테스트할 때는 해당 앱이 처리 범위에 포함되는지, 클라이언트가 시스템 권한을 받았는지 먼저 확인하세요. 데스크톱에서 터미널 명령만 작동하지 않는다면 브라우저와 터미널을 나눠 확인하는 방법을 참고하세요. 코어 로그에 수신 포트 충돌이 표시되면 충돌 프로세스를 확인해야 합니다. 시작 실패를 감추려고 앱마다 프록시 프로토콜을 바꾸지 마세요.

라우팅 분기: 조건·순서·기본 경로

먼저 실제 결과 세 가지 정하기

라우팅 분기는 코어에 들어온 요청만 처리합니다. 설정을 시작하기 전에 예상 결과 세 가지를 적어 두세요. 직접 연결할 대상, 선택한 프록시를 통해 보낼 대상, 규칙으로 차단할 대상을 정합니다. 명시적인 규칙에 일치하지 않는 요청의 기본 출구도 설정하세요. 기본 출구는 추측에 맡겨서는 안 되는 설정입니다. UI에 별도의 기본 출구 옵션이 없다면 해당 코어의 동작을 확인하고 생성된 설정의 출구 순서와 규칙 참조를 점검하세요.

라우팅 프리셋은 시작점으로 사용할 수 있지만 모드 이름만으로 실제 매칭 조건을 알 수는 없습니다. 프리셋을 적용한 뒤 규칙 목록에서 도메인, 대상 주소, 분류 데이터 중 무엇을 기준으로 판단하는지 확인하고 마지막에 일치하지 않은 요청을 어떻게 처리하는지 기록하세요. 지역별 또는 사이트별 분류 데이터는 업데이트될 수 있고, DNS 결과에 따라 테스트 결과도 달라질 수 있습니다. 정상 작동하는 기준 설정을 유지한 뒤 사용자 지정 규칙을 추가하세요. 분류 데이터, DNS 정책, 기본 출구를 한 번에 바꾸면 결과가 좋아져도 어느 변경이 효과를 냈는지 알기 어렵습니다.

도메인 규칙과 IP 주소 규칙의 적용 범위

도메인 조건은 이름으로 지정된 대상을 구분할 때, IP 주소 범위 조건은 명확한 네트워크 대역을 지정할 때 적합합니다. 도메인 규칙이 적용되는지는 코어가 판단하는 시점에 대상 이름을 알고 있는지에 달려 있습니다. 앱이 직접 DNS를 조회해 숫자 주소만 전달하면 도메인 정보를 사용할 수 없을 수 있습니다. 규칙에서 대상 주소를 요구하지만 코어가 도메인만 알고 있다면 라우팅 DNS 정책도 확인해야 합니다. 두 상황을 모두 분류 데이터베이스 문제로 단정하지 마세요.

Xray 필드 규칙을 예로 들면 규칙을 순서대로 검사하고 먼저 일치한 규칙이 출구를 결정합니다. 따라서 구체적인 예외를 포괄적인 규칙보다 앞에 두는 것이 일반적입니다. 하나의 필드 규칙에 도메인과 주소 조건을 함께 지정했다면 해당 코어의 조건 조합 방식을 확인해야 합니다. “도메인 또는 주소가 일치하면 직접 연결”하려는 경우에는 같은 출구를 가리키는 규칙 두 개로 나누는 편이 명확합니다. 아래 예시는 Xray 설정에 사용할 수 있는 routing 객체이지 전체 설정이나 클라이언트 구독 내용이 아닙니다. 사용하기 전에 direct가 직접 연결 출구로 정의되어 있는지 확인하세요.

{
  "domainStrategy": "AsIs",
  "rules": [
    {
      "type": "field",
      "domain": ["full:example.com"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "ip": ["192.168.50.0/24"],
      "outboundTag": "direct"
    }
  ]
}

첫 번째 규칙은 완전한 이름인 example.com만 일치시키며 하위 도메인은 포함하지 않습니다. 두 번째 규칙은 예시 네트워크 대역에 일치하지만 실제 LAN 범위를 확인하는 작업을 대신하지는 않습니다. AsIs는 이 단계의 주소 규칙을 위해 도메인을 주소로 해석하지 않으므로 도메인 이름으로 들어온 요청이 최종적으로 해당 대역에 연결된다는 이유만으로 두 번째 규칙에 일치할 것이라고 기대하면 안 됩니다. 어느 규칙에도 일치하지 않는 요청은 나머지 규칙이나 코어의 기본 출구를 따릅니다. 평소에는 클라이언트 규칙 편집기에 같은 조건을 입력해 설정하는 편이 좋습니다. UI에서 다시 생성될 파일을 직접 수정하지 마세요.

규칙에 일치하는 경우와 일치하지 않는 경우 모두 확인하기

규칙을 추가할 때마다 최소 두 가지 대상을 테스트하세요. 규칙에 일치해야 하는 정상 사례와 비슷하지만 다음 규칙으로 넘어가야 하는 반례입니다. 완전한 도메인 이름의 예외라면 해당 이름과 하위 도메인을 테스트할 수 있고, 주소 범위 규칙이라면 범위 안의 주소와 인접 범위를 테스트하면 됩니다. 명령이 성공했다고 대상에 접속할 수 있다는 뜻일 뿐, 예상한 출구를 통과했다는 보장은 없습니다. 코어의 라우팅 또는 출구 로그와 함께 확인하세요. 상세 로그가 없다면 진단 로그를 잠시 활성화해 테스트한 뒤 원래 수준으로 되돌리세요.

웹페이지는 리소스 도메인, 로그인 서비스, API 주소에 동시에 요청하는 경우가 많습니다. 기본 페이지는 열리지만 일부 내용이 실패한다면 실패한 요청의 대상을 찾아 필요한 규칙만 추가하세요. 차이를 감추려고 모든 출구를 한꺼번에 바꾸지 마세요. 새 규칙을 적용한 뒤 LAN 리소스, 공유 서비스, 기기 관리 페이지에 문제가 생기면 먼저 원래 규칙으로 복원하고 새 조건의 범위가 너무 넓은지, 앞선 규칙이 이를 가로채는지 확인하세요. 나중에 정리할 때 삭제할 항목을 판단할 수 있도록 각 규칙의 용도와 검증 방법을 기록하세요.

TUN 모드: 적용 범위·권한·DNS

필요한 경우에만 활성화하기

TUN은 시스템 프록시를 사용하지 않는 앱의 트래픽까지 처리해야 할 때 사용합니다. 데스크톱 클라이언트에서 관련 코어 기능을 실행하면 시스템이 가상 네트워크 인터페이스와 라우팅을 통해 조건에 맞는 트래픽을 처리 경로로 보냅니다. 적용 범위가 넓어진다고 모든 요청이 같은 프록시 출구로 전송되거나 모든 인터페이스와 트래픽 종류가 처리되는 것은 아닙니다. 어떤 트래픽을 가져올지는 시스템 라우팅과 클라이언트 설정이 결정하고, 가져온 트래픽을 어떻게 보낼지는 코어 라우팅이 결정합니다.

활성화하기 전에 일반 로컬 프록시 진입점과 노드가 정상인지 확인하고, 기기의 기존 시스템 프록시, 네트워크 인터페이스 상태, 자주 사용하는 LAN 서비스를 기록하세요. 이번에 TUN으로 처리할 앱을 정하고 해당 앱만 대상으로 테스트할 방법을 준비하세요. 원격 세션이나 관리형 VPN에 의존하는 기기에서는 복구 방법을 마련하지 않은 채 트래픽 처리 방식을 바꾸지 마세요. 클라이언트 화면에 문제가 표시되지 않더라도 라우팅 변경으로 해당 세션의 연결이 끊길 수 있습니다.

데스크톱에서 활성화하기: 권한과 충돌 확인

v2rayN에서 Tun 활성화 옵션 또는 관련 설정을 찾아 현재 빌드와 코어가 해당 기능을 지원하는지 확인한 뒤 운영체제 안내에 따라 필요한 권한을 부여하세요. Windows, macOS, Linux는 권한 부여와 인터페이스 생성 방식이 서로 다릅니다. 권한 부족 메시지가 표시되면 보조 구성 요소 실행 실패, 가상 인터페이스 생성 실패, 라우팅 변경 실패 중 어느 문제인지 확인하세요. 기기 정책에서 허용하고 현재 빌드에 실제로 필요한 경우에만 권한을 부여하세요. 인터페이스 권한 문제 하나를 해결하려고 모든 앱을 높은 권한으로 실행하지 마세요.

첫 테스트에서는 원인을 파악할 수 있는 처리 경로 하나만 유지하세요. 시스템 프록시가 설정되어 있다면 기존 값을 기록한 뒤 일시적으로 복원하고, 대상 앱을 사용해 TUN이 실제로 트래픽을 처리하는지 확인할 수 있습니다. 그렇지 않으면 TUN이 작동하지 않아도 앱이 로컬 프록시에 직접 연결해 인터넷에 접속할 수 있습니다. 먼저 가상 인터페이스와 클라이언트 상태를 확인한 뒤 일반 도메인 접속, 대상 앱 접속, 유지해야 하는 로컬 서비스 순으로 테스트하세요. 조건은 한 번에 하나씩 추가하세요. 예를 들어 기본 동작을 확인한 뒤 LAN 예외를 조정합니다.

활성화 직후 모든 접속이 시간 초과되면 먼저 TUN을 끄고 기존 상태로 돌아오는지 확인하세요. 인터페이스가 제대로 생성되지 않았거나 시스템 라우팅이 예상대로 설치되지 않았을 수 있습니다. 또는 코어와 프록시 서버 사이의 연결이 다시 자신이 처리하는 경로로 들어갔을 수도 있습니다. 로그에서 실패 단계와 현재 네트워크에 적합한 자동 인터페이스 선택 또는 출구 제외 설정이 클라이언트에 있는지 확인하세요. 추측으로 시스템 기본 경로를 삭제하지 마세요. 자세한 화면 설정은 v2rayN TUN 모드 설정을 참고하세요.

DNS 문제와 대상 연결 문제 구분하기

숫자 주소에는 연결되지만 일반 도메인 대부분에 접속할 수 없다면 DNS 경로를 우선 살펴보세요. 단, 숫자 주소로 직접 접속할 수 있는 대상을 골라 비교해야 합니다. 웹 주소를 숫자 주소로 바꾸는 것은 인증서와 사이트 선택이 도메인 이름에 의존하므로 신뢰할 만한 테스트 방법이 아닙니다. 코어가 프록시 서버 도메인을 해석할 수 있는지, 일반 앱의 DNS 요청이 예상한 처리 경로에 들어가는지, 결과 주소가 LAN과 외부 대상에 적합한지 확인하세요.

일부 앱은 자체적으로 암호화 DNS를 사용하므로 운영체제의 DNS 결과와 다를 수 있습니다. 업무 네트워크의 내부 도메인은 지정된 DNS 서버로 조회해야 할 수도 있습니다. 도메인 시간 초과가 발생했다고 로컬, 코어, 앱의 DNS 설정을 한꺼번에 바꾸지 마세요. 먼저 실패하는 도메인 종류를 좁힌 뒤 DNS 응답 여부, 반환된 주소가 예상 범위인지, 앱이 이후 어디에 연결했는지 확인하세요. 변경 전에 기존 설정을 보존하고 문제가 생기면 변경 순서의 역순으로 복원하세요.

Android의 VPN 권한은 데스크톱 TUN 메뉴와 같은 기능이 아닙니다. Android에서는 먼저 VPN이 활성화되어 있는지 확인한 뒤 앱 적용 범위, 시스템의 상시 VPN 설정, 기존 연결과의 충돌을 살펴보세요. 테스트가 끝나면 클라이언트에서 처리를 중단하고 대상 앱이 원래 네트워크에서 예상대로 동작하는지 확인하세요. 종료 후에도 문제가 있으면 시스템 네트워크 설정과 클라이언트 로그에서 실제 상태를 확인하세요. 운에 맡겨 스위치를 반복해서 켜고 끄지 마세요.

유지 관리: 업데이트·백업·문제 해결

세 가지 업데이트를 구분하기

클라이언트 업데이트는 UI, 설정 읽기·쓰기 방식, 패키지 구성을 바꿀 수 있습니다. 코어 업데이트는 프로토콜, DNS, 라우팅 동작에 영향을 줍니다. 구독 업데이트는 노드 정보를 바꿉니다. 하나의 설치 패키지가 클라이언트와 코어를 함께 업데이트하는 경우가 아니라면 문제를 진단하는 동안 여러 계층을 한꺼번에 변경하지 마세요. 업데이트 전에 실행 환경, 사용 중인 코어, 현재 유효한 진입점, 테스트 결과를 기록하세요. 업데이트 후 기준 상태를 먼저 다시 확인한 다음 다른 옵션을 사용해야 호환성 문제를 놓치지 않습니다.

백업할 때는 실행 디렉터리 전체를 공개 동기화 위치에 복사하기보다 다시 가져올 수 있는 설정, 라우팅 규칙, 필요한 사용 기록을 우선 보존하세요. 백업에는 구독 인증 정보, 서버 주소, 전체 연결 매개변수가 포함될 수 있으므로 접근이 제한된 위치에 저장해야 합니다. 백업을 마친 뒤 복원 경로와 대상 클라이언트를 기록하세요. 복원을 검증하지 않았다면 최소한 내보낸 내용을 읽을 수 있는지, 필요한 정보가 빠짐없이 들어 있는지 확인하고 일상 연결에 영향을 주지 않는 범위에서 그룹 하나를 복원해 보세요.

클라이언트나 플랫폼을 옮길 때는 재사용할 수 있는 설정과 기기별 상태를 구분하세요. 노드 그룹과 규칙의 목적은 지원되는 형식으로 옮길 수 있지만 작업 디렉터리, 수신 주소, 시스템 프록시 상태, 가상 인터페이스 선택은 새 기기에서 다시 확인해야 합니다. 업그레이드에 실패했다고 새 설정과 이전 설정을 같은 디렉터리에 섞어 반복해서 시도하지 마세요. 프로세스를 종료하고 문제가 발생한 사본을 보존한 뒤, 별도의 쓰기 가능한 위치에 정상 작동이 확인된 설정을 복원하고 최소한의 차이를 비교하세요.

기기 내부부터 대상까지 순서대로 확인하기

먼저 문제가 모든 기기에서 발생하는지 한 기기에서만 발생하는지, 모든 앱인지 특정 앱인지, 모든 대상인지 특정 도메인 종류인지 범위를 확인하세요. 다음으로 클라이언트가 실행 중인지, 코어가 수신 중인지, 앱이 같은 진입점을 가리키는지 확인합니다. 이 조건이 맞는 경우에만 노드 매개변수, DNS, 라우팅을 살펴보세요. 네트워크를 바꾼 뒤 문제가 발생했다면 같은 설정으로 두 네트워크를 비교하세요. 노드를 바꾼 뒤 문제가 생겼다면 같은 대상을 유지해 비교하세요.

Windows에서는 PowerShell로 예시 로컬 포트가 수신 중인지, 어떤 프로세스 번호가 사용 중인지 확인할 수 있습니다. 포트 번호는 설정에 표시된 실제 값으로 바꾸세요. 다른 운영체제라면 로컬 포트 사용 중 문제 해결을 참고해 플랫폼에 맞는 방법으로 조회하세요. 수신 결과가 없다면 코어 시작 로그를 다시 확인하세요. 수신 중이라면 먼저 해당 프로세스를 확인하고 포트 번호만 보고 v2rayN이라고 단정하지 마세요.

Get-NetTCPConnection -State Listen -LocalPort 10809 |
  Select-Object LocalAddress, LocalPort, OwningProcess

이전 클라이언트 인스턴스가 포트를 사용하고 있다면 해당 앱에서 정상적으로 종료하는 방법을 우선 사용하세요. 다른 필수 프로그램이 포트를 사용 중이라면 그 프로그램을 유지하고 클라이언트에 사용 가능한 포트를 지정한 뒤, 이전 포트를 명시적으로 참조하는 브라우저, 터미널, 앱 설정도 모두 수정하세요. 클라이언트의 포트만 바꾸고 끝내지 마세요. 변경 후 새 포트가 수신 중인지 확인하고 처음 실패했던 요청을 다시 실행하세요. 인증이나 협상 오류처럼 포트와 관계없는 문제는 해당 프로토콜 필드를 확인해야 하며 로컬 포트만 반복해서 살펴봐서는 안 됩니다.

진단에 필요한 정보만 기록하기

플랫폼, 클라이언트 이름, 사용 코어, 테스트 시간과 시간대, 문제 전 마지막 변경 사항, 오류가 발생한 단계, 재현에 필요한 최소 절차를 기록하세요. 로그를 공유하기 전에 구독 주소, 인증 정보, 계정 정보, 내부 도메인, 불필요한 전체 접속 경로를 삭제하고 오류 유형과 발생 순서는 남기세요. 재현에 필요한 근거를 한 번 수집할 때만 로그 수준을 잠시 높이고, 완료 후 평소 설정으로 되돌리세요. 문제가 바로 재현되지 않는다면 발생 조건을 관찰하세요. 클라이언트나 시스템 네트워크를 연속해서 재설치하거나 초기화하지 마세요.

고급 설정: 재현 가능한 설정과 변경 복구

작은 검증 매트릭스부터 만들기

안정적으로 작동한 뒤 설정을 확장하세요. 자주 사용하는 상황별로 진입점, 대상, 예상 결과를 정리합니다. 예를 들어 브라우저는 시스템 프록시를 사용하고, 지정한 터미널 명령은 로컬 진입점을 사용하며, LAN 관리 페이지는 정해진 경로로 접속하고, 시스템 프록시를 읽지 않는 앱은 TUN이 활성화된 경우에만 처리 범위에 포함되도록 합니다. 각 테스트에는 단순히 “열림”이라고 적지 말고 예상 결과를 구체적으로 기록하세요. 같은 대상에 접속되더라도 진입점에 따라 실제 출구는 다를 수 있습니다.

테스트를 최소 점검과 시나리오 점검으로 나누세요. 최소 점검에서는 코어 실행, 포트 수신, 대상 하나에 대한 접속, 정상 종료를 확인합니다. 시나리오 점검에서는 구독 업데이트, 라우팅 예외, 대상 네트워크에서의 DNS, 트래픽 처리 방식을 바꾼 뒤 복구 가능한지 확인합니다. 같은 대상 목록을 사용해 변경 전후를 비교하고 네트워크 조건을 기록하세요. 간헐적인 시간 초과를 곧바로 설정 오류로 단정할 필요는 없지만 비슷한 조건에서 다시 테스트해 일시적인 변동인지 반복 재현되는 문제인지 구분해야 합니다.

호환성 문제가 있을 때만 코어 변경하기

코어는 이름이나 UI의 인상이 아니라 설정 요구 사항을 기준으로 선택하세요. 데스크톱 v2rayN에서 사용할 수 있는 코어와 설정 항목은 현재 빌드와 노드 유형에 따라 달라집니다. Android에서 v2rayNG와 v2flyNG 중 선택할 때도 설정 제공처의 코어 요구 사항을 확인하세요. 코어를 바꾸기 전에 기존 설정을 저장하고 복사본으로 테스트해 일상적으로 사용하는 그룹을 덮어쓰지 마세요. 실행한 뒤에는 먼저 DNS 로그를 확인해 필드가 무시되거나 거부되지 않았는지 살펴보고, 명확한 대상 하나에 연결해 검증하세요.

같은 노드 공유 링크를 여러 앱에서 가져올 수 있다고 해서 사용자 지정 라우팅, DNS 정책, 추가 전송 매개변수의 의미까지 같다는 뜻은 아닙니다. 규칙을 옮기기 전에 “업무 도메인은 시스템에서 지정한 DNS 경로로 처리하고, 나머지 대상은 기존 조건에 따라 출구를 선택한다”처럼 의도를 먼저 적은 뒤 새 코어가 지원하는 방식으로 표현하세요. 출구 이름만 바꾸면 의미도 같다고 가정하지 마세요. 특히 어떤 요청이 규칙에 일치하지 않는지, 도메인 해석 시점, 연결 재사용이 테스트에 미치는 영향을 확인해야 합니다.

설정 적용 순서와 복구 절차를 기록하기

GUI 클라이언트가 생성하는 설정은 보통 실행하거나 설정을 저장할 때 다시 만들어집니다. 사용자 지정 설정을 사용하려면 현재 UI에 별도의 가져오기 기능이 있는지, 가져온 설정과 UI 옵션이 어떻게 함께 적용되는지 먼저 확인하세요. 임시 생성 파일만 수정하면 다음 실행에서 같은 상태를 재현하지 못할 수 있습니다. 지속적으로 적용할 설정은 명확한 저장 위치를 선택하고 UI에서 관리하는 값과 가져온 파일에서 제공하는 값을 기록하세요. 인증 정보는 공유 가능한 설정 설명과 분리해 보관하세요.

변경할 때마다 이유, 수정 항목, 예상 결과, 되돌리는 방법을 기록하세요. 라우팅을 바꿀 때는 예외 하나만 추가하고 정상 사례와 반례를 확인하세요. DNS를 바꿀 때는 공개 도메인 하나와 유지해야 하는 내부 도메인 하나를 비교하세요. 트래픽 처리 방식을 바꿀 때는 끈 뒤 복구되는지 먼저 확인하세요. 두 가지 복구 방법을 마련합니다. 하나는 새로 바꾼 항목만 되돌리는 것이고, 다른 하나는 변경 범위를 알 수 없을 때 정상 작동이 확인된 설정 묶음을 복원하는 것입니다. 두 방법 모두 프로세스 재시작, 시스템 프록시 초기화, 이전 앱 적용 범위 복원이 필요한지 설명해야 합니다.

다음에 문제가 발생하면 최근 변경 사항에 따라 관련 장으로 바로 이동할 수 있습니다. 구독 업데이트 뒤 목록에 문제가 생기면 구독 가져오기에서 제공처와 그룹을 확인하세요. 일부 대상만 잘못된 출구를 사용하면 라우팅 분기에서 조건과 순서를 살펴보세요. 트래픽 처리 기능을 추가한 뒤 LAN에 접속할 수 없다면 TUN의 인터페이스, 예외, DNS를 확인하세요. 조작 방법이 기억나지 않으면 빠른 시작 가이드의 최소 연결 절차를 다시 진행한 뒤 고급 설정으로 돌아오세요. 설정을 일상적으로 사용하기에 적합한지는 요청이 어떤 경로를 거치는지 설명할 수 있고 문제 발생 시 검증된 상태로 복구할 수 있는지에 달려 있습니다.