로그가 보이지 않으면 수집 설정부터 확인하기

구독 갱신이나 연결에 문제가 생겼을 때 로그는 오류가 발생한 시각과 앱이 반환한 정보를 남기는 데 도움이 됩니다. 다만 FlClash의 로그 수준과 로그 수집은 다른 설정입니다. 로그 수준 항목을 찾았거나 값을 바꿨다고 해서 로그 화면의 진입점까지 표시되는 것은 아닙니다.

대상은 유지보수가 이어지는 FlClash v0.8.99 정식 버전, Windows 11, amd64 / arm64, 영어 UI입니다. 이 버전에는 한국어 UI가 없으므로 실제 영어 항목 이름으로 설명합니다. 고정 버전 소스, 번역 사전, 상위 프로젝트의 테스트와 대조했으며 Windows 클라이언트를 직접 클릭해 검증한 절차는 아닙니다. Clash Verge Rev, Clash for Windows 또는 Android의 로그 경로를 그대로 적용하지 마세요.

FlClash가 정상적으로 열리고 설정에 들어갈 수 있어야 합니다. 시작하기 전에 앱이 충돌한다면 이 화면 절차를 사용할 수 없으며, 이 설명만으로 디스크에 저장된 충돌 로그의 위치를 판단할 수도 없습니다. 재설치, 패치 다운로드, YAML 변경은 필요하지 않습니다. 현재 구성, 프록시 모드, 로그 수준을 유지하고 수집 스위치부터 확인하세요.

Logcat을 켜고 Logs 화면으로 돌아가기

  1. 기본 창에서 Tools를 열고 Settings 구역의 General을 클릭합니다. Settings는 구역 제목이며, 먼저 들어가야 하는 별도의 페이지가 아닙니다.
  2. General 화면에서 Logs and diagnostics를 찾고 Logcat의 원래 상태를 기록합니다. 이미 켜져 있다면 그대로 두고, 꺼져 있을 때만 켜세요. 이 버전의 초기 기본값은 꺼짐이지만 기존 설정에서는 달라졌을 수 있습니다.
  3. 스위치는 즉시 반영되며 따로 저장 버튼을 누르지 않습니다. 로그 화면으로 자동 이동하지는 않으므로 기본 화면으로 돌아와 탐색 메뉴의 Logs를 엽니다. General 안에서 로그 본문을 계속 찾지 마세요.
  4. 현재 시각을 기록하고 원래 실패했던 동작을 한 번만 재현한 뒤, 로그 화면에서 그 시각 전후의 기록을 확인합니다. 구독 갱신 실패를 살펴본다면 갱신만 한 번 다시 시도하세요. 로그를 만들려고 구독 변경, 노드 전환, TUN 활성화를 한꺼번에 할 필요는 없습니다.

새 기록이 없다면 수집이 켜져 있는지, 해당 동작이 실제로 발생했는지, 코어가 정상적으로 실행 중인지 확인합니다. 검색 조건 때문에 기록이 가려지지 않았는지도 살펴보세요. 기록이 적은 것은 로그 수준 때문일 수도 있습니다. 기본값이 info라고 가정하지 마세요. 이 버전의 초기 설정은 error이며 기존 설정에서는 다를 수 있습니다. 이 글에서는 먼저 debug로 바꾸도록 요구하지 않습니다. 더 자세한 기록이 필요하면 해당 문제에 대한 유지관리자의 안내에 따라 별도로 조정하세요.

수집, 로그 수준, 검색은 무엇이 다른가요?

설정 또는 동작영향이것만으로 알 수 없는 것
로그 수집 Logcat로그 진입점을 표시하고 코어 로그 구독을 시작하거나 중지합니다끄는 것은 기존 기록 삭제가 아니며 모든 앱 내부 로그가 중지된다고 보장하지도 않습니다
로그 수준 Log level코어가 어떤 수준의 로그를 출력할지에 영향을 줍니다수준을 바꿔 기록이 줄었다고 문제가 해결된 것은 아닙니다
로그 화면 검색과 수준 태그 필터현재 목록에서 필요한 기록을 찾도록 돕습니다. 수준 태그를 클릭하면 필터 조건으로 추가할 수 있습니다필터로 걸러진 화면의 목록이 내보낼 파일의 범위는 아닙니다

로그 화면에는 코어 이벤트와 [APP] 표시가 붙은 앱 로그가 함께 나타날 수 있습니다. 시각, 수준, 구체적인 오류를 먼저 보고 당시 어떤 동작을 했는지 설명하세요. error 한 줄만으로 노드가 무효라고 판단하지 마세요. 이 글은 모든 오류의 뜻을 해석하는 문서가 아니며, 로그 화면도 완전한 과거 접속 기록은 아닙니다.

