mihomo 코어 · Apple Silicon 네이티브 지원

Clash Mac 버전 클라이언트 다운로드

Clash 다운로드 사용 가이드 보기

Apple Silicon 및 Intel Mac용 그래픽 클라이언트로, 구독 설정과 규칙 기반 라우팅을 한곳에서 관리할 수 있습니다.

오픈 소스 코어 메뉴 막대 관리 한국어 설정 가이드

클라이언트 설정 예시입니다. 클라이언트마다 항목 이름과 메뉴 위치가 다를 수 있으며, 스위치 상태는 설명을 위한 예시입니다.

macOS 설정 항목 살펴보기

메뉴 막대, 프록시 모드와 구독 관리

먼저 클라이언트 인터페이스, 프록시 코어, 설정 파일을 구분해야 합니다. 인터페이스는 조작 기능을 제공하고, 코어는 연결을 처리하며, 설정 파일은 규칙과 아웃바운드 정책을 정합니다. 아래에서는 Mac을 일상적으로 사용할 때 확인할 설정 여섯 가지를 살펴봅니다. 실제 지원 기능은 선택한 클라이언트의 구현에 따라 다릅니다.

메뉴 막대에서 실행 상태 확인

Mac 클라이언트는 대개 메뉴 막대에서 바로 조작할 수 있어, 기본 창을 열지 않고도 아웃바운드 모드를 전환하거나 현재 설정을 확인하고 프록시를 일시 중지할 수 있습니다. 클라이언트 설정에서 메뉴 막대 표시, 창 닫기 동작, 로그인 시 실행 항목을 찾아보세요. 창을 닫아도 앱 프로세스는 종료되지 않을 수 있습니다. 사용을 마칠 때는 창 숨기기와 앱 종료를 구분해야 합니다. 시스템 VPN 상태에 의존하는 모바일 기기와 달리, Mac에서는 메뉴 막대 앱이 계속 실행 중인지와 앱을 종료할 때 시스템 프록시가 원래대로 복구되는지도 확인해야 합니다. 중지된 포트를 가리키는 설정이 남지 않도록 주의하세요.

시작 시 실행
메뉴 막대에서 상시 관리

Mac 클라이언트는 대개 메뉴 막대에서 바로 조작할 수 있어, 기본 창을 열지 않고도 아웃바운드 모드를 전환하거나 현재 설정을 확인하고 프록시를 일시 중지할 수 있습니다. 클라이언트 설정에서 메뉴 막대 표시, 창 닫기 동작, 로그인 시 실행 항목을 찾아보세요. 창을 닫아도 앱 프로세스는 종료되지 않을 수 있습니다. 사용을 마칠 때는 창 숨기기와 앱 종료를 구분해야 합니다. 시스템 VPN 상태에 의존하는 모바일 기기와 달리, Mac에서는 메뉴 막대 앱이 계속 실행 중인지와 앱을 종료할 때 시스템 프록시가 원래대로 복구되는지도 확인해야 합니다. 중지된 포트를 가리키는 설정이 남지 않도록 주의하세요.

시작 시 실행
시스템 프록시 간편 설정

일반 설정에서 시스템 프록시로 설정을 켜면 클라이언트가 macOS의 관련 프록시 설정을 로컬 수신 주소로 지정합니다. 그러면 브라우저처럼 시스템 설정을 따르는 앱에서 프록시를 사용할 수 있습니다. 처음 설정할 때는 코어가 실행 중인지 확인한 다음 옵션을 켜고 웹페이지에 접속해 동작을 확인하세요. 모든 프로그램의 연결을 강제로 전환하는 기능은 아닙니다. 터미널 도구나 일부 게임은 별도의 네트워크 설정을 사용할 수 있습니다. 시스템 설정에서 항목을 하나씩 직접 입력하는 것보다 클라이언트 스위치로 간편하게 켜고 끌 수 있지만, 실제로 사용하는 네트워크 서비스도 확인해야 합니다. 특히 Wi-Fi와 이더넷을 전환한 뒤에는 다시 점검하세요.

