전체 플랫폼 가이드

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

처음 설정하면서 연결 하나만 확인하려면 사용 가이드에서 가져오기, 모드 선택, 연결, 확인 순서로 진행하세요. 이 페이지는 플랫폼별 차이나 문제가 생겼을 때 찾아보는 안내서입니다. 먼저 준비 사항을 확인한 뒤 사용 중인 기기 섹션으로 이동하세요. 구독을 가져왔는데 작동하지 않는다면 라우팅 규칙이나 설정 관련 자주 묻는 질문을 바로 확인할 수 있습니다.

준비 사항: 클라이언트, 구독 및 기본 연결 확인

기기에 맞는 클라이언트를 고른 다음 설치 파일을 선택하세요

데스크톱에서는 v2rayN, Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. V2Fly 코어에 의존하는 설정임을 확인한 경우에만 대안인 v2flyNG를 고려하세요. 클라이언트는 가져오기, 전환, 로그 확인을 위한 화면을 제공하고, 코어는 연결을 설정하고 라우팅을 처리합니다. 둘은 서로 다른 역할입니다. 목록에 노드가 보인다는 것은 클라이언트가 항목을 읽었다는 뜻일 뿐입니다. 실제로 연결을 시작할 수 있는지, 특정 보안 설정을 인식하는지는 사용 중인 코어에 달려 있습니다. 설치 파일을 고를 때는 기기의 시스템 정보에 표시된 아키텍처를 확인하세요. 기기 모델이나 프로세서 제조사, 다른 컴퓨터에 설치했던 경험만으로 추측하지 마세요.

플랫폼별 클라이언트 및 설치 파일 선택 기준
플랫폼클라이언트설치 파일 선택 기준
Windowsv2rayNx64. 데스크톱 버전이 먼저, 클래식 WPF 버전이 다음
macOSv2rayNApple Silicon은 arm64, Intel은 x64 선택
Linuxv2rayNdeb와 rpm 중 먼저 고른 다음 x64 또는 arm64 선택
Androidv2rayNG、v2flyNG시스템에서 지원하는 아키텍처에 따라 arm64 또는 범용 버전 선택

구독 링크와 단일 공유 링크 구분하기

구독 링크는 설정을 묶음으로 정기적으로 가져오는 주소이므로 구독 그룹에 입력해야 합니다. vmess://, vless:// 등으로 시작하는 단일 공유 링크는 클립보드 가져오기나 QR 코드 스캔 기능을 사용하세요. 구독 주소를 저장했다고 해서 클라이언트가 항목을 가져온 것은 아니므로, 추가한 뒤 해당 그룹을 업데이트해야 합니다. 반대로 직접 가져온 단일 설정은 다른 그룹을 업데이트해도 자동으로 바뀌지 않습니다. 스크린샷만 있는 경우에는 먼저 화면에 QR 코드 하나가 있는지, 메뉴 설명이 표시되어 있는지 확인하세요. 주소가 잘 보이지 않는다고 임의로 이어 붙이지 마세요. 두 링크의 용도는 공유 링크와 구독 링크의 차이에서 확인할 수 있습니다.

구독 링크에는 접근 정보가 포함될 수 있으며, 주소를 아는 사람은 해당 그룹의 내용을 가져갈 수 있습니다. 붙여넣기 전에 앞뒤에 따옴표나 공백, 메신저가 덧붙인 문장 부호가 없는지 확인하세요. 주소 매개변수를 함부로 수정하거나 온라인 디코더에 입력하지 마세요. 다른 사람에게 문제를 문의할 때는 클라이언트 이름, 현재 메뉴, 오류 유형만 알려주면 됩니다. 로그 스크린샷을 공유할 때는 전체 주소, 계정 식별 정보, 노드 이름, 서버 정보를 가리세요. 구독 그룹에는 용도를 알 수 있는 메모를 붙이고, 업데이트 전에 메모를 확인하면 여러 그룹 중 잘못된 그룹을 업데이트하는 일을 줄일 수 있습니다.

기존 설정을 기록하고 클라이언트 없이 한 번 테스트하세요

시작 전에 현재 시스템 프록시 상태, 실행 중인 다른 네트워크 도구가 있는지, 접속해야 하는 로컬 사이트를 기록하세요. 회사나 학교에서 제공한 프록시 또는 자동 설정 스크립트를 사용 중이라면 원래 설정을 보존하고, 관리 대상 네트워크 정책을 클라이언트로 덮어쓰지 마세요. 평소 접속 가능한 페이지를 직접 연결해 확인한 다음, 반복해서 열어볼 수 있는 페이지를 연결 확인용으로 정하세요. 브라우저에 이전 페이지가 표시된다고 네트워크가 정상인 것은 아닙니다. 캐시되지 않은 주소를 열고 페이지가 실제로 로드될 때까지 기다리는 것이 좋습니다.

첫 테스트에서는 변수를 최소화하세요. 클라이언트 하나, 구독 그룹 하나, 지원 여부를 확인한 노드 하나만 사용합니다. 데스크톱에서는 앱 하나 또는 시스템 프록시로 먼저 확인하고 TUN은 일단 사용하지 마세요. Android에서는 기본 VPN 연결을 확인하고 앱별 분할 설정은 나중에 조정하세요. 테스트한 네트워크와 앱도 기록하세요. 예를 들어 가정용 Wi-Fi와 브라우저처럼 구체적으로 적으면 됩니다. 네트워크나 앱이 다르면 결과를 그대로 비교할 수 없습니다. 네트워크를 바꾼 뒤에는 먼저 직접 연결을 다시 확인하고 구독이나 라우팅 문제를 판단하세요.

기기를 바꾸기 전에는 클라이언트의 내보내기 또는 백업 기능을 우선 사용하고, 백업은 직접 관리할 수 있는 위치에 보관하세요. 내보내기 기능이 없다면 구독 출처와 필요한 사용자 지정 규칙만 로컬에 보존하세요. 이전 기기의 로컬 포트, 권한, 네트워크 인터페이스 설정을 새 기기에 통째로 옮기는 것은 적절하지 않습니다. 특히 사용 중인 로컬 포트는 새 기기의 다른 프로그램이 이미 사용하고 있을 수 있습니다. 새 기기의 기본 설정으로 먼저 연결을 확인한 뒤, 용도가 분명한 사용자 지정 설정만 추가하세요.

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

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

