클라이언트 설정 및 문제 해결

v2rayN 자주 묻는 질문

구독, 시스템 프록시, TUN 및 연결 문제.
증상에 맞춰 설정을 확인하고 한 번에 하나씩 변경하세요.

v2rayN, v2rayNG, v2flyNG를 다룹니다. 메뉴 이름은 클라이언트 업데이트에 따라 달라질 수 있으니 문제를 확인할 때 현재 설정과 로그의 첫 오류를 기록하세요.

클라이언트와 설정 출처

기초 입문

먼저 클라이언트, 서버 설정, 트래픽 처리 방식을 구분하세요.

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

Windows, macOS, Linux 데스크톱에서는 v2rayN을 우선 고려하세요. Windows용 Desktop 버전은 크로스 플랫폼 인터페이스를, WPF 버전은 기존 Windows 인터페이스를 사용하므로 다운로드 페이지의 실행 환경 요구 사항을 확인해 선택하면 됩니다. Android에서는 Xray 코어를 사용하는 v2rayNG가 적합하며, V2Fly 코어가 필요하다면 v2flyNG를 고려하세요. 클라이언트 이름이 비슷해도 설정과 프로토콜 지원이 완전히 같지는 않습니다. 이전하기 전에 서버에서 요구하는 프로토콜, 전송 방식, 보안 매개변수를 대상 클라이언트가 지원하는지 확인한 뒤 설정을 가져오세요. 링크가 인식된다는 이유만으로 정상 작동한다고 판단해서는 안 됩니다.

클라이언트를 설치한 뒤에도 구독이나 서버 설정이 필요한 이유는 무엇인가요?

클라이언트는 설정을 읽고 프록시 코어를 실행한 뒤, 규칙에 맞는 네트워크 요청을 지정된 아웃바운드로 전달합니다. 설치 프로그램 자체가 사용할 수 있는 서버를 제공하지는 않습니다. 연결을 시작하려면 이용 권한이 있는 서비스 제공업체나 직접 구축한 서버에서 구독 주소, 공유 링크 또는 전체 수동 설정값을 받아야 합니다. 가져온 뒤에는 서버를 선택해 활성 서버로 지정하세요. 서버 주소만 있고 포트, 사용자 ID, 전송 매개변수가 빠져 있으면 대개 연결할 수 없습니다. 구독에는 접속 정보가 포함될 수 있으므로 문제를 확인할 때 전체 주소를 공개하거나 설정 화면 전체를 공개 게시판에 올리지 마세요.

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

vmess://, vless:// 등의 공유 링크는 보통 서버 하나의 정보를 담아 클립보드로 가져오기에 적합합니다. 구독 주소는 서버 목록과 이후 변경 사항을 가져오는 업데이트 가능한 네트워크 주소입니다. v2rayN에서는 공유 링크를 ‘서버’ 메뉴의 클립보드 가져오기 기능으로 추가하고, 구독 주소는 ‘구독 그룹 → 구독 그룹 설정’에서 새 그룹을 만든 뒤 입력하고 구독을 업데이트하세요. 구독 주소를 단일 노드 링크처럼 가져오면 형식 오류가 표시될 수 있습니다. 웹페이지에 표시된 제목을 실제 주소 대신 사용하지 말고, 복사할 때 설명 문구나 줄바꿈, 앞뒤 공백이 섞이지 않았는지 확인하세요.

시스템 프록시, 라우팅 규칙, TUN 모드는 각각 무엇을 제어하나요?

시스템 프록시는 시스템 프록시 설정을 따르는 앱의 요청을 클라이언트의 로컬 프록시 포트로 전달합니다. 라우팅 규칙은 코어에 들어온 요청을 프록시, 직접 연결, 차단 중 어디로 보낼지 정합니다. TUN 모드는 가상 네트워크 인터페이스를 통해 더 많은 앱의 트래픽을 처리합니다. 세 기능은 서로 다른 계층에서 작동합니다. 시스템 프록시를 켜도 모든 프로그램이 자동으로 프록시를 사용하는 것은 아니며, 전역 라우팅을 선택했다고 트래픽이 코어로 들어온다는 뜻도 아닙니다. 처음에는 시스템 프록시로 서버 연결을 확인한 다음 앱 사용 방식에 따라 TUN을 활성화하세요. 연결 처리 방식을 바꿀 때는 정상 작동하는 설정을 따로 보관해 라우팅, DNS, 가상 인터페이스를 한꺼번에 바꾸고 원인을 찾지 못하는 상황을 피하세요.

더 알아보기: 세 클라이언트 비교 · 프로토콜 및 기능 용어집

설치 파일과 첫 연결

설치 및 설정

