macOS 문제 해결 가이드

Clash 문제 진단

요청이 어느 단계에서 멈췄는지 확인한 뒤 해당 설정을 조정하세요.

처음 설치한다면 설정 가이드부터 시작해 구독 가져오기, 모드 선택, 연결, 결과 확인 순서로 진행하세요. 이 페이지는 이미 발생한 문제를 해결하기 위한 안내입니다. 문제를 해결한 뒤에는 가이드의 확인 단계로 돌아가 평소 사용하는 앱에서 다시 테스트하세요.

인터넷에 연결되지 않을 때: 먼저 직접 연결 복구하기

프록시가 개입하지 않는 상태로 되돌리기

Clash 앱에서 시스템 프록시와 TUN을 끈 다음, 「시스템 설정 → 네트워크」에서 현재 연결된 네트워크 서비스를 확인하세요. Wi-Fi 아이콘에 연결됨으로 표시되어도 기기가 액세스 포인트에 연결됐다는 뜻일 뿐, 외부 인터넷을 사용할 수 있다는 의미는 아닙니다. 도킹 스테이션의 이더넷도 함께 연결돼 있다면 요청이 Wi-Fi를 거친다고 단정하지 마세요. 이더넷 케이블을 잠시 뽑거나 Wi-Fi를 잠시 끄고 두 연결을 각각 테스트하세요.

브라우저에서 평소 직접 접속할 수 있는 공개 웹사이트와 별도의 사이트를 하나 더 열어 보세요. 호텔이나 게스트 네트워크는 로그인 페이지에서 인증해야 할 수 있습니다. 먼저 네트워크에 로그인한 뒤 프록시를 다시 켜세요. 같은 네트워크의 다른 기기에서도 두 사이트에 접속할 수 없다면 네트워크 연결부터 점검하세요. 이 Mac에서만 실패한다면 현재 네트워크 서비스의 주소, 라우터, DNS가 해당 네트워크의 요구사항에 맞게 설정돼 있는지 확인하세요.

시스템 프록시와 로컬 포트를 따로 테스트하기

직접 연결이 정상이라면 Clash 앱을 열고 프록시 개입 스위치 두 개는 일단 끈 상태로 두세요. 활성 설정이 로드됐는지 확인하고 설정에서 HTTP 또는 혼합 포트를 확인한 뒤, 명령어로 로컬 프록시에 직접 연결하세요. 아래 예시는 포트와 공개 테스트 도메인을 사용합니다. 포트가 다르면 현재 값으로 바꾸세요. 첫 번째 명령은 앱 수준 프록시를 우회하고, 두 번째 명령은 프록시를 명시적으로 지정합니다. TUN이 켜져 있다면 첫 번째 명령을 순수 직접 연결의 기준으로 삼을 수 없습니다.

curl --noproxy '*' --max-time 12 -I https://example.com/
curl --noproxy '' --proxy http://127.0.0.1:7897 --max-time 12 -I https://example.com/

두 번째 명령에서 로컬 포트에 연결할 수 없다고 나오면 먼저 코어 프로세스가 실행 중인지, 포트를 잘못 입력하지 않았는지, 앱이 SOCKS 전용 포트를 제공하도록 설정돼 있지는 않은지 확인하세요. 프록시 연결은 됐지만 이후 시간 초과가 발생한다면 포트를 서둘러 변경하지 마세요. 「연결」 또는 「로그」에서 요청 시각을 기준으로 대상을 찾아 매칭된 규칙, 아웃바운드 정책, 다음 오류를 확인하세요. 요청이 코어에 도달했다면 문제 범위는 코어 또는 그 이후의 경로로 좁혀집니다.

문제 범위에 따라 다음 항목 선택하기

테스트 결과우선 확인변경하지 말 것
프록시 개입을 꺼도 실패네트워크 로그인, 라우터, 기존 네트워크 설정노드와 정책 그룹
직접 연결 성공, 프록시 지정 연결 실패수신 포트, 코어 로그, 아웃바운드 정책브라우저 확장 프로그램
프록시 지정 연결 성공, 앱에서 실패시스템 프록시, 앱 프록시 설정, 우회 목록구독과 노드
TUN을 켠 경우에만 실패권한, 라우팅, 다른 네트워크 제어 도구앱 설치 파일

규칙 모드에서만 실패한다면 실제로 어떤 규칙이 적용됐는지 확인하세요. 정책 그룹 이름이 실제 아웃바운드 결과를 뜻하지는 않습니다. 특정 지역 이름의 그룹이라도 사용할 수 없는 노드가 선택됐거나 직접 연결이 포함될 수 있습니다. 공개 테스트 대상 하나만 정해 잠시 정책을 바꿔 비교하세요. 테스트가 끝나면 규칙 모드로 되돌리세요. 전역 모드를 장기 해결책으로 사용하면 원래 직접 연결해야 하는 서비스까지 영향을 받을 수 있습니다.

프록시 개입을 껐을 때는 정상인데 TUN을 켠 뒤 로컬 네트워크 리소스에도 접근할 수 없다면, Finder에서 로컬 공유에 다시 연결하는 등 기존 방식으로 같은 리소스를 테스트하세요. 회사 네트워크 도구가 라우팅을 관리하는지, 로컬 서브넷이 겹치는지 확인하세요. 업무가 정상적으로 돌아가는 설정으로 되돌리세요. 한 번의 테스트를 통과시키려고 회사 기기의 네트워크 정책을 임의로 변경하지 마세요.

항목별로 다시 켜고 재테스트하기

먼저 문제 발생 전에 실제로 사용하던 연결 방식 하나만 켜세요. 공개 웹사이트, 원래 문제가 발생한 앱, 평소 직접 연결해야 하는 리소스를 각각 다시 테스트하세요. 시스템 프록시를 켠 뒤 공개 웹사이트는 정상인데 명령줄만 작동하지 않는다면 시스템 프록시 항목으로 이동하세요. 여러 사이트에서 서버를 찾을 수 없다고 나오지만 앱은 이미 알고 있는 로컬 주소에 접속할 수 있다면 DNS 항목을 확인하세요. 노드와 DNS 설정을 동시에 바꾸지 마세요.