먼저 ‘설정 → 시스템 → 정보’에서 ‘시스템 종류’를 확인해 운영체제와 프로세서 유형을 확인한 다음 Windows 다운로드에서 설치 파일을 선택하세요. 처음 설치한다면 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전부터 시작해도 좋습니다. 기존 메뉴 배치에 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 기능 메뉴의 위치가 다를 수 있으므로 오래된 안내서를 볼 때는 스크린샷의 아이콘보다 메뉴 이름을 기준으로 찾으세요. 기능을 비교하려고 두 버전을 동시에 실행하지 마세요. 같은 로컬 수신 포트를 사용하거나 동일한 시스템 프록시 설정을 차례로 변경할 수 있습니다.

설치 프로그램을 실행하고 화면 안내에 따라 설치한 뒤 시작 메뉴에서 클라이언트를 여세요. 처음 실행한 뒤 창을 닫았을 때 프로그램이 사라진 것처럼 보이면 알림 영역과 숨겨진 아이콘을 먼저 확인하세요. 일부 설정에서는 창을 닫아도 프로그램이 종료되지 않고 트레이로 최소화됩니다. 버전을 바꾸거나 포트 사용을 해제하려면 창의 닫기 버튼만 누르지 말고 트레이 메뉴에서 ‘종료’를 선택하세요. 실행에 필요한 환경이 없다는 메시지가 명확하게 표시되면 선택한 설치 파일의 요구 사항을 확인하세요. 인터페이스가 열리지 않는 경우에는 구독이나 라우팅을 바꾸기 전에 설치 오류부터 해결하세요.

구독 그룹: 추가와 업데이트는 별개의 작업입니다

‘구독 그룹’을 열고 ‘구독 그룹 설정’으로 이동해 그룹을 추가한 뒤 메모와 구독 주소를 입력하세요. 저장한 다음 해당 그룹으로 전환하고 ‘구독 그룹’ 메뉴에서 업데이트를 실행합니다. 변경된 그룹이 하나뿐이라면 먼저 현재 그룹만 업데이트하세요. 다른 그룹의 요청 실패가 이번 결과를 가릴 수 있습니다. 노드가 표시되면 항목 하나를 선택해 활성 서버로 지정하고 로그에 시작 오류가 있는지 확인하세요. 표에서 행을 선택하는 것만으로 현재 서버가 바뀌지 않을 수도 있으므로 작업 후 기본 화면이나 상태 표시줄에 활성 항목이 표시되는지 확인하세요.

그룹이 비어 있다면 먼저 목록 필터와 그룹 탭이 방금 추가한 항목을 가리키는지 확인한 뒤 로그를 살펴보세요. 로그에 요청 시간 초과가 표시되면 구독 가져오기 문제를 확인하세요. 응답은 받았지만 파싱 오류가 발생했다면 단일 공유 링크를 가져온 것은 아닌지, 서버가 로그인 페이지를 반환한 것은 아닌지 확인하세요. 새 기기를 처음 설정할 때는 보통 프록시를 거치지 않고 업데이트를 시도하면 됩니다. 이미 사용 가능한 연결이 있고 꼭 필요한 경우에만 메뉴를 확인해 프록시를 통한 업데이트를 시도하세요. 노드를 내려받으려면 먼저 노드가 있어야 하는 상황이 생기지 않도록 주의하세요.

먼저 시스템 프록시를 사용하고, 적용되지 않는 앱이 있을 때 TUN을 고려하세요

코어가 정상적으로 시작된 후 기본 창이나 트레이의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 구성’을 선택하고, 시스템 프록시를 따르는 앱을 다시 열어 테스트하세요. 시스템 프록시는 앱에 로컬 프록시 주소를 알려주는 기능이지, 모든 프로세스의 데이터를 강제로 전달하는 기능은 아닙니다. 별도 프록시 설정을 사용하는 브라우저, 명령줄 프로그램, 일부 데스크톱 앱은 이를 무시할 수 있습니다. 특정 앱을 수동으로 설정하려면 ‘매개변수 설정’에서 로컬 수신 포트와 해당 포트가 지원하는 프로토콜을 확인하세요. 앱의 로컬 프록시 주소 입력란에 서버 주소를 넣지 마세요.

시스템 프록시를 읽지 않는 앱이 실제로 있을 때 TUN 사용을 검토하세요. 먼저 기존 시스템 프록시 상태를 기록합니다. 기기 권한이 허용되는 범위에서 클라이언트 안내에 따라 TUN을 켜세요. 관리자 권한이 필요하다는 메시지가 명확히 표시되면 작업 내용을 저장하고 종료한 뒤 필요한 권한으로 다시 실행하세요. 모든 작업에 장기간 권한 상승 상태를 사용하는 것은 피해야 합니다. 테스트 중에는 다른 가상 네트워크 도구를 동시에 켜지 말고 일반 웹 페이지와 로컬 서비스를 먼저 확인한 뒤 대상 앱을 테스트하세요. 문제가 생기면 TUN을 끄고 다시 확인하면 가상 인터페이스, 라우팅 처리, 기존 연결 중 어디에서 문제가 발생했는지 파악하는 데 도움이 됩니다.

로그에 주소가 이미 사용 중이라고 표시되면 먼저 트레이에 이전 인스턴스가 남아 있거나 수동으로 실행한 코어 프로세스가 있는지 확인하세요. 어떤 프로그램이 포트를 사용하는지 불확실하다면 사용하지 않는 다른 로컬 포트로 바꾸고, 수동으로 연결한 앱의 설정도 함께 변경할 수 있습니다. 정체를 모르는 시스템 프로세스를 종료하지 마세요. 포트를 바꾼 뒤에는 브라우저에 이전 주소가 남아 있지 않은지도 확인하세요. 코어가 새 포트에서 정상적으로 대기 중이어도 브라우저가 계속 이전 포트로 요청을 보낼 수 있습니다.

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

