오픈 소스 코어 · 모든 플랫폼 클라이언트

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

Clash 다운로드 가이드 보기

현재 운영체제에 맞는 클라이언트부터 시작해 구독 가져오기, 규칙 분기, 시스템 프록시를 차례로 설정하세요. Mihomo 코어, 그래픽 클라이언트, 설정 파일의 관계도 함께 설명해 문제에 맞는 자료를 빠르게 찾을 수 있습니다.

영구 무료 오픈 소스 한국어 문서
CORE mihomo LICENSE GPL-3.0 PLATFORMS 5 CONFIG YAML

설정 자료 브라우저

설정을 먼저 이해한 다음 시스템 프록시를 켜세요

클라이언트 화면은 조작을 담당하고, Mihomo 코어는 연결을 처리하며, 설정 파일은 코어에 트래픽을 어떻게 분기할지 알려줍니다. 다음 네 가지 자료는 일상적으로 가장 자주 접하는 설정을 다룹니다.

config.yaml

설정 파일은 코어의 실행 지침입니다

mixed-port: 7890
mode: rule
log-level: info
allow-lan: false

Clash 클라이언트에서 구독을 가져오면 원격 콘텐츠가 전환 가능한 Profile로 저장되고 Mihomo 코어가 이를 불러옵니다. 설정에는 포트, 프록시 노드, 정책 그룹, 규칙, DNS 등의 항목이 포함됩니다. 처음부터 빈 파일을 작성할 필요 없이 서비스 제공업체의 구독을 먼저 가져온 뒤 클라이언트에 “설정이 유효함”으로 표시되는지 확인하세요. 직접 수정해야 한다면 먼저 설정을 복사해 두어 구독 업데이트로 로컬 변경 사항이 덮어써지지 않게 하세요.

고정된 스위치만 제공하는 네트워크 도구와 달리 YAML 설정은 각 요소의 관계를 명확히 표현하고 이전과 문제 해결도 쉽습니다. 시작에 실패하면 먼저 로그에 표시된 항목과 줄 번호를 확인한 다음 들여쓰기, 콜론 뒤 공백, 목록 계층을 점검하세요. 설정이 성공적으로 로드된 것은 첫 단계일 뿐이며, 이후 정책 그룹을 선택하고 시스템 프록시를 켜야 합니다.

구독 가져오기 단계 알아보기 →

클라이언트 다운로드

운영체제에 맞는 Clash 클라이언트 선택

그래픽 클라이언트는 데스크톱과 모바일 기기의 일상적인 사용에 적합합니다. 서버, 라우터, 자동화 환경에서는 Mihomo 코어를 직접 사용하는 방법을 고려하세요.

Windows

데스크톱에서 상시 사용하기 좋습니다. 다운로드 전에 기기 아키텍처를 확인하고, 설치 후 시스템 프록시, 혼합 포트, 시작 시 자동 실행 옵션을 중점적으로 점검하세요. 이전 클라이언트가 실행 중이라면 먼저 종료해 여러 프로그램이 프록시 포트를 동시에 사용하는 일을 방지하세요.

다운로드하기

macOS

Intel 또는 Apple Silicon에 맞는 설치 패키지를 선택하세요. 처음 실행할 때 시스템 설정에서 권한을 확인해야 할 수 있습니다. 프록시를 켠 뒤에는 다른 네트워크 도구, 브라우저 확장 프로그램, 시스템 VPN이 연결 경로를 동시에 바꾸고 있지 않은지도 확인하세요.

다운로드하기

Android

모바일 기기는 보통 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. 구독을 가져와 시작한 뒤 상태 표시줄에 연결 상태가 나타나는지 확인하세요. 백그라운드 절전 제한으로 클라이언트 프로세스가 종료될 수 있으므로 장시간 사용할 때는 시스템 설정에서 안정적으로 실행되도록 허용하세요.

다운로드하기

iOS

App Store에서 Mihomo 설정을 지원하는 클라이언트를 받으세요. 처음 네트워크 설정을 추가하면 시스템에서 확인을 요청합니다. 가져온 후에는 먼저 정책을 선택하고 연결을 시작한 다음, 클라이언트 로그에서 구독 업데이트와 규칙 로드가 성공했는지 확인하세요.

다운로드하기

Linux

데스크톱 사용자는 그래픽 인터페이스가 있는 클라이언트를 선택할 수 있고, 서버 사용자는 Mihomo 코어를 직접 실행할 수 있습니다. 배포 전에 배포판, 프로세서 아키텍처, 설정 경로, 서비스 권한을 확인하고 로그와 설정 업데이트를 위한 명확한 디렉터리를 마련하세요.