앱을 종료한 뒤 인터넷이 끊긴다면 현재 네트워크 서비스의 프록시 설정으로 돌아가 로컬 포트를 계속 가리키고 있는지 확인하세요. 이번 테스트로 남은 프록시 항목만 되돌리고 기존 자동 설정과 관리 설정은 유지하세요. 같은 문제가 반복되면 정상 종료와 강제 종료를 구분해 기록하세요. 강제 종료 후에만 프록시 항목이 남는다면 비정상 종료부터 해결한 다음, 정상 종료 시 네트워크가 복구되는지 확인하세요.

노드 시간 초과: 탐색 테스트와 실제 요청 구분하기

테스트 대상과 시각을 고정하기

지연 시간 테스트는 지정된 탐색 주소에 따라 결과가 달라집니다. 시간 초과는 이번 탐색이 제한 시간 안에 끝나지 않았다는 뜻이지, 모든 웹사이트를 사용할 수 없다는 의미는 아닙니다. 테스트 시각, 사용 중인 네트워크, 정책 그룹, 실제 선택된 노드를 기록하세요. 같은 탐색 주소를 유지한 채 비교 가능한 노드 두 개를 직접 테스트하고, 같은 공개 웹사이트에 실제 요청도 보내 보세요. 이렇게 하면 특정 노드 문제인지, 탐색 주소 문제인지, 모든 아웃바운드 연결의 문제인지 구분할 수 있습니다.

실제 접속은 정상이고 탐색 테스트만 시간 초과된다면 정책 그룹의 탐색 주소에 접속할 수 있는지, 특정 상태 코드를 요구하는지, 리디렉션이 발생하는지 확인하세요. 시간 제한을 크게 늘리기보다 탐색 대상과 판정 방식을 먼저 조정하세요. 임계값이 너무 길면 장애 전환이 늦어지고, 너무 짧으면 일시적인 네트워크 불안정을 장애로 오인할 수 있습니다. 측정값이 가끔 높게 나온다는 이유만으로 전체 설정을 바꿀 필요는 없습니다.

로그를 따라 멈춘 단계 찾기

오류가 난 시각부터 로그를 몇 줄 거슬러 올라가 확인하세요. 노드 호스트 이름을 해석할 수 없다는 메시지가 나오면 웹사이트 도메인의 규칙이 아니라 노드 주소의 이름 해석을 점검해야 합니다. 주소 해석은 성공했지만 원격 주소 연결이 시간 초과된다면 기기에서 원격 서버까지의 전송 경로에 문제가 있을 가능성이 큽니다. 연결된 뒤 핸드셰이크에서 오류가 발생하면 구독 설정의 만료 여부, 클라이언트 코어의 프로토콜 필드 지원 여부, 시스템 날짜와 시간대를 확인하세요.

인증서 관련 오류는 인증서 검증을 무시하는 것으로 해결할 수 없습니다. 기기 시계를 확인하고, 설정 제공자가 확인해 준 매개변수를 사용하거나 기존 설정을 보관한 채 구독을 업데이트하세요. 로그에 특정 필드가 지원되지 않는다고 명시돼 있다면 현재 클라이언트의 호환성 안내를 먼저 확인하세요. 실행될 때까지 필드를 하나씩 지우지 마세요. 구문 검사를 통과했다는 것은 구조를 읽을 수 있다는 뜻일 뿐, 원격 서버가 연결을 허용한다는 뜻은 아닙니다.

단일 노드, 같은 그룹의 노드, 다른 네트워크 비교하기

노드 하나만 시간 초과된다면 같은 그룹의 다른 항목을 직접 선택하고, 진행 중이지 않은 새 요청을 보내세요. 그룹 전체가 실패하지만 같은 설정의 다른 그룹은 정상이라면 실패한 그룹이 같은 탐색 주소, 상위 연결 지점, 아웃바운드 의존성을 공유하는지 확인하세요. 자동 선택 그룹에 표시된 값이 아직 갱신되지 않았거나 이전 탐색 결과가 남아 있을 수 있습니다. 실제 연결 기록의 아웃바운드를 기준으로 판단하세요.

현재 Wi-Fi에서 모든 노드가 시간 초과되고 기본 직접 연결은 정상임을 확인했다면, 허용되는 경우 휴대폰 핫스팟으로 다시 테스트하세요. 노드, 모드, 대상은 그대로 유지하세요. 핫스팟에서 정상이라고 해서 라우터, 주소 체계, 원격 서버 제한 중 무엇이 원인인지 바로 단정할 수는 없습니다. 원래 네트워크에서 다른 기기로 같은 테스트를 해 네트워크를 따라 발생하는 문제인지 이 Mac에서만 발생하는 문제인지 확인하세요.

두 네트워크에서 모두 실패하고 이전에 작동했던 설정이 있다면 같은 기기에서 이전 설정으로 전환해 비교하세요. 이전 설정도 만료됐다면 클라이언트 문제의 증거로 사용할 수 없습니다. 여러 설정에서 오류가 난다면 모두 같은 단계에서 멈추는지 기록하세요. 예를 들어 같은 시간 초과라도 로컬 연결 거부와 원격 연결 시간 초과는 발생 위치가 완전히 다릅니다.

자동 전환으로 인한 오판 줄이기

진행 중인 영상 재생, 다운로드, 장시간 연결은 그룹 내 선택을 바꿔도 즉시 다른 노드로 전환되지 않을 수 있습니다. 노드를 바꾼 뒤 기존 테스트 연결을 닫고 같은 앱에서 새 요청을 보내세요. 그래야 이전 연결의 실패를 새 노드 문제로 오인하지 않습니다. 클라이언트에서 규칙별 연결을 확인할 수 있다면 대상 주소나 요청 시각으로 현재 연결을 찾아 아웃바운드가 실제로 바뀌었는지 확인하세요. 그룹 목록의 선택 표시만 보지 마세요.

