Platform Downloads

운영체제별 클라이언트 선택

운영체제마다 설치 패키지와 권한 방식이 다릅니다. 먼저 현재 기기를 선택한 다음 다운로드 페이지에서 사용 가능한 클라이언트, 시스템 요구 사항과 설치 방법을 비교하세요.

Windows

일상적인 데스크톱 사용에 적합합니다. 다운로드 페이지에서 GUI 클라이언트와 설치, 설정 가져오기 및 시스템 프록시 적용 방법을 안내합니다.

다운로드 페이지로 이동

macOS

Intel 및 Apple 칩 Mac에 적합합니다. 설치 패키지를 선택하기 전에 프로세서 아키텍처를 확인하고, 클라이언트 안내에 따라 네트워크 확장 또는 시스템 프록시 권한을 허용하세요.

다운로드 페이지로 이동

Android

스마트폰, 태블릿과 일부 TV 기기에 적합합니다. 다운로드 페이지에서 일반적인 프로세서용 패키지를 구분하고 GUI 클라이언트와 구독 설정 경로를 제공합니다.

다운로드 페이지로 이동

iOS 및 iPadOS

iPhone과 iPad에 적합합니다. 클라이언트는 시스템 네트워크 확장을 통해 작동하며, 구독을 가져오고 프록시 그룹을 선택한 뒤 온디맨드 연결을 설정할 수 있습니다.

다운로드 페이지로 이동

Linux

데스크톱 Linux, 서버와 라우터 환경에 적합합니다. 일반 사용자는 GUI 클라이언트를 선택하고, 고급 사용자는 mihomo 커널 항목을 계속 확인할 수 있습니다.

다운로드 페이지로 이동

모든 클라이언트 보기 →

Core Configuration

규칙, DNS 및 온디맨드 연결

네 가지 설정 패널에서 일상적으로 가장 많이 사용하는 작업을 다룹니다. 위의 색인으로 원하는 항목을 빠르게 찾고, 실제 설정 순서에 따라 패널 내용을 확인하세요.

Traffic Mode

규칙 모드
먼저 매칭한 뒤 출구를 결정

규칙 모드는 장기간 사용하기에 적합합니다. 클라이언트는 설정 파일의 위에서부터 도메인, IP, 프로세스 또는 규칙 집합을 확인하고, 일치하는 항목을 지정된 프록시 그룹으로 처리합니다. 자주 사용하는 서비스는 직접 연결하고 프록시가 필요한 요청은 노드 선택 그룹으로 보내며, 로컬 네트워크 주소는 로컬 접속 경로로 유지할 수 있습니다.

전역 모드는 대부분의 트래픽을 하나의 프록시 그룹으로 전달하므로 노드 사용 가능 여부를 확인할 때는 간단합니다. 하지만 복잡한 설정을 판단하는 기준으로는 적합하지 않습니다. 일부 웹사이트만 열리고 다른 사이트는 열리지 않는다면 먼저 현재 모드를 확인한 다음 해당 도메인이 어떤 규칙과 일치했는지 점검하세요.

실행 모드

규칙 모드

전역 모드

로그 기록

Network Access

로컬 네트워크 및 DNS
각 계층의 적용 범위를 명확히 설정

로컬 네트워크 허용은 같은 네트워크의 다른 기기가 이 기기의 프록시 포트에 연결하도록 할 때 사용합니다. 실제로 공유가 필요할 때만 켜고, 수신 주소·시스템 방화벽·포트 설정이 일치하는지 확인하세요. iPhone의 로컬 네트워크 권한은 로컬 기기 검색과 접근에 영향을 주며, 프록시 연결 자체와는 작동 범위가 완전히 같지 않습니다.

DNS 하이재킹은 시스템의 DNS 요청을 클라이언트 DNS 모듈로 보내 규칙 판단과 DNS 결과가 어긋나지 않도록 합니다. 설정할 때는 enable, 수신 주소, 향상된 모드, 업스트림 서버와 폴백 조건을 함께 확인하세요. 주소 하나만 바꾸는 것으로는 규칙·네트워크·노드에서 발생한 문제를 해결하기 어려운 경우가 많습니다.

네트워크

로컬 네트워크 허용

DNS 하이재킹

IPv6

Subscription

구독 자동 업데이트
되돌릴 수 있는 로컬 설정 유지

구독 주소는 일반적으로 서비스 제공자가 생성하며, 클라이언트는 설정된 주기에 따라 설정을 다시 다운로드합니다. 자동 업데이트를 켜기 전에 먼저 수동 업데이트를 실행해 파일이 정상적으로 파싱되고 프록시 그룹이 열리며 규칙 참조 오류가 없는지 확인하세요. 그러면 주소 만료, 네트워크 차단과 설정 문법 문제를 구분해 판단하기 쉽습니다.

구독을 업데이트하면 원격에서 제공한 내용으로 덮어쓰며, 로컬에서 임시로 수정한 내용은 사라질 수 있습니다. 장기간 유지할 DNS·규칙·프록시 그룹 변경은 구독 원문을 직접 수정하지 말고 클라이언트가 지원하는 오버라이드 및 병합 기능을 사용하세요. 업데이트에 실패하면 먼저 주소 접근 가능 여부, 시스템 시간과 네트워크 권한을 확인하세요.

설정 구독

구독 자동 업데이트

업데이트 후 설정 적용

로컬 오버라이드 유지

On Demand

온디맨드 연결
네트워크 조건에 따른 동작 설정

