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

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

처음 설정한다면 빠른 시작 가이드에 따라 가져오기, 연결, 확인까지 진행하세요. 이 페이지는 플랫폼별 참고용 안내서입니다. 해당 플랫폼 섹션부터 확인하고, 여러 플랫폼에 공통으로 적용되는 문제는 구독, 프록시 연결 지점, 문제 해결 항목을 살펴보세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다.

공통 준비: 패키지, 구독, 권한

이 장의 설정 요약
항목확인 위치권장 사항
시스템 및 아키텍처시스템 정보먼저 아키텍처를 확인한 다음 설치 패키지를 선택하세요
구독 주소서비스 제공업체 계정 또는 문서전체 주소를 복사하고 외부에 공유하지 마세요
최초 연결 확인클라이언트 로그와 브라우저먼저 단일 노드로 확인한 뒤 트래픽 처리 방식을 조정하세요

기기 제품군이 아니라 실제 아키텍처에 맞춰 패키지를 선택하세요

클라이언트 다운로드 페이지에서 운영체제를 선택한 다음 아키텍처와 패키지 형식을 확인하세요. x64와 x86-64는 같은 아키텍처를 뜻하며, arm64는 시스템 정보에 AArch64로 표시되기도 합니다. 시스템 이름만으로 아키텍처를 판단할 수는 없습니다. 데스크톱 프로세서 브랜드가 패키지 이름과 일치하는 것도 아닙니다. 예를 들어 Linux 패키지에 amd64라고 적혀 있어도 같은 아키텍처의 Intel 프로세서에서 사용할 수 있는 경우가 많습니다. 다운로드 페이지에 해당 플랫폼의 일부 아키텍처만 표시될 수 있습니다. 맞는 항목이 없다면 시스템 종류와 릴리스 정보를 먼저 확인하세요. 다른 플랫폼용 설치 패키지를 대체품으로 사용하지 마세요. 구형 기기라면 시스템 버전이 클라이언트의 최소 요구 사항을 충족하는지도 확인해야 합니다.

구독, 노드, 프록시 연결 지점 구분하기

구독 주소는 노드 목록을 가져오는 데 사용됩니다. 노드 항목에는 프로토콜, 대상 주소, 포트, 전송 매개변수가 저장됩니다. 로컬 프록시 연결 지점은 기기의 앱이 트래픽을 클라이언트로 전달할 때 사용합니다. 이 셋은 서로 다른 주소입니다. 구독 업데이트에 성공했다는 것은 인식 가능한 데이터를 가져왔다는 뜻일 뿐, 모든 노드에 연결할 수 있다는 뜻은 아닙니다. 반대로 구독 사이트에 일시적으로 접속할 수 없어도 이미 가져온 노드가 곧바로 작동하지 않게 되는 것은 아닙니다. 문제를 기록할 때는 구독 업데이트, 코어 실행, 대상 사이트 접속 중 어느 단계에서 실패했는지 먼저 적고 해당 단계에 맞춰 확인하세요.

가져오기 전에 받은 주소가 구독 주소인지 단일 노드 공유 링크인지 확인하세요. 구독 주소는 구독 그룹에 추가한 뒤 직접 업데이트하고, 단일 노드 링크는 클립보드나 QR 코드로 가져옵니다. 노드 공유 코드와 구독 주소에는 접속 정보가 포함될 수 있으므로 온라인 파서에 붙여 넣거나 QR 코드가 담긴 화면을 공개 토론에 올리지 마세요. 출처나 용도를 기준으로 그룹 이름을 지정하면 직접 추가한 노드와 구독 노드를 구분하기 쉽습니다. 구독을 수정하기 전에 현재 활성 노드와 그룹을 기록해 두세요. 업데이트 과정에서 항목이 다시 생성될 수 있으며, 구독 노드의 매개변수를 직접 수정한 내용이 덮어써질 수도 있습니다.

테스트 기준을 정한 뒤 설정을 변경하세요

시작하기 전에 시스템 프록시의 현재 상태, 다른 네트워크 트래픽 처리 도구의 실행 여부, 클라이언트의 현재 처리 모드를 기록하세요. 회사 프록시, 고정 스크립트, 수동 예외 규칙은 필요한 설정일 수 있으므로 설치 전에 지워야 할 잔여 항목으로 취급하면 안 됩니다. 테스트에는 평소 접속할 수 있는 HTTPS 페이지 하나를 고정 대상으로 사용하세요. 같은 네트워크, 같은 노드, 같은 브라우저를 유지하고 먼저 트래픽 처리를 끈 상태를 확인한 뒤 한 번에 설정 하나만 바꾸세요. 브라우저에 프록시 확장 프로그램이 설치되어 있거나 별도의 프록시 설정을 사용하는 경우, 테스트 전에 시스템 설정을 덮어쓰는지 확인하세요. 데스크톱에서는 시스템 프록시 확인을 마치기 전에 TUN을 서둘러 켤 필요가 없습니다. Android에서는 시스템 VPN 권한을 허용해 트래픽을 처리합니다.

