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

처음 연결한다면 빠른 시작 가이드부터 확인하세요. 이 가이드에서는 운영체제별 설치와 가져오기, 트래픽 연결 범위를 안내합니다. 기기를 바꾸거나 네트워크 모드를 전환할 때, 문제가 생겼을 때는 해당 장부터 살펴보세요.

공통 준비 사항

운영체제, 아키텍처, 설치 파일 확인

데스크톱에서는 v2rayN, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. v2fly 코어가 필요한 경우에만 v2flyNG를 선택하세요. 먼저 기기에서 실제로 실행 중인 운영체제를 확인한 다음 아키텍처를 확인합니다. 모델명, 구매 연도, 프로세서 제조사, 시스템 아키텍처는 서로 다른 정보입니다. 같은 제조사의 제품도 아키텍처가 다를 수 있고, 한 기기에서 실행하는 가상 머신은 호스트와 다른 운영체제를 사용할 수도 있습니다. 가상 머신에 설치할 때는 호스트가 아니라 가상 머신 안의 시스템 정보를 기준으로 설치 파일을 선택하세요.

설치 파일 페이지에서 플랫폼을 선택하고 카드에 표시된 패키지 유형에 맞는 파일을 받으세요. 시스템 요구 사항은 해당 페이지의 안내를 따르세요. 아키텍처가 맞는다는 것은 빌드 대상이 일치한다는 뜻일 뿐, 현재 운영체제와 런타임, 데스크톱 환경까지 모두 지원된다는 의미는 아닙니다. 처음 설치할 때는 기본 로컬 리스닝 설정을 유지하고, LAN 접근이나 부팅 시 자동 연결은 활성화하지 마세요. 이렇게 하면 처음 가져오기에 실패해도 클라이언트 실행 문제와 네트워크 연결 문제를 구분하기 쉽습니다.

플랫폼클라이언트설치 파일 선택 기준트래픽 연결 방식
Windowsv2rayNx64 데스크톱 버전 또는 WPF 버전시스템 프록시, 필요할 때 TUN 사용
macOSv2rayNApple Silicon 또는 Intel네트워크 서비스의 프록시 설정, 필요할 때 TUN 사용
Linuxv2rayN배포판의 패키지 형식과 프로세서 아키텍처데스크톱 프록시 또는 앱 프록시, 필요할 때 TUN 사용
Androidv2rayNG、v2flyNGarm64 또는 범용 버전클라이언트가 시스템 VPN 인터페이스를 통해 트래픽을 처리

구독 주소, 노드, 로컬 설정 구분하기

구독 주소는 여러 노드 정보를 가져오는 주소이므로 구독 관리 메뉴에 입력해야 합니다. 단일 공유 링크나 QR 코드는 노드 하나를 설명하므로 클립보드나 QR 스캔 등 단일 노드 가져오기 기능을 사용하세요. 두 가지를 반대로 입력하면 구독 작업에서 형식 오류가 반복되거나, 주소가 저장된 것처럼 보여도 목록에 새 항목이 추가되지 않을 수 있습니다. 내용을 받으면 먼저 어떤 유형인지 확인하고 선택한 클라이언트에서 파싱할 수 있는 형식인지 확인하세요. 다른 소프트웨어의 전체 설정 파일도 일반 구독처럼 가져올 수 없습니다.

구독 주소에는 접속 정보가 포함될 수 있으므로 비밀번호처럼 취급하세요. 온라인 변환 사이트나 공개 스크린샷, 게시글에 붙여 넣지 마세요. 구독 변환은 노드 정보를 한 형식에서 다른 형식으로 바꾸는 작업일 뿐, 대상 코어에서 지원하지 않는 프로토콜이나 전송 매개변수를 사용할 수 있게 해 주지는 않습니다. 형식이 호환되지 않으면 설정 제공자에게 클라이언트에 맞는 구독을 요청한 다음 이전 여부를 결정하세요. 백업을 내보낼 때도 구독 주소, 로컬 노드, 접속 정보가 포함되는지 확인하고, 보호된 로컬 저장소를 이용할 수 있다면 공개 공유는 피하세요.

연결 전후 상태 기록하기

연결하기 전에 기기가 정상적으로 인터넷에 접속되는지, 시스템 날짜와 시간, 시간대가 올바른지 확인하세요. 현재 네트워크에서 웹 로그인이 필요하다면 먼저 접속 절차를 완료합니다. 기존 시스템 프록시, 자동 프록시 스크립트, 업무용 VPN, 앱별 프록시 설정도 기록해 두세요. 기존 설정을 모두 지우려는 것이 아니라 테스트 후 원래대로 복구하기 위한 기록입니다. 관리되는 기기는 관리 정책을 유지하세요. 어떤 설정을 누가 관리하는지 확실하지 않다면 덮어쓰지 마세요.

테스트 대상으로 반복해서 접속할 수 있고 사용 권한이 있는 HTTPS 주소 하나를 고른 다음, 평소 직접 연결해야 하는 LAN 서비스 하나를 비교 대상으로 정하세요. 첫 연결에서는 노드 하나, 앱 하나, 트래픽 연결 방식 하나만 사용합니다. 클라이언트 로그로 로컬 인바운드와 아웃바운드 선택을 확인하고, 앱의 실제 응답으로 서비스 이용 가능 여부를 확인하세요. 노드가 목록에 보이는 것, 코어가 시작된 것, 대상에서 응답을 받은 것은 서로 다른 결과입니다. 문제가 생기면 어느 단계에서 발생했는지 기록하고, 단순히 '프록시가 안 됨'이라고만 적지 마세요.

이미 연결되는 기기는 비교 기준으로 남겨 두세요. 새 기기에 같은 구독을 가져온 다음 노드 그룹과 테스트 대상이 같은지 확인하고, 두 기기의 트래픽 연결 방식을 비교하세요. 두 기기 모두 구독을 업데이트하지 못하면 먼저 구독 서비스에 접속할 수 있는지 확인합니다. 새 기기에서만 실패하면 시스템 권한, 앱 설정, 로컬 네트워크를 우선 점검하세요. 정상 작동하는 기기를 먼저 덮어쓰면 문제가 발생한 단계를 파악하기 어려워집니다.