칩에 맞는 파일을 다운로드하고 응용 프로그램 폴더에서 실행하세요

Apple 메뉴에서 ‘이 Mac에 관하여’를 열어 확인하세요. Apple 칩이 표시되는 기기는 macOS 다운로드에서 arm64를, Intel 프로세서가 표시되는 기기는 x64를 선택합니다. 두 설치 파일은 아키텍처가 다르므로 여러 파일을 설치해 보며 판단하지 마세요. 디스크 이미지를 열고 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 디스크 이미지 창에서 계속 실행하면 이미지를 꺼낸 뒤 기존 실행 경로를 사용할 수 없고, 업데이트할 때 이전 복사본을 잘못 열기도 쉽습니다. 기존 클라이언트가 있다면 정상적으로 종료한 뒤 교체하세요.

시스템에서 앱을 열 수 없다는 메시지가 표시되면 앱 출처 관련 안내인지, 시스템 버전이 맞지 않는다는 뜻인지, 파일 자체를 열 수 없다는 뜻인지 먼저 확인하세요. 출처 안내와 아키텍처 문제는 서로 다른 점검 항목입니다. 다른 아키텍처의 설치 파일을 받아도 출처 문제는 해결되지 않습니다. 출처와 파일 유형을 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에 해당 앱 관련 안내가 있는지 살펴보고 기기 관리 정책에 따라 처리하세요. 관리형 컴퓨터에 제한이 있다면 관리자에게 문의하세요. 설치를 위해 기기 전체의 보호 기능을 끄는 것은 권장하지 않습니다.

그룹을 가져온 뒤 두 단계의 상태 변화를 확인하세요

v2rayN의 ‘구독 그룹’에서 그룹 설정을 열고 주소를 추가해 저장하세요. 목록으로 돌아와 새 그룹으로 전환한 다음 업데이트를 실행합니다. 첫 번째로 그룹에 예상한 항목이 표시되는지 확인하고, 두 번째로 항목을 활성 서버로 지정한 뒤 코어가 정상적으로 시작되는지 확인하세요. 다른 컴퓨터에서 여러 그룹을 옮겨온다면 처음에는 하나만 가져오세요. 시작부터 여러 노드 이름과 라우팅 규칙이 섞이면 원인을 파악하기 어렵습니다. 프로토콜 필드를 조정하기 전에는 서비스 제공자가 준 원래 설정을 사용 중인지 확인하세요. 서버의 전송 및 보안 매개변수는 클라이언트 쪽에서만 바꿔 맞출 수 없습니다.

구독 응답을 받았는데도 항목이 없다면 클라이언트가 지원하는 구독 콘텐츠인지 확인하세요. 계정 로그인 페이지나 서비스 관리 화면의 공유 페이지가 아닌지 살펴보세요. 단일 노드를 복사했다면 클립보드에서 가져오고, 그룹 주소를 복사했다면 구독 메뉴를 사용하세요. 노드 하나만 시작되지 않고 같은 그룹의 다른 항목은 정상이라면 해당 항목의 프로토콜과 코어 지원 범위를 비교하세요. 그룹 전체를 삭제할 필요는 없습니다. 자세한 추가 및 업데이트 순서는 데스크톱 및 Android 구독 가져오기 안내를 참고하세요.

프록시 설정은 기기가 아니라 네트워크 서비스에 따라 달라질 수 있습니다

코어가 시작되면 클라이언트에서 ‘시스템 프록시 자동 구성’을 선택하고 현재 활성 연결을 확인하세요. 시스템 설정에서는 보통 ‘시스템 설정 → 네트워크 → 현재 네트워크 서비스 → 세부사항 → 프록시’ 순서로 확인할 수 있습니다. Wi-Fi와 유선 네트워크가 서로 다른 네트워크 서비스로 설정되어 있을 수 있습니다. 도킹 스테이션을 연결하거나 분리한 뒤에는 클라이언트가 계속 실행 중이어도 실제 프록시 설정이 달라질 수 있습니다. 시스템에서 원래 자동 프록시 구성을 사용했다면 설정 방식을 기록하고, 출처를 모르는 수동 프록시 주소를 동시에 남겨두지 마세요.

브라우저는 정상인데 특정 명령줄 도구가 작동하지 않는다면 해당 도구가 시스템 프록시를 읽는지 먼저 확인하세요. 읽지 않는 도구라면 자체 프록시 옵션으로 테스트할 수 있습니다. 시스템 프록시로 연결되지 않는 프로그램을 처리해야 하고 현재 설치 파일이 TUN을 제공하는 경우에만 안내에 따라 권한을 허용하고 켜세요. 브라우저, LAN 서비스, 잠자기 후 깨어났을 때의 연결 상태를 함께 확인하세요. 깨어난 뒤 문제가 생기면 앱을 재설치하기 전에 선택한 모드를 껐다가 다시 켜고 로그에서 연결이 다시 설정되는지 살펴보세요.

종료하기 전에는 원래 프록시 설정을 복구하고 TUN을 끈 다음 앱 메뉴에서 완전히 종료하는 것이 좋습니다. 창을 닫는 것과 앱을 종료하는 것은 다를 수 있습니다. 앱이 종료된 뒤에도 웹 페이지가 열리지 않으면 현재 네트워크 서비스의 ‘프록시’에서 로컬 주소가 남아 있는지 확인하세요. 복구 전에 현재 상태를 기록하고, 복구한 뒤 같은 테스트 페이지에 새로 요청을 보내세요. 직접 연결도 실패한다면 Wi-Fi에 다시 인증해야 하는지, 원래 네트워크에 변화가 있었는지 확인하세요.

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

배포판, 패키지 형식, 아키텍처를 모두 확인하세요