처음 연결할 때 사용자 지정 DNS, 수동 라우팅, 시작 시 자동 실행을 한꺼번에 켜지 마세요. 연결이 확인되면 필요한 설정을 하나씩 추가하고, 변경할 때마다 같은 테스트를 반복하세요. 확인할 때는 클라이언트 로그와 실제 페이지를 함께 살펴보세요. 트레이 아이콘 색상 변화는 화면 상태가 바뀌었다는 뜻일 뿐이며, 페이지가 정상적으로 열려도 캐시된 결과일 수 있습니다. 페이지를 새로 요청하고 같은 시간대의 로그를 대조해야 요청이 예상한 연결 지점으로 전달됐는지 확인할 수 있습니다. 도움을 요청할 때는 플랫폼, 패키지 형식, 실패 단계, 민감 정보를 가린 오류 내용을 제공하세요. 설정 전체를 내보내 공유하지 마세요.

Windows: v2rayN 데스크톱 버전과 WPF 버전

이 장의 설정 요약
설정 항목선택 항목권장 사항
배포 형태데스크톱 버전 / WPF 버전새로 설치한다면 데스크톱 버전부터 시작하고, 필요에 따라 WPF를 선택하세요
시스템 프록시자동 설정 / 초기화먼저 시스템 프록시를 읽는 앱에서 확인하세요
TUN켜기 / 끄기권한과 라우팅 필요성을 확인한 뒤 사용 설정하세요

인터페이스 버전과 실행 위치 선택

Windows 다운로드에서 v2rayN 데스크톱 버전과 클래식 WPF 버전 중 하나를 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용해 데스크톱 운영체제가 달라도 익숙한 방식으로 조작할 수 있습니다. WPF 버전은 클래식 Windows 인터페이스에 익숙하거나 기존 작업 흐름을 유지해야 하는 사용자에게 적합합니다. 두 버전의 주된 차이는 인터페이스와 실행 환경이지 구독 주소의 종류가 아닙니다. 한 기기에서 두 배포 형태를 번갈아 사용하려면 먼저 트레이 메뉴에서 이전 클라이언트를 완전히 종료하세요. 두 코어가 동시에 로컬 포트를 사용하려 하거나 두 프로세스가 시스템 프록시 설정을 번갈아 바꾸는 일을 방지할 수 있습니다.

압축 파일을 다운로드했다면 현재 계정에 쓰기 권한이 있는 폴더에 완전히 압축을 푼 다음 주 프로그램을 실행하세요. 압축 파일 미리보기 창에서 바로 실행하면 안 됩니다. 설치 프로그램을 다운로드했다면 설치 화면의 안내에 따라 설치한 뒤 시작 메뉴나 생성된 바로 가기에서 실행하세요. 실행에 필요한 구성 요소가 없다는 오류가 표시되면 오류에 나온 런타임 이름과 아키텍처를 기록한 뒤 해당 배포 형태의 안내에 따라 설치하세요. 검색 결과에서 같은 이름의 라이브러리 파일만 따로 받아 앱 폴더에 넣지 마세요. 조직의 보안 정책으로 실행이 차단되면 보호 기능을 끄고 설치를 강행하지 말고 기기 관리자에게 허가 여부를 확인하세요.

그룹을 가져오고 시스템 프록시 설정하기

구독 그룹 설정을 열어 이름과 전체 구독 주소를 입력하고 저장한 다음 해당 그룹을 업데이트하세요. 인터페이스에 노드가 표시되면 항목 하나를 선택해 활성 서버로 지정하세요. 먼저 로그에서 코어 실행 실패나 포트 바인딩 오류가 있는지 확인한 다음 트레이 메뉴에서 「시스템 프록시 자동 설정」을 선택하세요. Windows 네트워크 설정에서 프록시 상태를 확인하고 브라우저로 고정 테스트 대상에 접속하세요. 시스템 프록시 주소가 설정됐는데 브라우저가 프록시를 사용하지 않는다면 브라우저 프록시 확장 프로그램, 앱 자체의 네트워크 설정, 관리 정책을 확인하세요. 기본 창을 닫아도 트레이로 최소화될 뿐, 프로그램이 종료되거나 이전 시스템 설정이 복원되는 것은 아닙니다.

TUN, 포트 충돌, 종료 후 남은 설정 처리

시스템 프록시를 읽지 않는 앱까지 트래픽을 처리해야 한다면 먼저 현재 설정을 기록한 뒤 화면 안내에 따라 TUN에 필요한 권한을 허용하세요. 초기화에 실패하면 로그를 확인해 가상 인터페이스 생성 실패, 라우트 변경 실패, 코어 실행 실패를 구분하세요. 네트워크를 처리 중인 다른 클라이언트를 먼저 종료하고 단독으로 테스트하세요. 두 도구가 같은 기본 경로를 놓고 경쟁하는 상태로 계속 사용하지 마세요. TUN을 켠 뒤에는 로컬 네트워크 리소스와 업무 네트워크에 계획대로 계속 접속할 수 있는지도 확인하세요. 처리 범위가 예상보다 넓다면 먼저 TUN을 꺼서 기존 상태로 되돌린 뒤 라우트를 따로 조정하세요.