Windows: v2rayN 설치 및 트래픽 연결

데스크톱 버전 또는 WPF 버전 선택

「설정 → 시스템 → 시스템 정보」에서 시스템 종류를 확인하고 x64 기반인지 살펴본 다음 Windows 설치 파일을 엽니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 Windows 인터페이스를 사용합니다. 두 버전은 메뉴 배치가 다를 수 있습니다. 다른 버전의 화면에서 같은 이름의 버튼을 찾을 수 없다면 구독 관리, 노드 선택, 시스템 프록시와 관련된 메뉴를 찾아보세요. 평소에는 클라이언트 하나만 실행하세요. 두 인스턴스를 동시에 열면 로컬 포트를 함께 사용하거나 프록시 설정을 서로 덮어쓸 수 있습니다.

다운로드 페이지에 표시된 패키지 유형에 따라 설치 프로그램을 실행하거나, 압축 파일을 완전히 풀고 안에 있는 클라이언트를 실행하세요. 실행 파일만 압축 파일에서 꺼내 실행하지 마세요. 코어와 관련 리소스도 함께 있어야 합니다. 처음에는 일반 사용자 계정으로 실행하고, 관리자 권한으로 계속 실행하는 방식을 기본 설치 절차로 삼지 마세요. 기본 창이 열리기 전에 프로그램이 종료되면 시스템 알림과 다운로드 페이지의 런타임 요구 사항부터 확인하세요. 창은 열렸지만 코어 시작에 실패한다면 로그에서 리소스 누락, 접근 거부, 포트 사용 중 여부를 확인하세요.

구독 업데이트 후 앱 하나로 확인하기

구독 그룹 관리에서 알아보기 쉬운 이름으로 그룹을 추가하고 주소 입력란에 구독 주소를 입력한 뒤 저장하세요. 방금 추가한 그룹으로 전환하고 현재 구독 업데이트를 실행해 새 항목이 실제로 해당 그룹에 들어왔는지 확인합니다. 저장할 때 오류가 없다는 것은 로컬에 주소가 기록되었다는 뜻일 뿐입니다. 업데이트가 성공해야 클라이언트가 내용을 가져와 파싱한 것입니다. 노드 하나를 선택해 현재 사용 노드로 지정하고 로그에 시작 오류가 없는지 확인하세요. 기존 그룹의 목록이 남아 있더라도 그것을 이번 업데이트 결과로 착각하지 마세요.

트레이 메뉴에서 시스템 프록시 설정을 선택한 다음, 기본적으로 시스템 프록시를 사용하는 브라우저로 테스트 대상에 접속하세요. Windows의 「네트워크 및 인터넷 → 프록시」에서 실제 설정이 변경되었는지 확인하고 클라이언트에 표시된 로컬 프록시 주소와 포트를 비교합니다. 시스템 프록시를 켠다고 모든 프로그램이 같은 경로를 사용하는 것은 아닙니다. 터미널, 서비스, 일부 다운로드 프로그램, 별도 프록시를 설정한 브라우저는 자체 설정으로 연결할 수 있습니다. 브라우저는 정상인데 다른 앱만 실패한다면 노드가 작동하지 않는다고 단정하기 전에 해당 앱의 프록시 설정을 확인하세요.

TUN 전환 전 중복된 연결 경로 정리하기

대상 프로그램이 시스템 프록시를 따르지 않거나 가상 네트워크 인터페이스로 트래픽을 처리해야 할 때만 v2rayN TUN 모드를 테스트하세요. 기본 경로를 변경하는 다른 프록시 도구를 종료하고, 테스트 전 시스템 프록시 상태를 복원한 뒤 새 모드 하나만 활성화하세요. 클라이언트 안내에 따라 가상 네트워크 어댑터에 필요한 권한을 부여합니다. 확인할 때는 로그와 앱 결과를 함께 살펴보세요. 버튼이 켜졌다고 라우팅이 적용된 것은 아닙니다. 절전 모드에서 깨어난 뒤, Wi-Fi와 유선 네트워크를 전환한 뒤, 시스템에 다른 가상 인터페이스가 남아 있을 때 특히 주의하세요.

TUN을 켠 뒤 인터넷은 되지만 프린터, 파일 공유, 인트라넷 서비스에 연결할 수 없다면 먼저 TUN을 끄고 즉시 복구되는지 확인하세요. 복구된다면 LAN 주소 범위, 도메인, 규칙 우선순위를 확인하고 트래픽 처리 범위를 바로 넓히지 마세요. TUN을 꺼도 네트워크가 여전히 비정상이라면 시스템 프록시 설정에 로컬 포트나 스크립트가 남아 있는지 확인하세요. 수동으로 복구할 때는 테스트 전 기록을 기준으로 삼으세요. 원래 업무용 프록시를 쓰던 기기에서 모든 옵션을 무작정 끄면 안 됩니다.

리스닝 상태로 포트 충돌 확인하기

로그에 주소 사용 중이라는 오류가 나타나면 PowerShell에서 로컬 리스닝 소켓을 조회할 수 있습니다. 아래 명령은 리스닝 상태인 연결을 표시합니다. 출력된 로컬 포트를 v2rayN 설정 페이지에 실제로 표시된 포트와 비교하세요. 기본 포트라고 짐작해서 판단하지 마세요. 프로세스 ID는 포트를 사용 중인 프로그램을 찾는 데 도움이 되지만, 해당 프로그램이 문제라는 뜻은 아닙니다. 같은 프로그램도 서로 다른 주소에서 각각 리스닝할 수 있습니다.

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