Linux 다운로드에서 배포판에 맞는 패키지를 선택하세요. Ubuntu, Debian 및 파생 데스크톱 시스템은 주로 deb를 사용하고, Fedora 등 rpm을 사용하는 시스템은 rpm을 선택합니다. 패키지 형식을 확인한 다음 아키텍처를 확인하세요. x86_64는 다운로드 페이지의 x64, aarch64는 arm64에 해당합니다. 가상 머신에 설치한 데스크톱 시스템이라면 가상 머신 안에서 확인하고 호스트 컴퓨터의 정보를 그대로 사용하지 마세요. 일부 컨테이너와 호환 환경에서는 사용자 공간 아키텍처가 호스트 환경과 다를 수 있습니다.

uname -m
cat /etc/os-release

대상 시스템에서 위 두 명령을 실행해 기기 아키텍처와 배포판 정보를 각각 확인하세요. 그래픽 소프트웨어 설치 도구가 있다면 다운로드한 패키지를 열고 화면에 표시되는 의존성 안내를 확인하세요. 해당 그래픽 도구가 없다면 배포판의 기본 패키지 관리자로 로컬 패키지를 설치하고, 다운로드가 완료된 실제 파일 경로를 사용하세요. 의존성 누락으로 설치가 실패하면 먼저 배포판 버전과 활성화된 소프트웨어 저장소를 확인하세요. 다른 배포판의 라이브러리 파일을 섞어 사용하지 마세요. 처음 실행할 때는 데스크톱 메뉴에서 v2rayN을 검색하세요. 실행 후 창이 보이지 않으면 트레이와 앱 로그를 확인해 프로그램이 백그라운드에서 실행 중인지, 시작에 실패했는지 구분하세요.

그룹 하나와 앱 하나로 먼저 확인하세요

‘구독 그룹’을 열어 주소를 추가하고 용도를 알 수 있도록 메모를 작성하세요. 저장한 뒤 업데이트하고 활성 서버를 지정합니다. 업데이트가 실패하면 로그에 가져오기 실패가 표시되는지, 파싱 실패가 표시되는지 기록하세요. 명령줄이 구독 주소에 접근할 때 다른 프록시에 의존하고 클라이언트의 직접 업데이트는 작동하지 않는다면 두 요청은 서로 다른 경로를 사용합니다. 이러한 환경 차이를 먼저 기록한 뒤 업데이트 방법을 바꾸세요. 터미널에서 같은 주소에 접근할 수 있다는 이유만으로 클라이언트도 반드시 가져올 수 있다고 단정하지 마세요.

데스크톱 시스템 프록시의 동작은 데스크톱 환경과 앱이 프록시를 읽는지에 따라 달라집니다. GNOME이나 KDE의 네트워크 프록시 설정을 확인 지점으로 삼을 수 있지만 셸, 백그라운드 서비스, 격리 환경에서 실행되는 일부 데스크톱 앱은 같은 설정을 사용하지 않을 수 있습니다. 먼저 프록시 설정을 읽는 것이 확인된 그래픽 앱 하나로 테스트하세요. 그런 다음 명령줄에서 별도로 테스트해 두 환경을 혼동하지 마세요. 다음 예시는 10808이 클라이언트에서 사용 가능한 로컬 SOCKS 포트임을 확인했다고 가정합니다. 테스트 전에 자신의 ‘매개변수 설정’을 확인하세요.

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

이 명령은 이번 요청에만 프록시를 지정하며, socks5h는 도메인 조회를 프록시 쪽에서 처리합니다. 로그인 환경은 변경하지 않습니다. 응답을 받으면 로컬 접속 경로를 통해 이번 요청이 처리된다는 뜻입니다. 모든 데스크톱 트래픽이 연결되었다거나 특정 라우팅 규칙이 적용되었다는 뜻은 아닙니다. 연결이 거부되면 코어 실행 여부와 포트가 일치하는지 먼저 확인하세요. 로컬 포트에는 연결됐지만 요청 시간이 초과된다면 활성 설정과 관련 로그를 확인하세요. 문제를 해결하려고 시스템 시작 스크립트에 전역 환경 변수를 먼저 추가하지 마세요.

TUN이 필요할 때만 가상 인터페이스와 권한을 확인하세요

TUN은 보통 가상 인터페이스를 만들고 라우팅을 변경해야 하므로, 사용 가능 여부는 시스템 환경과 클라이언트의 권한 설정에 달려 있습니다. 로그에 장치를 사용할 수 없거나 권한이 부족하다고 표시되면 먼저 컨테이너, 가상 머신, 제한된 세션 중 어디에서 실행 중인지 확인하고 해당 설치 파일의 안내에 따라 처리하세요. 데스크톱 세션 전체를 높은 권한으로 실행하거나 문제 해결을 위해 기존 라우팅과 방화벽 설정을 지우지 마세요. 기업 네트워크 도구를 사용 중이라면 먼저 관리 정책을 확인하세요. 앱 하나만 연결하면 된다면 되돌리기 쉬운 로컬 프록시가 더 적합할 수 있습니다.

일상적인 사용이 안정된 것을 확인한 뒤 로그인 후 자동 실행 설정을 고려하세요. 데스크톱 자동 실행은 사용자가 로그인한 세션에서 앱을 시작하는 기능이지, 기기를 켜자마자 모든 사용자의 트래픽을 처리하는 기능이 아닙니다. 먼저 수동으로 실행해 구독, 포트, 프록시 설정을 확인한 다음 자동 실행 항목 하나를 추가하세요. 로그인 후 포트 충돌이 발생하면 데스크톱 자동 실행 항목과 기존 서비스가 모두 프로그램을 시작하는지 확인하세요. 관리하기 쉬운 실행 경로 하나만 남기면 됩니다.

Android: v2rayNG 설치, 구독 및 VPN 연결

v2rayNG를 우선 사용하고 시스템 지원에 맞는 설치 파일을 선택하세요

Android 다운로드에서 v2rayNG를 우선 선택하세요. 기존 설정에 V2Fly 코어가 필요하다는 것을 확인한 경우에만 대안인 v2flyNG를 살펴보세요. 비교적 최신 기기는 대부분 arm64 패키지로 시작할 수 있지만, 설치 가능 여부는 시스템 사용자 공간이 해당 아키텍처를 지원하는지에도 달려 있습니다. 프로세서 하드웨어만 보고 판단하지 마세요. 시스템에서 아키텍처가 맞지 않는다고 명확히 안내하고 다운로드 페이지에 범용 버전이 있다면 범용 패키지를 시도할 수 있습니다. 기존 앱과 패키지가 충돌한다는 메시지가 표시되면 아키텍처를 계속 바꾸기보다 설치된 앱의 출처와 업데이트 방식을 먼저 확인하세요.