아래 명령은 PowerShell에서 TCP 수신 대기 포트를 확인합니다. 숫자는 자주 사용하는 로컬 SOCKS 포트를 확인하기 위한 예시입니다. 클라이언트 화면에 다른 값이 표시되면 실제 값을 사용하세요. 출력의 OwningProcess 값은 작업 관리자의 프로세스 ID와 대조할 수 있습니다. 출력이 없다는 것은 해당 TCP 포트에서 수신 대기를 확인하지 못했다는 뜻일 뿐, 원격 서버의 온라인 여부를 판단할 수는 없습니다.

Get-NetTCPConnection -State Listen -LocalPort 10808 -ErrorAction SilentlyContinue

포트가 이미 사용 중이라면 해당 프로세스가 이전 코어인지, 다른 로컬 서비스인지, 현재 클라이언트인지 먼저 확인하세요. 수신 대기 포트를 변경할 때는 주소를 직접 입력한 앱의 설정도 함께 수정해야 합니다. 클라이언트를 종료한 뒤에야 웹 페이지 접속이 실패한다면 시스템이 중지된 로컬 프록시를 계속 가리키는지 우선 확인하세요. 원래 회사 프록시를 사용하던 기기라면 모든 설정을 무조건 지우지 말고 기존 설정을 복원하세요. 인터페이스 선택과 설치 방식은 Windows 데스크톱 버전과 WPF 버전 설치 안내에서도 확인할 수 있습니다.

macOS: 칩에 맞는 패키지와 네트워크 서비스

이 장의 설정 요약
항목확인 위치권장 사항
칩이 Mac에 관하여Apple Silicon은 arm64, Intel은 x64를 선택하세요
시스템 프록시현재 네트워크 서비스의 프록시 설정네트워크 서비스를 바꾼 뒤 다시 확인하세요
TUN클라이언트 스위치와 로그권한 및 라우트를 따로 확인하세요

응용 프로그램 폴더에 설치한 뒤 처음 실행하세요

시스템 메뉴에서 「이 Mac에 관하여」를 선택해 Apple Silicon인지 Intel 프로세서인지 확인한 다음 macOS 다운로드에서 해당하는 v2rayN 디스크 이미지를 선택하세요. 컴퓨터를 구입한 연도만으로 판단할 필요는 없으며, 기본 패키지를 사용하기 위해 다른 아키텍처의 실행 환경을 추가할 필요도 없습니다. 다운로드한 이미지를 열고 창의 안내에 따라 앱을 「응용 프로그램」으로 복사한 뒤, 복사한 앱을 실행하고 디스크 이미지를 추출하세요. 디스크 이미지에서 앱을 계속 실행하면 이후 교체와 실행 경로를 파악하기 어려워집니다. 복사본이 여러 개라면 이전 복사본을 종료하고 방금 복사한 앱이 열렸는지 확인하세요.

처음 실행할 때 경고가 표시되면 아키텍처가 맞지 않는 것인지, 시스템 버전이 너무 오래된 것인지, 출처를 확인할 수 없는 것인지, 기기 관리 정책이 차단한 것인지 먼저 확인하세요. 원인에 따라 해결 방법이 다릅니다. 출처와 기기 정책을 확인한 뒤 시스템에서 허용하는 단일 앱 승인 절차만 사용하세요. 조직에서 관리하는 기기라면 관리자에게 문의하세요. 시스템의 앱 심사 설정을 전체적으로 변경하지 마세요. 앱 창은 열렸는데 코어가 실행되지 않는다면 로그에서 실행 권한, 런타임 구성 요소, 설정 파싱 중 어느 문제인지 확인하세요. 창이 열린다는 이유만으로 설치가 완전히 끝났다고 판단하면 안 됩니다.

구독을 가져오고 현재 네트워크 서비스 확인

v2rayN에서 새 구독 그룹을 만들고 전체 주소를 붙여 넣은 다음 저장하고 직접 업데이트하세요. 활성 노드를 선택한 뒤 로컬 수신 대기 상태를 확인하고 시스템 프록시 자동 설정을 켜세요. 시스템 설정의 「네트워크」에서 현재 사용 중인 Wi-Fi 또는 유선 서비스를 확인하고 세부 정보에서 「프록시」를 여세요. 프록시 설정은 네트워크 서비스별로 저장됩니다. 두 서비스가 모두 표시된다면 목록의 첫 번째 서비스만 확인하지 마세요. 시스템 버전이나 인터페이스 언어에 따라 메뉴 이름이 다를 수 있으므로 현재 사용 중인 서비스에 표시된 설정을 기준으로 확인하세요.