아키텍처 선택부터 시작해 가져오기 방법, 시스템 프록시, 권한을 확인하세요.

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

비교적 최신 Android 휴대전화라면 64비트 ARM 환경용 arm64 설치 파일을 우선 선택할 수 있습니다. 일반적으로 universal 버전보다 용량이 작습니다. 출시 연도만으로 호환 여부를 단정할 수는 없으며 프로세서와 운영체제가 해당 아키텍처를 지원하는지 확인해야 합니다. 확실하지 않다면 universal 버전을 선택하거나 시스템 정보에서 ABI를 확인하세요. ‘앱이 설치되지 않았습니다’라는 메시지가 뜨거나 설치 파일을 분석하지 못한다면 아키텍처뿐 아니라 운영체제 버전 요구 사항, 다운로드 완료 여부, 기기에 서명 정보가 다른 같은 이름의 앱이 설치되어 있는지도 확인하세요. 기존 앱을 삭제하기 전에는 구독과 사용자 지정 규칙을 잃지 않도록 필요한 설정을 내보내세요.

구독이나 공유 링크를 가져오지 못하면 무엇부터 확인해야 하나요?

먼저 가져오려는 것이 단일 서버 공유 링크인지, 네트워크에서 내용을 받아오는 구독 주소인지 구분하세요. 공유 링크는 프로토콜 접두사를 포함해 전체를 유지하고 클라이언트의 클립보드 가져오기 기능으로 추가합니다. 구독 주소는 구독 그룹에 입력한 다음 업데이트해야 합니다. 지원하지 않는 형식이라는 메시지가 나오면 제공업체에 클라이언트가 지원하는 설정 형식을 반환하는지 확인하세요. 웹페이지, 로그인 안내 또는 다른 앱의 설정 파일일 수도 있습니다. 복사한 내용에 따옴표, 설명 문구, 중간 공백이 들어갔는지도 확인하세요. 링크의 사용자 ID나 인코딩된 내용을 직접 수정하지 마세요. 업데이트 후에도 목록이 비어 있다면 현재 그룹 필터와 서버 필터 조건을 확인하세요.

v2rayN에서 시스템 프록시를 켰는데 브라우저에 변화가 없는 이유는 무엇인가요?

먼저 v2rayN 하단 메뉴에서 ‘시스템 프록시’를 ‘시스템 프록시 자동 설정’으로 바꾸고 활성 서버가 선택되어 있는지, 코어 로그에 시작 오류가 없는지 확인하세요. 다음으로 시스템 네트워크 설정의 프록시 주소와 포트가 클라이언트의 현재 로컬 수신 설정과 일치하는지 확인합니다. 브라우저 확장 프로그램, 브라우저 자체의 수동 프록시 설정, 다른 프록시 클라이언트가 시스템 설정을 덮어쓸 수 있으므로 문제를 확인하는 동안에는 트래픽 처리 방식을 하나만 사용하세요. 설정을 바꾼 뒤 브라우저를 다시 열어 테스트합니다. 명령줄 프로그램이나 일부 앱은 시스템 프록시 설정을 따르지 않을 수 있으므로 해당 프로그램의 직접 연결 결과만으로 시스템 프록시가 작동하지 않는다고 판단하면 안 됩니다. 이런 프로그램은 별도로 프록시를 설정하거나 TUN을 사용해야 합니다.

TUN 모드가 시작되지 않을 때 권한과 가상 인터페이스는 어떻게 확인하나요?

먼저 TUN을 끄고 일반 시스템 프록시로 정상 접속되는지 확인한 다음 가상 인터페이스 문제를 살펴보세요. Windows에서는 클라이언트를 종료하고 관리자 권한으로 다시 실행한 뒤 ‘Tun 사용’을 켭니다. macOS와 Linux에서는 클라이언트 안내에 따라 필요한 권한을 부여하세요. 모든 프로그램에 최고 권한을 계속 부여하지는 마세요. 로그에서 가장 먼저 나타난 오류를 확인해 권한 부족, 인터페이스 생성 실패, 라우트 추가 실패 중 무엇인지 구분합니다. 가상 네트워크 인터페이스를 사용하는 다른 도구를 잠시 종료한 뒤 다시 시도하세요. Android의 v2rayNG는 시스템 VPN 권한 절차를 사용합니다. 첫 연결 때 시스템 팝업에서 허용하고, 다른 VPN 연결이 이미 사용 중인지 확인하세요.

관련 경로: Android 설치 안내 · 첫 설정 가이드

그룹, 테스트 및 분할 라우팅

사용 팁

정상 작동하는 기준 설정을 보존하고 일상 설정을 하나씩 조정하세요.

구독이 여러 개일 때 업데이트 과정에서 헷갈리지 않도록 그룹을 나누려면 어떻게 하나요?