시스템 프록시로 설정
TUN 모드

TUN은 가상 네트워크 인터페이스와 라우팅 설정을 사용해 지정된 경로의 트래픽을 코어에서 처리합니다. 터미널이나 시스템 프록시를 사용하지 않는 앱의 연결을 점검할 때 유용합니다. 네트워크 또는 고급 모드 설정에서 관련 항목을 찾은 뒤, 클라이언트 안내에 따라 서비스를 설치하고 macOS 권한을 승인한 다음 기능을 켜고 연결 기록을 확인하세요. 모바일 기기의 시스템 권한 설정과는 달리 Mac에서는 백그라운드 서비스와 관리자 권한이 필요한 경우가 많습니다. TUN을 켠다고 모든 연결이 프록시를 통과하는 것은 아닙니다. 최종 아웃바운드는 규칙에 따라 결정됩니다. 다른 VPN과 함께 사용할 때는 라우팅이나 DNS가 충돌하지 않는지도 확인하세요.

TUN 모드
규칙 기반 라우팅과 정책 그룹

규칙 모드에서는 설정에 입력된 순서대로 도메인, 주소 및 기타 조건을 확인하고 해당 연결을 알맞은 정책 그룹으로 보냅니다. 먼저 프록시 화면에서 규칙 모드를 선택하고 정책 그룹을 펼쳐 사용할 아웃바운드를 고르세요. 예상과 다른 결과가 나오면 연결 또는 로그 화면에서 적용된 규칙을 확인할 수 있습니다. 정책 그룹 이름은 설정 파일에 따라 달라지며, 소프트웨어가 고정으로 제공하는 서비스가 아닙니다. 전역 스위치만 제공하는 도구와 달리 규칙 기반 라우팅에서는 대상마다 다른 경로를 지정할 수 있지만, 규칙 순서와 DNS 응답에 더 큰 영향을 받습니다. 설정을 변경하기 전에 사본을 보관하세요. 구독 업데이트로 덮어써질 수 있는 내용을 직접 수정하지 않는 것이 좋습니다.

아웃바운드 모드규칙전역직접 연결
Apple Silicon 및 Intel 지원

Apple 메뉴의 이 Mac에 관하여를 열어 칩 이름을 확인하세요. Apple 칩이면 Apple Silicon 또는 arm64 설치 파일을, Intel 프로세서면 x64 설치 파일을 선택하면 됩니다. 두 아키텍처를 지원한다는 것은 다운로드 페이지에서 각각에 맞는 파일을 제공한다는 뜻이지, 모든 파일이 유니버설 바이너리라는 뜻은 아닙니다. Rosetta로 변환해 실행하는 것보다 칩에 맞는 네이티브 앱을 일상적으로 사용하는 편이 대체로 적합합니다. 최소 macOS 요구 사항은 클라이언트마다 다르므로 구형 시스템에서는 설치 전에 다운로드 페이지의 안내를 확인하세요. 그래픽 인터페이스와 내장 코어 모두 현재 시스템을 지원해야 한다는 점도 유의해야 합니다.

코어mihomo
구독 자동 업데이트

구독 또는 설정 화면에서 호환되는 구독 주소를 추가하고 다운로드가 끝나면 현재 설정으로 지정한 뒤, 필요에 따라 자동 업데이트를 켜세요. 업데이트는 주로 원격 규칙과 아웃바운드 정보를 새로 받아오는 기능이며 클라이언트나 코어 업그레이드와는 다릅니다. 로컬 파일을 직접 가져오는 것보다 구독 관리가 지속적인 설정 유지에 편리하지만, 서버에서 내려받은 내용은 코어와 호환되어야 합니다. Mac이 잠자기 상태인 동안에는 예약 작업이 제때 실행되지 않는 경우가 많으므로, 깨어난 뒤 수동으로 업데이트해 상태를 확인할 수 있습니다. 오래 유지해야 하는 사용자 규칙은 원격 구독으로 생성된 파일을 직접 편집하지 말고, 클라이언트가 지원하는 오버라이드나 병합 기능을 사용하세요.