회사에서 유선 네트워크를 설정한 뒤 집에서 Wi-Fi로 바꾸자 앱 동작이 달라졌다면 Wi-Fi 서비스의 프록시 상태와 클라이언트가 설정을 다시 적용했는지부터 확인하세요. 네트워크에서 먼저 웹 인증을 해야 하는지도 살펴보세요. 이 경우 구독 업데이트 실패가 노드 문제라는 뜻은 아닐 수 있습니다. 아래 두 명령은 네트워크 상태만 확인합니다. 첫 번째 명령은 네트워크 서비스 순서와 서비스별 기기 연결 관계를 보여 주고, 두 번째 명령은 현재 시스템 프록시 요약을 표시합니다. 프록시가 켜져 있다면 클라이언트에 표시된 로컬 포트와 대조하세요. 요약이 정상이어도 모든 앱이 해당 프록시를 사용하는 것은 아닙니다.

networksetup -listnetworkserviceorder
scutil --proxy

TUN과 잠자기 후 깨어난 상태 확인

시스템 프록시를 읽지 않는 앱을 사용해야 하고 현재 배포 패키지가 TUN을 지원한다면, 비교를 위해 시스템 프록시를 끈 뒤 클라이언트에서 TUN을 켜고 안내에 따라 권한을 허용하세요. 인터페이스 초기화, 고정 대상 요청, 직접 연결을 유지해야 하는 로컬 리소스를 차례로 확인하세요. 기기에 VPN, 프록시 설정, 관리되는 필터 구성 요소가 이미 있다면 조직 설정을 임의로 끄지 마세요. 허용된 네트워크와 기기에서 별도로 확인할 수 있습니다. 모드를 전환해도 기존 연결이 바로 다시 설정되지 않을 수 있으므로, 이전에 열어 둔 페이지를 보는 데 그치지 말고 테스트 앱을 종료하거나 새 연결을 시도하세요.

잠자기에서 깨어나거나 네트워크를 바꾼 뒤 간헐적으로 실패한다면 잠자기 전 사용한 인터페이스와 깨어난 뒤 실제 인터페이스를 기록하고, 기존 연결만 문제가 있는지 확인하세요. 새 연결도 실패한다면 클라이언트 코어가 계속 실행 중인지, 네트워크 서비스 프록시가 유효한 수신 포트를 가리키는지, TUN이 다시 설정됐는지 살펴보세요. 복구할 때는 클라이언트에서 해당 모드를 끈 다음 현재 네트워크 서비스 상태를 확인하세요. 모든 네트워크 환경설정을 초기화하지 마세요. 문제가 안정적으로 재현된 뒤 로그인 시 자동 실행을 설정할지 결정하세요. 자동 실행을 먼저 설정하면 남은 설정과 시작 순서 문제를 구분하기 어려워집니다.

Linux: deb, rpm, 데스크톱 세션

이 장의 설정 요약
항목선택 항목권장 사항
패키지 형식deb / rpm배포판의 패키지 관리 방식에 맞춰 선택하세요
환경 프록시데스크톱 프록시 / 프로세스 환경 변수그래픽 앱과 터미널 프로그램을 구분하세요
가상 인터페이스TUN인터페이스 지원 여부와 권한을 먼저 확인하세요

배포판과 프로세서 아키텍처에 맞춰 설치하세요

Debian과 Ubuntu에서는 보통 deb를, Fedora와 openSUSE에서는 rpm을 선택합니다. 하지만 rpm 형식이라도 필요한 종속성이 모두 같다는 뜻은 아닙니다. Linux 다운로드에서 릴리스 정보에 명시된 지원 시스템을 확인한 뒤 x64 또는 arm64를 선택하세요. uname -m으로 기기 아키텍처를 확인하고 cat /etc/os-release로 배포판을 확인할 수 있습니다. 컨테이너나 원격 호스트에서 명령을 실행하면 해당 환경의 정보가 표시됩니다. 그래픽 클라이언트를 실제로 실행할 데스크톱의 정보와 다를 수 있습니다. 특정 패키지를 설치하려고 다른 배포판의 소프트웨어 저장소를 시스템에 추가하지 마세요.

가능하면 데스크톱 소프트웨어 설치 프로그램으로 로컬 패키지를 여세요. 터미널에서 설치해야 한다면 아래 명령은 Debian 계열, Fedora, openSUSE용입니다. 해당하는 명령 하나만 선택하세요. 예시는 선택한 실제 설치 패키지를 현재 디렉터리에 두고 짧은 파일 이름으로 변경했다고 가정합니다. 실제 경로로 바꿔도 되며, 경로에 공백이 있으면 따옴표로 묶으세요. 패키지 관리자가 종속성 누락이나 충돌을 보고해야 합니다. 종속성 확인을 무시해 설치를 강행하지 마세요.

sudo apt install ./v2rayn.deb
sudo dnf install ./v2rayn.rpm
sudo zypper install ./v2rayn.rpm

실제로 사용할 데스크톱 세션에서 가져오기와 연결 확인

설치가 끝나면 앱 메뉴에서 평소 로그인 계정으로 v2rayN을 실행하세요. 설치에 관리자 권한을 사용했더라도 그래픽 인터페이스를 매일 관리자 계정으로 실행해야 하는 것은 아닙니다. 일반 계정으로 구독 그룹을 추가하고 직접 업데이트한 다음 활성 노드를 선택하세요. 로그에서 코어와 수신 대기가 준비됐는지 확인하세요. 앱 메뉴에서 실행 항목을 찾을 수 없다면 먼저 설치 작업이 완료됐는지 확인한 뒤 데스크톱 세션에 다시 로그인해 메뉴가 갱신됐는지 살펴보세요. 경로나 권한 문제를 숨기려고 다른 사용자의 설정 디렉터리에서 관리자 권한으로 실행하지 마세요.

