이 글의 목차
홈 화면에 통신 오류가 나타나면 구성이 사라진 것은 아닌지 걱정될 수 있습니다. 화면은 코어에서 노드와 상태를 읽고 코어는 별도로 연결을 처리하므로 두 곳의 상태가 다를 수 있습니다. 먼저 현재 구성이 새 요청을 계속 전달할 수 있는지 확인해야 합니다.
프록시 페이지가 비어 있을 때 웹 접속은 가능한가
홈 화면에 ‘코어 통신 오류’가 표시되고 프록시 페이지가 비어 있다면 새 웹 페이지 요청으로 코어가 여전히 트래픽을 전달하는지 확인할 수 있습니다. ‘로그’와 ‘연결’ 페이지를 열어 해당 요청의 도메인과 아웃바운드 기록을 확인하세요. 구독을 삭제하거나 즉시 DNS를 변경하지 마세요.
새 요청이 완료되고 로그에 TCP 또는 UDP 연결이 계속 나타난다면 Mihomo가 트래픽을 전달하고 있을 수 있습니다. 최근 공식 issue에는 시스템 프록시가 사용하는 로컬 포트는 이용할 수 있고 실행 설정에는 노드가 있는데도 데스크톱 화면에서 프록시 그룹이나 현재 노드 등의 제어 정보를 읽지 못한 사례가 기록되어 있습니다.
로그의 첫 오류를 기준으로 다음 단계 결정
서비스 모드를 시작할 때 클라이언트는 런타임 구성을 만들고 검증한 뒤 서비스에서 코어를 시작하게 하고 마지막으로 제어 인터페이스를 통해 프록시 그룹을 읽습니다. 맨 끝의 '통신 오류'만 보면 실제 실패 지점을 놓치게 됩니다. 한 번 재시작한 뒤 로그 맨 위부터 첫 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을 사용한다면 가상 네트워크 인터페이스가 실제로 켜졌는지도 확인하세요.
나타나는 현상에 따른 처리 방법
| 현재 나타나는 현상 | 가능성이 높은 문제 | 조치를 시작할 곳 |
|---|---|---|
| 웹페이지는 열리고 로그는 계속 추가되지만 프록시 페이지는 비어 있음 | 화면과 코어 사이의 제어 통신 이상 | 버전을 먼저 업데이트한 뒤 서비스 모드 확인 |
| 웹페이지가 열리지 않고 로그에도 새 연결이 없음 | 코어가 시작되지 않았거나 요청이 클라이언트에 유입되지 않음 | 구성 검증, 서비스와 로컬 포트 확인 |
| 구독 업데이트 후 노드가 하나도 없음 | 구독 내용 또는 파싱 실패 | 구독 업데이트 오류로 돌아가고 제어 채널은 처리하지 않음 |
| 웹사이트 하나만 실패 | 규칙, DNS 또는 대상 사이트 호환성 문제 | 노드를 고정하고 해당 도메인의 일치 기록 확인 |
구성에 노드가 있다고 화면에서 반드시 읽을 수 있는 것은 아닙니다
구독 다운로드, 런타임 구성과 프록시 페이지 표시는 서로 다른 세 단계입니다. 구독 페이지에 업데이트 시간이 표시되는 것은 주소를 저장하고 처리를 한 번 완료했다는 뜻일 뿐입니다. 런타임 YAML에 proxies와 proxy-groups가 있으면 코어가 노드를 받았다는 뜻입니다. 프록시 페이지에서는 제어 인터페이스를 통해 이 그룹들을 별도로 읽어야 합니다.
공식 진단 기록에서는 실행 구성에 프록시와 정책 그룹이 있고 Mixed 포트로 트래픽도 전달되지만 external-controller는 비어 있어 화면이 명명된 파이프로 정보를 읽습니다. HTTP 제어기를 직접 개방하면 관리 인터페이스 노출이 커질 수 있으므로 우선할 방법이 아닙니다. 정식 버전 업데이트와 방화벽 점검을 먼저 하세요. 서비스 구성 요소가 공식 보안 공지의 수정 요건을 충족하는지 확인한 뒤에만 서비스를 재시작하세요.
세 단계 검증 방법
| 단계 | 유효한 근거 | 실패했을 때 하지 말아야 할 작업 |
|---|---|---|
| 구독 다운로드 | 업데이트에 성공하고 실제 노드 수가 표시됨 | 구독 이름이 나타났다는 사실만 확인하지 않기 |
| 코어 실행 | 로그에 구성 검증 성공, 포트 수신과 실제 연결이 표시됨 | 홈 화면 카드만 보고 코어가 실행을 멈췄다고 판단하지 마세요 |
| 화면 제어 | 프록시 그룹이 보이고 현재 노드를 읽을 수 있으며 전환이 적용됨 | 화면 복구를 위해 external-controller를 공개하지 않기 |
통신 상태 수정이 포함된 정식 버전을 우선 설치
Clash Verge Rev v2.5.2 공식 출시 안내에는 '홈 프록시 카드에서 통신 이상이 잘못 표시될 수 있는 문제 수정', '홈의 현재 프록시 상태가 가끔 동기화되지 않는 문제 수정', 'Clash 구성을 다시 로드한 뒤 규칙 페이지 데이터가 제때 갱신되지 않는 문제 수정'이 포함되어 있습니다. 문제가 v2.5.1 또는 이전 버전에서 발생한다면 제어기 포트를 바꾸는 것보다 정식 버전 업데이트가 더 직접적인 방법입니다.
프로젝트 공식 Release 또는 출처가 명시된 이 사이트의 다운로드 페이지에서 Windows 아키텍처에 맞는 설치 파일을 선택하세요. 업데이트할 때 구독과 DNS 설정은 보존하세요. 비활성화한 이전 서비스와 TUN은 그대로 꺼 두고, 서비스 구성 요소가 공식 보안 공지의 수정 요건을 충족하는지 확인한 뒤에만 서비스 모드를 다시 켜세요.
확인 가능한 업데이트 한 번
현재 버전과 오류 기록
정보 페이지에서 버전을 기록하고 홈 화면 안내와 프록시 페이지 상태를 캡처한 뒤 구독 링크를 제외한 로그를 내보내세요. 현재 구독 이름도 기록하세요.
아키텍처에 맞는 정식 패키지 다운로드
대부분의 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 하나가 정상적으로 수신하고 로그에 이미 프록시 요청이 나타난다면 포트 충돌 문제로 계속 다루지 마세요.
Windows 방화벽을 잠시 껐다 다시 켜면 프록시 그룹이 표시되나요?
Clash Verge Rev 공식 Windows FAQ는 프록시 메뉴가 비는 원인을 코어 통신 실패로 설명하며 Windows 방화벽을 껐다 다시 켜라고 권장합니다. 잠시 끈 뒤 즉시 다시 켜서 비교하는 데만 사용하세요. 보호 기능을 꺼 둔 채로 유지하거나 이 결과만으로 구체적인 원인을 단정하지 마세요.
Windows 보안 센터에서 '방화벽 및 네트워크 보호'를 열고 현재 네트워크 유형을 기록합니다. 해당 네트워크의 Microsoft Defender 방화벽을 잠시 껐다가 즉시 다시 켠 뒤 Clash Verge Rev를 종료하고 재시작하세요. 회사 컴퓨터가 관리자 정책으로 제어된다면 정책을 우회하지 말고 로그를 관리자에게 전달해 앱과 로컬 통신 규칙을 확인하도록 합니다.
방화벽 새로 고침 후 확인
- Microsoft Defender 방화벽을 다시 켬
- 테스트를 위해 공용 네트워크 대상 인바운드 포트를 추가하지 않음
- 보안 소프트웨어가 Clash Verge Rev와 서비스 프로세스를 격리하지 않음
- 클라이언트를 다시 열면 프록시 그룹이 표시되고 노드를 전환할 수 있음
로그가 서비스 이상을 가리킬 때 안전하게 서비스 복구하기
로그가 서비스, 파이프 권한이나 중복 코어 문제를 명확히 가리키고 업데이트와 방화벽 규칙 새로 적용으로도 해결되지 않을 때만 서비스 모드를 처리하세요. 재설치 전 공식 Windows 서비스 보안 공지와 실제 서비스 구성 요소를 확인하고, 영향을 받는 이전 서비스는 다시 켜지 마세요.
서비스 재설치는 만료된 구독을 고치지 않으며 프록시 페이지가 빌 때마다 반복할 작업도 아닙니다. 재시작 후 관리자 권한이 없거나 버튼이 정책으로 비활성화되었거나 보안 소프트웨어가 서비스 설치를 막는다면 반복 시도를 중단하고 내보낸 앱 로그와 서비스 로그를 보존하세요.
안전한 복구 순서
Windows 직접 연결부터 복구
시스템 프록시와 TUN을 끄고 클라이언트를 종료한 뒤 일반 웹페이지가 계속 열리는지 브라우저에서 확인합니다.
Profile과 로그 백업
구독 URL, 노드 비밀번호 또는 컨트롤러 secret을 공개하지 말고 문제 보고에는 민감 정보를 제거한 일부 내용만 첨부합니다.
제거 후 재시작
클라이언트에서 제공하는 서비스 모드 메뉴를 통해 제거하고 시스템 서비스 파일을 수동으로 삭제하지 않습니다. 완료 후 Windows를 재시작하세요.
서비스 모드 재설치
서비스 구성 요소가 공식 보안 공지의 수정 조건을 충족하는지 확인한 뒤에만 클라이언트 메뉴에서 관리자 승인을 받아 설치하세요. 시작 후에는 원래 Profile만 활성화해 확인하세요.
계속 실패하면 구성 수정을 중단
버전, 시스템 아키텍처, 첫 error, 프로세스와 포트 결과를 첨부해 공식 issue에 제출합니다.
프록시 그룹, 실제 요청과 종료 후 복구 확인하기
프록시 페이지가 다시 나타나는 것만으로는 충분하지 않습니다. 같은 Profile과 노드로 실제 웹사이트에 접속해 화면 표시, 서비스, 제어 채널과 요청 전달이 모두 정상인지 확인하세요.
완료 기준
- 홈 화면에 코어 통신 오류가 더 이상 표시되지 않고 현재 프록시 모드와 노드 이름을 읽을 수 있음
- 프록시 페이지에 전체 정책 그룹이 표시되고 노드 전환 시 선택 상태가 즉시 갱신됨
- 작업 관리자에 작동 중인 verge-mihomo.exe가 하나만 있음
- 브라우저에서 테스트 사이트에 접속하면 연결 페이지에 해당 도메인, 규칙과 외부 경로가 나타남
- 클라이언트를 종료하면 Windows 시스템 프록시가 꺼지고 일반 네트워크가 복구됨