클라이언트 문제 색인

V2Ray 자주 묻는 질문

구독 가져오기부터 연결 문제 해결까지, 오류가 발생한 단계를 찾아 해당 설정을 확인하세요.

v2rayN v2rayNG v2flyNG

클라이언트와 코어

기본 개념

설정 출처, 코어 호환성, 트래픽 진입 경로를 구분해 잘못된 부분을 반복해서 수정하지 않도록 하세요.

v2rayN, v2rayNG, v2flyNG 중 무엇을 선택해야 하나요?

Windows, macOS, Linux 데스크톱에서는 v2rayN을 먼저 고려하세요. Android에서는 보통 Xray 코어를 사용하는 v2rayNG를 선택하고, V2Fly 코어가 필요할 때 v2flyNG를 고려하면 됩니다. 클라이언트는 구독 관리와 화면 조작, 프록시 설정을 담당하고 코어는 연결을 처리하므로 서로 다른 개념입니다. 선택하기 전에 구독 안내에 적힌 프로토콜과 전송 방식도 확인하세요. 이름이 비슷하다고 호환되는 것은 아닙니다. 클라이언트를 바꾸기 전에는 기존 구독과 라우팅 설정을 보관하고, 새 클라이언트에서 설정을 가져와 활성 구성을 선택한 뒤 연결을 확인하세요. 이전 설정은 확인이 끝난 다음 정리해야 여러 프록시 프로그램이 동시에 실행되어 포트가 충돌하는 일을 막을 수 있습니다.

클라이언트를 설치한 뒤 연결하려면 무엇을 준비해야 하나요?

클라이언트에는 사용할 수 있는 원격 연결 설정이 포함되어 있지 않습니다. 사용 권한이 있는 구독 주소나 개별 공유 링크, 또는 서버에서 제공한 전체 접속 정보를 준비해야 합니다. 구독 주소는 설정 목록을 주기적으로 가져오는 데 쓰이고, 공유 링크는 보통 하나의 설정만 담습니다. 일반 웹페이지 주소는 구독 주소로 가져올 수 없습니다. 처음 사용할 때는 시스템 시간이 정확한지 확인한 다음 설정을 가져오고, 사용할 항목을 선택한 뒤 시스템 프록시나 앱에서 요구하는 연결 모드를 켜세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 공개 댓글이나 스크린샷, 온라인 파싱 사이트에 올리지 마세요. 클라이언트 설치가 완료되어도 원격 서비스까지 사용할 수 있다는 뜻은 아닙니다.

시스템 프록시, 라우팅 프리셋, TUN은 각각 무엇을 제어하나요?

시스템 프록시는 시스템 설정을 따르는 앱의 요청을 로컬 프록시로 전달합니다. 라우팅 프리셋은 코어로 들어온 요청을 프록시로 보낼지 직접 연결할지 결정합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 받아 더 많은 앱의 연결을 처리할 때 사용합니다. 세 기능은 서로 다른 단계에서 작동하므로 라우팅을 바꿔도 시스템 프록시를 따르지 않는 앱이 자동으로 연결되지는 않습니다. 처음에는 TUN을 끄고 시스템 프록시만으로 브라우저 접속을 확인한 뒤, 필요에 따라 TUN을 켜세요. Android 클라이언트는 보통 시스템 VPN 권한을 받아 트래픽을 처리하므로 데스크톱 클라이언트와 설정 방식이 다를 수 있습니다. 데스크톱 메뉴를 그대로 적용할 필요는 없습니다.

설정에 VLESS와 REALITY가 있는데 코어를 바꾸면 왜 작동하지 않나요?

프로토콜, 전송 방식, 보안 계층은 클라이언트와 코어가 모두 지원해야 합니다. REALITY는 보안 계층 방식이지, 아무 주소나 가져오면 사용할 수 있는 독립적인 노드 유형이 아닙니다. 서버에서 요구하는 공개 키와 서버 이름 등의 값도 일치해야 합니다. 한 클라이언트에서는 작동하던 설정이 코어를 바꾼 뒤 오류를 내면 구독 안내와 현재 코어 종류를 확인하고, 로그에서 지원되지 않는 필드나 전송 방식이 있는지 살펴보세요. V2Fly와 Xray가 지원하는 기능은 완전히 같지 않으며, 클라이언트 화면을 업데이트해도 코어까지 업데이트된다는 보장은 없습니다. 오류를 없애려고 설정값을 임의로 삭제하지 말고, 서버 요구 사항에 맞는 클라이언트와 코어 조합을 사용하세요.

설치 파일과 구독 입력

설치 및 설정

