Clash 시작 로그 확인: 창 종료와 코어 종료 구분하기

클라이언트를 실행한 뒤 창이 사라지면 먼저 시스템 트레이나 메뉴 막대에 아이콘이 남아 있는지 확인하세요. 창을 닫아도 백그라운드에서 계속 실행되는 클라이언트가 있는 반면, 창은 그대로지만 코어 하위 프로세스가 종료되어 연결 실패로 표시되는 경우도 있습니다. 문제를 확인할 때는 실행 버튼을 누른 시간을 기록하고 한 번만 다시 시도한 뒤, 같은 시간대의 화면 로그와 코어 로그, 시스템 기록을 대조하세요. 이렇게 하면 여러 번 실행했을 때 나온 서로 다른 오류를 혼동하지 않을 수 있습니다.

  • 창이 계속 열려 있는 경우: 클라이언트에 ‘로그’와 ‘코어 로그’ 메뉴가 따로 있다면 먼저 코어 로그에서 가장 먼저 발생한 오류를 확인하세요. 이어서 화면 로그에 실행한 코어 파일 경로와 실제로 불러온 설정 파일 경로가 기록되어 있는지 살펴보세요.
  • Windows에서 창이 순식간에 사라지는 경우: ‘이벤트 뷰어’ → ‘Windows 로그’ → ‘응용 프로그램’에서 실행 시각에 해당하는 오류를 찾으세요. ‘응용 프로그램 오류’ 기록이 있으면 오류가 발생한 응용 프로그램과 모듈 이름을 확인해 클라이언트 자체가 종료된 것인지 코어가 종료된 것인지 구분하세요. 일반적인 설정 로드 오류는 이곳에 기록되지 않을 수도 있습니다.
  • macOS에서 창이 순식간에 사라지는 경우: ‘응용 프로그램’ → ‘유틸리티’ → ‘콘솔’에서 해당 시각의 충돌 보고서를 찾으세요. 보고서가 없다면 클라이언트에 저장된 시작 로그를 확인하세요. 오류를 출력한 뒤 프로세스가 스스로 종료되는 경우에는 충돌 보고서가 생성되지 않을 수 있습니다.
로그 메시지다음 확인 항목
yaml: line 12실제로 불러온 YAML 파일을 열고 12행부터 위쪽으로 들여쓰기와 목록 구조를 확인하세요.
address already in use같은 로그에 나온 주소와 포트, 프로토콜을 기준으로 해당 포트를 사용하는 프로세스를 찾으세요.
no such file or directory누락된 파일이 코어인지, 설정 파일인지, 규칙 파일인지 먼저 확인하고 오류에 표시된 전체 경로를 점검하세요.
exec format error코어 파일 형식과 설치 패키지가 현재 운영체제 및 프로세서 아키텍처에 맞는지 확인하세요.

YAML 설정 오류: 오류가 난 줄보다 앞선 필드부터 확인하기

로그에 12행이라고 표시되어도 반드시 12행 자체가 잘못된 것은 아닙니다. 예를 들어 11행의 문자열 따옴표가 닫히지 않으면 파서가 다음 행까지 읽은 뒤 오류를 표시할 수 있습니다. 로그에 나온 경로의 파일을 열고, 줄 번호와 공백 문자를 표시하는 일반 텍스트 편집기로 확인하세요. 구독 설정 병합이나 덮어쓰기를 지원하는 클라이언트에서는 코어가 구독 원문이 아니라 생성된 설정 파일을 읽는 경우가 많습니다. 생성 파일에서 문제를 찾아 원인을 파악한 다음 로컬 덮어쓰기 설정이나 구독 원본을 수정하세요. 그래야 다음 업데이트 때 변경 사항이 덮어써지는 일을 막을 수 있습니다.

먼저 형식을 확인하고 참조 항목을 점검하세요

  1. 같은 수준의 필드는 들여쓰기를 맞추고, 탭 대신 공백을 사용하세요. mixed-port: 7890처럼 키와 값을 쓸 때는 영문 콜론 뒤에 공백 하나를 둡니다. 두세 줄 위에 닫히지 않은 따옴표가 있는지, 목록 항목 앞에 -가 빠졌는지도 확인하세요.
  2. 파일 첫 줄이 <!doctype html>이라면 다운로드한 파일이 로그인 페이지나 오류 페이지일 수 있습니다. 구독 제공처에서 주소와 출력 형식을 확인하세요. 웹페이지를 YAML로 수정하려고 하거나 액세스 토큰이 포함된 구독 주소를 공개 문제 해결 게시물에 올리지 마세요.
  3. 로그에 정책 그룹이나 규칙 세트가 없다고 표시되면 규칙 끝의 대상 이름이 proxy-groups에 정의된 이름과 일치하는지, RULE-SET 참조가 rule-providers의 키와 맞는지 확인하세요. YAML 문법이 유효해도 참조 항목까지 올바르다는 뜻은 아닙니다. mihomo에서 구버전 Clash 코어로 바꿨다면 해당 버전이 사용하는 필드와 규칙 유형을 지원하는지도 확인해야 합니다.