포트를 점유한 것이 계속 실행 중인 이전 인스턴스라면 트레이 메뉴에서 정상적으로 종료하세요. 계속 실행해야 하는 앱이 점유 중이라면 사용되지 않는 로컬 포트로 바꾸고, 프록시를 수동으로 설정한 프로그램도 함께 업데이트하세요. 변경한 후 연결을 다시 시작해 리스닝 항목이 나타나는지 확인하고 앱 하나로 재테스트합니다. 리스닝은 정상인데 접속이 실패한다면 포트를 계속 바꾸지 말고 트래픽 연결 방식과 아웃바운드 로그를 확인하세요.

macOS: v2rayN 설치 및 네트워크 서비스

칩에 맞는 디스크 이미지 선택

Apple 메뉴에서 「이 Mac에 관하여」를 엽니다. Apple 칩이라고 표시되면 macOS 설치 파일에서 Apple Silicon 빌드를 선택하고, Intel 프로세서라고 표시되면 Intel 빌드를 선택하세요. 터미널의 동작만으로 기기 전체의 아키텍처를 판단할 수는 없습니다. 터미널 프로세스가 호환 환경에서 실행 중일 수도 있습니다. 해당 디스크 이미지를 열고 창의 안내에 따라 클라이언트를 응용 프로그램 폴더로 복사하세요. 마운트된 이미지에서 계속 실행하지 말고 복사한 앱을 실행합니다. 정상적으로 열리는 것을 확인한 후 디스크 이미지를 추출하세요.

시스템에서 실행을 차단하면 먼저 보안 정책, 시스템 버전 불일치, 프로그램 실행 후 비정상 종료 중 어떤 경우인지 구분하세요. 출처를 확인할 수 있고 기기의 관리 정책에 맞는 앱만 시스템 안내에 따라 처리하세요. 조직 정책상 실행이 허용되지 않는다면 관리자에게 문의하고 시스템 보호 기능을 끄지 마세요. 프로그램 창이 열린 다음 앱 로그를 확인합니다. 앱 로딩 단계에서 문제가 발생한다면 구독, 프록시, DNS를 조정할 필요가 없습니다. 이런 설정 변경으로 바이너리 호환성 문제를 해결할 수는 없습니다.

현재 네트워크 서비스에서 시스템 프록시 확인

구독 관리에서 그룹을 추가하고 업데이트한 다음 노드를 하나 선택하세요. 클라이언트에서 시스템 프록시를 켜고 「시스템 설정 → 네트워크」에서 현재 연결된 서비스를 찾아 프록시 설정을 확인합니다. Wi-Fi와 유선 네트워크는 서로 다른 네트워크 서비스이며 과거 설정이 각각 남아 있을 수 있습니다. 외장 네트워크 어댑터를 연결하거나 도킹 스테이션을 분리하거나 회사에서 집 네트워크로 옮긴 뒤에는 이전 서비스의 프록시 상태만으로 현재 서비스가 같은 경로를 사용한다고 판단할 수 없습니다. 현재 서비스와 현재 시간의 로그를 비교하세요.

터미널에서 아래 읽기 전용 명령을 실행해 시스템이 보고하는 현재 프록시 설정과 네트워크 서비스 순서를 확인할 수도 있습니다. 출력에서 프록시 활성화 여부와 포트가 로컬 기기를 가리키는지 확인할 수 있고, 자동 설정 관련 항목이 표시되기도 합니다. 하지만 모든 앱이 이 설정을 사용한다는 뜻은 아닙니다. 브라우저 프로필에 별도 프록시가 지정되어 있거나 터미널이 환경 변수만 읽는다면 각 요청의 실제 경로를 따로 확인해야 합니다.

scutil --proxy
networksetup -listnetworkserviceorder

클라이언트 로그에 예상한 앱의 인바운드 요청이 나타나지 않으면 해당 앱을 완전히 종료했다가 다시 실행하세요. 일부 프로그램은 초기화할 때 프록시 설정을 읽기 때문에 계속 실행 중인 프로세스는 이전 설정을 사용할 수 있습니다. 프록시를 중지할 때도 창만 전환하지 말고 상태를 확인하세요. 클라이언트의 시스템 프록시를 끄고 필요하면 앱 프로세스를 종료한 다음 현재 네트워크 서비스가 원래 상태로 돌아왔는지 확인합니다. 조직에서 배포한 자동 프록시 주소가 보이면 유지하고, 비교를 위해 삭제하지 마세요.

TUN 시작과 절전 모드 복귀 확인

시스템 프록시로 대상 앱을 사용할 수 있다면 인터페이스 상태를 맞추기 위해 TUN을 켤 필요는 없습니다. 프록시 설정을 읽지 않는 앱의 트래픽을 처리해야 한다면 이번 테스트에서는 시스템 프록시를 끄고 v2rayN 안내에 따라 가상 네트워크 인터페이스를 활성화하세요. 먼저 도메인 접속을 확인하고, 다음으로 LAN 서비스에 접속한 뒤 클라이언트를 정상 종료하고 두 항목을 다시 테스트합니다. 외부 사이트 접속만 확인하면 가상 인터페이스가 기본 경로를 바꾼 뒤 발생하는 LAN 문제를 놓칠 수 있습니다.

절전 모드 전에는 정상이고 깨어난 뒤 실패한다면 먼저 Wi-Fi가 다시 연결되었는지, 클라이언트 로그가 요청을 계속 받는지 확인하세요. Wi-Fi가 복구되지 않았다면 네트워크 연결과 IP 주소 할당을 먼저 점검합니다. Wi-Fi는 복구됐지만 앱의 인바운드 요청이 없다면 시스템 프록시나 가상 라우팅이 여전히 유효한지 확인하세요. 기존 세션이 만료된 것이 확인된 경우에만 해당 모드를 껐다가 다시 켜고, 문제가 재현되는지 살펴보세요. 이렇게 하면 복귀 문제와 구독 노드 변경 문제를 구분할 수 있습니다.

