FAQ / 설정 및 문제 해결
V2Ray 자주 묻는 질문
구독, 프록시 모드, 연결 문제 해결
문제가 발생한 단계에 맞는 답변을 찾아보세요. 먼저 설정 입력을 확인하고, 코어 실행 상태를 점검한 다음, 앱의 트래픽이 프록시를 거치는지 확인하세요. 원인을 찾기 쉽도록 한 번에 한 항목씩 변경하세요.
클라이언트와 코어
기본 이해
클라이언트, 코어, 원격 서버를 먼저 구분하면 엉뚱한 단계의 설정을 반복해서 바꾸는 일을 줄일 수 있습니다.
V2Ray, Xray, v2rayN은 각각 어떤 역할을 하나요?
V2Ray는 Project V 프록시 기술 생태계에 속하며, V2Fly와 Xray는 관련 코어 계열입니다. 코어는 프로토콜 처리, 연결 수립, 라우팅을 담당합니다. v2rayN은 구독을 저장하고 서버를 선택해 설정을 생성하며 코어 실행을 관리하는 GUI 클라이언트입니다. 문제가 생기면 먼저 인터페이스가 열리는지, 코어가 시작되는지, 연결이 수립되는지를 구분하세요. 각 상황에 따라 점검 방법이 다릅니다. 같은 프로토콜 이름을 사용한다고 해서 새 설정 항목까지 모두 호환되는 것은 아닙니다. 가져오기 전에 현재 클라이언트와 실제로 사용하는 코어가 해당 설정을 지원하는지 확인하세요.
데스크톱과 Android에서는 어떤 클라이언트를 선택해야 하나요?
Windows, macOS, Linux 데스크톱에서는 v2rayN을 먼저 살펴보세요. Windows 다운로드 페이지에서는 Desktop과 클래식 WPF 인터페이스를 구분하므로 사용 방식과 시스템 요구 사항에 맞춰 선택하면 됩니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. 기존 설정이 V2Fly 코어를 명시적으로 필요로 할 때는 v2flyNG를 고려하세요. 이름이 비슷한지보다 플랫폼, 프로세서 아키텍처, 설정 호환성을 기준으로 선택해야 합니다. 클라이언트를 옮길 때는 기존 구독 주소와 필요한 라우팅 기록을 보관한 뒤 가져오기 테스트를 진행하세요. 서로 다른 클라이언트의 전체 백업을 그대로 복원할 수 있다고 가정하지 마세요.
클라이언트를 설치했는데 사용할 수 있는 서버가 없는 이유는 무엇인가요?
클라이언트는 설정과 연결을 관리할 뿐, 설치만으로 원격 서버가 만들어지지는 않습니다. 접근 권한이 있는 구독 주소를 사용하거나 서버 관리자가 제공한 개별 설정을 가져온 뒤 서버를 선택해 연결을 시작해야 합니다. 먼저 메인 화면에 어떤 구독 그룹이 표시되어 있는지 확인하세요. 빈 그룹을 가져오기 실패로 오해할 수 있습니다. 구독 주소에는 접근 정보가 포함될 수 있으므로 공개 게시판에 올리거나 전체 QR 코드를 다른 사람에게 보내지 마세요. 이 사이트는 클라이언트 안내와 설정 가이드를 제공하며, 사용 가능한 서버를 배포하지 않습니다. 프록시 모드와 네트워크 연결을 점검하려면 기존 설정이 유효해야 합니다.
시스템 프록시, 전역 라우팅, TUN 모드는 어떻게 다른가요?
시스템 프록시는 시스템 설정을 따르는 앱의 요청을 로컬 프록시로 보낼지 결정합니다. 라우팅 규칙은 요청이 코어에 들어온 뒤 어떤 아웃바운드로 보낼지 정합니다. TUN은 가상 네트워크 인터페이스를 통해 지정된 트래픽을 처리합니다. 서로 다른 단계의 기능이므로 전역 라우팅으로 바꿔도 모든 앱이 자동으로 시스템 프록시를 따르지는 않습니다. 처음 설정할 때는 TUN을 끄고 시스템 프록시로 브라우저 접속을 확인한 다음, 시스템 프록시를 따르지 않는 앱을 점검하세요. 특정 프로그램만 연결에 문제가 있다면 라우팅 모드를 계속 바꾸기보다 해당 앱이 어떤 프록시 진입점을 사용하는지 먼저 확인하세요.
가져오기, 아키텍처, 권한
설치 및 설정
입력 형식과 로컬 환경부터 확인하세요. 가져오기 실패, 설치 실패, 코어 시작 실패는 각각 다르게 해결해야 합니다.
v2rayN에서 구독을 가져오지 못하면 무엇부터 확인해야 하나요?
먼저 받은 항목이 구독 주소인지, 개별 공유 링크인지, 웹페이지 주소인지 구분하세요. 구독 주소는 구독 그룹 설정에 추가하고 저장한 뒤 구독 업데이트를 실행해야 합니다. 개별 공유 링크는 보통 클립보드에서 가져오기 기능으로 처리합니다. 복사할 때 앞뒤 공백과 줄바꿈을 제거하고 메신저에 포함된 설명 문구는 함께 붙여넣지 마세요. 지원하지 않는 형식이라는 메시지가 나오면 응답 내용이 로그인 페이지나 오류 페이지인지, 또는 변환이 필요한 다른 형식인지 확인하세요. 가져오기를 반복해서 누르기보다 입력 유형과 응답 내용을 확인한 다음 로그에서 파싱 오류를 살펴보세요. 메뉴 이름은 버전에 따라 조금씩 다를 수 있습니다.
Android 앱을 다운로드할 때 arm64와 universal 중 무엇을 선택해야 하나요?
먼저 기기 설정의 ‘휴대전화 정보’에서 프로세서 정보를 확인하세요. 아키텍처가 표시되지 않는다면 제조사의 사양을 참고하면 됩니다. 최근 출시된 Android 휴대전화는 대부분 arm64를 사용하므로 기기가 해당 아키텍처라면 arm64 패키지를 선택하세요. 아키텍처를 확인할 수 없거나 지원되는 여러 아키텍처와의 호환성이 필요할 때는 universal 패키지를 고려하면 됩니다. universal 버전이라고 더 빠르게 실행되는 것은 아닙니다. 일반적으로 더 많은 아키텍처 구성 요소를 포함해 파일 크기가 커질 수 있습니다. 설치 중 파싱 오류가 발생하면 Android 버전, 다운로드 완료 여부, 기존 앱과 서명 일치 여부도 확인하세요. 이 메시지만으로 아키텍처가 잘못됐다고 판단하지 마세요.
TUN을 켤 때 권한 부족 메시지가 나오면 어떻게 해야 하나요?
먼저 TUN을 끄고 일반 시스템 프록시 모드가 정상 작동하는지 확인하세요. 권한 문제와 구독 문제를 동시에 점검하지 않도록 하기 위해서입니다. Windows에서는 클라이언트를 종료한 뒤 관리자 권한으로 다시 실행해 보세요. macOS와 Linux에서는 클라이언트 안내에 따라 필요한 권한이나 보조 구성 요소를 설정하고, 프로그램 폴더 전체의 권한을 무작정 변경하지 마세요. Android에서는 처음 연결할 때 시스템 VPN 연결 요청을 허용하고, 다른 VPN 앱이 연결을 사용 중인지 확인하세요. 권한을 허용한 뒤에도 실패한다면 로그에서 가상 네트워크 어댑터 생성이나 라우팅 설정 오류를 확인하세요. 이런 문제는 구독을 바꾸기보다 로컬 환경부터 해결해야 합니다.
로컬 포트 10808이 사용 중인데 포트를 바꿔도 되나요?
포트를 바꿀 수 있지만 먼저 다른 클라이언트 인스턴스가 백그라운드에서 실행 중인지 확인하세요. 중복 실행 중인 인스턴스를 종료하고 다시 시작해 보세요. 그래도 다른 프로그램이 포트를 사용 중이라면 설정에서 사용 가능한 로컬 수신 포트로 변경한 뒤 저장하면 됩니다. 실제 포트 번호는 현재 화면에 표시된 값을 기준으로 하세요. 10808은 흔히 쓰이는 예시일 뿐입니다. 변경 후 코어를 재시작하고 브라우저 확장 프로그램이나 앱별 프록시에 직접 입력한 주소도 함께 수정하세요. 시스템 프록시도 다시 설정해야 합니다. 두 프로그램이 같은 수신 주소와 포트를 공유하지 않도록 하고, 오류를 없애려고 LAN 연결 허용을 함부로 켜지 마세요.
업데이트, 분할 라우팅, 테스트
사용 팁
정상 작동하는 기본 설정은 유지하고 업데이트 방식, 라우팅, 테스트 방법을 하나씩 조정하세요.
구독을 업데이트할 때 직접 연결과 프록시 연결 중 무엇을 선택해야 하나요?
현재 네트워크에서 구독 주소에 접속할 수 있다면 먼저 직접 연결로 업데이트하세요. 직접 접속에 실패하고 기존 프록시 연결이 정상 작동하는 것을 확인한 경우에만 프록시를 통한 업데이트를 선택하세요. 처음 가져오는 중이라 사용할 수 있는 서버가 없다면 프록시 업데이트는 동작하는 연결 경로가 없어 일반적인 해결책이 되기 어렵습니다. 업데이트 전에는 기존 그룹을 보관하고, 업데이트 후 서버 목록이 현재 그룹에 해당하는지 확인하세요. 인증 실패나 주소 만료가 표시되면 연결 방식을 바꿔도 대개 해결되지 않으므로 구독 권한과 유효 기간을 확인해야 합니다. 접근 정보가 노출되지 않도록 구독 주소를 공개 온라인 변환기나 네트워크 테스트 페이지에 입력하지 마세요.
중국 본토 우회 분할 라우팅은 어떻게 설정하며 규칙 순서는 어떻게 정해야 하나요?
v2rayN 라우팅 설정에서 필요한 중국 본토 우회 규칙 집합을 선택하고 저장한 뒤, 해당 규칙이 현재 라우팅으로 적용됐는지 확인하세요. 규칙은 보통 순서대로 매칭됩니다. 앞쪽의 포괄적인 규칙이 뒤쪽의 세부 규칙에 먼저 적용될 수 있으므로 특정 도메인 규칙은 범위가 넓은 규칙보다 앞에 배치하세요. geosite 또는 geoip 항목을 사용한다면 현재 코어가 해당 구문을 지원하고 규칙 데이터 파일을 사용할 수 있는지도 확인해야 합니다. 예상대로 직접 연결될 대상과 프록시를 거칠 대상을 각각 방문한 뒤 로그에서 아웃바운드 태그를 확인하세요. 브라우저에서 페이지가 열린다는 사실만으로 분할 라우팅이 의도대로 작동한다고 볼 수는 없습니다.
V2Ray 지연 시간 테스트와 다운로드 속도 측정 중 무엇을 봐야 하나요?
TCPing은 대상 포트와 TCP 연결을 수립할 수 있는지 주로 확인합니다. 실제 연결 지연 시간에는 프록시 경로와 테스트 대상에 요청을 보내는 과정도 영향을 줍니다. 다운로드 속도 테스트는 일정 시간 동안의 데이터 전송 성능을 측정합니다. 세 테스트는 확인하는 경로가 다르므로 결과를 서로 대신 사용할 수 없습니다. 평소에는 실제로 사용하는 대상에 안정적으로 접속되는지 확인하고, 실제 연결 지연 시간으로 응답성을 판단하세요. 다운로드가 중요하다면 짧게 속도 테스트를 추가로 진행하면 됩니다. 테스트 대상에 접속할 수 없어도 실패할 수 있으므로 한 번 시간 초과가 났다고 서버가 중단됐다고 볼 수는 없습니다. 여러 서버를 동시에 측정하면 로컬 대역폭 경쟁이 결과에 영향을 줄 수 있으니 피하세요.
다른 사람에게 도움을 요청할 때 어떤 로그와 환경 정보를 제공해야 하나요?
먼저 운영체제, 클라이언트 이름과 버전, 실제 실행 중인 코어, 프록시 모드, 문제가 발생한 절차를 기록하세요. 그런 다음 오류 전후의 연속된 로그 일부를 복사하면 됩니다. connection refused, i/o timeout, TLS 핸드셰이크 실패 같은 오류 키워드와 시간 순서는 남기되, 장시간 실행 기록 전체를 제출할 필요는 없습니다. 보내기 전에 구독 주소, 계정 식별 정보, 비밀번호, 토큰, 공개하고 싶지 않은 서버 정보를 삭제하세요. 로그 수준을 높여야 한다면 잠시만 적용하고 한 번 재현한 뒤 원래대로 되돌리세요. 최근 변경한 설정과 클라이언트를 종료했을 때 직접 연결이 정상인지 비교 결과도 함께 설명하면 오류 화면 하나보다 도움이 됩니다.
증상별로 문제 범위 좁히기
문제 해결
시간 초과는 결과일 뿐입니다. 로그와 비교 테스트를 함께 살펴 구독 접속, 원격 연결, 로컬 프록시 진입점, 도메인 확인 문제를 구분하세요.
구독 업데이트 실패 또는 업데이트 후 목록이 비었을 때는 어떻게 확인해야 하나요?
먼저 방금 업데이트한 그룹이 선택되어 있는지 확인한 다음 업데이트 로그를 살펴보세요. 도메인 이름 확인 실패는 보통 로컬 DNS나 네트워크 문제를, 연결 시간 초과는 접속 경로 문제를, 인증 실패는 주소나 권한 문제를 가리킵니다. 업데이트 성공으로 표시되는데 목록이 비어 있다면 응답에 인식 가능한 항목이 없거나 그룹 필터가 적용됐을 수 있습니다. 필터를 해제하고 기존 설정은 보관하세요. 서버를 모두 바로 삭제하지 마세요. 구독 주소가 웹페이지를 반환하거나 형식이 바뀌었다면 설정 제공자에게 지원되는 클라이언트 형식을 확인해야 합니다. 실제 접속 경로가 달라지는 경우에만 직접 연결과 프록시 연결 전환이 의미가 있으며, 만료된 인증 정보를 해결할 수는 없습니다.
서버 연결이 계속 시간 초과되는데 서버 문제인가요, 로컬 네트워크 문제인가요?
여러 서버를 한꺼번에 테스트하지 말고, 확인된 설정 하나만 선택하세요. 기기 시간이 정확하고 기본 네트워크가 작동하는지 확인한 다음 로그에서 도메인 확인 실패, 연결 시간 초과, 핸드셰이크 오류 중 무엇인지 살펴보세요. 포트에 연결된다고 프로토콜 설정까지 올바른 것은 아닙니다. TLS, 전송 방식, 서버 측 설정도 서로 일치해야 합니다. 같은 설정이 신뢰할 수 있는 다른 네트워크에서는 작동한다면 현재 네트워크, 방화벽, DNS를 먼저 점검하세요. 특정 서버 하나만 계속 실패하면 원격 서버 상태를 확인합니다. 테스트 결과는 대상의 영향을 받으므로 실제 앱 접속 결과와 로그를 함께 살펴보세요. 시간 초과 표시만 보고 클라이언트를 반복해서 재설치하지 마세요.
클라이언트는 연결됨으로 표시되지만 시스템 프록시가 작동하지 않으면 어떻게 하나요?
연결됨 표시는 클라이언트나 로컬 서비스가 실행 중이라는 뜻일 수 있지만, 요청이 원격 서버까지 도달했다는 보장은 아닙니다. 먼저 코어가 종료되지 않았는지 확인하세요. 그런 다음 시스템 프록시 메뉴에서 시스템 프록시 자동 설정을 선택하고 운영체제의 프록시 설정에 표시된 주소와 포트가 현재 로컬 수신 주소를 가리키는지 확인합니다. 브라우저 확장 프로그램, 앱별 프록시, 다른 프록시 도구가 설정을 덮어쓸 수 있으므로 점검 중에는 제어 수단을 하나만 남기세요. 브라우저는 정상인데 특정 앱만 실패한다면 해당 앱이 시스템 프록시를 따르는지 확인하세요. 모두 실패한다면 서버와 라우팅 로그를 추가로 점검해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시를 해제해 잘못된 설정이 남지 않도록 하세요.
웹페이지가 열리지 않고 로그에 DNS 오류가 나오면 어떤 설정을 바꿔야 하나요?
먼저 구독 도메인, 서버 도메인, 접속 대상 도메인 중 어느 쪽에서 실패했는지 확인하세요. 각각 DNS 확인 경로가 다를 수 있습니다. 프록시를 끈 상태에서 기본 네트워크로 자주 사용하는 도메인을 확인할 수 있는지 테스트하세요. 기본 DNS 확인도 실패한다면 먼저 시스템 네트워크와 DNS 설정을 고쳐야 합니다. 프록시 대상에서만 문제가 생긴다면 코어의 DNS 설정, 분할 라우팅 규칙, 원격 DNS 접속 경로를 확인하세요. DNS 결과가 있어야 연결할 수 있는 경로를 통해 DNS 요청을 보내 순환 문제가 생기지 않도록 주의해야 합니다. 변경 전에 기존 값을 기록하고 한 번에 한 항목씩 수정한 뒤 다시 테스트하세요. 브라우저의 보안 DNS와 앱 캐시도 결과에 영향을 줄 수 있으므로 여러 사용자 지정 DNS 설정을 동시에 추가하지 마세요.