문제 해결
v2rayN 문제 해결 가이드
처음 설치하거나 구독을 가져오거나 라우팅을 설정한다면 v2rayN 설정 가이드의 시작 절차를 따라 하세요. 설정을 마쳤는데 문제가 생겼다면 이 페이지의 목차에서 증상을 선택하세요. 처음부터 다시 설치할 필요는 없습니다. 설정 가이드는 작동하는 구성을 만드는 방법을, 이 가이드는 그 구성이 어느 단계에서 작동하지 않는지 찾는 방법을 설명합니다.
문제를 확인할 때는 한 번에 한 가지만 변경하세요. 먼저 발생 시각, 현재 노드, 연결 네트워크와 프록시 모드를 기록한 뒤 같은 앱과 대상 주소로 다시 테스트합니다. 로그를 공유할 때는 재현 시각 전후의 오류만 발췌하고 구독 주소, 사용자 식별 정보와 서버 주소는 삭제하세요.
인터넷 연결 안 됨: 로컬 연결부터 실제 출구까지 확인
먼저 기기 전체의 인터넷 장애와 프록시 경로 문제를 구분하세요
먼저 클라이언트의 네트워크 제어를 잠시 해제하세요. 가상 네트워크 어댑터 모드를 사용 중이라면 클라이언트에서 끄고, 시스템 프록시를 설정했다면 클라이언트의 초기화 기능으로 해제한 다음 시스템 설정에서도 확인합니다. 회사나 학교 기기는 지정된 프록시가 필요할 수 있습니다. 이때는 기존 주소나 자동 구성 스크립트를 복원하고, 모든 프록시를 끄는 것을 기본값으로 삼지 마세요. 원래 접속할 수 있어야 하는 웹페이지를 브라우저에서 열고 시스템의 네트워크 연결 상태도 확인합니다. 호텔이나 학교의 로그인 네트워크를 이용 중이라면 먼저 인증을 완료하세요. 네트워크 제어를 끈 뒤에도 원래 열려야 할 페이지에 접속할 수 없다면 기본 인터넷 연결부터 복구해야 합니다.
인터넷 연결을 복구한 다음에는 네트워크 제어 방식을 하나만 켜고 현재 노드를 불러온 뒤, 앞서 사용한 브라우저로 같은 주소에 접속하세요. 가상 네트워크 어댑터, 시스템 프록시, 브라우저 프록시 확장 프로그램을 동시에 켜면 요청을 어떤 경로가 처리하는지 확인하기 어렵습니다. 일반 웹페이지는 열리지만 특정 앱에서 실패한다면, 브라우저로 해당 앱이 사용하는 같은 웹사이트에 접속해 비교하세요. 브라우저 접속 성공이 앱도 시스템 프록시를 사용한다는 뜻은 아니며, 앱 접속 실패가 전체 연결 경로의 장애를 의미하지도 않습니다. 네트워크 제어를 다시 켠 뒤 모든 요청이 실패한다면 먼저 코어가 정상적으로 시작했는지 확인하고 노드를 점검하세요. 처음부터 프로토콜을 바꾸거나 네트워크를 초기화하지 마세요.
로컬 수신 포트와 앱 연결 지점 확인
v2rayN 설정에서 HTTP, SOCKS, 혼합 모드 중 실제로 활성화된 수신 방식을 확인하고 로그에 바인딩 실패가 있는지 살펴보세요. 일부 앱은 특정 프록시 방식만 지원합니다. 포트가 맞더라도 방식을 잘못 선택하면 연결되지 않습니다. 설정에 표시된 로컬 수신 주소를 사용하고, 포트는 현재 실행 중인 인스턴스의 값으로 입력하세요. 오래된 가이드의 값을 그대로 사용하면 안 됩니다. 아래는 로컬 포트 확인 예시입니다. 현재 포트가 10808일 때만 그대로 실행하고, 다르면 먼저 포트를 바꾸세요. 클라이언트를 실행한 상태에서 한 번 확인한 뒤, 필요한 경우 정상적으로 종료하고 다시 확인해 프로세스가 종료될 때 수신 포트도 닫히는지 비교하세요.
| 플랫폼 | 확인 명령 | 결과 해석 |
|---|---|---|
| Windows | Test-NetConnection 127.0.0.1 -Port 10808 | PowerShell에서 TcpTestSucceeded 값을 확인합니다. |
| macOS | nc -vz 127.0.0.1 10808 | 성공은 이 기기의 TCP 연결을 수락했다는 뜻일 뿐입니다. |
| Linux | ss -ltnp 'sport = :10808' | 일치하는 TCP 수신 포트를 확인합니다. 권한에 따라 프로세스 정보가 표시되지 않을 수 있습니다. |
로그에 포트 사용 중이라고 표시되면 다른 클라이언트나 종료되지 않은 코어가 해당 포트를 사용 중인지 확인하세요. 중복 실행이 확실한 경우 먼저 정상적으로 종료합니다. 정체를 알 수 없는 시스템 프로세스를 강제로 종료하지 마세요. 포트를 바꿔야 한다면 이전 포트를 직접 입력한 앱도 함께 수정한 뒤 v2rayN에서 시스템 프록시를 다시 적용하세요. 명령 결과 수신 상태는 정상인데 요청이 코어 로그에 나타나지 않는다면 앱의 연결 설정을 먼저 확인합니다. 로그 수준에 따라 접속 기록이 남지 않을 수 있으므로 이 결과만으로 결론 내리지 마세요. 수동 프록시를 지원하는 앱에서 해당 수신 주소를 임시로 지정해 테스트한 뒤 원래 설정으로 되돌릴 수 있습니다.
요청 하나로 라우팅과 복구 상태 확인
요청이 코어에 도달하는 것을 확인한 뒤, 실패한 요청이 실제로 어떤 아웃바운드를 선택했는지 살펴보세요. 화면에 표시된 정책 이름이 아니라 실제로 일치한 결과가 중요합니다. 예상과 달리 직접 연결로 처리됐다면 규칙 순서, 도메인과 IP 주소 중 어떤 값으로 매칭되는지, 실행 중인 설정이 방금 수정한 파일인지 확인하세요. 라우팅을 수정할 때는 테스트 규칙 하나만 바꾸고, 테스트가 끝나면 기존 정책을 복원하세요. 원래 직접 연결해야 하는 내부 서비스가 프록시 아웃바운드로 전송되지 않도록 주의합니다. 기대한 프록시 아웃바운드가 선택됐는데 서버 연결이나 핸드셰이크 단계에서 멈춘다면 노드 시간 초과 항목을 확인하세요.
노드 시간 초과: DNS 조회, 연결, 핸드셰이크 구분
어떤 종류의 테스트에서 시간 초과가 발생하는지 확인
먼저 클라이언트에서 실행한 테스트가 어떤 종류인지 확인하세요. TCP 연결만 시도하는 기능도 있고, 해당 노드를 통해 실제 요청을 보내 테스트 주소의 응답을 기다리는 기능도 있습니다. 전자의 성공이 코어의 프로토콜 핸드셰이크까지 완료됐다는 뜻은 아니며, 후자의 실패는 테스트 사이트에 연결할 수 없어서일 수도 있습니다. 시스템의 ping 응답 여부로 프록시 작동을 판단하지 마세요. 원격 서버는 이런 탐색 요청에 응답하지 않더라도 해당 포트의 연결은 정상적으로 받을 수 있습니다. 먼저 안정적인 네트워크에서 노드 하나를 개별 테스트하고, 정상 작동이 확인된 노드 하나를 골라 같은 테스트를 실행하세요. 문제를 찾는 동안 일괄 속도 테스트는 중단하세요. 로컬 연결 동시 실행과 원격 서버의 요청 제한이 결과에 섞일 수 있습니다.
첫 실패 시각을 기록하고 모든 노드가 동시에 시간 초과되는지, 같은 그룹의 노드만 그런지, 노드 하나만 문제인지 구분하세요. 모든 노드가 동시에 실패한다면 현재 네트워크, 노드 도메인의 DNS 조회 결과, 기기 시계와 코어 시작 상태를 먼저 확인합니다. 같은 그룹만 실패하고 다른 그룹은 정상이라면 두 그룹이 서버 주소, 전송 방식 또는 구독 출처를 공유하는지 살펴보세요. 노드 하나만 실패하면 전체 설정은 그대로 두고 해당 노드의 주소, 포트와 전송 매개변수를 집중적으로 비교합니다. 한 노드가 복구된 뒤에도 다른 노드를 다시 테스트하세요. 여러 장애가 우연히 같은 시간에 발생했는데 하나의 문제로 오해하지 않도록 주의합니다.
로그에 표시된 단계에 따라 조치하고 대기 시간을 늘려 문제를 덮지 마세요
첫 로그가 호스트를 찾지 못했거나 DNS 조회 시간 초과라고 알린다면 아직 원격 주소도 확인하지 못한 상태입니다. 현재 네트워크의 시스템 DNS를 사용해 노드 도메인을 확인한 뒤 코어 자체의 DNS 처리 경로를 살펴보세요. IP 주소는 확인됐지만 연결이 시간 초과된다면 현재 네트워크에서 구독에 표시된 주소와 포트에 접속할 수 있는지 확인합니다. 연결 거부와 연결 시간 초과는 서로 다른 결과입니다. 전자는 해당 연결이 거부됐다는 뜻이고, 후자는 기다리는 동안 예상한 응답을 받지 못했다는 뜻입니다. 어느 결과만으로도 어느 쪽 장비가 원인인지 단정할 수는 없습니다. 사용할 권한이 있는 다른 네트워크에서도 같은 노드를 테스트하되 서버 매개변수는 동시에 변경하지 마세요.
기본 연결은 성립했지만 핸드셰이크에서 오류가 발생한다면 노드 제공자가 안내한 설정과 프로토콜, 암호화 또는 보안 설정, 전송 방식, 필요한 서버 이름과 경로를 대조하세요. 표시 이름은 메모일 뿐 이런 설정을 대신할 수 없습니다. 같은 템플릿에서 가져온 매개변수라도 주소만 복사해 다른 노드에 적용해서는 안 됩니다. 인증서나 시간 관련 로그가 있다면 먼저 시스템 시계를 자동으로 동기화하고, 해당 오류가 실제로 그 노드의 핸드셰이크 중 발생했는지 확인하세요. 오류 메시지를 없애려고 인증서 검증을 끄지 마세요. 설정이 제공자의 현재 안내와 일치한다면 민감 정보를 가린 첫 번째 핸드셰이크 오류를 제공자에게 보내 확인하세요.
테스트 주소와 실제 접속을 따로 확인
테스트에서는 시간 초과가 표시되지만 노드를 통해 실제 업무에 필요한 페이지를 열 수 있다면 테스트 주소가 현재 네트워크에 적합한지 확인하세요. 클라이언트에서 테스트 주소를 바꿀 수 있다면 안정성이 예상되고 사용 권한이 분명한 HTTPS 주소를 선택한 뒤 두 테스트에서 같은 주소를 사용하세요. 일부 주소는 다른 페이지로 이동하거나 인증을 요구합니다. 브라우저에서 페이지가 표시돼도 클라이언트의 연결 테스트가 성공한 것은 아닙니다. 반대로 속도 테스트 요청의 성공은 그 대상까지의 경로만 사용할 수 있다는 뜻입니다. 실제 대상이 계속 열리지 않는다면 해당 대상의 라우팅, DNS 조회와 접속 조건을 확인하세요. 실제 요청을 처리할 수 있는 노드를 반복해서 바꾸지 마세요.
시간 초과 안내를 성공으로 바꾸려고 테스트 대기 시간을 계속 늘리지 마세요. 일반 요청이 반복해서 완료되고, 최초 연결만 간혹 느리며, DNS 조회와 핸드셰이크 실패를 배제한 경우에만 대기 시간을 조정해 관찰할 의미가 있습니다. 복구 후 두 차례 확인하세요. 먼저 기존 노드로 같은 실제 주소에 접속한 다음, 평소 라우팅을 복원하고 직접 연결해야 하는 주소에 접속합니다. 네트워크 전환이나 기기 절전 해제 뒤에만 실패한다면 네트워크를 바꾼 시점부터 첫 요청까지 걸린 시간을 따로 기록하세요. 네트워크가 다시 준비된 뒤 자동으로 복구되는지 확인한 다음 시스템 프록시나 모바일 백그라운드 정책을 점검할지 결정합니다.
구독 업데이트 실패: 주소부터 그룹까지 단계별 확인
업데이트 대상과 경로 확인
v2rayN의 구독 그룹 설정을 열고 현재 조작하는 항목이 문제가 발생한 그룹인지 확인하세요. 이름이 비슷한 다른 그룹을 잘못 선택하지 않도록 합니다. 주소의 앞부분, 도메인과 끝의 매개변수를 구간별로 비교하세요. 채팅 기록이나 줄바꿈된 텍스트에서 복사하면 설명, 공백이나 문장 끝의 문장부호까지 붙는 경우가 많습니다. 제공자가 전달한 전체 주소를 유지하고 계정 관리 페이지 주소를 구독 주소로 입력하지 마세요. 자동 업데이트와 수동 업데이트는 별개입니다. 자동 업데이트가 실패했다면 해당 그룹이 업데이트 대상인지 확인한 다음 수동 업데이트를 한 번 실행하고 그 시각의 로그를 살펴보세요. 수동 업데이트가 성공한 뒤에야 주기 설정, 절전 해제 후 업데이트 정책, 앱의 백그라운드 실행 여부를 확인할 수 있습니다.
업데이트 요청이 직접 연결 경로와 프록시 경로 중 어느 쪽을 사용하는지 구분하세요. 브라우저에서 웹페이지가 열린다고 클라이언트의 구독 요청도 같은 네트워크 설정을 사용한다고 볼 수 없습니다. 로그를 확인하고 현재 클라이언트의 업데이트 옵션을 기준으로 판단하세요. 프록시를 통해 구독을 업데이트하는데 해당 그룹의 기존 노드가 모두 작동하지 않는다면, 업데이트에 기존 노드가 필요한 순환 의존이 생깁니다. 현재 네트워크에서 구독 주소에 직접 연결할 수 있는지 먼저 확인하세요. 프록시 업데이트가 필요하다면 실제 접속이 확인된 다른 노드를 사용하고 문제가 있는 그룹만 한 번 업데이트합니다. 테스트 전 기존 업데이트 방식을 기록하고, 실패하면 원래대로 복원하세요. 검증하지 않은 경로로 모든 그룹을 한꺼번에 바꾸지 마세요.
요청 실패, 응답 오류와 형식 불일치 구분
로그에 HTTP 상태 코드가 없다면 구독 도메인의 DNS 조회, 연결과 인증서 문제를 먼저 확인하세요. 상태 코드가 있다면 응답에 따라 조치합니다. 인증이 필요하거나 접근이 거부됐다면 구독이 만료됐는지, 전용 주소가 따로 필요한지 제공자에게 확인하세요. 주소가 없다는 응답이면 제공자가 구독 경로를 변경했는지 살펴봅니다. 요청 제한에 걸렸다면 반복 재시도를 멈추고 서버 안내나 제공자 요청에 따라 기다리세요. 서버 오류는 발생 시각과 상태를 기록해 문의하세요. 짧은 시간 안에 그룹을 계속 삭제하고 다시 만들어도 서버 장애는 해결되지 않습니다. 로그를 복사할 때는 오류 단계와 상태만 남기고 매개변수가 포함된 전체 주소는 인증 정보처럼 취급하세요.
요청 성공이 구독 가져오기 성공을 의미하지는 않습니다. 계정 로그인 페이지, 오류 안내, 빈 본문 또는 클라이언트가 지원하지 않는 구독 형식이 반환될 수 있습니다. 파싱 오류가 표시되면 제공자가 현재 클라이언트용 별도 구독 주소를 제공하는지 확인하세요. 형식 매개변수를 임의로 붙이지 마세요. 로그인한 브라우저에서 주소가 열려도 클라이언트에는 같은 로그인 상태가 없을 수 있습니다. 구독 내용을 출처를 알 수 없는 온라인 변환기에 입력하지 마세요. 제공자에게 확인이 필요하다면 반환된 내용의 유형, 오류 발생 시각과 클라이언트 이름만 설명하세요. 응답을 비교할 때는 클라이언트가 제공하는 요약을 우선 확인하고 전체 내용을 공개 로그에 저장하지 마세요.
업데이트 완료 후 목록 변화 확인
로그에는 업데이트 완료로 표시되는데 목록이 바뀌지 않았다면 현재 그룹 필터와 검색창, 업데이트 대상부터 확인한 뒤 이미 알고 있는 노드 하나의 설정을 비교하세요. 별칭과 개수만 보아서는 안 됩니다. 프로토콜이 호환되지 않거나 내용이 유효하지 않아 일부 항목이 건너뛰어질 수 있습니다. 이 경우 그룹 전체가 실패했다고 단정하지 말고 건너뛴 항목과 가져오기 안내를 확인하세요. 반대로 목록이 늘어났다고 새 설정이 작동하는 것도 아닙니다. 해당 그룹에서 방금 업데이트한 노드를 선택해 실제 접속을 테스트하세요. 직접 관리하던 항목이 있다면 구독으로 생성된 항목과 구분해 서비스 측 업데이트가 덮어쓴 일을 로컬 저장 실패로 오해하지 않도록 합니다.
속도 저하: 비교 테스트로 병목 찾기
어느 단계에서 느린지 먼저 구분
증상을 첫 페이지를 여는 데 오래 걸리는 경우, 열린 뒤에도 전송이 계속 느린 경우, 전송 중 주기적으로 멈추는 경우로 나누세요. 첫 응답은 늦지만 이후 전송이 안정적이라면 DNS 조회, 연결 수립과 핸드셰이크를 먼저 확인합니다. 시작은 빠르지만 다운로드 중 반복해서 멈춘다면 지속 처리량, 패킷 손실, 대상 서비스의 제한 또는 네트워크 전환을 살펴봐야 합니다. 노드의 단일 지연 시간 측정값은 파일 다운로드 속도를 뜻하지 않습니다. 서비스마다 경로, 서버 부하와 응답 시간이 다를 수 있습니다. 웹페이지는 여러 도메인에서 리소스를 불러오므로 메인 페이지 응답이 시작됐다고 모든 요청이 원활하다는 뜻은 아닙니다. 안정적으로 재현할 수 있는 작업을 하나 정해 테스트하세요.
같은 앱과 주소를 사용해 비슷한 시간대에 비교하세요. 현재 네트워크를 유지하고 기존 라우팅으로 한 차례 측정한 다음, 정상 작동이 확인된 노드 하나만 바꿔 다시 측정합니다. 그다음에야 노드를 고정하고 연결 네트워크를 바꾸는 방법을 검토하세요. 안전하게 직접 연결할 수 있는 공개 리소스라면 직접 연결도 테스트해 로컬 네트워크 기준값으로 삼을 수 있습니다. 원래 직접 접속할 수 없는 대상이라면 직접 연결 실패를 속도 비교에 포함하지 마세요. 대역폭을 사용하는 백그라운드 작업을 끄고 두 테스트가 서로 다른 캐시 경로를 사용하지 않도록 합니다. 공개된 같은 크기의 리소스를 사용해 첫 응답까지의 대기 시간과 이후 전송 시간을 기록하고 여러 번 반복해 결과가 안정적인지 확인하세요. 우연히 나온 최고 속도를 기준으로 삼지 마세요.
영향 범위에 따라 라우팅, 연결 경로와 대상 서비스 확인
특정 웹사이트나 파일 유형만 느리다면 대상 요청이 예상한 아웃바운드로 처리되는지 먼저 확인하세요. 페이지의 정적 리소스는 다른 도메인에서 가져올 수 있습니다. 메인 문서는 프록시를 통하지만 리소스가 실수로 직접 연결되면 페이지 틀은 먼저 표시되고 내용은 늦게 로드될 수 있습니다. 브라우저 개발자 도구의 네트워크 패널에서 어떤 요청이 느린지 구분하고 코어 로그에서 해당 대상을 확인하세요. 테스트할 때는 규칙 범위를 좁게 유지하고 문제가 확인된 트래픽에만 적용합니다. 특정 서비스만 느리고 다른 자주 쓰는 대상은 안정적이라면, 전체 라우팅을 바꾸기 전에 해당 서비스에 세션, 계정 또는 연결 속도 제한이 있는지 확인하세요.
모든 노드가 느리고 직접 연결 기준값도 낮다면 로컬 무선 신호, 접속 네트워크 혼잡과 다른 기기의 전송을 먼저 확인하세요. 특정 시간대에만 느리다면 같은 시간에 비교 테스트를 반복해 문제가 접속 네트워크를 따라가는지, 같은 서비스에만 나타나는지 확인합니다. 특정 노드만 여러 네트워크에서 계속 느리고 다른 노드는 괜찮다면 검증된 노드로 전환하고 비교 결과를 제공자에게 전달하세요. 업로드와 다운로드는 따로 살펴봐야 합니다. 웹페이지가 정상인데 업로드만 느릴 수 있습니다. 백그라운드 동기화가 업로드 대역폭을 모두 사용하면 대화형 요청에도 영향이 갈 수 있습니다. 동기화를 멈춘 뒤 나아진다면 프록시 프로토콜을 바꾸기보다 작업 동시성이나 실행 시간을 조정하세요.
근거가 확인됐을 때만 고급 설정 변경
시스템 전체의 네트워크 어댑터 설정을 먼저 바꾸거나 연결 수를 무작정 늘리지 마세요. 같은 네트워크, 노드와 대상에서 가상 네트워크 어댑터 모드의 지속 전송만 반복해서 실패하고 로컬 프록시를 사용하는 앱은 정상일 때에만 가상 네트워크 경로, 어댑터 충돌과 패킷 크기 제한을 확인할 근거가 있습니다. 트래픽을 동시에 제어할 수 있는 다른 앱을 먼저 종료하고 연결이 다시 수립된 뒤 테스트하세요. 클라이언트에서 관련 매개변수를 조정할 수 있다면 기존 값을 기록하고 한 번에 하나만 바꾸세요. 한 번의 속도 측정만 좋아지거나 다른 앱에 문제가 생기면 원래 값으로 되돌립니다. 안정적으로 재현되지 않는다면 실험 설정을 모든 네트워크에 적용하지 마세요.
처리 후에는 더 쉽게 성공하는 속도 테스트로 원래 문제를 대신하지 말고 실제 문제가 발생한 상황에서 다시 확인하세요. 장시간 다운로드에서 문제가 났다면 같은 유형의 다운로드를 이전에 멈췄던 지점까지 실행합니다. 웹페이지에 들어갈 때 문제가 발생했다면 같은 도메인에 새로 요청해 첫 응답 대기 시간이 실제로 줄었는지 확인하세요. 개선을 가져온 변경 사항이 하나뿐인지, 어떤 네트워크에서 적용되는지 기록합니다. 이전 네트워크로 돌아가면 계속 실패하고 다른 네트워크에서는 안정적이라면 두 결과를 각각 기록하세요. 네트워크 조건이 다른 결과를 하나로 묶어 클라이언트가 완전히 복구됐다고 결론 내리지 마세요.
DNS 문제: 노드 도메인과 접속 대상 도메인 구분
실제로 DNS 조회를 수행하는 구성 요소 찾기
먼저 문제 기록에 DNS 조회에 실패한 대상이 노드 서버 도메인인지 접속 대상 도메인인지 적으세요. 노드 서버 도메인은 프록시 연결을 시작하기 전에 조회해야 할 수 있습니다. 접속 대상 도메인의 조회는 프록시 연결 방식과 설정에 따라 시스템, 브라우저, 로컬 코어 또는 원격에서 처리될 수 있습니다. 시스템 명령에서 조회에 성공했다는 것은 해당 명령이 사용한 DNS 경로가 작동한다는 뜻일 뿐, 브라우저의 보안 DNS나 코어도 같은 DNS 서버를 사용한다는 뜻은 아닙니다. 코어 로그에 대상 주소가 있더라도 로컬에서 도메인을 조회했다고 단정할 수 없습니다. 앱이 주소를 전달했을 수도 있습니다. 현상이 서로 다르면 설정을 바꾸기 전에 먼저 DNS 조회를 수행한 주체를 확인하세요.
문제가 발생한 같은 도메인을 여러 앱에서 비교하고 실제로 조회된 주소 유형, 오류와 발생 시각을 기록하세요. 여러 앱에서 도메인을 찾지 못한다면 현재 네트워크의 DNS 설정과 도메인 철자를 확인합니다. 브라우저 하나에서만 문제가 발생한다면 브라우저가 별도의 보안 DNS를 사용하는지, 해당 주소가 현재 네트워크에서만 조회되는 이름인지 살펴보세요. 앱이 프록시에 도메인 조회를 맡긴다면 로컬 명령의 조회 결과는 실제 접속과 직접 관련이 없을 수 있습니다. DNS 상태를 판단하려고 HTTPS 주소를 IP 주소로 바꾸지 마세요. 인증서 검증, 가상 호스트와 라우팅 매칭이 모두 달라집니다.
조회 결과와 새 요청을 교차 확인
아래 명령은 일반적인 데스크톱 환경에서 기본 DNS 서버가 공개 예시 도메인에 응답하는지 확인합니다. 실제 문제를 진단할 때는 테스트 권한이 있는 문제가 발생한 도메인으로 example.org를 바꾸고 IPv4와 IPv6 레코드를 나누어 확인하세요. 대상에 한 종류의 레코드만 설정된 것은 DNS 장애가 아닙니다. 두 종류의 주소가 모두 반환되는데도 앱 연결이 실패한다면 앱이 실제로 어느 주소를 선택했는지, 그 주소에 연결할 수 있는지 확인합니다. 조회 시간 초과, 도메인 없음, 요청한 유형의 레코드 없음은 서로 다른 결과입니다. 모두 DNS 서버 장애로 단정하지 마세요. 내부 도메인은 허가된 내부 DNS 서버에서만 조회해야 합니다.
nslookup -type=A example.org
nslookup -type=AAAA example.org
현재 네트워크로 전환하기 전후의 결과를 비교할 때 이전 탭의 새로고침 여부만으로 판단하지 마세요. 이미 연결된 세션은 이전 주소를 계속 사용할 수 있고 앱, 시스템 또는 DNS 서버가 이전 성공이나 실패 결과를 캐시했을 수 있습니다. 설정을 변경한 뒤에는 관련 페이지나 앱을 닫고 새 요청을 만들어 로그를 확인하세요. 모든 계층의 캐시를 한꺼번에 지우면 어떤 캐시가 결과에 영향을 줬는지 알 수 없습니다. DNS는 복구됐는데 대상에 접속할 수 없다면 요청에 선택된 주소와 라우팅을 확인하세요. 도메인에 의존하는 규칙인데 인바운드에서 주소만 전달됐다면 매칭에 필요한 정보가 실제로 보이는지 먼저 살펴봅니다.
DNS 서버의 시작 의존성과 규칙 용도 파악
코어에 별도의 DNS 서비스가 설정돼 있다면 해당 서비스에 연결하는 데 먼저 다른 주소 조회가 필요한지, 아직 연결되지 않은 프록시 아웃바운드에 의존하는지 확인하세요. 프록시 노드 도메인의 유효한 주소를 먼저 알아야 하는데 DNS 서비스는 해당 노드를 통해서만 접속할 수 있다면 의존성 순환이 생깁니다. 아직 연결되지 않은 경로로 모든 DNS 요청을 옮기지 마세요. 작동하는 초기 DNS 경로를 유지하고 별도 처리가 필요한 대상만 범위를 정해 조정합니다. 관리되는 네트워크라면 내부 도메인, 검색 접미사와 사설 주소의 DNS 규칙을 먼저 확인하세요. 변경 후 노드 도메인, 일반 공개 도메인과 필요한 내부 도메인을 각각 확인해 특정 종류만 해결되는 일이 없도록 합니다.
코어 설정을 변경하기 전에 현재 실행 중인 코어에서 해당 필드를 지원하는지 확인하세요. 다른 코어의 설정 구조를 그대로 붙여 넣으면 안 됩니다. 라우팅의 도메인 매칭, DNS 서비스의 도메인 매칭과 반환 주소 제한은 서로 다른 단계에 적용됩니다. 규칙이 적용되지 않는다면 현재 로드된 설정이 클라이언트 생성 설정인지 수동 설정인지 확인한 뒤, 로그에 알 수 없는 필드나 데이터 파일 읽기 오류가 있는지 살펴보세요. 각 필드의 용도를 차례로 이해하려면 V2Ray DNS 설정 자세히 알아보기를 참고하세요. 실제 문제를 진단할 때는 현재 요청과 사용 중인 DNS 서버의 응답을 기준으로 판단합니다.
시스템 프록시가 적용되지 않을 때: 적용 범위와 남은 설정 확인
먼저 앱이 시스템 설정을 사용하는지 확인
시스템 프록시는 앱이 사용할 수 있는 연결 설정일 뿐 기기의 모든 트래픽을 가로채는 기능은 아닙니다. 문제가 발생한 앱이 시스템 기본 프록시, 자체 프록시 설정, 실행 환경의 프록시 환경 변수 중 무엇을 사용하는지 확인하세요. 시스템 설정을 사용하는 것이 확실한 브라우저와 비교한 뒤 문제가 있는 앱을 완전히 종료하고 다시 실행합니다. 일부 앱은 시작 시에만 설정을 읽습니다. 창을 닫아도 트레이에 계속 실행 중이거나 데스크톱과 다른 계정 환경에서 작동하는 경우도 있습니다. 브라우저는 정상이지만 문제가 있는 앱의 요청이 코어에 나타나지 않는다면 라우팅 규칙부터 바꾸지 마세요. 앱이 프록시 설정을 어디서 읽는지 확인한 다음 수동 설정이 필요한지 판단합니다.
클라이언트에서 자동 설정을 선택했다면 트레이 메뉴만 보지 말고 시스템에 실제로 적용된 주소, 포트와 예외 항목을 확인하세요. 시스템 프록시를 변경하지 않는 옵션을 선택해도 기존 값이 남을 수 있으며 자동으로 직접 연결로 복원되지는 않습니다. 프록시를 수동 설정했던 기기라면 원래 예외 항목과 자동 구성 주소도 기록해야 합니다. 앱의 프록시 주소로 로컬 수신 포트를 입력할 때는 앱이 지원하는 프로토콜에 맞춰 HTTP 또는 SOCKS를 선택하세요. 포트가 열려 있다는 이유만으로 앱과 방식이 일치한다고 볼 수 없습니다. 처음 테스트할 때는 예외 목록에 없는 공개 도메인과 제외되어야 하는 내부 사이트를 각각 확인해 프록시 적용과 예외 처리가 예상대로 되는지 비교하세요.
플랫폼별로 실제 적용 위치 확인
| 플랫폼 | 우선 확인할 항목 | 일반적인 차이 |
|---|---|---|
| Windows | 설정 → 네트워크 및 인터넷 → 프록시 | 데스크톱 사용자 설정과 서비스 프로세스의 WinHTTP 설정은 다릅니다. |
| macOS | 현재 네트워크 서비스 세부 정보 → 프록시 | 무선과 유선 서비스에 서로 다른 설정이 저장될 수 있습니다. |
| Linux | 데스크톱 세션의 네트워크 프록시 및 앱 자체 프록시 옵션 | 데스크톱, 터미널과 시스템 서비스는 각각 다른 실행 환경을 사용합니다. |
Windows에서는 현재 로그인한 사용자의 시스템 프록시와 일부 서비스가 사용하는 WinHTTP를 구분해야 합니다. 데스크톱 브라우저는 정상인데 백그라운드 서비스가 실패한다면 서비스가 사용하는 네트워크 인터페이스와 계정을 먼저 확인하세요. 데스크톱 프록시 설정을 시스템 전체에 그대로 적용하지 마세요. macOS에서는 현재 활성화된 네트워크 서비스를 확인하고 유선과 무선 사이를 전환한 뒤 설정을 다시 살펴보세요. 예전에 설정했던 서비스만 확인해서는 안 됩니다. Linux에서는 실행 방식을 특히 주의하세요. 터미널에서 실행한 프로세스와 데스크톱에서 실행한 프로세스가 서로 다른 환경 변수를 받을 수 있습니다. 앱 문서에서 설정을 읽는 순서를 확인한 다음 해당 앱에 실제로 적용되는 값을 변경하세요.
시스템 페이지의 프록시 값이 잠시 후 바뀐다면 관리 정책, 다른 프록시 앱 또는 브라우저 확장 프로그램이 설정을 동시에 관리하는지 확인하세요. 중복으로 작동하는 것이 분명한 프로그램은 종료하되 기기 관리자가 지정한 설정은 유지하고 자동 설정을 한 번만 실행합니다. 시스템 프록시의 적용 범위를 확인하려고 가상 네트워크 어댑터 모드까지 바로 켜지 마세요. 연결 방식을 바꿀 때는 기존 방식을 먼저 중지하고 시스템 설정이 원래 상태로 돌아왔는지 확인해야 합니다. 가상 네트워크 어댑터가 대상 앱의 트래픽을 처리할 수 있는지는 라우팅, 예외 항목과 권한에 달려 있습니다. 앱 설정 오류를 간단히 덮는 방법으로 여기지 마세요.
종료 후 남은 설정을 정리하고 다시 테스트
클라이언트를 종료한 뒤 웹페이지가 오히려 열리지 않는다면 시스템이나 앱이 종료된 로컬 수신 포트를 계속 가리키는지 확인하세요. 클라이언트를 다시 실행할 수 있다면 먼저 클라이언트의 초기화 기능을 사용한 다음 시스템 설정을 확인합니다. 실행할 수 없다면 문제를 조사하기 전에 기록한 프록시 설정을 시스템에서 복원하세요. 앱에서 프록시 주소를 별도로 저장하는 경우 시스템 설정을 복원한 뒤 해당 항목도 하나씩 되돌려야 합니다. 평소 프록시를 사용하지 않는 기기는 시스템이 오래된 로컬 포트를 가리키지 않는지 확인하세요. 조직 프록시를 사용하는 환경이라면 모든 프록시 설정을 지우지 말고 조직에서 제공한 설정을 복원합니다. 변경 후에는 영향을 받은 앱을 다시 시작해 이전 연결을 계속 사용하지 않도록 하세요.
마지막으로 두 차례 확인하세요. 클라이언트를 켠 상태에서 예상한 요청이 올바른 연결 경로를 사용하는지 살펴보고, 정상적으로 종료한 뒤에는 원래 직접 연결할 수 있는 리소스에 계속 접속되는지 확인합니다. 절전 모드에서 깨어나거나 네트워크를 바꿀 때마다 문제가 재현된다면 전후의 현재 네트워크 서비스, 시스템 프록시 값과 로컬 수신 상태를 각각 기록해 무엇이 먼저 바뀌는지 찾으세요. 상태 아이콘과 실제 연결이 다르면 시스템 설정과 요청 기록을 기준으로 판단합니다. 특정 앱 하나에서만 재현된다면 앱 설정을 다시 확인하고 예외 하나 때문에 시스템 네트워크 전체를 초기화하지 마세요.
앱 충돌: 화면과 코어의 종료 원인을 따로 확인
종료가 발생한 단계 파악
먼저 아이콘을 눌러도 화면이 전혀 나타나지 않는 경우, 화면이 뜬 직후 종료되는 경우, 화면은 정상인데 코어가 시작된 뒤 종료되는 경우를 구분하세요. 앞의 두 경우에는 시스템 앱 이벤트와 클라이언트 시작 로그를 우선 확인하고, 마지막 경우에는 코어 로그부터 살펴봅니다. 시작 오류가 발생한 시각을 기록하고 해당 실행 시도의 첫 번째 오류를 보관하세요. 뒤이어 나오는 여러 오류는 첫 실패의 연쇄 결과일 수 있습니다. 특정 페이지를 열거나 특정 그룹을 불러오거나 특정 노드로 전환할 때마다 충돌한다면 어떤 작업을 했는지, 매번 재현되는지 기록합니다. 반복해서 재시작하지 마세요. 다시 실행하면 가장 먼저 발생한 중요한 로그를 찾기 어려워질 수 있습니다.
화면이 나타나지 않는다고 반드시 충돌한 것은 아닙니다. 트레이에 최소화됐는지, 프로세스가 계속 실행 중인지, 이미 실행 중인 다른 인스턴스를 시작한 것은 아닌지 확인하세요. 클릭한 직후 프로세스가 사라진다면 시스템이 실행을 차단했는지, 런타임 종속성, 프로세서 아키텍처, 작업 디렉터리 또는 파일 접근 권한에 오류가 있는지 확인합니다. 앱 실행기나 데스크톱 바로가기로 열었다면 바로가기가 현재 설치 위치를 가리키는지 살펴보세요. 시스템 보안 정책이나 기기 관리 제한이 있다면 해당 기기의 규정에 따라 관리자에게 문의하고 보안 기능을 꺼서 테스트하지 마세요. 클라이언트가 실행되지 않아 프록시 설정만 남았다면 계속 문제를 조사하기 전에 시스템에서 원래 프록시 상태를 복원하세요.
첫 번째 오류를 기준으로 설치, 포트와 설정 확인
오류가 아키텍처나 시작 종속성을 가리킨다면 설치 파일이 시스템과 일치하는지 다시 확인하세요. 데스크톱에서는 v2rayN을 권장합니다. 다운로드 센터에서 플랫폼, 클래식 인터페이스, 프로세서 아키텍처와 패키지 형식을 구분할 수 있습니다. Windows에서는 두 인터페이스의 프로그램 파일을 섞지 마세요. macOS에서는 Apple Silicon과 Intel용을 확인합니다. Linux에서는 배포판의 패키지 형식과 프로세서 아키텍처를 모두 확인하세요. 클라이언트가 여러 개 설치돼 있다면 예상한 위치에서 실행해 새 프로그램이 다른 구형 폴더의 파일을 불러오지 않게 합니다. 데이터 디렉터리에 쓸 수 없다는 오류라면 현재 계정과 파일 소유권을 확인하세요. 권한 설정 문제를 가리기 위해 계속 높은 권한으로 실행해서는 안 됩니다.
클라이언트 화면은 실행되지만 코어가 종료된다면 파일 읽기, 설정 검사, 포트 바인딩, 네트워크 초기화 중 어느 단계에서 실패했는지 확인하세요. 바인딩 오류는 로컬 수신 포트 절차를 따릅니다. 파일 읽기 오류라면 경로와 파일 존재 여부, 현재 계정의 접근 권한을 확인하세요. 수동 설정을 불러올 때 필드 오류가 발생한다면 먼저 선택한 코어를 확인한 다음 오류 줄 주변의 괄호, 따옴표, 필드 대소문자와 중복 항목을 살펴보세요. 아래는 기존 파일과 비교하기 위한 Xray 최상위 로그 필드 예시이며 단독으로 연결할 수 있는 설정은 아닙니다. 기존 설정에 합칠 때 같은 이름의 최상위 필드를 두 번 추가하지 마세요.
{
"log": {
"loglevel": "warning"
}
}
초기 설정으로 재현한 뒤 설정을 나누어 복원
설정 손상이 의심된다면 클라이언트를 완전히 종료하고 이 기기에 설정 데이터를 백업한 뒤 원래 파일 위치를 기록하세요. 먼저 클라이언트가 지원하는 임시 설정이나 별도 인스턴스 테스트 방식을 사용합니다. 그런 기능이 없다면 데이터 디렉터리가 현재 클라이언트만 사용하는지 확인하고 기존 폴더를 잠시 다른 위치로 옮겨 프로그램이 초기화되도록 합니다. 백업하지 않은 데이터를 삭제하거나 다른 앱의 파일까지 동시에 옮기지 마세요. 초기 설정에서 정상 실행된다면 설정 종류별로 하나씩 복원하고 노드 하나를 테스트한 뒤 구독, 라우팅과 시작 설정을 복구합니다. 특정 설정 묶음을 복원한 뒤 다시 종료되면 그 묶음을 되돌리고 범위를 좁혀 보세요. 정상적으로 작동하는 다른 설정까지 모두 지울 필요는 없습니다.
초기 설정에서도 종료된다면 시스템 환경, 설치 파일 유형, 재현 단계와 첫 번째 오류를 기록하세요. 플랫폼에 맞는 설치 파일로 바꿔야 하는지 또는 기기 관리자에게 권한 확인을 요청해야 하는지 판단합니다. 복구 후에는 일반 사용자 계정으로 실행하고 정상적으로 종료한 뒤 다시 시작해 보세요. 마지막으로 문제를 유발했던 작업을 다시 시도합니다. 인바운드, 아웃바운드와 라우팅 필드의 참조 관계를 알아보려면 V2Ray 설정 파일 구조를 참고할 수 있지만 설명 문서의 예시를 현재 사용 중인 설정에 그대로 덮어쓰지 마세요.
Android 문제: 권한, 앱 적용 범위와 백그라운드 연결
시스템에서 VPN 연결을 허용했는지 먼저 확인
Android에서는 v2rayNG를 우선 사용하고 V2Fly 코어 설정에 맞춰야 한다면 필요에 따라 v2flyNG를 선택할 수 있습니다. 처음 연결을 시작할 때 시스템의 VPN 권한 요청이 나타나는지 확인하세요. 권한을 거부하거나 창을 닫으면 클라이언트에서 노드를 선택해도 시스템에 연결이 만들어지지 않을 수 있습니다. 클라이언트로 돌아와 연결을 다시 시작하고 시스템 VPN 설정에 현재 앱이 활성 상태로 표시되는지 확인합니다. 같은 사용자나 프로필 환경에서 다른 앱이 이미 VPN을 제어한다면 해당 앱을 잠시 중지할 수 있는지 먼저 확인하세요. 관리 기기에서는 강제 연결 정책을 끄지 말고 허용된 사용 범위를 관리자에게 문의하세요. 클라이언트에 실행 중이라고 표시되는 것만으로 시스템 연결 상태를 확인했다고 볼 수 없습니다.
같은 구독을 데스크톱에서는 사용할 수 있는데 휴대전화에서 연결되지 않는다면 휴대전화와 데스크톱을 같은 Wi-Fi 네트워크에 연결하고 같은 노드와 공개 테스트 주소를 선택하세요. 휴대전화에서 실제로 업데이트된 노드를 선택했는지, 해당 노드의 프로토콜과 전송 매개변수를 지원하는지 확인합니다. 데스크톱이 정상인 이유는 다른 코어, 라우팅 또는 업데이트 방식을 사용했기 때문일 수도 있습니다. 휴대전화 설치 파일에 문제가 있다고 단정하지 마세요. 앱 화면조차 열리지 않는다면 Android 다운로드 안내에서 프로세서 아키텍처를 확인하세요. 앱은 정상적으로 실행되지만 요청이 실패한다면 연결 로그를 먼저 살펴보고 진단 방법으로 반복해서 재설치하지 마세요.
일부 앱에서만 실패할 때 프록시 적용 범위 확인
브라우저에서는 접속되지만 특정 앱만 실패한다면 앱별 프록시 설정이 켜져 있는지 확인하세요. 현재 모드가 선택한 앱만 프록시를 사용하는 방식인지, 선택한 앱을 제외하는 방식인지 확인해야 합니다. 두 모드에서 같은 목록이 같은 의미로 작동한다고 볼 수 없습니다. 일부 기기에서는 개인 프로필과 업무 프로필에 같은 앱이 따로 설치됩니다. 한쪽에서 앱을 선택해도 다른 프로필의 앱까지 자동 선택되지는 않습니다. 목록을 수정하기 전에 기존 예외를 기록하고 기기 정책에 맞는 범위에서 테스트할 앱만 변경하세요. 저장 후 클라이언트 안내에 따라 연결을 다시 수립하고 앱을 실행해 확인합니다. 동기화와 인증 트래픽의 경로가 바뀌지 않도록 관련 없는 앱을 모두 테스트 목록에 추가하지 마세요.
프록시를 켰을 때 모든 앱에서 인터넷이 끊긴다면 현재 네트워크가 테스트 사이트에 접속할 수 있는지 먼저 확인하고, 클라이언트 로그에서 노드 DNS 조회, 연결 또는 핸드셰이크 오류를 살펴보세요. 휴대전화 시스템의 비공개 DNS와 클라이언트의 DNS 처리 정책이 동시에 적용될 수 있으며 트래픽 경로에 따라 일부 앱에만 영향을 줄 수도 있습니다. 현재 설정을 기록하고 기기 관리 정책이 적용되는지 확인하세요. 비공개 DNS를 끄는 것을 일반적인 해결책으로 삼지 마세요. Wi-Fi와 모바일 데이터 사이를 전환할 때만 실패한다면 새 네트워크가 실제로 연결된 뒤 다시 연결하세요. 전환 전후 로그를 남겨 연결 제어가 다시 설정되지 않은 것인지 새 네트워크에서 노드 연결에 실패한 것인지 구분합니다.
화면 잠금 후 연결 끊김과 네트워크 전환 문제 재확인
화면이 켜져 있을 때는 안정적이지만 잠금 후 일정 시간이 지나면 연결이 끊긴다면, 끊어진 시점에 시스템에 VPN이 계속 표시되는지와 클라이언트 알림이 남아 있는지 확인하세요. 화면을 다시 켰을 때 수동 조작 없이 복구되는지도 살펴봅니다. 알림이 보이지 않는 것은 알림 권한 문제일 수 있으므로 시스템의 실제 연결 상태와 함께 확인해야 합니다. 시스템 연결은 유지되는데 요청만 실패한다면 네트워크 절전, 연결 전환이나 노드 장애를 먼저 살펴봅니다. 시스템 연결도 끊겼다면 해당 앱의 백그라운드 실행 제한을 확인하세요. 시스템이 허용하는 경우 이 앱의 배터리 또는 백그라운드 권한만 조정하고, 원래 문제를 일으켰던 시간만큼 화면을 잠가 다시 테스트합니다. 기기 전체의 절전 기능을 끌 필요는 없습니다.
휴대전화에서 항상 사용 VPN과 VPN 미사용 연결 차단을 켠 경우 연결이 다시 수립되는 동안 기기 전체가 오프라인처럼 보일 수 있습니다. 먼저 시스템에 연결된 앱이 현재 사용하는 클라이언트인지 확인하고 클라이언트를 바꾸기 전에 해당 정책을 변경해도 되는지 확인하세요. 다시 테스트할 때는 화면 잠금과 네트워크 전환을 각각 따로 시험합니다. 문제가 해결된 뒤에는 필요한 백그라운드 권한을 유지하고 임시 테스트 옵션은 원래대로 되돌리세요. 어떤 클라이언트를 선택할지 아직 판단하기 어렵다면 클라이언트 비교 가이드를 먼저 읽고, 설치나 일상 설정 관련 짧은 답변은 자주 묻는 질문에서 확인하세요.