Windows
시스템 정보에서 기기 아키텍처를 확인하세요. 처음 사용한다면 시스템 프록시를 켜고 브라우저 연결 기록이 생성되는지 살펴보세요. 시스템 프록시를 사용하지 않는 앱까지 연결해야 한다면 클라이언트의 TUN 지원 여부와 권한 안내를 확인하세요. 기존 설정을 옮기기 전에는 이전 프로그램을 종료해 두 클라이언트가 동시에 프록시 설정을 변경하거나 수신 포트를 점유하지 않도록 하세요.
다운로드 페이지로 이동운영체제에 맞는 클라이언트를 선택하고 mihomo 코어와 YAML 설정을 살펴보세요. 구독을 가져온 뒤 규칙 기반 라우팅을 확인하는 방법도 안내합니다.
구독 전체를 클라이언트에서 가져오며, 노드 제공 소스는 코어가 설정에 따라 읽습니다.
설정 목록에 호환되는 구독 URL을 붙여 넣고 다운로드 및 파싱이 끝날 때까지 기다린 다음 해당 설정을 현재 설정으로 지정하세요. 직접 입력한 정보와 달리 원격 구독은 새로고침할 수 있으며, 노드 이름이 바뀌면 기존 선택에도 영향을 줄 수 있습니다. 노드 제공 소스만 있다면 proxy-providers로 별도 로드한 뒤 프록시 그룹에서 참조할 수 있습니다. 두 링크 모두 YAML을 반환하더라도 서로 바꿔 쓸 수 있는 것은 아닙니다. 업데이트에 성공했는데 노드가 보이지 않으면 먼저 전달된 콘텐츠의 유형을 확인하고, 프록시 그룹이 올바른 제공 소스를 참조하는지 점검하세요.
proxy-providers: office: type: file path: ./providers/office.yamlproxy-groups: - name: PROXY type: select use: [office]구체적인 규칙을 먼저 두고, 기본 규칙은 맨 마지막에 배치하세요.
규칙 모드는 요청을 목록 순서대로 확인하며 일반적으로 처음 일치하는 규칙을 적용합니다. 도메인 접미사 규칙은 하위 도메인을 묶어 분류할 때, IP 대역 규칙은 알려진 네트워크 범위를 지정할 때 유용합니다. 전역 모드와 달리 규칙 모드에서는 대상별로 서로 다른 출구를 지정할 수 있습니다. 설정할 때는 범위가 좁은 예외를 먼저 적고, 범위가 넓은 규칙을 뒤에 둔 다음 마지막에 MATCH로 나머지를 처리하세요. 트래픽이 잘못된 출구로 나가면 노드를 바꾸기 전에 연결 기록에서 실제로 적용된 규칙과 프록시 그룹의 현재 선택을 확인하세요.
mode: rulerules: - DOMAIN,docs.example.com,DIRECT - DOMAIN-SUFFIX,example.com,PROXY - MATCH,DIRECTDNS 연결 방식에 따라 조회 요청이 코어를 거치는지가 달라집니다.
fake-ip 모드에서는 먼저 앱에 가상 IP를 반환한 뒤 코어가 매핑 정보를 바탕으로 대상 도메인을 식별할 수 있습니다. 실제 IP를 바로 반환하는 방식과 달리, 이후 연결도 이 매핑을 인식하는 코어를 거쳐야 합니다. 설정할 때는 시스템과 앱이 사용하는 DNS 경로를 확인하세요. 실제 IP가 필요한 LAN 서비스는 필요에 따라 fake-ip-filter에 추가할 수 있습니다. 변경한 뒤에는 같은 앱에서 연결을 다시 시도하세요. 이전 DNS 캐시나 앱 자체 DNS로 생긴 차이를 규칙 오류로 오해하지 않도록 주의해야 합니다.
dns: enable: true enhanced-mode: fake-ip fake-ip-filter: - '+.lan' nameserver: - system구독의 원본 내용은 유지하고, 로컬 변경 사항은 별도의 오버라이드에 저장하세요.
원격 구독에서 생성된 복사본을 직접 수정하면 새로고침 후 변경 사항이 사라질 수 있습니다. 오버라이드를 지원하는 클라이언트에서는 포트, 로그 수준, 로컬 예외를 따로 저장해 시작 전에 병합할 수 있습니다. 매핑과 목록을 처리하는 방식은 클라이언트마다 다릅니다. 매핑은 키 단위로 갱신될 수 있고, 목록은 전체 교체되거나 앞에 삽입 또는 뒤에 추가될 수 있습니다. 한 클라이언트의 병합 문법을 다른 클라이언트에 그대로 적용하지 마세요. 저장한 뒤 최종 설정을 열어 규칙 순서, 프록시 그룹 참조, 수신 주소가 예상대로 유지되는지 확인하세요.
mixed-port: 7890allow-lan: falselog-level: info코어 전환은 클라이언트가 지원해야 하며, 설정 필드가 자동으로 호환되는 것은 아닙니다.
설치 화면을 제공하는 클라이언트와 설정을 실행하는 코어는 별도로 업데이트될 수 있습니다. 코어 전환을 지원한다면 기존 설정을 보존한 뒤 복사본을 대상 코어에서 불러와 프로토콜, 규칙 세트, DNS 필드 중 인식되지 않는 항목이 있는지 확인하세요. 코어가 고정된 클라이언트라면 앱을 업데이트하거나 다른 클라이언트를 선택해야 합니다. 오른쪽에는 시작 문제와 구독 문제를 구분하기 위한 최소한의 직접 연결 설정이 있습니다. 먼저 코어가 설정을 읽고 포트를 열 수 있는지 확인한 다음 프록시 그룹과 규칙을 하나씩 복구하면 호환되지 않는 부분을 더 빠르게 찾을 수 있습니다.
mixed-port: 7890mode: rulerules: - MATCH,DIRECT먼저 운영체제로 필터링한 뒤 프로세서 아키텍처, 설치 방식, 유지 관리 상태를 확인하세요. 기존 클라이언트에서 옮기는 경우 새 클라이언트의 앱 데이터 폴더를 덮어쓰지 말고 구독이나 설정 파일을 가져오세요.
시스템 정보에서 기기 아키텍처를 확인하세요. 처음 사용한다면 시스템 프록시를 켜고 브라우저 연결 기록이 생성되는지 살펴보세요. 시스템 프록시를 사용하지 않는 앱까지 연결해야 한다면 클라이언트의 TUN 지원 여부와 권한 안내를 확인하세요. 기존 설정을 옮기기 전에는 이전 프로그램을 종료해 두 클라이언트가 동시에 프록시 설정을 변경하거나 수신 포트를 점유하지 않도록 하세요.
다운로드 페이지로 이동‘이 Mac에 관하여’에서 Apple Silicon과 Intel 중 어떤 프로세서인지 확인한 뒤 해당 설치 파일을 선택하세요. 프록시를 처음 켠 다음에는 시스템 네트워크 설정에서 현재 네트워크 서비스에 해당 설정이 적용됐는지 확인할 수 있습니다. 클라이언트를 종료한 뒤에도 앱이 로컬 프록시 포트에 연결을 시도한다면 구독을 반복해서 가져오기보다 시스템 프록시가 해제됐는지 확인하세요.
다운로드 페이지로 이동시스템에서 지원하는 ABI에 맞춰 설치 파일을 선택하세요. 프로세서가 특정 명령어 집합을 지원하더라도 현재 시스템에 해당 패키지를 설치할 수 있다는 뜻은 아닙니다. 처음 연결할 때는 시스템 안내에 따라 VPN 권한을 허용하세요. 화면을 잠근 뒤 연결이 끊긴다면 알림 영역의 상태를 기록하고 앱의 백그라운드 실행 제한과 다른 VPN 서비스의 연결 점유 여부를 확인하세요.
다운로드 페이지로 이동App Store에서 클라이언트와 시스템의 호환 조건을 확인하세요. 설정을 가져오고 VPN 구성 추가를 허용한 뒤 클라이언트로 돌아와 선택된 설정과 프록시 그룹을 확인하세요. 상태 표시줄에 VPN 연결이 표시되는데도 대상 앱을 사용할 수 없다면 먼저 브라우저에서 같은 대상에 접속해 보세요. 그런 다음 해당 앱의 연결 기록을 확인해 터널 시작 문제와 요청 전달 문제를 구분하세요.
다운로드 페이지로 이동데스크톱 환경에서는 배포판에 맞춰 패키지 형식을 선택할 수 있습니다. 예를 들어 Debian 계열에는 DEB를, 해당 배포판에는 RPM을 사용할 수 있습니다. GUI가 없는 기기에 배포할 경우 코어를 독립 실행할 수 있지만 설정 디렉터리, 서비스 권한, 로그는 직접 관리해야 합니다. 시작에 성공한 뒤에도 시스템 설정, 환경 변수 또는 다른 연결 방식을 통해 앱의 요청이 코어로 전달되는지 확인하세요.
다운로드 페이지로 이동구독 또는 설정 페이지에서 제공업체가 안내한 호환 링크를 추가하거나 로컬 YAML 파일을 선택하세요. 목록에 파일이 표시되면 해당 파일을 현재 설정으로 지정해야 합니다. 가져오기에 실패했다면 응답이 설정 본문인지, 로그인 페이지나 서비스 안내 페이지인지 먼저 확인하세요. 스크린샷, 로그, 문제 보고서에 구독 URL을 노출하지 마세요.
규칙 모드를 선택하고 프록시 그룹에서 사용할 출구를 확인하세요. 데스크톱에서는 먼저 시스템 프록시를 사용하고, 모바일에서는 안내에 따라 VPN 권한을 허용하세요. TUN이 필요한지 판단하기 전에 연결 방식 하나를 먼저 검증하세요. 코어가 실행 중이라는 것은 시작되었다는 뜻일 뿐 앱 트래픽이 코어로 들어왔다는 의미는 아닙니다. 두 상태를 각각 확인해야 합니다.
직접 연결될 것으로 예상되는 대상과 프록시를 거칠 것으로 예상되는 대상을 하나씩 골라 차례로 접속하고 연결 기록을 확인하세요. 대상 도메인, 적용된 규칙, 최종 출구를 비교합니다. 기록이 없다면 프록시 연결 설정을 먼저 확인하세요. 기록은 있지만 출구가 잘못됐다면 규칙 순서를 점검하세요. 적용된 규칙과 출구가 모두 예상과 일치한 뒤에야 원격 연결 문제를 살펴보세요.
원본 Clash 설정은 프록시 노드, 프록시 그룹, 규칙을 중심으로 구성됩니다. 이후 여러 프로젝트가 이 구성을 이어받거나 확장했지만 이름이 비슷하다고 해서 배포 경로나 유지 관리 일정까지 공유하는 것은 아닙니다. 오래된 가이드에서는 화면의 메뉴 위치가 달라졌을 수 있습니다. 내용을 읽을 때는 코어 필드, 클라이언트 사용법, 특정 구독 제공업체의 변환 규칙 중 무엇을 다루는지 먼저 확인하세요.
클라이언트는 설정 관리, 시스템 연결, 연결 기록을 담당하고 코어는 설정을 파싱해 규칙을 적용하고 연결을 생성합니다. 구독 제공업체는 전달할 콘텐츠를 관리합니다. 같은 구독을 사용해도 클라이언트에 따라 결과가 달라질 수 있습니다. 예를 들어 한 클라이언트가 DNS나 수신 설정을 추가로 삽입할 수 있습니다. 문제를 확인할 때는 구독 원본과 최종 적용 설정을 각각 보관하세요. 화면의 토글만 보는 것보다 둘의 차이를 비교하는 편이 정확합니다.
mihomo는 Clash Meta 코어의 개발을 이어받아 프록시 프로토콜, 규칙 세트, 네트워크 스택 설정 옵션을 추가했습니다. 원본 설정에서 흔히 쓰는 기본 필드는 마이그레이션의 출발점으로 활용할 수 있지만, 같은 이름의 필드라도 허용 값과 연관 조건은 대상 코어의 기준을 따라야 합니다. 파싱에 실패하면 오류 메시지에서 처음 문제가 발생한 필드를 찾은 뒤 설정 참고 자료를 확인하세요. 용어가 낯설다면 용어 설명을 참고하세요.
클라이언트 릴리스 노트와 코어 변경 내역은 따로 확인하세요. 업그레이드 전에 정상 작동하는 설정과 필요한 로컬 오버라이드를 보관하세요. 업그레이드 후에는 설정을 불러올 수 있는지 먼저 확인하고 시스템 프록시, DNS 경로, 규칙 적용을 점검하세요. 재현 가능한 문제를 보고할 때는 사용 플랫폼, 연결 방식, 최소 재현 설정을 적고 개인 도메인, 구독 매개변수, 노드 인증 정보는 제거하세요. 실제 결과를 먼저 설명한 다음 기대한 결과를 적으면 유지 관리자들이 문제 발생 계층을 파악하기 쉽습니다.
코어는 GPL-3.0 라이선스로 배포됩니다. 아래 명령은 소스 코드를 가져오는 용도이며 데스크톱 클라이언트 설치 명령이 아닙니다. GUI 클라이언트가 필요하다면 설치 파일 페이지로 돌아가 운영체제에 맞는 항목을 선택하세요.
git clone https://github.com/MetaCubeX/mihomo.git
플랫폼 지원, 코어 버전, UI, TUN 지원, 설정 오버라이드 기능을 기준으로 주요 Clash 클라이언트를 비교하고 사용 환경별 선택 기준을 안내합니다.
모든 노드가 시간 초과되거나 특정 노드에 연결되지 않을 때 구독 유효성, 로컬 포트, DNS 조회, 시스템 시간, 규칙 적용을 차례로 확인해 원인을 찾고 해결 방법을 안내합니다.
Windows용 Clash 클라이언트를 설치하고 구독 가져오기, 시스템 프록시, TUN 모드를 차례로 설정하는 방법과 방화벽 차단, 포트 충돌, 서비스 모드 권한 등 자주 발생하는 문제를 정리합니다.