이 글의 목차
컴퓨터가 절전에서 깨어난 뒤 Clash Party의 노드 지연 시간은 정상이지만, TUN이 켜진 상태에서 인터넷에 연결되지 않을 수 있습니다. TUN 설정을 바꿨는데 연결은 여전히 이전 설정대로 동작하기도 합니다. 먼저 앱 버전과 문제가 생긴 과정을 확인한 다음 코어가 설정을 다시 불러오도록 처리하세요. 두 상황을 모두 노드 고장으로 판단하지 마세요.
절전 후 인터넷이 끊겼는데 노드 지연 시간은 왜 정상일까요?
Clash Party v2.0.4 정식 릴리스 노트는 두 가지 문제의 수정을 명시합니다. 절전 복귀 시 TUN을 다시 만들면서 설정 일부가 빠지는 문제와, TUN 설정을 저장한 뒤 코어가 재시작되지 않는 문제입니다. 이 글은 이 두 상황을 다룹니다. 업데이트가 모든 플랫폼의 모든 TUN 연결 문제를 해결한다는 뜻은 아닙니다.
프로젝트 이슈 #2235에서 macOS용 v2.0.3 사용자는 화면에서 TUN을 켠 뒤 실행 중인 코어의 stack, dns-hijack, auto-route 값이 예상과 달랐지만 work/config.yaml에는 설정이 온전히 남아 있었다고 보고했습니다. 이 보고는 증상을 구별하는 데 쓰며, 모든 사용자에게 같은 필드가 빠진다는 뜻은 아닙니다.
어느 단계에서 문제가 생겼는지 먼저 구별하세요
| 증상 | 먼저 확인할 항목 |
|---|---|
| 절전 전에는 정상이었지만 복귀 후 TUN이 트래픽을 전달하지 못함 | 절전에서 깨어난 시간을 기록하고, 현재 실행 중인 앱에 해당 수정이 포함되어 있는지 확인하세요. |
| 가상 네트워크 어댑터 화면에서 설정을 저장해도 연결 동작이 바뀌지 않음 | 설정이 저장되었는지, 코어 재시작이 끝났는지 확인하세요. 구독을 반복해서 수정하지 마세요. |
| TUN을 꺼도 직접 연결이 안 되거나 노드 자체에 연결할 수 없음 | 현재 네트워크와 노드, 실제 오류부터 살펴보세요. 이번 TUN 수정만으로 설명할 수 있는 상황이 아닙니다. |
전체 설정을 다시 불러오는 것과 TUN만 껐다 켜는 것은 어떻게 다를까요?
v2.0.4 태그의 소스 코드에서는 절전 복귀 후 코어가 응답하고 TUN이 켜져 있어야 하는데 어댑터가 사라진 경우, 먼저 TUN을 끈 다음 전체 설정을 생성해 코어에 적용합니다. 이전 버전은 이 분기에서 스위치를 다시 켜기만 했으므로, 어댑터를 다시 만들 때 일부 설정이 빠질 수 있었습니다.
새 버전은 가상 네트워크 어댑터 화면에서 설정을 저장할 때 현재 enable 상태를 유지하고, 값을 저장한 뒤 restartCore를 호출합니다. 실행 중인 코어에 설정만 다시 적용하는 것과는 다릅니다. 저장 후 연결이 잠시 끊길 수 있으므로 중요한 파일을 전송하는 도중에는 시험하지 마세요.
화면에 표시된 값, 디스크에 생성된 설정 파일, 실제 실행 중인 코어는 각각 따로 확인해야 합니다. 파일에 tun 블록이 온전히 있어도 코어에 적용되었다는 증거는 아닙니다. 코어 로그와 실제 요청을 확인해 설정 불러오기와 재시작이 끝났는지 검증해야 합니다.
복원할 수 있는 사본을 만든 뒤 앱을 업데이트하세요
업데이트 전후에 다음 순서로 확인하세요
현재 설정을 로컬 백업으로 내보내기
‘앱 설정 → 백업 및 복원’에서 ‘백업 내보내기’를 선택하세요. 파일을 별도 위치에 저장하고 읽을 수 있는지 확인합니다. 구독, 오버라이드, 현재 TUN 설정도 따로 기록하되 민감한 내용은 공개하지 마세요.
현재 앱 버전과 코어 버전 확인하기
Clash Party 앱 버전과 현재 실행 중인 Mihomo 버전을 각각 기록하세요. v2.0.4는 앱의 릴리스 버전입니다. 코어만 교체해서는 앱에서 처리하는 절전 복귀와 설정 저장 로직의 수정이 적용된다고 보장할 수 없습니다.
프로젝트의 v2.0.4 정식 릴리스 사용하기
프로젝트 Release에서 운영체제와 CPU 아키텍처에 맞는 버전을 선택하세요. 백업과 사용 가능한 설정을 보관하고, 이전 앱을 완전히 종료한 뒤 플랫폼별 설치 절차에 따라 업데이트합니다. 데이터 초기화, 구독 변경, DNS 전체 수정을 한꺼번에 하지 마세요.
실행한 버전과 설정 다시 확인하기
실제로 열린 앱이 다른 위치에 남아 있는 이전 사본이 아니라 v2.0.4인지 확인하세요. 선택한 프로필, 노드, 프록시 모드와 기존 TUN 설정도 다시 확인합니다.
보고에 나온 어댑터 이름, stack, MTU, DNS 주소를 그대로 복사하지 마세요. 보고자의 환경에 맞춘 값이며 이번 수정에서 요구하는 새 기본값이 아닙니다. 이전에 정상 동작하던 설정을 유지하고, 예상과 다른 것으로 확인된 항목만 바로잡으세요.
TUN 설정을 저장한 뒤 코어 재시작을 확인하세요
앱의 ‘가상 네트워크 어댑터’ 화면을 열고 기록해 둔 어댑터 이름, 프로토콜 스택, 자동 라우팅, DNS 하이재킹, 제외 주소를 대조하세요. 메뉴 언어와 플랫폼에 따라 표시가 다를 수 있으므로 현재 앱 화면을 기준으로 확인합니다. 다른 클라이언트의 메뉴 경로를 그대로 적용하지 마세요.
설정을 고쳐야 한다면 확인된 항목만 수정한 뒤 ‘저장’을 누르세요. v2.0.4는 현재 TUN 켜짐 상태를 저장하고 코어를 재시작합니다. 완료될 때까지 기다렸다가 새 요청을 보내세요. 업데이트 실패가 표시되면 오류를 기록하고 현재 설정을 보관합니다. 버튼을 연속으로 누르거나 스위치를 반복해서 껐다 켜지 마세요.
고칠 설정이 없다면 저장 버튼을 표시하려고 MTU나 프로토콜 스택을 임의로 바꿀 필요는 없습니다. 먼저 중단되면 안 되는 요청을 멈추고 앱을 완전히 종료했다가 다시 여세요. 그런 다음 TUN 상태와 실제 요청을 다시 확인합니다.
PATCH /configs를 직접 호출하는 방식을 일반적인 복구 방법으로 사용하지 마세요. 앱이 스위치 상태와 설정을 계속 관리하므로 일부 값만 쓰면 앱의 상태와 충돌할 수 있습니다. 이 글에서는 앱 안에서 저장하고 재시작하는 방법을 사용합니다. 제어 포트를 열거나 임시로 생성된 설정 파일을 편집할 필요는 없습니다.
절전에 들어갔다 깨어나며 복구 결과를 확인하세요
현재 네트워크와 노드에서 접근 권한이 있는 일반 웹페이지나 요청을 먼저 시험하고 결과를 기록하세요. 그런 다음 평소처럼 절전 모드에 들어갔다가 깨운 뒤 네트워크가 복구되면 같은 대상으로 새 요청을 보냅니다. 절전 전부터 유지되던 연결이나 지연 시간 숫자만 보고 판단하지 마세요.
이번 복구의 확인 목록
- 앱 버전이 v2.0.4이며, 선택한 프로필과 노드, 원래 TUN 설정을 기록해 두어 복원할 수 있습니다.
- 저장한 값이 화면에 올바르게 남아 있고 코어 재시작이 끝났으며, 업데이트 실패나 TUN 시작 오류가 계속 발생하지 않습니다.
- 절전 복귀 후 같은 도메인의 이름을 해석할 수 있고 같은 웹페이지나 앱 요청이 완료되며, 연결 기록에 예상한 규칙과 경로가 표시됩니다.
- 앱을 완전히 종료했다가 다시 연 뒤 현재 TUN 상태와 실제 요청을 다시 확인합니다. 스위치 색깔만으로 트래픽이 정상 전달된다고 판단하지 않습니다.
- 시험한 네트워크, 시간, 재현 단계와 결과를 남깁니다. 한 번의 성공은 이번 환경에 대한 결과이며 모든 네트워크 조건을 검증했다는 뜻은 아닙니다.
계속 실패한다면 연결과 설정을 어떻게 보존할까요?
업데이트하거나 저장한 뒤에도 인터넷이 끊긴다면 먼저 앱에서 TUN을 끄고 시스템의 직접 연결이 복구되는지 확인하세요. 이전에 정상 동작을 확인한 시스템 프록시 설정이 있을 때만 임시 대안으로 사용합니다. 시스템 프록시가 처리하는 트래픽 범위는 다르므로, 이것이 동작한다고 TUN이 복구된 것은 아닙니다.
이번에 추가로 변경한 내용을 취소하고, 기록해 둔 원래 값과 사용 가능한 구독으로 되돌리세요. 백업을 가져와야 한다면 먼저 현재 상태를 별도 사본으로 보관합니다. 앱의 ‘백업 가져오기’는 현재 설정을 덮어쓰므로 파일과 버전이 적합한지 확인해야 합니다. 유일한 사본을 반복해서 덮어쓰지 마세요.
이전 버전으로 돌아가야 한다면 새 버전의 데이터 사본을 보관하고 업데이트 전에 따로 만든 백업을 사용하세요. 이 글에서는 버전 간 데이터 호환성을 검증하지 않았습니다. 이전 앱이 유일한 데이터 폴더를 바로 덮어쓰게 하지 마세요. 이전 버전에도 이번 수정이 들어 있다고 보장하지 않습니다.
문제를 보고할 때는 앱과 코어 버전, 운영체제, 절전 복귀 또는 설정 저장으로 문제가 생기는 최소 단계, 관련 TUN 블록과 오류 로그를 제공하세요. 구독 Token, 노드 비밀번호, 컨트롤러 secret은 제거합니다. 민감한 정보가 담긴 전체 설정은 업로드하지 마세요.
이 글은 정식 릴리스 기록과 v2.0.4 태그의 소스 코드를 대조해 작성했으며, 모든 플랫폼의 실제 기기에서 재현한 결과는 아닙니다. 다른 권한, 라우팅, DNS 문제는 실제 로그를 바탕으로 확인해야 합니다. 이후 변경 사항은 프로젝트의 새 버전과 유지관리자의 결론을 기준으로 판단하세요.