mihomo 코어·전 플랫폼 클라이언트

Clash 다운로드 센터 전 플랫폼 클라이언트 및 구독 설정

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기, 규칙 기반 라우팅, TUN 모드를 설정하세요.

오픈 소스 생태계 한국어 사용 가이드 증상별 문제 해결

Clash 설정 주요 항목

설정 출처부터 트래픽 처리까지 항목별로 살펴보세요. 탭을 클릭하면 자동 전환이 멈춥니다.

Clash 다운로드 센터 CONFIG EDITOR

구독 링크 가져오기 및 업데이트

구독 링크는 설정 파일을 가져오는 데 사용됩니다. 클라이언트를 설치해도 사용할 수 있는 프록시가 자동으로 생성되지는 않습니다. ‘구독’ 또는 ‘설정’을 열고 서비스 제공업체가 안내한 전체 주소를 붙여 넣은 다음 ‘가져오기’를 선택하세요. 다운로드가 끝나면 해당 설정을 현재 설정으로 지정하고, ‘프록시’ 화면에서 프록시 그룹이 표시되는지 확인합니다. 업데이트는 원본 내용을 다시 가져오는 기능이며, 사용할 수 없는 서비스를 자동으로 복구하지는 않습니다. 규칙을 변경하려면 다음 업데이트 때 덮어써지지 않도록 구독 파일을 직접 수정하기보다 클라이언트의 오버라이드 기능을 이용하세요. 링크에 포함된 토큰은 접근 자격 증명이므로 화면을 캡처하거나 도움을 요청할 때 가려야 합니다.

# 클라이언트 설정 예시
구독 → 새로 만들기 → 원격 링크
가져오기 완료 → 현재 설정 선택
자동 업데이트 → 제공업체 권장값으로 설정
가이드 보기 →

Clash 플랫폼별 다운로드

운영체제와 프로세서 아키텍처를 먼저 확인한 다음 다운로드 페이지에서 클라이언트와 설치 패키지를 살펴보세요.

호환되는 설정 형식을 지원하는 클라이언트라면 같은 구독을 사용할 수 있지만, 설치 패키지는 운영체제 간에 공용으로 쓸 수 없습니다. 데스크톱에서는 기기의 아키텍처와 시스템 요구 사항을, 모바일에서는 시스템 권한과 설정 형식을 먼저 확인하세요. 아래 링크를 누르면 해당 플랫폼의 다운로드 페이지로 이동합니다. 다운로드 페이지에서 선택 가능한 클라이언트, 유지 관리 상태, 설치 안내를 확인할 수 있습니다. 소프트웨어와 파일 선택이 뒤섞이지 않도록 홈 화면에는 구체적인 패키지 목록을 반복해서 표시하지 않습니다.

Windows

트레이 관리, 시작 시 자동 실행, 시스템 프록시가 필요한 데스크톱 환경에 적합합니다. Clash Plus를 먼저 살펴보거나 Clash Verge Rev 등 다른 클라이언트의 기능과 시스템 요구 사항을 비교해 보세요.

설치 전에 ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하세요. 처음 실행한 뒤 설정을 가져오고 시스템 프록시를 켭니다. 시스템 프록시를 사용하지 않는 앱의 트래픽도 처리해야 한다면 가이드를 참고해 서비스를 설치한 뒤 TUN을 사용해 보세요. 시스템 경고로 설치가 차단되면 출처와 구체적인 안내 내용을 먼저 확인하고, 보안 기능 전체를 바로 끄지 마세요.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 패키지를 선택한 뒤 메뉴 막대 사용법, 구독 관리, 서비스 권한 설정을 비교하세요. Clash Plus, Clash Verge Rev 등의 다운로드 링크는 다운로드 페이지에 모아 두었습니다.

‘이 Mac에 관하여’에서 칩 종류를 확인할 수 있습니다. 설치 후 앱을 ‘응용 프로그램’으로 옮기고 안내에 따라 네트워크 또는 서비스 권한을 허용하세요. 시스템 프록시와 TUN은 서로 다른 트래픽 처리 방식이므로 처음부터 둘 다 켤 필요는 없습니다. 기존 설정을 옮길 때는 현재 기기를 가리키는 경로와 포트를 먼저 확인해 다른 기기의 환경 설정까지 가져오지 않도록 하세요.