구독 자동 업데이트

처음 설치할 때는 구독을 가져오고 브라우저 연결을 확인한 다음 TUN 사용 여부를 결정하는 것이 좋습니다. 설정 간의 의존 관계와 작업 순서, 확인 방법은 빠른 시작 가이드에서, 프로토콜 기능과 코어 호환 범위는 프로토콜 안내서에서 확인하세요.

플랫폼 및 설치 파일

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

Clash는 생태계를 가리키는 이름이며, 그래픽 클라이언트마다 설정 메뉴와 지원 범위가 다릅니다. 다운로드 페이지에서 플랫폼별 클라이언트, 아키텍처, 설치 요구 사항을 확인할 수 있습니다. 설치 파일에는 소프트웨어만 포함되므로 사용 전에 호환되는 설정을 준비해야 합니다. 하나의 구독을 여러 기기에서 사용할 수 있는지는 형식과 프로토콜 항목, 서비스 제공자의 정책에 따라 달라집니다.

Windows

데스크톱에서 구독과 정책 그룹을 관리하는 데 적합합니다. 다운로드 전에 시스템 아키텍처를 확인하고, 처음 실행할 때 방화벽이나 백그라운드 서비스 안내를 살펴보세요. 시스템 프록시와 TUN은 서로 다른 연결 방식이므로 처음 설정할 때 둘 다 켤 필요는 없습니다.

다운로드 페이지로 이동

macOS

먼저 이 Mac에 관하여에서 Apple 칩인지 Intel 프로세서인지 확인한 뒤 알맞은 설치 파일을 선택하세요. 다운로드 페이지에서는 Clash Plus, Clash Verge Rev, FlClash 등을 선택할 수 있습니다. 메뉴 막대 조작 방식, 서비스 권한 부여 방법, 최소 시스템 요구 사항을 함께 고려하세요.

다운로드 페이지로 이동

Android

기기 아키텍처에 맞는 설치 파일을 선택하고, 처음 연결할 때는 시스템 안내에 따라 VPN 권한을 허용하세요. 백그라운드에서 연결이 자주 끊긴다면 배터리 최적화와 앱 백그라운드 제한을 확인하세요. 데스크톱 설정을 휴대폰으로 옮긴 뒤에도 규칙과 DNS 동작을 다시 점검해야 합니다.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io 정보를 확인할 수 있습니다. 설치 후 앱 안내에 따라 설정을 가져오고 VPN 권한을 허용하세요. 사용할 수 있는 프로토콜과 설정 항목은 모바일 클라이언트의 실제 지원 범위를 기준으로 합니다.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 배포판에 맞는 그래픽 클라이언트 패키지를 선택할 수 있습니다. 서버나 라우터에서 사용할 때는 코어와 그래픽 인터페이스를 구분하고, 서비스 실행과 권한, 라우팅을 별도로 설정해야 합니다. 코어만 다운로드하면 데스크톱 설정 창은 나타나지 않습니다.

다운로드 페이지로 이동

설치 전에 세 가지 정보 확인

운영체제 버전, 프로세서 아키텍처, 현재 사용 중인 설정 형식을 확인해 두세요. 구형 시스템에서는 최신 클라이언트가 실행되지 않을 수 있고, 아키텍처가 맞지 않으면 변환 실행을 거치거나 설치에 실패할 수 있습니다. 설정이 호환되지 않으면 가져오기 오류나 코어 실행 실패가 발생할 수 있습니다. 원인마다 해결 방법이 다르므로 설치 파일을 계속 바꿔 보기보다 먼저 정보를 확인하는 편이 효과적입니다.