GNOME과 KDE Plasma의 시스템 프록시 설정은 서로 다른 구성 인터페이스로 관리될 수 있습니다. 터미널 프로그램도 프로세스 환경 변수나 자체 설정만 읽을 수 있습니다. 시작할 때 프록시 설정을 읽는 앱은 데스크톱 프록시를 바꾼 뒤 다시 실행해야 확인할 수 있습니다. 브라우저에서는 접속되지만 패키지 관리자는 접속되지 않는다면 패키지 관리자가 어떤 프록시 설정을 읽는지 먼저 확인하세요. 관리자 권한으로 실행한 프로세스에는 일반 사용자 환경 변수가 전달되지 않을 수 있습니다. 아래 명령은 로컬 수신 대기 상태만 확인하며 데스크톱이나 터미널의 프록시 설정은 변경하지 않습니다. 인터페이스의 포트가 다르면 조건에 실제 포트를 입력하세요.

ss -ltn 'sport = :10808'

가상 인터페이스와 로그인 시 자동 실행 확인

TUN을 사용해야 한다면 먼저 시스템에서 /dev/net/tun을 제공하는지 확인하고 클라이언트가 요청하는 권한이 배포 안내에 따라 부여됐는지도 확인하세요. 장치 경로가 있어도 현재 프로세스에서 열 수 있다는 보장은 없으며, 시스템 라우트를 변경할 수 있다는 뜻도 아닙니다. 컨테이너나 관리형 세션에서는 호스트 환경이 인터페이스와 라우트 권한을 제한할 수 있습니다. 인터페이스 생성 실패가 로그에 표시되면 장치를 사용할 수 없는 문제인지 권한 부족인지 먼저 구분하세요. 인터페이스는 생성됐는데 특정 대상에 연결되지 않는다면 앱 권한을 더 늘리지 말고 라우트와 DNS를 확인하세요.

수동 연결이 안정된 뒤 로그인 시 자동 실행을 설정하세요. 데스크톱 세션 자동 실행은 시스템 부팅 시 서비스 실행과 다릅니다. 전자는 올바른 사용자 세션에서 그래픽 설정을 사용할 수 있지만, 후자는 로그인 전에 실행될 수 있어 같은 데스크톱 프록시 설정이나 사용자 디렉터리를 사용하지 않을 수 있습니다. 자동 실행을 확인하려면 로그아웃한 뒤 다시 로그인해 트레이, 활성 노드, 로그를 살펴보세요. 백그라운드 프로세스가 보인다는 이유만으로 시스템 프록시가 적용됐다고 판단하면 안 됩니다. 자동 실행에서만 실패한다면 네트워크 준비 순서와 이전 프로세스의 중복 실행을 먼저 확인하세요. 자세한 내용은 Linux 패키지 설치와 자동 실행 안내를 참고하세요.

Android: 구독 그룹과 VPN 트래픽 처리

이 장의 설정 요약
항목선택 항목권장 사항
클라이언트v2rayNG / v2flyNGv2rayNG를 우선 권장하며, 프로토콜 요구 사항에 따라 대안을 선택하세요
APK 아키텍처arm64 / 범용시스템의 arm64 지원 여부를 확인한 뒤 전용 패키지를 선택하세요
트래픽 처리 방식Android VPN 서비스처음 실행할 때 권한을 요청한 앱을 확인하세요

클라이언트, 아키텍처, 설치 출처 선택

Android 다운로드에서 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요한 경우에만 v2flyNG를 고려하세요. 두 클라이언트가 지원하는 노드 유형과 옵션은 완전히 같지 않습니다. 클라이언트를 바꾸기 전에 구독의 프로토콜과 전송 요구 사항을 확인하세요. 가져올 수 있는지만으로 연결 가능 여부를 판단하면 안 됩니다. 대부분의 최신 Android 휴대전화에서는 먼저 arm64 설치가 가능한지 확인하세요. 시스템에서 지원하는 앱 아키텍처를 모른다면 범용 패키지를 선택할 수 있습니다. 프로세서가 64비트를 지원해도 시스템에서 해당 아키텍처 앱 설치를 허용한다는 보장은 없습니다.

다운로드한 APK를 열면 시스템에서 브라우저나 파일 관리자 등 현재 설치에 사용하는 출처에 권한을 요청할 수 있습니다. 실제로 설치 파일을 연 출처에만 필요한 권한을 부여하고, 설치가 끝난 뒤 임시 권한을 취소할 수 있습니다. 조직에서 관리하는 기기에서 설치가 금지되어 있다면 먼저 기기 정책을 확인하세요. 설치에 실패하면 패키지 비호환, 저장 공간 부족, 기존 앱을 덮어쓸 수 없는 문제를 구분하세요. 백업 없이 앱을 바로 삭제하지 마세요. 구독, 수동 노드, 앱별 설정이 함께 삭제될 수 있습니다.