사용 가능한 노드를 직접 선택했을 때는 정상인데 자동 그룹이 나중에 실패한 노드로 다시 전환한다면, 일단 수동 그룹으로 연결을 유지하세요. 이후 자동 그룹의 탐색 대상, 간격, 구성원을 확인하고 자동 선택으로 되돌리세요. 재현 조건을 기록할 때는 오류 단계와 비식별 처리한 그룹 이름만 남기면 됩니다. 구독 주소나 노드 인증 정보를 피드백에 함께 복사하지 마세요.

구독 오류: 다운로드, 파싱, 활성화를 나눠 확인하기

현재 작동하는 설정부터 보존하기

업데이트 실패가 현재 활성 설정까지 사용할 수 없게 됐다는 뜻은 아닙니다. 먼저 클라이언트에 마지막 업데이트 성공 시각이 표시되는지, 현재 요청은 계속 작동하는지 확인하세요. 활성 설정을 삭제하거나 모든 구독을 지우지 마세요. 클라이언트에서 내보내기를 지원한다면 사용 가능한 설정을 로컬의 안전한 위치에 백업하세요. 비공개 연결 정보가 포함될 수 있으므로 일반 로그처럼 다른 사람에게 전달하면 안 됩니다.

오류가 업데이트 버튼을 누른 뒤, 콘텐츠 파싱 중, 활성 설정으로 전환한 뒤 중 언제 발생했는지 기록하세요. 첫 번째 단계에서는 콘텐츠를 가져올 수 있는지 확인하고, 두 번째 단계에서는 콘텐츠 형식과 구조를 점검합니다. 세 번째 단계에서야 정책 참조와 코어 실행을 확인합니다. 화면에 ‘가져오기 실패’만 표시되면 로그를 열어 같은 시각에 발생한 가장 이른 구체적인 오류를 찾으세요. 마지막의 포괄적인 메시지만 확인하지 마세요.

응답 상태와 업데이트 경로 확인하기

제공 업체의 관리 페이지에서 해당 클라이언트용 구독 주소를 다시 복사하세요. 붙여넣을 때 앞뒤 공백이나 줄바꿈이 있는지 확인하고 쿼리 매개변수를 임의로 삭제하거나 변경하지 마세요. 인증되지 않음 또는 접근 금지로 표시되면 구독 만료 여부, 초기화 여부, 제공 업체의 구독 유형 제한을 확인하세요. 요청이 너무 잦다는 메시지가 나오면 연속으로 새로고침하지 말고 제한이 풀린 뒤 다시 시도하세요. 업데이트 버튼을 계속 누르면 원래 오류를 파악하기 더 어려워집니다.

호스트 이름을 해석할 수 없거나 연결이 시간 초과된다면 업데이트 요청이 어떤 네트워크 경로를 사용하는지 확인하세요. 웹페이지가 열린다는 것은 브라우저가 접속할 수 있다는 뜻일 뿐입니다. 클라이언트의 백그라운드 다운로드는 다른 프록시 방식을 사용할 수 있습니다. 구독 업데이트에 사용할 프록시 옵션이 있는지 확인하고, 직접 업데이트와 정상 작동이 확인된 프록시를 통한 업데이트 결과를 비교하세요. 현재 사용할 수 없는 설정에 연결이 의존한다면 다른 정상 설정이나 허용된 네트워크를 통해 업데이트 경로를 마련하세요.

성공 상태 코드가 반환돼도 예상한 설정 대신 로그인 페이지, 접근 안내 페이지, 제공 업체의 오류 설명이 내려올 수 있습니다. 확인을 위해 구독 링크를 온라인 파서에 입력하지 마세요. 클라이언트의 오류 상세 정보나 제공 업체의 지원 안내로 응답 유형을 확인하고, 필요하다면 콘텐츠를 로컬에서만 확인하세요. 인증서 오류가 발생하면 시계와 접속 주소를 확인하거나 제공 업체에 문의하세요. 인증서 검증을 끄지 마세요.

오류 메시지로 형식, 들여쓰기, 참조 점검하기

같은 제공 업체의 링크라도 전체 설정, 노드 모음, 다른 클라이언트 형식으로 제공될 수 있습니다. 전체 설정은 보통 독립 설정으로 활성화할 수 있지만, 노드 모음이나 규칙 목록은 기존 설정에서 참조해야 할 수 있습니다. 가져올 때 최상위 항목이 없다고 나오면 먼저 어떤 유형의 콘텐츠를 받은 것인지 확인하세요. 한 번 가져오려고 노드만 들어 있는 데이터를 기존 규칙 끝에 억지로 붙이지 마세요.

오류에 행 번호가 표시되면 해당 행과 바로 위아래 행도 함께 확인하세요. 목록 항목의 들여쓰기가 맞지 않거나, 복사 과정에서 탭 문자가 들어갔거나, 문자열이 닫히지 않았거나, 콜론 뒤의 내용이 예상과 다르게 해석되는 것이 흔한 원인입니다. 사용자 지정 오버라이드를 사용한다면 테스트 사본에서 먼저 비활성화하세요. 원본 구독은 불러올 수 있지만 병합한 뒤 오류가 난다면 오버라이드를 수정하세요. 정상적인 구독까지 교체하지 마세요.

구문 검사는 통과했지만 코어에서 정책 그룹이 없다고 나오면 현재 설정의 참조 이름과 규칙의 이름이 공백과 문장부호까지 완전히 일치하는지 확인하세요. 구독 업데이트로 그룹 이름이 바뀌었지만 로컬 오버라이드는 이전 이름을 참조하고 있을 수 있습니다. 설정 사본에서 참조 하나를 수정한 뒤 다시 불러오세요. 알 수 없는 정책을 모두 직접 연결로 바꾸지 마세요. 구문 검사는 통과해도 실제 트래픽 분배가 달라집니다.

