문제 해결 / 증상별 설정 확인

V2Ray 자주 묻는 질문
구독 및 연결 문제 해결

문제가 발생한 계층을 먼저 확인한 다음 관련 설정을 변경하세요. 문제를 펼쳐 순서대로 확인할 수 있습니다. 메뉴 이름은 클라이언트 버전에 따라 조금씩 다를 수 있습니다.

v2rayN v2rayNG v2flyNG

개념부터 확인

기본 개념

클라이언트, 코어, 설정 출처, 트래픽 처리 방식을 구분하세요.

V2Ray, v2rayN, v2rayNG는 각각 어떤 프로그램인가요?

먼저 코어와 인터페이스를 구분해야 합니다. V2Ray는 Project V 기술 생태계에 속하며, V2Fly와 Xray는 프로토콜 처리, 라우팅, 네트워크 연결을 담당하는 관련 코어 계열입니다. v2rayN은 데스크톱 그래픽 클라이언트이고 v2rayNG는 Android 그래픽 클라이언트로, 설정을 가져오고 연결을 관리합니다. v2flyNG는 V2Fly 코어를 사용하는 Android 대안입니다. 클라이언트를 설치해도 서버 설정이 자동으로 제공되는 것은 아닙니다. 사용할 권한이 있는 구독 주소나 공유 링크를 가져온 뒤 서비스 제공자의 안내에 따라 연결해야 합니다.

구독 주소, 노드 공유 링크, 설치 파일은 어떻게 다른가요?

링크 모양이 아니라 용도를 확인하세요. 설치 파일은 클라이언트를 설치할 때 사용하고, 노드 공유 링크에는 서버 설정 하나가 담겨 있으며, 구독 주소로는 여러 서버 설정을 가져오고 업데이트할 수 있습니다. 구독 주소를 단일 노드 가져오기 메뉴에 붙여 넣으면 형식을 인식하지 못할 수 있습니다. 웹 로그인 주소를 구독 주소로 입력하면 웹페이지 내용만 가져올 수도 있습니다. 현재 클라이언트에 맞는 구독 링크를 서비스 제공자에게 받아 구독 그룹 설정에 입력하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 공개 게시판에 올리거나 출처가 불분명한 변환 서비스에 입력하지 마세요.

시스템 프록시, 라우팅 규칙, TUN은 같은 기능인가요?

트래픽이 어느 계층에서 처리되는지부터 구분하세요. 시스템 프록시는 시스템 프록시 설정을 따르는 앱의 요청을 클라이언트의 로컬 수신 포트로 전달합니다. 라우팅 규칙은 코어에 들어온 요청을 직접 연결, 프록시, 차단 중 어떤 방식으로 처리할지 결정합니다. TUN은 가상 네트워크 인터페이스를 통해 지정된 트래픽을 가로챕니다. 시스템 프록시를 켜도 모든 프로그램이 프록시를 사용하는 것은 아니며, TUN을 켜도 모든 목적지가 프록시를 거치는 것은 아닙니다. 코어의 라우팅 규칙은 계속 적용됩니다. 문제를 확인할 때는 먼저 TUN을 끄고 일반 시스템 프록시로 접속되는지 확인한 다음, TUN을 따로 테스트해 여러 계층의 설정을 동시에 바꾸지 않도록 하세요.

클라이언트가 노드를 자동으로 제공하나요? 지연 시간만으로 사용 가능 여부를 알 수 있나요?

먼저 유효한 설정이 있는지 확인하세요. 클라이언트는 연결을 관리하는 프로그램이며, 설치만으로 사용할 수 있는 서버를 자동으로 제공하지는 않습니다. 지연 시간 테스트는 특정 시점의 네트워크에서 특정 방식으로 측정한 결과일 뿐, 웹페이지·다운로드·동영상이 실제로 정상 작동한다는 뜻은 아닙니다. TCP 테스트는 주로 포트 연결 여부를 보여 주며, 실제 연결 테스트에는 프로토콜 핸드셰이크와 테스트 대상이 포함됩니다. 지연 시간은 정상인데 웹페이지가 열리지 않는다면 서비스 유효 기간, 기기 시간, DNS, 라우팅을 확인하세요. 지연 시간 하나만 보고 코어를 계속 바꾸지 말고 같은 설정으로 비교 테스트를 진행하세요.

설치와 가져오기 메뉴 확인

설치 및 설정