구독 추가, 목록 업데이트, 서비스 시작

v2rayNG에서 구독 그룹 관리 메뉴를 찾아 그룹을 추가하고 전체 구독 주소를 입력하세요. 목록으로 돌아가 구독을 업데이트한 뒤 결과가 해당 그룹에 표시되는지 확인하고 노드 하나를 선택하세요. QR 코드로 받은 경우 단일 노드 링크인지 구독 주소인지 확인한 다음 클라이언트의 해당 가져오기 기능을 사용하세요. 이미지를 업로드하는 인식 서비스를 사용하지 마세요. 직접 가져온 노드와 구독 그룹은 따로 관리하는 것이 좋습니다. 그래야 업데이트 후 기존에 선택한 노드가 사라졌다고 오해하지 않습니다.

연결을 시작하면 Android에 VPN 연결 요청이 표시됩니다. 현재 선택한 클라이언트에서 요청한 것인지 확인한 뒤 승인하세요. 이 권한을 통해 클라이언트는 시스템이 제공하는 가상 네트워크 인터페이스로 트래픽을 받으며, Wi-Fi의 수동 프록시 설정을 변경할 필요는 없습니다. 상태 표시줄의 VPN 아이콘은 서비스가 시작됐다는 뜻일 뿐, 활성 노드와의 핸드셰이크가 성공했다는 의미는 아닙니다. 연결 경로에 영향을 줄 수 있는 다른 네트워크 도구를 먼저 끄고 브라우저에서 새 페이지를 연 다음 같은 시간대의 클라이언트 로그와 비교하세요. Wi-Fi와 모바일 데이터를 구분해 테스트하려면 매번 네트워크 하나만 바꾸고 같은 노드와 테스트 앱을 유지하세요.

앱별 설정, 상시 연결, 백그라운드 연결 끊김

앱별 설정이 필요하다면 화면에서 「허용 목록의 앱만」과 「허용 목록의 앱 제외」 중 어떤 모드가 선택되어 있는지 먼저 확인하세요. 같은 브라우저가 목록에 있어도 두 모드에서 의미가 반대입니다. 테스트 앱 하나만으로 먼저 확인한 뒤 다른 앱을 추가하세요. 대상 앱이 업무 프로필에 있거나 기기 정책으로 관리된다면 개인 프로필의 클라이언트가 해당 앱의 트래픽을 처리하지 못할 수 있습니다. 앱 하나의 문제를 확인하려고 앱별 설정, 상시 연결 VPN, 연결 끊김 시 차단을 처음부터 모두 켜지 마세요.

백그라운드로 전환하거나 화면을 끈 뒤 연결이 끊긴다면 알림과 클라이언트 로그를 먼저 확인하세요. 서비스가 중지됐는지, Wi-Fi에서 모바일 데이터로 전환됐는지, 노드는 선택된 상태인데 새 연결만 실패하는지 살펴보세요. 백그라운드 제한이 원인이라는 증거가 있을 때만 시스템에서 허용하는 방식으로 해당 클라이언트의 배터리 사용 제한과 백그라운드 실행 설정을 확인하세요. 모든 앱이 갑자기 접속되지 않는다면 시스템에서 현재 어떤 VPN 앱을 사용 중인지, 연결이 끊겼을 때 네트워크를 차단하는 옵션이 켜져 있는지 확인하세요. 복구하기 전에 이 설정을 본인이나 관리자가 구성했는지도 살펴보세요. v2rayNG와 v2flyNG를 비교할 때는 한 번에 하나만 실행하세요. VPN 앱을 전환한 결과를 노드 연결 끊김으로 오해할 수 있습니다.

시스템 프록시와 TUN: 트래픽 처리 범위와 확인

이 장의 설정 요약
연결 지점적용 범위권장 사항
시스템 프록시시스템 프록시를 읽는 앱데스크톱 최초 연결 시 우선 확인
로컬 SOCKSSOCKS 주소를 직접 지정할 수 있는 앱앱 하나를 진단할 때 사용
TUN가상 인터페이스로 들어오는 트래픽라우트와 DNS를 확인한 뒤 적용 범위를 넓히세요

시스템 프록시는 연결 지점을, 라우팅은 출구를 결정합니다

데스크톱 클라이언트의 시스템 프록시 스위치는 보통 운영체제의 프록시 설정이 로컬 수신 지점을 가리키도록 합니다. 앱이 이 설정을 직접 읽어야 요청을 클라이언트에 전달할 수 있습니다. 브라우저 하나가 프록시를 사용한다고 해서 터미널, 백그라운드 업데이트 프로그램, 로컬 네트워크 앱도 같은 연결 지점을 사용한다는 뜻은 아닙니다. 클라이언트의 라우팅 설정은 이미 클라이언트로 전달된 요청을 처리합니다. 도메인, 주소, 기타 조건에 따라 프록시 사용, 직접 연결, 차단을 선택할 수 있습니다. 라우팅을 전역 모드로 바꿔도 시스템 프록시를 읽지 않는 앱이 트래픽을 보내도록 할 수는 없습니다. 반대로 TUN을 켜도 모든 대상이 원격 노드를 거치는 것은 아닙니다.