설치 파일 아키텍처를 확인하고 구독 주소와 공유 링크를 구분하세요. 권한 문제는 별도로 해결해야 합니다.

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

2015년 이후 출시된 대부분의 Android 스마트폰은 arm64 패키지를 우선 고려할 수 있지만, 최종적으로는 기기 프로세서와 시스템에서 지원하는 앱 아키텍처를 확인해야 합니다. 64비트 프로세서를 사용하더라도 시스템이 앱 아키텍처를 제한하는 기기가 있으므로 프로세서 이름만으로 판단하지 마세요. 확인하기 어렵다면 여러 아키텍처를 포함하는 universal 패키지를 선택할 수 있습니다. 대신 파일 크기가 더 큽니다. 설치 중 기기와 호환되지 않는다는 메시지가 나오면 다운로드 플랫폼과 아키텍처를 확인하세요. 서명 충돌 메시지는 다른 문제입니다. 기존 앱을 바로 삭제하지 말고 구독, 그룹, 사용자 지정 규칙을 먼저 백업한 다음 클라이언트나 설치 경로를 잘못 선택했는지 확인하세요.

v2rayN 구독 주소는 어디에 붙여 넣나요?

v2rayN에서 ‘구독 그룹’ 또는 ‘구독 그룹 설정’을 열고 그룹을 추가하세요. 알아보기 쉬운 이름을 입력한 뒤 구독 주소 전체를 주소 입력란에 붙여 넣고 저장합니다. 그런 다음 메인 화면의 구독 메뉴로 돌아가 해당 그룹을 업데이트하세요. 주소만 저장하면 설정 목록이 자동으로 만들어지지는 않습니다. 개별 공유 링크를 받은 경우에는 ‘클립보드에서 공유 링크 가져오기’를 사용하세요. 두 입력 방법을 혼용하지 마세요. 메뉴 이름은 버전에 따라 조금씩 다를 수 있으므로 구독 주소와 그룹 입력란이 있는 창인지 확인하면 됩니다. 업데이트한 뒤 현재 그룹 필터를 확인하고 사용할 설정을 선택한 다음 시스템 프록시를 설정하세요.

공유 링크를 가져오지 못하거나 가져온 뒤 항목이 없으면 무엇부터 확인해야 하나요?

먼저 클립보드에 구독 관리 웹페이지나 QR 코드 이미지, 메신저에서 잘린 텍스트가 아닌 완전한 공유 링크가 있는지 확인하세요. 복사할 때 앞뒤의 따옴표나 설명, 공백은 포함하지 마세요. 여러 링크는 클라이언트가 지원하는 형식에 맞춰 줄바꿈해 가져오면 됩니다. 지원하지 않는 프로토콜이나 필드라는 오류가 나오면 오류 내용을 기록하고 클라이언트 버전과 코어의 지원 범위를 확인하세요. 암호화나 보안 계층 설정을 계속 바꿔가며 해결하려고 하지 마세요. 오류 없이 항목이 보이지 않는다면 검색어를 지우고 전체 그룹을 선택하세요. 가져온 설정이 현재 그룹에 추가되는 경우도 있어, 목록이 비어 보이는 것이 실제로 설정이 사라졌다는 뜻은 아닐 수 있습니다.

TUN을 켤 때 권한 부족 메시지가 나오면 어떻게 해야 하나요?

먼저 TUN을 끄고 일반 시스템 프록시로 접속되는지 확인한 뒤 권한 문제를 해결하세요. Windows에서는 클라이언트 안내에 따라 관리자 권한으로 실행하거나 필요한 서비스를 설치합니다. macOS에서는 시스템 설정에서 네트워크 확장, VPN 또는 보조 서비스 권한을 확인하세요. Linux에서는 설치 방식에 맞춰 클라이언트에 필요한 네트워크 권한과 보조 서비스를 점검합니다. 구현 방식은 버전마다 다르므로 다른 플랫폼의 권한 설정을 그대로 따라 하지 마세요. Android에서는 시스템 VPN 연결 요청을 허용하고, 다른 VPN 앱이 연결을 사용 중인지 확인해야 합니다. 권한을 허용한 뒤에도 실패한다면 로그에서 인터페이스 생성이나 라우팅 오류를 확인하세요. 시스템 보안 기능을 끄는 것으로 문제 해결을 대신하지 마세요.

프록시 상태와 관리

사용 팁

트래픽 처리, 라우팅, 설정 관리를 나눠 진행하면 업데이트와 문제 해결 과정을 추적하기 쉽습니다.

v2rayN 시스템 프록시의 세 가지 상태는 어떻게 사용하나요?