도메인 탐색, 이름 확인, 서비스 연결 구분하기

LAN 접속 문제도 단계별로 확인하세요. 먼저 접속 가능한 것으로 알고 있는 기기의 주소로 실제 서비스를 테스트한 다음 기기 이름으로 접속되는지 확인합니다. 주소로는 되지만 이름으로는 안 된다면 이름 확인이나 로컬 서비스 검색을 점검하세요. 원격 노드부터 변경할 필요는 없습니다. 기기 주소로도 접속되지 않는다면 트래픽 연결 전후의 인터페이스와 규칙을 비교하세요. 원격 DNS 서버는 보통 로컬 네트워크의 기기 이름을 알지 못합니다. 외부 HTTPS 접속이 정상이어도 내부 네트워크의 이름 확인까지 정상이라고 볼 수는 없습니다.

특정 도킹 스테이션이나 특정 네트워크에서만 문제가 발생한다면 현재 서비스 이름, 트래픽 연결 모드, 테스트 대상 유형을 기록하세요. 새로 변경한 설정을 먼저 끄고 검증된 설정으로 돌아간 다음 순서대로 다시 테스트합니다. 모든 네트워크 서비스와 클라이언트 설정을 한꺼번에 삭제하지 마세요. 증상이 사라져도 프록시가 복구된 것인지, 시스템이 사용 가능한 다른 네트워크로 전환한 것인지 알 수 없게 됩니다.

Linux: v2rayN 설치 및 데스크톱 프록시

배포판 패키지 형식과 아키텍처

먼저 배포판의 패키지 관리 체계를 확인한 다음 기기 아키텍처를 확인하세요. Debian, Ubuntu 및 해당 패키지 체계를 사용하는 데스크톱 배포판은 보통 deb를 선택하고, Fedora 및 관련 배포판은 rpm을 선택합니다. 설치 도구가 다른 형식의 파일도 읽을 수 있다는 이유로 deb와 rpm을 서로 바꿔 쓸 수 있다고 생각하지 마세요. Linux 설치 파일의 기본 항목은 x64이며 arm64도 제공됩니다. 배포판이 페이지에 표시된 호환 범위에 없다면 패키지 형식만 같다고 설치할 수 있다고 단정하지 마세요.

uname -m
cat /etc/os-release

uname -m 결과가 x86_64이면 보통 x64 빌드, aarch64이면 arm64 빌드에 해당합니다. 컨테이너나 특수 호환 환경에서는 커널이 보고하는 아키텍처와 사용자 공간 패키지의 아키텍처가 다를 수 있으므로 대상 시스템의 패키지 관리 도구 결과도 확인하세요. 배포판 정보를 읽는 것은 해당 시스템에 맞는 패키지 형식을 선택하기 위한 것이므로 어떤 항목도 변경할 필요가 없습니다. 한 번 설치하기 위해 패키지 저장소를 바꿀 필요도 없습니다.

먼저 데스크톱에 기본으로 제공되는 패키지 설치 프로그램을 사용할 수 있습니다. 명령줄을 사용한다면 실제 파일이 있는 디렉터리에서 배포판에 맞는 설치 명령을 실행하세요. 아래 예시는 선택한 패키지의 이름을 로컬에서 v2rayn.deb 또는 v2rayn.rpm으로 변경했다고 가정합니다. 두 명령 중 하나만 실행하세요. 패키지 관리자가 의존성을 처리합니다. 의존성을 해결할 수 없다는 메시지가 나오면 먼저 시스템 버전과 기존 저장소를 확인하고, 의존성을 강제로 무시해 설치하지 마세요.

# Debian / Ubuntu
sudo apt install ./v2rayn.deb

# Fedora
sudo dnf install ./v2rayn.rpm

현재 데스크톱 사용자 계정으로 구독 가져오기

설치할 때 권한을 높여야 한다고 해서 클라이언트를 평소에도 높은 권한으로 실행해야 하는 것은 아닙니다. 먼저 현재 사용자의 데스크톱 세션에서 실행한 다음 구독 그룹을 추가하고 업데이트하여 노드를 선택하세요. 이전에 권한을 높여 실행했다면 다른 설정을 읽고 썼을 수 있어 일반 사용자 계정에서는 목록이 다르게 보일 수 있습니다. 설정 디렉터리에서 권한 오류가 발생하면 구체적인 경로와 소유자를 확인하고 홈 디렉터리 전체의 권한을 재귀적으로 완화하지 마세요. 코어 로딩에 실패하면 첫 번째 오류를 보존하고 이후 반복 재시도 메시지만 잘라내지 마세요.

데스크톱 프록시 사용 여부는 현재 세션에 따라 달라집니다. 클라이언트가 데스크톱 설정을 기록해도 해당 설정을 읽는 앱만 프록시를 사용합니다. 다른 데스크톱 환경, 별도로 실행되는 샌드박스 앱, 다른 사용자로 실행한 프로그램, 이미 열려 있는 터미널에는 같은 프록시 설정이 전달되지 않을 수 있습니다. 먼저 일반 데스크톱 브라우저 하나로 확인한 다음 대상 프로그램을 각각 테스트하세요. 대상 프로그램만 실패한다면 데스크톱 프록시 스위치 전체가 작동하지 않는다고 생각하기보다 해당 프로그램의 자체 프록시 설정을 사용해 보세요.

로컬 프록시 직접 테스트

데스크톱 앱과 터미널의 동작이 다르다면 터미널에서 클라이언트의 HTTP 또는 혼합 프록시 포트를 지정해 테스트할 수 있습니다. 아래 명령은 입력값을 읽기만 하며 시스템이나 셸의 영구 설정을 변경하지 않습니다. 클라이언트에 실제로 표시된 로컬 포트를 입력하세요. 노드의 원격 포트가 아닙니다. 테스트 대상에는 접속이 허용된 것으로 확인된 주소를 사용하세요. SOCKS 인바운드만 활성화했다면 HTTP를 예로 든 이 테스트는 사용할 수 없습니다. 테스트 주소가 HEAD 요청에 응답하지 않으면 일반 GET 요청으로 바꾸세요.

