FAQ 클라이언트 사용 및 문제 해결

v2rayN 자주 묻는 질문

설치 파일과 구독 형식부터 확인하세요. 연결은 되었지만 접속할 수 없다면 트래픽 유입, 라우팅, 아웃바운드 순서로 원인을 찾아보세요.

기본 개념

클라이언트, 구독 형식, 설정 필드의 차이를 알아봅니다.

v2rayN, v2rayNG, v2flyNG는 어떻게 다른가요?

v2rayN은 Windows, macOS, Linux에서 사용할 수 있고, v2rayNG와 v2flyNG는 Android용으로 각각 Xray와 V2Fly 코어를 사용합니다. 먼저 기기 플랫폼을 확인한 뒤 노드의 프로토콜, 전송 방식, 보안 옵션이 해당 클라이언트와 코어에서 지원되는지 살펴보세요. 같은 주소를 가져오더라도 클라이언트에 따라 일부 매개변수를 인식하지 못할 수 있습니다. 설치 파일 형식과 아키텍처는 플랫폼별 클라이언트 페이지에서 확인할 수 있습니다.

구독 주소와 단일 노드 링크는 어떻게 다른가요?

구독 주소는 여러 노드 정보를 가져오는 주소입니다. 구독 그룹에 추가한 다음 해당 그룹을 업데이트하세요. 단일 노드 링크는 연결 하나를 지정하므로 클립보드에서 가져오거나 QR 코드로 추가하면 됩니다. 구독 주소를 단일 노드로 가져오면 형식이 지원되지 않는다는 메시지가 표시될 수 있고, 단일 노드 링크를 구독으로 저장해도 업데이트할 노드 목록이 만들어지지 않습니다. 형식이 헷갈리면 설정 제공자에게 전달 형식을 확인하고, 전체 주소를 공개 게시물에 올리지 마세요.

시스템 프록시, TUN, 전역 모드는 같은 기능인가요?

시스템 프록시와 TUN은 트래픽이 클라이언트로 들어오는 방식을 결정합니다. 시스템 프록시는 앱이 시스템 프록시 설정을 따르는 방식이고, TUN은 가상 네트워크 어댑터와 시스템 라우팅을 통해 트래픽을 받습니다. 전역 모드는 클라이언트에 들어온 트래픽을 어떤 아웃바운드로 보낼지 정하며, 실제 동작은 선택한 라우팅 설정에 따라 달라집니다. 전역 모드를 켜도 모든 앱의 트래픽이 자동으로 전달되는 것은 아니며, TUN을 켜도 직접 연결 규칙이 비활성화되는 것은 아닙니다. 문제를 확인할 때는 트래픽 유입 경로와 아웃바운드 경로를 따로 살펴보세요.

inbounds, routing, outbounds는 어떤 순서로 이해하면 되나요?

요청이 이동하는 경로를 기준으로 보면, inbounds는 로컬 수신 주소와 포트, 프로토콜 등 요청을 받는 방식을 정의합니다. routing은 규칙에 따라 트래픽을 보낼 아웃바운드를 결정하고, outbounds는 실제 연결 방식을 정의합니다. 설정을 확인할 때는 먼저 앱의 요청이 올바른 인바운드로 들어오는지 확인한 뒤 라우팅 조건을 살펴보세요. 마지막으로 outboundTag가 정의된 아웃바운드 tag와 일치하는지 확인하면 됩니다. 필드 구성과 참조 관계는 설정 레퍼런스를 참고하세요.

설치 및 설정

운영체제, 아키텍처, 인터페이스 버전에 맞는 파일을 선택한 다음 구독을 가져옵니다.

Android 설치 파일은 arm64와 universal 중 어떤 것을 선택해야 하나요?

Android 시스템이 arm64-v8a를 지원한다면 arm64 패키지를 우선 선택하세요. 아키텍처를 모를 때는 제조사 사양이나 기기 정보에서 시스템 지원 아키텍처를 확인하세요. 칩셋이 64비트를 지원한다는 이유만으로 64비트 앱을 설치할 수 있다고 단정해서는 안 됩니다. 확인이 어렵다면 같은 클라이언트의 universal 패키지를 사용해 볼 수 있습니다. universal 패키지는 용량이 더 큰 편이며, 최소 Android 버전 요구 사항을 해결해 주지는 않습니다. 기존 앱 위에 설치할 때는 서명 충돌 안내가 표시되는지도 확인하세요.