새 설정을 활성화한 뒤 범위를 좁혀 테스트하기

새 설정을 가져오는 데 성공하면 직접 활성 설정으로 선택하고 정책 그룹이 모두 있는지 확인하세요. 원래 서로 다른 정책을 사용하는 공개 테스트 대상 두 개로 먼저 확인하세요. 활성화한 뒤 인터넷이 끊기면 사용 가능한 설정으로 즉시 되돌리고 오류 단계와 관련 로그를 저장하세요. 자동 업데이트 시각은 업무가 중요한 시간을 피해 설정하세요. 먼저 수동 업데이트가 끝까지 정상 작동하는지 확인한 뒤 예약 작업을 사용하세요. 오류 사례는 구독 링크 만료 및 파싱 실패 점검 목록에서 확인할 수 있습니다.

속도 저하: 대기 시간과 전송 속도 구분하기

페이지를 열기 전과 전송 중, 어디서 느린지 확인하기

웹페이지가 오래 흰 화면으로 남는 현상, 열린 뒤 콘텐츠가 차례로 로드되는 현상, 다운로드가 처음부터 끝까지 느린 현상은 각각 다릅니다. 첫 번째는 도메인 해석, 연결, 핸드셰이크를 확인하세요. 두 번째는 기본 페이지와 이미지·스크립트 같은 부가 리소스 중 무엇이 멈췄는지 확인해야 합니다. 세 번째는 페이지가 열리는 시간이 아니라 지속적인 전송 속도를 점검해야 합니다. 테스트를 시작하기 전에 대용량 파일 동기화와 시스템 다운로드를 일시 중지하세요. 매번 테스트할 때 백그라운드 작업이 다른 대역폭을 사용하면 결과가 달라질 수 있습니다.

공개된 안정적인 테스트 대상을 하나 정하고 같은 기기와 네트워크에서 직접 연결을 먼저 측정한 뒤 같은 정책 그룹의 다른 노드를 통해 측정하세요. 한 번에 변수 하나만 바꾸고 두 경로를 번갈아 테스트해 일시적인 네트워크 변동의 영향을 줄이세요. 다운로드 비교에는 같은 출처의 같은 파일을 사용하고 서로 다른 사이트의 속도를 비교하지 마세요. 웹페이지 로딩은 캐시 적중으로 인한 오차를 피해야 합니다.

HTTP 요청 하나의 구간별 시간 확인하기

curl --noproxy '*' --max-time 20 --silent --show-error \
  --output /dev/null \
  --write-out 'dns=%{time_namelookup}\nconnect=%{time_connect}\ntls=%{time_appconnect}\nfirst=%{time_starttransfer}\ntotal=%{time_total}\n' \
  https://example.com/

아래 값은 초 단위이며 요청 시작부터 누적됩니다. 직접 연결 요청에서는 연결 완료 시간에서 이름 해석 시간을 빼면 연결 수립에 걸린 시간을 확인할 수 있습니다. 핸드셰이크 완료 시간에서 연결 완료 시간을 빼면 핸드셰이크 단계를 확인할 수 있습니다. 이 명령은 응답 본문을 버리므로 짧은 요청의 대기 시간을 비교하는 데 적합하지만 대역폭 측정 도구는 아닙니다. 실제 직접 연결을 측정하려면 먼저 TUN을 끄세요. 프록시 우회 옵션만으로는 가상 네트워크 인터페이스를 우회할 수 없습니다.

HTTP 프록시를 명시적으로 지정해 비교하려면 첫 번째 줄의 우회 옵션을 --noproxy '' --proxy http://127.0.0.1:7897로 바꾸세요. 포트는 클라이언트 설정에 맞춰야 합니다. 이때 연결 시간은 주로 로컬 프록시에 연결하는 데 걸린 시간일 수 있으며, 이름 해석 시간도 원격 도메인 해석에 걸린 시간과 같지 않을 수 있습니다. 전체 요청의 첫 바이트까지 걸린 시간을 비교하고 로그를 함께 확인해 프록시 연결과 상위 응답 중 어느 단계가 느린지 파악하세요.

노드, 규칙, 클라이언트 부하를 구분해 확인하기

직접 연결과 프록시 연결이 모두 느려졌다면 같은 시각에 Wi-Fi 재전송, 라우터 혼잡, 백그라운드 업로드가 있었는지 먼저 확인하세요. 액세스 포인트에 가까이 가거나 유선 연결로 비교 테스트할 수 있습니다. 직접 연결은 안정적이고 특정 노드에서만 파일 전송이 느리다면 같은 파일을 같은 그룹의 다른 노드로 비교하세요. 노드 탐색은 빠른데 다운로드가 느려도 모순은 아닙니다. 소량의 탐색 데이터는 지속 전송량을 측정하지 않습니다.

사이트 하나만 느리다면 브라우저 개발자 도구의 네트워크 패널에서 가장 오래 걸린 요청을 확인한 뒤 Clash 앱의 연결 기록에서 해당 도메인을 찾으세요. 기본 페이지와 부가 리소스에는 서로 다른 정책이 적용될 수 있습니다. 오래 걸리는 요청을 확인한 뒤 해결 방법을 찾으세요. 이미지 로딩이 느리다는 이유로 브라우저 전체를 전역 모드로 바꾸지 마세요. 끝나지 않은 기존 요청은 이전 경로를 계속 사용할 수 있으므로 새 요청으로 비교하세요.

