Clash 자주 묻는 질문
구독, 프록시, TUN

클라이언트는 설정을 가져오고, 정책을 전환하며, 연결을 관리하는 그래픽 인터페이스입니다. mihomo는 프록시 프로토콜과 트래픽 분기 규칙을 처리하는 코어이고, 구독은 설정이나 노드 정보를 제공하는 원격 주소입니다. 클라이언트를 설치한 뒤 사용할 수 있는 설정을 가져오고 정책을 선택해야 규칙에 따라 트래픽을 전달할 수 있습니다. 이 사이트는 설치 및 설정 정보를 제공하며 노드 계정은 제공하지 않습니다. 문제를 해결할 때는 클라이언트 실행, 설정 다운로드, 노드 연결 중 어느 단계에서 오류가 발생했는지 먼저 확인하세요.

일상적인 사용에는 규칙 모드를 선택하세요. 코어가 설정에 지정된 도메인, IP 등의 조건에 따라 트래픽 경로를 결정합니다. 전역 모드는 코어로 들어오는 연결을 전역 정책 그룹에 전달하지만, 그룹에서 사용할 정책을 선택해야 합니다. 모든 앱의 트래픽을 자동으로 처리하는 것은 아닙니다. 직접 연결 모드는 코어로 들어온 연결을 대상에 바로 연결합니다. 모드를 바꾼 뒤 요청을 다시 보내세요. 기존의 장시간 연결은 이전 경로를 계속 사용할 수 있습니다. 특정 웹사이트만 문제가 있다면 잠시 전역 모드로 바꿔 비교한 다음 규칙 모드로 돌아와 매칭 결과를 확인하세요.

시스템 프록시는 프록시 주소를 운영체제 설정에 등록해 해당 설정을 따르는 앱에 적용합니다. TUN은 가상 네트워크 인터페이스를 사용하는 방식으로 네트워크 계층에서 더 많은 트래픽을 처리할 수 있지만, 실제 적용 범위는 라우팅, 제외 항목, DNS 설정에 따라 달라집니다. 보통 보조 서비스 권한도 필요합니다. 웹 브라우징은 먼저 시스템 프록시로 설정을 확인하고, 터미널이나 게임 등 다른 앱이 프록시를 따르지 않을 때 TUN을 고려하세요. 처음 문제를 점검할 때 여러 프록시 도구를 동시에 사용하면 실제 트래픽 경로와 라우팅을 파악하기 어렵습니다.

Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’를 확인하세요. Apple M 시리즈 칩이면 Apple Silicon 또는 arm64를, Intel 프로세서면 Intel 또는 x64를 선택합니다. Universal 패키지는 일반적으로 두 아키텍처를 모두 포함하지만, 프로젝트의 시스템 요구 사항도 확인하세요. Mac을 구입한 연도만으로 판단하지 마세요. 설치 후 앱이 현재 시스템을 지원하지 않는다는 메시지가 표시되면 macOS 최소 버전을 확인하세요. 아키텍처를 바꿔도 오래된 macOS 버전 문제는 해결되지 않습니다.

사용 가능 여부는 설정 항목, 프록시 프로토콜, 사용 중인 코어의 호환성에 따라 달라집니다. 업데이트가 중단됐다고 모든 기존 설정이 바로 작동하지 않는 것은 아닙니다. 이전하기 전에 기존 설정과 정책 선택을 저장하고, 계속 유지 관리되는 클라이언트에서 구독을 다시 가져온 뒤 규칙, DNS, TUN 설정을 확인하세요. 새 클라이언트의 데이터 폴더 전체를 그대로 덮어쓰지 마세요. 오래된 코어는 새 프로토콜이나 설정 항목을 인식하지 못할 수 있습니다. 설정 파싱 오류가 발생하면 오류 메시지에서 해당 항목을 찾아 구독 제공자에게 호환되는 설정을 요청하세요.

