mihomo 생태계 · 설정 및 문제 해결 노트

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

Clash 다운로드 가이드 보기

구독 가져오기부터 규칙 기반 라우팅까지, 설정 항목별로 DNS와 TUN을 확인하세요.

오픈 소스YAML 설정한국어 사용 가이드
운영체제 선택
Windows Android iOS macOS Linux

CONFIG / 문제 해결 대기열

규칙, TUN 및 DNS 설정

먼저 트래픽이 코어에 들어오는지, 들어온 뒤 어떤 규칙을 따르는지 구분하세요. 아래 설정 조각은 각 항목을 확인하기 위한 예시이며, 단독으로 실행할 수 있는 완성된 구독 설정은 아닙니다. 프록시 그룹 이름은 기존 설정과 일치해야 합니다. 예시에 있는 PROXY는 실제로 존재하는 그룹 이름으로 바꿔야 합니다.

규칙은 순서대로 적용되므로 구체적인 도메인을 먼저 배치하세요

규칙 모드는 한 기기에서 직접 연결과 프록시를 함께 사용할 때 적합합니다. 실행 모드를 rule로 설정하고, 먼저 명시적으로 처리할 도메인을 입력한 다음 지역 규칙을 추가하고 마지막에 MATCH로 나머지 요청을 처리하세요. 전역 모드와 달리 모든 요청을 하나의 프록시 그룹으로 보내지 않으며, 직접 연결 모드와 달리 설정된 라우팅 규칙을 적용합니다. 대상 사이트에 접속한 뒤 연결 기록에서 적용된 규칙과 실제 연결 경로를 확인하세요. 예시의 강조 행은 다른 규칙에 해당하지 않는 요청만 처리하며, 모든 요청에 적용되는 것은 아닙니다.

config.yaml · 규칙 설정 예시
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

문제 해결 순서: 설정을 불러올 수 있는지 확인하고, 리스닝 포트를 점검한 다음 앱 트래픽이 코어에 들어오는지 확인하세요. 마지막으로 규칙과 DNS를 살펴보면 됩니다. 로그에 해당 연결이 없다면 아직 노드 선택 단계까지 도달하지 않았을 가능성이 큽니다. 먼저 트래픽이 들어오는 경로를 연결한 뒤 나가는 경로를 확인하면 불필요한 시행착오를 줄일 수 있습니다.

설정 예시는 mihomo를 기준으로 하며, 그래픽 클라이언트가 일부 항목을 생성하거나 덮어쓸 수 있습니다. 플랫폼별 설치 경로, 서비스 권한, 시스템 제한은 전체 플랫폼 가이드를 확인하세요. 처음 연결하는 방법만 궁금하다면 구독 가져오기 가이드부터 살펴보세요.

PACKAGES / 운영체제별 클라이언트

Clash 전체 플랫폼 다운로드

클라이언트는 화면, 설정 관리, 시스템 연동을 담당하고 코어는 프로토콜 처리와 규칙 적용을 담당합니다. 운영체제와 CPU 아키텍처를 먼저 확인한 뒤 유지 관리 상태와 기능 지원 여부를 비교하세요. Clash 튜토리얼은 다운로드 경로와 설정 방법을 정리한 안내 사이트로, 각 클라이언트의 공식 사이트가 아니며 프록시 서비스나 구독 계정을 제공하지 않습니다.

Windows

먼저 Clash Plus를 살펴보고, 사용 방식에 따라 Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. 다운로드 전 운영체제와 설치 권한을 확인하세요. 처음 실행하면 설정을 가져온 뒤 시스템 프록시를 켜면 됩니다. TUN이 필요하다면 서비스 모드가 제대로 설치됐는지 확인해 권한 오류를 구독 만료로 오해하지 않도록 하세요.

다운로드 페이지로 이동 →

macOS

먼저 ‘이 Mac에 관하여’에서 Apple Silicon인지 Intel인지 확인한 뒤 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 인터페이스와 유지 관리 상태를 비교해 고를 수 있습니다. 처음 실행할 때 macOS 보안 경고가 표시되면 시스템 설정에서 안내하는 권한 승인 절차를 따르세요. 한 앱 때문에 보안 기능 전체를 끄지 마세요.

다운로드 페이지로 이동 →

Android

Clash Plus를 먼저 확인하고 Clash Meta for Android, FlClash, Surfboard의 설정 호환성을 비교해 보세요. 처음 연결할 때 시스템 VPN 권한이 필요합니다. 앱을 백그라운드로 보낸 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 설치 파일의 아키텍처가 기기와 일치해야 하며, 설정 형식도 선택한 클라이언트와 호환되어야 합니다.

