이 글의 목차
화면 연결만 끊긴 것인지 코어가 실제로 시작되지 않은 것인지 먼저 확인
홈 화면에 '코어 통신 오류'가 표시되고 현재 노드가 비어 있으면 대개 프록시가 완전히 중지되었다고 생각하기 쉽습니다. 구독을 삭제하거나 DNS를 바로 바꾸지 마세요. '로그'와 '연결' 페이지를 연 뒤 브라우저에서 새 웹페이지에 접속하고 방금 사용한 도메인과 외부 연결 기록이 나타나는지 관찰합니다.
웹페이지가 계속 열리고 로그에도 TCP 또는 UDP 연결이 계속 추가된다면 Mihomo는 여전히 전달 중이지만 데스크톱 화면에서 프록시 그룹과 현재 노드를 읽지 못하는 상황일 수 있습니다. 최근 공식 issue에는 시스템 프록시가 가리키는 로컬 포트는 계속 작동하고 런타임 구성에도 노드가 있지만 홈과 프록시 페이지에서 제어 정보를 읽지 못하는 상태가 기록되어 있습니다.
증상에 따라 먼저 분류
| 현재 나타나는 현상 | 가능성이 높은 문제 | 이 글에서 시작할 지점 |
|---|---|---|
| 웹페이지는 열리고 로그는 계속 추가되지만 프록시 페이지는 비어 있음 | 화면과 코어 사이의 제어 통신 이상 | 버전을 먼저 업데이트한 뒤 서비스 모드 확인 |
| 웹페이지가 열리지 않고 로그에도 새 연결이 없음 | 코어가 시작되지 않았거나 요청이 클라이언트에 유입되지 않음 | 구성 검증, 서비스와 로컬 포트 확인 |
| 구독 업데이트 후 노드가 하나도 없음 | 구독 내용 또는 파싱 실패 | 구독 업데이트 오류로 돌아가고 제어 채널은 처리하지 않음 |
| 웹사이트 하나만 실패 | 규칙, DNS 또는 대상 사이트 호환성 문제 | 노드를 고정하고 해당 도메인의 일치 기록 확인 |
통신 상태 수정이 포함된 정식 버전을 우선 설치
Clash Verge Rev v2.5.2 공식 출시 안내에는 '홈 프록시 카드에서 통신 이상이 잘못 표시될 수 있는 문제 수정', '홈의 현재 프록시 상태가 가끔 동기화되지 않는 문제 수정', 'Clash 구성을 다시 로드한 뒤 규칙 페이지 데이터가 제때 갱신되지 않는 문제 수정'이 포함되어 있습니다. 문제가 v2.5.1 또는 이전 버전에서 발생한다면 제어기 포트를 바꾸는 것보다 정식 버전 업데이트가 더 직접적인 방법입니다.
프로젝트 공식 Release 또는 출처가 명시된 이 사이트의 다운로드 페이지에서 Windows 아키텍처와 일치하는 설치 패키지를 선택합니다. 업데이트 전에 로그를 내보내고 현재 구독 이름을 기록하세요. 설치가 끝나면 클라이언트를 완전히 한 번 종료한 뒤 다시 엽니다. 구독, TUN, DNS와 서비스 모드를 동시에 바꾸면 어느 단계가 효과가 있었는지 판단할 수 없습니다.
확인 가능한 업데이트 한 번
현재 버전과 오류 기록
정보 페이지에서 버전을 적고 홈 알림과 프록시 페이지 상태를 캡처한 뒤 구독 링크가 없는 로그를 내보냅니다.
아키텍처에 맞는 정식 패키지 다운로드
대부분의 Windows 컴퓨터는 x64를 사용하며 ARM Windows 기기만 ARM64를 선택합니다. 출처를 추적할 수 있는 출시 경로에서만 다운로드하세요.
클라이언트를 종료한 뒤 설치
트레이에서 Clash Verge Rev를 먼저 종료하고 설치 프로그램이 끝났는지 확인한 뒤 일반 사용자 권한으로 시작합니다.
기존 Profile만 테스트
기존 노드, Rule 모드와 시스템 프록시 설정을 당분간 유지하고 프록시 그룹이 복구되는지 확인합니다.
프록시 페이지가 계속 비어 있다면 코어 두 개가 같은 포트를 점유하는지 확인
업데이트 후에도 오류가 계속되면 작업 관리자의 '세부 정보'를 먼저 엽니다. 정상 서비스 모드에서는 데스크톱 프로그램, 서비스 프로세스와 Mihomo 코어 하나가 보입니다. verge-mihomo.exe가 두 개 동시에 있다면 기존 프로세스가 mixed-port 또는 명명된 파이프를 점유해 새 코어가 완전히 시작되지 못할 수 있습니다.
Clash 이름이 있는 프로세스가 여러 개 보인다고 모두 강제 종료하지 마세요. 트레이에서 클라이언트를 먼저 종료하고 몇 초 뒤 verge-mihomo.exe가 여전히 두 개 있는지 확인합니다. 로그에 bind, Only one usage, Access is denied 또는 pipe listen error가 나타날 때만 남은 프로세스, 포트 점유와 서비스 상태를 중점적으로 확인하세요.
Get-Process clash-verge, verge-mihomo -ErrorAction SilentlyContinue
Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 7897 |
Select-Object LocalAddress, LocalPort, OwningProcess
Get-Process -Id (Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 7897 |
Select-Object -First 1 -ExpandProperty OwningProcess)명령은 수신 프로세스를 확인할 뿐 종료하지 않습니다. Mixed 포트는 7897이 아닐 수 있으므로 클라이언트 설정이나 로그의 실제 값으로 바꾸세요. verge-mihomo.exe 하나가 정상적으로 수신하고 로그에 이미 프록시 요청이 나타난다면 포트 충돌 문제로 계속 다루지 마세요.
로그의 첫 오류를 기준으로 다음 단계 결정
서비스 모드를 시작할 때 클라이언트는 런타임 구성을 만들고 검증한 뒤 서비스에서 코어를 시작하게 하고 마지막으로 제어 인터페이스를 통해 프록시 그룹을 읽습니다. 맨 끝의 '통신 오류'만 보면 실제 실패 지점을 놓치게 됩니다. 한 번 재시작한 뒤 로그 맨 위부터 첫 error를 찾으세요.
구성 검증 실패, Invalid YAML 또는 unsupported field
문제는 Profile 또는 덮어쓰기에 있습니다. 수정하지 않은 구독으로 돌아가고 Merge, 스크립트와 사용자 필드를 임시로 끈 뒤 다시 검증하세요.
mixed port bind failed、Only one usage
로컬 포트를 기존 코어 또는 다른 프로그램이 점유했습니다. 클라이언트를 종료하고 수신 프로세스를 확인한 뒤 Windows를 재시작해 남은 상태를 정리하세요.
pipe listen error、Access is denied
서비스에서 제어 채널을 만들지 못했거나 권한이 일치하지 않습니다. 클라이언트 서비스를 먼저 재시작하고 계속 실패할 때만 서비스 모드를 재설치하세요.
구성 검증에 성공하고 포트와 pipe도 수신 중이지만 화면에는 계속 오류 표시
데스크톱 화면이 제어 정보를 읽지 못하는 문제에 더 가깝습니다. 정식 버전으로 업데이트했는지 확인하고 로그를 내보내 프로젝트 issue에 제출하세요. 노드를 계속 수정하지 않습니다.
코어는 성공적으로 시작했지만 새 연결이 전혀 없음
Windows 시스템 프록시가 현재 Mixed 포트를 계속 가리키는지 확인합니다. TUN을 사용한다면 가상 네트워크 인터페이스가 실제로 켜졌는지도 확인하세요.
Windows 방화벽은 롤백 가능한 방식으로 한 번만 새로 고침
Clash Verge Rev 공식 Windows FAQ는 '프록시 메뉴가 비는 현상'의 원인을 코어 통신 실패로 설명하며 Windows 방화벽을 껐다가 다시 켜라고 권장합니다. 여기서 핵심은 방화벽 규칙을 다시 로드하는 것이며 보호 기능을 장기간 끄는 것이 아닙니다.
Windows 보안 센터에서 '방화벽 및 네트워크 보호'를 열고 현재 네트워크 유형을 기록합니다. 해당 네트워크의 Microsoft Defender 방화벽을 잠시 껐다가 즉시 다시 켠 뒤 Clash Verge Rev를 종료하고 재시작하세요. 회사 컴퓨터가 관리자 정책으로 제어된다면 정책을 우회하지 말고 로그를 관리자에게 전달해 앱과 로컬 통신 규칙을 확인하도록 합니다.
방화벽 새로 고침 후 확인
- Microsoft Defender 방화벽을 다시 켬
- 테스트를 위해 공용 네트워크 대상 인바운드 포트를 추가하지 않음
- 보안 소프트웨어가 Clash Verge Rev와 서비스 프로세스를 격리하지 않음
- 클라이언트를 다시 열면 프록시 그룹이 표시되고 노드를 전환할 수 있음
구성에 노드가 있다고 화면에서 반드시 읽을 수 있는 것은 아닙니다
구독 다운로드, 런타임 구성과 프록시 페이지 표시는 서로 다른 세 단계입니다. 구독 페이지에 업데이트 시간이 표시되는 것은 주소를 저장하고 처리를 한 번 완료했다는 뜻일 뿐입니다. 런타임 YAML에 proxies와 proxy-groups가 있으면 코어가 노드를 받았다는 뜻입니다. 프록시 페이지에서는 제어 인터페이스를 통해 이 그룹들을 별도로 읽어야 합니다.
최근 공식 진단 기록에는 런타임 구성에 프록시와 정책 그룹이 있고 Mixed 포트도 트래픽을 전달하지만 external-controller가 비어 있으며 데스크톱 화면에서 읽을 수 있는 명명된 파이프만 남은 사례가 있습니다. 이 상황에서 HTTP 제어기를 직접 개방하는 것은 우선할 수정이 아니며 관리 인터페이스의 노출 범위를 넓힐 수 있습니다. 정식 버전 업데이트, 서비스 재시작과 방화벽 새로 고침을 먼저 완료하세요.
세 단계 검증 방법
| 단계 | 유효한 근거 | 실패했을 때 하지 말아야 할 작업 |
|---|---|---|
| 구독 다운로드 | 업데이트에 성공하고 실제 노드 수가 표시됨 | 구독 이름이 나타났다는 사실만 확인하지 않기 |
| 코어 실행 | 로그에 구성 검증 성공, 포트 수신과 실제 연결이 표시됨 | 홈 카드만 보고 코어가 중지되었다고 판단하지 않기 |
| 화면 제어 | 프록시 그룹이 보이고 현재 노드를 읽을 수 있으며 전환이 적용됨 | 화면 복구를 위해 external-controller를 공개하지 않기 |
서비스 이상을 확인한 뒤 서비스 모드 재설치
로그에서 서비스, 파이프 권한 또는 중복 코어를 명확히 지목하고 업데이트와 방화벽 새로 고침이 모두 효과가 없을 때만 서비스 모드를 처리합니다. 시스템 프록시와 TUN을 먼저 끄고 일반 네트워크가 복구되는지 확인한 뒤 클라이언트 설정의 서비스 모드에서 서비스를 제거하고 Windows를 재시작해 다시 설치합니다.
서비스 재설치는 만료된 구독을 고치지 않으며 프록시 페이지가 빌 때마다 반복할 작업도 아닙니다. 재시작 후 관리자 권한이 없거나 버튼이 정책으로 비활성화되었거나 보안 소프트웨어가 서비스 설치를 막는다면 반복 시도를 중단하고 내보낸 앱 로그와 서비스 로그를 보존하세요.
안전한 복구 순서
Windows 직접 연결부터 복구
시스템 프록시와 TUN을 끄고 클라이언트를 종료한 뒤 일반 웹페이지가 계속 열리는지 브라우저에서 확인합니다.
Profile과 로그 백업
구독 URL, 노드 비밀번호 또는 컨트롤러 secret을 공개하지 말고 문제 보고에는 민감 정보를 제거한 일부 내용만 첨부합니다.
제거 후 재시작
클라이언트에서 제공하는 서비스 모드 메뉴를 통해 제거하고 시스템 서비스 파일을 수동으로 삭제하지 않습니다. 완료 후 Windows를 재시작하세요.
서비스 모드 재설치
클라이언트의 정상 메뉴에서 관리자 권한을 요청하고 시작 후에는 기존 Profile만 활성화해 검증합니다.
계속 실패하면 구성 수정을 중단
버전, 시스템 아키텍처, 첫 error, 프로세스와 포트 결과를 첨부해 공식 issue에 제출합니다.
수정 후 다섯 가지 검사를 모두 통과해야 함
프록시 페이지가 다시 나타났다고 문제가 완전히 끝난 것은 아닙니다. 마지막으로 같은 Profile과 노드로 화면에서 실제 접속까지 이어지는 전체 과정을 한 번 완료해야 서비스, 제어 채널과 전달 기능이 모두 복구되었다고 확인할 수 있습니다.
완료 기준
- 홈 화면에 코어 통신 오류가 더 이상 표시되지 않고 현재 프록시 모드와 노드 이름을 읽을 수 있음
- 프록시 페이지에 전체 정책 그룹이 표시되고 노드 전환 시 선택 상태가 즉시 갱신됨
- 작업 관리자에 작동 중인 verge-mihomo.exe가 하나만 있음
- 브라우저에서 테스트 사이트에 접속하면 연결 페이지에 해당 도메인, 규칙과 외부 경로가 나타남
- 클라이언트를 종료하면 Windows 시스템 프록시가 꺼지고 일반 네트워크가 복구됨