모바일 설정 · mihomo 생태계

Clash 모바일클라이언트 다운로드 및 설정

구독 가져오기부터 규칙 분기까지, 휴대폰 운영체제에 맞춰 권한과 백그라운드 설정을 완료하세요. 데스크톱 설정도 확인할 수 있습니다.

  • 중국어 사용 설명서
  • YAML 설정
  • 오픈 소스 코어

01 / CLIENTS

Clash 클라이언트 다운로드

전체 클라이언트 보기 →

먼저 기기의 운영체제를 확인한 다음 클라이언트가 지원하는 코어와 설정 형식을 살펴보세요. Clash는 생태계의 이름이며, 인터페이스가 다르다고 기능까지 같은 것은 아닙니다. 새 기기에 같은 구독을 가져온 뒤에도 정책 그룹 이름, DNS 설정, 시스템 트래픽 처리 방식을 확인해야 합니다. 처음 사용하는 경우 Clash Plus부터 가이드를 따라 해 보세요. 기존 설정이 있다면 먼저 백업한 후 교체 여부를 결정하세요.

Windows

브라우저와 업무용 앱, 데스크톱 프로그램에 적합합니다. 먼저 시스템 프록시로 기본 연결을 확인하고, 시스템 프록시를 따르지 않는 앱까지 처리해야 할 때 TUN, 즉 가상 네트워크 인터페이스 모드를 고려하세요. 다운로드 전에 프로세서 아키텍처를 확인하고, 새 프록시를 켜기 전에 기존 클라이언트를 종료해 여러 프로그램이 시스템 설정을 반복해서 바꾸지 않도록 하세요.

다운로드 페이지로 이동

Android

휴대폰에서는 먼저 VpnService 권한을 허용해야 합니다. VpnService는 Android가 제공하는 VPN 시스템 인터페이스로, 클라이언트가 트래픽을 처리할 수 있게 합니다. 원격 노드에 연결됐다는 뜻은 아닙니다. 구독을 가져온 뒤에는 백그라운드 실행도 허용하세요. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 자동 시작 권한, 다른 VPN 앱과의 충돌을 확인하세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 스토어 페이지로 이동하고 공식 웹사이트 clashplus.io도 확인할 수 있습니다. 설정을 가져온 뒤 클라이언트 안내에 따라 VPN 구성을 추가하고 시스템 인증을 진행하세요. 여기서 말하는 시스템 VPN 구성은 수동 설치가 필요한 프로파일과 다릅니다. 출처가 낯선 프로파일은 사용 목적과 출처를 먼저 확인하세요.

다운로드 페이지로 이동

macOS

먼저 '이 Mac에 관하여'에서 Apple Silicon인지 Intel인지 확인한 다음 해당 설치 파일을 선택하세요. 시스템 프록시와 TUN은 필요한 권한이 다르므로 보조 서비스를 설치할 때는 앱 출처를 확인해야 합니다. 클라이언트를 바꾼 뒤 웹페이지가 열리지 않으면 프록시 설정을 계속 추가하기보다 네트워크 설정에 이전 포트가 남아 있는지 먼저 살펴보세요.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 그래픽 클라이언트를 우선 선택하고, 서버와 라우터에는 mihomo 코어를 별도로 배포하는 방식을 고려하세요. 설치 파일 형식과 프로세서 아키텍처, 서비스 권한이 운영체제에 맞아야 합니다. 명령줄 도구는 데스크톱 프록시 설정을 사용하지 않을 수 있으므로 환경 변수를 따로 확인하세요. TUN을 켜기 전에는 라우팅과 DNS가 처리되는 범위도 알아두세요.

다운로드 페이지로 이동

02 / SETTINGS

규칙 분기와 모바일 네트워크 설정

각 스위치가 무엇을 바꾸는지 먼저 파악한 뒤 설정을 조정하세요. 자주 쓰는 항목을 기준으로 설명합니다. 규칙은 트래픽의 목적지를 정하고, 정책 그룹은 사용할 출구를 선택하며, TUN과 시스템 권한은 코어로 전달되는 트래픽을 결정합니다. 아래 설정 조각은 문법 예시일 뿐 노드가 포함된 완전한 설정이 아닙니다. 클라이언트 인터페이스의 스위치 이름은 다를 수 있습니다.

규칙은 순서대로 적용됩니다