다운로드 페이지로 이동 →

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 지원되는 구독 또는 설정을 가져오고 VPN 구성 추가를 허용하세요. 시스템에 VPN 연결됨으로 표시되어도 터널이 만들어졌다는 뜻일 뿐입니다. 실제 웹사이트에 접속해 규칙과 연결 경로가 예상대로 작동하는지 확인하세요.

다운로드 페이지로 이동 →

Linux

데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 사용하세요. 데스크톱 환경이 없는 서버와 라우터에는 mihomo 코어를 직접 실행하는 방법이 더 적합합니다. 그래픽 인터페이스의 시스템 프록시 설정이 터미널 프로그램에 적용되지 않을 수 있으므로 환경 변수, 앱별 프록시 설정, TUN을 함께 확인해 실제 트래픽 경로를 파악하세요.

다운로드 페이지로 이동 →

보관된 클라이언트는 이전 설정을 이해하는 데 도움이 될 수 있지만, 익숙한 예전 인터페이스만 보고 유지 관리 상태를 간과해서는 안 됩니다. mihomo 생태계로 옮길 때는 프로토콜 항목, 프록시 그룹 참조, DNS 설정을 중점적으로 확인하세요. 파일을 가져올 수 있다고 해서 모든 항목이 적용되는 것은 아닙니다. 프록시 클라이언트를 여러 개 동시에 실행하면 포트나 라우팅이 충돌할 수 있으므로 처음 확인할 때는 하나만 실행하세요.

전체 클라이언트 보기 → · 클라이언트 비교 및 리뷰 보기 →

QUICKSTART / 첫 연결 최소 단계

구독 가져오기와 첫 연결: 세 단계로 확인

먼저 가장 단순한 연결 경로부터 확인한 뒤 오버라이드, 사용자 지정 규칙, TUN을 추가하세요. 지원되는 구독 주소와 인터넷에 연결된 기기, 기존 설정 백업을 준비합니다. 클라이언트 자체가 사용할 수 있는 노드를 만들어 주지는 않습니다. 설치가 끝났다고 프록시 서비스를 이용할 수 있는 것은 아닙니다.

  1. 구독을 가져와 현재 설정으로 선택

    클라이언트의 설정 또는 구독 페이지에서 원격 주소를 추가하고 업데이트하세요. 노드와 프록시 그룹이 표시되면 해당 설정을 현재 사용 설정으로 선택합니다. 목록이 비어 있다면 업데이트 로그의 상태 코드와 파싱 오류부터 확인하세요. 구독 링크에 계정 식별 정보가 포함될 수 있으므로 전체 주소가 보이는 화면을 공개하지 마세요. 이 단계에서는 DNS를 수정하지 말고 되돌릴 수 있는 기준점을 남겨 두세요.

  2. 규칙 모드를 선택하고 트래픽 진입 경로를 켜세요

    규칙 모드를 선택하고 프록시 그룹에서 사용 가능한 연결 경로를 지정한 뒤 시스템 프록시를 켜세요. 데스크톱 브라우저는 보통 이 방법으로 첫 연결을 테스트할 수 있으며, 모바일에서는 안내에 따라 VPN 권한을 허용하세요. 특정 앱이 시스템 프록시를 사용하지 않는다면 TUN을 별도로 검토하세요. 전역 모드를 바꾸면서 포트와 라우팅까지 동시에 수정하지 마세요. 그래야 연결에 성공했을 때 어떤 설정이 영향을 주었는지 파악할 수 있습니다.

  3. 웹페이지에 접속해 연결 및 규칙 기록을 확인하세요

    프록시를 사용해야 하는 대상과 직접 연결해야 하는 대상에 각각 접속해 연결 화면의 도메인, 적용된 규칙, 프록시 경로를 확인하세요. 웹페이지가 열리지 않으면 오류 내용을 기록하세요. DNS 조회 실패, 연결 시간 초과, 인증서 오류는 각각 확인할 부분이 다릅니다. 테스트가 끝나면 프록시를 끄고 다시 접속해 시스템 프록시가 정상적으로 복구되는지 확인하세요. 스위치 색상만 바뀐 것은 검증이 아닙니다. 설정 파일도 저장했다고 해서 자동으로 올바르게 작동하는 것은 아닙니다.

전체 가이드 보기 →

SOURCE / 코어와 프런트엔드의 역할

Clash 오픈 소스 생태계와 mihomo 코어

클라이언트를 장기간 사용하기에 적합한지 판단하려면 어떤 코어를 사용하는지, 설정을 어떻게 업데이트하는지, 오류가 발생했을 때 실행 로그를 확인할 수 있는지 살펴보세요. 이름이 비슷하다고 같은 개발자가 관리하거나 기능과 업데이트 주기가 같다는 뜻은 아닙니다.