DMG를 연 뒤 앱을 Applications 폴더로 드래그하고, 해당 폴더에서 실행하세요. 디스크 이미지에서 계속 실행하지 마세요. 설치 패키지의 아키텍처가 시스템 요구 사항에 맞는지도 확인합니다. 시스템에서 실행을 차단하면 먼저 다운로드 출처를 확인한 다음 ‘시스템 설정 → 개인정보 보호 및 보안’에서 관련 안내를 찾아 시스템이 제공하는 방법으로 처리하세요. 앱 하나를 실행하기 위해 기기 전체의 보안 기능을 끄지 마세요. 손상 또는 서명 관련 오류가 발생하면 다시 다운로드하고 해당 클라이언트의 릴리스 노트에서 알려진 문제를 확인하세요.

클라이언트의 ‘설정’ 또는 ‘구독’ 페이지에서 URL 가져오기를 선택하고 구독 주소 전체를 붙여 넣은 뒤 저장하세요. 다운로드가 끝나면 새 설정이 선택되어 있는지 확인하고, 프록시 페이지에서 정책을 선택한 다음 시스템 프록시를 켜고 접속이 확인된 웹사이트를 방문하세요. 로컬 YAML 파일은 파일 가져오기 메뉴를 사용해야 하며 URL 입력란에 붙여 넣으면 안 됩니다. 구독 주소에 계정 정보가 포함될 수 있으므로 스크린샷을 찍거나 로그를 공유하거나 도움을 요청하기 전에 주소의 민감한 부분을 가리세요.

오류 메시지에 표시된 줄 번호와 설정 항목부터 확인하세요. 서버가 반환한 내용이 로그인 페이지, 만료 안내, Base64 노드 문자열일 수 있으며 클라이언트가 필요한 Clash YAML 설정이 아닐 수도 있습니다. 구독 제공자에게 사용해야 할 구독 형식을 확인하세요. 파일 확장자만 바꾸는 것으로 해결되지는 않습니다. 실제 YAML이라면 들여쓰기에 공백을 사용했는지, 콜론 뒤에 공백이 있는지, 현재 코어가 해당 항목을 지원하는지 확인하세요. 직접 수정하기 전에 복사본을 저장하고, 개인 노드 정보가 포함된 설정을 출처가 불분명한 온라인 변환 서비스에 제출하지 마세요.

먼저 TUN을 끄고 클라이언트 설정에서 보조 서비스 또는 서비스 모드 설치 메뉴를 찾아 시스템 안내에 따라 권한을 부여하세요. 설치가 끝나면 클라이언트를 다시 시작한 뒤 TUN을 켜고, 코어 로그에 가상 네트워크 인터페이스나 라우팅 생성 오류가 있는지 확인합니다. 메뉴 이름은 클라이언트마다 다를 수 있으므로 현재 버전의 안내를 따르세요. 회사에서 관리하는 기기는 권한 정책에 따라 설치가 차단될 수 있으니 관리자에게 문의하세요. 앱의 출처를 확인한 뒤에만 권한을 부여하고, 출처를 알 수 없는 권한 상승 명령을 그대로 실행하지 마세요.

먼저 클라이언트 코어가 실행 중이고 설정이 선택되어 있으며 현재 정책을 사용할 수 있는지 확인하세요. macOS에서 현재 네트워크 서비스의 프록시 설정을 열어 주소와 포트가 클라이언트에 표시된 값과 일치하는지 확인합니다. 특히 Wi-Fi와 유선 네트워크를 전환한 뒤 설정을 확인하세요. 브라우저 확장 프로그램, 별도의 프록시 설정, 다른 프록시 소프트웨어가 시스템 설정을 덮어쓸 수 있으니 잠시 비활성화하고 다시 시도하세요. 마지막으로 연결 기록을 확인합니다. 요청이 보이지 않으면 트래픽이 프록시로 전달되는 경로를 점검하고, 요청이 보이면 매칭 규칙, 정책 선택, 노드 상태를 확인하세요.

