오류 화면부터 찍기보다 필요한 로그 종류 확인
실행, 구독 갱신, 연결에 문제가 생기면 로그를 보여 달라는 요청을 받곤 합니다. 그렇다고 구성 폴더 전체를 올리라는 뜻은 아닙니다. Clash Verge Rev 앱 로그와 Mihomo 코어 로그는 서로 다른 단계를 기록하므로 잘못 고른 파일에는 해당 오류가 없을 수 있습니다.
대상은 공식 Clash Verge Rev v2.5.2, Windows 10/11, x64 또는 ARM64이며 한국어 화면과 영어 메뉴명을 함께 사용합니다. Rev는 유지 관리 중인 프로젝트로, 개발이 중단된 Clash for Windows와 다릅니다. 설정 화면을 열 수 있다는 전제에서 기존 로그만 가져옵니다. 앱이 전혀 열리지 않거나 다른 버전·개발 빌드라면 이 글을 근거로 고정 폴더 위치를 추측하지 마세요.
사이드바의 로그 화면은 코어 메시지를 살펴보는 곳입니다. 필터, 일시 중지, 지우기는 앱 로그 내보내기 버튼이 아닙니다. 「진단 정보 내보내기」도 아래의 파일 복사 절차와 다른 기능입니다. 기존 로그 수준을 유지하고 남아 있는 기록부터 확인하세요. 파일을 찾기 위해 바로 Debug로 바꾸거나 과거 기록을 삭제할 필요는 없습니다.
Verge 고급 설정에서 실제 로그 폴더 열기
- 설정 페이지에서 「Verge 고급 설정」(
Verge Advanced Setting)을 찾습니다. - 「로그 디렉터리 열기」(
Open Logs Dir)를 눌러 현재 앱이 사용하는 폴더를 엽니다. logs디렉터리인지 확인하고 파일을 이동하거나 이름을 바꾸지 않은 채 살펴봅니다.- 오류가 발생한 현지 시각과 시간대를 기록합니다. 다른 계정이나 예전 설치의 로그를 섞지 마세요.
다른 사람의 절대 경로를 그대로 입력하기보다 앱의 메뉴로 여는 편이 정확합니다. Windows 계정이나 포터블 구성에 따라 데이터 위치가 달라질 수 있으며 항상 설치 실행 파일 옆에 있는 것은 아닙니다. 아래 경로는 모두 방금 연 로그 폴더 기준 상대 경로입니다. 드라이브 최상위에 새 폴더를 만들라는 뜻이 아닙니다.
파일명은 버전에 맞게 해석하세요: 공식 내보내기 문서에는 날짜와 가장 큰 순번으로 파일을 고르는 설명이 남아 있습니다. v2.5.2 소스는 현재 로그에 latest 이름을 사용하고 순환 저장된 파일도 보관합니다. 이전 이름 형식이 없다고 로그가 사라졌다고 판단하지 마세요.
latest.log와 service 로그는 무엇이 다른가요?
| 상대 경로 | 주요 대상 | 확인 사항 |
|---|---|---|
latest.log | Clash Verge Rev 앱 로그 | 앱 시작, 구성 처리, 앱 계층의 관련 오류 |
service/service_latest.log | 서비스 모드의 코어 로그 | 오류 시간대와 일치하는 코어 출력 |
sidecar/sidecar_latest.log | sidecar 방식 코어 로그 | 현재 기록 중인지, 관련 시각의 내용인지 |
폴더가 있다는 이유만으로 현재 실행 모드를 확정하면 안 됩니다. 이전에 모드를 바꿨다면 두 폴더가 모두 남을 수 있습니다. 오류 시각, 파일 수정 시각, 파일 안의 기록을 함께 비교하세요. 확실하지 않다면 그대로 설명하고 두 종류를 로컬 비교용으로 보관합니다. 로그를 만들기 위해 서비스나 TUN을 바꾸지 마세요.
latest는 현재 쓰는 파일이라는 뜻이지 전체 오류 과정을 보장하지는 않습니다. 순환 저장 조건에 도달하면 이전 기록은 인접한 오래된 파일에 있을 수 있습니다. 조금 전의 오류라면 같은 폴더의 해당 시간대 파일도 살피고 필요한 앞뒤 기록을 함께 복사하세요. 마지막 오류 한 줄만 고르지 않습니다.
시간을 적고 한 번 재현한 뒤 개인 폴더로 복사
먼저 진행 중인 작업을 저장합니다. 결제, 중복 제출 등 부작용이 없는 경우에만 같은 동작을 한 번 재현하고 시각, 수행한 작업, 예상 결과와 실제 결과를 적습니다. 안전하게 재현할 수 없다면 기존 기록을 사용하고 그 제한을 설명하세요. 로그를 얻기 위해 위험한 동작을 반복하지 않습니다.
- 관련 기록이 남은 뒤 해당 시간대를 포함하는 파일을 고릅니다.
- 컴퓨터의 공개 공유되지 않은 폴더로 복사하고 원본 위치는 그대로 둡니다.
- 신뢰할 수 있는 로컬 텍스트 편집기로 사본을 열어 시각, 내용, 오류 문맥을 확인합니다. 빈 파일이나 예전의 다른 오류가 아닌지 살핍니다.
- 공유용 사본을 따로 만들어 민감 값을 가리고, 수정하지 않은 사본은 자신의 확인용으로 보관합니다.
기록 중인 파일을 복사하면 복사 과정에서 읽은 내용까지만 담깁니다. 전체 세션의 스냅샷은 아닙니다. 필요한 이벤트가 아직 없다면 다시 복사해서 확인하고, 처음부터 시작한다며 원본을 지우지 마세요. 이 글에서는 기록 수준과 보관 개수를 바꾸지 않으므로 해당 설정을 되돌리는 과정도 필요하지 않습니다.
민감 값은 가리고 문제를 파악할 문맥은 유지
전체 구독 URL, Token, 비밀번호, UUID, 인증 헤더, Cookie, 노드 서버 주소, IP와 Windows 사용자 이름이 포함된 경로를 확인하세요. 모든 로그에 전부 나오는 것은 아니지만 발견한 값은 공개 전에 검토해야 합니다. 링크는 여러 줄이나 오류 메시지 안에서도 반복될 수 있어 스크린샷의 토큰 하나만 가리는 것으로는 부족합니다.
공유 사본에서 숨긴 값은 [REDACTED]로 표시하고 같은 노드는 NODE_A처럼 일관된 이름을 씁니다. 타임스탬프, 사건 순서, 오류 종류와 필요한 문맥은 남깁니다. 중요한 오류 줄 전체를 지우거나 편집본을 원본이라고 부르지 마세요. 마지막으로 민감 값을 다시 검색하고 파일명, 스크린샷, 붙여넣기 미리보기도 확인합니다.
로그가 자동으로 공개에 안전한 자료는 아닙니다:profiles 전체나 확인하지 않은 데이터 폴더를 올리지 말고, 출처가 불분명한 온라인 가림 도구에 원본을 보내지 마세요. 비밀번호나 인증 링크가 노출되었다면 제공업체 절차로 취소·재설정합니다. 게시물을 지워도 복사되지 않았다고 보장할 수는 없습니다.
공식 프로젝트에 보고할 때는 당시 양식을 확인하세요. 이번에 확인한 양식은 로그 파일 업로드가 아닌 내용 붙여넣기를 요구합니다. 관련 시간대의 가림 처리된 기록과 앱 버전, OS 버전, 시간대, 재현 단계를 준비하면 됩니다. 기존 로그가 유지 관리자가 요구하는 Debug 기록을 충족하지 못할 수도 있습니다. 추가 요구는 별도로 확인하고 전체 구성 파일을 대신 보내지 마세요.
공식 자료와 버전 범위
- Clash Verge Rev v2.5.2 공식 릴리스
- 공식 가이드: 문제 재현과 로그 복사
- v2.5.2 고급 설정의 로그 디렉터리 메뉴
- v2.5.2 앱·서비스·sidecar 로그 경로
- v2.5.2 현재 로그와 파일 순환 저장
- v2.5.2 로그 화면: 필터·일시 중지·지우기
- 공식 보고 양식: 버전·재현 단계·로그 붙여넣기
버전 번호, 파일 이름, 화면 문구는 업데이트로 바뀔 수 있습니다. 작업 전에 연결된 공식 문서를 확인하세요.