printf '로컬 HTTP 또는 혼합 프록시 포트: '
IFS= read -r proxy_port
printf 'HTTPS 테스트 주소: '
IFS= read -r test_url
curl --noproxy '' --proxy "http://127.0.0.1:$proxy_port" \
  --head --max-time 15 -- "$test_url"

로컬 기기에서 연결이 거부되면 포트가 리스닝 중인지, 포트 유형이 맞는지 먼저 확인하세요. HTTP 응답을 받았다면 클라이언트 로그를 함께 살펴 요청이 프록시, 직접 연결, 거부 중 어떤 방식으로 처리됐는지 확인합니다. 상태 코드만으로 어느 아웃바운드가 연결을 완료했는지는 알 수 없습니다. 테스트는 성공했지만 터미널의 일반 도구가 계속 실패한다면 해당 도구의 네트워크 설정을 확인하세요. 명시적 매개변수를 사용한 한 번의 테스트를 모든 명령이 프록시를 상속했다는 뜻으로 해석하지 마세요.

가상 인터페이스, 기본 경로, 설정 되돌리기

TUN을 테스트하기 전에 커널에서 가상 네트워크 인터페이스를 제공하는지, 데스크톱 세션에 클라이언트가 요구하는 권한이 있는지 확인하고 정상 상태의 기본 경로와 내부 네트워크 연결 상태를 기록하세요. 컨테이너, 원격 데스크톱, 관리형 시스템은 필요한 인터페이스를 만들지 못할 수도 있습니다. 인터페이스 생성 문제를 해결하려고 그래픽 세션 전체를 높은 권한으로 실행하지 마세요. 활성화 후 다른 업무 네트워크 연결이 끊기면 이번에 추가한 트래픽 연결 모드를 먼저 중지한 다음 라우팅을 비교하세요. 원격 세션에서 라우팅 테이블을 바로 비우지 마세요.

네트워크 관리자는 다시 연결할 때 기기 설정을 재적용할 수 있으므로 처음 활성화할 때와 정상적으로 재연결할 때를 각각 테스트하세요. 재연결 후에만 실패한다면 인터페이스, 네트워크 환경, 오류가 발생한 시간을 기록하고 기본 경로가 사라졌는지 먼저 확인한 다음 클라이언트 상태를 점검하세요. 정상 종료한 뒤에는 데스크톱 프록시, 앱별 프록시, 가상 인터페이스를 각각 확인해야 합니다. 한 곳의 설정을 되돌려도 나머지 설정까지 자동으로 취소되지는 않습니다.

Android: v2rayNG 및 v2flyNG

클라이언트 및 설치 파일 아키텍처

Android 설치 파일에는 v2rayNG가 먼저, v2flyNG가 다음으로 표시됩니다. v2rayNG는 Xray 코어를 사용하므로 우선 선택하기에 적합합니다. 구독에 v2fly 코어가 명시적으로 필요한 경우에만 v2flyNG를 선택하세요. 두 앱의 조작 방식은 비슷하지만 지원하는 프로토콜, 전송 조합, 가져오기 세부 사항이 같다고 단정할 수는 없습니다. 기기 시스템이 arm64 앱을 지원하는지 확인되면 arm64를 선택하세요. 확실하지 않다면 기기 사양을 확인한 뒤 범용 버전을 선택할 수 있습니다. 프로세서가 64비트라고 해서 제조사가 같은 아키텍처의 앱을 지원하는 시스템을 설치했다고 보장할 수는 없습니다.

파일 관리자에서 설치 파일을 여세요. 시스템에서 현재 출처의 앱 설치를 허용하라는 메시지가 나오면 실제로 파일을 연 앱에 필요한 권한만 부여하고, 완료 후 시스템 설정에서 권한을 취소할 수 있습니다. 기존 앱 위에 설치할 수 없다면 아키텍처 불일치, 시스템 버전 미지원, 기기 관리 제한, 기존 앱과 새 패키지의 호환성 문제를 구분하세요. 사용 중인 앱을 바로 삭제하지 마세요. 삭제하면 로컬 노드, 앱별 목록, 환경 설정이 남지 않을 수 있습니다. 실제로 이전하기로 결정한 뒤 백업하세요.

구독 업데이트 및 첫 VPN 권한 승인

구독 그룹 설정을 열고 주소와 알아보기 쉬운 이름을 추가하세요. 노드 페이지로 돌아가 구독을 업데이트하고 이번에 가져온 노드 하나를 선택한 다음 연결을 시작합니다. 클립보드 가져오기는 단일 공유 링크에 적합합니다. 구독 업데이트에 실패했다고 같은 주소를 클립보드 가져오기로 다시 입력할 필요는 없습니다. 로그에서 가져오기 단계가 실패했다면 현재 네트워크로 구독 서비스에 접속할 수 있는지 먼저 확인하세요. 내용을 가져왔지만 사용 가능한 항목이 없다면 구독 형식과 코어 지원 여부를 확인합니다.

처음 실행할 때 보통 시스템 VPN 권한 요청이 표시됩니다. 연결을 생성하려는 앱이 방금 선택한 클라이언트인지 확인한 다음 권한을 승인하세요. 이 기능은 시스템이 제공하는 가상 네트워크 인터페이스를 사용합니다. 같은 사용자 환경에서 이 인터페이스를 사용하는 업무용 VPN, 로컬 방화벽, 필터가 클라이언트와 충돌할 수 있습니다. 항상 켜짐 VPN을 설정해 두었다면 어느 앱에 적용된 설정인지 먼저 확인하세요. 데스크톱의 '시스템 프록시 설정' 단계를 모바일에 그대로 적용하지 말고, 노드 비교를 위해 클라이언트 두 개를 동시에 실행하지도 마세요.