온디맨드 연결은 iOS의 네트워크 조건에 따라 클라이언트를 실행합니다. 예를 들어 모바일 데이터, 지정한 Wi-Fi 또는 알 수 없는 네트워크에서 자동으로 연결할 수 있습니다. 설정하기 전에 수동 연결을 한 번 완료해 시스템에 VPN 설정이 생성되었는지 확인하고, 클라이언트가 네트워크 확장을 추가하도록 허용하세요.

규칙은 구체적인 조건에서 일반적인 조건 순서로 작성해 앞의 포괄적인 규칙이 먼저 일치하지 않도록 해야 합니다. 가정용 네트워크는 연결 해제 또는 무시로 설정하고 모바일 데이터에서는 연결하도록 설정할 수 있습니다. 연결이 자주 반복되면 먼저 중복 조건을 줄이고, 그다음 고빈도 상태 확인을 끈 뒤 저전력 모드와 시스템 백그라운드 상태를 확인하세요.

자동화

온디맨드 연결

모바일 데이터에서 연결

신뢰하는 Wi-Fi

Quick Start

iPhone에서 3단계로 시작하기

먼저 확인 가능한 가장 짧은 경로를 완료한 뒤 자동 업데이트, 오버라이드와 온디맨드 연결을 설정하세요. 그러면 문제가 어느 단계에서 발생했는지 쉽게 찾을 수 있습니다.

설치 후 네트워크 확장 권한 허용

다운로드 페이지의 iOS 영역에서 iPhone 또는 iPad에 맞는 클라이언트를 선택하세요. 처음 연결할 때 시스템에서 VPN 설정 추가를 요청합니다. 기기 암호, Face ID 또는 Touch ID로 권한을 승인하세요. 승인은 시스템 팝업에서만 확인하면 되며, 설정을 가져오기 전에 연결 스위치를 반복해서 전환하지 마세요.
구독을 가져오고 프록시 그룹 확인

유효한 구독 주소를 복사한 뒤 클라이언트의 설정 또는 구독 페이지에서 URL로 가져오기를 선택하세요. 다운로드가 끝나면 설정을 열어 프록시 그룹 이름, 규칙 목록과 DNS 섹션이 정상적으로 읽히는지 확인합니다. 그런 다음 프록시 그룹 선택 페이지에서 용도에 맞는 노드 또는 자동 프록시 그룹을 선택하세요. 설정 이름만 보고 바로 연결하지 마세요.
연결 후 규칙 일치 여부 확인

규칙 모드를 켠 뒤 연결하고, 직접 연결되어야 하는 사이트와 프록시를 거쳐야 하는 사이트를 각각 열어 보세요. 결과가 예상과 다르면 여러 설정을 연속으로 바꾸지 말고 연결 기록에서 규칙 이름과 프록시 그룹을 확인하세요. 먼저 트래픽 경로를 확인한 다음 규칙, DNS, 노드 또는 로컬 네트워크 문제인지 판단하세요.

전체 가이드 보기 →

Open Source Context

Clash 및 mihomo 오픈 소스 생태계

클라이언트, 커널과 설정 형식은 서로 다른 계층에 속합니다. 이 관계를 이해하면 인터페이스 문제, 네트워크 문제와 커널 문제를 한데 섞어 점검하는 일을 줄일 수 있습니다.

프로젝트 역사와 설정 호환성

Clash는 널리 사용되는 YAML 설정 구조를 정립했으며, 일반적인 항목에는 프록시 노드, 프록시 그룹, 규칙, DNS와 실행 포트가 포함됩니다. 원 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 이 설정 방식을 이어 갔고, 호환 구현·규칙 데이터·GUI 클라이언트를 중심으로 개발을 계속했습니다. 따라서 기존 가이드의 기본 개념은 여전히 참고할 수 있지만, 구체적인 필드 지원 여부는 현재 커널 문서를 기준으로 확인해야 합니다.

mihomo 및 GUI 클라이언트

mihomo는 지속적으로 유지 관리되는 Clash 호환 커널 중 하나로, 설정을 파싱하고 프록시 연결을 만들며 규칙을 실행하고 DNS를 처리합니다. Windows, macOS, Android, iOS와 Linux의 GUI 클라이언트는 일반적으로 커널 외부에서 구독 관리, 시스템 프록시, 네트워크 확장, 로그 확인과 프록시 그룹 전환 기능을 제공합니다. 인터페이스 명칭은 달라도 기본 개념은 대체로 같습니다.

오픈 소스 코드와 문제 분석

코드가 공개되어 있으면 설정 필드, 동작 변화와 알려진 문제를 커뮤니티가 검토할 수 있습니다. 이상이 발생하면 먼저 운영체제, 클라이언트 이름, 사용한 모드, 설정 출처와 재현 절차를 기록한 다음 클라이언트 프로젝트를 볼지 커널 프로젝트를 볼지 결정하세요. 단순히 “사용할 수 없음”이라고 제보하는 것만으로는 문제를 찾기 어렵습니다. 로그의 필드 오류, 규칙 이름과 네트워크 상태가 원인 판단에 더 유용합니다.

업데이트 방식과 호환 범위

클라이언트 업데이트, 커널 업데이트와 구독 업데이트는 서로 독립된 경로입니다. 클라이언트 업데이트는 주로 인터페이스와 시스템 통합을 바꾸고, 커널 업데이트는 지원 필드와 네트워크 동작을 바꿀 수 있으며, 구독 업데이트는 서비스 제공자가 내려보낸 노드·프록시 그룹·규칙을 교체합니다. 변화가 생겼을 때는 한 번에 한 계층만 조정하고 이전에 작동하던 설정을 보관하세요. 그래야 되돌리기와 비교가 더 명확해집니다.

mihomo source

git clone https://github.com/MetaCubeX/mihomo.git

Common Checks