오리지널 Clash에서 mihomo까지

오리지널 Clash 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 호환되는 규칙 문법과 설정 구조를 중심으로 발전을 이어 왔습니다. mihomo는 Clash.Meta의 기술 계보를 이어받아 프로토콜, 라우팅, DNS 등의 기능을 유지 관리합니다. 이 가이드에 등장하는 Clash, Clash Meta, mihomo는 역사적으로 연결되어 있지만 같은 소프트웨어 이름으로 취급할 수는 없습니다. 이전 가이드의 설정 항목, 전용 기능, 플랫폼 제한은 현재 코어 문서와 대조해 확인해야 합니다.

그래픽 클라이언트와 코어는 서로 다른 역할을 맡습니다

Clash Verge Rev, FlClash, Clash Nyanpasu 등의 프런트엔드는 구독 관리, 트레이 메뉴, 시스템 프록시, 서비스 연동 기능을 제공합니다. 실제 연결을 만들고 규칙을 처리하며 트래픽을 관리하는 것은 코어입니다. 프런트엔드가 업데이트되어도 프로토콜 구현이 바뀌지 않을 수 있습니다. 반대로 코어를 교체하면 화면은 그대로여도 지원하는 설정 항목이 달라질 수 있습니다. 오류를 제보할 때는 클라이언트 이름, 운영체제, 코어 정보를 함께 기록해야 문제를 담당하는 계층을 파악하기 쉽습니다.

오픈 소스 라이선스 및 프로젝트 자료

mihomo 저장소의 코드는 GPL-3.0 라이선스로 공개되어 있으며 소스 파일, 커밋 기록, 이슈 토론을 통해 기능의 출처를 확인할 수 있습니다. 코드를 검토할 수 있다고 해서 모든 설정이 안전한 것은 아닙니다. 리스닝 주소를 외부에 공개하거나 LAN 접근 또는 제어 인터페이스를 활성화했다면 접근 범위를 직접 확인해야 합니다. 규칙과 구독도 입력 데이터이므로 출처가 불분명한 설정으로 장기간 사용하는 구성을 덮어쓰지 마세요. 제어 인터페이스의 인증 정보도 다른 사람에게 공유하지 마세요.

프로그램 업데이트와 구독 업데이트를 구분하세요

프로그램 업데이트는 인터페이스나 코어 문제를 수정하고, 구독 업데이트는 노드와 규칙을 동기화합니다. GeoIP 및 GeoSite 데이터 업데이트는 지역 기반 라우팅 결과에 영향을 줍니다. 세 가지는 서로 다른 작업입니다. 업데이트 전에 정상 작동하는 설정을 보관하고, 업데이트 후에는 시작 로그와 주요 사이트에 적용되는 규칙을 확인하세요. 구독 응답 오류라면 클라이언트를 반복해서 재설치해도 대개 해결되지 않습니다. 설정 항목이 호환되지 않는다면 실행 중인 코어가 해당 설정을 지원하는지 확인하세요.

증상에 맞는 자료 찾기: mixed-port와 제어 인터페이스의 차이가 궁금하다면 용어 설명을 확인하세요. 가져오기는 성공했지만 연결되지 않는다면 자주 묻는 질문을 살펴보세요. 플랫폼별 시스템 프록시, 권한, 백그라운드 실행 제한을 확인해야 한다면 전체 플랫폼 설치 및 설정 가이드를 참고하세요. 이 사이트는 재현 가능한 작업 절차와 설정 설명을 중심으로 하며, 다운로드 수나 평점을 기술적 근거로 내세우지 않습니다.

FIELD NOTES / 최신 문제 해결 노트

Clash 설정 및 문제 해결 가이드

빠른 가이드에서 첫 연결을 설정했다면, 아래 노트에서는 연결 이후 발생하는 세부 문제를 다룹니다. 읽기 전에 ‘브라우저에서는 접속되지만 터미널에서는 안 됨’, ‘규칙은 맞는데 도메인 조회가 시간 초과됨’처럼 확인 가능한 질문으로 증상을 정리하세요. 설정 전체를 한꺼번에 복사하는 것보다 근거를 바탕으로 범위를 좁히는 편이 효과적입니다.

DNS 설정을 변경할 때는 변경 전후의 조회 결과와 브라우저의 보안 DNS 사용 여부를 기록하세요. 규칙을 수정할 때는 대상 도메인과 실제로 적용된 규칙 행을 남기세요. 로그에는 빨간 아이콘만 찍기보다 ‘어디서 실패했는지’가 드러나야 합니다. 공유하기 전에 계정 관련 정보를 지우세요. 재현 절차가 짧을수록 문제를 찾기 쉽습니다.

전체 글 보기 →