V2Ray 전체 플랫폼
설치 및 설정 가이드

준비 사항 및 설정 범위

클라이언트, 코어, 서버 설정 구분하기

v2rayN은 구독을 관리하고 설정을 생성해 코어를 실행하는 데스크톱 GUI 클라이언트이며, v2rayNG와 v2flyNG는 Android용입니다. 실제 연결과 프로토콜 처리, 라우팅은 코어가 담당합니다. Project V는 관련 오픈소스 생태계의 출발점이며, V2Fly와 Xray는 서로 다른 코어 개발 계열입니다. 클라이언트를 설치했다고 바로 연결할 수 있는 것은 아닙니다. 사용 권한이 있는 구독 주소나 개별 공유 링크를 별도로 준비해야 합니다.

데스크톱에서는 v2rayN을 우선 선택하세요. Android에서는 보통 v2rayNG로 시작하고, V2Fly 설정과의 호환성이 필요할 때 v2flyNG를 고려하면 됩니다. 이름이나 기능 수로 판단하기보다 현재 코어가 설정에 필요한 프로토콜, 전송 방식, 보안 옵션을 지원하는지 확인하세요. 예를 들어 REALITY 설정에는 해당 기능 지원이 필요하며, 코어 이름만 바꾼다고 호환되는 것은 아닙니다. 자세한 차이는 Xray와 V2Fly 코어 선택 비교에서 확인하세요.

다운로드 전 시스템 및 네트워크 환경 확인

클라이언트 다운로드에서 운영체제를 선택한 뒤 프로세서 아키텍처와 패키지 종류를 고르세요. 시스템 아키텍처와 앱 아키텍처는 각각 확인해야 합니다. 호환 계층에서 특정 프로그램이 실행된다고 해서 현재 기기에 가장 적합한 패키지라는 뜻은 아닙니다. 데스크톱은 시스템 정보에서 프로세서를 확인하고, Android는 기기 사양을 살펴보세요. 아키텍처를 확인하기 어렵다면 다운로드 페이지의 범용 패키지를 선택하세요. 기기 외관이나 구매 연도로 아키텍처를 짐작하지 마세요.

시작하기 전에 현재 프록시, VPN, 가상 네트워크 어댑터, 보안 소프트웨어 상태를 기록하세요. 네트워크를 동시에 제어하는 도구를 여러 개 켜면 이후 트래픽 경로를 파악하기 어려워집니다. 다른 프록시 클라이언트를 먼저 종료하고 기존 네트워크 환경을 유지한 상태에서 일반 인터넷 연결이 되는지 확인하세요. 시스템 시간은 자동 동기화하도록 설정하세요. 암호화 연결에는 정확한 시간이 필요하며, 시계가 어긋나면 인증서 검증에 실패할 수 있습니다. 이런 오류를 검증 기능을 끄는 방식으로 숨겨서는 안 됩니다.

구독 정리 및 백업

구독 주소는 설정을 가져오는 경로이고, 공유 링크는 개별 설정 하나를 나타내므로 서로 다른 입력란에 넣어야 합니다. 구독은 보통 HTTPS 주소이며 인코딩된 설정 모음을 반환할 수 있습니다. 공유 링크에는 프로토콜 접두사가 붙습니다. 클라이언트에는 각각 다른 가져오기 메뉴가 있는 경우가 많습니다. 주소를 복사할 때 쿼리 매개변수를 보존하고 앞뒤 공백이나 줄바꿈이 없는지 확인하세요. 브라우저 로그인 페이지 주소를 구독 주소로 사용하지 마세요. 형식에 관한 자세한 내용은 구독 링크와 공유 형식 안내를 참고하세요.

라우팅, DNS, 코어를 크게 변경하기 전에는 클라이언트의 내보내기 또는 백업 기능으로 현재 상태를 저장하세요. 설정에는 구독 매개변수, 사용자 식별 정보, 서버 주소가 포함될 수 있으므로 개인이 관리하는 안전한 위치에 보관해야 합니다. 지원을 요청할 때는 오류 유형, 발생 시간, 필요한 설정 구조만 남기고 식별 정보는 가리세요. 전체 구독 주소를 공개 게시물에 올리거나 자격 증명이 포함된 설정을 온라인 변환 사이트에 복사하지 마세요.

되돌릴 수 있는 검증 순서 만들기

처음 설정할 때는 설치, 가져오기, 설정 선택, 코어 실행, 트래픽 진입 기능 활성화, 접속 확인 순으로 진행하세요. 한 번에 한 종류의 설정만 바꾸고 결과를 확인한 뒤 다음 항목을 조정합니다. 먼저 시스템 프록시로 기본 연결을 확인하고 TUN이 필요한지 결정하세요. 기본 라우팅으로 통신을 확인한 다음 사용자 지정 분할 설정을 추가하세요. 각 변경의 출발점이 명확하면 문제가 생겼을 때 여러 매개변수를 동시에 추측하지 않고 직전의 정상 상태로 돌아갈 수 있습니다.

아래의 로컬 포트 번호는 설정 관계를 설명하기 위한 예시일 뿐, 클라이언트의 고정 기본값이 아닙니다. 현재 설정 화면에서 실제 수신 포트를 확인한 뒤 앱에 입력하세요. 구독 내용이 모든 로컬 설정을 자동으로 결정하지는 않습니다. 시스템 프록시 스위치, 권한, 라우팅, DNS를 각각 확인해야 합니다. 사용 전 네트워크 및 기기 관리 정책을 확인하고, 사용이 허용된 환경에서 설정하세요.

Windows: v2rayN 설치 및 구독

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

Windows 다운로드에서 v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 기존 Windows 인터페이스를 이어갑니다. 두 버전의 차이는 UI와 앱 구성 방식이며 서비스 프로토콜 차이가 아닙니다. 처음 설치한다면 하나만 선택하면 됩니다. 이전 버전에서 옮길 경우 기존 설정을 백업한 다음 새 인터페이스의 가져오기 메뉴, 수신 포트, 프록시 모드를 확인하세요. 두 프로그램이 동시에 시스템 프록시를 제어하도록 설정하는 것은 권장하지 않습니다.

