V2Ray 문제 해결 가이드
먼저 문제가 발생한 단계를 확인한 뒤 관련 설정을 변경하세요. 설치, 구독 가져오기, 첫 연결 확인을 아직 마치지 않았다면 시작 가이드를 순서대로 따라 하세요. 이미 연결해 본 적이 있고 특정 문제가 생겼다면 이 페이지의 목차에서 해당 항목으로 바로 이동하면 됩니다. 시작 가이드에서는 정상적인 설정 절차를, 이 페이지에서는 어느 단계에서 막혔는지 확인하는 방법과 변경 사항이 효과 없을 때 복구하는 방법을 다룹니다.
연결은 됐지만 인터넷이 되지 않음
클라이언트에 연결됨으로 표시되어도 로컬 시작 절차가 완료됐다는 뜻일 뿐, 웹 요청이 올바른 출구를 통해 전달된다는 보장은 없습니다. 먼저 증상을 두 가지로 나눠 보세요. 클라이언트를 종료해도 웹페이지가 열리지 않는다면 기기 네트워크나 남아 있는 프록시 설정부터 확인합니다. 종료 후에는 정상이고 클라이언트를 실행할 때만 실패한다면 로컬 입력 지점, 라우팅, 출구를 점검하세요. 데스크톱에서는 대표 클라이언트인 v2rayN을 기준으로 설명하며, 메뉴 이름은 현재 화면을 따릅니다.
먼저 기본 네트워크를 정상화하세요
v2rayN에서는 먼저 트레이 메뉴에서 클라이언트가 설정한 시스템 프록시를 해제한 다음 프로그램을 종료하세요. 기기에 원래 기관에서 설정한 프록시가 있었다면 기존 설정으로 복구해야 하며, 무조건 끄면 안 됩니다. 안드로이드에서는 클라이언트 연결을 끊고 시스템의 VPN 화면에서 상태를 확인하세요. 항상 켜기 또는 VPN 연결이 끊겼을 때 연결 차단이 활성화되어 있다면, 연결 해제 후 인터넷이 되지 않는 것은 해당 정책의 결과일 수 있습니다. 관리 대상 기기의 정책은 직접 변경하지 말고 관리자에게 확인을 요청하세요.
브라우저에서 평소 접속할 수 있고 서로 다른 서비스에 속한 웹사이트 두 곳을 열어 보세요. 이미 열려 있는 탭만 확인하지 마세요. 캐시에 페이지 일부가 남아 있으면 실패가 간헐적인 것처럼 보일 수 있습니다. 기본 네트워크에서도 두 사이트 모두 열리지 않는다면 올바른 Wi-Fi에 연결했는지, 공용 네트워크 로그인이 필요한지, 같은 네트워크의 다른 기기는 정상인지 확인하세요. 한 기기에서만 실패하면 해당 기기의 프록시와 네트워크 설정을 먼저 살펴보고, 여러 기기에서 실패하면 네트워크 연결 자체를 확인하세요.
로컬 포트와 실제 웹 요청을 따로 테스트하세요
데스크톱에서 커널을 다시 시작하고 클라이언트 인스턴스는 하나만 실행하세요. 설정에서 로컬 SOCKS 포트를 확인합니다. 아래에서는 흔히 쓰이는 10808을 예로 들지만, 실제 테스트에는 화면에 표시된 값을 사용하세요. 두 번째 명령은 브라우저의 시스템 프록시 설정과 관계없이 요청을 로컬 프록시로 직접 전달합니다. 요청과 함께 도메인 이름도 프록시 측에서 처리하므로 해당 경로로 웹페이지에 접속할 수 있는지 확인하기 좋습니다. 시스템 설정은 변경되지 않습니다.
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/
첫 번째 명령에서 포트에 연결할 수 없다고 나오면 커널이 실행 중인지, 수신 주소가 로컬 루프백인지, 포트 번호를 잘못 입력하지 않았는지 확인하세요. 이 단계에서는 노드를 계속 바꿀 필요가 없습니다. 첫 번째 명령은 성공하지만 두 번째 명령에서 즉시 거부된다면 포트에 해당하는 프로토콜을 확인하세요. 로컬 HTTP 프록시와 SOCKS 프록시는 둘 다 수신 중이어도 서로 바꿔 쓸 수 없습니다. 두 번째 명령에서 대상 사이트의 응답 헤더를 받았다면 해당 요청은 정상적으로 전달된 것입니다. 그렇다고 모든 사이트에 접속할 수 있거나 브라우저가 같은 입력 지점을 사용한다는 뜻은 아닙니다.
로그에서 요청이 멈춘 단계를 확인하세요
로그 창을 열어 둔 상태에서 테스트 요청을 한 번만 보내고 시각을 기록하세요. 해당 시각에 연결 기록이 전혀 없다면 앱이 실제로 어떤 프록시를 사용하는지 확인한 다음, 로그 수준이 연결을 기록하기에 충분한지 살펴보세요. 요청이 들어온 기록은 있지만 예상한 출구가 선택되지 않았다면 현재 라우팅 구성과 앞쪽에 배치된 포괄적인 규칙을 확인하세요. 로그에 요청이 선택한 출구로 전달됐다고 표시되면 연결 시간 초과, 이름 확인, 핸드셰이크 중 처음 발생한 오류를 살펴보세요. 마지막 재시도 실패를 근본 원인으로 단정하지 마세요.
문제 해결을 마치기 전에 이전에 효과가 있던 설정을 하나씩 복원한 뒤 실제 사용 환경에서 다시 확인하세요. 예를 들어 직접 연결할 일반 웹페이지와 프록시로 처리할 테스트 페이지를 함께 엽니다. 명령줄에서 지정한 프록시로는 계속 성공하지만 평소 사용하는 앱에서 열리지 않는다면 시스템 프록시가 작동하지 않음으로 이동하세요. 특정 서비스의 도메인만 연결되지 않는다면 클라이언트 전체를 재설치하지 말고 먼저 DNS 문제를 확인하세요.
노드 시간 초과 및 핸드셰이크 실패
지연 시간 테스트에서 시간 초과가 발생해도 테스트 방식에 따라 의미가 달라집니다. 일부 테스트는 대상 포트 연결만 시도하고, 다른 테스트는 노드를 통해 테스트 페이지에 접속합니다. 전자가 성공해도 프로토콜 핸드셰이크가 정상이라는 뜻은 아니며, 후자가 실패해도 테스트 사이트 자체에 접속할 수 없는 것일 수 있습니다. 같은 노드로 일반 웹페이지 요청을 한 번 보내고 로그 시각을 클릭한 시점과 맞춘 다음 주소, 포트, 핸드셰이크 매개변수 중 무엇을 확인할지 판단하세요.
시간, 노드 주소, 대상 포트 확인
시스템 날짜와 시간, 시간대를 확인하고 신뢰할 수 있는 시간 서버와 동기화되도록 설정하세요. 인증서 유효 기간은 시스템 시각을 기준으로 하므로, 기기가 오랫동안 절전 상태였거나 시간을 직접 변경했다면 특히 확인할 필요가 있습니다. 동기화 후 오류가 사라졌다면 정확한 시간을 유지하고 프로토콜 매개변수는 바꾸지 마세요. 로그에 서버 도메인을 찾을 수 없다고 나오면 도메인이 완전히 가져와졌는지 확인한 뒤 시스템 DNS 결과와 클라이언트가 실제로 사용한 결과를 비교하세요. 테스트 목적으로 구독에 설정된 서버 이름을 임시 주소로 영구 변경하지 마세요.
TCP 기반 연결을 확인하고 있고 해당 서비스를 직접 관리하거나 테스트 권한을 받은 경우, Windows에서 Test-NetConnection을 사용해 실제 서비스 포트를 확인할 수 있습니다. 명시적으로 연결 거부가 발생하면 서비스가 예상한 주소와 포트에서 수신 중인지, 연결 지점이 잘못되지 않았는지 확인하세요. 계속 시간 초과가 발생한다면 네트워크 경로, 접근 규칙, 서비스 중단도 고려해야 합니다. 포트 연결 성공은 TCP 연결이 성립했다는 뜻일 뿐, 인증서나 전송 경로, 인증 절차를 검증하지는 않습니다. UDP 기반 전송을 사용한다면 이 TCP 테스트 결과를 결론으로 삼을 수 없습니다.
같은 재현 과정에서 핸드셰이크 항목 확인
노드 세부 정보에서 서버가 제공한 원본 매개변수를 확인하세요. 프로토콜, 서버 포트, 전송 방식, 보안 유형을 먼저 확인한 다음 서버 이름, 호스트 헤더, 전송 경로를 살펴봅니다. 서버 주소는 연결할 대상이고 TLS 서버 이름은 핸드셰이크와 인증서 신원 확인에 사용됩니다. 전송 계층의 호스트 헤더나 경로는 이후 서비스 식별에 쓰입니다. 값이 같은 경우도 있지만 무조건 동일한 값으로 입력해서는 안 됩니다. 가져온 설정에 표시되지 않는 항목은 경험에 따라 임의로 채우지 말고 설정 출처에서 확인하세요.
로그에 인증서 이름 불일치, 인증서 만료 또는 신뢰할 수 없는 체인 오류가 먼저 나온다면 해당 오류에 맞게 처리하세요. 인증서 검증을 건너뛰는 것은 해결책이 아닙니다. TLS 오류 전에 읽기 시간 초과가 있었다면 인증서뿐 아니라 상위 전달 구간이나 서비스 응답 대기 중에 지연이 발생했을 수도 있습니다. 커널 기능과 관련된 안내가 있다면 클라이언트 비교에서 사용할 클라이언트를 확인하고 Xray와 V2Fly 코어 차이를 살펴보세요. 코어를 바꾸기 전 설정을 보관하고, 노드와 코어를 동시에 바꾸지 않아 결과를 비교하기 어렵게 만들지 마세요.
교차 테스트로 연관성과 원인을 구분하세요
기기와 네트워크를 그대로 둔 채 이미 정상 작동을 확인한 다른 노드를 테스트하세요. 그런 다음 문제가 있는 노드는 유지하고 정상 작동이 확인된 다른 네트워크에서 다시 테스트합니다. 같은 노드가 두 네트워크에서 모두 실패한다면 노드 설정이나 서버 상태를 중점적으로 확인하세요. 여러 노드가 한 네트워크에서만 실패한다면 접속 네트워크를 살펴보세요. 네트워크를 바꾸면 주소 체계나 DNS 서비스도 함께 바뀔 수 있습니다. 따라서 테스트 결과는 범위를 좁히는 데 활용하고, 한 번 성공했다는 이유만으로 원인을 단정하지 마세요.
서비스 관리자에게 전달할 기록에는 실패 시각과 시간대, 사용한 전송 유형, 서버 포트까지 연결됐는지, 로그에서 가장 먼저 발생한 오류를 포함하세요. 인증 정보나 공유 링크, 구독 주소가 포함된 스크린샷은 공개하지 마세요. 오류의 의미를 더 알아보려면 자주 나타나는 로그 오류 안내를 참고하세요. v2rayN 화면을 기준으로 작업 순서를 확인하려면 노드 시간 초과 해결 순서를 살펴보세요.
구독 업데이트 실패 또는 목록이 비어 있음
구독 업데이트는 콘텐츠를 가져오는 단계와 노드를 파싱하는 단계로 나뉩니다. 업데이트 실패 메시지가 나오면 먼저 네트워크 요청을 확인하세요. 업데이트 완료로 표시되는데 노드가 보이지 않으면 현재 그룹, 응답 본문, 형식을 확인합니다. 시작하기 전에 계속 사용할 수 있는 기존 그룹을 보관하고 목록부터 비우지 마세요. 테스트를 위해 개인 구독 주소를 온라인 변환 서비스에 보내서도 안 됩니다. 많은 구독 링크는 그 자체로 접근 권한을 제공하므로 전체 주소가 노출되면 비밀번호가 노출된 것처럼 취급해야 합니다.
어떤 주소와 그룹을 업데이트하는지 확인하세요
v2rayN의 구독 그룹 설정에서 현재 그룹과 주소를 확인하고, 저장 후 다른 그룹이 아니라 해당 그룹을 선택해 업데이트했는지 확인하세요. 안드로이드에서는 v2rayNG 또는 v2flyNG의 구독 그룹 관리에서 같은 내용을 확인한 뒤 노드 목록으로 돌아가 업데이트하세요. 주소를 복사할 때 앞뒤 공백, 줄바꿈, 메신저가 자동으로 붙인 문장 부호에 주의하세요. 주소의 쿼리 매개변수는 필요한 값일 수 있으므로 임의로 자르거나 다시 인코딩하지 마세요.
목록에 기존 항목만 계속 표시된다면 키워드 검색, 그룹 필터, 현재 그룹만 표시 옵션이 켜져 있는지 확인하세요. ‘그룹 추가’와 ‘그룹 업데이트’도 구분해야 합니다. 그룹을 추가하는 것은 주소를 저장하는 것일 뿐, 콘텐츠가 성공적으로 가져와졌다는 뜻은 아닙니다. 비교를 위해 임시 그룹을 추가해도 원래 그룹을 바로 삭제하지 마세요. 새 그룹에서 노드를 선택하고 연결할 수 있는지 확인한 다음 중복 항목을 정리하세요.
가져오기 결과에 따라 확인하세요
로그에 이름 확인 실패, 연결 시간 초과, 인증서 오류가 표시되면 구독 콘텐츠를 가져오는 네트워크 경로부터 확인하세요. 클라이언트가 구독을 직접 업데이트하는지, 프록시를 통해 업데이트하는지 확인하고 후자라면 필요한 기존 노드가 작동하는지도 살펴보세요. 모든 노드가 작동하지 않는 상황에서 프록시로 업데이트하면 순환 의존성이 생길 수 있습니다. 이때는 구독 서비스에 정상 접속할 수 있는 네트워크를 사용하거나 관리자에게 유효한 접근 경로를 요청하세요. 같은 실패 요청을 계속 반복하지 마세요.
인증되지 않음 또는 접근 금지 오류가 나오면 구독이 만료됐는지, 권한이 재설정됐는지 확인하고 관리자가 제공한 새 주소를 사용하세요. 리소스를 찾을 수 없다는 오류는 경로가 바뀌었는지 확인합니다. 요청이 너무 많다는 안내가 나오면 서비스 규정에 따라 기다리세요. 상태가 성공으로 표시돼도 실제 응답은 로그인 페이지, 점검 페이지, 오류 안내일 수 있습니다. 신뢰할 수 있는 기기에서 응답 유형만 확인하고 본문을 포럼에 복사하지 마세요. 해당 주소에 접속하려면 로그인이 필요한 경우 그래픽 클라이언트는 보통 브라우저 로그인 상태를 자동으로 사용하지 않습니다.
응답 형식과 노드 호환성 확인
단일 노드 공유 링크, 노드 목록 구독, 전체 커널 설정은 서로 다른 형식입니다. 전체 설정을 구독 주소 입력란에 붙여 넣어도 유효한 목록이 만들어지지 않습니다. 일부 서비스는 요청한 클라이언트에 따라 형식을 다르게 반환하므로, 브라우저에서 같은 주소의 텍스트를 내려받을 수 있어도 현재 클라이언트가 파싱할 수 있다는 뜻은 아닙니다. 해당 주소가 지원하는 클라이언트 형식을 제공처에 확인하세요. 인코딩된 전체 텍스트를 직접 분해하거나 수정하지 마세요. 일부 항목만 나타난다면 누락된 프로토콜이나 전송 방식을 기록하고 사용 가능한 커널이 해당 필드를 지원하는지 확인하세요.
업데이트 후에는 대상 그룹에 예상한 노드가 나타났는지 확인하고 노드를 하나 직접 선택해 웹 요청을 보내세요. 목록이 표시되면 파싱 결과가 있다는 뜻이지만 모든 노드가 연결된다는 보장은 없습니다. 반대로 기존 노드가 작동해도 구독이 업데이트됐다는 증거는 아닙니다. 이전 콘텐츠가 계속 표시된다면 클라이언트가 보여 주는 업데이트 결과를 기록하고 서버 캐시나 게시 지연 여부를 확인하세요. 새 항목과 기존 항목의 차이를 확인한 뒤 그룹을 정리합니다. 해당 메뉴를 찾지 못했다면 시작 가이드에서 가져오기 절차를 확인하세요.
속도 저하와 간헐적인 끊김
먼저 느린 현상이 무엇인지 구체적으로 구분하세요. 도메인을 처음 열 때 오래 기다리는지, 다운로드가 시작된 뒤에도 전송 속도가 계속 낮은지, 실시간 음성·영상이 간헐적으로 끊기는지 확인합니다. 각각 이름 확인과 연결 설정, 지속 전송, 지연 변동이나 패킷 손실과 관련될 수 있습니다. 화면에 표시된 단일 지연 시간은 한 번의 응답 시간만 보여 주며 대용량 다운로드 속도를 뜻하지 않습니다. 속도 측정 사이트가 빠르더라도 실제 업무 서비스가 같은 경로에서 똑같이 작동한다는 보장은 없습니다.
반복 가능한 비교 테스트를 준비하세요
동기화, 백업, 다른 다운로드를 일시 중지하고 공개적으로 접근할 수 있는 같은 테스트 리소스를 골라 비슷한 시간대에 기본 네트워크와 프록시 경로의 결과를 기록하세요. 비슷한 크기의 리소스로 여러 번 테스트해 대표적인 결과를 비교하고 가장 빠른 기록만 고르지 마세요. 두 경로에서 같은 사이트에 접속할 수 없다면 각각 접속 가능한 기준만 비교하고, 동일 대상에 대한 엄밀한 비교로 취급하지 마세요. 첫 접속 대기 시간, 지속 전송 추세, 중단 여부를 각각 기록하면 비슷해 보이는 끊김을 구분하는 데 도움이 됩니다.
노드는 유지하고 Wi-Fi, 유선 네트워크, 모바일 데이터 중 두 가지 환경에서 테스트하세요. 그런 다음 네트워크는 그대로 두고 작동이 확인된 다른 노드와 비교합니다. 기본 네트워크와 프록시 경로가 모두 느려졌다면 신호, 백그라운드 트래픽, 네트워크 회선을 먼저 확인하세요. 같은 조건에서 특정 노드만 계속 느리다면 서비스 측에 대역폭 제한이나 부하를 문의하세요. 특정 시간대에만 발생한다면 다른 시간에도 테스트해 야간의 일시적인 혼잡을 설정 문제로 오해하지 마세요.
비교 중인 경로로 트래픽이 실제 전달되는지 확인하세요
클라이언트 로그에 실제 요청을 기록하고 대상 도메인과 출구 태그를 확인하세요. 앱이 자체 프록시 설정에 따라 직접 연결하거나 현재 라우팅의 기본 규칙을 따를 수 있어, 의도한 경로와 다르게 전달될 수 있습니다. 일부 시스템의 프록시 입력 지점은 주로 HTTP 또는 HTTPS 요청을 처리하므로 실시간 앱의 UDP 트래픽도 같은 경로를 지난다고 단정할 수 없습니다. 문서와 로그를 확인해 해당 앱이 현재 연결 방식을 지원하는지 살펴본 뒤 프로토콜 차이가 끊김의 원인인지 판단하세요.
웹페이지는 여러 도메인에서 스크립트, 이미지, API를 불러옵니다. 기본 문서는 빠르게 열리는데 페이지를 사용할 수 없을 만큼 늦다면 브라우저 네트워크 패널에서 가장 느린 요청을 확인하고 이름 확인, 연결 대기, 콘텐츠 다운로드 단계로 나눠 클라이언트 로그와 비교하세요. 특정 리소스 도메인만 계속 느리다면 해당 도메인의 라우팅과 대상 서비스를 중점적으로 확인하세요. 리소스 하나 때문에 전체 라우팅을 초기화하지 마세요. 로그 수준을 디버그로 높였다면 문제를 재현하는 동안만 켜 두고 끝난 뒤 평소 수준으로 되돌리세요.
기기 부하와 설정 변경의 부작용 확인
속도가 떨어질 때 시스템 작업 관리자나 리소스 모니터도 확인하세요. 다운로드 중 CPU 사용률이 계속 높거나 기기가 뜨거워지거나 디스크 쓰기가 병목이라면 부하가 큰 프로그램을 중지하고 기기 온도가 정상일 때 다시 테스트하세요. 브라우저 단독 테스트와 여러 작업을 동시에 하는 테스트를 비교하면 다운로드 창만 보는 것보다 기기 자체의 병목을 찾기 쉽습니다. 안드로이드에서 화면을 끈 뒤에만 불안정해진다면 안드로이드 백그라운드 연결 끊김 항목에서 시스템이 서비스를 중지하는지 확인하세요.
근거 없이 전송 방식, 멀티플렉싱, 가상 인터페이스 설정을 한꺼번에 바꾸지 마세요. 작은 페이지는 정상인데 대용량 전송이 자주 멈춘다는 이유만으로 패킷 크기 문제라고 단정할 수도 없습니다. 먼저 리소스 측 속도 제한과 네트워크 패킷 손실을 확인하고, 필요하면 네트워크 담당자에게 경로 점검을 요청하세요. 설정을 유지하려면 같은 테스트에서 개선을 반복해서 확인할 수 있어야 하고 새로운 시간 초과, 음성·영상 문제, 로컬 네트워크 접근 문제도 없어야 합니다. 그렇지 않으면 변경 사항을 되돌리고 비교 결과를 바탕으로 계속 원인을 찾으세요.
DNS 확인 및 라우팅 문제
이름 확인 오류는 서로 다른 두 대상에서 발생할 수 있습니다. 서버 도메인 확인 실패는 클라이언트의 출구 연결을 방해하고, 대상 웹사이트 도메인 확인 실패는 일부 요청에만 영향을 줄 수 있습니다. 로그에서 오류가 난 도메인이 어느 쪽인지 확인한 뒤 시스템, 앱, 커널 중 어디에서 이름을 확인하는지 살펴보세요. 웹페이지에 서버를 찾을 수 없다고 표시돼도 시스템 DNS에 문제가 있다고 단정할 수 없습니다. 프록시를 통해 웹 요청을 보낸 뒤 대상 도메인 확인에서 실패했을 수도 있습니다.
시스템 DNS 조회와 실제 앱 요청 비교
시스템의 기본 설정으로 공개 도메인을 조회하고 반환된 주소, 오류, 대기 시간을 기록하세요. Windows에서는 아래 시스템 조회 도구를 사용할 수 있습니다. 특정 도메인으로 재현하려면 예시를 공개적으로 테스트할 수 있는 대상으로 바꾸세요. 이 결과는 해당 조회 한 번만 보여 줍니다. 브라우저의 보안 DNS, 커널 설정의 DNS 서버, 프록시 상대편이 같은 응답을 받았다는 뜻은 아닙니다.
Resolve-DnsName -Name example.com -Type A -DnsOnly
Resolve-DnsName -Name example.com -Type AAAA -DnsOnly
IPv4와 IPv6 주소를 따로 조회하는 이유는 어느 주소 유형에서 문제가 생기는지 확인하기 위해서이지, 모든 도메인이 두 주소를 모두 반환해야 하기 때문은 아닙니다. 특정 유형의 레코드를 받아도 현재 네트워크에서 해당 주소에 연결할 수 있다는 뜻은 아닙니다. 시스템 조회는 성공하지만 브라우저에서 실패한다면 브라우저가 자체 보안 DNS를 사용하는지 확인하고 기본 네트워크 설정을 사용하는 다른 앱과 비교하세요. 프록시를 직접 지정한 요청만 실패한다면 커널이나 프록시 상대편이 대상 도메인 확인을 담당하는지 로그와 함께 확인하세요. 비교를 마친 뒤에는 원래 보안 DNS 설정으로 복구해야 합니다.
도메인 규칙과 IP 주소 규칙의 적용 순서 확인
커널은 도메인을 받으면 도메인 규칙으로 출구를 선택할 수 있습니다. 도메인을 IP 주소로 확인해 주소 규칙에 포함할지는 라우팅의 도메인 정책에 따라 달라집니다. AsIs는 라우팅 매칭을 위해 도메인을 별도로 확인하지 않습니다. IPIfNonMatch는 도메인 요청이 규칙과 일치하지 않을 때 이름을 확인해 IP 주소로 매칭을 시도할 수 있습니다. 앱이 먼저 도메인을 IP 주소로 바꾼 뒤 그 주소만 커널에 전달하면 도메인 규칙이 요청과 일치하지 않을 수 있습니다. 먼저 로그에 표시된 대상 형식을 확인한 뒤 어떤 규칙을 살펴볼지 판단하세요.
아래는 direct 출구 태그가 이미 설정된 커널 구성 일부로, 로컬 관리 도메인 하나를 직접 연결로 보내는 규칙만 보여 줍니다. 직접 사용하는 설정에 적용하려면 실제로 관리하는 도메인으로 바꾸고 기존 규칙에 병합하세요. 완전한 설정이 아니며 DNS 서버를 자동으로 지정하지도 않습니다. 해당 도메인을 내부 DNS로만 확인할 수 있다면 직접 연결 규칙이 올바르더라도 공용 DNS 서버에서 사용할 수 있는 주소를 받지 못할 수 있습니다.
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:router.home.arpa"],
"outboundTag": "direct"
}
]
}
}
내부 도메인, 캐시, 시작 단계 의존성 점검
가정이나 회사 내부 도메인은 해당 네트워크에서 허용한 DNS 서버를 계속 사용해야 합니다. 테스트를 위해 내부 이름을 외부 공용 DNS 서버로 보내지 마세요. 규칙을 변경한 뒤에는 기존 결과와 새 결과를 기록하고 테스트 앱을 다시 시작해 기존 연결 재사용을 방지하세요. 캐시에는 유효 시간이 있으며 시스템, 앱, 커널이 동시에 갱신되는 것은 아닙니다. 이전 결과와 새 결과가 번갈아 나타난다면 여러 DNS 서비스를 연이어 바꾸기보다 어느 계층에서 어떤 결과가 나왔는지 먼저 확인하세요.
노드 주소 확인이 도메인에 의존하고 그 주소를 확인하는 요청도 아직 연결되지 않은 같은 노드를 거치도록 설정된 순환 문제가 생길 수 있습니다. 이 경우 출구 설정이 올바르더라도 시작에 실패합니다. 먼저 노드 도메인을 처음 확인하는 경로를 살펴보고, 그다음 대상 도메인의 확인 정책을 확인하세요. 수정 후에는 노드 시작, 일반 웹사이트, 계속 사용해야 하는 내부 도메인을 각각 다시 테스트합니다. 매개변수의 의미는 용어 빠른 안내에서 확인하고 기존 내부 네트워크 설정을 새 규칙 하나로 덮어쓰지 마세요.
시스템 프록시가 작동하지 않음
시스템 프록시는 시스템 설정을 따르는 앱의 요청을 어디로 보낼지 결정하고, 라우팅은 커널이 요청을 받은 뒤 어느 출구로 보낼지 정합니다. 두 항목은 각각 확인해야 합니다. 웹페이지가 라우팅 규칙에 따라 직접 연결됐다고 해서 로컬 클라이언트를 거치지 않은 것은 아닙니다. 반대로 클라이언트 상태 표시줄에 프록시가 설정됐다고 나와도 모든 앱이 시스템 설정을 읽는 것은 아닙니다. 문제가 어느 계층에 있는지 판단하려면 실제 요청이 로컬 포트에 들어왔는지부터 확인하세요.
데스크톱 시스템의 실제 연결 지점 확인
v2rayN 트레이 메뉴에서 시스템 프록시 자동 설정을 선택한 뒤 시스템 네트워크 설정에서 적용 결과를 확인하세요. 프록시를 직접 지정해야 하는 앱은 지원하는 프로토콜에 맞춰 클라이언트 화면에 표시된 수신 주소와 포트를 입력합니다. 원격 노드의 포트를 로컬 연결 지점으로 입력하면 안 됩니다. 같은 컴퓨터에서 테스트할 때는 보통 루프백 주소를 사용하며, 문제 해결을 위해 ‘LAN에서 연결 허용’을 켤 필요는 없습니다. 로컬 포트를 바꾼 적이 있다면 수동 설정을 사용하는 앱이 이전 포트를 계속 가리키지 않는지도 확인하세요.
| 운영체제 | 확인할 위치 | 확인 방법 |
|---|---|---|
| Windows | 설정 → 네트워크 및 인터넷 → 프록시 | 수동 프록시와 자동 구성 스크립트를 확인하세요. 일부 서비스는 데스크톱 앱과 다른 프록시 설정을 사용합니다. |
| macOS | 시스템 설정 → 네트워크 → 현재 서비스 → 세부 정보 → 프록시 | 현재 사용 중인 네트워크 서비스인지 확인한 다음 선택된 프록시 유형과 포트를 확인하세요. |
| Linux | 데스크톱 네트워크 프록시 설정, 대상 앱의 환경설정, 시작 환경 | 데스크톱 세션과 명령줄 프로세스가 같은 연결 지점을 사용하는지 확인하세요. 두 환경에서 프록시 상태를 공유하지 않을 수 있습니다. |
시스템 화면에 자동 구성 스크립트와 수동 설정이 함께 있다면 기존 값과 기관 정책으로 관리되는 항목인지 먼저 기록하세요. 오래된 스크립트가 특정 도메인을 직접 연결하도록 설정했을 수 있고, 다른 네트워크 도구가 클라이언트의 프록시 설정을 원래 값으로 다시 덮어쓸 수도 있습니다. 앱을 종료한 뒤에도 로컬 포트를 가리키는 프록시가 남아 있다면 클라이언트의 시스템 프록시 해제 기능으로 복구하세요. 관리 대상 기기는 관리자가 제공한 기존 설정으로 복구하고, 출처를 모르는 관리 항목은 삭제하지 마세요.
앱별 설정과 라우팅 결과 구분
문제가 계속되면 앱 하나만 선택해 다시 테스트하세요. 앱에서 ‘시스템 프록시 사용’을 선택했는지, 별도의 프록시 설정이 활성화되어 있는지, 직접 연결 우선 설정이 있는지 확인합니다. 테스트 탭을 닫고 새 요청을 보내세요. 필요한 경우 앱을 다시 시작해 기존 연결이 이전 설정을 계속 사용하지 않도록 합니다. 명령줄 도구는 환경 변수에서 프록시 주소를 가져올 수도 있습니다. 로컬 프록시를 명시해 성공하더라도 해당 호출 방식만 사용할 수 있다는 뜻이며 시스템 설정이 올바른지는 확인할 수 없습니다.
클라이언트가 요청을 받은 상태라면 로그에서 선택된 출구를 확인하세요. 출구 태그가 direct라면 요청이 커널에 도달한 뒤 규칙에 따라 직접 나간다는 뜻이므로 시스템 프록시를 계속 바꾸지 말고 라우팅을 확인해야 합니다. 더 구체적인 대상 규칙이 앞에 있는 포괄적인 규칙에 가로막혔는지, 마지막으로 선택된 항목이 기본 출구인지 확인하세요. 가상 인터페이스 모드를 테스트하려면 기존 시스템 프록시와 다른 네트워크 도구의 상태를 먼저 기록하고 각각 따로 테스트하세요. 두 연결 지점이 동시에 작동하면 결과를 판단하기 어렵습니다.
종료, 재시작, 네트워크 전환 후 상태 확인
문제를 해결한 뒤 두 차례 연결 상태를 확인하세요. 클라이언트 실행 중에는 시스템 설정이 실제 수신 주소와 일치하는지 확인하고, 종료 후에는 앱이 원래 프록시 상태로 돌아가는지 확인합니다. 그런 다음 자주 사용하는 네트워크를 한 번 전환해 시스템이 다른 네트워크 서비스를 사용하거나 기존 스크립트를 불러오는지 살펴보세요. 재시작할 때마다 다른 프로그램이 프록시 설정을 덮어쓴다면 여러 도구에서 같은 포트를 반복 설정하지 말고 어떤 프로그램이 설정을 변경하는지 확인하세요. 한 앱에서만 작동하지 않는다면 자주 묻는 문제에서 앱 연결 방식을 확인하세요.
클라이언트 강제 종료 및 시작 실패
먼저 실패가 발생하는 시작 단계를 구분하세요. 창이 나타나기도 전에 종료된다면 패키지 형식, 종속 항목, 폴더 권한을 확인해야 합니다. 창은 열리지만 커널 시작에 실패한다면 로그, 수신 포트, 현재 설정부터 살펴보세요. 프로그램은 종료되지 않고 창만 사라졌다면 트레이로 최소화됐는지도 확인해야 합니다. 세 경우의 해결 순서는 서로 다릅니다. 처음 강제 종료된 직후 기존 파일을 덮어쓰지 마세요. 원인을 찾거나 복구할 수 있도록 기존 데이터는 그대로 두세요.
설치 패키지와 실행 환경이 맞는지 확인
데스크톱에서는 다운로드 패키지 페이지에서 운영체제, 프로세서 아키텍처, 패키지 형식을 다시 확인하세요. Windows 데스크톱 버전과 클래식 WPF 버전은 화면 구성이 다르고 필요한 런타임도 패키지별 안내를 확인해야 합니다. 특정 .NET 런타임이 없다는 오류가 명확히 표시되면 필요한 런타임의 유형과 아키텍처를 확인하세요. 데스크톱 런타임과 기본 런타임은 서로 다른 구성 요소입니다. 압축 파일은 현재 사용자에게 읽기·쓰기 권한이 있는 폴더에 완전히 풀어 사용하고, 압축 미리보기에서 실행 파일을 직접 실행하지 마세요.
macOS에서는 칩 유형과 패키지 아키텍처가 맞는지 확인하고 시스템 안내가 출처 제한, 아키텍처 불일치, 권한 부족 중 무엇을 가리키는지 살펴보세요. Linux에서는 배포판에 맞는 패키지 형식과 아키텍처를 확인하고 패키지 관리자가 안내하는 누락된 종속 항목을 처리하세요. 편의를 위해 시스템 보호 기능을 전역 해제하거나 관리자 권한으로 계속 실행하지 마세요. 쓰기 불가 경로 오류가 나온다면 프로그램 폴더 전체에 불필요한 권한을 부여하지 말고 일반 사용자 데이터 경로를 사용하세요.
커널 종료, 포트 충돌, 설정 오류 구분
창을 사용할 수 있다면 클라이언트 로그에서 로컬 커널 시작과 관련된 첫 번째 실패 메시지를 찾으세요. 주소가 이미 사용 중이라는 오류가 나오면 이전 인스턴스가 실행 중인지, 다른 정상 서비스가 해당 포트를 사용하는지 확인합니다. Windows에서는 실제 포트 번호를 넣어 아래 명령으로 수신 프로세스의 ID를 확인한 다음 작업 관리자에서 해당 프로세스를 찾을 수 있습니다. 모르는 프로세스는 바로 종료하지 마세요. 클라이언트에 사용 가능한 포트를 지정한 뒤 해당 연결 지점에 의존하는 프록시 설정도 함께 업데이트할 수 있습니다.
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
로그에서 커널 파일을 읽을 수 없다고 나오면 압축 파일이 완전히 풀렸는지, 해당 경로가 존재하는지, 시스템 보안 기록에 관련 안내가 있는지 확인하세요. 알 수 없는 필드, 유효하지 않은 출구, 설정 파싱 실패가 표시되면 먼저 이전에 정상 작동한 노드와 기본 라우팅으로 돌아가세요. 오류에 표시된 필드는 클라이언트가 생성한 설정에 있을 수 있습니다. 실행할 때마다 덮어써지는 파일을 직접 편집하기보다 그래픽 화면에서 해당 설정의 원인을 수정하는 편이 효과적입니다.
데이터를 보관하고 별도 환경에서 재현
사용자 설정이 손상된 것으로 의심되면 먼저 클라이언트와 남아 있는 커널 프로세스를 종료하세요. 프로그램이 실제로 사용하는 데이터 폴더를 백업하고, 백업은 본인만 접근할 수 있는 위치에 보관합니다. 새 폴더와 독립 데이터로 실행하는 기능을 프로그램이 명확히 지원한다면 빈 설정으로 비교 테스트할 수 있습니다. 그렇지 않으면 안내에 따라 실제 데이터 경로를 확인하세요. 프로그램 폴더만 바꿔도 데이터가 자동으로 분리된다고 생각하면 안 됩니다. 빈 설정으로 실행된다면 먼저 구독 하나나 정상 작동이 확인된 노드 하나를 복구한 뒤 라우팅과 화면 설정을 하나씩 복원하세요.
빈 설정에서도 실패한다면 운영체제와 아키텍처, 패키지 형식, 클라이언트 창이 나타났는지, 같은 시각의 시스템 이벤트 기록에 표시된 오류 모듈을 기록하세요. 로그 폴더가 없다고 오류가 발생하지 않았다는 뜻은 아닙니다. 로그가 만들어지기 전에 문제가 생겼을 수 있습니다. 안드로이드에서 앱 데이터를 삭제하면 로컬 설정도 제거되므로 백업하고 다시 가져올 수 있는지 확인한 뒤에만 고려하세요. 데스크톱 사례는 v2rayN 시작 오류 및 실행 환경 문제 해결을 참고하세요.
안드로이드 권한, 앱별 프록시, 백그라운드 연결 끊김
안드로이드에서는 연결이 끊기는 시점에 따라 점검하세요. 연결 버튼을 누르자마자 실패하면 시스템 권한과 기존 VPN을 확인합니다. 특정 앱 하나만 인터넷에 연결되지 않으면 앱별 목록과 모드를 확인하세요. 화면을 잠근 뒤 한참 지나서 연결이 끊기면 백그라운드 실행과 배터리 정책을 살펴봅니다. 같은 노드로 앱을 전면에 둔 상태, 화면 잠금 상태, 네트워크 전환 상태에서 각각 확인해 커널 연결 시간 초과, 시스템에 의한 서비스 종료, 앱이 프록시 대상에서 제외된 문제를 혼동하지 마세요.
VpnService 권한 및 시스템의 VPN 점유 확인
v2rayNG에서 VPN 모드를 처음 시작하면 Android가 연결 요청을 표시합니다. 안내에 표시된 앱이 사용할 클라이언트인지 확인한 뒤 권한을 허용하세요. 연결을 눌러도 팝업이 나타나지 않는다면 이미 권한이 허용됐거나 기존 VPN 또는 기기 관리 정책이 새 연결을 막고 있을 수 있습니다. 시스템의 VPN 화면에서 현재 제공자를 확인하세요. 같은 사용자 또는 업무 프로필에서는 보통 VPN 하나만 활성화할 수 있습니다. 다른 네트워크 앱이 연결을 인계받으면 기존 VPN이 종료될 수 있습니다.
VPN 항상 켜기와 VPN 연결이 없을 때 차단은 서로 다른 영향을 주는 시스템 설정입니다. 전자는 시스템이 VPN을 유지하거나 다시 연결할지 결정하고, 후자는 VPN이 끊겼을 때 일반 네트워크 요청을 차단할 수 있습니다. 기본 네트워크를 테스트하기 전에 두 설정이 켜져 있는지 확인하세요. 정책이 적용된 것을 Wi-Fi 문제로 오해하지 마세요. 업무 프로필이나 관리 대상 기기에서는 해당 옵션이 잠겨 있을 수 있습니다. 관리자의 도움을 받고 보안 기능을 끄는 방식으로 장기적인 문제 해결을 시도하지 마세요.
앱별 목록이 의미하는 바 확인
클라이언트의 앱별 프록시 설정에서 현재 목록이 ‘선택한 앱만 VPN 사용’인지 ‘선택한 앱은 VPN 우회’인지 먼저 확인하세요. 우회 모드를 켜면 같은 체크 표시도 의미가 반대일 수 있습니다. 문제를 확인할 때는 구분하기 쉬운 앱 두 개를 선택해 하나는 VPN을 사용하고 다른 하나는 원래 네트워크로 접속하도록 설정하세요. 저장한 뒤 VPN에 다시 연결하고 각 앱에서 새 요청을 보내세요. 열린 페이지를 새로고침하는 것만으로는 기존 연결을 계속 사용할 수 있으므로 새 페이지를 열거나 대상 앱을 다시 시작하세요.
같은 앱을 최근에 다시 설치했거나 업무 프로필에 설치했거나 시스템 앱 복제 기능으로 만들었다면 목록에 같은 이름이 표시돼도 테스트 중인 앱 인스턴스와 다를 수 있습니다. 아이콘 표시, 소속 프로필, 클라이언트에 보이는 앱 항목을 확인하세요. 로그인 페이지가 시스템 브라우저나 다른 구성 요소에서 열리면 실제 요청은 원래 앱이 보내지 않았을 수도 있습니다. 요청을 보낸 앱을 확인한 다음 목록을 조정하세요. 앱 하나를 정상 작동시키려고 모든 앱을 같은 출구에 장기간 넣지 마세요.
화면 잠금 및 네트워크 전환으로 백그라운드 끊김 확인
먼저 화면을 켠 상태에서 연결하고 정상 작동을 확인한 뒤, 문제가 재현될 만큼 충분히 기다리며 화면을 잠그세요. 잠금을 해제한 뒤 즉시 다시 연결하지 말고 VPN 표시, 지속 알림, 클라이언트 로그를 먼저 확인하세요. 서비스가 사라졌는데 노드 오류가 없다면 시스템의 백그라운드 제한을 우선 확인합니다. 서비스는 유지되지만 로그에 연결 재설정이나 이름 확인 시간 초과가 있다면 대기 중 네트워크 경로가 바뀌었는지 살펴보세요. 같은 노드로 Wi-Fi와 모바일 데이터 사이를 한 번 전환해 전환 후 기존 연결이 정상적으로 재설정되는지 따로 확인할 수 있습니다.
백그라운드 제한이 원인으로 확인되면 시스템의 앱 정보에서 배터리 또는 백그라운드 사용 설정을 찾아 사용하는 클라이언트에만 백그라운드 실행 허용 또는 ‘제한 없음’을 설정해 보세요. 일부 기기에는 자동 시작이나 백그라운드 활동 제한이 별도로 있으며 메뉴 이름은 시스템마다 다릅니다. 기기 안내에 따라 해당 설정을 찾으세요. 설정은 한 번에 하나씩 바꾼 뒤 같은 화면 잠금 테스트를 반복하고 연결 개선 여부와 배터리 사용량을 확인하세요. v2flyNG에도 같은 점검 순서를 적용할 수 있으며 화면 항목은 실제 표시를 따릅니다. 자세한 내용은 안드로이드 권한, 배터리 절약, 앱별 프록시 설정을 참고하세요.