다운로드한 설치 파일을 열고 현재 설치 출처에 필요한 권한을 시스템 안내에 따라 설정하세요. 자녀 보호 기능, 업무용 프로필 또는 회사 정책으로 휴대전화 사용이 제한되어 있다면 먼저 기기 관리 요구 사항을 확인하세요. 기존 앱과 설치 파일이 충돌하더라도 바로 앱을 삭제하지 마세요. 삭제하면 로컬 그룹, 사용자 지정 규칙, 앱별 설정까지 함께 사라질 수 있습니다. 내보낼 수 있는 내용을 먼저 백업하고 구독 주소를 다시 확인할 수 있는지 확인한 뒤 이전 여부를 결정하세요. 처음 실행할 때는 기본 설정을 마친 뒤 자동 연결과 백그라운드 상시 실행은 켜지 말고 단계별로 확인하세요.

구독 그룹을 추가하고 업데이트한 다음 노드를 선택하세요

v2rayNG 메뉴를 열고 ‘구독 그룹 설정’으로 이동해 메모와 구독 주소를 추가하고 저장하세요. 목록으로 돌아온 뒤 메뉴에서 ‘구독 업데이트’를 선택해 항목을 가져옵니다. 버전에 따라 화면 배치가 달라질 수 있으므로 메뉴 이름을 기준으로 찾으세요. 업데이트가 끝나면 해당 그룹으로 전환하고 노드 하나를 선택해 현재 선택 상태를 확인하세요. 공유 링크만 있다면 ‘클립보드에서 가져오기’ 또는 ‘QR 코드 스캔’을 사용하고 단일 링크를 구독 주소로 추가하지 마세요. 메신저 대화에서 긴 주소를 복사했다면 입력란에 첫 번째 줄만 복사되지는 않았는지 확인하세요.

업데이트 오류가 발생하면 먼저 현재 네트워크에서 추가 웹 로그인이 필요한지 확인한 다음 서버 접속 실패인지 콘텐츠 파싱 실패인지 살펴보세요. Wi-Fi에서는 업데이트되지만 모바일 데이터에서는 안 된다면 같은 기기와 주소로 두 네트워크의 결과를 비교하세요. 코어, 구독, 노드를 한꺼번에 바꾸지 마세요. 목록에서 항목이 갑자기 줄었다면 현재 선택한 그룹, 필터 조건, 서버 콘텐츠가 변경됐는지 확인하세요. 사용 가능한 기존 항목을 보존한 뒤 삭제하고 다시 추가할지 결정하세요.

VPN 연결 요청을 허용한 뒤 앱이 연결 대상에 포함됐는지 확인하세요

연결 버튼을 누르면 보통 처음에는 시스템의 VPN 연결 요청이 표시됩니다. 현재 실행한 클라이언트가 보낸 요청인지 확인한 뒤 허용하세요. 이 기능은 시스템 VPN 인터페이스를 사용해 기기 트래픽을 연결하므로 데스크톱의 ‘시스템 프록시’ 메뉴를 그대로 따라 하거나 데스크톱 로컬 포트를 휴대전화 Wi-Fi 프록시 입력란에 넣을 필요가 없습니다. 시스템에 연결 아이콘이 나타나면 인터페이스가 설정된 것입니다. 브라우저에서 실제 페이지를 열어 연결을 확인하세요. 다른 VPN이 실행 중이라는 안내가 표시되면 시스템 VPN 설정을 확인하세요. 기기 정책이 허용한다면 충돌하는 연결을 끊고 테스트하세요.

브라우저는 정상인데 특정 앱이 예상대로 연결되지 않는다면 클라이언트 설정의 ‘앱별 프록시’와 현재 목록의 적용 방식을 확인하세요. 선택한 앱만 포함하는 모드와 선택한 앱을 제외하는 모드가 있습니다. 먼저 설명하기 쉬운 한 가지 모드로 설정을 되돌리고 대상 앱을 다시 여세요. 이전 연결이 계속 재사용되지 않도록 해야 합니다. 업무용 프로필과 개인 프로필의 같은 앱도 서로 다른 설정 범위에 속할 수 있습니다. 아이콘만 보고 판단하지 말고 실제 사용하는 프로필에서 테스트하세요.

클라이언트를 종료한 뒤에만 네트워크가 복구되지 않는다면 시스템 VPN 설정에서 해당 앱에 ‘항상 켜짐’ 또는 ‘VPN 없이 연결 차단’이 켜져 있는지 확인하세요. 이는 그룹에 노드가 있는지와 무관한 시스템 정책입니다. 개인 기기라면 필요에 따라 기존 설정을 복구할 수 있습니다. 관리 대상 기기에서는 원래 정책을 따르세요. 클라이언트를 바꿀 때는 새 앱에 권한을 주기 전에 이전 연결과 관련 정책이 계속 적용 중인지 확인하세요. 이전 정책으로 발생한 인터넷 끊김을 새 앱의 설치 실패로 오해할 수 있습니다.

라우팅 및 DNS: 연결 방식과 분할 규칙

트래픽이 클라이언트에 들어왔는지부터 확인하세요

시스템 프록시와 TUN은 앱 트래픽이 클라이언트로 들어오는 방식을 결정하고, 라우팅 규칙은 들어온 트래픽이 어떤 출구로 나갈지를 결정합니다. 앱이 시스템 프록시를 읽지 않는다면 라우팅 목록을 바꿔도 클라이언트에 연결되지 않습니다. 반대로 연결된 트래픽이 직접 연결 규칙과 일치하면 원격 노드를 거치지 않는 것이 정상일 수 있습니다. 문제를 확인할 때는 로컬 포트를 사용한다고 확인된 앱 하나로 테스트한 뒤 시스템 프록시나 TUN에서의 동작을 비교하세요. ‘라우팅 모드 전환’과 ‘시스템 프록시 전환’을 같은 기능으로 생각하지 마세요.