설치 프로그램의 안내에 따라 쓰기 가능한 위치를 선택하세요. 압축을 풀어 사용하는 경우 디렉터리 전체를 유지하고 실행 파일만 바탕 화면으로 옮기지 마세요. 클라이언트는 관련 파일과 설정 디렉터리에 접근해야 합니다. 코어가 없거나 보안 소프트웨어가 파일을 격리하면 화면은 열리지만 연결을 시작하지 못할 수 있습니다. 실행 환경 관련 안내가 표시되면 먼저 오류에서 요구하는 구성 요소를 확인한 뒤 시스템과 아키텍처에 맞게 처리하세요. 맞지 않는 구성 요소를 반복해서 설치하지 마세요.

구독 그룹을 만들고 업데이트하기

v2rayN의 구독 그룹 설정을 열어 새 그룹을 만들고, 알아보기 쉬운 메모를 입력한 뒤 전체 구독 링크를 주소란에 붙여넣으세요. 그룹을 활성화하고 저장한 다음 구독을 업데이트합니다. 처음이라 사용할 수 있는 프록시가 없다면 먼저 ‘프록시를 사용하지 않고’ 업데이트하세요. 사용할 수 있는 설정이 있고 현재 네트워크에서 구독 제공처에 직접 접속할 수 없는 경우에만 ‘프록시를 사용하여’ 업데이트를 시도하세요. 업데이트가 끝나면 그룹에 설정이 표시되는지 확인하고 빈 그룹에 머물러 있지 않은지 살펴보세요.

자동 업데이트 간격은 구독을 다시 가져오는 주기만 조절하며, 연결 유지나 서비스 유효 기간에는 영향을 주지 않습니다. 너무 자주 업데이트하면 제공처의 요청 제한에 걸릴 수 있습니다. 필터 조건은 표시되는 항목을 바꾸므로 처음에는 비워 두고 전체 내용이 정상적으로 표시되는지 확인한 뒤 설정하세요. 업데이트 성공으로 표시되는데 목록이 비어 있다면 현재 그룹과 필터 조건을 먼저 확인하고, 제공처가 구독 내용 대신 로그인이 필요한 웹페이지를 반환하는 것은 아닌지 살펴보세요.

설정 선택 및 시스템 프록시

목록에서 사용할 설정을 선택해 활성 항목으로 지정하고 코어가 정상적으로 실행되는지 확인하세요. 그런 다음 시스템 프록시 메뉴에서 시스템 프록시 설정을 선택합니다. 프록시 포트는 클라이언트의 로컬 수신 포트와 일치해야 합니다. 다른 도구가 시스템 프록시를 변경한 적이 있다면 기존 설정을 먼저 지운 뒤 v2rayN에서 다시 설정하세요. 브라우저는 대체로 시스템 프록시를 사용하지만 게임, 명령줄 도구, 일부 데스크톱 앱은 따르지 않을 수 있습니다. 브라우저에서 연결된다고 모든 프로그램의 트래픽이 제어되는 것은 아닙니다.

라우팅 모드와 시스템 프록시는 서로 다른 단계입니다. 시스템 프록시는 앱이 요청을 클라이언트로 보낼지 결정하고, 라우팅은 클라이언트가 받은 요청을 직접 연결할지 프록시로 보낼지 정합니다. 처음에는 LAN을 우회하는 라우팅을 선택해 로컬 기기 요청이 원격으로 전달되지 않도록 하세요. 이후 사용 목적에 맞춰 조정하면 됩니다. 특정 앱만 테스트하려면 수동 프록시를 지원하는 앱에 로컬 주소와 실제 포트를 입력하면 됩니다. 바로 전체 트래픽을 제어할 필요는 없습니다.

권한, 절전 모드, 종료 후 복구

일반 시스템 프록시는 보통 관리자 권한으로 실행할 필요가 없습니다. TUN은 가상 네트워크 어댑터와 라우팅을 변경하므로 현재 클라이언트가 안내하는 필요한 권한만 제공하세요. 활성화 후 LAN 기기 접속에 문제가 생기면 방화벽을 끄는 대신 LAN 우회 규칙과 라우팅 테이블을 먼저 확인하세요. 보안 소프트웨어가 코어 실행을 차단한다면 차단 기록과 파일 위치를 확인하고 원인을 파악한 뒤 관련 허용 설정만 추가하세요. 전체 디스크를 무조건 허용하지 마세요.

절전 모드에서 복귀하거나 유선 네트워크에서 무선 네트워크로 전환하면 기존 네트워크 인터페이스, 게이트웨이, DNS 환경이 달라질 수 있습니다. 먼저 TUN을 끈 뒤 다시 활성화하세요. 그래도 문제가 계속되면 클라이언트를 종료하고 다시 실행합니다. 프로그램이 비정상 종료된 뒤 브라우저에서 인터넷이 되지 않는다면 Windows 프록시 설정에 수동 프록시가 남아 있는지 확인하고, 연결할 수 없는 로컬 주소를 삭제한 다음 기본 네트워크를 테스트하세요. 네트워크가 복구된 뒤 클라이언트를 시작해야 남은 프록시 설정을 서비스 오류로 오인하지 않습니다.

마지막으로 두 가지를 확인하세요. 프록시가 필요한 대상에 접속해 프록시 출구 경로가 작동하는지 확인하고, LAN 기기나 직접 연결해야 하는 대상에도 접속해 분할 라우팅이 로컬 통신을 방해하지 않는지 살펴보세요. 같은 시간대의 로그를 확인해 코어 실행, 도메인 조회, 연결 오류를 구분합니다. 속도 측정은 참고 자료일 뿐 실제 앱 접속을 대신할 수 없습니다. 브라우저는 정상인데 특정 프로그램만 문제가 있다면 해당 프로그램의 프록시 지원 여부를 먼저 확인한 뒤 이 페이지의 TUN 항목을 살펴보세요.

macOS: 칩 선택 및 네트워크 권한

칩 종류와 설치 위치 확인

시스템의 ‘이 Mac에 관하여’에서 칩 종류를 확인한 다음 macOS 다운로드에서 v2rayN을 선택하세요. Apple Silicon은 해당 아키텍처 패키지를, Intel은 해당 x64 패키지를 사용합니다. 호환성 기능으로 다른 아키텍처의 프로그램을 실행할 수 있더라도 코어 실행과 권한 처리에서 변수를 줄이려면 기기에 맞는 네이티브 패키지를 우선 사용하세요. 아키텍처가 맞지 않아 생긴 실행 문제를 구독이나 네트워크 오류로 오해하지 마세요.

