이 글의 목차
다운로드 전에 "이 Mac에 관하여"에서 Apple Silicon 또는 Intel인지 확인하세요
왼쪽 위 Apple 메뉴의 "이 Mac에 관하여"를 클릭하세요. 칩 항목에 Apple M1, M2, M3 또는 이후 Apple 계열이 표시되면 Apple Silicon / arm64 빌드를 선택하고 프로세서에 Intel이 표시되면 x64 / Intel 빌드를 선택합니다. 중고 기기와 조직 소유 기기는 구매 연도에 따른 일반적인 규칙과 다를 수 있으므로 시스템 정보를 직접 확인하는 것이 가장 정확합니다.
Clash Verge Rev 같은 실제 프로젝트의 Release 페이지에서 macOS 첨부 파일을 다운로드하세요. 파일 목록이 버전 태그와 릴리스 안내에 맞아야 합니다. 이름이 비슷한 클라우드 저장소의 "Mac 불법판"을 사용하거나 파일 이름에 Clash가 있다는 이유만으로 계속 유지 관리되는 제품이라고 가정하지 마세요.
Mac과 첨부 파일 표시
| 이 Mac의 표시 | 선택 |
|---|---|
| Apple M 계열 칩 | arm64 / Apple Silicon |
| Intel 프로세서 | x64 / Intel |
| Universal | 두 아키텍처를 모두 포함해 파일이 보통 더 큼 |
| 확인할 수 없음 | 추측하지 말고 "이 Mac에 관하여"에서 확인 |
DMG는 설치 미디어일 뿐이며 앱은 Applications로 옮겨야 합니다
표준 설치 과정
다운로드한 DMG 열기
Finder에 앱 아이콘과 Applications 폴더가 나타날 때까지 기다립니다.
앱을 Applications로 드래그
복사가 끝나면 DMG에서 계속 실행하지 말고 "응용 프로그램" 디렉터리에서 시작하세요.
디스크 이미지 추출
앱 복사가 끝났다면 Finder 사이드바에서 DMG를 추출할 수 있습니다.
원본 Release 정보 보관
이후 문제 해결과 업데이트에도 버전과 아키텍처가 필요합니다.
Applications에 같은 이름의 이전 버전이 있다면 메뉴 막대 프로그램을 완전히 종료한 뒤 앱을 교체하세요. 구형 ClashX, 다른 Mihomo 클라이언트 또는 VPN이 동시에 실행되면 시스템 프록시를 번갈아 수정해 새 버전 설치가 실패한 것처럼 보일 수 있습니다.
"개발자를 확인할 수 없음"은 개인정보 보호 및 보안에서 처리하세요
macOS에서 인터넷에서 받은 앱을 처음 열면 개발자를 확인할 수 없거나 앱이 차단되었다는 안내가 나타날 수 있습니다. 프로젝트 Release, 버전, 파일 이름을 다시 확인한 뒤 "시스템 설정 > 개인정보 보호 및 보안"에서 방금 차단된 항목을 찾아 시스템의 "확인 없이 열기" 절차에 따라 승인하세요.
Gatekeeper를 전체적으로 끄는 명령을 실행하거나 안내를 우회하려고 출처를 모르는 서명 패치를 설치하지 마세요. 개별 앱에 대한 시스템 예외면 충분하며 다른 다운로드 콘텐츠는 계속 보호받아야 합니다. 앱이 손상되었다는 안내가 나오면 보안 속성을 바로 제거하지 말고 아키텍처에 맞는 첨부 파일을 다시 다운로드하세요.
메뉴 막대 아이콘이 나타나면 커널 상태가 안정될 때까지 기다리세요
처음 실행할 때 인터페이스가 나타나도 Mihomo가 준비되었다는 뜻은 아닙니다. 설정이나 로그를 열어 커널이 반복해서 종료되지 않고 클라이언트가 자체 설정 디렉터리를 정상적으로 읽고 쓸 수 있는지 확인하세요. 아직 구독을 가져오지 않은 상태이므로 core failed, permission denied는 로컬 설치 계층에서 먼저 처리해야 합니다.
Rosetta 안내 후에만 앱이 열린다면 보통 Intel 빌드를 선택한 것입니다. Apple 칩에서도 일부 Intel 앱을 실행할 수 있지만 프로젝트가 제공하는 arm64 버전으로 바꿔 추가 의존성과 이후 업데이트 혼동을 줄이는 것이 좋습니다.
첫 설정에서는 구독과 시스템 프록시만 사용하세요
Profiles(설정) 페이지에서 Clash 또는 Mihomo 호환 구독을 추가하고 수동으로 업데이트한 뒤 선택하세요. Proxies로 이동해 노드 하나를 고정하고 모드는 Rule로 유지한 다음 System Proxy를 켭니다. macOS에서 시스템 프록시 수정 권한을 요청할 수 있으며 요청 앱은 방금 설치한 클라이언트여야 합니다.
브라우저로 익숙한 웹사이트를 열면 Connections에 해당 연결이 나타나야 합니다. 일반 시스템 프록시가 작동하기 전에는 TUN을 켜거나 네트워크 확장 기능을 설치하지 마세요. 그렇지 않으면 한 번의 실패에 구독, 노드, 시스템 프록시, 네트워크 권한이 모두 얽힙니다.
첫 연결에서 확인할 결과
- Profile에 이번 업데이트 시각이 표시됨
- Proxies에서 구체적인 노드를 선택할 수 있음
- 현재 클라이언트가 macOS 시스템 프록시를 기록함
- Connections에서 방금 실행한 브라우저 요청을 찾을 수 있음
앱을 열 수 없는 문제와 웹페이지를 열 수 없는 문제는 별도로 진단하세요
앱 아이콘에 금지 표시가 있음
macOS 버전 요구 사항과 앱 아키텍처를 확인하고 일치하는 빌드를 다운로드하세요.
앱이 손상되었다고 표시됨
원본 Release에서 다시 다운로드하고 파일이 완전하며 출처가 같은지 확인하세요.
구독 업데이트 오류 401 / 403
링크 자격 증명 또는 계정 상태의 문제이며 macOS 권한과는 관계없습니다.
브라우저가 실패하고 Connections가 비어 있음
System Proxy가 기록되었는지 확인하고 다른 프록시 클라이언트를 종료하세요.
연결은 Clash에 들어왔지만 timeout 발생
사용 가능함을 확인한 다른 노드로 바꾸세요. DMG를 다시 설치할 필요는 없습니다.
오류가 처음 나타난 인터페이스의 해당 계층으로 돌아가 처리하세요. 앱을 시작할 수 있고 Profile을 업데이트하며 노드를 선택할 수 있게 된 뒤에야 웹 연결 문제에서 프록시와 규칙을 확인할 가치가 있습니다.
제거하거나 클라이언트를 바꾸기 전에 macOS를 직접 연결 상태로 되돌리세요
제거, 버전 롤백 또는 다른 클라이언트로 이전하기 전에 현재 프로그램에서 시스템 프록시와 TUN을 끄고 메뉴 막대에서 완전히 종료하세요. 창만 닫으면 백그라운드 프로세스가 로컬 프록시 포트를 계속 유지할 수 있습니다. 앱을 바로 휴지통으로 옮기면 이후 웹 요청이 수신 프로그램이 없는 주소를 계속 가리킬 수 있습니다.
macOS 네트워크 설정에서 HTTP, HTTPS, SOCKS 프록시가 해제되었는지 확인하고 브라우저에서 로컬에서 접근 가능한 웹사이트에 직접 연결할 수 있어야 합니다. 직접 연결 복원을 확인한 뒤 Applications의 앱과 필요 없는 데이터를 삭제하세요. 이전할 때는 구독을 다시 가져오고 두 클라이언트의 데이터 디렉터리를 서로 덮어쓰지 마세요.
새 클라이언트에서 System Proxy를 켠 뒤 Connections에 새 브라우저 요청이 나타나면 기존 프록시 잔여 설정이 정리된 것입니다. 이제 이 Mac에서 아키텍처 선택, 앱 설치, Gatekeeper 승인, 구독 및 시스템 프록시의 첫 설정까지 완료되었습니다. 이후 버전을 바꿀 때도 같은 종료 및 직접 연결 확인 절차를 유지하세요.