macOS 설치 파일은 Apple Silicon과 Intel 중 어떤 것을 선택해야 하나요?

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. M 시리즈 칩이 표시되면 Apple Silicon용 arm64 설치 파일을, Intel 프로세서가 표시되면 Intel용 x64 설치 파일을 선택하세요. 기준은 현재 사용 중인 Mac의 칩이며, 이전에 사용하던 클라이언트 버전이 아닙니다. 처음 실행할 때 시스템 안내가 표시되면 macOS 버전이 맞지 않는지, 앱 사용이 제한되었는지, 파일을 열 수 없는지 확인하세요. 업무용 기기의 제한은 기기 관리자에게 문의해야 합니다.

Windows용 Desktop과 WPF 버전, 어떤 것을 선택해야 하나요?

Desktop은 크로스 플랫폼 인터페이스를 사용하고, WPF는 Windows용 기존 인터페이스입니다. 기존 작업 흐름이 익숙한 메뉴 구성에 맞춰져 있다면 WPF를 계속 사용하세요. 다른 데스크톱 플랫폼과 비슷한 인터페이스를 원한다면 Desktop을 선택할 수 있습니다. 전환하기 전에 노드, 구독, 사용자 지정 라우팅을 백업하세요. 새 버전을 처음 실행할 때는 기존 버전과 트레이 프로세스를 종료한 뒤 로컬 수신 포트와 시스템 프록시 상태를 확인해 두 인스턴스가 동시에 설정을 변경하지 않도록 하세요.

구독 주소를 복사했는데 가져온 뒤 노드가 보이지 않는 이유는 무엇인가요?

클립보드에 패널 첫 화면이나 단일 노드 링크가 아니라 전체 구독 주소가 복사되어 있는지 확인하세요. 구독 그룹에 항목을 추가해 저장한 다음 해당 그룹을 직접 업데이트해야 합니다. 주소를 저장하는 것만으로 노드가 가져와지지는 않습니다. 로그에 요청 성공이 표시되는데 가져올 항목이 없다면 응답 내용이 로그인 안내나 빈 목록인지, 현재 클라이언트에서 지원하지 않는 설정 형식인지 확인하세요. 주소를 다시 복사할 때는 쿼리 매개변수를 그대로 유지하고 임의로 삭제하거나 바꾸지 마세요.

사용 팁

새 요청으로 프록시 설정을 확인하고, 속도 테스트 결과와 실제 연결 상태를 구분하세요.

앱이 시스템 프록시를 사용하는지 어떻게 확인하나요?

먼저 클라이언트 코어가 실행 중인지 확인한 다음, 시스템 네트워크 설정의 프록시 주소와 포트가 클라이언트의 로컬 수신 설정과 일치하는지 살펴보세요. 시스템 프록시 설정을 따르는 브라우저에서 요청을 보내고, 클라이언트 로그에 해당 기록이 남는지 확인하세요. 브라우저에는 기록이 있지만 다른 앱에는 없다면 해당 앱에 별도 프록시 설정이 있는지, 브라우저 확장 프로그램이나 관리 정책의 영향을 받는지, 설정 변경 후 앱을 다시 시작해야 하는지 확인하세요.

노드 속도 테스트에서는 어떤 결과를 봐야 하나요?

먼저 테스트 방식을 확인한 뒤 결과를 비교하세요. TCP 지연 시간은 노드 주소와 포트에 연결하는 데 걸리는 시간을 나타낼 뿐, 프록시 핸드셰이크나 대상 웹사이트 접속 성공을 보장하지 않습니다. 프록시를 통한 테스트 요청은 테스트 주소와 DNS 확인 결과에도 영향을 받습니다. 비교할 때는 같은 네트워크, 테스트 방식, 테스트 주소를 사용하고 필요하면 다시 측정하세요. 평소 특정 사이트나 앱을 사용한다면 지연 시간 순위만 보지 말고 실제 요청으로 확인하세요.

TUN을 켤 때 권한 부족 오류가 표시되면 무엇부터 확인해야 하나요?

먼저 시작 로그를 확인해 가상 네트워크 어댑터 생성, 시스템 라우팅 설정, 시스템 권한 중 어느 단계에서 실패했는지 살펴보세요. Windows에서는 클라이언트 안내에 따라 권한을 허용한 뒤 다시 시작할 수 있습니다. macOS와 Linux에서는 해당 버전의 권한 요구 사항을 확인하세요. Android에서는 시스템 VPN 연결 권한을 승인했는지, 다른 VPN이 실행 중인지 확인하세요. 트래픽을 가로채는 도구는 한 번에 하나만 사용하세요. 관리 기기의 권한 제한은 관리자에게 문의해야 합니다.

노드를 바꿨는데 기존 연결에는 왜 변화가 없나요?