디스크 이미지를 연 뒤 앱을 응용 프로그램 폴더에 넣고 고정된 위치에서 실행하세요. 마운트한 설치 이미지에서 계속 실행하거나 패키지 내부 파일만 따로 꺼내지 마세요. 경로를 고정하면 권한 기록과 업데이트 관리가 일관되게 유지됩니다. 시스템 보안 안내가 표시되면 먼저 다운로드 출처와 파일을 확인한 뒤 시스템에서 제공하는 보안 설정 절차를 따르세요. 모든 검사를 우회하려고 기기 전체의 보안 기능을 끄지 마세요.

구독을 가져와 기본 연결 설정하기

v2rayN을 열고 구독 그룹 설정에서 메모와 전체 주소를 입력한 뒤 그룹을 활성화하고 저장하세요. 업데이트가 끝나면 설정 하나를 활성 항목으로 선택합니다. 데스크톱 플랫폼별 설정 원리는 같지만 메뉴 위치와 단축 동작은 다를 수 있습니다. 다른 운영체제의 마우스 경로를 그대로 따라 하지 말고 기능 이름으로 메뉴를 찾으세요. 업데이트가 실패하면 제공처에 직접 접속할 수 있는지 확인한 뒤 이미 사용 가능한 프록시를 통해 업데이트할지 결정하세요. 아직 연결을 설정하지 않은 상태에서 프록시에 의존하지 마세요.

처음 실행할 때는 코어가 정상적으로 작동하는지 확인한 뒤 시스템 프록시를 활성화하세요. 로그에 실행 불가, 권한 부족, 파일 누락이 표시되면 먼저 로컬 실행 문제를 해결해야 합니다. 코어가 로컬 포트에서 수신 중이어야 시스템 프록시가 요청을 전달할 수 있습니다. 실행되지 않은 포트를 프록시 대상으로 설정하면 앱이 계속 대기하거나 즉시 실패할 수 있어 원격 연결 문제로 오해하기 쉽습니다.

네트워크 서비스별 프록시 설정 이해하기

macOS의 프록시 설정은 네트워크 서비스별로 관리됩니다. Wi-Fi, 유선 네트워크, 기타 서비스가 각자 설정을 저장할 수 있으므로 네트워크를 바꾼 뒤 프록시 상태를 다시 확인해야 합니다. 시스템 네트워크 설정에서 현재 사용 중인 서비스를 확인하고 HTTP, HTTPS 또는 SOCKS 프록시의 로컬 주소와 포트를 점검하세요. 클라이언트가 설정 완료를 표시하는데 브라우저에서 프록시를 사용하지 않는다면 연결되지 않은 서비스가 아니라 현재 활성 네트워크 서비스를 확인하고 있는지 살펴보세요.

일부 앱은 자체 네트워크 스택이나 별도의 프록시 설정을 사용하므로 시스템 프록시를 따르지 않을 수 있습니다. 이런 앱에서는 수동 프록시를 지원하는지 확인하고 클라이언트가 현재 수신 중인 프로토콜에 맞춰 설정하세요. SOCKS 포트를 HTTP 전용 입력란에 넣으면 안 됩니다. 시스템 프록시는 설정을 따르는 앱에만 적용됩니다. 다른 트래픽까지 제어해야 한다면 모든 프로그램을 시스템 프록시 모드 전환으로 해결하려 하지 말고 TUN을 검토하세요.

TUN 권한 및 다른 네트워크 도구

TUN을 활성화하려면 권한을 높이거나 클라이언트가 요구하는 보조 구성 요소를 설치해야 할 수 있습니다. 정확한 절차는 현재 빌드에 따라 다릅니다. 안내를 읽고 필요한 권한을 허용한 다음 가상 인터페이스가 생성되는지 확인하세요. 다른 운영체제의 드라이버 설치 방법을 따라 하거나 권한 문제를 해결하려고 앱 패키지 내부 권한을 임의로 변경하지 마세요. 권한을 허용했는데도 시작되지 않는다면 첫 오류 메시지를 확인해 보조 구성 요소, 포트 점유, 가상 인터페이스 생성 문제를 구분하세요.

업무용 기기에는 네트워크 필터, 기업 VPN, 기기 관리 정책이 이미 적용되어 있을 수 있습니다. TUN과 함께 사용하면 라우팅과 DNS의 처리 주체가 복잡해집니다. 관리되는 기기라면 관리자 지침을 먼저 따르세요. 개인 기기에서 문제를 확인할 때는 다른 네트워크 제어 도구를 잠시 끄고 한 가지 설정만으로 테스트할 수 있습니다. 여러 VPN의 우선순위를 동시에 변경하면 문제가 해결되더라도 어떤 변경이 효과가 있었는지 알기 어렵습니다.

절전 모드에서 깨어난 뒤 먼저 현재 네트워크 서비스가 정상적인 주소를 받았는지 확인하고 프록시 상태를 점검하세요. 네트워크 전환 후에만 실패한다면 트래픽 제어 기능을 끄고 기본 네트워크에서 접속을 테스트한 뒤 다시 켜세요. 프로그램을 종료한 뒤에도 연결할 수 없다면 활성 서비스에 로컬 프록시 설정이 남아 있는지 확인하세요. 새 기기로 옮길 때 구독과 라우팅을 가져올 수는 있지만 로컬 포트, 시스템 권한, 칩 호환성을 다시 확인해야 합니다. 다른 기기의 네트워크 서비스 상태를 그대로 재사용할 수는 없습니다.

Linux: 패키지 종류, 데스크톱 프록시, 권한

배포판과 아키텍처에 맞게 v2rayN 설치하기

Linux 다운로드에서 v2rayN을 받고 배포판에 맞는 deb 또는 rpm 패키지를 선택한 뒤 x64 또는 arm64인지 확인하세요. 패키지 종류는 시스템의 패키지 관리 방식에 따라 결정되고 프로세서 아키텍처는 기기에 따라 결정되므로 두 조건이 모두 맞아야 합니다. 데스크톱 인터페이스의 정상 표시 여부는 그래픽 환경과 시스템 종속성에도 영향을 받습니다. 패키지 확장자가 맞다고 모든 실행 조건이 충족된 것은 아닙니다.