데스크톱에서 TUN을 켤 때는 로컬 서비스, 가상 네트워크 어댑터, 다른 네트워크 도구에 주의하세요. 관리 페이지, LAN 기기, 일부 가상 머신 네트워크는 기존 규칙에 따라 직접 연결해야 할 수 있습니다. 먼저 해당 주소에 원래 어떻게 접속했는지 기록하세요. TUN을 켠 뒤 로컬 서비스에 연결할 수 없다면 TUN을 끄고 다시 확인해 연결 범위가 바뀐 것인지 확인한 다음 규칙을 조정할지, 앱별 프록시를 사용할지 결정하세요. 원래 클라이언트가 처리하지 않던 트래픽까지 연결되기 시작했다면 관련 없는 규칙을 대량으로 추가하지 말고 매칭 범위를 확인하세요.

도메인, 주소, 포트로 규칙 범위를 좁히세요

v2rayN에서 ‘라우팅 설정’을 열고 현재 어떤 규칙을 사용 중인지 확인하세요. 편집하기 전에는 원래 설정을 보존하고, 복사할 수 있다면 사본을 수정하세요. 호스트 이름으로 대상에 접근하는 경우 도메인 매칭이 적합하고, 대상이 주소로 직접 표시되거나 정책에 따라 이미 주소로 해석된 경우에는 주소 매칭이 적합합니다. 앱 요청은 웹페이지 도메인뿐 아니라 API 도메인, 정적 리소스 도메인, 리디렉션된 호스트 이름을 사용할 수 있습니다. 재현할 수 있는 요청 하나를 기준으로 클라이언트에 들어올 때 표시되는 대상을 확인한 뒤 적절한 조건을 선택하세요.

일반적으로 구체적인 예외 규칙을 더 넓은 매칭 규칙보다 앞에 두세요. 요청이 앞선 규칙과 일치하면 뒤의 예외 규칙을 확인하지 않습니다. 목록 앞부분에 범위가 지나치게 넓은 기본 규칙을 두지 마세요. 특정 서비스를 매칭하려고 흔히 쓰이는 포트만으로 판단하지도 마세요. 같은 포트를 관련 없는 여러 서비스가 사용할 수 있습니다. 규칙을 편집한 뒤 지정한 출구가 실제로 있는지 확인하세요. 그래픽 인터페이스의 직접 연결 또는 프록시 이름은 설정의 출구 태그와 연결되어 있습니다. 이 기기에 정의되지 않은 태그를 다른 설정에서 복사하지 마세요.

routing.domainStrategy의 일반적인 값
값라우팅 매칭에 미치는 영향
AsIs매칭 규칙을 위해 대상 도메인을 추가로 조회하지 않습니다. 이미 확인된 주소는 주소 규칙에 매칭될 수 있습니다.
IPIfNonMatch원래 대상이 매칭되지 않았을 때 도메인을 조회하고 조회한 주소로 매칭을 시도합니다.
IPOnDemand매칭 과정에서 주소 조건을 확인해야 할 때 대상 도메인을 먼저 조회할 수 있습니다.

이 값은 코어가 라우팅을 판단할 때 도메인을 언제 조회할지 제어하며, 앱의 DNS 조회가 반드시 코어의 DNS를 사용한다는 뜻은 아닙니다. 앞선 와일드카드 규칙이 이미 요청을 처리했다면 IPIfNonMatch가 주소 규칙을 계속 확인할 것이라고 기대할 수 없습니다. 직접 설정하기 전에 현재 클라이언트에서 사용하는 코어와 버전이 해당 값을 지원하는지 확인하세요. 먼저 도메인 규칙과 주소 규칙 중 어떤 요청이 각각에 매칭되는지 살펴본 뒤 전략의 차이를 비교하세요. 이 필드를 일반적인 연결 스위치처럼 사용하지 마세요.

DNS를 설정한 뒤 같은 요청으로 경로를 확인하세요

특정 도메인만 열리지 않고 다른 사이트는 정상이라면 먼저 DNS 조회 실패, 적합하지 않은 주소를 얻은 경우, 주소는 얻었지만 연결이 실패한 경우를 구분하세요. 브라우저가 자체 보안 DNS를 사용할 수 있고 명령줄은 시스템 리졸버를 사용할 수 있으므로 조회 결과가 서로 다를 수 있습니다. 테스트할 때는 앱과 네트워크를 그대로 두고 DNS 또는 라우팅 설정 하나만 바꿔 비교하세요. 코어 DNS를 조정하려면 먼저 DNS 분할 조회 설정 안내를 확인한 뒤 도메인별로 어떤 리졸버를 사용할지 정하세요.

규칙을 저장한 뒤 새 요청을 보내세요. 기존 연결이 재사용되면 변경 사항이 적용되지 않을 수 있습니다. 매칭 정보가 표시되면 대상, 규칙, 출구를 비교하세요. 표시되지 않는다면 직접 연결되어야 하는 로컬 대상 하나와 프록시를 통해야 하는 대상 하나를 각각 테스트하세요. 한쪽만 실패하면 해당 매칭 조건과 출구를 확인하고 둘 다 실패하면 연결 계층을 다시 살펴보세요. 성공한 뒤에는 새 규칙의 용도를 메모하세요. 나중에 문제를 확인할 때 어느 줄이 잘못됐는지 추측하지 않고 해당 변경 전체를 되돌릴 수 있습니다.

설정 관련 자주 묻는 질문: 오류 위치로 원인 찾기

업데이트 실패: 콘텐츠를 가져왔는지부터 확인하세요