다운로드하기

전체 클라이언트 보기 →

빠른 시작

가져오기, 선택, 확인 세 단계로 기본 연결 완료

먼저 기본 연결을 한 번 정상적으로 완료한 뒤 규칙, DNS, LAN 공유 같은 고급 설정을 다루세요. 한 번에 하나씩 변경하면 문제를 더 명확하게 추적할 수 있습니다.

  1. 01

    구독 설정 가져오기

    클라이언트의 설정 또는 Profile 페이지를 열고 전체 구독 주소를 붙여 넣은 다음 다운로드를 실행하세요. 가져온 후 수동으로 한 번 업데이트해 설정 이름, 정책 그룹, 규칙이 모두 표시되는지 확인하세요. 형식 오류가 표시되면 먼저 링크가 잘리지 않았는지 확인하고, 일반 웹페이지 주소를 구독 주소로 사용하지 마세요.

  2. 02

    정책과 모드 선택

    프록시 또는 정책 그룹 페이지로 이동해 사용할 수 있는 정책을 선택하세요. 실행 모드는 우선 “규칙”으로 설정하면 구성에 따라 직접 연결과 프록시를 분기합니다. 테스트 중에는 DNS, 포트, 규칙을 동시에 변경하지 마세요. 문제가 생겼을 때 어떤 설정이 영향을 주었는지 판단하기 어려워집니다.

  3. 03

    프록시를 켜고 확인하기

    데스크톱에서는 시스템 프록시를 켜고, 모바일에서는 시스템 VPN 연결을 시작하세요. 그런 다음 외부 사이트에 접속해 클라이언트 연결 기록에 요청이 나타났는지, 규칙이 매칭되었는지, 정책이 선택되었는지 확인하세요. 웹페이지는 열리지만 기록이 비어 있다면 시스템 프록시가 실제로 클라이언트 포트를 가리키는지 먼저 점검해야 합니다.

전체 가이드에서는 설정 업데이트, 모드 전환, 출구 연결 확인, 자주 발생하는 실패 현상의 처리 순서도 다룹니다.

전체 가이드 보기 →

오픈 소스 생태계

Mihomo 코어, 클라이언트, 설정 자료의 관계

Clash 클라이언트가 자신에게 맞는지 판단할 때는 화면만 보면 안 됩니다. 코어의 출처, 설정 호환성, 업데이트 경로, 문제의 경계를 함께 구분해야 합니다.

프로젝트 발전과 코어의 역할

Mihomo는 Clash Meta 프로젝트가 이어서 사용하는 코어 이름으로, 로컬 포트 수신, 설정 해석, 프록시 연결 수립, 규칙 매칭, DNS 처리를 담당합니다. 사용자가 평소 보는 창, 트레이 메뉴, 구독 관리, 시스템 프록시 버튼은 대부분 상위 그래픽 클라이언트가 제공합니다. 코어와 클라이언트는 같은 소프트웨어 패키지가 아니므로 두 클라이언트가 모두 Mihomo를 사용하더라도 설치 방식, 설정 메뉴, 시스템 통합 방식은 다를 수 있습니다.

오픈 소스 생태계의 역할 분담

코어 유지 관리자는 프로토콜 구현, 설정 항목, 네트워크 동작, 실행 안정성을 담당하고, 클라이언트 유지 관리자는 이러한 기능을 데스크톱이나 모바일 시스템에 맞는 화면으로 구성합니다. 구독 서비스 제공업체는 노드, 정책 그룹, 규칙을 생성합니다. 문제가 발생하면 먼저 어느 계층의 문제인지 판단하세요. 화면이 열리지 않으면 클라이언트 계층, 설정 해석 실패는 대개 YAML 또는 항목 호환성 문제, 노드 시간 초과는 연결 계층, 웹사이트가 잘못된 정책을 사용하면 규칙 매칭을 확인해야 합니다.

설정 호환성과 이전 방법

Mihomo는 비교적 완전한 Clash 설정 구조를 지원하지만, 클라이언트마다 원본 설정 외에 자체 화면 설정을 저장할 수 있습니다. 예를 들어 시작 시 자동 실행, 창 동작, 시스템 프록시 스위치는 보통 구독 파일에 기록되지 않습니다. 클라이언트를 이전할 때는 구독 주소, 로컬 오버라이드 규칙, 클라이언트 환경설정을 각각 백업하세요. 설정 파일 하나만 복사하면 모든 설정이 따라온다고 가정하지 마세요. 다시 가져온 뒤 정책 그룹, DNS, 시스템 프록시 상태를 항목별로 확인하는 편이 안전합니다.