로컬 최소 설정으로 구독 및 덮어쓰기 설정 분리하기

클라이언트에서 설정을 내보내거나 클라이언트를 종료한 뒤 기존 설정을 백업하세요. 그런 다음 아래 내용을 test.yaml로 저장하되 현재 사용하는 구독 설정을 덮어쓰지 마세요. 이 예시는 로컬 컴퓨터에서만 혼합 프록시 포트를 열고, 규칙에 일치하는 트래픽은 모두 직접 연결합니다. 프록시 노드는 테스트하지 않습니다. 7890 포트가 이미 사용 중이라면 다음 절차에서 사용 가능한 포트를 확인한 뒤 실제 시작을 테스트하세요.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

같은 버전의 독립 실행형 mihomo 파일이 있다면 -t 옵션으로 설정을 검사할 수 있습니다. 아래 명령은 Windows PowerShell에서 실행하며, 현재 폴더에 mihomo.exe, test.yaml, 이번 테스트에 사용할 빈 폴더 clash-test-home가 있다고 가정합니다:

.\mihomo.exe -t -d .\clash-test-home -f .\test.yaml

여기서 -d는 코어 작업 디렉터리, -f는 설정 파일을 지정합니다. 검사에 통과해도 실제로 한 번 실행해야 포트가 정상적으로 열리고 클라이언트 시작 과정에 문제가 없는지 확인할 수 있습니다. 기존 설정을 테스트할 때 규칙 파일이나 다른 리소스가 작업 디렉터리에 필요하다면 빈 폴더에서 파일 누락 오류가 추가로 발생할 수 있습니다. 이런 오류를 YAML 문법 오류로 오해하지 마세요.

7890 포트 충돌: 주소와 프로토콜에 맞춰 프로세스 확인하기

mixed-port는 HTTP와 SOCKS 프록시가 함께 사용하는 수신 포트이고, external-controller는 제어 인터페이스 주소입니다. 실제 오류가 DNS 수신 주소에서 발생했을 수도 있습니다. 로그에 listen tcp 127.0.0.1:7890이라고 나오면 TCP 7890 포트를 확인하세요. 제어 인터페이스 127.0.0.1:9090 오류라면 혼합 포트만 변경해도 충돌이 해결되지 않습니다. 0.0.0.0:7890처럼 모든 인터페이스를 지정하는 주소도 확인하세요. 이미 루프백 주소의 수신 포트까지 점유하고 있을 수 있습니다.

Windows: 수신 기록을 찾은 뒤 PID 확인하기

netstat -ano -p tcp | findstr ":7890"

‘로컬 주소’ 열의 값이 정확히 :7890으로 끝나는지 확인하고 상태가 LISTENING인지 살펴보세요. 검색 결과에는 원격 포트만 7890인 연결도 포함될 수 있으므로 해당 행을 포트 점유 프로세스로 오인하면 안 됩니다. 마지막 열의 PID를 확인한 뒤 ‘작업 관리자’ → ‘세부 정보’에서 해당 프로세스를 찾으세요. 오류에 UDP라고 표시되면 netstat -ano -p udp로 해당 로컬 포트를 확인하세요. UDP 결과에는 TCP의 수신 상태 열이 없습니다.

macOS: TCP 수신 프로세스 바로 확인하기

lsof -nP -iTCP:7890 -sTCP:LISTEN

출력의 COMMAND 및 PID 열에서 프로세스를 확인하세요. UDP 포트라면 lsof -nP -iUDP:7890을 사용하고, 7890을 로그에 표시된 실제 포트 번호로 바꾸세요. 일반 사용자 계정으로는 모든 프로세스가 표시되지 않을 수 있습니다. 결과가 비어 있더라도 점유 프로세스가 이미 종료되었을 수 있으니 오류가 발생한 직후 다시 확인하는 것이 좋습니다.

코어 파일 누락: 경로, 설치 패키지, 시스템 아키텍처 확인하기