요청 시간 초과, 도메인 조회 실패, 서비스의 접근 거부, 콘텐츠 파싱 실패는 각각 해결 방법이 다릅니다. 시간 초과가 발생하면 현재 네트워크에서 직접 연결이 가능한지 확인한 뒤 업데이트 작업이 직접 가져오기를 사용하는지, 프록시를 통한 가져오기를 사용하는지 확인하세요. 접근 거부나 주소가 만료되었다는 안내가 표시되면 구독 서비스의 접속 경로에서 주소와 계정 상태를 확인하세요. 짧은 간격으로 계속 재시도하지 마세요. 응답은 성공했지만 파싱할 수 없다면 먼저 반환된 콘텐츠가 지원되는 구독 형식인지 확인하세요. 로그인 페이지나 서비스 안내 페이지는 정상적으로 열리더라도 가져올 수 있는 노드 목록이 아닙니다.

업데이트 후 일부 서비스는 항목의 이름, 순서, 개수를 바꿀 수 있습니다. 같은 이름이 보인다고 이전 항목이 계속 작동한다고 단정하지 마세요. 목록이 비어 있다고 바로 서비스가 중단됐다고 판단하지도 마세요. 먼저 검색 필터를 해제하고 올바른 그룹으로 전환한 뒤 업데이트 로그와 실제 항목을 확인하세요. 업데이트로 활성 설정이 바뀌었다면 사용할 노드를 다시 선택하세요. 기존 설정을 보존해야 한다면 업데이트 전에 백업하세요. 네트워크와 설정이 동시에 바뀌어 비교할 자료가 없어지는 일을 막을 수 있습니다.

코어가 시작되지 않을 때: 첫 번째 유효 오류부터 해결하세요

기본 화면의 로그를 열고 연결을 누르거나 노드를 전환한 뒤 처음 표시되는 오류를 살펴보세요. 포트 충돌은 중복 실행 인스턴스와 설정된 포트를 확인하고, 코어 구성 요소를 찾을 수 없다는 오류는 설치가 완전한지와 프로그램을 올바른 위치에서 실행했는지 확인하세요. 프로토콜 매개변수를 인식할 수 없다면 그룹 항목의 전송 및 보안 옵션이 현재 코어와 맞는지 확인하세요. 클라이언트가 계속 재시도하면 비슷한 로그가 많이 쌓입니다. 이후의 연결 실패는 첫 번째 오류의 결과일 수 있습니다. 로컬 수신에 실패했다고 원격 설정부터 바꾸지 마세요.

사용자 지정 설정만 시작되지 않는다면 먼저 이전에 작동한 클라이언트 기본 가져오기 항목으로 전환하세요. 기본 항목이 작동하면 사용자 지정 필드, 참조 태그, 코어 호환성으로 원인을 좁힐 수 있습니다. 둘 다 실패하면 프로세스 권한과 로컬 포트를 확인하세요. 설정 조각을 복사할 때는 일부 설정만 포함된 내용인지, 바로 실행할 수 있는 전체 설정인지 확인하세요. 보안 매개변수가 불확실하다면 하나씩 검증 기능을 끄며 시험하지 말고 설정 제공자에게 서로 호환되는 값을 확인하세요.

연결됐는데 앱이 작동하지 않음: 같은 경로를 사용하는지 확인하세요

브라우저가 접속된다고 해서 다른 앱도 같은 연결 경로를 사용하는 것은 아닙니다. 먼저 문제가 있는 앱이 시스템 프록시를 읽는지, Android 앱별 설정에서 제외됐는지, 격리된 세션에서 실행 중인지 확인하세요. 대상 하나만 실패하면 해당 도메인의 조회 결과와 라우팅 매칭을 살펴보세요. 모든 대상이 실패하면 활성 서버와 로컬 접속 경로를 먼저 확인하세요. 같은 앱에서 새 요청을 보내고 네트워크가 바뀌었는지도 기록하세요. 이전 스크린샷의 연결 상태를 근거로 현재 기기의 실제 경로를 추측하지 마세요.

네트워크를 바꿨을 때만 실패한다면 현재 네트워크에서 테스트 페이지에 직접 접속할 수 있는지, 로그인 인증이 필요한지 먼저 확인하세요. 클라이언트를 시작하기 전부터 발생한 문제일 수 있습니다. 일반 웹 페이지는 계속 정상인데 특정 앱만 시간 초과가 발생한다면 해당 앱이 사용하는 프로토콜과 연결 모드를 비교하세요. 예를 들어 앱이 UDP에 의존한다면 현재 클라이언트의 접속 경로, 노드 설정, 원격 서버가 모두 해당 트래픽을 처리할 수 있는지 확인해야 합니다. 로컬 옵션 하나를 켰다고 전체 경로가 UDP를 지원한다는 뜻은 아닙니다.

지연 시간 테스트는 성공했는데 앱이 열리지 않는 이유는 무엇인가요?

지연 시간 테스트는 보통 테스트 대상이나 연결 단계만 확인합니다. 문제가 있는 앱이 클라이언트 접속 경로를 사용하는지 확인한 다음 앱이 실제로 접속하는 도메인과 출구를 살펴보세요. 테스트와 앱의 대상이 다르면 결과도 다를 수 있습니다.

종료 후에도 인터넷이 끊기는데 다시 설치해야 하나요?

보통은 시스템 프록시, TUN, 시스템 VPN 정책이 남아 있는지 먼저 확인하세요. 원래 설정을 복구한 뒤 같은 페이지를 직접 연결해 테스트하세요. 앱을 종료한 뒤에만 네트워크 상태가 문제가 된다면 재설치가 첫 번째 조치는 아닙니다.

그룹 하나에 문제가 생기면 클라이언트 데이터를 모두 지워야 하나요?

다른 그룹은 보존하고 문제가 있는 그룹의 주소와 업데이트 결과를 확인하세요. 별도 그룹에서 문제가 재현되는지 확인한 뒤 해당 그룹만 처리하세요. 전체 데이터를 지우는 것으로 원인 확인을 대신하지 마세요.

원인을 찾기 어렵다면 재현 가능한 상황을 한 문장으로 정리하세요. 어떤 운영체제와 클라이언트에서 어떤 연결 방식을 사용했고, 어떤 작업을 했을 때 어떤 오류가 발생했는지 적습니다. 최근 업데이트나 네트워크 변경 여부를 덧붙이고 민감 정보를 가린 첫 오류도 기록하세요. 한 화면 분량의 긴 스크린샷보다 이런 정보가 구독 가져오기, 코어 시작, 트래픽 연결, 규칙 출구 중 어디에서 문제가 생겼는지 판단하는 데 더 유용합니다.

