Clash 오픈소스 커뮤니티 mihomo

Clash 클라이언트 다운로드및 설정 가이드

운영체제에 맞는 Clash 클라이언트를 선택하고 mihomo 설정 항목을 확인한 뒤, 연결 기록으로 규칙 기반 라우팅 결과를 점검하세요.

  • 커널 소스 공개
  • 한국어 문서

INSTALL / PLATFORM

Clash 플랫폼별 다운로드

먼저 운영체제와 프로세서 종류를 확인한 다음 클라이언트를 선택하세요. 같은 프로젝트에서도 아키텍처별 설치 패키지를 따로 제공할 수 있으므로 이름이 비슷해도 서로 바꿔 설치하면 안 됩니다. 처음 사용한다면 GUI 클라이언트가 편리합니다. 설정 가져오기, 연결 확인, 정책 전환을 모두 화면에서 할 수 있습니다. 라우터나 서버에서 네트워크 서비스를 직접 관리하는 경우에는 코어만 별도로 설치하는 방법도 고려해 보세요.

Windows

「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. 다운로드 페이지에 표시된 아키텍처와 대조한 뒤 설치 패키지를 선택하면 됩니다. 클라이언트를 바꾸기 전에는 기존 프로그램을 종료하고 시스템 트레이의 백그라운드 프로세스도 끝났는지 확인하세요. 두 인스턴스가 같은 포트를 동시에 사용하려는 상황을 방지할 수 있습니다.

macOS

「이 Mac에 관하여」에서 칩 또는 프로세서 항목을 확인한 다음 Apple 칩용이나 Intel용 설치 패키지를 선택하세요. 메뉴 막대에 클라이언트 아이콘이 보이는 것은 보통 프로그램이 실행 중이라는 뜻일 뿐입니다. 설정을 가져온 뒤에는 해당 설정이 활성화되어 있는지 확인하고, 필요한 경우 시스템 프록시를 켜세요.

Android

기기의 앱 아키텍처에 맞는 설치 패키지를 선택하세요. 휴대전화 모델에 ‘64비트’라고 표시되어 있다는 이유만으로 패키지를 결정할 수는 없습니다. 처음 연결할 때는 시스템의 VPN 권한 요청을 확인하세요. 기기에서 다른 로컬 VPN을 사용 중이었다면 연결을 끊어야 하는지 확인한 후 새 클라이언트를 시작하세요.

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동해 앱 상세 정보의 시스템 요구 사항을 확인하세요. 설치 후에는 먼저 클라이언트가 지원하는 가져오기 형식을 살펴보세요. 연결을 설정할 때 시스템 안내에 따라 VPN 구성을 추가한 다음, 클라이언트로 돌아와 현재 어떤 설정을 사용 중인지 확인하세요.

Linux

먼저 배포판에서 지원하는 패키지 형식을 확인하고 아키텍처를 대조하세요. 데스크톱 환경이라면 GUI 클라이언트를 고려할 수 있습니다. 명령줄만 사용하는 환경에서는 설정 디렉터리, 프로세스 시작 방법, 로그 저장 위치를 직접 관리해야 합니다. 다른 기기로 옮길 때는 기본 설정뿐 아니라 규칙 세트와 로컬 파일 참조도 확인하세요.

이전 가이드에 나온 버튼이 새 클라이언트에서는 다른 위치에 있을 수 있습니다. 특히 지원이 종료된 Clash for Windows에서 옮기는 경우에는 직접 추가한 규칙과 오버라이드를 보존하고, 새 클라이언트에서 설정을 다시 가져오세요. 기존 작업 디렉터리 전체를 그대로 복사하지 마세요. 설정 파일 외에도 캐시와 예전 인터페이스에서만 쓰이는 설정이 들어 있을 수 있습니다.

전체 클라이언트 보기 → 클라이언트 기능 비교 및 선택

CONFIG / INSPECTION

mihomo 핵심 설정

문제를 진단할 때는 세 가지를 나눠 살펴보세요. 요청이 코어에 들어왔는지, 어떤 규칙에 매칭됐는지, 마지막으로 어떤 아웃바운드를 사용했는지 확인하면 됩니다. 아래 예시는 각 설정 항목을 설명하기 위한 것으로, 그대로 바꿔 넣을 수 있는 전체 설정 파일은 아닙니다. 항목의 허용 값과 의존 관계는 전체 설정 항목 레퍼런스에서 확인하세요.

구체적인 규칙을 먼저, 기본 규칙은 마지막에