앱별 트래픽 연결 및 네트워크 전환

처음 확인할 때는 일반적인 트래픽 연결 범위로 브라우저를 테스트하고 앱별 조건은 바로 추가하지 마세요. 테스트에 성공한 다음 앱별 프록시를 켜고 화면 설정이 '선택한 앱만 연결'인지 '선택한 앱은 제외'인지 확인합니다. 연결되어야 하는 앱 하나와 연결되지 않아야 하는 앱 하나로 각각 다시 테스트하세요. 브라우저는 되는데 앱 내부 페이지가 실패한다면 네트워크 요청을 보내는 주체가 기본 앱인지, 시스템 구성 요소인지, 외부 브라우저인지 확인하세요. 아이콘만 보고 요청을 보내는 앱을 판단하면 앱 목록을 잘못 선택할 수 있습니다.

Wi-Fi에서는 정상이지만 모바일 데이터에서 문제가 생기면 클라이언트를 끈 상태에서도 전환 후 일반 웹 페이지에 접속할 수 있는지 먼저 확인한 다음 연결이 다시 설정되는지 살펴보세요. 모바일 데이터 권한, 데이터 절약 설정, 현재 네트워크의 접속 조건이 결과에 영향을 줄 수 있습니다. 시스템의 VPN 아이콘만 보지 마세요. 인터페이스가 계속 표시된다고 이전 원격 연결이 새 네트워크에서도 유지된다는 뜻은 아닙니다. 재연결 버튼을 연속으로 누르는 것보다 네트워크를 전환하기 전후의 첫 오류를 기록하는 편이 문제를 찾기 쉽습니다.

백그라운드 제한 및 상시 연결 설정

화면을 잠그면 멈추고 화면을 켜면 다시 작동한다면 시스템의 배터리 및 백그라운드 실행 설정부터 확인하세요. 문제가 반복되면 현재 클라이언트의 배터리 제한만 조정하고 같은 네트워크와 같은 잠금 시간으로 다시 테스트하세요. 모든 앱의 제한을 해제할 필요는 없습니다. 항상 켜짐 VPN은 연결 정책이고 VPN을 거치지 않은 연결을 차단하는 것은 별도의 제한입니다. 후자는 클라이언트가 중지됐을 때 일반 네트워크 연결도 막고 직접 연결이 필요한 앱에 영향을 줄 수 있습니다. 활성화하기 전에 기기 정책과 사용 목적을 확인하고 백그라운드 종료 원인을 가리는 용도로 사용하지 마세요.

배터리 소모를 확인할 때는 클라이언트의 지속적인 트래픽 처리, 앱의 잦은 요청, 불안정한 네트워크로 인한 반복 재연결을 구분하세요. 배터리 사용량 페이지에서 같은 사용 시간을 기준으로 비교하고, 테스트 중에는 네트워크와 앱 범위를 고정하세요. 배터리 최적화, 제조사의 백그라운드 관리, 앱별 설정을 더 자세히 확인하려면 v2rayNG 배터리 소모 및 백그라운드 실행 문제 해결을 참고하세요.

기기를 바꾼 뒤 시스템 설정 다시 구성하기

구독을 다시 가져오면 주로 노드 목록이 복원됩니다. 새 기기의 시스템 VPN 권한, 데이터 사용 권한, 앱별 목록까지 설정되지는 않습니다. 기기를 바꾼 뒤에는 먼저 최소한의 연결을 구성하고 백그라운드 실행과 상시 연결 조건을 추가한 다음 두 기기의 앱 접속 결과를 비교하세요. 직접 만든 노드 몇 개만 이전한다면 필요에 따라 단일 링크를 공유할 수 있습니다. 라우팅과 환경 설정도 유지해야 한다면 백업으로 내보낼 수 있는 항목을 먼저 구분하고 여러 기기에서 설정 동기화하기를 확인하세요.

라우팅 규칙과 DNS

트래픽 연결 경로, 규칙 일치, 아웃바운드

'앱 요청이 클라이언트에 전달되는가'와 '클라이언트가 요청을 받은 뒤 어디로 보내는가'를 먼저 구분하세요. 시스템 프록시나 TUN은 첫 번째 문제를, 라우팅 규칙은 두 번째 문제를 해결합니다. 앱 요청이 클라이언트에 들어오지 않는다면 규칙을 바꿔도 영향을 주지 않습니다. 반대로 로그에서 요청이 수신됐지만 잘못된 아웃바운드로 처리된 것이 보인다면 다른 연결 모드를 켜지 말고 규칙 순서, 일치 조건, 기본 동작을 확인하세요.

일반 라우팅 규칙은 순서대로 검사하며 보통 처음 일치하는 규칙이 아웃바운드를 결정합니다. 도메인 전용 규칙은 해당 규칙을 먼저 처리할 수 있는 포괄적인 규칙보다 앞에 둬야 합니다. 규칙의 outboundTag는 설정에 이미 정의된 아웃바운드 태그를 가리킵니다. 임의의 이름을 입력할 수 있는 것은 아닙니다. direct, proxy, block은 흔히 쓰이는 예시 이름이지만 모든 설정에서 같은 태그를 사용한다고 단정하지 마세요. 일치하는 규칙이 없으면 코어는 보통 첫 번째 아웃바운드를 사용하며 그래픽 클라이언트가 기본 규칙을 추가할 수도 있습니다. 화면의 모드 이름만 보고 추측하지 말고 실제 설정과 로그를 확인하세요.

구체적인 규칙을 확인한 뒤 기본 경로 변경하기

아래는 Xray에서 사용할 수 있는 도메인 규칙 예시입니다. 정확히 example.org와 일치하는 요청을 이미 정의된 direct 아웃바운드로 보냅니다. 이는 routing.rules 배열에 넣는 단일 객체이지 전체 설정이 아닙니다. 규칙 순서를 확인하려면 해당 아웃바운드가 있는지 확인한 다음 테스트 설정의 포괄적인 규칙보다 앞에 넣고, 해당 도메인과 다른 테스트 대상의 아웃바운드 로그를 비교하세요. 그래픽 클라이언트에 라우팅 편집기가 있다면 해당 필드에 값을 입력하고, 도메인만 받는 입력란에 객체 전체를 붙여 넣지 마세요.