업데이트 및 복구: 사용할 수 있는 설정과 되돌리기 절차 보존

클라이언트 업데이트, 코어 변경, 구독 업데이트를 구분하세요

클라이언트 업데이트는 인터페이스와 로컬 동작을 바꿀 수 있고, 코어 변경은 프로토콜, 전송 방식, 라우팅 필드의 지원 여부에 영향을 줄 수 있습니다. 구독 업데이트는 서비스에서 제공하는 항목을 바꿉니다. 이 세 작업은 같은 화면에 있어도 서로 다릅니다. 새 노드를 받으려면 해당 구독 그룹만 업데이트하면 됩니다. 클라이언트 문제를 해결하려면 현재 설치 유형과 연결 방식을 기록한 뒤 클라이언트 다운로드 페이지에서 같은 플랫폼과 아키텍처의 파일을 선택하세요. 설치 유형까지 바뀐다면 마이그레이션으로 간주하고 기존 위치에 그대로 덮어쓸 수 있다고 가정하지 마세요.

업데이트 전에 정상적으로 연결되는 설정을 하나 보존하고 시스템 프록시 상태, 활성 코어, 수신 포트, 라우팅 규칙 이름, 로그인 시 자동 실행 여부를 기록하세요. 클라이언트에 백업 기능이 있다면 용도를 구분해 로컬에 저장하고 예상한 경로에서 복원할 수 있는지 확인하세요. 백업은 프로그램 파일만을 뜻하지 않습니다. 구독 그룹과 규칙은 보통 사용자 데이터이며 프로그램은 별도로 설치할 수 있습니다. 백업을 보관하기 전에 주소에 인증 정보가 포함되어 있는지 확인하세요. 문의용 로그와 함께 제출하거나 공개적으로 접근 가능한 위치에 두지 마세요.

프로그램을 먼저 확인하고 사용자 지정 설정은 나중에 복원하세요

업그레이드하거나 기기를 바꾸기 전에 사용 중인 프록시를 끄고 이전 인스턴스를 정상 종료한 뒤 새 패키지를 설치하세요. 실행 후 인터페이스가 열리는지, 코어가 시작되는지 확인합니다. 그다음 확인된 설정 하나로 앱 하나를 테스트하세요. 통과하면 추가 그룹, 규칙, TUN, 앱별 필터를 복원합니다. 한 번에 한 종류씩 복원하세요. 기본 환경에서는 연결되는데 특정 라우팅 규칙을 복구한 뒤 실패한다면 규칙을 확인할 수 있어 마이그레이션 데이터 전체에서 문제를 찾지 않아도 됩니다.

데스크톱 운영체제를 업그레이드한 뒤에는 기존 네트워크 서비스 이름, 시스템 프록시, 가상 인터페이스 권한을 다시 확인하세요. Android 기기를 바꾼 뒤에는 VPN 권한, 백그라운드 제한, 업무용 및 개인용 프로필의 앱 적용 범위를 확인하세요. 이전 기기의 데이터를 성공적으로 가져왔어도 구독을 가져오는 것만으로 새 기기가 같은 시스템 권한을 얻지는 않습니다. 먼저 앱을 사용 중인 상태에서 연결을 확인한 뒤 절전 모드에서 깨어났을 때나 화면을 잠갔을 때도 테스트하세요. 두 상황이 모두 예상대로 작동한 뒤에만 자동 연결이나 장시간 백그라운드 실행을 켜세요.

작은 범위부터 단계적으로 되돌리세요

규칙을 바꾼 뒤 문제가 생겼다면 이전 규칙 집합으로 되돌리세요. TUN을 사용하기 시작한 뒤 문제가 생겼다면 TUN을 끄고 이전에 확인한 연결 방식으로 돌아가세요. 수신 포트를 바꾼 뒤 일부 앱만 실패한다면 해당 앱의 로컬 프록시 주소를 먼저 수정하세요. 되돌린 뒤 원래 테스트를 다시 실행하세요. 복구됐다면 구독과 앱 데이터를 함께 삭제하지 마세요. 방금 변경한 항목만 따로 기록해 필요할 때 다시 시도하세요. 새 환경과 기존 환경이 실제로 호환되지 않고 백업도 사용할 수 있는 경우에만 재설치나 기존 설정 삭제를 고려하세요.

인터넷이 끊길 때마다 시스템 네트워크 설정을 초기화하는 것은 적절한 해결 방법이 아닙니다. 클라이언트를 종료한 뒤에도 시스템에 문제가 남으면 활성화 전 기록한 프록시 설정을 먼저 복구하고 계속 적용 중인 VPN 정책이 있는지 확인하세요. 설정을 복구했는데도 직접 접속할 수 없다면 현재 네트워크를 점검하세요. 회사나 학교에서 제공한 설정은 관리자 요구 사항에 맞게 복구해야 합니다. 앱을 제거해야 한다면 먼저 실행 중인 인스턴스를 종료하고 네트워크 설정을 복구한 다음 필요한 사용자 데이터를 보존하세요. 이후 시스템의 앱 관리 기능으로 프로그램을 제거하면 기존 프록시가 사라진 포트를 계속 가리키는 일을 막을 수 있습니다.

자주 쓰는 설정을 간단한 기록으로 남기고 필수 항목과 선택 항목을 구분하세요. 예를 들어 현재 그룹, 활성 코어, 단일 앱 테스트용 접속 경로는 필수 항목이고 로그인 시 자동 실행과 추가 규칙은 선택 항목입니다. 다음에 새 기기를 설정할 때는 사용 가이드의 연결 절차에 따라 필수 항목부터 확인한 다음 이 페이지에서 필요한 설정을 찾으세요. 생소한 필드가 있다면 용어 설명을 확인하세요. 메뉴 위치를 기억하려고 오래되어 부정확해질 수 있는 인터페이스 스크린샷을 통째로 보관할 필요는 없습니다.