규칙 모드에서는 목록을 위에서 아래로 확인하며, 일치하는 항목을 찾으면 이후 규칙은 검사하지 않습니다. 특정 하위 도메인을 기본 도메인과 다른 경로로 보내려면 정확한 도메인 규칙을 먼저 쓰고, 범위가 더 넓은 도메인 접미사 규칙을 뒤에 둔 다음 마지막에 기본 규칙을 추가하세요. 전역 모드와 달리 규칙 모드에서는 하나의 설정에서 여러 아웃바운드를 지정할 수 있습니다. 수정 후에는 연결 기록에서 실제로 매칭된 규칙을 확인하세요. 규칙이 사용자 지정 프록시 그룹을 가리킨다면 규칙에 적힌 이름과 그룹 이름이 정확히 일치하는지도 확인해야 합니다.

config.yaml · rules
mode: rule
rules:
  - DOMAIN,blocked.example.com,REJECT
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

SETUP / FIRST RUN

설정 가져오기, 트래픽 처리, 연결 확인

처음 테스트할 때는 평소 접속할 수 있는 사이트를 선택하고 프록시를 켜기 전 상태를 기록해 두세요. 이후에는 한 번에 설정 하나만 변경하세요. 문제가 생기면 바로 이전 단계로 돌아가 어떤 변경 이후에 문제가 시작됐는지 확인할 수 있습니다.

  1. 설정 파일을 가져와 활성화하기

    클라이언트의 「설정」 또는 「구독」 메뉴에서 파일 가져오기를 선택하거나 신뢰할 수 있는 출처의 구독 URL을 입력하세요. 가져온 뒤 해당 설정을 선택하고 규칙과 프록시 그룹이 로드됐는지 확인하세요. 목록에 항목이 있다고 해서 코어가 실제로 사용 중인 것은 아닙니다. 파싱 오류가 발생하면 먼저 메시지에 표시된 항목이나 줄 번호를 기록하세요. 기존 파일은 보관하고 복사본에서 들여쓰기, 목록 계층 또는 항목 유형을 수정하세요.

  2. 규칙 모드와 트래픽 처리 방식 선택

    규칙 모드로 테스트한 다음 관련 프록시 그룹에서 아웃바운드를 하나 선택하세요. 데스크톱에서는 시스템 프록시 설정을 따르는 앱을 먼저 테스트할 수 있습니다. 모바일에서는 클라이언트 안내에 따라 시스템 VPN을 설정하세요. 모드와 노드, 트래픽 처리 방식을 한꺼번에 바꾸지 마세요. 터미널 도구 하나만 프록시로 연결하려는 경우에는 전체 기기의 라우팅을 바꾸지 말고 해당 도구의 문서에 따라 프록시 주소를 설정해도 됩니다.

  3. 연결 기록에서 규칙 매칭 확인

    테스트 페이지를 연 다음 클라이언트의 연결 목록에서 대상 도메인을 찾아 규칙과 아웃바운드를 확인하세요. 연결 기록이 없다면 먼저 앱의 트래픽이 클라이언트로 들어오는지 확인하세요. 기록은 있지만 기본 규칙에 매칭됐다면 규칙 순서와 도메인 표기를 다시 살펴보세요. 올바른 규칙에 매칭됐는데도 시간 초과가 발생한다면 대상 사이트와 선택한 아웃바운드의 연결 상태를 확인하세요. 오류가 발생하면 시간, 모드, 오류 메시지를 기록하고 로그를 공유하기 전에 구독 URL과 인증 정보를 삭제하세요.

전체 가이드 보기 →

처음 확인할 문제

노드 지연 시간은 측정되는데 웹페이지가 열리지 않는 이유는 무엇인가요?

지연 시간 측정 요청과 웹페이지 요청은 서로 다른 규칙을 따를 수 있고, 대상 주소도 다를 수 있습니다. 먼저 웹페이지 요청이 연결 목록에 표시되는지 확인한 다음 실제 아웃바운드를 살펴보세요. 지연 시간은 해당 테스트를 한 번 수행했을 때의 결과만 보여 줍니다. 관련 용어는 용어집에서 확인하세요.

구독 업데이트에 실패하면 기존 설정을 삭제해야 하나요?

먼저 정상적으로 사용할 수 있는 설정을 보존하세요. 업데이트 오류가 요청 시간 초과인지, 인증 실패인지, 형식 파싱 오류인지 확인하고 원인에 맞게 처리하세요. 원격 콘텐츠를 가져올 수 없는 경우 클라이언트를 반복해서 재설치해도 대개 해결되지 않습니다. 용어집에서 구독과 로컬 설정의 차이를 먼저 확인해 보세요.