가능하면 그래픽 소프트웨어 설치 프로그램으로 다운로드한 파일을 열고 종속성과 설치 결과를 확인한 다음 앱 메뉴에서 실행하세요. 설치에 실패하면 종속성 누락, 아키텍처 불일치, 파일 읽기 불가 중 어떤 문제인지 먼저 확인하고 종속성을 강제로 건너뛰지 마세요. 시스템 저장소 설정이 완료되지 않았다면 패키지 관리자를 먼저 정상화해야 합니다. 이전 패키지를 제거하거나 새 패키지를 설치하기 전에 클라이언트 설정을 저장하세요. 일반적인 설치 오류를 해결하려고 시스템 네트워크 설정을 수동으로 모두 지우지 마세요.

구독을 가져오고 쓰기 가능한 디렉터리 확인

일반 사용자로 클라이언트를 실행하고 구독 그룹 설정에서 주소를 추가한 다음 업데이트하고 활성 설정을 선택하세요. 클라이언트 설정 디렉터리는 현재 사용자가 읽고 쓸 수 있어야 합니다. 과거에 GUI 프로그램을 높은 권한으로 실행했다면 파일 소유자가 달라져 설정이 저장되지 않거나 실행할 때마다 이전 내용으로 돌아갈 수 있습니다. 이 경우 전체 홈 디렉터리나 시스템 디렉터리 권한을 재귀적으로 바꾸지 말고 문제가 있는 디렉터리와 소유자를 확인하세요.

코어가 실행되지 않을 때는 화면 메시지보다 로그에 더 자세한 정보가 나오는 경우가 많습니다. 먼저 코어 파일이 존재하고 실행 가능한지 확인한 뒤 보안 정책의 제한 여부, 수신 포트 점유 여부를 살펴보세요. 소프트웨어 설치 성공과 코어 실행 성공은 별개의 단계입니다. 연결에 실패했다고 바로 서버 주소를 바꾸지 마세요. 로컬 코어 자체가 실행되지 않는다면 원격 설정을 바꿔도 로컬 실행 권한 문제는 해결되지 않습니다.

데스크톱 설정과 앱 설정은 별개의 단계

Linux에는 모든 데스크톱 환경에서 동일하게 적용되는 공통 시스템 프록시 인터페이스가 없습니다. 데스크톱 네트워크 설정을 브라우저가 읽더라도 터미널, 컨테이너, 백그라운드 서비스는 따르지 않을 수 있습니다. v2rayN에서 시스템 프록시를 켠 뒤 실제 사용하는 앱에서 확인하세요. 수동 설정을 지원하는 프로그램에는 루프백 주소와 클라이언트의 실제 포트를 입력하고 HTTP와 SOCKS 중 사용할 프로토콜을 지정하세요. 모든 프로그램이 데스크톱 설정을 자동으로 공유한다고 가정하면 안 됩니다.

터미널의 프록시 환경 변수는 일반적으로 현재 프로세스와 하위 프로세스에만 적용됩니다. 데스크톱 설정을 대체하거나 이미 실행 중인 프로그램에 자동 적용되지는 않습니다. 아래는 임시 변수 사용 예시입니다. 포트를 클라이언트의 실제 HTTP 프록시 포트로 바꾼 뒤 같은 터미널에서 해당 변수를 지원하는 도구를 실행하세요. 테스트가 끝나면 변수를 삭제하세요. SOCKS를 사용할 때는 도구가 도메인 조회를 프록시 쪽에 맡길 수 있는지도 확인해야 합니다.

export http_proxy="http://127.0.0.1:10809"
export https_proxy="http://127.0.0.1:10809"
export no_proxy="localhost,127.0.0.1,::1"

# 테스트가 끝나면 현재 터미널의 임시 설정을 삭제합니다
unset http_proxy https_proxy no_proxy

TUN, DNS 서비스, 컨테이너 경계

TUN은 가상 네트워크 인터페이스를 만들고 라우팅을 변경하므로 관련 네트워크 관리 권한이 필요할 수 있습니다. 현재 클라이언트의 권한 부여 절차를 따르세요. GUI 클라이언트를 항상 최고 권한으로 실행하는 것을 기본 해결책으로 삼지 마세요. 활성화한 뒤 기본 네트워크를 확인하고 프록시를 사용할 대상에 접속해 보세요. 프로세스는 실행되는데 가상 인터페이스가 만들어지지 않는다면 권한을 조사하세요. 인터페이스는 있는데 모든 접속이 실패한다면 앱을 반복해서 재설치하지 말고 라우팅과 DNS를 확인하세요.

배포판마다 DNS를 관리하는 구성 요소가 다르므로 해석 설정 파일을 직접 고치면 네트워크 서비스가 바로 덮어쓸 수 있습니다. 클라이언트나 현재 네트워크 관리 도구를 통해 설정하고 기존 상태를 기록하세요. 컨테이너, 가상 머신, 독립 네트워크 네임스페이스는 호스트의 프록시와 라우팅을 그대로 물려받지 않을 수 있습니다. 호스트 브라우저가 연결된다고 컨테이너도 프록시를 사용하는 것은 아닙니다. 이런 환경을 설정할 때는 게이트웨이, DNS 리졸버, 호스트 수신 주소까지의 연결 가능성을 먼저 확인하세요.

업그레이드 전에 작동하는 설정을 보관하고 클라이언트를 종료하세요. 업그레이드 후에는 코어 경로, 수신 포트, 권한 안내를 다시 확인합니다. 데스크톱 로그인 후 자동 실행만 실패하고 수동 실행은 정상이라면 네트워크가 준비되기 전에 실행되는지, 대화형 세션과 실행 환경이 다른지 확인하세요. 설치, 설정 저장, 코어 실행, 앱 연결, 대상 접속을 단계별로 검증하면 Linux 환경 차이를 구체적인 문제로 나누어 불필요한 시스템 설정 변경을 줄일 수 있습니다.

Android: v2rayNG 및 v2flyNG 설정

코어와 설치 패키지 선택

