FAQ / DIAGNOSTICS

V2Ray 자주 묻는 질문 및 문제 해결

기본 개념, 설치·설정, 사용 팁, 문제 해결 순서로 정리했습니다. 연결 문제가 발생하면 클라이언트, 구독, 노드, 프록시 처리, DNS를 차례로 확인해 여러 설정을 동시에 변경하지 않는 것이 좋습니다.

기본 개념 코어, 클라이언트, 구독 및 프록시 모드
설치 및 설정 구독 가져오기, 플랫폼 설치 및 권한
사용 팁 모드 전환, 라우팅 및 DNS 분할
문제 해결 시간 초과, 인터넷 끊김, 비정상 종료 및 업데이트 오류

CONCEPTS

기본 개념

그래픽 클라이언트, 프록시 코어, 구독, 단일 노드 링크를 먼저 구분하세요. 개념을 명확히 이해하면 설치 선택과 로그 분석이 훨씬 수월해집니다.

V2Ray, V2Fly, Xray와 그래픽 클라이언트는 어떤 관계인가요?

V2Ray는 일반적으로 Project V에서 발전한 프로토콜과 프록시 도구 생태계를 가리키며, V2Fly와 Xray는 그 안에서 널리 사용되는 코어 계열입니다. v2rayN, v2rayNG, v2flyNG는 구독 관리, 노드 선택, 라우팅 설정, 시스템 프록시 제어를 담당하는 그래픽 클라이언트이며, 실제 연결은 클라이언트가 호출하는 코어가 처리합니다. 문제를 진단할 때는 소프트웨어 이름만 보지 말고 클라이언트 인터페이스, 코어 버전, 서버 설정을 함께 구분해야 합니다.

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

Windows, macOS, Linux 데스크톱에서는 구독 관리, 시스템 프록시, 라우팅, TUN 등 데스크톱 기능을 제공하는 v2rayN을 우선 고려하세요. Android에서는 보통 Xray 코어를 사용하는 v2rayNG를 먼저 선택합니다. V2Fly 코어를 사용하거나 코어별 동작을 비교해야 한다면 v2flyNG를 선택할 수 있습니다. 클라이언트 이름만으로 노드 사용 가능 여부를 판단할 수는 없으며, 플랫폼, 코어 지원 범위, 구독에 실제로 전달된 프로토콜 매개변수가 핵심입니다.

구독 주소와 vmess://, vless:// 공유 링크는 어떻게 다른가요?

구독 주소는 일반적으로 서비스 제공자가 관리하는 여러 노드 목록을 반환하며, 클라이언트에 주소를 저장해 두면 이후 다시 업데이트할 수 있습니다. vmess:// 및 vless:// 공유 링크는 보통 단일 노드만 설명하므로 가져온 뒤 같은 서비스의 다른 노드가 자동으로 추가되지 않습니다. 단일 노드 링크는 클립보드에서 가져오기를 사용하고, 웹 주소 형태의 구독은 구독 그룹에 추가해야 합니다. 두 방식을 혼용하면 클라이언트에서 형식 오류가 표시되거나 업데이트 결과가 비어 있을 수 있습니다.

시스템 프록시 모드와 TUN 모드는 어떻게 다른가요?

시스템 프록시 모드는 운영체제의 프록시 설정을 변경해 시스템 프록시를 따르는 브라우저와 앱의 트래픽을 주로 처리합니다. 설정이 간단하고 동작을 확인하기 쉽습니다. TUN 모드는 가상 네트워크 인터페이스를 통해 더 다양한 트래픽을 처리하므로 시스템 프록시 설정을 읽지 않는 앱에 적합하지만, 일반적으로 관리자 권한이 필요하며 가상 머신, 다른 VPN, 네트워크 필터링 도구와 인터페이스 또는 라우팅 충돌이 발생할 수 있습니다. 처음 설정할 때는 시스템 프록시로 노드를 확인한 뒤 필요에 따라 TUN을 활성화하세요.

SETUP

설치 및 설정

설치 단계에서는 주소의 완전성, 프로세서 아키텍처, 시스템 권한, 앱 실행 폴더를 중점적으로 확인하세요. 대부분의 최초 실행 문제는 이 네 가지 항목에서 원인을 찾을 수 있습니다.

구독 주소를 붙여넣은 뒤 가져오기에 실패하면 무엇을 확인해야 하나요?

복사한 내용이 웹페이지 제목이나 로그인 페이지 주소, 줄바꿈이 포함된 안내문이 아닌 완전한 구독 주소인지 먼저 확인하세요. 그런 다음 주소의 앞뒤에 불필요한 공백이 없는지 점검합니다. 브라우저에서 주소를 열어 구독 내용이 반환되는지, 로그인 안내나 오류 페이지가 표시되는지 확인할 수도 있습니다. 서비스에 인증 매개변수가 필요하다면 원래 주소의 전체 쿼리 문자열을 그대로 유지해야 합니다. 수정 후 구독 그룹을 새로 만든 다음, 단일 노드 가져오기 창에 구독 주소를 붙여넣지 마세요.