브라우저는 인터넷에 연결되는데 터미널은 왜 다른 경로를 사용하나요?

명령줄 프로그램이 시스템 프록시 설정을 반드시 읽는 것은 아닙니다. 환경 변수를 읽는 도구도 있고 별도로 설정해야 하는 도구도 있습니다. 먼저 해당 도구의 문서를 확인한 다음 클라이언트에 인바운드 연결 기록이 있는지 살펴보세요. 트래픽 처리 방식은 용어집을 참고하세요.

SOURCE / MAINTENANCE

mihomo 소스 코드와 프로젝트별 역할

프로젝트 이름, 클라이언트 이름, 구독 제공자는 서로 다른 개념입니다. 설정 항목을 확인할 때는 실제로 설정을 불러오는 코어가 무엇인지 먼저 살펴보세요. 설치나 업데이트, 인터페이스 문제가 있다면 해당 클라이언트의 문서를 확인하면 됩니다.

Clash에서 mihomo로

Clash 생태계에서는 인바운드, 아웃바운드, 규칙을 YAML로 정의해 왔습니다. mihomo는 이전에 Clash.Meta로 불리던 코어 프로젝트를 이어갑니다. 예전 자료에 과거 명칭이 남아 있는 것은 흔한 일입니다. 오래된 문서의 인터페이스 화면이나 매개변수를 볼 때는 어떤 프로젝트에 해당하는지 먼저 확인하세요. 이름이 비슷하다는 점은 검색 단서일 뿐, 특정 설정 항목이 여전히 유효한지 판단하거나 두 설치 패키지가 같은 관리 주체에서 제공된다고 단정하는 근거가 될 수 없습니다.

오픈소스 라이선스와 프로젝트별 역할

mihomo 소스 저장소는 GPL-3.0 오픈소스 라이선스를 따르며, 상위 저장소에서 코드와 변경 내역, 이슈 논의를 확인할 수 있습니다. 이 라이선스는 코어 프로젝트에 적용되며 모든 GUI 클라이언트가 같은 라이선스를 따른다는 뜻은 아닙니다. GUI 프로젝트는 각자 인터페이스와 시스템 연동, 배포 패키지를 관리합니다. 구독은 설정 제공자가 관리하며, 구독을 업데이트해도 클라이언트가 바뀌거나 새 코어가 시스템에 설치되지는 않습니다.

GUI와 실제 적용되는 설정

코어는 인바운드를 처리하고 규칙에 따라 아웃바운드를 선택해 연결을 수행합니다. GUI 클라이언트는 이러한 정보를 보여 줄 뿐 아니라 구독, 오버라이드, 전역 설정을 병합한 다음 결과를 코어에 전달하기도 합니다. 설정 파일에 규칙이 있는데도 인터페이스에서 적용되지 않는다면 먼저 활성 설정을 확인하고, 이어서 오버라이드가 적용되는 순서를 살펴본 뒤 연결 기록과 대조하세요. 편집기에 표시된 원본 파일만 확인하면 클라이언트가 나중에 추가한 설정을 놓치기 쉽습니다.

업데이트 전에 어떤 변경 내역을 확인해야 하나요?

설치 패키지를 바꾸는 경우 먼저 클라이언트의 릴리스 노트를 확인하세요. 규칙 문법, DNS 동작, 가상 네트워크 인터페이스 지원과 관련된 변경은 사용 중인 코어의 변경 내역도 살펴봐야 합니다. 업데이트 전에 현재 설정과 트래픽 처리 방식을 기록하고 로컬 규칙과 오버라이드의 복사본을 저장하세요. 업데이트 후에는 같은 대상을 사용해 테스트하세요. 규칙 하나만 추가하려는 경우 프로그램, 규칙 세트, 구독을 동시에 업데이트하기보다 해당 규칙만 따로 저장하고 테스트하는 편이 변경 원인을 찾기 쉽습니다.

NOTES / LATEST

기술 노트

연결 기록이 없다면 먼저 프록시가 요청을 처리하고 있는지 확인하세요. 기록은 있지만 경로가 예상과 다르다면 모드를 살펴보세요. 클라이언트를 바꿀 때는 꼭 필요한 기능과 설정을 옮기는 방법을 먼저 확인하세요.

전체 글 보기 →