Android 다운로드에서 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 서비스를 설정하는 데 필요한 사항을 확인한 뒤 선택하세요. 일반적인 arm64 기기는 해당 패키지를 사용할 수 있으며 아키텍처를 모른다면 범용 패키지를 고르세요. OS 버전만으로 프로세서 아키텍처를 판단하지 마세요. 프로토콜 호환성을 확인하려고 두 클라이언트를 번갈아 설치하는 것보다 설정 항목을 먼저 비교하는 편이 효과적입니다.

시스템 설치 프로그램으로 설치하세요. 설치 출처를 허용하라는 안내가 나오면 현재 사용하는 파일 관리자나 브라우저에만 필요한 권한을 부여하고, 설치 후에는 필요에 따라 권한을 회수할 수 있습니다. 패키지가 호환되지 않는다는 메시지가 표시되면 아키텍처, 시스템 요구 사항, 기존 앱을 확인하세요. 서명 충돌이 표시되면 기존 앱 설정을 먼저 백업한 뒤 설치 출처를 바꿔야 하는지 판단합니다. 구독과 규칙이 삭제될 수 있으므로 업데이트 실패 때마다 앱을 바로 제거하지 마세요.

구독 관리 및 개별 링크 가져오기

v2rayNG에서 구독 그룹 메뉴를 열고 새 그룹을 추가한 뒤 메모와 전체 구독 주소를 입력해 저장하고 업데이트하세요. 개별 공유 링크를 받았다면 클립보드에서 가져오기나 관련 정보를 스캔하는 메뉴를 사용하세요. 공유 문자열을 구독 주소 입력란에 넣으면 안 됩니다. v2flyNG의 메뉴 위치는 다를 수 있지만 설정 모음을 가져오는 것과 개별 설정 하나를 가져오는 방법은 구분해야 합니다. 메뉴 이름이 바뀌었다면 기능을 기준으로 찾으세요.

업데이트 후 사용할 설정을 선택하고 연결 버튼을 누르세요. 목록이 비어 있다면 그룹 활성화 여부, 주소가 완전한지, 필터 조건을 확인하세요. Android 브라우저는 공유 페이지 제목만 복사하거나 주소 일부를 생략할 수 있으므로 전체 문자열을 살펴보는 것이 좋습니다. 구독에는 사용자 관련 매개변수가 포함될 수 있으니 개인 기기에만 보관하세요. 기기를 바꿀 때는 안전하게 관리되는 백업 방법을 사용하고 전체 주소를 공개 메시지나 스크린샷으로 전달하지 마세요.

시스템 VPN 권한 및 앱 범위

처음 연결할 때는 시스템 VPN 권한 안내가 표시되는 경우가 많습니다. 클라이언트가 시스템 인터페이스를 사용해 트래픽을 제어하는 데 필요한 권한입니다. 허용한 뒤 연결 상태와 로그를 확인하세요. Android의 이 방식은 데스크톱의 ‘시스템 프록시 설정’과 같지 않습니다. 선택한 앱의 트래픽을 클라이언트로 보내고, 이후 라우팅에서 직접 연결 또는 프록시 경로를 정할 수 있습니다. 상태 표시줄에 연결 아이콘이 나타나도 인터페이스가 생성되었다는 뜻일 뿐, 모든 원격 설정에 접속할 수 있다는 보장은 아닙니다.

앱별 프록시와 라우팅 분할도 서로 다른 기능입니다. 앱 목록은 어떤 앱이 트래픽 제어 범위에 들어오는지 정하고, 라우팅 규칙은 범위에 들어온 요청이 어떤 출구를 사용할지 결정합니다. 선택한 앱만 프록시를 쓰는 모드에서는 대상 앱을 목록에서 빠뜨리면 프록시를 거치지 않습니다. 선택한 앱을 우회하는 모드에서는 체크한 앱의 의미가 반대입니다. 변경하기 전에 현재 모드의 설명을 읽고 대상 앱 하나로 테스트하세요. 목록이 길 때 선택 결과를 잘못 판단하지 않도록 주의해야 합니다.

백그라운드 제한, 네트워크 전환, 충돌

일부 시스템은 백그라운드 실행을 제한하므로 화면을 잠근 뒤 연결이 끊긴다면 절전 정책이 원인일 수 있습니다. 먼저 시스템이 클라이언트를 종료했는지 확인하고 배터리 설정에서 기기 정책에 맞는 백그라운드 실행 권한을 부여하세요. 백그라운드 실행을 허용해도 모든 연결이 영구적으로 유지되는 것은 아닙니다. Wi-Fi에서 모바일 네트워크로 바뀌면 기존 연결을 다시 만들어야 할 수 있습니다. 화면 잠금이나 네트워크 전환 뒤에만 문제가 발생한다면 프로토콜을 바꾸기 전에 프로세스 상태와 네트워크 전환을 먼저 확인하세요.

시스템 VPN 인터페이스를 다른 네트워크 도구가 사용 중일 수 있습니다. 다른 앱을 켠 뒤 기존 연결이 끊기면 충돌 여부를 확인하세요. 문제를 살펴볼 때는 트래픽을 제어하는 도구 하나만 남기고 결과를 확인합니다. 프라이빗 DNS, 네트워크 필터, 앱별 설정도 DNS 조회와 적용 범위에 영향을 줄 수 있으므로 기존 상태를 기록한 다음 하나씩 테스트하세요. 문제 해결을 위해 시스템 네트워크 보호 기능을 모두 영구적으로 끄지 마세요. 관련성을 확인한 뒤 범위가 분명하고 되돌릴 수 있는 방식으로 조정하세요.

검증할 때는 먼저 대상 앱에서 실제로 접속한 뒤 로그의 DNS 조회 및 연결 결과를 확인하세요. 클라이언트 테스트는 성공했는데 특정 앱만 실패한다면 앱별 적용 범위, 앱 자체 프록시 설정, 프로토콜 요구 사항을 살펴보세요. 모든 앱이 실패한다면 서비스 설정과 DNS를 다시 확인합니다. 새 휴대전화로 옮긴 뒤에는 VPN 권한, 배터리 제한, 앱 목록을 다시 점검하세요. 이 시스템 상태는 구독과 함께 완전히 이전되지 않습니다. 빠른 설정은 구독 가져오기 가이드를 함께 참고하세요.

라우팅, DNS, 도메인 매칭

분할 라우팅 전에 입력과 출구 확인