‘시스템 프록시 자동 설정’은 시스템 프록시를 클라이언트의 로컬 주소로 연결하므로 브라우저를 사용할 때 편리합니다. ‘시스템 프록시 해제’는 시스템 프록시 설정을 지우지만 코어 실행까지 중지하지는 않을 수 있습니다. ‘시스템 프록시 변경 안 함’은 현재 설정을 유지하므로 프록시를 수동으로 설정해 둔 경우에 적합합니다. 상태를 바꾼 뒤에는 로컬 연결 주소와 활성 설정이 정상인지 확인하세요. 시스템 프록시와 전체 라우팅은 다릅니다. 어떤 주소에 직접 연결할지는 라우팅 규칙이 결정합니다. 문제를 확인할 때 다른 프록시 프로그램이 동시에 시스템 설정을 변경하지 않도록 하세요. 클라이언트를 종료하기 전 시스템 프록시를 해제하면, 종료된 로컬 포트를 계속 가리키는 문제를 줄일 수 있습니다.

구독이 여러 개일 때 그룹을 나누고, 업데이트 후 잘못된 설정을 선택하지 않으려면 어떻게 해야 하나요?

구독마다 별도 그룹을 만들고 출처나 용도로 이름을 구분하세요. 그룹 이름에 접속 정보는 넣지 마세요. 업데이트 전에 관리할 그룹을 선택하고 현재 그룹만 업데이트할지 전체 구독을 업데이트할지 확인합니다. 업데이트가 끝나면 검색 조건을 지운 뒤 설정 목록을 확인하세요. 키워드 필터는 표시 범위를 좁힐 뿐, 설정을 삭제하거나 비활성화하는 기능이 아닙니다. 구독 업데이트로 항목 순서가 바뀌거나 기존 항목이 사라질 수 있으므로 활성 설정이 남아 있는지 다시 확인하세요. 자동 업데이트 주기는 구독 제공자의 안내에 맞추면 되며, 자주 새로 고칠 필요는 없습니다. 수동 설정과 사용자 지정 라우팅도 별도로 백업해 구독 항목과 혼동하지 않도록 하세요.

‘중국 본토 우회’와 ‘전체 프록시’ 중 무엇을 선택해야 하나요?

‘중국 본토 우회’는 보통 중국 본토 도메인이나 주소 규칙에 해당하는 요청을 직접 연결하고, 나머지 트래픽은 프리셋에 따라 처리합니다. ‘전체 프록시’는 코어에 들어온 요청 대부분을 프록시로 보내지만, 구체적인 동작은 클라이언트에 표시된 규칙을 따릅니다. 어느 쪽도 클라이언트로 들어오지 않은 앱 트래픽까지 처리해 주지는 않습니다. 평소에는 접속 목적에 맞는 프리셋을 선택하고, 특정 사이트 문제를 확인할 때는 프리셋을 잠시 바꿔 비교하세요. 한 번에 하나의 설정만 변경하는 것이 좋습니다. 전체 프록시는 작동하지만 분할 라우팅이 안 된다면 규칙 순서와 규칙 데이터, DNS 확인을 우선 점검하세요. 처음부터 모든 직접 연결 규칙을 삭제하지 마세요. 로컬 네트워크 기기나 서비스가 해당 규칙을 필요로 할 수 있습니다.

클라이언트를 업그레이드하기 전에 어떤 설정을 보관해야 하나요?

먼저 클라이언트의 백업, 내보내기 또는 설정 메뉴에서 현재 설정을 저장하세요. 구독 그룹, 직접 만든 설정, 라우팅 규칙, DNS 설정, 로컬 수신 포트를 특히 보관해야 합니다. 백업 파일에 구독 접속 정보가 포함될 수 있으므로 신뢰할 수 있는 로컬 위치에 저장하세요. 업그레이드 전 사용 중인 클라이언트와 코어 종류를 기록하고 프로그램을 정상 종료합니다. 업그레이드 후에는 활성 설정과 프록시 상태를 확인한 다음 접속이 확인된 사이트를 테스트하세요. GUI 클라이언트는 config.json을 다시 생성할 수 있어 생성된 파일을 직접 수정해도 변경 사항이 유지되지 않을 수 있습니다. 가능하면 화면에서 지원하는 사용자 지정 설정을 이용하세요. 업그레이드와 코어 변경, 라우팅 수정을 동시에 하지 마세요. 문제가 생겼을 때 원인을 찾기 어려워집니다.

증상별 문제 해결

문제 해결

오류 메시지를 그대로 기록하고 구독 가져오기, 로컬 트래픽 처리, 원격 연결 문제를 구분하세요. 모든 문제를 노드 탓으로 돌리지 마세요.