TUN을 켠 경우에만 기기가 뜨거워지고 페이지 스크롤도 끊긴다면 「활성 상태 보기」에서 앱 인터페이스, 코어, 다른 앱 중 어느 프로세스가 CPU를 계속 사용하는지 확인하세요. 상세 로그가 많이 쌓이거나 활성 연결 목록이 계속 새로고침되면 부하가 커질 수 있습니다. 일반적인 로그 수준으로 되돌리고 불필요한 디버그 화면을 닫은 뒤 같은 작업을 다시 수행하세요. CPU가 잠시 치솟았다고 지속적인 성능 문제가 있다고 단정할 수는 없습니다.

원인을 설명할 수 있는 정책으로 되돌린 뒤 안정성 평가하기

자동 선택 탐색 간격이 너무 짧으면 작은 변동에도 노드를 자주 다시 선택할 수 있습니다. 문제를 점검하는 동안 안정적으로 작동하는 노드를 하나로 고정하고 회의나 다운로드가 끊김 없이 끝나는지 확인한 뒤 탐색 간격이나 그룹 구성원을 조정하세요. 특정 시간대에 특정 사이트만 반복해서 느리다면 시간대, 대상 리소스, 아웃바운드를 기록한 뒤 다시 테스트하세요. 재현 가능한 느린 요청부터 해결하면 됩니다. 모든 상황에서 가장 빠른 노드를 찾을 필요는 없습니다.

DNS 문제: 실제 이름 해석 경로 확인하기

이름 해석 결과가 없는 경우와 결과 주소에 연결할 수 없는 경우 구분하기

브라우저에서 서버를 찾을 수 없다고 나오면 먼저 도메인 철자가 맞는지 확인한 뒤 공개 도메인도 동일하게 실패하는지 테스트하세요. 도메인 하나만 찾을 수 없다면 레코드가 변경됐거나 도메인 자체가 존재하지 않을 수 있습니다. 여러 공개 도메인이 동시에 실패한다면 현재 이름 해석기와 네트워크 경로를 확인하세요. 주소를 이미 받았는데 웹페이지가 시간 초과된다면 곧바로 DNS 문제로 단정하지 말고 주소에 연결할 수 있는지, 핸드셰이크가 완료되는지도 확인하세요.

scutil --dns
dscacheutil -q host -a name example.com
dig +time=2 +tries=1 example.com A
dig +time=2 +tries=1 example.com AAAA

scutil --dns는 시스템에서 사용 가능한 이름 해석기와 도메인 또는 인터페이스별 설정을 확인하는 명령이며, 실제 도메인 조회 요청을 보내지는 않습니다. dscacheutil은 시스템 호스트 조회 결과를 확인하며, 결과가 캐시에서 가져온 것일 수 있습니다. dig는 조회 응답을 확인하는 도구지만 macOS에서는 앱이 사용하는 시스템 해석 경로와 같은 서버를 사용한다고 보장할 수 없습니다. 결과가 서로 다르면 바로 캐시를 지우지 말고 먼저 경로 차이를 파악하세요.

시스템, 브라우저, 코어 결과 비교하기

명령줄에서는 이름이 해석되는데 브라우저에서만 실패한다면 브라우저가 별도의 보안 DNS 설정을 사용하는지, 확장 프로그램이 연결 방식을 바꾸는지 확인하세요. Mac 전체를 초기화하는 것보다 다른 브라우저나 새 브라우저 프로필로 비교하는 편이 원인을 파악하는 데 도움이 됩니다. 반대로 브라우저는 정상인데 시스템 조회가 실패한다면 브라우저 결과만으로 시스템 경로가 복구됐다고 판단할 수 없습니다.

HTTP 또는 SOCKS를 통해 요청을 전달하면 도메인을 요청한 앱이 아니라 클라이언트 코어가 해석할 수 있습니다. SOCKS를 명시적으로 테스트할 때 socks5://와 socks5h://는 curl의 도메인 해석 위치가 다릅니다. 전자는 curl이 로컬에서 해석하고, 후자는 호스트 이름을 프록시에 전달합니다. 비교할 때 같은 포트와 대상을 사용하세요. 그렇지 않으면 관찰된 차이가 해석 위치 때문인지 판단할 수 없습니다.

TUN과 코어 DNS는 서로 다른 설정입니다. DNS를 프록시로 넘기도록 설정했더라도 요청이 실제로 해당 설정이 적용되는 경로를 지나는지 확인해야 합니다. 암호화 DNS를 사용하는 앱은 일반 DNS 요청 경로를 사용하지 않을 수 있으므로 스위치 상태만 보고 판단하지 마세요. fake-ip 모드에서는 가상 주소가 반환된다는 사실만으로 누출이나 오류라고 볼 수 없습니다. 이후 연결이 코어에서 올바른 도메인으로 매핑되는지 확인하세요.

로컬 네트워크와 전용 도메인의 이름 해석 보호하기

공개 사이트는 정상인데 회사 내부망이나 로컬 기기 이름만 실패한다면 새로 설정한 프록시 개입을 끈 뒤 기존 네트워크에서 해당 이름을 해석할 수 있는지 먼저 확인하세요. 회사 네트워크는 도메인 접미사에 따라 전용 이름 해석 서버를 사용할 수 있습니다. 모든 요청을 공용 이름 해석기에 보내면 내부망이 작동하지 않을 수 있습니다. .local은 로컬 멀티캐스트 이름 해석을 사용하는 경우가 많으므로 공용 이름 해석기에 한 번 조회한 결과만으로 기기가 온라인인지 판단할 수 없습니다.

일부 설정에서는 특정 도메인에 사용할 이름 해석기를 지정하거나 특정 도메인에서 fake-ip 동작을 제외할 수 있습니다. 두 기능은 다릅니다. 전자는 어디에 조회할지 정하고 후자는 반환되는 주소 형식에 영향을 줍니다. 사용 중인 코어의 설정 문서를 기준으로 필드를 확인하세요. 문제가 이 단계에 있다고 확인된 뒤에만 명확한 도메인 접미사에 최소한의 변경을 적용하세요. 관리되는 전용 이름 해석 규칙은 네트워크 관리자에게 확인해야 합니다.