요청이 클라이언트에 들어오면 라우팅 규칙에 따라 직접 연결, 프록시, 차단 중 하나의 출구를 선택합니다. 규칙은 도메인, 대상 주소, 포트, 프로토콜을 기준으로 매칭될 수 있으며 우선순위와 순서가 결과에 영향을 줍니다. 일반적으로 먼저 보호해야 할 LAN 규칙을 두고, 구체적인 대상 규칙을 추가한 다음 기본 처리 방식을 둡니다. 여러 규칙이 동시에 일치할 수 있다면 현재 코어의 매칭 방식에 따라 판단하세요. 도메인이 더 길면 무조건 우선 적용된다고 가정하지 마세요.

도메인 규칙의 적용 여부는 코어가 대상 도메인을 알고 있는지에 달려 있습니다. 앱이 먼저 자체 DNS 조회를 하고 주소만 전달하면 클라이언트에는 IP 정보만 들어올 수 있습니다. 스니핑은 일부 트래픽에서 대상 이름을 추출할 수 있지만 모든 프로토콜에서 작동하지 않으며 DNS 설정을 대신하지도 않습니다. 설정하기 전에 요청이 어떤 형식으로 들어오는지 확인하고 도메인 규칙과 주소 규칙 중 무엇을 사용할지 정하세요. 규칙 문법이 올바르더라도 매칭에 필요한 입력을 얻지 못하면 적용되지 않을 수 있습니다.

서비스 주소 조회와 대상 조회 구분

DNS 조회는 크게 두 가지입니다. 프록시 연결을 만들기 전에 프록시 서비스 주소를 조회해야 하고, 대상에 접속할 때 대상 도메인을 다시 조회해야 할 수도 있습니다. 첫 번째 조회가 아직 연결되지 않은 프록시에 의존하면 시작 단계에서 순환 문제가 생길 수 있습니다. 두 번째 조회는 직접 연결 또는 프록시 경로 중 의도한 방식으로 처리해야 합니다. 시스템 리졸버, 앱 내장 DNS, 코어 DNS가 함께 동작할 수 있으므로 클라이언트의 DNS 설정 하나만 바꿔도 모든 앱의 조회 경로가 달라지는 것은 아닙니다.

원격 DNS는 어떤 DNS 리졸버를 사용할지 설명할 뿐, 요청이 자동으로 프록시를 통과한다는 뜻은 아닙니다. 해당 리졸버까지의 트래픽이 어떻게 라우팅되는지, 클라이언트가 앱에서 나오는 조회를 제어하는지 확인해야 합니다. 암호화된 DNS는 조회 전송 방식을 개선하는 기능이지 출구 경로를 정하는 기능이 아닙니다. 라우팅 규칙에서 리졸버 주소를 직접 연결로 처리하면 조회가 로컬 네트워크를 통해 나갈 수 있습니다. 설정할 때는 리졸버 선택과 리졸버 연결 경로를 따로 검증하세요.

설정 예시는 규칙 구조를 이해하기 위한 것입니다

아래는 규칙 필드와 출구의 관계를 설명하는 Xray/V2Fly 스타일의 부분 라우팅 구조입니다. 완전한 실행 설정이 아니므로 해당 구조를 사용하는 사용자 설정에 병합해야 하며, 직접 연결 출구의 태그가 실제로 direct인지 확인하세요. GUI에서 다른 태그를 만들 수 있으므로 이름이 같다고 가정하면 안 됩니다. 다른 설정 형식을 사용하는 코어는 해당 설정 메뉴를 사용하고, 이 구조를 호환되지 않는 파일에 그대로 넣지 마세요.

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

AsIs는 라우팅 단계에서 해당 정책 때문에 도메인을 주소로 변환하지 않는다는 뜻이지, 이후 연결에 DNS 조회가 필요 없다는 의미는 아닙니다. geoip:private를 사용하려면 해당 규칙 데이터도 제공되어야 합니다. 로그에 데이터 파일이 없다고 표시되면 리소스 로딩 문제를 해결하세요. 분할 라우팅 규칙을 모두 삭제하지 마세요. 예시 도메인은 구조 설명용이므로 실제 설정에는 필요한 대상을 입력하고, 너무 넓은 규칙으로 많은 트래픽이 뜻하지 않게 직접 연결되지 않도록 주의하세요.

FakeDNS와 유출 검사 범위

FakeDNS는 가상 주소를 사용해 도메인 매핑을 유지합니다. DNS 조회와 이후 연결이 모두 알맞은 처리 경로를 거쳐야 합니다. 앱이 클라이언트를 우회해 실제 주소를 전달했는데 가상 주소 규칙과 매칭되거나, 반대로 가상 주소를 받았지만 연결이 제어되지 않으면 접속에 실패할 수 있습니다. 활성화하기 전에 TUN의 DNS 처리 방식과 코어 지원 여부를 확인하세요. 모든 앱에 한 번에 적용되는 기능이라고 생각하면 안 됩니다.

DNS 경로를 확인할 때는 클라이언트 로그, 시스템 DNS 설정, 테스트 앱을 함께 살펴보세요. 테스트 페이지에 표시된 DNS 출구는 단서일 뿐 기기에서 발생하는 모든 조회를 증명하지는 않습니다. 시스템 DNS, 브라우저 자체 DNS, TUN 환경을 각각 확인하고 직접 연결 대상과 프록시 대상도 따로 검증하세요. 자세한 방법은 DNS 누출 테스트 및 설정 실습을 참고하세요. 문제가 나타나면 먼저 정상적으로 작동하는 DNS 설정을 복구한 뒤 기능을 하나씩 추가하세요. 통신이 끊기면 문제 원인을 찾기 어려워집니다.

시스템 프록시와 TUN 중 선택

트래픽 진입과 출구 라우팅을 나눠서 보기

시스템 프록시는 앱에 프록시 주소를 제공하며, 해당 설정을 따르는 앱이 요청을 직접 전달합니다. TUN은 가상 네트워크 인터페이스를 만들고 라우팅을 통해 범위에 해당하는 트래픽을 클라이언트로 보냅니다. 서로 다른 진입 문제를 해결하므로 어느 쪽이 더 빠른지만으로 선택할 수 없습니다. 주로 브라우저를 사용한다면 동작을 확인하기 쉬운 시스템 프록시부터 시작하세요. 앱이 시스템 프록시를 읽지 않거나 더 다양한 트래픽을 처리해야 한다면 TUN을 검토하세요.