규칙 모드는 위에서 아래로 도메인과 주소 등의 조건을 확인하고, 조건에 맞으면 지정된 정책으로 처리합니다. 직접 연결할 특정 도메인은 앞쪽에, 기본 처리용 MATCH는 마지막에 두세요. 정책 이름은 설정에 이미 존재해야 합니다. 전역 모드와 달리 모든 연결에 같은 출구를 사용할 필요가 없습니다. 휴대폰에서 특정 앱만 이상하다면 연결 기록에서 어떤 규칙이 적용됐는지 확인한 뒤 해당 항목을 수정하세요. 구독을 업데이트하면 직접 편집한 규칙이 덮어써질 수 있으므로, 계속 유지할 변경 사항은 클라이언트가 지원하는 재정의 또는 병합 기능에 추가하세요.

mode: rule
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

이 설정 조각은 기본 경로를 직접 연결로 지정하며, 규칙 적용 순서만 보여줍니다. 실제 프록시 정책은 현재 설정에 있는 이름을 사용해야 합니다.

03 / QUICK START

Clash 구독 가져오기 3단계

처음 사용할 때는 전체 연결 과정을 한 번에 확인하세요. 사용할 수 있는 설정을 준비하고, 시스템 터널을 만들고, 대상 앱에서 정상적으로 접속할 수 있어야 합니다. 우선 구독에 포함된 DNS와 규칙을 그대로 두고 여러 가이드의 설정 조각을 한꺼번에 섞지 마세요. 한 항목씩 바꿀 때마다 확인하면 나중에 문제 원인을 찾기 쉽습니다.

  1. 구독 준비 및 가져오기

    신뢰할 수 있는 서비스에서 구독 주소를 복사한 다음 클라이언트 설정 페이지에서 URL로 가져와 현재 설정으로 지정하세요. 형식 오류가 표시되면 로그인 페이지나 만료 안내가 아니라 클라이언트가 지원하는 설정이 반환되는지 먼저 확인하세요. 구독 주소를 공개 게시판에 올리지 마세요.

  2. 규칙 선택 및 권한 허용

    규칙 모드를 사용하고 정책 그룹에서 작동하는 출구를 선택한 뒤 연결을 시작하세요. 휴대폰에서는 시스템 안내에 따라 VPN 구성을 허용하고, Android에서는 백그라운드 실행 권한도 확인하세요. 시스템 프록시, TUN, 규칙 모드는 서로 다른 설정이므로 '안전하게' 쓰려고 모든 스위치를 켤 필요는 없습니다.

  3. 앱 및 화면 잠금 상태 확인

    먼저 자주 사용하는 서비스에 접속한 뒤 연결 기록에서 예상한 정책이 적용됐는지 확인하세요. 그런 다음 Wi-Fi와 모바일 데이터 사이를 한 번 전환하고, 화면을 잠갔다가 다시 켜서 테스트하세요. 화면을 잠글 때만 연결이 끊긴다면 배터리 제한을 먼저 확인하세요. 특정 도메인만 문제가 있다면 규칙과 DNS를 살펴보고 클라이언트를 서둘러 재설치하지 마세요.

전체 가이드 보기 →

04 / OPEN SOURCE

Clash 코어와 오픈 소스 생태계

클라이언트를 고를 때는 인터페이스만 보기보다 프로젝트 이름, 코어, 설정 출처를 구분하는 편이 유용합니다. 이 사이트는 다운로드 경로와 중국어 사용 자료를 정리하며, 상위 프로젝트의 릴리스 안내를 대신하거나 프록시 노드를 제공하지 않습니다. 클라이언트의 기능은 사용하는 코어와 시스템 제한, 실제 설정에 따라 달라집니다.

원본 Clash, Meta, mihomo의 관계

원본 Clash는 규칙 기반 프록시의 기본 설정 방식을 제공했습니다. Clash.Meta는 이를 확장했고 관련 코어는 이후 mihomo라는 이름으로 발전했습니다. 따라서 'Clash 설정 지원'이 모든 필드를 서로 바꿔 쓸 수 있다는 뜻은 아닙니다. 최신 프로토콜과 규칙 유형, 네트워크 스택 옵션은 코어의 지원 여부를 확인해야 합니다.