구독 업데이트 실패, 빈 목록, 파싱 오류는 어떻게 구분하나요?

먼저 업데이트 메시지를 확인하세요. 연결 시간 초과는 네트워크 연결 문제일 가능성이 큽니다. 인증 실패나 권한 오류가 나오면 구독 상태와 주소를 확인하고, 파싱 오류라면 응답 내용이 클라이언트에서 지원하는 구독 형식인지 확인하세요. 제공자 페이지에서 구독 주소 전체를 다시 복사하고 불필요한 공백이 없는지, 관리 페이지 주소를 구독 주소로 잘못 사용하지 않았는지 확인합니다. 클라이언트에서 직접 연결 업데이트와 프록시를 통한 업데이트를 지원한다면 이미 사용 가능한 설정이 있을 때 각각 시도해 볼 수 있습니다. 사용 가능한 설정이 없는데 프록시 업데이트에 의존하면 연결이 순환할 수 있습니다. 업데이트 성공 후에도 목록이 비어 있다면 그룹 필터, 검색어 필터, 구독 만료 여부를 확인하세요. 접속 정보가 포함된 주소를 공개 파싱 도구에 입력하지 마세요.

노드 테스트가 시간 초과되면 서버가 반드시 중단된 건가요?

반드시 그렇지는 않습니다. 테스트 메뉴에 따라 포트 연결 여부나 실제 요청 응답 시간을 측정할 수 있으므로 테스트 실패만으로 서버가 중단됐다고 단정할 수 없습니다. 먼저 시스템 시간과 현재 네트워크가 정상인지 확인하세요. 해당 설정을 선택해 실제 접속을 시도하면서 로그에 도메인 확인 실패, 연결 시간 초과, 핸드셰이크 오류가 있는지도 살펴보세요. 같은 네트워크에서 정상 작동이 확인된 다른 설정과 비교하면 기기 문제와 개별 설정 문제를 구분하는 데 도움이 됩니다. 짧은 시간에 여러 항목을 반복해서 테스트하면 요청 부담이 커질 수 있습니다. 한 설정만 실패한다면 서버 설정을 확인하고, 모든 설정이 실패한다면 로컬 코어 실행 여부와 네트워크 변경, 다른 프록시와의 충돌을 우선 점검하세요.

연결됨으로 표시되지만 브라우저나 다른 앱에서 인터넷에 접속할 수 없으면 어떻게 해야 하나요?

‘연결됨’은 로컬 서비스나 VPN 연결이 시작됐다는 뜻일 뿐, 원격 요청까지 성공했다는 의미는 아닐 수 있습니다. 먼저 활성 설정을 확인하고 브라우저에서 접속이 확인된 사이트를 열어 로그에 해당 요청이 기록되는지 살펴보세요. 요청 기록이 없다면 시스템 프록시가 켜져 있는지, 브라우저에 별도 프록시가 설정되어 있는지, 앱이 시스템 설정을 따르는지 확인합니다. 요청은 기록되지만 실패한다면 DNS, 라우팅, 원격 핸드셰이크 오류를 점검하세요. 특정 앱에서만 문제가 발생하면 우선 해당 앱의 프록시 설정을 확인하세요. 바로 클라이언트를 다시 설치할 필요는 없습니다. 마지막으로 다른 프록시 프로그램을 꺼서 로컬 포트 충돌이나 중복된 네트워크 처리가 있는지 비교해 보세요.

클라이언트를 종료한 뒤에도 웹페이지가 열리지 않으면 일반 연결을 어떻게 복구하나요?

시스템 프록시가 여전히 로컬 주소와 클라이언트 포트를 가리키는지 먼저 확인하세요. v2rayN을 다시 열고 ‘시스템 프록시 해제’를 선택한 뒤 정상 종료하고 접속을 테스트합니다. 운영체제의 네트워크 프록시 설정에서 수동 프록시와 자동 구성 스크립트를 확인해도 됩니다. TUN이나 VPN을 사용했다면 클라이언트에서 해당 기능을 끈 다음 시스템에 연결이 남아 있는지 확인하세요. Android에서는 시스템 VPN 화면에서 연결이 끊겼는지 확인할 수 있습니다. 회사나 학교 기기는 조직에서 프록시를 관리할 수 있으므로 클라이언트와 무관한 설정은 삭제하지 마세요. 기본 웹 접속이 복구된 뒤 클라이언트를 단계적으로 다시 켜면 기존 설정이 남아 있는 상태에서 새 프록시 연결이 겹치는 일을 방지할 수 있습니다.