TUN이 더 넓은 범위의 트래픽을 제어한다고 해서 모두 원격 프록시로 보내야 하는 것은 아닙니다. 가상 인터페이스에 들어온 뒤에도 라우팅에 따라 LAN 통신, 특정 대상, 일부 시스템 트래픽을 직접 연결할 수 있습니다. 반대로 전체 프록시 라우팅을 선택해도 클라이언트에 들어오지 않은 앱이 자동으로 프록시를 사용하지는 않습니다. 문제를 해결할 때는 먼저 요청이 클라이언트에 들어왔는지 확인하고, 들어온 뒤 어떤 출구를 선택했는지 따로 살펴보세요.

데스크톱에서 활성화하기 전 확인 순서

먼저 시스템 프록시로 기본 연결을 완료하고 활성 설정, 코어, 구독이 모두 작동하는지 확인한 뒤 TUN을 준비하세요. 현재 네트워크 인터페이스, 기본 게이트웨이, 다른 VPN 상태를 기록하고 충돌할 수 있는 도구를 종료합니다. 클라이언트 안내에 따라 가상 인터페이스 생성 권한을 얻고 TUN을 켠 뒤 로그에서 인터페이스 생성과 라우팅 결과를 확인하세요. 화면의 스위치가 켜져 있어도 로그에 오류가 있다면 실제 실행 결과를 기준으로 판단해야 합니다.

자동 라우팅, 엄격한 라우팅, DNS 제어 등의 설정은 적용 범위와 호환성에 영향을 줍니다. 정확한 의미는 현재 사용하는 코어의 문서에서 확인하세요. 엄격한 라우팅은 우회를 줄일 수 있지만 LAN, 가상 머신, 일부 시스템 서비스에 영향을 줄 수도 있습니다. 처음에는 고급 옵션을 한꺼번에 모두 켜지 말고 클라이언트가 권장하는 기본 조합을 사용한 뒤 실제로 필요한 기능만 추가하세요. 변경할 때마다 프록시 대상, 직접 연결 대상, LAN 접속을 확인하고 되돌릴 수 있는 상태를 유지하세요.

서비스 연결이 자기 자신을 거치지 않도록 하기

프록시 서버에 연결할 때도 네트워크 트래픽이 발생합니다. TUN이 이 트래픽을 올바르게 처리하지 못하면 코어의 연결이 다시 같은 진입점으로 전달되어 루프가 생길 수 있습니다. 클라이언트와 코어에는 보통 인터페이스 제외, 출구 바인딩, 라우팅 처리 기능이 있습니다. 우선 제공된 통합 설정을 사용하세요. 로그에 연결이 반복되고 리소스 사용량은 늘지만 대상 접속은 되지 않는다면 원격 설정만 바꾸지 말고 라우팅 루프와 다른 트래픽 제어 도구의 충돌을 확인하세요.

서비스 주소로 도메인을 사용하면 시작 단계에서 DNS 조회도 필요합니다. 아직 연결되지 않은 프록시로 조회 요청을 강제로 보내면 서비스 주소조차 확인하지 못할 수 있습니다. 서비스 주소는 연결 가능한 초기 DNS 경로를 사용하고 대상 도메인은 의도한 정책에 따라 조회되도록 하세요. 여러 네트워크 인터페이스가 연결되어 있다면 실제 기본 출구를 확인하세요. 일부 프로그램은 이전 인터페이스에 바인딩되어 있을 수 있으므로 네트워크를 바꾼 뒤 유효한 경로를 다시 선택하도록 트래픽 제어 기능을 재시작해야 할 수도 있습니다.

UDP, LAN, 앱 호환성

시스템 프록시, 클라이언트의 로컬 진입점, 원격 프로토콜의 UDP 지원은 서로 다를 수 있으며 원격 서비스에도 제한이 있을 수 있습니다. TUN은 트래픽을 코어로 전달할 뿐 전체 연결 경로의 UDP 지원을 자동으로 제공하지는 않습니다. 웹페이지는 열리는데 음성 통화, 게임, 다른 앱이 실패한다면 앱이 사용하는 트래픽 종류를 확인한 뒤 진입점, 코어, 원격 프로토콜, 서버 정책을 점검하세요. TCP 접속이 된다고 전송 문제까지 해결된 것은 아닙니다.

LAN 기기에 접속하려면 주소 라우팅이 필요하며, 기기 검색에는 브로드캐스트나 멀티캐스트가 사용될 수 있습니다. LAN 우회 규칙 하나로 모든 기기 검색이 해결된다고 가정하지 마세요. 먼저 알고 있는 LAN 주소에 직접 접속해 주소 통신 문제인지 검색 방식 문제인지 구분하세요. 가상 머신과 컨테이너의 가상 네트워크 대역도 계획에 포함해 TUN 주소 풀과 겹치지 않게 하세요. 네트워크 대역이 충돌하면 관련 설정을 조정하고 모든 트래픽을 직접 연결하는 방식으로 규칙 범위를 넓히지 마세요.

종료 및 전환 시 복구 경로 유지하기

테스트를 마치면 먼저 TUN을 끄고 더 이상 필요하지 않은 시스템 프록시를 해제한 뒤 클라이언트를 종료하세요. 특정 구성에서는 두 진입 방식을 함께 사용할 수 있지만, 처음 문제를 진단할 때는 한 가지만 남겨 경로를 단순하게 유지하세요. 네트워크 변경, 절전 모드 복귀, 업그레이드 후에는 가상 인터페이스와 기본 라우팅을 다시 확인하세요. TUN을 끈 뒤에도 문제가 있다면 시스템에 프록시나 DNS 설정이 남아 있는지 확인하세요. 원리와 설정 방법은 v2rayN TUN 모드 상세 안내에서 더 살펴볼 수 있습니다.

설정 관련 자주 발생하는 문제와 단계별 해결

문제가 발생한 단계를 먼저 파악하기