화면은 길이가 제한된 메모리 버퍼를 보여 줍니다. 오래된 기록은 밀려날 수 있고 앱 재시작이나 구성 다시 불러오기로 이번 기록이 남지 않을 수도 있습니다. 문제를 재현한 뒤 바로 저장하고, 먼저 재시작한 다음 직전 오류를 찾으려 하지 마세요. 위로 스크롤하면서 자동 따라가기를 멈추는 것은 목록의 스크롤과 표시 방식을 바꿀 뿐, 로그 수집을 중지하는 동작이 아닙니다.

저장한 파일을 확인한 뒤 공유하기

기록을 남기려면 로그 화면에서 툴팁이 Export logs인 내보내기 버튼을 사용합니다. Windows 저장 창에서 본인이 쓸 수 있는 로컬 폴더를 고르고 파일명을 확인한 뒤 저장하세요. 기본 이름 형식은 FlClash_YYYY-MM-DD.log입니다. 이는 형식 예시이며 실제 날짜는 내보낼 때의 시스템 시각으로 결정됩니다. 같은 날 다시 저장할 때는 다른 파일명을 사용해 보관해야 할 기존 기록을 덮어쓰지 않도록 하세요.

성공하면 앱에 Export successful이 표시됩니다. 이어서 실제로 저장된 파일을 텍스트 편집기로 열고 이번 재현 전후의 시각과 오류가 포함되어 있는지 확인하세요. 파일명만 보고 내용이 맞다고 판단하지 마세요. 저장 창을 취소한 것은 저장 성공이 아니며, 오류가 발생했다면 대상 파일이 완전하다고 가정해서도 안 됩니다.

검색은 민감한 정보를 제거하는 기능이 아닙니다.내보내기는 현재 로그 버퍼를 읽으며, 필터를 적용한 화면에 보이는 몇 줄만 저장하지 않습니다. 파일에는 접속 도메인, IP, 노드 이름, 구독 주소, Token, 로컬 경로 등이 들어 있을 수 있습니다. 확인하지 않은 전체 파일이나 스크린샷, 완전한 구독 링크를 공개 Issue, 단체 채팅방, 온라인 분석 사이트에 보내지 마세요.

로컬 사본에서 오류 전후의 필요한 부분만 남기고 인증 정보와 공개하고 싶지 않은 주소를 가리세요. 시각, 오류 유형과 상황을 이해하는 데 필요한 앞뒤 내용은 유지합니다. 텍스트 편집기에서 이 정리된 부분을 복사한 뒤 FlClash 버전, Windows 버전, 재현 동작을 함께 전달하세요. 여기서 말하는 복사는 일반 텍스트 편집기의 기능이며, FlClash 안에 별도의 ‘모두 복사’ 버튼이 있다는 뜻이 아닙니다.

확인이 끝나면 수집 설정을 원래대로 돌리기

Tools → Settings → General → Logs and diagnostics로 돌아가 Logcat을 작업 전 상태로 되돌립니다. 원래 꺼져 있었다면 끄고, 원래 켜져 있었으며 계속 관찰해야 한다면 그대로 둘 수 있습니다. 끄면 로그 진입점이 숨겨지고 코어 로그 구독이 중지됩니다. 기록을 비우는 버튼은 아니며, 디스크에 이미 저장한 .log 파일을 지워 주지도 않습니다.

[APP] 표시가 붙은 앱 내부 로그는 여전히 버퍼에 기록될 수 있습니다. 이 스위치를 ‘모든 로그를 완전히 금지하는 기능’으로 이해하지 마세요. 구성을 삭제하거나 앱 데이터를 비우거나 모든 설정을 초기화할 필요는 없습니다. 이미 공개된 인증 정보는 수집을 끄거나 로컬 파일을 삭제해도 회수할 수 없습니다. 구독 Token을 잘못 공유했다면 해당 서비스 제공자에게서 폐기하거나 재발급하세요.

최종적으로 필요한 것은 특정 동작과 연결되고, 내용을 확인해 민감한 정보를 가린 기록입니다. 무조건 많은 로그를 모으는 것이 목적은 아닙니다. 파일에서 이번 문제를 찾을 수 없다면 수집 상태, 시각, 실제로 설정된 로그 수준을 다시 확인하고 범위를 정해 한 번 더 재현하세요. 로그를 임의로 덧쓰거나 추측한 오류 원인으로 빈 부분을 채우지 마세요.

공식 자료와 버전 범위

버전 번호, 파일 이름, 화면 문구는 업데이트로 바뀔 수 있습니다. 작업 전에 연결된 공식 문서를 확인하세요.