이전 클라이언트에서 옮기는 경우 복구할 수 있도록 설정과 사용자 규칙을 먼저 내보낸 뒤 기존 앱을 종료하세요. 두 클라이언트가 동시에 시스템 프록시를 변경하거나 같은 포트를 사용하지 않도록 해야 합니다. 새 클라이언트에서 코어가 실행되고 설정을 불러오며 연결 기록이 생성되는지 확인한 다음 오버라이드 규칙과 자동 업데이트 설정을 하나씩 옮기세요.

클라이언트 전체 보기 →

프로젝트 출처와 설정 범위

Clash 생태계와 mihomo 코어 알아보기

클라이언트를 고를 때는 먼저 코어 기능과 유지 관리 상태를 확인한 다음 인터페이스가 사용 습관에 맞는지 살펴보세요. 오픈 소스 저장소에서는 구현 내용을 확인하고 변경 사항을 추적하며 설정 문서를 대조할 수 있습니다. 인터페이스 스크린샷이나 소프트웨어 이름만으로는 이를 판단할 수 없습니다.

원본 Clash에서 mihomo까지

원본 Clash는 규칙 기반 라우팅, 정책 그룹, YAML 설정 등 널리 쓰이는 사용 방식을 정립했습니다. 이후 커뮤니티에서 이를 바탕으로 여러 코어와 클라이언트가 나왔으며, mihomo는 기존 Clash Meta의 기술 방향을 이어갑니다. 이름이 비슷하다고 기능까지 같은 것은 아닙니다. 기존 설정에서 자주 쓰는 항목은 유지될 수 있지만, 새 프로토콜과 규칙 유형, DNS 옵션은 해당 코어의 문서를 확인해야 합니다. 이전할 때는 원본 파일을 보관하고 로그에 명시된 비호환 항목부터 처리하세요.

Mac용 소프트웨어를 선택할 때 두 이름을 구분해야 하는 이유도 여기에 있습니다. 클라이언트 이름은 조작 화면을, 코어 이름은 실제 네트워크 연결을 처리하는 프로그램을 뜻합니다. 인터페이스가 업데이트되어도 코어가 함께 업그레이드되는 것은 아니며, 코어에서 지원하는 기능이 모든 인터페이스에 버튼으로 제공되는 것도 아닙니다. 기능 사용 가능 여부를 판단하려면 메뉴에 비슷한 이름이 있는지만 볼 것이 아니라 클라이언트 안내, 코어 지원 범위, 현재 설정을 모두 확인해야 합니다.

오픈 소스 코드와 커뮤니티 문서

mihomo의 코드와 변경 기록, 이슈 논의는 프로젝트 저장소에서 확인할 수 있습니다. 문서를 볼 때는 대상 코어와 기능 범위를 먼저 확인해 다른 코어의 설정 예시를 현재 파일에 그대로 복사하지 않도록 하세요. 문제를 제보할 때는 인터넷이 안 된다는 설명만 적기보다 시스템 버전, 칩 종류, 클라이언트 이름, 재현 단계, 관련 로그를 함께 제공하면 원인을 파악하기 쉽습니다. 로그를 공개하기 전에는 구독 주소와 인증 정보 등 개인정보를 지우고 오류를 설명하는 데 필요한 최소한의 내용만 남기세요.

이 사이트는 다운로드 경로와 한국어 설정 안내를 정리하며, 서로 다른 커뮤니티 프로젝트를 하나의 공식 앱으로 취급하지 않습니다. 다운로드 페이지의 유지 관리 상태는 선택 시 참고할 정보이며, 보관 처리된 클라이언트는 명확한 호환성 요구가 있는 사용자에게 적합합니다. 장기간 사용할 앱이라면 현재 macOS를 지원하고 계속 관리되며 주요 설정을 문서로 설명하는지 우선 확인하세요. 오픈 소스라고 해서 모든 서드파티 패키지가 업스트림 빌드와 완전히 동일한 것은 아닙니다.

세 가지 업데이트 경로를 구분해 관리

