무엇을 해결하는 글인가요
Mihomo Party 설치와 Apple Silicon·Mac M칩을 함께 검색할 때 사용자 의도는 보통 세 단계로 이어집니다. 첫째, 신뢰할 수 있는 채널에서 dmg를 받아 앱을 실행한다. 둘째, macOS 게이트키퍼와 다운로드 격리 때문에 막히는 구간을 통과한다. 셋째, 구독 가져오기까지 끝낸 뒤 시스템 프록시만으로 충분한지, 아니면 TUN까지 켜야 터미널·일부 앱까지 같은 규칙으로 묶이는지 스스로 확인한다는 흐름입니다. 과거 이름으로 더 익숙한 Clash Mihomo·Clash Meta 규칙을 그대로 쓰려는 경우에도 이 순서는 같습니다.
윈도 전용 안내와 달리 맥에서는 코드 서명·공증 노출 이름·격리 속성 때문에 «파일은 받았는데 아이콘만 튕김» 같은 증상이 먼저 올라옵니다. 반대로 한 번 통과하면 이후 패치는 대개 앱 안 업데이터나 새 dmg 교체로 정리되기 때문에 초반만 정확히 짚어두면 유지 비용은 낮습니다. 아래 목차대로 내려가면 설치부터 첫 접속 검증까지 한 바퀴를 닫을 수 있도록 구성했습니다.
설치 전에 볼 것: 칩셋·macOS 버전·보안 소프트
M1·M2·M3·M4 계열은 동일하게 Apple Silicon 계열로 묶여 릴리스 페이지에 arm64·Apple Silicon·맥 전용 dmg 같은 표기가 붙습니다. 인텔 맥과 패키지를 섞어 받으면 Rosetta 경로로 돌거나 아예 실행 단계에서 막히기 쉬우니 지금 기기가 M 칩인지 «이 맥 정보» 한 번 확인하고 받는 파일 이름을 맞추는 습관이 좋습니다. 회사 단말이면 MDM으로 가상 인터페이스나 네트워크 확장 설치가 제한됐을 수 있어 TUN까지 가기 전에 정책을 먼저 확인해야 시간 낭비를 줄입니다.
백신·EDR·네트워크 필터가 실시간으로 새 바이너리를 잠그면 규칙 YAML 문제보다 먼저 소켓이 막힌 것처럼 보입니다. 다른 VPN 클라이언트나 필터 드라이버가 이미 TUN 유사 스택을 잡고 있으면 순서 충돌로 «켜졌는데 패킷이 안 잡힌다» 패턴이 나오니 테스트 때는 하나씩만 켜 두고 비교하는 편이 빠릅니다.
- 관리자 비밀번호: 네트워크 확장·프록시 프로필 설치 요청 시 한 번 이상 들어갈 수 있습니다
- 방화벽: 새 앱 첫 실행 때 연결 허용 팝업을 놓치면 로컬 패널만 열리고 외부 테스트는 실패하는 것처럼 보일 수 있습니다
- DNS 프로필: iCloud 비공개 릴레이나 서드파티 DNS 앱이 동시에 켜져 있으면 resolver만 따로 노는 증상이 납니다
- 시스템 업데이트 직후: 확장 권한이 초기화된 탭으로 돌아가 허용 목록을 다시 눌러야 하는 경우가 있습니다
Mihomo Party 받기: Apple Silicon dmg 고르기
배포 채널은 프로젝트 릴리스·미러·패키지 관리 방식 등 여러 갈래가 있을 수 있습니다. 원칙은 동일합니다. 체크섬이 공개돼 있다면 검증하고, 바이너리 아키텍처가 Mac M칩용인지 확인합니다. 이름만 비슷한 포크나 구버전 dmg를 받으면 코어 문자열과 UI 버전이 어긋나 이슈 트래커에 올릴 재현 정보가 흔들립니다. 저장소 허브가 막힌 회선이라면 브라우저만 우회되어 실제 에셋 요청은 실패하는 경우가 있어 규칙에서 해당 호스트 줄이 출구까지 붙었는지 함께 봐야 합니다.
버전 줄이 헷갈리면 본 사이트에 모아 둔 클라이언트 다운로드 페이지에서 Mihomo·Party 계열 링크를 따라가 동일 릴리스 태그를 맞추는 방법도 있습니다. zip 포터블 형태와 dmg 형태가 함께 있을 때 일상 사용은 Applications 폴더로 끌어 넣는 dmg 쪽이 업데이트·삭제 경로가 분명한 경우가 많습니다.
dmg와 포터블 묶음을 나누는 기준
| 형식 | 장점 | 언제 선택 |
|---|---|---|
.dmg |
응용 프로그램 폴더로 드래그하는 표준 맥 흐름, 스포트라이트 검색과 연동이 단순 | 개인 노트북·장기 고정 설치 |
| 포터블 폴더·zip | 경로 고정 없이 테스트·백업만 할 때 교체 속도가 빠름 | 임시 계정·여러 버전 병렬 비교 |
dmg 열기와 게이트키퍼: 격리 속성까지
검색 의도로 자주 나오는 dmg 열기 문제는 대개 두 겹입니다. 첫째는 게이트키퍼가 개발자 서명을 기본 거절하는 경우이고, 둘째는 브라우저가 파일에 붙인 com.apple.quarantine 때문에 «확인되지 않은 개발자» 메시지가 반복되는 경우입니다. 신뢰하는 릴리스라면 시스템 설정의 «개인정보 보호 및 보안»에서 해당 앱 허용을 누르거나, Finder에서 Control 키를 누른 채 클릭해 «열기»를 선택하는 방법이 안전하게 권장되는 순서입니다.
고급 사용자는 터미널에서 격리 속성만 제거하는 패턴도 쓰지만, 출처가 불분명한 파일에는 적용하면 안 됩니다. 팀 내 표준 절차가 있다면 해시 검증과 릴리스 서명 확인 문서를 같이 두는 편이 재현 가능합니다.
-
dmg 더블 클릭이 막히면
우클릭 또는 Control+클릭 후 열기로 한 번 통과 시도 후에도 안 되면 시스템 설정 보안 탭에서 차단 해제 버튼을 확인합니다 -
앱 번들 실행 단계에서만 막히면
Applications로 복사한 뒤 동일하게 우클릭 열기를 시도합니다 드래그만 하고 바로 실행하면 차이가 나는 경우가 있습니다 -
격리 속성 확인이 필요하면
터미널에서xattr로 속성 목록을 보고 신뢰 경로에서만 제거합니다 내려받기 폴더와 Applications 모두 각각 확인합니다
Applications로 옮기고 첫 실행하기
dmg 안에서 앱 아이콘을 응용 프로그램 폴더 별칭 위로 드래그하는 그림은 표준입니다. 복사가 끝나면 dmg를 꺼내고 애플리케이션 폴더에서 실행합니다. 첫 실행 때 네트워크 접근·알림·파일 접근 같은 권한 팝업이 나오면 필요한 범위만 허용합니다. 로컬 대시보드나 API 포트를 쓰는 빌드라면 127.0.0.1 리스너가 다른 도구와 겹치지 않는지 정도만 같이 확인합니다.
버전 업은 앱 내 체크 또는 새 dmg 덮어쓰기 중 하나를 택하면 됩니다. 코어 바이너리를 수동 교체하는 경우 앱이 기대하는 경로 규칙을 어기면 서명 검증이나 자동 업데이트 줄이 꼬일 수 있어 릴리스 노트를 우선 따르는 편이 좋습니다.
첫 실행 화면에서 볼 것: 프로필·코어·로그
처음 열면 프로필·프록시·설정·로그 블록이 나뉘어 있습니다. 여기서 앱 버전 문자열과 내장 Mihomo 계열 코어 버전 문자열을 같이 적어 두면 이후 장애 보고 때 재현 줄을 빠르게 맞출 수 있습니다. 한국 사용자에게 흔한 혼선은 활성 프로필은 새 구독인데 디스크 어딘가의 예전 YAML을 편집기로 연 채로 디버깅하는 패턴이라 목록에서는 테스트용 이름을 접두어로 분리해 두면 좋습니다.
외부 패널을 브라우저 북마크에 두었다면 비밀번호·LAN 노출 여부를 함께 검토합니다. 카페 같은 공용 회선이라면 무조건 인증을 켜는 편이 안전합니다.
구독 가져오기와 활성 프로필 고정
Mihomo Party 본체는 노드를 파는 서비스가 아니라 원격 설정을 받아 규칙 엔진에 넣는 macOS 클라이언트 역할입니다. 새 프로필을 만들 때 URL 구독 입력란에 제공받은 HTTPS 링크 전체를 한 줄로 붙여 넣습니다. 줄바꿈이나 공백이 끼면 파싱 오류처럼 보이기 쉽습니다.
-
프로필 추가 화면으로 이동
내비게이션에서 프로필 항목을 연 뒤 새 항목을 만듭니다 이름은 서비스명·만료 월처럼 짧게 식별 가능하게 둡니다 -
구독 URL 붙여넣기
토큰이 포함된 쿼리 문자열까지 잘리지 않았는지 확인합니다 붙여넣기 후 즉시 가져오기나 새로 고침을 누릅니다 -
성공 신호 확인
노드 수·정책 그룹이 채워지고 로그에 파싱 완료 줄이 보이면 정상입니다 HTTP 상태 코드가 실패로 찍히면 그 한 줄을 저장해 제공자와 공유합니다 -
활성 프로필 선택
여러 개를 두었다면 방금 받은 카드가 활성 테두리인지 확인합니다 오래된 캐시 프로필이 활성인 채로 새 구독만 수정하는 착각이 자주 납니다
시스템 프록시만 할 때와 TUN을 열어볼 때
macOS에서 클라가 켜는 시스템 프록시는 많은 GUI 앱이 잘 따릅니다. Safari·Chrome 계열·일부 메신저는 이 경로로 충분한 경우가 많습니다. 반면 curl이나 패키지 매니저 일부는 환경 변수 없이 직통 소켓을 열어 규칙 밖으로 나가 보입니다. 이때 바로 TUN을 켜기보다 mixed 포트에 수동 붙여 보거나 브라우저와 터미널을 나란히 같은 테스트 URL로 비교하면 원인이 시스템 레이어인지 앱 설정인지 빨리 갈립니다.
TUN은 가상 인터페이스 쪽으로 트래픽을 접어 들여 무시 프로그램까지 같은 분기 규칙으로 묶기 유리하지만 다른 네트워크 확장과 충돌하거나 디버깅 난이도가 올라갑니다. 그래서 첫 방문 사용자에게는 시스템 프록시와 규칙 모드로 «브라우저 접속 한 바퀴»를 닫은 뒤 필요할 때 TUN 레버를 추가하는 순서를 권합니다.
- 시스템 프록시 우선: 문서·브라우저 중심 업무, 회사 정책으로 커널 확장이 제한된 단말
- TUN 검토: CLI·일부 게임 런처·시스템 프록시를 무시하는 프로세스까지 같은 rule-set으로 맞추고 싶을 때
- 동시에 둘 다 켠다고 해서 처리량이 두 배가 되지는 않음: 지연 테스트는 규칙에 따라 한 경로만 탑니다
맥에서 TUN 켜기: 확장 허용과 DNS
빌드에 따라 메뉴 이름은 조금 다르지만 패턴은 비슷합니다. 먼저 앱이 요청하는 네트워크 확장 또는 시스템 확장 허용을 시스템 설정에서 켠 뒤 관리자 비밀번호를 입력합니다. 허용 탭을 닫아 두면 스위치가 계속 회색으로 남는 경우가 있습니다. 그 다음 앱 안에서 TUN 스위치를 올리고 잠깐 연결이 끊겼다가 복구되는지 확인합니다.
DNS만 ISP로 새는 패턴은 규칙보다 resolver 설정을 먼저 의심합니다. Mihomo 계열에서 자주 보는 fake-ip·도메인 규칙과 함께 로그의 DNS 줄을 비교하면 원인 분류가 빨라집니다.
-
시스템 설정에서 확장 허용
프라이버시 및 보안 혹은 네트워크 관련 탭에서 앱 이름이 차단 목록에 없는지 확인합니다 OS 마이너 업데이트 직후 다시 묻는 경우가 있습니다 -
TUN 켠 뒤 인터페이스 확인
네트워크 설정에서 새 인터페이스가 활성인지 확인합니다 다른 VPN과 동시에 켜 두면 하나만 패킷을 잡는 것처럼 보일 수 있습니다 -
규칙 모드 점검
글로벌로 모두 노드에 태우면 국내 서비스까지 느려질 수 있어 활성 프로필의 국내 DIRECT·provider 분기가 의도대로인지 확인합니다 -
간단 DNS 비교
브라우저와 터미널에서 같은 호스트 조회 결과를 비교해 resolver가 어긋나는지 봅니다 로그의 rule hit와 함께 읽으면 방향이 잡힙니다
첫 접속 자가 점검 루프 닫기
Rule 모드를 기본으로 두고 테스트 사이트나 API 한 줄로 IP·지역 표시가 바뀌는지 먼저 봅니다. 브라우저만 볼 것이 아니라 터미널에서도 같은 엔드포인트를 호출해 차이가 나면 시스템 프록시와 TUN 중 어디까지 켜야 하는지 결론이 납니다. 앱 연결 패널에서 프로세스 이름이 어떤 정책 그룹으로 올라갔는지 함께 보면 규칙 오타인지 출구 선택 문제인지 좁히기 쉽습니다.
로컬 개발 서버나 Docker 내부 트래픽은 브리지·라우팅이 달라 별도 글 주제에 가깝습니다. 여기서는 호스트 macOS 위에서 Mihomo Party가 제어하는 경로에 집중해 루프를 닫습니다.
자주 묻는 질문과 좁히는 순서
«손상되어 열 수 없음» 또는 dmg 마운트 실패
다운로드가 중간에 끊겼거나 미러에서 바이너리가 깨진 경우입니다. 해시가 공개돼 있다면 재검증하고 다른 회선으로 다시 받습니다. 파일은 정상인데 메시지만 반복되면 게이트키퍼·격리 절차를 다시 적용합니다.
인텔 빌드만 있을 때
Rosetta 설치 후 실행은 가능하지만 전력·발열 면에서 네이티브 arm64 dmg를 고르는 편이 낫습니다. 릴리스에 유니버설 바이너리가 있다면 칩 종류와 무관하게 하나로 통일할 수 있습니다.
구독 새로 고침만 타임아웃
활성 프로필이 직통이라 구독 호스트 줄에 손이 안 닿는 패턴이 흔합니다. 브라우저는 우회되어 보여도 CLI 업데이터는 다른 출구를 쓰는 경우도 있어 규칙에서 해당 도메인이 원하는 노드로 가는지 로그와 함께 확인합니다.
브라우저만 되면 무엇부터 보나요
활성 프로필·시스템 프록시 스위치·모드가 Rule인지 순서대로 확인합니다. 터미널에서는 잠깐 HTTPS_PROXY 등을 mixed 포트에 맞춰 붙여 보고 시스템 레이어 문제인지 앱 자체 설정 문제인지 갈립니다.
마무리: 같은 규칙 언어로 클라를 고르기
일부 오래된 GUI는 코어 줄이 멀어지거나 TUN·DNS 옵션을 옛 패턴으로 고정해 두어 같은 YAML도 미세 기능에서 어긋나기 쉽습니다. 화면이 단순해 보여도 사용자 입장에서는 문제가 날 때마다 설정을 다시 맞추는 시간이 늘어납니다.
Clash·Mihomo 계열은 rule-set·프로바이더·DNS 모델을 공유하는 경우가 많아 한 번 규칙을 익히면 클라이언트를 바꿔도 학습 비용이 비교적 낮습니다. 오픈 생태계 기준으로 기능과 업스트림 패치 속도를 함께 보면 일상 교체 피로를 줄이기 좋습니다.
클라 출처를 한곳에서 정리하고 싶다면 클라이언트 다운로드 페이지에서 현재 플랫폼 빌드를 받아 본문 순서와 병행해 비교해 보세요.