이 글의 목차
Mac에서 “열리지 않는다”는 문제가 앱 자체에서 발생할 수도 있고, 프록시를 통해 접속하는 웹페이지에서 발생할 수도 있습니다. 두 경우는 확인 방법이 다릅니다. 다운로드와 설치 단계에서는 칩 종류, 파일 출처, 시스템 보안 안내를 확인하고, 앱을 실행한 뒤 설정과 요청을 점검하세요. 기존 클라이언트를 교체할 때는 남아 있는 프록시 설정도 해제해야 합니다.
Mac 다운로드: Apple Silicon과 Intel 중 선택
Apple 메뉴의 “이 Mac에 관하여”에서 칩 또는 프로세서 항목을 확인한 뒤 아래 표에서 맞는 macOS 파일을 선택하세요. 중고 기기나 직장 기기의 아키텍처를 구매 연도로 추측하지 마세요.
Clash Verge Rev 같은 실제 프로젝트의 Release 페이지에서 macOS 첨부 파일을 다운로드하세요. 파일 목록이 버전 태그와 릴리스 안내에 맞아야 합니다. 이름이 비슷한 클라우드 저장소의 "Mac 불법판"을 사용하거나 파일 이름에 Clash가 있다는 이유만으로 계속 유지 관리되는 제품이라고 가정하지 마세요.
Mac과 첨부 파일 표시
| 이 Mac의 표시 | 선택 |
|---|---|
| Apple M1, M2, M3 또는 이후 Apple 계열 칩 | 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 시작 상태
처음 실행할 때 화면이 나타났다고 Mihomo가 준비된 것은 아닙니다. 설정이나 로그를 열어 코어가 반복 종료되지 않고 클라이언트가 설정 디렉터리를 읽고 쓸 수 있는지 확인하세요. 아직 구독을 가져오기 전이므로 core failed나 permission denied가 나오면 구독 대신 로컬 설치 상태와 권한을 확인해야 합니다.
Rosetta 안내 후에만 앱이 열린다면 보통 Intel 빌드를 선택한 것입니다. Apple 칩에서도 일부 Intel 앱을 실행할 수 있지만 프로젝트가 제공하는 arm64 버전으로 바꿔 추가 의존성과 이후 업데이트 혼동을 줄이는 것이 좋습니다.
구독 가져오기와 시스템 프록시 활성화
여기서는 Clash Verge Rev를 예로 듭니다. Profiles(프로필)에 Clash 또는 Mihomo 호환 구독을 추가하고 수동으로 업데이트한 뒤 선택하세요. Proxies에서 노드 하나를 고정하고 Rule을 유지한 채 System Proxy를 켜세요. macOS에서 프록시 변경 권한을 요청하면 방금 설치한 클라이언트가 요청한 것인지 확인하세요.
브라우저로 익숙한 웹사이트를 열면 Connections에 해당 연결이 나타나야 합니다. 일반 시스템 프록시가 작동하기 전에는 TUN을 켜거나 네트워크 확장 기능을 설치하지 마세요. 그렇지 않으면 한 번의 실패에 구독, 노드, 시스템 프록시, 네트워크 권한이 모두 얽힙니다.
다른 macOS 클라이언트는 해당 앱의 구독 및 연결 메뉴를 사용하세요. Profiles가 보이지 않는다고 설치에 실패한 것은 아닙니다.
첫 연결에서 확인할 결과
- Profile에 이번 업데이트 시각이 표시됨
- Proxies에서 구체적인 노드를 선택할 수 있음
- 현재 클라이언트가 macOS 시스템 프록시를 기록함
- Connections에서 방금 실행한 브라우저 요청을 찾을 수 있음
앱이 열리지 않거나 웹페이지가 열리지 않을 때의 처리
앱 아이콘에 금지 표시가 있음
macOS 버전 요구 사항과 앱 아키텍처를 확인하고 일치하는 빌드를 다운로드하세요.
앱이 손상되었다고 표시됨
원본 Release에서 다시 다운로드하고 파일이 완전하며 출처가 같은지 확인하세요.
구독 업데이트 오류 401 / 403
링크 자격 증명 또는 계정 상태의 문제이며 macOS 권한과는 관계없습니다.
브라우저가 실패하고 Connections가 비어 있음
System Proxy가 기록되었는지 확인하고 다른 프록시 클라이언트를 종료하세요.
연결은 Clash에 들어왔지만 timeout 발생
사용 가능함을 확인한 다른 노드로 바꾸세요. DMG를 다시 설치할 필요는 없습니다.
제거 또는 이전 시 macOS 프록시 설정 해제
제거하거나 버전을 되돌리거나 다른 클라이언트로 옮기기 전에는 현재 앱에서 시스템 프록시와 TUN을 끈 다음 메뉴 막대에서 완전히 종료하세요. 창만 닫으면 백그라운드 프로세스가 로컬 프록시 포트를 계속 열어 둘 수 있습니다. 앱을 바로 휴지통으로 옮기면 브라우저는 이미 중지된 프록시 포트에 계속 연결을 시도합니다.
macOS 네트워크 설정에서 HTTP, HTTPS, SOCKS 프록시가 해제되었는지 확인하고 브라우저에서 로컬에서 접근 가능한 웹사이트에 직접 연결할 수 있어야 합니다. 직접 연결 복원을 확인한 뒤 Applications의 앱과 필요 없는 데이터를 삭제하세요. 이전할 때는 구독을 다시 가져오고 두 클라이언트의 데이터 디렉터리를 서로 덮어쓰지 마세요.
새 클라이언트에서 System Proxy를 켜면 Connections에 새 브라우저 요청이 표시되어야 합니다. 이후 버전이나 클라이언트를 바꿀 때도 프로그램 종료와 직접 연결 확인을 계속 수행하세요.