업데이트 방식과 문제 재현

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 경로입니다. 클라이언트 업그레이드는 주로 화면과 시스템 통합을 바꾸고, 코어 업그레이드는 설정 항목을 추가하거나 네트워크 동작을 수정할 수 있으며, 구독 업데이트는 노드, 규칙, 정책 그룹을 교체합니다. 문제를 해결할 때 플랫폼, 클라이언트 이름, 설정 출처, 실행 모드, 주요 로그를 기록하면 불필요한 시도를 줄일 수 있습니다. 업데이트 후 이상이 생겼다면 먼저 어느 계층에서 변화가 발생했는지 확인한 다음 설정을 되돌릴지 클라이언트 환경설정을 점검할지 결정하세요.

자주 묻는 질문

증상에 따라 먼저 해결 방향을 정하세요

구독을 가져온 뒤 선택할 수 있는 정책이 없는 이유는 무엇인가요?

현재 Profile을 먼저 수동 업데이트하고, 구독 주소가 로그인 페이지나 일반 웹페이지가 아닌 Clash YAML 설정을 반환하는지 확인하세요. 설정은 로드되지만 정책이 비어 있다면 클라이언트 로그의 해석 메시지를 확인한 뒤 사용 가이드에서 가져오기 절차를 점검하세요.

클라이언트를 켰는데도 웹페이지가 직접 연결되는 이유는 무엇인가요?

데스크톱에서는 코어가 실행 중인지와 시스템 프록시가 켜져 있는지를 모두 확인해야 합니다. 브라우저에서 별도의 프록시 확장 프로그램을 사용한다면 시스템 설정을 덮어쓰고 있지 않은지도 점검하세요. 클라이언트 연결 기록을 열고 웹페이지를 새로 고치세요. 기록이 비어 있다면 대개 트래픽이 아직 클라이언트로 들어오지 않은 것입니다.

규칙 모드와 전역 모드 중 무엇을 선택해야 하나요?

일상적인 사용에는 규칙 모드를 우선 선택해 각 연결을 설정에 따라 분기하세요. 전역 모드는 노드가 작동하는지 임시로 확인할 때 적합하며, 모든 문제의 고정 해결책으로 사용하는 것은 권장하지 않습니다. 테스트가 끝나면 규칙 모드로 돌아와 구체적인 규칙 매칭을 확인하세요.

설정을 업데이트한 뒤 수정한 내용이 사라지는 이유는 무엇인가요?

구독 업데이트는 보통 원격 설정을 다시 기록하므로 로컬에서 직접 편집한 내용이 교체될 수 있습니다. 오래 보존해야 하는 변경 사항은 클라이언트의 오버라이드 기능을 사용하거나 별도의 설정 사본으로 관리하세요. 작업 전에 기존 값을 기록해 두면 문제가 생겼을 때 복구하기 쉽습니다.

기술 노트

설정 관리와 문제 위치 추적 기록

각 글은 하나의 구체적인 문제를 중심으로 재현 가능한 확인 절차를 제시합니다. 증상에 맞는 주제를 먼저 확인한 뒤 순서대로 진행하세요.

시작하기

Clash 설정 파일 Profile이란? 여러 설정 전환 및 관리 방법

Profile, 구독 링크, config.yaml의 관계를 설명하고 여러 설정의 이름 지정, 전환, 업데이트, 정리 방법을 정리해 잘못된 설정을 수정하거나 로컬 내용이 덮어써지는 일을 줄입니다.

전체 글 읽기 →
문제 해결

Clash 포트가 사용 중일 때 해결 방법: 7890 충돌 프로세스 찾기 및 혼합 포트 변경

Windows, macOS, Linux에서 자주 쓰는 명령으로 포트를 점유한 프로세스를 찾고, mixed-port 변경 후 시스템 프록시를 함께 확인하는 방법을 설명합니다. 포트는 바꿨지만 트래픽 진입점이 이전 값을 가리키는 문제를 방지할 수 있습니다.

전체 글 읽기 →
형식과 선택

Clash 구독 형식 정리: YAML, Base64 공유 링크, sing-box JSON 상호 변환 방법

자주 사용하는 구독 형식의 구조와 식별 방법을 비교하고, 변환 전에 보존해야 할 항목과 변환 후 다시 확인해야 할 정책 그룹, 규칙, DNS, 프로토콜 매개변수를 설명합니다.

전체 글 읽기 →

전체 글 보기 →