다운로드 페이지로 이동

Android

시스템 VPN 인터페이스를 통해 앱 연결을 처리하는 데 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Meta for Android, FlClash, Surfboard를 확인할 수 있으며, 설정 호환 여부는 각 클라이언트의 지원 범위를 따릅니다.

먼저 기기의 아키텍처를 확인하세요. 확실하지 않으면 시스템 정보나 다운로드 페이지의 안내를 살펴보세요. 구독을 가져온 뒤 현재 설정을 선택하고 시작을 누른 다음 VPN 연결 요청을 허용합니다. 백그라운드로 전환한 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 기기에 다른 VPN이 연결되어 있다면 기존 연결을 먼저 끊고 현재 클라이언트를 테스트해야 구독 문제로 잘못 판단하지 않습니다.

다운로드 페이지로 이동

iOS

Clash Plus는 App Store에서 설치할 수 있으며 공식 웹사이트는 clashplus.io입니다. 먼저 다운로드 페이지에서 App Store 상세 페이지로 이동해 기기 호환성을 확인한 뒤 앱의 설정 메뉴에서 구독을 가져오세요.

처음 연결할 때 VPN 설정 추가를 허용해야 합니다. 연결된 뒤 대상 앱으로 돌아가 실제 접속이 되는지 확인하세요. 시스템에 VPN 아이콘이 표시되어도 터널이 활성화되었다는 뜻일 뿐, 모든 규칙과 프록시가 정상 작동한다는 의미는 아닙니다. 다른 네트워크 도구를 사용한다면 현재 적용 중인 VPN 설정을 확인하세요. 구독 형식에 관한 안내가 표시되면 앱의 지원 범위에 맞는 출처인지 확인하고, 데스크톱 전용 설정을 범용 파일처럼 사용하지 마세요.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 Clash Verge Rev와 FlClash를 비교하고 배포판에서 지원하는 패키지 형식을 선택할 수 있습니다. 서버, 라우터, 게이트웨이 환경에서는 데스크톱 설치 절차를 적용하지 말고 mihomo 코어 배포 자료를 확인하세요.

설치 전에 배포판, 프로세서 아키텍처, 그래픽 환경을 확인하세요. 데스크톱의 시스템 프록시 설정은 모든 터미널 프로그램에 자동으로 적용되지 않습니다. 명령줄 앱에는 프록시 환경 변수를 별도로 설정하거나, 라우팅에 미치는 영향을 파악한 뒤 TUN을 사용해야 합니다. 코어를 직접 실행하려면 설정 디렉터리, 서비스 권한, 시작 관리도 필요합니다. 원격으로 네트워크를 변경할 때는 기존 세션을 유지하고 서비스를 중지해 되돌릴 방법을 마련하세요.

다운로드 페이지로 이동

전체 클라이언트 보기 →

Clash 생태계와 mihomo 코어

프로젝트, 클라이언트, 설정 출처를 구분하면 업데이트와 문제 해결의 대상을 명확히 할 수 있습니다.

프로젝트의 역사와 자료 범위

Clash는 처음에 규칙 기반 프록시 코어를 중심으로 시작했으며, 이후 데스크톱과 모바일용 클라이언트가 다양하게 등장했습니다. 원 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티는 호환 가능한 설정 형식을 바탕으로 여러 구현을 개발해 왔습니다. Clash Meta는 이 과정에서 자주 쓰인 이름이며, mihomo는 현재 관련 코어 프로젝트의 이름입니다. 오래된 가이드를 검색하면 여러 명칭이 함께 등장할 수 있습니다. 내용이 현재 환경에 적용되는지 판단할 때는 제목만 보지 말고 실제 사용하는 코어를 확인하세요.

Clash 다운로드 센터는 클라이언트 다운로드 링크, 한국어 가이드, 문제 해결 자료를 정리하며 서로 다른 프로젝트의 유지 관리자를 하나의 팀으로 취급하지 않습니다. 클라이언트 이름이 비슷해도 출시 일정이나 기능을 공유한다는 뜻은 아닙니다. 다운로드 전에 해당 프로젝트의 시스템 요구 사항을 확인하세요. 오래된 가이드를 읽을 때는 먼저 일반적인 개념을 파악한 뒤 메뉴, 설정 항목, 권한 절차가 현재 화면과 일치하는지 확인해야 합니다.