{
  "type": "field",
  "domain": ["full:example.org"],
  "outboundTag": "direct"
}

도메인 규칙은 코어가 도메인 이름을 알아낸 경우에만 일치할 수 있습니다. IP 주소로 직접 접속하거나 앱이 먼저 이름을 확인한 다음 연결하거나 가상 인터페이스에서 목적지 IP만 확인할 수 있는 경우에는 도메인 규칙이 적용되지 않을 수 있습니다. 일부 설정에서는 트래픽 스니핑으로 도메인 정보를 보완할 수 있지만 인식 여부는 트래픽과 설정에 따라 달라집니다. 내부 기기에 직접 연결해야 한다면 앱이 로컬 이름을 사용하는지 특정 주소를 사용하는지 먼저 확인하고, 범위가 적절한 도메인 또는 IP 조건을 선택하세요. 관련 없는 주소 범위 전체를 제외하지 않는 것이 좋습니다.

도메인 이름은 어디서 확인하는가

V2Ray DNS 설정은 여러 단계에 걸쳐 있습니다. 운영체제가 먼저 이름을 확인할 수 있고, 브라우저가 자체 보안 DNS를 사용할 수도 있으며, 코어가 라우팅 판단이나 아웃바운드 연결을 위해 조회할 수도 있습니다. 원격 DNS를 활성화해도 모든 조회가 원격 DNS로 전달되는 것은 아니며, TUN이 각 앱에 내장된 DNS 확인 기능까지 자동으로 제어하는 것도 아닙니다. 문제를 확인할 때는 먼저 어떤 종류의 조회를 테스트할지 정한 다음 로그, 앱 설정, 시스템 이름 확인 결과의 차이를 살펴보세요. 외부 도메인과 내부에서만 사용하는 이름은 보통 서로 다른 확인 경로가 필요합니다. 둘을 같은 DNS 서버로 처리하면 문제를 파악하기 더 어려워질 수 있습니다.

사이트가 도메인으로만 접속된다면 IP 주소로 직접 접속되는지를 HTTPS 성공 기준으로 삼지 마세요. 인증서, 가상 호스트, 핸드셰이크에 사용하는 서버 이름은 도메인에 의존할 수 있습니다. 더 확실한 비교 방법은 도메인 이름 확인 성공 여부, 앱 연결 여부, 코어가 최종 선택한 아웃바운드를 각각 기록하는 것입니다. 앱 캐시의 영향을 받는다면 테스트할 앱을 종료했다가 다시 실행하세요. 설정을 바꾸자마자 표시되는 이전 캐시 결과를 새 설정이 적용됐다는 증거로 보지 마세요. 조회 경로를 체계적으로 확인하려면 DNS 유출 테스트 및 설정을 참고하세요.

도메인 정책과 FakeDNS의 사용 범위

코어의 라우팅 도메인 정책은 IP 규칙에 적용할 주소 확인 여부에 영향을 줍니다. 예를 들어 Xray의 AsIs는 라우팅을 위해 도메인을 IP 주소로 변환하지 않고, IPIfNonMatch는 도메인 규칙에 일치하지 않을 때 IP 규칙을 확인하기 위해 주소를 조회합니다. 라우팅 일치를 위한 조회와 최종 연결에 사용할 주소는 별개의 설정입니다. 정책을 바꾸면 조회 시점과 규칙 일치 결과가 달라질 수 있으므로 변경한 뒤에는 원래 직접 연결되어야 하는 대상과 프록시를 거쳐야 하는 대상을 모두 확인하세요.

FakeDNS는 합성 주소를 만들어 매핑을 저장한 다음 트래픽을 처리하는 코어가 이를 도메인으로 되돌리는 방식입니다. DNS 응답과 후속 연결이 서로 맞물리는 처리 경로를 따라야 합니다. 기기가 합성 주소를 받은 뒤 트래픽이 가로채지지 않는 경로로 연결되면 이름 확인은 성공하지만 연결은 실패할 수 있습니다. 처음 설정할 때는 일반 DNS 확인과 라우팅을 먼저 안정화하세요. 도메인 매핑이 꼭 필요한 경우에만 FakeDNS 원리와 사용 사례를 읽고 별도로 검증하세요. 설정을 되돌릴 때는 매핑 관련 옵션도 함께 취소하고 테스트 앱의 연결을 새로 설정하세요.

설정 관련 자주 묻는 질문

구독은 저장됐는데 노드 목록이 비어 있는 이유는 무엇인가요?

가져오기 단계와 파싱 단계 구분하기

활성 그룹과 업데이트 대상이 일치하는지 먼저 확인하세요. 업데이트 로그에 도메인 확인 실패, 연결 시간 초과, 서버 오류 상태가 표시되면 아직 가져오기 단계의 문제입니다. 구독 서비스에 접속할 수 있는 기존 네트워크를 사용해 다시 시도하세요. 아직 가져오지 않은 노드로 구독에 연결할 수는 없습니다. 가져오기는 성공했지만 형식이 지원되지 않는다고 표시되면 제공자에게 응답 내용이 클라이언트에서 읽을 수 있는 구독인지 확인하세요. 로그인 페이지나 오류 메시지, 다른 소프트웨어의 전체 설정 파일일 수 있습니다. 응답 내용과 원본 주소를 공개하지 말고 오류 유형과 발생 시간만 기록하세요.