클라이언트 화면과 프록시 코어는 서로 다른 구성 요소입니다. 앱 아이콘이 있다고 해서 실행에 필요한 코어 파일도 남아 있다는 뜻은 아닙니다. 포터블 버전에서 압축 파일 안의 메인 프로그램만 꺼내거나 업그레이드 후에도 이전 폴더를 참조하면 화면에서 코어를 찾지 못할 수 있습니다. 로그에 하위 프로세스 시작 실패라고 나오면 오류 경로가 실행 파일을 가리키는지 먼저 확인하세요. 경로가 규칙 세트, 지리 데이터 또는 설정 파일을 가리킨다면 코어를 교체하지 말고 해당 리소스를 복구하거나 작업 디렉터리를 바로잡으세요.

  1. 파일 위치 확인 로그에 표시된 전체 경로에서 파일을 확인하세요. 포터블 패키지는 원래 폴더 구조를 유지한 채 로컬 폴더에 전체 압축을 풀어야 합니다. 설치 버전은 해당 클라이언트의 배포 패키지로 복구하고, 다른 클라이언트의 코어 파일을 임의로 이름만 바꿔 넣지 마세요.
  2. 운영체제와 아키텍처 확인 Windows에서는 ‘설정’ → ‘시스템’ → ‘시스템 정보’의 ‘시스템 종류’에서 x64와 ARM64를 구분하세요. macOS에서는 Apple 메뉴 → ‘이 Mac에 관하여’에서 Apple 칩과 Intel 프로세서를 확인할 수 있습니다. 배포 페이지에 arm64, x64, universal이라고 표시되어 있다면 프로젝트의 운영체제 및 아키텍처 안내에 맞춰 선택하세요.
  3. 시스템에서 차단했는지 확인 Windows에서는 ‘Windows 보안’ → ‘바이러스 및 위협 방지’ → ‘보호 기록’에서 해당 시각과 경로를 확인하세요. macOS에서는 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에서 관련 알림을 확인할 수 있습니다. 패키지 출처가 불분명하거나 시스템이 구체적인 위험을 알리면 실행을 중단하고 프로젝트의 신뢰할 수 있는 배포 경로에서 다시 받으세요. 문제를 확인한다는 이유로 전체 보안 기능을 끄지 마세요.
  4. TUN 시작 실패인지 확인 로그에 설정 로드와 로컬 프록시 수신 시작이 표시된 뒤 가상 인터페이스, 라우팅 또는 권한 오류가 발생한다면 코어 파일 누락이 아닙니다. 클라이언트를 열 수 있다면 TUN 옵션을 끄고 일반 수신을 시도하세요. 로컬 설정을 직접 수정한다면 테스트 사본에서 기존 tun 항목 안의 enable을 false로 바꾸고, 같은 이름의 항목을 새로 추가하지 마세요. 끈 뒤 실행된다면 해당 클라이언트의 안내에 따라 서비스나 권한 요구 사항을 따로 확인하세요.

최소 설정에서도 종료된다면 클라이언트 상태를 분리한 뒤 하나씩 복구하기

같은 버전의 독립 실행형 코어는 최소 설정으로 시작되는데 그래픽 클라이언트가 열자마자 종료된다면, 클라이언트 자체 상태를 확인하세요. 이전 설정 자동 복원, TUN 자동 활성화, 업그레이드 후 남은 코어 경로 등이 원인일 수 있습니다. 먼저 앱을 정상 종료하고 백그라운드에 남은 프로세스가 없는지 확인한 뒤 클라이언트 문서에서 데이터 폴더 위치를 찾으세요. 사용자 데이터를 새로 만들 수 있는 프로젝트라면 먼저 백업하고 기존 폴더의 이름을 임시로 바꿔 새 폴더를 생성하게 하세요. 기존 폴더를 바로 삭제하거나 새 데이터와 기존 데이터를 한꺼번에 섞지 마세요.

  1. 먼저 초기 상태로 화면을 열고 최소 설정만 불러오세요. 종료한 뒤 다시 실행해 이전 상태 복원 때문에 또 종료되지 않는지 확인하세요.
  2. 구독 설정을 복원하고 정상적으로 시작되는지 확인한 다음 덮어쓰기 설정과 규칙을 각각 복원하세요. 항목을 하나 추가할 때마다 다시 시작하고, 시스템 프록시나 TUN은 마지막에 복원하세요. 최소 직접 연결 설정만 시작된다고 해서 구독 노드까지 정상이라고 볼 수는 없습니다. 다만 원인 일부를 분리한 것입니다.
  3. 계속 시작되지 않는다면 운영체제 버전, 클라이언트 버전, 코어 버전, 최근 변경 사항과 첫 오류 전후의 로그 몇 줄을 기록하세요. 로그를 공유하기 전에 구독 주소, 토큰, 노드 인증 정보, 로컬 사용자 이름을 가리세요. 종료를 알리는 마지막 한 줄만으로는 원인을 파악하기 어렵습니다.