v2rayN의 ‘구독 그룹 → 구독 그룹 설정’에서 제공업체나 용도별로 그룹을 만들고 출처를 알아볼 수 있는 메모를 추가하세요. 서로 다른 주소를 같은 그룹에 반복해서 덮어쓰지 마세요. 주소를 바꾼 뒤에는 먼저 해당 그룹을 업데이트해 내용이 올바른지 확인하고, 필요하면 전체 구독을 업데이트합니다. 서버를 필터링할 때는 현재 선택된 그룹을 먼저 확인해 다른 그룹이 숨겨진 것을 데이터 손실로 오해하지 않도록 하세요. 구독으로 생성된 항목은 업데이트 과정에서 교체될 수 있으므로 장기간 유지할 수동 변경 사항은 별도 설정으로 저장하세요. 백업할 때는 사용자 지정 라우팅과 DNS도 기록하고, 복원 후 현재 설정에서 여전히 참조되는지 확인하세요.

Tcping, 실제 연결 지연 시간, 다운로드 속도 측정 중 무엇을 봐야 하나요?

Tcping은 주로 서버 포트와 TCP 연결을 맺을 수 있는지 확인합니다. 프록시 인증, 전송 핸드셰이크, 대상 웹사이트 접속까지 성공한다는 뜻은 아닙니다. 실제 연결 지연 시간은 프록시 경로를 통해 테스트 주소에 요청을 보내므로 일상적인 사용 환경에 더 가깝지만, 결과는 테스트 주소와 DNS, 라우팅 규칙에도 영향을 받습니다. 다운로드 속도 측정은 지속적인 전송 성능을 확인하며 보통 더 많은 데이터를 사용하므로 한 번의 결과만으로 회선을 비교하지 마세요. 먼저 실제 연결 테스트로 사용 가능한 설정을 추린 뒤 필요한 앱으로 확인하는 것이 좋습니다. 테스트 항목이 실패하면 관련 로그를 확인하고, 테스트 주소 접속 불가, 포트 연결 실패, 서버 설정 오류를 모두 ‘지연 시간 높음’으로 뭉뚱그리지 마세요.

v2rayNG 앱별 프록시의 프록시 모드와 우회 모드는 어떻게 사용하나요?

v2rayNG의 ‘설정’에서 ‘앱별 프록시’를 찾아 먼저 기능을 활성화한 다음, 화면 안내에 따라 선택한 앱을 프록시로 보내거나 프록시를 우회하도록 설정하세요. 두 모드는 앱 목록의 의미가 반대이므로 설정 후 체크한 앱을 다시 확인하고 연결을 중지했다가 재시작해 변경 사항을 적용하세요. 앱별 프록시는 어떤 앱이 VPN 처리 범위에 포함되는지 제어하며, 코어에 들어온 뒤 적용되는 라우팅 규칙을 대신하지는 않습니다. 프록시가 필요한 앱이 제외되어 있다면 전역 라우팅으로 바꿔도 다시 포함되지 않습니다. 백그라운드 다운로드나 시스템 구성 요소의 접속에 문제가 생기면 실제 요청을 보낸 주체가 다른 앱이나 시스템 서비스인지도 확인하세요.

DNS를 조정하거나 FakeDNS를 활성화해야 하는 경우는 언제인가요?

도메인 조회에 문제가 있거나 분할 라우팅이 예상대로 작동하지 않을 때, 또는 TUN 환경에서 특정 도메인 매핑이 필요할 때만 DNS와 FakeDNS 설정을 조정하세요. 먼저 현재 정상 작동하는 설정을 보존하고 모든 도메인에서 문제가 생기는지 일부 도메인에서만 발생하는지 기록한 다음 프록시 연결 자체가 정상인지 확인합니다. FakeDNS는 매핑에 사용하는 가상 주소를 반환하는 기능으로, 일반 공용 DNS 서비스가 아니며 모든 앱과 호환된다고 보장할 수 없습니다. 설정을 바꾸기 전 사용 중인 코어와 TUN 구현이 해당 기능을 지원하는지 확인하세요. 대응하는 트래픽 처리와 라우팅 설정 없이 스위치만 켜지 않도록 주의해야 합니다. 변경 후에도 문제가 계속되면 기존 설정으로 되돌리고 관련 앱을 다시 시작하세요. 남아 있는 DNS 캐시도 판단에 영향을 줄 수 있습니다.

추가 설정: 구독, 라우팅, DNS 고급 가이드

로그 및 연결 상태

문제 해결

먼저 문제의 범위를 확인하고 설정 가져오기, 연결 수립, 대상 접속의 세 단계를 구분하세요.