노드를 바꾼 뒤에는 새 요청을 만들어 먼저 확인하세요. 이미 연결된 장시간 연결은 기존 경로를 계속 사용할 수 있으며, 코어를 다시 불러오는 과정에서 연결이 끊겼다가 다시 연결될 수도 있습니다. 테스트 중인 앱을 닫았다가 다시 열고, 새 요청의 아웃바운드 태그를 확인해 보세요. 새 요청도 직접 연결된다면 사용 중인 라우팅 설정이 직접 연결 규칙에 해당하는지 살펴보세요. 현재 노드 변경은 프록시 아웃바운드를 사용해야 하는 요청에만 영향을 주며, 기존 분기 규칙을 바꾸지는 않습니다.

문제 해결

오류가 발생한 시점의 로그를 확인해 업데이트 요청, 프록시 연결, 로컬 수신 문제를 구분하세요.

잘 되던 구독 업데이트가 실패하면 어떻게 확인해야 하나요?

오류가 발생한 그룹만 업데이트하고 해당 요청의 오류 내용을 기록하세요. 도메인 이름 확인에 실패하면 현재 네트워크와 시스템 DNS부터 확인하세요. 연결 또는 읽기 시간 초과가 발생하면 업데이트 요청의 네트워크 경로가 정상인지 살펴보세요. 인증되지 않았거나 접근이 금지되었다는 응답이 오면 주소가 만료되었는지, 새 주소를 받아야 하는지 제공자에게 확인하세요. 파싱 단계에서 오류가 발생하면 구독 형식과 클라이언트 호환성을 확인하세요. 재시도하려고 기존 노드가 들어 있는 그룹 전체를 삭제하지 마세요.

노드 테스트가 계속 시간 초과될 때 문제 범위를 어떻게 좁히나요?

같은 네트워크와 테스트 방식으로 문제가 있는 노드와 정상 작동이 확인된 노드를 각각 테스트하세요. 프록시 요청 테스트만 실패한다면 정상적으로 접속할 수 있는 다른 테스트 주소로 바꿔 보세요. 노드 하나만 실패하면 서버 도메인과 포트를 확인하고, 로그에서 연결 시간 초과인지 핸드셰이크 실패인지 살펴보세요. 여러 노드가 동시에 실패하면 기기 네트워크, 코어 실행 상태, DNS를 우선 확인하세요. 한 번에 설정 하나만 바꾸고 변경 전후 결과를 기록하세요.

클라이언트에 연결됨으로 표시되는데 웹페이지가 열리지 않는 이유는 무엇인가요?

연결됨 표시는 보통 로컬 서비스나 트래픽 가로채기 모드가 시작되었다는 뜻일 뿐, 실제 요청이 성공했다는 뜻은 아닙니다. 웹페이지를 열면서 같은 시점의 로그를 확인하세요. 해당 기록이 없다면 브라우저 트래픽이 시스템 프록시나 TUN으로 들어오는지 살펴보세요. 기록은 있지만 도메인 확인에 실패하면 DNS를 확인하세요. 아웃바운드가 확인되었는데 핸드셰이크가 실패한다면 노드의 전송 및 보안 매개변수를 확인하세요. 특정 사이트만 실패할 때는 클라이언트를 바로 재설치하지 말고 같은 브라우저에서 다른 사이트도 열어 보세요.

시스템 프록시를 켰는데도 작동하지 않으면 어떤 충돌을 확인해야 하나요?

시스템 프록시에 입력한 포트가 현재 코어에서 실제로 수신 중인 포트인지 확인하고, 해당 포트의 프로토콜도 살펴보세요. SOCKS만 제공하는 포트를 HTTP 프록시 포트로 사용할 수는 없습니다. 다음으로 브라우저에 별도 프록시 확장 프로그램이 켜져 있는지, 시스템에 자동 프록시 스크립트가 설정되어 있는지, 다른 클라이언트가 프록시 설정을 덮어쓰는지 확인하세요. 다른 프록시 도구를 종료하고 설정을 다시 적용한 뒤 새 요청으로 확인하세요. 클라이언트를 종료하기 전에는 해당 시스템 프록시 설정을 해제하세요.

로그에 로컬 수신 포트가 사용 중이라고 표시되면 어떻게 해야 하나요?

시작 실패 로그에서 수신 주소와 포트를 확인하세요. 먼저 트레이에 클라이언트가 하나 더 실행 중인지 살펴본 다음, 시스템 연결 확인 도구로 해당 포트를 수신하는 프로세스를 찾으세요. 이전 클라이언트 인스턴스라면 정상적으로 종료하세요. 계속 실행해야 하는 프로그램이 포트를 사용 중이라면 클라이언트에서 사용하지 않는 포트로 변경하세요. 코어를 다시 시작한 뒤 시스템 프록시와 직접 설정한 앱의 포트도 함께 바꾸고 새 요청으로 확인하세요. 정체를 알 수 없는 시스템 프로세스를 강제 종료하지 마세요.