기존 설정을 이전할 때는 먼저 구독 원본을 보관하고 시작 로그에서 오류가 발생한 필드를 확인하세요. 기본 설정이 정상적으로 불러와지는지 확인한 다음 사용자 지정 규칙을 복원하세요. 오류 하나를 없애려고 DNS나 라우팅 설정 전체를 지우지 마세요. 프로그램은 시작되더라도 기존 트래픽 경로가 달라질 수 있습니다.

코어별 차이 안내 보기 →

그래픽 클라이언트와 코어의 역할

그래픽 클라이언트는 구독 가져오기, 정책 선택, 시스템 프록시, 권한 제어를 인터페이스로 제공합니다. mihomo 같은 코어는 네트워크 설정을 실행합니다. 하나의 코어가 여러 인터페이스와 함께 사용될 수 있고, 클라이언트도 업데이트하면서 코어나 기본 옵션을 변경할 수 있습니다. 스크린샷만으로 동작이 완전히 같다고 판단할 수는 없습니다.

휴대폰에는 별도의 시스템 제약도 있습니다. Android의 배터리 관리가 백그라운드 서비스를 종료할 수 있고, iOS의 VPN 구성에는 시스템 인증이 필요하며, 데스크톱은 보조 서비스에 의존할 수 있습니다. 문제가 생기면 '인터페이스가 시작되지 않음', '코어 설정 오류', '시스템 터널 미생성' 중 어디에 해당하는지 먼저 구분하면 진단이 쉬워집니다.

네트워크 및 시스템 용어 보기 →

오픈 소스 라이선스 및 소스 코드

mihomo 프로젝트는 GPL-3.0 라이선스를 따르며 공개 저장소에서 코드와 이슈 논의, 릴리스 기록을 확인할 수 있습니다. 오픈 소스 라이선스는 코드 사용과 배포 조건을 규정하며, 해당 코어를 사용하는 모든 클라이언트가 동일한 인터페이스와 기능, 유지보수 주기를 갖는다는 뜻은 아닙니다. 코드를 수정하거나 재배포하려면 해당 프로젝트의 라이선스 파일을 확인하세요.

일반 사용자는 소스 코드를 직접 빌드하지 않아도 됩니다. 설정 동작을 살펴보거나 문제를 재현하고 개발에 참여하려는 경우에 저장소를 복제하면 됩니다. 문제를 제보하기 전 구독 주소와 노드 비밀번호, 개인 네트워크 정보를 제거하고 재현에 필요한 최소 설정과 로그만 남기세요.

mihomo 프로젝트 저장소 보기 ↗

업데이트와 이전을 위한 복구 경로 확보

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 시스템 연동을 바꿀 수 있고, 코어 업데이트는 필드 동작에 영향을 줄 수 있으며, 구독 업데이트는 노드와 규칙을 대체할 수 있습니다. 문제가 생기면 최근에 어느 계층을 바꿨는지 먼저 확인하세요. 앱을 되돌리고 네트워크를 초기화하고 모든 설정을 다시 가져오는 일을 한꺼번에 하지 마세요.

평소 사용 가능한 설정과 별도의 재정의 기록을 보관하고, 업그레이드 후에는 시작, DNS 조회, 정책 그룹, 대상 앱 순으로 확인하세요. 오랫동안 유지보수가 중단된 클라이언트는 새 기기의 기본 선택지보다 이전 작업의 출발점으로 보는 편이 좋습니다. 이전을 마치고 안정성을 확인한 뒤 기존 앱과 남은 프록시 설정을 정리하세요.

업데이트가 중단된 클라이언트의 이전 경로 보기 →

mihomo 소스 코드 복제

Git이 로컬에 설치되어 있어야 합니다. 이 명령은 소스 코드만 다운로드하며 그래픽 클라이언트를 설치하거나 프록시 설정을 자동으로 만들지 않습니다. 빌드 방법과 개발 의존성은 저장소 문서를 확인하세요.

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

05 / NOTES

Clash 기술 노트

전체 글 보기 →

기본 연결이 작동한다면 클라이언트 선택과 이전, 정책 그룹 설정을 이어서 살펴보세요. 각 글은 구체적인 문제 하나를 다뤄 일부 이상을 해결하려고 전체 설정을 다시 만들지 않도록 돕습니다. 작업 전에 기존 설정을 보관하고, 글에 나온 예시는 자신의 클라이언트와 코어, 구독에 맞게 조정하세요.