누출 여부를 판단하려면 예상 경로를 확인하고 다시 테스트하기

테스트 페이지에 특정 이름 해석 서비스 제공 업체가 표시된다고 해서 곧바로 DNS 누출이라고 볼 수는 없습니다. 먼저 이번 테스트에서 해당 앱이 어떤 이름 해석 경로를 사용해야 하는지 정한 뒤, 브라우저 설정, 현재 모드, 코어 로그와 관찰 결과를 비교하세요. 설정을 변경한 뒤에는 같은 앱에서 새 요청을 보내 공개 도메인 하나와 원래 로컬 이름 해석이 필요한 도메인 하나를 각각 확인하세요. IPv6 주소로 연결할 때만 실패한다면 IPv6 연결 상태부터 점검하고 전역으로 비활성화하지 마세요.

시스템 프록시가 작동하지 않을 때: 네트워크 서비스와 앱 확인하기

현재 네트워크 서비스의 실제 프록시 값 확인하기

클라이언트 스위치가 켜져 있어도 모든 앱이 현재 시스템 프록시를 사용하는 것은 아닙니다. 「시스템 설정 → 네트워크」에서 트래픽을 주고받는 네트워크 서비스로 이동한 뒤 「세부사항 → 프록시」에서 웹 프록시, 보안 웹 프록시, SOCKS 프록시 설정을 확인하세요. macOS 버전에 따라 메뉴 이름이 조금 다를 수 있습니다. Wi-Fi, 도킹 스테이션, 사용자 계정을 바꾼 뒤에는 현재 사용 중인 서비스의 설정을 확인하세요.

networksetup -listallnetworkservices
scutil --proxy
networksetup -getwebproxy 'Wi-Fi'
networksetup -getsecurewebproxy 'Wi-Fi'

뒤의 두 명령에서 서비스 이름은 첫 번째 명령의 출력에 맞게 바꾸세요. 활성화 상태, 호스트, 포트를 비교하고 자동 프록시 설정이나 우회 목록이 있는지도 확인하세요. 여기서 확인하는 것은 설정값일 뿐 포트가 실제로 연결을 받고 있다는 뜻은 아닙니다. 시스템에 127.0.0.1로 표시된다면 프록시는 이 기기에서 실행 중입니다. 클라이언트가 종료됐거나 코어가 실행되지 않는데 이 설정이 남아 있으면 해당 설정을 읽는 앱은 연결할 수 없습니다.

시스템 설정에 지정된 포트가 실제로 연결을 받고 있는지 확인하기

macOS 터미널에서 lsof -nP -iTCP:7897 -sTCP:LISTEN을 실행하면 예시 포트를 어느 프로세스가 사용하는지 확인할 수 있습니다. 클라이언트에서 사용 중인 실제 포트로 바꾸세요. 다른 프로세스가 포트를 사용 중이라면 먼저 어떤 프로세스이며 어떤 용도인지 확인하세요. 알 수 없는 서비스를 강제 종료하지 마세요. 포트를 바꾼 뒤에는 시스템 프록시 설정을 다시 적용하고 프록시 지정 명령으로 검증하세요. 설정 화면의 숫자만 확인해서는 안 됩니다.

아래는 mihomo의 최소 포트 설정 예시로, 각 필드를 확인하기 위한 것이며 전체 설정은 아닙니다. 혼합 포트는 HTTP와 SOCKS 연결을 모두 받습니다. 이 기기에서만 사용할 경우 로컬 네트워크 접속 허용을 끈 상태로 유지하세요. 로컬 브라우저에서 프록시를 사용하려고 네트워크 전체 수신을 켤 필요는 없습니다. 클라이언트 화면에서 실행 설정의 포트를 덮어쓸 수 있으므로 변경 후에는 실제 수신 포트와 시스템 프록시 값을 확인하세요.

mixed-port: 7897
allow-lan: false

브라우저, 터미널, 우회 설정을 각각 확인하기

브라우저는 보통 시스템 프록시를 사용하지만 확장 프로그램, 관리되는 브라우저 정책, 독립 프록시 설정에 따라 결과가 달라질 수 있습니다. 공개 웹사이트에 새 요청을 보내고 클라이언트에서 해당 시각의 연결 기록을 찾으세요. 브라우저에서 요청이 발생했는데 코어에 기록이 없다면 진입 경로와 우회 설정을 먼저 확인하세요. 코어에 기록은 있지만 아웃바운드가 직접 연결이라면 프록시 개입은 작동한 것이므로 스위치를 다시 켜지 말고 적용된 규칙을 확인하세요.

터미널 도구가 macOS 시스템 프록시를 사용하는 것은 아닙니다. 일부 도구는 현재 프로세스의 환경 변수를 읽고, 다른 도구는 자체 설정 파일을 사용합니다. 잘못된 포트를 시작 파일에 기록하지 않도록 먼저 단일 명령에만 적용되는 옵션으로 테스트하세요. 명령에서 프록시를 명시하면 성공한다면 문제는 앱 자체의 프록시 설정 경로에 있습니다. 한 터미널 창에서만 실패한다면 환경 차이를 비교하세요. 인증 정보가 포함될 수 있는 변수 값을 공개하지 마세요.

우회 목록은 로컬 서비스처럼 특정 호스트가 시스템 프록시를 거치지 않게 하는 설정입니다. 문제가 발생한 대상이 우회 범위와 일치한다면 클라이언트에 연결 기록이 없는 것은 정상일 수 있습니다. 목록 전체를 지우지 마세요. 호스트 하나가 일치하는지, 도메인 패턴이 잘못 매칭되는지 확인하고 기존 설정은 기록해 두세요. 회사에서 배포한 자동 프록시 설정과 우회 규칙은 개인 기기와 같은 방식으로 처리할 수 없습니다. 브라우저와 명령줄의 차이는 앱별 시스템 프록시 문제 해결에서 더 확인할 수 있습니다.

TUN이 필요한 경우 확인하기

