도움말 센터 · 증상별 확인
V2Ray 자주 묻는 질문 및 연결 문제 해결
먼저 설정 출처를 확인하고 트래픽 진입 경로를 살펴보세요. 한 번에 하나씩 변경한 뒤 같은 대상으로 다시 테스트하세요.
처음 사용하는 경우 사용 안내를 먼저 읽어 보세요. 설치 파일은 다운로드 센터에서 확인할 수 있습니다. 아래 내용은 네 가지 문제 유형으로 나뉘며, 질문을 누르면 전체 점검 방법을 볼 수 있습니다.
기본 개념
클라이언트, 코어, 프로토콜, 트래픽 진입 경로를 구분해 서로 다른 계층의 문제를 혼동하지 않도록 합니다.
V2Ray, Xray, v2rayN은 각각 무엇인가요?
V2Ray는 Project V 프록시 도구 생태계에 속합니다. V2Fly는 V2Ray 코어를 관리하고, Xray는 관련 기술을 바탕으로 한 분기입니다. 두 코어의 기능과 설정 세부 사항은 버전에 따라 달라질 수 있습니다. v2rayN은 설정 관리, 연결 선택, 시스템 프록시 설정, 해당 코어 실행을 담당하는 GUI 클라이언트이지 특정 프로토콜을 뜻하지 않습니다. 문제를 해결할 때는 먼저 UI 조작 문제인지 코어 연결 문제인지 구분한 뒤, 실제 사용 중인 코어와 로그를 확인하세요. 클라이언트 이름만으로 설정의 호환성을 단정할 수는 없습니다. 프로토콜, 보안 계층, 전송 방식, 코어 버전도 함께 확인해야 합니다.
클라이언트를 설치한 뒤 연결하려면 어떤 정보가 필요한가요?
클라이언트 설치는 설정과 연결에 필요한 도구를 갖춘 단계일 뿐입니다. 합법적으로 제공받아 사용할 권한이 있는 서버 설정도 필요합니다. 일반적인 형식은 단일 공유 링크, QR 코드, 구독 주소이며, 여기에는 서버 주소와 포트, 인증 정보, 전송 및 보안 계층 매개변수가 포함됩니다. 가져오기 전에 정보의 출처와 호환되는 클라이언트를 확인하세요. 일반 웹사이트 주소를 구독 주소로 착각해서는 안 됩니다. QR 코드와 공유 링크에 접속 정보가 포함될 수 있으므로 공개하지 마세요. 주소와 포트만 있고 인증 정보나 보안 계층 매개변수가 없다면 설정 제공자에게 문의해 필요한 정보를 받으세요. 프로토콜을 번갈아 바꾸며 정답을 추측해서는 안 됩니다.
공유 링크와 구독 주소는 어떻게 다른가요?
공유 링크는 보통 하나의 연결 설정을 나타내며, vmess://, vless://, trojan://, ss:// 같은 접두사가 사용됩니다. 구독 주소는 여러 설정을 가져오는 HTTPS 주소인 경우가 많습니다. 공유 링크는 특정 연결을 가져올 때, 구독 주소는 이후 설정 변경을 동기화할 때 편리합니다. 주소 모양만으로 판단하지 말고 제공자의 안내를 확인하세요. 공유 링크는 클립보드나 QR 코드 스캔으로 가져오고, 구독 주소는 구독 그룹에 추가한 뒤 업데이트해야 합니다. 구독 주소에 접속 정보가 포함될 수 있으므로 화면을 캡처하거나 도움을 요청하거나 로그를 복사할 때 전체 주소와 쿼리 매개변수를 가리세요.
전역 프록시, 규칙 기반 분할, TUN 모드는 어떻게 다른가요?
전역 프록시와 규칙 기반 분할은 코어에 들어온 트래픽을 어떤 경로로 내보낼지 결정합니다. TUN 모드는 어떤 시스템 트래픽을 가상 네트워크 인터페이스를 통해 코어로 보낼지 결정하므로 서로 다른 계층의 기능입니다. 시스템 프록시는 보통 해당 설정을 따르는 앱에만 적용되며, 모든 프로그램이 프록시를 사용하는 것은 아닙니다. 클라이언트의 전역 옵션도 현재 트래픽 진입 방식과 라우팅 설정에 따라 적용 범위가 달라집니다. 일상적인 사용이라면 먼저 시스템 프록시와 규칙 분할을 확인하고, 프록시를 사용할 수 없는 앱이 있을 때 TUN을 고려하세요. 진입 방식, DNS, 라우팅을 한꺼번에 바꾸면 문제의 원인을 찾기 어려워집니다.
설치 및 설정
클라이언트와 아키텍처를 먼저 선택한 뒤 설정을 가져오세요. 권한 문제와 연결 매개변수는 따로 확인해야 합니다.
Windows에서 v2rayN 데스크톱 버전과 클래식 WPF 버전 중 무엇을 선택해야 하나요?
데스크톱 버전은 크로스 플랫폼 UI를 사용하고, 클래식 WPF 버전은 Windows에서 익숙한 방식의 UI를 유지합니다. 먼저 다운로드 센터에서 해당 버전의 운영체제와 실행 종속성 요구 사항을 확인한 다음, 사용 방식에 맞춰 선택하세요. UI의 신구 여부만으로 연결 속도를 판단해서는 안 됩니다. 두 버전은 메뉴 위치, 설정 저장 위치, 마이그레이션 방법이 다를 수 있습니다. 전환하기 전에 클라이언트의 내보내기 또는 백업 기능으로 설정을 저장하고, 그 안의 인증 정보도 안전하게 보관하세요. 새 버전에서 가져오기와 연결이 정상적으로 되는지 확인한 뒤 기존 설정을 정리하세요. 실행 중 종속성 누락 메시지가 표시되면 안내에 따라 해결하고, 다른 버전의 프로그램 파일을 임의로 복사하지 마세요.
Android 설치 파일에서 arm64와 universal 중 무엇을 선택해야 하나요?
최근 출시된 Android 스마트폰 대부분은 arm64를 사용합니다. 기기 사양이나 시스템 정보에서 지원 여부를 확인한 뒤 arm64 패키지를 선택하세요. universal 패키지는 보통 여러 프로세서 아키텍처를 포함하므로 기기 아키텍처를 확인하기 어려울 때 유용하지만, 파일 크기가 더 큰 편입니다. 프로세서가 특정 아키텍처를 지원하더라도 현재 시스템 환경에서 해당 앱을 실행할 수 있다는 뜻은 아닙니다. 설치 결과는 기기 상태에 따라 달라질 수 있습니다. 설치 파일을 분석할 수 없다는 오류가 나오면 Android 버전 요구 사항, 다운로드 완료 여부, 설치 권한도 확인하세요. 같은 클라이언트를 업데이트할 때 서명이 다르면 덮어쓰기가 차단될 수 있으므로 먼저 설정을 백업하세요.
v2rayN 또는 v2rayNG에 구독 주소를 어떻게 가져오나요?
v2rayN에서 구독 그룹 설정을 열고 새 그룹을 추가한 뒤 알아보기 쉬운 이름과 전체 구독 주소를 입력하세요. 저장한 다음 해당 그룹을 업데이트합니다. v2rayNG에서는 구독 그룹 설정에 주소를 추가하고 저장한 뒤 목록으로 돌아가 구독 업데이트를 실행하세요. 메뉴 이름은 버전에 따라 다를 수 있습니다. 주소를 복사할 때 앞뒤 공백, 줄바꿈, 메신저가 덧붙인 문장 부호가 없는지 확인하세요. 업데이트 후 실제로 사용할 연결 설정을 선택하고 알맞은 프록시 진입 방식을 활성화해야 합니다. 단일 프로토콜 공유 링크를 받았다면 구독 주소 입력란이 아니라 클립보드 가져오기를 사용하세요. 두 가져오기 방식을 혼동하지 마세요.
TUN 모드를 켤 때 권한 부족 메시지가 표시되면 어떻게 해야 하나요?
TUN은 가상 네트워크 인터페이스를 만들거나 관리해야 하므로 데스크톱 운영체제에서는 관리자 권한, 권한이 높은 서비스 또는 시스템 승인이 필요할 수 있습니다. 필요한 권한은 클라이언트 버전과 플랫폼 구현에 따라 다릅니다. 먼저 로그에서 권한 오류를 확인하고 클라이언트 안내에 따라 권한을 부여하세요. 시스템 보안 기능을 바로 끄지는 마세요. Android에서는 보통 시스템 VPN 연결 승인 창이 표시되며, 승인해야 인터페이스를 만들 수 있습니다. 이미 실행 중인 다른 유사 연결과 충돌할 수도 있습니다. 처음 문제를 확인할 때는 TUN을 끄고 시스템 프록시로 같은 설정이 연결되는지 테스트하세요. 시스템 프록시는 정상인데 TUN만 실패한다면 서버 매개변수를 바로 바꾸기보다 권한, 인터페이스 생성, 라우팅 충돌을 확인하세요.
사용 팁
테스트 결과는 실제 요청과 함께 살펴보세요. 라우팅을 바꾸거나 구독을 업데이트할 때는 복구할 수 있는 기준 설정을 남겨 두세요.
설정을 여러 개 가져온 뒤 사용할 수 있는 노드를 어떻게 선택하나요?
먼저 구독 업데이트가 정상적으로 완료됐는지 확인하세요. 목록에서 연결할 설정을 선택하고 클라이언트의 실제 연결 테스트를 실행한 뒤, 실제 앱으로 접속해 확인합니다. TCPing은 대상 포트와 TCP 연결이 성립하는지 주로 확인할 뿐, 인증과 보안 계층, 프록시 출구가 정상인지까지 증명하지는 않습니다. 실제 연결 테스트도 선택한 테스트 주소에 접근할 수 있어야 합니다. 한 번 나온 숫자만으로 정렬하지 말고 자주 사용하는 서비스의 안정성, 지속적인 오류 발생 여부, 로그의 핸드셰이크 완료 여부를 함께 살펴보세요. 테스트할 때는 가능한 한 같은 네트워크, 대상, 라우팅 설정을 유지해야 서로 다른 조건의 결과를 잘못 비교하지 않습니다.
시스템 프록시가 적용됐는지 어떻게 확인하나요?
클라이언트에서 시스템 프록시 자동 설정 또는 해당 활성화 옵션을 선택하세요. 그런 다음 운영체제의 프록시 설정을 열어 프록시 주소가 로컬 기기를 가리키고, 포트가 클라이언트의 현재 수신 포트와 일치하는지 확인합니다. 시스템 프록시를 따르는 브라우저로 대상 페이지에 접속한 뒤, 클라이언트 로그나 연결 기록에 해당 요청이 표시되는지 살펴보세요. 브라우저에 별도 프록시 확장 프로그램이 설치되어 있다면 시스템 설정을 덮어쓰고 있는지 먼저 확인해야 합니다. 터미널 도구, 일부 다운로드 프로그램, 자체 네트워크 스택을 사용하는 앱은 시스템 프록시를 따르지 않을 수 있으므로 별도 설정이나 적절한 연결 방식을 사용해야 합니다. 클라이언트 프로세스가 실행 중이라는 사실만으로 앱의 요청이 프록시를 거쳤다고 볼 수는 없습니다.
규칙 분할을 잘못 수정해 접속이 끊기지 않게 하려면 어떻게 해야 하나요?
먼저 정상 작동하는 라우팅 설정을 백업한 뒤 대상 앱이나 도메인을 직접 연결할지, 프록시로 보낼지, 차단할지 정하세요. 규칙은 보통 순서대로 적용되므로 앞쪽의 포괄적인 조건이 뒤쪽의 구체적인 조건보다 먼저 적용될 수 있습니다. 규칙을 추가한 뒤에는 저장 여부만 확인하지 말고 실제로 어떤 경로가 선택됐는지 확인하세요. 도메인 규칙이 적용되는지는 요청에 도메인 정보가 포함되는지, 스니핑 설정, DNS 처리 방식에도 영향을 받습니다. 한 번에 한 조건만 수정하고 같은 대상으로 검증하세요. 잘못 차단했다면 가장 최근 변경부터 되돌리세요. 규칙 세트 이름과 지원 문법은 코어마다 다르므로 서로 다른 코어의 설정 전체를 그대로 섞어 사용하지 마세요.
구독을 업데이트하기 전에 무엇을 백업해야 하나요? 수동 수정도 유지할 수 있나요?
업데이트 전에 그룹 이름, 현재 사용하는 연결, 구독 주소, 별도로 관리하는 라우팅 및 DNS 설정을 기록하고 클라이언트 내장 백업 기능을 우선 사용하세요. 구독을 업데이트하면 원격에서 관리하는 연결 항목이 바뀔 수 있으며, 구독 항목을 직접 수정한 매개변수는 유지되지 않을 수 있습니다. 장기간 수정 사항을 유지해야 한다면 클라이언트가 지원하는 경우 별도 설정으로 복사하고, 구독 원본과 로컬 관리 버전을 구분하세요. 백업 파일에도 인증 정보가 들어 있을 수 있으므로 안전하게 관리되는 위치에 보관해야 합니다. 다른 기기나 클라이언트로 옮긴 경우에는 가져오기와 연결이 정상인지 확인한 뒤 기존 환경을 삭제하세요. 복구할 수 없는 화면 캡처만 남기지 마세요.
문제 해결
요청 경로를 따라 원인을 찾으세요: 구독 가져오기, 설정 파싱, 연결 핸드셰이크, 앱 연결, 도메인 조회.
구독 업데이트가 실패하거나 업데이트 후 목록이 비어 있으면 무엇을 확인해야 하나요?
먼저 구독 주소가 올바르게 입력됐는지, 만료 여부와 접근 권한에 문제가 없는지 확인한 다음 로그에서 요청 결과를 살펴보세요. 연결 시간 초과, 인증 실패, 응답 형식 인식 불가는 서로 다른 문제입니다. 응답이 로그인 페이지나 오류 안내라면 요청 자체가 성공했더라도 유효한 구독으로 볼 수 없습니다. 클라이언트가 제공자가 내보낸 구독 형식을 지원하는지 확인하고, 필요하다면 호환되는 형식으로 제공해 달라고 요청하세요. 비공개 주소를 낯선 변환 서비스에 입력하지 마세요. 사용 가능한 연결이 이미 있다면 구독 소스에 접근할 때 클라이언트의 프록시 업데이트 옵션을 시도할 수 있습니다. 목록이 갑자기 비었다면 그룹을 반복해서 삭제하지 말고, 추가 설정 손실을 막기 위해 먼저 백업을 보관하세요.
노드 연결이 시간 초과될 때 포트 테스트 결과만 봐서는 안 되는 이유는 무엇인가요?
시간 초과는 도메인 조회, 서버 연결, 보안 계층 핸드셰이크, 프록시 출구 요청 등 여러 단계에서 발생할 수 있습니다. 먼저 현재 네트워크에서 일반 웹사이트에 직접 접속할 수 있는지 확인하고, 로그에서 마지막으로 진행된 단계를 살펴보세요. TCP 포트에 연결할 수 있다는 것은 연결 경로의 일부가 열려 있다는 뜻일 뿐, UUID, 비밀번호, 서버 이름, 기타 보안 계층 매개변수가 올바르다는 뜻은 아닙니다. 설정이 만료되지 않았는지와 시스템 시간이 정확한지 확인하고, 사용 가능한 다른 설정과 비교하세요. 모든 설정이 실패한다면 로컬 방화벽, 네트워크 환경, 클라이언트 진입 방식을 먼저 확인하세요. 하나만 실패한다면 해당 서버의 상태와 설정을 집중적으로 점검하세요.
클라이언트는 연결됨으로 표시되는데 브라우저에서 인터넷에 접속할 수 없으면 어떻게 해야 하나요?
연결됨 표시는 로컬 서비스나 가상 인터페이스가 시작됐다는 의미일 수 있으며, 대상 요청이 성공했다는 보장은 아닙니다. 먼저 다른 프록시 도구를 끄고 현재 연결 설정이 선택됐는지 확인한 다음, 시스템 프록시 주소와 수신 포트가 일치하는지 살펴보세요. 클라이언트의 실제 연결 테스트와 브라우저 접속을 각각 실행하고, 로그에 요청이 들어오는지 확인합니다. 요청이 없다면 앱이 프록시를 우회하는지 확인하세요. 요청은 있지만 핸드셰이크에 실패한다면 연결 매개변수를 확인하고, 일부 도메인만 실패한다면 DNS와 라우팅을 살펴보세요. TUN을 사용 중이라면 잠시 시스템 프록시로 전환해 비교할 수 있습니다. 설정은 한 번에 하나씩 변경하고 결과를 기록해 비교 가능한 기준을 유지하세요.
IP 주소로는 접속되는데 도메인으로는 열리지 않으면 DNS 문제인가요?
이런 현상에서는 DNS를 먼저 확인할 만하지만, IP 주소로 직접 접속해도 HTTPS 인증서나 사이트 호스팅 방식 때문에 실패할 수 있으므로 한 번의 테스트만으로 단정할 수 없습니다. 클라이언트 로그에 이름 조회 시간 초과, DNS 서버에 연결할 수 없음, 도메인 규칙 미적용이 기록됐는지 확인한 뒤 시스템과 클라이언트의 DNS 설정을 각각 살펴보세요. 브라우저의 보안 DNS는 별도 경로를 사용할 수 있으므로 실제로 어떤 DNS가 쓰이는지 확인해야 합니다. DNS 처리 방식을 바꾼 뒤 관련 캐시를 지우고 같은 대상으로 다시 테스트하세요. 프록시 서버 주소가 도메인이라면 프록시 연결을 시작하기 전에 해당 도메인을 조회할 수 있어야 합니다. 아직 연결되지 않은 프록시에 DNS 요청을 의존시키지 마세요.