클라이언트 업데이트는 주로 인터페이스, 시스템 연동, 설치 서비스를 변경합니다. 코어 업데이트는 프로토콜 구현, 규칙 처리, 네트워크 동작에 영향을 주며 구독 업데이트는 원격 설정 내용을 바꿉니다. 세 작업은 서로 독립적으로 진행될 수 있으므로 구독 새로고침에 성공해도 소프트웨어가 업그레이드된 것은 아닙니다. 업그레이드 전에 사용자 지정 포트, DNS 설정, 오버라이드 규칙을 기록하고, 업그레이드 후에는 코어 실행, 설정 불러오기, 실제 연결 순으로 확인하세요. 문제가 생기면 어느 계층에서 변화가 발생했는지 정확히 파악할 수 있습니다.

자동 업데이트가 필요한 점검을 대신해 주지는 않습니다. 구독 서버가 일시적으로 오류 페이지를 반환하거나 특정 설정 항목이 일부 코어에서만 지원될 수 있습니다. 업데이트 직후 실행되지 않는다면 시스템 네트워크를 바로 변경하기보다 먼저 설정 파싱 오류를 확인하세요. Mac이 잠자기 상태에서 깨어나거나 네트워크 서비스를 전환하거나 다른 VPN을 켜고 끄면 라우팅 환경이 달라질 수도 있습니다. 문제를 해결할 때는 한 번에 설정 하나만 바꾸고 변경 전후 결과를 기록하세요. 여러 변수가 겹쳐 원인을 잘못 판단하는 일을 줄일 수 있습니다.

클라이언트와 네트워크 서비스의 차이

클라이언트를 설치해도 사용할 수 있는 아웃바운드가 자동으로 생기지는 않습니다. 구독은 보통 사용자가 이미 이용 중인 서비스에서 제공하거나 직접 관리하는 설정으로 마련할 수 있습니다. 가져오기 전에 출처를 신뢰할 수 있는지, 형식이 호환되는지 확인하고 규칙과 DNS 설정도 살펴보세요. 구독 주소에 접속 정보가 포함될 수 있으므로 공개 게시판에 올리거나 온라인 변환 서비스에 함부로 입력하지 마세요. 형식을 변환해야 한다면 어떤 항목이 손실될 수 있는지 먼저 확인한 뒤 변환된 파일의 정책 그룹과 규칙 참조를 로컬에서 점검하세요.

연결 문제가 발생하면 계층별로 확인하세요. 연결 기록이 없으면 앱 트래픽이 프록시로 들어오는지 살펴보고, 규칙이 적용됐는데도 연결에 실패하면 아웃바운드와 네트워크를 확인하세요. 일부 도메인만 문제가 있다면 DNS, 규칙 순서, 대상 웹사이트 상태를 점검하면 됩니다. 시스템 프록시와 TUN은 모든 문제를 해결하는 만능 스위치가 아닙니다. 증상에 맞춰 도움말 센터를 살펴보거나, 설정을 바꾸기 전에 용어집에서 혼합 포트, 정책 그룹, 가상 네트워크 인터페이스의 차이를 확인하세요.

mihomo 프로젝트 소스 코드 보기

Git이 설치된 사용자는 명령어를 복사해 터미널에서 공개 저장소를 다운로드할 수 있습니다. 이 명령어는 소스 코드만 가져오며 클라이언트를 설치하거나 시스템 프록시를 변경하지 않습니다.

git clone https://github.com/MetaCubeX/mihomo.git
프로젝트 저장소 열기 ↗

설정 및 문제 해결 가이드

구독 형식, 인증서 문제와 클라이언트 선택

기본 연결을 마친 뒤 구체적인 문제에 맞는 가이드를 확인하세요. 형식 변환은 설정 항목의 호환성을, 인증서 오류는 보안 경계를, 클라이언트 비교는 사용 방식과 시스템 지원을 살펴봅니다. 각 주제에는 서로 다른 점검 방법이 필요합니다.

전체 글 보기 →