앱이 요구사항에 맞게 시스템 프록시를 사용할 수 있다면 TUN을 추가로 켤 필요가 없습니다. 시스템 프록시를 사용하지 않는 앱이라면 먼저 앱 자체에 프록시 설정이 있는지 확인하고, 없다면 가상 네트워크 인터페이스로 트래픽을 제어하는 방법을 검토하세요. TUN을 테스트할 때는 이번 테스트에 사용되는 시스템 프록시를 먼저 끄고 현재 어떤 연결 경로를 사용하는지 확인한 뒤 DNS, 로컬 네트워크, 평소 사용하는 앱을 점검하세요. 그래야 결과가 나빠져도 어떤 설정이 원인인지 되돌릴 수 있습니다.

앱 충돌: 화면, 코어, 권한 문제 구분하기

종료된 시점을 기록하고 바로 재설치하지 않기

앱을 열자마자 종료되는 경우, 화면은 정상인데 코어가 실행되지 않는 경우, 특정 설정으로 전환한 뒤에만 종료되는 경우는 해결 방법이 다릅니다. 마지막으로 보였던 동작과 종료 전에 시스템 알림이 표시됐는지 기록하세요. 백그라운드에서 앱이 작동 중인지 확실하지 않다면 「활성 상태 보기」에서 관련 프로세스를 확인하세요. 창을 닫아도 앱이 종료되지 않을 수 있고, 앱이 멈춰도 코어가 연결을 받지 않는다고 단정할 수 없습니다.

종료 후 인터넷이 끊겼다면 인터넷 연결 불가 항목에 따라 먼저 네트워크를 복구한 다음 충돌 문제를 확인하세요. macOS 「콘솔」의 충돌 보고서에서 시각과 프로세스를 기준으로 최근 기록을 찾거나 클라이언트 로그를 확인하세요. 화면을 담당하는 프로세스와 프록시 코어는 별개이므로 창에 나타난 현상만 보는 것보다 어느 프로세스의 보고서인지 확인하는 것이 중요합니다. 문제를 일으킨 동작과 보고서 요약을 기록하면 되며, 전체 보고서를 올릴 필요는 없습니다.

기기 모델, 설치 위치, 시스템 안내 확인하기

「이 Mac에 관하여」에서 칩 또는 프로세서 정보를 확인한 다음 Apple 칩 또는 Intel에 맞는 설치 파일을 선택하세요. 재설치하거나 다른 클라이언트를 사용할 경우 macOS 다운로드 페이지에서 우선 추천하는 Clash Plus를 확인하고 시스템 요구사항에 맞춰 선택하세요. Clash Verge Rev 또는 FlClash를 계속 사용한다면 해당 기기의 아키텍처에 맞는 설치 파일을 선택해야 합니다. 설치 파일 아이콘만으로 판단하지 마세요.

앱을 정상적인 응용 프로그램 위치에 복사했는지 확인하세요. 디스크 이미지에서 바로 실행하는 것과 설치한 뒤 실행하는 것은 다릅니다. macOS에서 앱과 시스템이 호환되지 않는다고 명확히 표시한다면 지원 범위를 확인하세요. 보안 제한이나 시스템 관리 제한이 표시된다면 시스템 안내에 따라 출처와 권한을 확인하세요. 실행 여부를 확인하려고 시스템 보안 기능을 끄지 마세요. 보안 경고와 프로세스 충돌을 같은 오류로 취급하지 마세요.

최소한의 변경으로 설정과 시작 충돌 배제하기

가져오기 후 또는 TUN을 켠 뒤 문제가 발생했다면 화면에 들어갈 수 있을 때 해당 기능을 끄고 마지막으로 작동했던 설정으로 되돌리세요. 시동 시 자동 실행을 막으려면 「시스템 설정 → 일반 → 로그인 항목 및 확장 프로그램」에서 직접 추가한 로그인 항목을 확인하세요. 재시동한 뒤 Clash 앱 하나만 직접 열어 메인 화면이 안정적으로 유지되는지 확인한 다음, 설정을 가져오고 필요한 트래픽 제어 기능을 차례로 켜세요.

화면은 열리지만 코어가 시작되지 않는다면 코어 오류부터 확인하세요. 설정 구조 오류, 포트 충돌, 서비스 권한 부족으로 코어가 시작되지 않을 수 있으며, 이 경우 화면 앱을 재설치해도 해결되지 않을 수 있습니다. 일반 시스템 프록시는 작동하지만 TUN을 켰을 때 실패한다면 클라이언트가 요청하는 서비스 설치나 권한 안내를 확인하고 다른 도구가 가상 네트워크를 동시에 제어하고 있지는 않은지 확인하세요. 관리되는 기기의 권한은 관리자에게 확인해야 합니다.

업데이트 후 앱을 열자마자 종료된다면 해당 클라이언트의 지원 안내를 확인하고 사용자 설정을 백업한 뒤 비활성화해 실행할 수 있는지 알아보세요. 디렉터리 소유권을 확인하고 앱을 완전히 종료한 뒤 백업까지 마친 경우에만 문제 확인을 위해 해당 클라이언트의 설정 디렉터리를 옮기는 방법을 검토하세요. 시스템 라이브러리의 파일을 한꺼번에 삭제하지 말고 다른 클라이언트의 디렉터리를 원인으로 착각하지 마세요.

기능을 하나씩 복구하고 결과 기록하기

초기 상태에서 앱이 실행된다면 먼저 화면과 코어를 확인한 뒤 형식이 정상임을 확인한 설정을 가져오세요. 자동 시작과 TUN은 끈 상태로 두고 연결 기록이 정상인지 확인한 다음 필요한 기능을 복구하세요. 매번 한 항목씩 복구해 문제를 일으키는 동작을 찾으세요. 초기 상태에서도 계속 충돌한다면 기기 아키텍처, 시스템 버전, 오류 프로세스 이름, 재현 조건을 정리해 해당 프로젝트의 지원 채널로 문의하세요. 구독 파일이나 정리하지 않은 로그는 첨부하지 마세요.