구독 업데이트에 실패하거나 계속 네트워크 오류가 표시되면 어떻게 해야 하나요?

현재 네트워크에서 구독 주소에 접속할 수 있는지 먼저 확인하고, 인증서 연결에 영향을 줄 수 있으므로 기기의 날짜, 시간, 시간대가 정확한지도 점검하세요. 클라이언트에서 구독 업데이트에 사용할 프록시 방식을 설정할 수 있다면 직접 연결과 현재 프록시를 통한 업데이트를 각각 테스트합니다. 이후 중복 실행 중인 클라이언트 프로세스를 종료하고 다시 시작한 뒤 업데이트하세요. 계속 실패한다면 응답 상태, 업데이트 시각, 구독 그룹 이름을 기록해 주소 만료, 인증 만료, 로컬 네트워크 요청 차단 여부를 판단합니다.

Android 설치 패키지에서 arm64와 universal 중 무엇을 선택해야 하나요?

2015년 이후 출시된 주요 Android 스마트폰과 태블릿은 대체로 64비트 ARM 프로세서를 사용하므로 먼저 arm64 설치 패키지를 선택할 수 있습니다. 해당 아키텍처 구성 요소만 포함해 파일 크기가 보통 더 작습니다. 프로세서 아키텍처를 확인하기 어렵거나 기기가 오래되었거나 arm64 패키지 설치 중 호환되지 않는다는 메시지가 표시될 때는 universal 범용 패키지를 선택하세요. 범용 패키지는 더 많은 프로세서 아키텍처를 지원하지만 같은 버전의 arm64 패키지와 기능상 본질적인 차이는 없으므로 두 버전을 모두 설치할 필요는 없습니다.

macOS에서 처음 v2rayN을 열 때 시스템이 차단하면 어떻게 해야 하나요?

먼저 앱을 응용 프로그램 폴더에 넣고 한 번 실행해 시스템에 차단 기록이 생성되도록 하세요. 그런 다음 시스템 설정의 개인정보 보호 및 보안 페이지에서 최근 차단된 앱 항목을 찾아 실행을 허용합니다. 처음 연결할 때 로컬 네트워크, 네트워크 확장 또는 프록시 관련 권한 요청이 표시되면 실제 사용 모드에 맞게 허용하세요. 앱이 반복해서 격리된다면 기존 복사본을 삭제한 뒤 앱을 다시 배치하고, 압축 파일이나 임시 다운로드 폴더에서 직접 실행하지 마세요.

OPERATIONS

사용 팁

먼저 단일 노드가 기본 모드에서 연결되는지 확인한 다음 라우팅, DNS, TUN 설정을 단계적으로 추가하세요. 항목별로 변경하면 실제 적용 범위를 더 쉽게 파악할 수 있습니다.

여러 노드를 가져온 뒤 프록시 모드는 어떻게 선택해야 하나요?

먼저 매개변수가 완전하고 최근에 사용할 수 있었던 노드 하나를 선택한 뒤 규칙 모드부터 테스트하세요. 규칙 모드는 라우팅 규칙에 따라 직접 연결 또는 프록시를 결정하므로 일상적인 사용에 적합합니다. 전역 모드는 더 많은 트래픽을 현재 프록시로 보내며, 일반적으로 누락된 규칙을 찾을 때만 사용합니다. 직접 연결 모드는 로컬 네트워크를 빠르게 복구할 때 활용합니다. 모드를 바꾸기 전 기존 설정을 기록하고 한 번에 하나의 변수만 변경하세요. 브라우저와 대상 앱에서 각각 확인해야 노드, DNS, 라우팅을 동시에 바꾼 뒤 원인을 알 수 없는 상황을 피할 수 있습니다.

클라이언트에는 연결됨으로 표시되지만 시스템 프록시가 적용되지 않으면 어떻게 해야 하나요?

클라이언트가 코어만 시작한 것이 아니라 시스템 프록시 설정까지 실행했는지 먼저 확인하고, 운영체제 프록시 설정의 주소와 포트가 클라이언트의 로컬 리스닝 주소와 일치하는지 점검하세요. 그런 다음 대상 브라우저나 앱을 완전히 종료했다가 다시 여세요. 일부 프로그램은 시작할 때만 프록시 설정을 읽습니다. 시스템에서 다른 프록시 도구, 네트워크 가속 도구, 관리 스크립트가 함께 실행 중이라면 잠시 종료해 프록시 설정이 즉시 덮어써지지 않도록 하세요. 마지막으로 LAN 또는 수동 프록시 설정에 이전 포트가 남아 있지 않은지 확인합니다.

TUN을 활성화할 때 권한 부족 또는 인터페이스 생성 실패가 표시되면 어떻게 해야 하나요?