많은 명령줄 도구는 macOS 시스템 프록시 설정을 읽지 않습니다. 먼저 클라이언트가 실제로 수신 대기 중인 HTTP 또는 혼합 포트를 확인한 다음 도구 문서에 따라 HTTP_PROXY, HTTPS_PROXY, ALL_PROXY 등의 환경 변수를 설정하세요. HTTPS_PROXY는 HTTPS 대상에 접속할 때 사용할 프록시를 지정하는 변수이며, 프록시 주소를 반드시 https 프로토콜로 작성해야 한다는 뜻은 아닙니다. 먼저 현재 터미널 세션에서 테스트하고 정상 작동을 확인한 뒤 shell 설정 파일에 추가하세요. 테스트가 끝나면 관련 변수를 지워 클라이언트를 종료한 뒤에도 명령이 로컬 포트를 계속 가리키지 않도록 하세요.

먼저 구독 제공자가 권장하는 간격을 따르세요. 사용 가능 상태를 유지하려고 지나치게 자주 업데이트할 필요는 없습니다. 설정 변경이 많지 않다면 몇 시간에서 하루 간격으로 시작하고, 필요할 때 수동으로 업데이트하세요. 간격의 단위나 기기가 절전 모드에서 깨어난 뒤 업데이트하는 방식은 클라이언트마다 다를 수 있으므로 저장 전에 화면 안내를 확인하세요. 업데이트에 실패해도 현재 사용할 수 있는 설정은 유지하고, 삭제와 재생성을 반복하지 마세요. 구독 업데이트는 설정을 가져오는 기능입니다. 노드 연결 여부는 계정 상태, 네트워크 경로, 노드 서비스 자체에도 영향을 받습니다.

클라이언트의 연결 페이지를 열고 대상 웹사이트에 접속한 다음 도메인이나 프로세스 이름으로 새 연결을 찾아 적용된 규칙, 정책 그룹, 실제 연결 경로를 확인하세요. 필요한 경우 로그 수준을 잠시 높여 한 번 재현한 뒤 원래대로 돌려 로그가 계속 쌓이지 않게 하세요. 규칙은 일반적으로 순서대로 적용되므로 범위가 넓은 규칙이 앞에 있으면 뒤쪽의 세부 규칙이 적용되지 않을 수 있습니다. 설정을 수정한 뒤 다시 불러오고 새 요청을 보내세요. 브라우저 캐시, 연결 재사용, 암호화 DNS 때문에 예상과 다른 결과가 나타날 수 있습니다.

먼저 연결 기록에서 해당 웹사이트가 직접 연결이나 다른 정책 그룹이 아니라 선택한 정책을 실제로 거쳤는지 확인하세요. 관련 페이지를 닫고 다시 연결하고, 필요하면 해당 웹사이트의 기존 연결만 종료하세요. 웹사이트는 계정 지역, 쿠키, 위치 정보 권한, 방문 기록을 바탕으로 위치를 판단할 수도 있으므로 페이지 언어만으로 연결 경로가 바뀌었는지 판단하지 마세요. 네트워크 출구를 확인하려면 신뢰할 수 있는 IP 조회 서비스를 이용하고, 같은 웹사이트의 도메인마다 서로 다른 규칙이 적용될 수 있다는 점도 유의하세요.

먼저 현재 네트워크에서 기본 서비스에 직접 접속할 수 있는지 확인하고, 공용 Wi-Fi라면 웹 로그인 절차를 완료한 뒤 프록시를 다시 켜세요. 노드를 다시 테스트하고, 계속 문제가 있으면 시스템 프록시를 껐다 켜세요. TUN을 사용하는 기기는 TUN을 다시 시작하고 로그에서 라우팅 및 DNS 오류를 확인하세요. 네트워크가 바뀌면 기존 연결이 끊길 수 있으므로 문제가 발생한 앱을 다시 열어 확인하세요. 문제가 매번 발생한다면 네트워크 유형과 발생 순서를 기록하고, 시스템 프록시만 사용할 때와 TUN만 사용할 때를 각각 테스트해 원인을 좁히세요.