구독 업데이트에 실패하거나 업데이트 후 서버가 보이지 않을 때는 어떤 순서로 확인해야 하나요?

먼저 ‘구독 그룹 → 구독 그룹 설정’을 열어 주소가 완전한지, 만료되지 않았는지, 제공업체에서 새 주소를 받아야 하는지 확인한 다음 업데이트 로그의 오류를 살펴보세요. 연결 시간이 초과되면 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인합니다. 반환된 내용을 분석하지 못한다면 로그인 페이지나 오류 페이지, 호환되지 않는 형식을 받은 것은 아닌지 확인하세요. 직접 연결로 가져올 수 없다면 이미 사용 가능한 서버가 있을 때 ‘프록시를 통해 구독 업데이트’를 시도할 수 있습니다. 아직 가져오기에 성공하지 못한 설정에 의존하지 마세요. 업데이트는 성공했는데 목록이 비어 있다면 그룹 필터를 해제하고 서버 필터 조건을 확인하세요. 인증서 검증에 문제가 생기지 않도록 시스템 날짜와 시간도 올바른지 확인합니다.

서버 연결 시간이 계속 초과되면 포트를 바꿔야 하나요, 서버를 바꿔야 하나요?

먼저 기존 매개변수를 유지하고 포트를 임의로 바꾸지 마세요. 현재 네트워크에서 일반 웹사이트에 정상적으로 접속할 수 있는지 확인한 다음 활성 서버의 주소, 포트, 프로토콜, 전송 방식, 보안 매개변수가 제공업체 정보와 일치하는지 살펴보세요. 특히 TLS 서버 이름과 전송 경로를 확인해야 합니다. 로그를 보고 도메인 조회 실패, TCP 연결 시간 초과, 핸드셰이크 실패를 구분하세요. 각각 해결 방법이 다릅니다. 같은 구독의 다른 서버가 작동한다면 잠시 전환해 비교해 보세요. 특정 설정 하나의 문제인지 클라이언트 환경 전체의 문제인지 판단하는 데 도움이 됩니다. 제공업체에서 포트나 매개변수 변경을 명확히 안내한 경우에만 수정하세요. 로컬 테스트 실패만으로 원격 서비스가 중단됐다고 단정할 수는 없습니다.

연결됨으로 표시되지만 웹페이지가 모두 열리지 않을 때는 무엇을 확인해야 하나요?

‘연결됨’ 표시나 코어 실행은 로컬 프로세스가 시작됐다는 뜻일 뿐, 원격 요청이 성공한다는 의미는 아닙니다. 먼저 활성 서버가 올바른지 확인하고 코어 로그, 트래픽이 클라이언트로 들어오는지, 라우팅이 예상한 아웃바운드를 선택했는지, DNS 조회가 되는지 차례로 확인하세요. 시스템 프록시를 사용한다면 앱이 프록시 설정을 읽는지 확인합니다. TUN을 사용한다면 인터페이스와 라우팅 충돌을 피하도록 다른 VPN이나 프록시 도구를 먼저 종료하세요. 비교를 위해 명확한 프록시 라우팅으로 잠시 바꿔 테스트한 뒤 원래 규칙으로 되돌릴 수 있습니다. 일부 웹사이트만 열리지 않는다면 해당 도메인의 라우팅과 DNS를 따로 확인하세요. 설정을 전부 초기화하거나 여러 항목을 반복해서 바꾸지 마세요.

Android에서 화면을 잠근 뒤 연결이 끊기거나 클라이언트를 종료한 후 네트워크에 문제가 생기면 어떻게 해야 하나요?

화면을 잠근 뒤 연결이 끊긴다면 먼저 시스템의 v2rayNG 또는 v2flyNG 배터리 최적화, 백그라운드 실행, 백그라운드 네트워크 제한을 확인하고 기기 설정에서 필요한 백그라운드 활동을 허용하세요. 시스템 VPN 권한이 여전히 유효한지도 확인합니다. 일부 기기에서는 앱 자동 시작 설정도 확인해야 하며 시스템에 따라 메뉴 이름이 다를 수 있습니다. 클라이언트를 종료한 뒤 네트워크에 문제가 생긴다면 시스템에서 ‘VPN 상시 연결’ 또는 ‘VPN 없이 연결 차단’이 켜져 있는지 살펴보세요. 이 옵션은 클라이언트가 중지된 뒤에도 네트워크 연결을 제한할 수 있습니다. 데스크톱 클라이언트를 종료하기 전에는 TUN을 끄고 시스템 프록시를 해제하세요. 복구할 때는 남아 있는 트래픽 처리 설정부터 정리한 다음 다시 연결하고, 설정 폴더 전체를 바로 삭제하지 마세요.

분류 탐색 메뉴 위로