오픈 소스 저장소와 설정 참고 자료

mihomo의 소스 코드, 릴리스 노트, 이슈 논의는 공개 저장소에서 확인할 수 있습니다. 특정 필드의 지원 여부나 동작 변경의 원인을 확인할 때는 재인용된 설명보다 프로젝트 문서와 해당 릴리스 노트를 참고하는 것이 좋습니다. 공개 코드를 통해 커뮤니티가 구현을 검토하고 수정 사항을 제안할 수 있지만, 각 GUI 클라이언트에는 별도의 설정 관리 계층이 있습니다. 문제를 보고할 때는 클라이언트 이름, 사용 중인 코어, 문제를 일으킨 구체적인 작업을 함께 기록해 인터페이스 문제를 코어 프로젝트에 잘못 전달하지 않도록 하세요.

아래 명령은 mihomo 소스 코드를 내려받으며, 구현을 살펴보거나 개발에 참여할 때 사용할 수 있습니다. 일반 사용자는 GUI 클라이언트를 선택하면 되므로 저장소를 먼저 복제할 필요가 없습니다. 저장소를 복제했다고 실행 가능한 프로그램이 설치되는 것도 아닙니다. 빌드, 의존성, 실행 방법은 프로젝트 안내를 따르세요.

코어, 클라이언트, 구독 출처

코어는 프로토콜, 규칙, DNS, 연결을 처리하고 클라이언트는 구독 가져오기, 모드 전환, 시스템 연동 기능을 제공합니다. 구독 출처는 실제 설정과 프록시 정보를 제공합니다. 각각 별도로 업데이트되며 담당 범위도 다릅니다. 링크 가져오기에 실패하면 출처와 네트워크를, 설정 해석에 실패하면 형식과 필드를, 특정 앱만 프록시를 사용하지 않으면 트래픽 처리 방식을 먼저 확인하세요. 클라이언트를 반복해서 재설치하는 것보다 문제를 단계별로 나누어 살펴보는 편이 원인을 찾기 쉽습니다.

설정에서 자주 보이는 프록시 이름과 프록시 그룹 이름은 서로 참조하는 값일 뿐, 고정된 기능 버튼이 아닙니다. 구독을 바꾸면 그룹 이름과 규칙도 함께 달라질 수 있습니다. 이전 이름을 참조하는 오버라이드를 그대로 두면 설정을 불러오지 못하거나 규칙이 잘못된 대상으로 연결될 수 있습니다. 이전하기 전에 현재 작동하는 설정을 보관하고, 이전 후에는 현재 설정, 모드, 기본 프록시 그룹을 하나씩 확인한 다음 필요한 대상에 접속해 보세요.

업데이트 순서와 복구 준비

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트를 업데이트하면 메뉴나 서비스 설치 방식이 바뀔 수 있고, 코어 업데이트는 새 필드를 추가하거나 처리 동작을 변경할 수 있으며, 구독 업데이트는 설정 출처의 내용을 바꿉니다. 문제가 생기면 먼저 어느 부분을 변경했는지 기록하고 모든 구성 요소를 한꺼번에 업데이트하지 마세요. 안내를 확인한 뒤 업데이트하고 기존 설정과 오버라이드를 보관해 변경 내용을 비교할 수 있도록 하세요.

연결을 확인할 때는 반복해서 테스트할 수 있는 대상부터 점검하세요. 먼저 기기의 네트워크가 정상인지 확인하고, 설정이 제대로 불러와졌는지 살핀 다음 연결 기록에서 규칙과 프록시를 확인합니다. TUN을 켠 뒤 문제가 생기면 TUN을 끄고 다시 테스트하세요. 클라이언트를 종료한 뒤에도 접속할 수 없다면 시스템 프록시 설정이 남아 있는지 확인합니다. 로그를 공유할 때는 구독 주소, 인증 정보, 개인 식별이 가능한 네트워크 정보를 지우고 오류를 이해하는 데 필요한 문맥만 남기세요.

mihomo 소스 코드

공개 저장소: MetaCubeX / mihomo ↗

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

Clash 설정 및 문제 해결 가이드

규칙 작성, 앱 프록시 설정, 프록시 그룹 선택을 구체적인 문제별로 살펴보세요.

전체 글 보기 →