운영체제와 아키텍처를 확인한 뒤 구독 형식과 실행 권한을 점검하세요.

Android 설치 파일은 arm64와 universal 중 무엇을 선택해야 하나요?

기기의 프로세서와 시스템 아키텍처를 먼저 확인하세요. 비교적 최신 Android 스마트폰이라면 보통 arm64 패키지를 선택할 수 있으며, 여러 아키텍처를 포함한 universal 패키지보다 파일 크기가 작은 편입니다. 아키텍처를 모르거나 오래된 기기를 사용하거나 아키텍처 불일치 오류가 발생하면 universal을 시도해 보세요. 프로세서가 64비트를 지원해도 기기에 64비트 시스템이 설치되어 있다고 단정할 수는 없습니다. 기기 시스템 정보와 설치 결과를 기준으로 판단하세요. 설치할 수 없다는 메시지가 계속 표시되면 Android 시스템 요구 사항, 저장 공간, 서명이 다른 동명의 앱이 설치되어 있는지 확인하세요. 서명이 다른 앱으로 바꾸기 전에 설정을 내보내고, 유일하게 작동하는 클라이언트를 바로 삭제하지 마세요.

v2rayN 데스크톱 버전, WPF 버전, 운영체제별 설치 파일은 어떻게 선택하나요?

운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. Windows 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 Windows 데스크톱 인터페이스를 유지합니다. 메뉴 배치와 일부 기능의 위치가 다를 수 있으므로 두 버전의 설정 화면을 혼용하지 마세요. macOS에서는 ‘이 Mac에 관하여’에서 칩을 확인해 Apple Silicon은 arm64, Intel은 x64를 선택하세요. Linux는 배포판에 맞춰 deb 또는 rpm을 고른 뒤 기기가 x64인지 arm64인지 확인하세요. 설치 파일 형식만으로 아키텍처가 결정되지는 않습니다. 실행되지 않으면 먼저 다운로드한 파일 유형과 현재 버전의 시스템 요구 사항을 확인한 뒤 재설치를 고려하세요.

구독을 가져온 뒤 목록이 비어 있거나 형식 오류가 표시되면 어떻게 하나요?

구독 그룹 설정을 열어 구독 주소가 올바른 그룹에 저장되어 있는지 확인한 다음 해당 그룹의 구독을 업데이트하세요. 주소를 저장하는 것만으로 서버 목록이 바로 채워지지 않을 수 있습니다. 주소에 공백, 줄바꿈, 메신저가 덧붙인 문장 부호가 포함되어 있는지 확인하고, 현재 목록이 다른 그룹으로 필터링되어 있지 않은지도 살펴보세요. 응답 내용이 로그인 페이지, 만료 안내, 웹 오류 메시지라면 다시 가져와도 노드가 생성되지 않습니다. 먼저 구독 권한을 확인하세요. 단일 공유 링크만 있다면 클립보드에서 가져오기 메뉴를 사용하세요. 그래도 인식되지 않으면 제공자에게 링크 형식과 클라이언트 지원 여부를 문의하세요.

TUN을 켤 때 권한 부족 또는 가상 네트워크 어댑터 생성 오류가 발생하면 어떻게 하나요?

먼저 TUN을 끄고 일반 시스템 프록시로 연결되는지 확인해 서버 오류를 권한 문제로 오인하지 않도록 하세요. Windows에서는 클라이언트의 현재 버전 안내에 따라 관리자 권한으로 실행하거나 서비스 방식으로 시작하세요. Linux에서는 필요한 권한과 TUN 장치 사용 가능 여부를 확인하고, macOS에서는 시스템 안내에 따라 권한을 허용하세요. 문제를 확인한다며 시스템 보호 기능 전체를 끄지 마세요. 가상 네트워크 어댑터가 계속 생성되지 않으면 네트워크를 제어하는 다른 도구를 종료하고 로그의 구체적인 오류를 확인하세요. 운영체제, 설치 방식, 코어에 따라 권한 처리 방법이 다를 수 있습니다. 문제를 해결한 뒤 클라이언트를 재시작하고 라우팅이 정상적으로 복구됐는지 다시 확인하세요.

처음부터 다시 진행해야 하나요? 구독 가져오기 및 연결 가이드를 확인하거나 클라이언트 페이지에서 운영체제에 맞는 설치 파일을 선택하세요.

한 번에 하나씩 변경

사용 팁

업데이트 경로, 앱 프록시, 라우팅 규칙을 조정하고 되돌릴 수 있는 설정을 보관하세요.