주소를 빠짐없이 복사했는지, 계정이 만료되지 않았는지, 제공자가 구독 주소를 변경하지 않았는지 확인하세요. 업데이트 로그의 상태 코드를 살펴보세요. 401이나 403은 인증 또는 접근 정책과 관련된 경우가 많고, 404는 주소나 리소스가 변경된 경우가 많으며, 429는 요청 횟수 제한을 뜻합니다. 자세한 내용은 구독 제공자의 안내를 확인하세요. 시간 초과나 도메인 확인 오류가 발생하면 네트워크와 DNS를 먼저 점검하세요. 업데이트가 현재 작동하지 않는 프록시에 의존한다면 클라이언트에서 지원하는 방법으로 직접 연결을 사용해 업데이트하거나 다른 네트워크에서 테스트하세요.

반드시 그런 것은 아닙니다. 지연 시간 테스트는 지정된 테스트 주소에 요청을 보내는 경우가 많습니다. 테스트 주소에 접속할 수 없거나 DNS에 문제가 있거나 시간 제한이 너무 짧으면 시간 초과가 발생할 수 있습니다. 다른 노드와 비교한 뒤 브라우저에서 실제 대상 웹사이트에 접속하고 연결 로그를 확인하세요. 모든 노드가 동시에 실패하면 계정 상태, 구독 업데이트, 시스템 시간, 로컬 네트워크를 점검하세요. 노드 하나만 실패하면 제공자에게 문의하세요. 지연 시간 테스트를 대역폭 테스트로 간주하거나 숫자 하나만으로 전체 서비스의 가용성을 판단하지 마세요.

먼저 TUN을 끄고 기본 네트워크가 복구되는지 확인한 다음 다른 VPN, 가상 네트워크 인터페이스, 프록시 도구가 함께 실행 중인지 점검하세요. 일단 트래픽을 처리하는 도구는 하나만 남기세요. 로그에서 라우팅 충돌, DNS 수신 오류, 권한 오류를 찾아 메시지에 따라 하나씩 해결하세요. 기존 설정을 DNS 설정 전체로 덮어쓰지 마세요. 클라이언트를 종료한 뒤에도 문제가 계속되면 시스템 VPN 및 프록시 설정이 남아 있는지 확인하고, 필요하면 네트워크에 다시 연결하거나 기기를 재시작하세요. 복구한 뒤 최소 설정으로 TUN을 다시 켜서 확인하세요.

AppContainer 격리 기능을 사용하는 일부 Windows 앱은 로컬 프록시 주소에 접근할 때 루프백 제한을 받을 수 있습니다. 먼저 일반 브라우저가 같은 프록시를 통해 인터넷에 연결되는지 확인한 다음, 클라이언트에서 제공하는 루프백 예외 도구를 사용해 문제가 있는 앱에만 예외를 설정하고 안내에 따라 관리자 권한을 부여하세요. UWP는 유니버설 Windows 플랫폼을 뜻하며, 루프백 문제는 모든 스토어 앱에 해당하지 않습니다. 예외를 설정한 뒤에도 연결되지 않으면 앱 자체의 네트워크 권한, 방화벽, 프록시 방식을 확인하세요. 예외를 취소할 때도 해당 앱의 설정만 제거하세요.

클라이언트를 종료한 뒤 인터넷이 끊기면 시스템 네트워크 설정에서 수동 프록시가 중지된 로컬 포트를 계속 가리키는지 확인하고, 남아 있는 설정을 끈 뒤 다시 시도하세요. 실행할 때 포트가 사용 중이라는 메시지가 표시되면 다른 프록시 클라이언트를 종료하고 이전 코어 프로세스가 실행 중인지 확인한 다음 로그에서 충돌하는 포트를 찾으세요. 수신 포트를 변경했다면 시스템 프록시, 터미널 변수, 브라우저 설정도 함께 확인해야 합니다. 잘 모르는 시스템 프로세스를 무작정 종료하지 마세요. 원인을 찾지 못하면 로그를 저장하고 작업 순서를 기록해 도움을 요청하세요.