요청 하나로 로컬 프록시를 따로 확인하세요

데스크톱에 curl이 설치되어 있다면 시스템 프록시 선택 과정을 건너뛰고 로컬 SOCKS 주소를 직접 지정해 테스트할 수 있습니다. 명령의 공개 도메인은 예시용으로 예약된 주소입니다. 실제 문제를 확인할 때는 접속 가능 여부를 알고 있는 HTTPS 대상으로 바꾸세요. 먼저 클라이언트에서 SOCKS 연결을 제공하는지, 포트가 화면에 표시된 값과 일치하는지 확인하세요. HTTP 프록시 포트나 원격 노드 포트를 입력하면 안 됩니다. Windows PowerShell에서는 같은 이름의 별칭이 호출되지 않도록 curl.exe를 사용할 수 있습니다. 예시의 socks5h는 curl이 로컬에서 먼저 이름을 해석하는 대신 대상 호스트 이름을 SOCKS 서비스에 전달합니다. 그렇다고 이후 클라이언트가 반드시 특정 DNS 서비스를 사용하는 것은 아닙니다.

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

로컬 연결이 거부됐다는 오류가 명확하다면 먼저 수신 대기 포트와 프로세스 상태를 확인하세요. 로컬 서비스까지 연결됐지만 대상 응답을 기다리다 시간 초과됐다면 로그에서 라우팅과 원격 연결을 살펴보세요. 대상의 HTTP 응답을 받았다면 해당 요청이 애플리케이션 계층에서 응답을 받았다는 뜻일 뿐, 다른 대상이나 앱, UDP 트래픽까지 정상이라는 의미는 아닙니다. 대상이 HEAD 요청을 허용하지 않는다면 일반 GET 요청으로 다시 테스트할 수 있습니다. 진단을 마친 뒤 로컬 수신 주소를 무심코 로컬 네트워크에 공개하지 마세요. 같은 기기에서 테스트할 때는 루프백 주소면 충분하며, 다른 기기에 공개하면 접근 범위가 달라집니다.

TUN 사용 후 라우트와 DNS 확인

TUN은 운영체제의 라우팅으로 전달된 트래픽을 가상 네트워크 인터페이스에서 처리합니다. 먼저 시스템 프록시를 끈 비교 상태에서 같은 테스트 앱을 사용한 다음 TUN만 켜세요. 세 가지를 확인하세요. 트래픽을 처리해야 하는 앱, 직접 연결을 유지해야 하는 로컬 서비스, 도메인으로 접속하는 테스트 대상입니다. TUN을 켰을 때만 로컬 네트워크 리소스에 접속할 수 없다면 로컬 네트워크 대역과 인터페이스 선택을 먼저 확인하세요. 네트워크는 연결되지만 도메인 대상에 접속할 수 없다면 DNS 요청이 어떤 경로로 처리되는지 살펴보세요. 최종 확인에 도메인 대신 IP 주소를 직접 사용하지 마세요. 인증서, 가상 호스트, 라우팅 규칙에 도메인 이름이 필요할 수 있습니다.

지원되는 코어와 설정에서 FakeDNS는 도메인에 가상 주소를 반환하고, 연결이 클라이언트에 들어온 뒤 매핑을 이용해 원래 도메인을 찾을 수 있습니다. 이 기능이 제대로 작동하려면 DNS 조회와 연결의 처리 경로가 서로 맞아야 합니다. 앱이 자체적으로 이름을 해석하거나, 모드 전환을 넘어 캐시를 유지하거나, 가상 주소가 예상한 인터페이스로 들어오지 않으면 결과가 다를 수 있습니다. 일반적인 설치에서는 이 기능을 직접 켤 필요가 없습니다. 특정 트래픽을 도메인 기준으로 처리해야 한다는 점이 분명할 때만 사용을 검토하세요. 먼저 기능을 끈 상태를 기록한 다음 해당 설정 하나만 변경하세요. 원리는 FakeDNS 가상 주소 매핑 안내, 용어는 용어집에서 확인할 수 있습니다.

설정 관련 문제 해결: 실패 단계별 확인

이 장의 설정 요약
증상먼저 확인다음 단계
목록이 비어 있음구독 업데이트 결과그룹과 응답 데이터 형식 확인
로컬 연결 거부클라이언트 수신 대기포트, 프로세스, 시작 오류 확인
일부 앱에서만 실패앱의 요청이 클라이언트에 전달됐는지 확인시스템 프록시, TUN, 앱별 설정 비교

먼저 재현 가능한 테스트 한 차례를 기록하세요