모바일: 권한, 백그라운드 실행, 네트워크 전환 후 연결 끊김

시스템에서 VPN 연결이 설정됐는지 먼저 확인하기

모바일 연결은 macOS 시스템 프록시와 다른 경로를 사용합니다. 먼저 앱을 전면에 띄우고 운영체제의 VPN 구성 권한 요청에 응답한 다음, 시스템 설정에서 현재 연결을 설정한 앱을 확인하세요. 상태 표시줄에 VPN이 표시돼도 어떤 앱이 연결을 만들었는지, 대상 트래픽에 사용 가능한 정책이 적용되는지는 보장되지 않습니다. 공개 웹사이트를 먼저 테스트한 뒤 클라이언트에서 해당 요청 기록을 확인하세요.

휴대폰에 회사 VPN, 다른 프록시 도구, 로컬 VPN을 사용하는 필터 앱이 있다면 시스템 연결을 점유하고 있는지 확인하세요. 직접 변경할 권한이 있는 도구만 잠시 중지하세요. 회사에서 관리하는 연결은 삭제하거나 덮어쓰지 마세요. 개인 기기에서 비교할 수 있다면 같은 설정이 개인 기기와 관리 기기에서 다르게 작동하는지 확인하세요. 차이가 있다면 설정 호환성을 판단하기 전에 기기 정책부터 확인해야 합니다.

플랫폼우선 확인할 항목테스트 방법
AndroidVPN 권한, 백그라운드 배터리 관리, 상시 알림화면을 잠근 뒤 잠금 해제하고 새 요청 보내기
iOSVPN 구성 소유 앱, 연결 상태, 주문형 연결 설정네트워크를 바꾼 뒤 다시 연결되는지 확인하기

Android: 백그라운드에서 앱이 중지됐는지 확인하기

화면이 켜져 있을 때는 정상인데 잠금 상태로 일정 시간 지난 뒤 연결이 끊긴다면 시스템의 VPN 상태와 클라이언트 상시 알림이 함께 사라지는지 확인하세요. 다음으로 시스템 앱 정보에서 배터리 관리 설정을 확인하세요. 제조사마다 메뉴 위치가 다르며 배터리 사용량 또는 백그라운드 활동 설정 아래에 있을 수 있습니다. 사용 중인 클라이언트에 대해서만 필요한 만큼 제한을 완화한 뒤 같은 시간 동안 화면을 잠가 다시 테스트하세요. 기기 전체의 절전 기능을 끌 필요는 없습니다. 자세한 메뉴 경로는 Android 권한 및 배터리 절전 설정에서 확인하세요.

VPN이 계속 연결된 것으로 표시되지만 특정 앱에서 트래픽이 발생하지 않는다면 클라이언트의 허용 또는 제외 앱 목록을 확인하세요. 시스템에서 상시 연결 VPN 또는 VPN을 사용하지 않는 연결 차단을 설정했는지도 확인해야 합니다. 후자는 트래픽을 제어하지 않는 앱의 네트워크 동작을 바꿀 수 있으므로 이를 노드 문제로 오해하지 마세요. 테스트가 끝나면 원래 보안 설정으로 되돌리고 진단을 위해 변경한 설정은 남겨 두지 마세요.

iOS: 연결이 복구되지 않은 경우와 기존 요청이 복구되지 않은 경우 구분하기

시스템 VPN 설정에서 활성 구성의 소유 앱을 확인한 다음 Clash Plus에서 연결 상태를 확인하세요. 주문형 연결을 설정했다면 실제 적용 조건을 확인하세요. 모든 네트워크에서 즉시 다시 연결된다고 가정하지 마세요. Wi-Fi에서 셀룰러로 전환해 테스트할 때는 시스템에서 새 네트워크를 사용할 수 있다고 확인한 뒤 새 웹 요청을 보내세요. 기존 음성 통화나 다운로드가 다른 연결로 옮겨지지 않았다고 해서 새 연결도 사용할 수 없다는 뜻은 아닙니다.

셀룰러 네트워크에서만 실패한다면 이번 프록시 개입을 끄고 시스템 데이터 연결과 대상 앱의 셀룰러 데이터 권한을 각각 확인하세요. 게스트 Wi-Fi에서만 실패한다면 네트워크 로그인부터 완료한 뒤 VPN을 테스트하세요. 설정 여러 개를 동시에 켜고 반복 전환하지 마세요. 클라이언트 하나와 정상 작동이 확인된 설정 하나를 고정한 뒤 두 네트워크에서의 결과를 각각 기록하세요.

기기 간 이전 후 기능 다시 확인하기

Mac에서 가져올 수 있는 구독이라고 해서 모바일에서 데스크톱 설정을 모두 인식하는 것은 아닙니다. 데스크톱에서 사용하는 로컬 포트, 오버라이드, 로컬 네트워크 정책, 확장 필드는 별도로 설정해야 할 수 있습니다. 해당 플랫폼이 지원하는 형식으로 테스트 설정을 가져와 공개 대상 하나와 직접 연결이 필요한 리소스 하나를 확인하세요. 화면을 다시 켜거나 네트워크를 바꿀 때만 휴대폰에서 실패한다면 전체 규칙을 먼저 바꾸지 말고 트래픽 제어 상태와 새 요청 결과를 기록하세요.

문제를 해결한 뒤 같은 앱에서 화면이 켜진 상태, 잠금 해제 직후, 네트워크 전환 후 총 세 차례 테스트하세요. 문제가 계속 발생하면 기기 운영체제, 네트워크 유형, 재현 단계, 오류 발생 시 VPN 상태를 포함해 문의하세요. 해당 시도와 관련된 비식별 처리 로그만 첨부하고 관련 없는 앱의 요청 목록은 공유하지 마세요.