구독 업데이트가 실패할 때 프록시를 사용하지 않고 업데이트해야 하는 경우는 언제인가요?

업데이트 요청이 어떤 네트워크 경로를 사용하는지 먼저 확인하세요. 현재 노드가 작동하지 않고 구독 업데이트도 해당 노드를 통과한다면 연결 오류로 업데이트가 막힐 수 있습니다. 이 경우 ‘프록시를 사용하지 않고 구독 업데이트’를 시도하세요. 반대로 현재 직접 연결된 네트워크에서 구독 서비스에 접속할 수 없다면 사용 가능한 노드를 선택한 뒤 프록시를 통해 업데이트하세요. 두 방식 모두 실패하면 구독 유효 기간, 기기 시간, 서버 응답, 로그를 확인하세요. 그룹을 계속 새로 만들 필요는 없습니다. 자동 업데이트 간격을 설정하기 전에 수동 업데이트가 한 번 성공하는지 확인하세요. 간격을 너무 짧게 설정해도 잘못된 주소가 해결되지는 않으며 서버의 요청 제한에 걸릴 수 있습니다.

브라우저 외의 프로그램에서 로컬 프록시를 설정하려면 어떻게 하나요?

먼저 프로그램이 시스템 프록시를 따르는지 확인하세요. 수동 프록시를 지원하는 프로그램에는 클라이언트가 현재 수신 중인 프로토콜, 주소, 포트를 입력해야 합니다. 같은 기기에서는 보통 127.0.0.1을 사용하며, 포트는 설정의 로컬 혼합 수신 포트를 기준으로 하세요. 모든 버전이 10808을 사용하는 것은 아닙니다. 터미널 도구는 HTTP_PROXY, HTTPS_PROXY 환경 변수나 자체 설정을 사용할 수 있으므로 따로 확인하고, 변경 후 터미널을 다시 시작해 테스트하세요. 프록시를 직접 설정할 수 없는 앱에서만 TUN을 고려하세요. 로컬 프로그램을 연결하려고 ‘LAN 연결 허용’을 켜면 수신 범위가 넓어지므로 사용하지 마세요.

라우팅 규칙을 바꿨는데도 대상 웹사이트가 이전 경로로 접속되는 이유는 무엇인가요?

요청이 현재 클라이언트에 실제로 들어오는지 확인한 뒤 어떤 라우팅 규칙이 활성화되어 있는지 살펴보세요. 규칙은 보통 순서대로 적용되므로 앞에 있는 포괄적인 규칙이 먼저 일치할 수 있습니다. 도메인, IP, 프로세스 규칙이 적용되는 대상도 서로 다릅니다. IPIfNonMatch를 사용하면 도메인 규칙이 일치하지 않을 때만 대상 IP를 조회해 IP 규칙을 추가로 확인합니다. 모든 도메인을 반드시 먼저 조회한다는 뜻은 아닙니다. 저장한 뒤 필요하면 서비스를 재시작하고, 대상 앱의 기존 연결을 종료한 다음 테스트하세요. 앱 자체 프록시를 사용하거나 시스템 프록시를 우회한다면 코어의 라우팅만 바꿔서는 실제 접속 경로가 달라지지 않습니다.

클라이언트를 업데이트하거나 코어를 바꾸기 전에 어떤 설정을 보관해야 하나요?

클라이언트의 내보내기 또는 백업 기능을 사용해 구독 그룹, 로컬 수신 포트, 라우팅 선택, DNS 설정, 사용자 지정 설정을 기록하세요. 백업에는 민감한 정보가 포함될 수 있으므로 직접 관리할 수 있는 위치에 보관해야 합니다. 업데이트하기 전에 클라이언트를 종료하고 기존 설정과 되돌릴 수 있는 설치 방식을 보존한 뒤 새 버전에서 설정을 읽을 수 있는지 확인하세요. Xray 또는 sing-box 코어로 바꾸기 전에 노드 프로토콜과 사용자 지정 매개변수가 호환되는지 확인해야 합니다. 같은 항목도 코어마다 요구 사항이 다를 수 있습니다. 먼저 한 가지 변경 사항만 테스트하고 연결이 정상임을 확인한 다음 자동 업데이트, TUN 등 추가 기능을 다시 활성화하세요.

요청이 들어오는 지점부터 서버까지 확인

문제 해결

시간 초과, 프록시 미적용, 포트 충돌, 모바일 백그라운드 연결 끊김을 구분하세요.