이전에는 목록이 정상이었는데 이번에 일부 항목이 사라졌다면 활성 그룹을 잘못 선택했는지 먼저 확인한 다음 서버에서 노드를 교체하거나 일부 항목을 철회했는지 확인하세요. 구독 업데이트로 그룹의 기존 노드가 덮어써질 수 있습니다. 별도로 관리해야 하는 수동 설정은 다른 그룹에 보관해 구독 변경과 로컬 변경을 구분하세요.

노드 테스트는 성공했는데 앱이 연결되지 않는 이유는 무엇인가요?

테스트 종류에 맞게 결과 해석하기

V2Ray 노드 속도 테스트는 서버까지의 전송 연결만 확인할 수도 있고, 노드를 통해 클라이언트에 설정된 테스트 주소에 접속할 수도 있습니다. 테스트에 성공해도 다른 도메인, 다른 앱, 다른 DNS 설정까지 작동한다는 뜻은 아닙니다. 현재 선택한 노드가 테스트한 노드와 같은지 확인한 다음 대상 앱에서 새 요청을 보내고 시간을 기록해 코어 로그를 확인하세요. 인바운드 기록이 없다면 시스템 프록시, 가상 인터페이스, 앱 범위를 확인합니다. 인바운드가 있고 아웃바운드도 예상대로라면 원격 연결과 대상 서비스의 응답을 점검하세요.

테스트 주소, 네트워크, 테스트 유형이 다르면 결과를 직접 비교하기 어렵습니다. 한 번 시간 초과가 발생했다고 구독 전체를 사용할 수 없다고 판단할 수는 없습니다. 같은 네트워크에서 동일한 테스트 주소로 반복 확인하고, 같은 단계에서 계속 실패하는지 기록한 다음 정상 작동이 확인된 노드와 비교하세요.

TUN을 켠 뒤 모든 사이트에 접속할 수 없다면 어떻게 하나요?

정상 작동 상태로 복구한 뒤 트래픽 연결만 다시 테스트하기

이번에 켠 TUN을 먼저 끄고 기존 직접 연결이나 시스템 프록시 상태로 돌아가 기본 네트워크가 여전히 정상인지 확인하세요. 복구 후에도 인터넷에 연결되지 않으면 현재 네트워크에서 로그인이 완료됐는지, 클라이언트를 종료한 뒤 로컬 프록시 포트가 남아 있는지, 기기에 상시 VPN 정책이 적용되어 있는지 확인하세요. 복구 과정에서 기존 업무 네트워크 설정을 유지해야 합니다. TUN을 끄자마자 정상으로 돌아온다면 가상 인터페이스 권한, 다른 네트워크 도구와 라우팅 충돌 여부, DNS 확인에 사용하는 주소에 도달할 수 있는지 점검하세요.

다시 테스트할 때는 TUN만 켜고 노드와 테스트 주소를 그대로 유지하세요. 먼저 도메인 접속과 원래 직접 연결해야 하는 로컬 주소를 테스트한 다음 로그를 확인합니다. '켜짐' 표시는 클라이언트가 작업을 수락했다는 뜻일 뿐입니다. 라우팅, 인터페이스, DNS 확인, 아웃바운드 상태를 각각 확인해야 합니다.

같은 구독인데 두 기기에서 다르게 작동한다면 무엇부터 비교해야 하나요?

클라이언트, 코어, 테스트 조건 맞추기

실제로 선택한 노드, 코어 종류, 네트워크, 대상 주소, 테스트 시간을 먼저 비교하세요. 모바일은 시스템 VPN 인터페이스를 사용하고 데스크톱은 시스템 프록시만 설정할 수 있습니다. 같은 노드를 사용해도 두 기기의 앱 트래픽 연결 범위는 다를 수 있습니다. 가져온 뒤에는 표시되지만 연결할 때 매개변수 오류가 발생한다면 현재 코어가 해당 프로토콜과 전송 설정을 인식하는지 확인하세요. 클라이언트를 바꾸기 전에 클라이언트 비교에서 차이를 확인한 다음 한 기기에서 변수 하나만 바꿔 테스트하세요.

두 앱에서 모두 정상적으로 사용할 수 있고 규칙을 옮겨야 하더라도 시스템 관련 설정 전체를 그대로 복사하지 마세요. 같은 트래픽 분리 방식을 각 기기에 맞게 설정할 수 있지만 로컬 주소, 프록시 포트, 앱 목록, 권한 대상을 각각 다시 확인해야 합니다. 옵션을 완전히 같게 맞추기보다는 두 기기에서 직접 연결할 서비스와 트래픽을 처리할 서비스가 의도대로 작동하는지 확인하세요.

인증서 또는 핸드셰이크 오류가 발생하면 어떤 설정을 바꿔야 하나요?

인증서 검증은 유지하고 오류 위치 확인하기

시스템 날짜와 시간이 올바른지 확인하고, 오류 메시지가 브라우저로 접속한 대상 사이트에서 나온 것인지 클라이언트와 노드 사이의 핸드셰이크에서 나온 것인지 구분하세요. 클라이언트 로그에 오류가 있다면 가져온 노드 주소, 전송 매개변수, 서버 이름이 제공자의 안내와 일치하는지 확인합니다. 브라우저에 오류가 표시된다면 테스트 주소를 정확히 입력했는지, 현재 네트워크에서 웹 로그인이 필요한지, 앱이 시스템에 남은 프록시를 잘못 사용하고 있지 않은지 확인하세요. 인증서 검증을 끄는 것은 해결 방법이 아닙니다. 연결 대상이나 설정 정보의 불일치를 감출 수 있습니다.

문제를 문의할 때는 운영체제, 클라이언트 이름, 연결 모드, 재현 절차, 민감 정보를 가린 첫 번째 오류만 제출하세요. 전체 구독, 노드 공유 링크, 접속 정보가 포함된 설정 내보내기 파일은 첨부하지 마세요. 오류가 어느 단계에서 시작되는지 여전히 알기 어렵다면 빠른 시작 가이드로 돌아가 최소한의 절차를 다시 진행한 다음 이 가이드의 해당 장을 따라 설정을 추가하세요.