문제를 앱 설치, 코어 실행, 구독 가져오기, 서버 연결, 트래픽 진입, 라우팅 및 DNS의 여섯 단계로 나누세요. 발생 시간, 현재 네트워크, 가장 최근에 변경한 설정을 기록하고 같은 시간대의 로그를 확인합니다. 이후 반복된 오류에 가려지지 않도록 가장 먼저 나타난 주요 오류를 찾으세요. 화면에 연결 상태가 표시되거나 시스템에 가상 인터페이스가 생기거나 테스트 하나가 통과해도 각 단계만 확인된 것입니다. 전체 연결 경로 검증을 대신할 수는 없습니다.

클라이언트를 종료한 뒤에도 기본 네트워크를 사용할 수 없다면 시스템 프록시, DNS, 네트워크 인터페이스를 먼저 복구해 네트워크 자체 상태를 확인하세요. 기본 네트워크는 정상인데 코어가 실행되지 않으면 로컬 파일, 권한, 포트를 점검합니다. 코어는 정상인데 모든 설정이 실패한다면 시스템 시간, 네트워크 제한, 공통 매개변수를 확인하세요. 설정 하나만 실패한다면 해당 설정을 집중적으로 살펴보세요. 영향을 받는 범위를 줄여 가는 편이 클라이언트를 계속 바꾸는 것보다 원인을 명확히 파악하기 쉽습니다.

구독 업데이트 실패 또는 업데이트 후 목록이 비어 있음

먼저 주소가 완전한지, 쿼리 매개변수가 빠지지 않았는지, 공백이 포함되지 않았는지, 페이지 제목을 주소로 복사한 것은 아닌지 확인하세요. 그런 다음 네트워크 문제와 콘텐츠 문제를 구분합니다. 제공처에 연결할 수 없다면 현재 네트워크와 업데이트 방식을 확인하세요. 연결은 되는데 파싱에 실패한다면 반환된 내용이 클라이언트에서 지원하는 구독 형식인지 살펴보세요. 로그인 페이지, 오류 페이지, 요청 제한 안내가 일반 텍스트로 반환될 수 있으므로 ‘가져오기 성공’이라고 해서 설정 내용이 유효한 것은 아닙니다.

프록시 없이 업데이트할 때 실패하고 사용 가능한 연결이 이미 있다면 프록시를 통한 업데이트를 시도할 수 있습니다. 처음이라 사용할 수 있는 연결이 없다면 이 옵션에 의존해서는 안 됩니다. 업데이트 후 목록이 비어 있으면 그룹 활성화 여부, 필터 조건, 제공처가 반환한 내용을 확인하세요. 새 내용이 정상인지 검증하기 전에는 기존에 작동하는 설정을 삭제하지 마세요. 자세한 내용은 문제 해결 FAQ를 참고하고 업데이트 실패와 연결 실패를 별개의 문제로 다루세요.

설정을 가져왔지만 연결되지 않음

서비스 제공자가 안내한 전체 매개변수와 비교해 주소, 포트, 사용자 식별 정보, 전송 방식, 보안 설정, 서비스 이름 등을 확인하세요. 공유 링크에는 일부 정보만 축약되어 표시될 수 있으므로 편집 화면에서 실제 값을 확인해야 합니다. 이름이 비슷해도 의미가 다른 필드가 있으므로 서버 주소를 모든 보안 필드의 값으로 사용하지 마세요. 인증서 오류가 나면 시스템 시간과 설정에 지정된 대상 이름을 먼저 확인하세요. 검증을 꺼서 문제를 임시로 숨기지 마세요.

코어 호환성도 별도로 확인해야 합니다. 클라이언트가 공유 링크를 읽었다고 해서 현재 선택한 코어가 모든 옵션을 지원하는 것은 아닙니다. 가져오는 과정에서 필드가 빠지거나 마이그레이션 중 이전 설정이 남아 호환되지 않을 수 있습니다. 먼저 구독의 원본 설정으로 기준 상태를 만든 뒤 수동 조정을 검토하세요. 코어를 바꾼 뒤 실패했다면 이전에 작동했던 코어로 복구하고 지원 항목의 차이를 비교하세요. 여러 매개변수를 무작위로 조합하는 방식으로 문제를 해결하지 마세요.

브라우저는 연결되지만 다른 프로그램은 실패함

먼저 문제가 있는 프로그램이 시스템 프록시를 사용하는지 확인하세요. 수동 설정을 지원한다면 프록시 프로토콜, 루프백 주소, 실제 포트를 확인합니다. 지원하지 않는다면 TUN이나 Android의 앱별 트래픽 제어 범위를 검토하세요. 프로그램의 요청이 이미 클라이언트에 들어왔다면 라우팅 규칙과 DNS를 확인합니다. 앱 자체의 암호화 DNS, 오래된 주소 캐시, 다른 트래픽 유형 때문에 동작이 달라질 수 있습니다. 이전 연결이 설정 변경을 가리지 않도록 매번 새 연결을 시도해 확인하세요.

일반 앱 오류를 해결하려고 로컬 수신 주소를 모든 네트워크 인터페이스로 바꾸지 마세요. 같은 기기에서 실행되는 프로그램이라면 대개 루프백 주소로 충분합니다. 다른 기기에서 로컬 프록시에 접속하는 것은 별도의 요구 사항이며 접근 제어와 방화벽 계획이 필요합니다. 수신 포트를 다른 프로그램이 사용 중이라면 먼저 점유한 프로그램을 확인한 뒤 충돌 프로세스를 종료하거나 사용 가능한 포트로 바꾸고 앱 설정도 함께 수정하세요. 한쪽 포트만 바꾸면 새로운 연결 오류가 생깁니다.

정상 상태로 복구한 뒤 문제 제보하기

간헐적인 문제가 발생하면 화면 잠금, 절전 모드, 네트워크 전환, 구독 업데이트, 다른 네트워크 도구 활성화와 발생 시점이 일치하는지 기록하세요. 같은 대상을 반복해서 확인하면서 한 번에 변수 하나만 바꾸세요. 문제가 생기면 우선 트래픽 제어 기능을 끄고 기본 네트워크를 복구한 다음 가장 최근의 정상 백업을 가져오세요. 제보할 때는 시스템과 아키텍처, 클라이언트 이름, 코어 종류, 시도한 단계, 민감 정보를 가린 오류 내용을 제공하세요. 전체 자격 증명을 공개하지 마세요. 용어가 낯설다면 용어 설명을 확인한 뒤 해당 항목의 안내로 돌아오세요.