노드 테스트가 전부 시간 초과되면 어디부터 확인해야 하나요?

클라이언트 프록시를 끄고 일반 네트워크로 접속되는지 확인한 다음 구독이 만료되지 않았는지, 기기 시간이 자동으로 동기화되는지 확인하세요. 같은 노드를 현재 네트워크와 사용할 수 있는 다른 네트워크에서 비교해 접속 네트워크 문제인지 판단하세요. 구체적인 오류가 가려지지 않도록 노드 하나씩 테스트하세요. 그런 다음 로그에서 도메인 조회 실패, 연결 시간 초과, 연결 거부, 핸드셰이크 실패를 구분하세요. 포트에 연결된다고 해서 프로토콜 설정이 올바른 것은 아닙니다. 주소, 포트, 전송 방식, TLS 설정을 확인하세요. 인증서 검증을 꺼서 시간이나 인증서 문제를 숨기지 말고, 한 번의 시간 초과만으로 클라이언트가 고장 났다고 단정하지 마세요.

연결은 됐는데 인터넷이 안 되고 시스템 프록시도 작동하지 않으면 어떻게 하나요?

유효한 서버를 선택했는지 확인하고 v2rayN에서 시스템 프록시 자동 설정을 선택하세요. 로컬 수신 포트와 시스템 프록시에 지정된 포트가 일치하는지 확인한 다음, 브라우저 프록시 확장 프로그램을 잠시 끄고 시스템 설정을 덮어쓰지 않는지 살펴보세요. 브라우저는 되는데 터미널이 안 되면 터미널 환경 변수를 따로 확인하세요. 둘 다 안 되면 클라이언트에 요청이 들어오는지 확인합니다. 로그에 요청이 없다면 연결 경로와 프록시 설정을 살펴보세요. 요청은 있지만 오류가 발생한다면 노드, DNS, 라우팅을 확인하세요. 클라이언트를 종료한 뒤에도 직접 연결이 안 되면 클라이언트를 다시 열어 시스템 프록시를 해제하고, 운영체제에 수동 프록시 설정이 남아 있는지 확인하세요.

10808 포트가 사용 중이거나 DNS 조회에 실패하면 어떻게 하나요?

로그에 표시된 오류 종류에 따라 나눠서 처리하세요. 포트가 사용 중이라면 클라이언트가 중복 실행 중인지, 다른 프록시 프로그램도 실행 중인지 확인하세요. Windows에서는 netstat -ano로 해당 포트의 프로세스 ID를 찾을 수 있습니다. 프로세스 용도를 확인한 뒤 종료하고, 정체를 알 수 없는 시스템 프로세스를 바로 강제 종료하지 마세요. 설정에서 로컬 혼합 수신 포트를 변경할 수도 있습니다. 이 경우 수동 프록시 설정도 함께 업데이트하세요. DNS 조회 실패라면 서버 도메인이 조회되는지 먼저 확인하고, 코어 DNS와 라우팅이 순환 구조를 만들지 않는지 살펴보세요. 포트, DNS, 노드 설정을 한꺼번에 바꾸지 말고 한 번에 하나씩 수정하며 변경 전후 로그를 보관하세요.

Android 화면을 잠근 뒤 연결이 끊기거나 네트워크를 바꾼 뒤 복구되지 않으면 어떻게 하나요?

시스템이 v2rayNG의 백그라운드 활동이나 배터리 사용을 제한하는지 확인하고, 기기 설정에서 필요한 백그라운드 실행을 허용한 뒤 연결 상태 알림도 살펴보세요. Android VPN 연결은 다른 VPN 앱이 대신 사용할 수 있으므로 현재 연결을 제어하는 앱이 무엇인지 확인하세요. Wi-Fi와 모바일 네트워크를 바꾼 뒤에는 연결을 끊었다가 다시 연결하고 로그에서 연결이 다시 설정되는지 확인하세요. 특정 네트워크에서만 실패한다면 해당 네트워크의 DNS와 연결 상태를 점검하세요. 처음부터 앱 데이터를 삭제하지 말고 먼저 설정을 내보내세요. 연결이 계속 끊기면 발생 시각, 네트워크 종류, 개인정보를 가린 오류 정보를 기록해 원인을 더 살펴보세요.

문제를 계층별로 확인하고 싶으신가요? 문제 해결 안내서의 전체 점검 절차를 읽어 보세요.