데스크톱 운영체제에서는 클라이언트가 관리자 권한으로 가상 네트워크 인터페이스를 생성하도록 허용해야 하며, Android에서는 시스템에 표시되는 VPN 연결 권한을 승인해야 합니다. 권한을 허용했는데도 실패한다면 가상 인터페이스를 사용 중인 다른 VPN이나 프록시 프로그램을 먼저 종료한 뒤 클라이언트를 다시 시작하세요. Windows에서는 관련 서비스와 드라이버가 보안 정책에 의해 차단되지 않았는지 확인하고, Linux에서는 현재 계정에 네트워크 관리 권한이 있는지 점검합니다. 변경 후에는 TUN을 끈 다음 다시 활성화하고, 스위치를 연속해서 반복 클릭하지 마세요.

라우팅 규칙과 DNS 분할은 어떤 순서로 조정해야 하나요?

먼저 기본 DNS 설정을 유지한 채 범위가 명확한 라우팅 규칙 하나만 조정하고, 대상 도메인이 실제로 예상한 출구를 사용했는지 확인하세요. 라우팅 결과는 정상인데 도메인 해석에 문제가 계속되면 DNS 조회가 직접 연결되는지 프록시를 통하는지, 로컬 캐시가 활성화되어 있는지, 앱이 별도의 암호화 DNS를 사용하는지 점검합니다. 매번 변경한 뒤 클라이언트 DNS 캐시를 지우고 연결을 다시 시도하세요. 여러 규칙 세트와 DNS 방식을 한꺼번에 가져오면 로그에서 최종 적용 항목을 찾기 어렵습니다.

TROUBLESHOOTING

문제 해결

기본 네트워크부터 시작해 코어 실행, 노드 매개변수, 로컬 포트, 트래픽 처리, 라우팅, DNS를 차례로 확인하세요. 로그는 문제가 어느 계층에서 발생했는지 파악하는 데 사용합니다.

노드 테스트가 계속 시간 초과될 때 어디부터 점검해야 하나요?

먼저 같은 구독의 다른 노드로 전환해 특정 노드의 문제인지 전체 노드의 문제인지 확인하세요. 모든 노드가 시간 초과되면 기기 네트워크, 시스템 시간, 구독 만료 여부, 클라이언트 코어의 정상 실행 여부를 점검합니다. 특정 노드만 시간 초과된다면 주소, 포트, 전송 방식, TLS, SNI, 경로 등의 매개변수를 중점적으로 확인하세요. 지연 시간 테스트 방식은 실제 연결 방식과 다를 수 있으므로 한 번의 테스트 결과만으로 판단하지 말고 클라이언트 로그와 실제 웹 접속 결과를 함께 확인해야 합니다.

노드는 연결 성공으로 표시되지만 웹페이지와 앱 모두 인터넷에 연결되지 않으면 어떻게 해야 하나요?

먼저 시스템 프록시나 TUN을 끄고 기본 네트워크가 정상인지 확인한 뒤 다시 연결하면서 트래픽 처리 방식은 하나만 활성화하세요. 이후 로컬 리스닝 포트, 시스템 프록시 포트, 앱의 수동 프록시 포트가 일치하는지 점검합니다. 도메인은 열리지 않지만 알고 있는 주소에 직접 접속하면 응답이 오는 경우 문제는 대개 DNS에 있습니다. 모든 요청이 실패한다면 라우팅 출구, 코어 로그, 노드 매개변수를 확인하세요. 방화벽이 클라이언트 프로세스를 차단하는지, 이전 프록시 설정이 정리되지 않았는지도 함께 점검해야 합니다.

V2Ray 클라이언트가 열리지 않거나 실행 후 종료되고 인터페이스가 응답하지 않으면 어떻게 해야 하나요?

먼저 작업 관리자나 시스템 모니터에 남아 있는 프로세스를 종료한 뒤 정식 설치 폴더에서 실행하세요. Windows에서는 데스크톱 실행 환경이 완전한지, 설정 폴더에 쓰기 권한이 있는지, 로컬 포트가 사용 중인지 확인합니다. macOS에서는 최초 실행 권한을 중점적으로 점검하고, Linux에서는 터미널에서 앱을 실행해 오류 출력을 확인할 수 있습니다. 최근 설정을 가져온 뒤 문제가 시작되었다면 설정 폴더를 먼저 백업하고 최근 생성된 설정 파일을 다른 곳으로 옮긴 다음, 클라이언트를 기본 상태로 시작해 하나씩 복원하세요.

구독 업데이트는 성공했지만 노드 목록이 바뀌지 않는 이유는 무엇인가요?

현재 보고 있는 구독 그룹이 업데이트되었는지, 이름이 비슷한 다른 그룹을 업데이트한 것은 아닌지 먼저 확인하세요. 일부 클라이언트는 기존 노드를 유지하거나 메모를 기준으로 중복 항목을 병합하며, 새 노드를 다른 그룹에 넣기도 하므로 업데이트 로그와 그룹 필터 조건을 확인해야 합니다. 서버가 지난번과 동일한 내용을 반환했다면 클라이언트에 새 노드가 추가되지 않는 것이 정상입니다. 해당 구독의 로컬 캐시를 삭제한 뒤 다시 업데이트할 수도 있지만, 정리 과정에서 손실되지 않도록 사용자 지정 라우팅과 수동 노드를 먼저 내보내세요.