문제를 검증 가능한 한 문장으로 정리하세요. 예를 들어 「같은 브라우저에서 시스템 프록시를 끄면 테스트 페이지가 열리지만, 켜면 로컬 수신 대기 오류가 발생한다」처럼 적고 단순히 연결할 수 없다고만 쓰지 마세요. 확인 당시의 네트워크, 프록시 모드, 활성 그룹, 테스트 대상을 기록하고 해당 요청을 포함하는 로그 일부를 저장하세요. 로그에 구독 쿼리 매개변수, 계정 표시 정보, 노드 주소가 있다면 다른 사람에게 보내기 전에 가리세요. 재시험 중 네트워크, 노드, 코어를 한꺼번에 바꾸지 마세요. 문제가 해결되더라도 어떤 변경을 유지해야 할지 알기 어렵습니다.

로그의 마지막 줄만 보지 말고 문제와 관련된 첫 오류부터 확인하세요. 설정 파싱 실패, 포트 바인딩 실패, 원격 핸드셰이크 실패는 서로 다른 단계에서 발생합니다. 앞 단계가 이미 실패했다면 뒤에 나타난 시간 초과는 그 결과일 수 있습니다. 한 번의 지연 시간 테스트만으로 실제 접속 상태를 판단할 수는 없습니다. 테스트가 서버 포트까지만 확인하거나 다른 요청 대상을 사용할 수도 있습니다. 지연 시간 결과는 테스트 유형, 로그 시간, 실제 앱 동작과 함께 살펴보세요. 가까운 단계부터 원격까지 확인하는 전체 순서는 노드 시간 초과 및 연결 실패 문제 해결에서 확인할 수 있습니다.

자주 발생하는 증상과 다음 단계

구독을 추가했는데 노드가 표시되지 않는 이유는 무엇인가요?

그룹을 저장한 것은 주소를 저장한 것일 뿐, 내용을 가져왔다는 뜻은 아닙니다. 해당 그룹을 직접 업데이트하고 로그에서 연결 실패, 접근 거부, 형식 오류가 표시되는지 먼저 확인하세요. 응답이 로그인 안내나 일반 웹페이지라면 클라이언트가 노드 정보를 읽어 오지 못할 수 있습니다. 제공업체 계정에서 클라이언트가 인식할 수 있는 구독 주소를 다시 받아 보세요. 업데이트에는 성공했는데 목록이 비어 있다면 현재 선택된 그룹이 방금 업데이트한 그룹인지, 검색 필터가 적용된 상태인지 확인하세요. 기존 목록을 사용할 수 있다면 새 구독을 가져올 수 있는지 확인하기 전에 이전 그룹을 삭제하지 마세요.

노드는 목록에 있지만 모든 대상에 연결할 수 없나요?

먼저 시스템 날짜와 시간대가 동기화됐는지 확인한 뒤 활성 노드가 선택되어 있는지, 코어가 실행 중인지, 로컬 프록시 포트가 수신 대기 중인지 살펴보세요. 고정된 테스트 대상으로 요청을 한 번 보내세요. 로그에 해당 요청이 전혀 없다면 앱의 프록시 연결 지점을 먼저 확인하세요. 요청이 클라이언트에 전달됐다면 대상 이름 해석, 원격 연결, 전송 핸드셰이크를 차례로 구분하세요. 제공업체에서 받은 매개변수가 있을 때만 전송 유형, 서비스 이름, TLS 설정을 수정하세요. 인증서 오류를 없애려고 검증을 끄지 마세요. 시간, 대상 이름, 노드의 원래 설정을 다시 확인하세요.

노드 전환이나 업데이트 후에만 문제가 생기나요?

먼저 같은 기존 노드를 사용해 비교하세요. 업데이트된 항목만 실패한다면 활성 그룹이 바뀌었는지, 제공업체에서 포트나 전송 방식을 변경했는지, 클라이언트 코어가 해당 설정을 지원하는지 확인하세요. 업데이트 후 모든 노드가 실패한다면 다른 프로그램 복사본을 실행했는지, 기존 데이터 디렉터리를 읽고 있는지, 이전 프로세스가 포트를 계속 사용 중인지 먼저 살펴보세요. 백업을 복원할 때는 클라이언트를 종료하고 데이터 형식이 호환되는지 확인한 뒤 해당 데이터를 복원하세요. 서로 다른 배포 형태의 설정 파일을 전부 섞지 마세요.

창을 닫은 뒤 인터넷에 연결할 수 없으면 어떻게 복구하나요?

클라이언트가 여전히 트레이에서 실행 중인지 확인하고 창 닫기, 코어 중지, 완전 종료를 구분하세요. 클라이언트를 열 수 있다면 먼저 화면에서 사용 설정한 트래픽 처리 모드를 끄고 시스템 프록시가 아직 로컬 포트를 가리키는지 확인하세요. 클라이언트가 비정상 종료됐다면 준비 단계에서 기록한 상태를 기준으로 원래 프록시, 자동 설정 스크립트, VPN 설정을 복원하세요. 회사 프록시를 사용하던 기기라면 모든 프록시 항목을 일괄 삭제하지 마세요. 복원한 뒤 같은 테스트 대상으로 요청을 다시 보내고 로컬 네트워크 리소스도 정상적으로 사용할 수 있는지 확인하세요.