macOS · 기본 설정 절차
Clash Mac 설정 가이드
구독을 가져온 뒤 연결을 확인하는 4단계로 처음 설정을 마칩니다. 클라이언트와 유효한 구독이 준비되어 있다면 기본 설정은 약 10분이면 완료할 수 있습니다. 구독 다운로드와 시스템 권한 승인에 걸리는 시간은 환경에 따라 다릅니다.
시작 전: 클라이언트와 설정 출처 확인
먼저 Apple 메뉴에서 ‘이 Mac에 관하여’를 엽니다. ‘칩’ 항목에 Apple 계열 이름이 표시되는 Mac에는 Apple Silicon 설치 파일을, Intel 프로세서가 표시되는 Mac에는 Intel 설치 파일을 선택하세요. 설치 파일이 클라이언트에서 요구하는 macOS 버전과 호환되는지도 확인해야 합니다. 아직 설치하지 않았다면 Mac 설치 파일 목록에서 클라이언트를 선택하세요. 디스크 이미지가 열리면 안내에 따라 앱을 ‘응용 프로그램’으로 드래그하고, 이미지를 추출한 뒤 ‘응용 프로그램’에서 실행합니다. 다운로드 폴더나 디스크 이미지에서 장기간 실행하지 마세요.
처음 실행할 때 macOS에서 앱 출처 확인을 요청할 수 있습니다. 출처를 신뢰할 수 있고 예상한 앱인지 확인한 뒤 진행하세요. 시스템에서 실행을 차단하면 ‘시스템 설정 → 개인정보 보호 및 보안’에서 구체적인 사유를 확인할 수 있습니다. 가이드를 진행하려고 시스템 전체의 보안 보호를 끄거나 악성 소프트웨어 경고를 무시하지 마세요. 클라이언트가 알림 권한을 요청하면 사용 방식에 따라 허용 여부를 결정하면 됩니다. 브라우저 프록시를 사용하는 데 필요한 권한은 아닙니다.
이 가이드에서는 유효한 Clash 또는 mihomo 호환 구독 주소나 미리 준비한 로컬 YAML 설정 파일이 있다고 가정합니다. 클라이언트를 설치해도 노드, 계정 또는 구독이 자동으로 생성되지는 않습니다. 구독에는 서버 정보와 접속 인증 정보가 포함되는 경우가 많으므로 계정 정보처럼 안전하게 보관하세요. 공개 스크린샷이나 채팅 기록, 온라인 변환 페이지에 올리지 마세요. 준비가 끝나면 먼저 구독을 가져오고, 설정 문제와 시스템 트래픽 처리 문제를 혼동하지 않도록 시스템 프록시와 TUN은 아직 켜지 않습니다.
1. 구독을 가져와 현재 설정으로 활성화
클라이언트 메인 창을 열고 사이드바에서 ‘구독’ 또는 ‘설정’을 찾습니다. ‘추가’, ‘가져오기’ 또는 더하기 버튼을 누르고 URL 가져오기를 선택하세요. 이름 입력을 요청하면 알아보기 쉬운 이름을 지정하고, 주소 입력란에 서비스 제공자가 안내한 전체 구독 링크를 붙여넣은 다음 확인 또는 다운로드를 누릅니다. 붙여넣은 링크의 앞뒤에 공백이 없는지, 메신저에서 링크가 잘리지 않았는지, 매개변수 부분이 모두 포함됐는지 확인하세요. 웹사이트 로그인 주소나 계정 관리 페이지를 구독 주소로 착각하지 않도록 주의합니다.
가져오는 동안 클라이언트가 원격 파일을 요청하고 내용을 해석합니다. 성공하면 설정 페이지에 새 설정 카드나 목록 항목이 표시됩니다. 해당 설정을 눌러 현재 사용할 설정으로 지정하세요. 가져온 직후 자동으로 활성화되는 클라이언트도 있고, ‘사용’, ‘활성화’ 또는 선택 표시를 추가로 눌러야 하는 경우도 있습니다. 목록에 설정이 보인다는 것은 저장됐다는 뜻일 뿐, 코어에서 사용 중이라는 의미는 아닙니다. 프록시 페이지를 열어 해당 설정에서 제공하는 정책 그룹과 아웃바운드 항목이 표시되는지 확인하세요.
로컬 파일을 사용한다면 같은 페이지에서 ‘파일에서 가져오기’를 선택하고 확장자가 .yaml 또는 .yml인 설정 파일을 고릅니다. 일부 클라이언트는 파일을 복사하지만, 다른 클라이언트는 원본 파일과 연결된 상태로 사용할 수 있으므로 나중에 수정하기 전에 클라이언트 안내를 확인하세요. 파일을 가져와도 원격 업데이트 기능이 자동으로 생기지는 않습니다. 설정에서 외부 규칙이나 노드 제공자를 참조한다면 처음 로드할 때 인터넷 연결이 필요할 수 있습니다. 파일이 로컬에 있다는 이유만으로 모든 종속 항목을 사용할 수 있다고 단정하지 마세요.
형식 오류가 표시되면 먼저 구독이 Clash 또는 mihomo를 명시적으로 지원하는지 확인합니다. 인코딩된 문자열만 있는 경우, 프로토콜 링크 하나만 제공된 경우, 다른 코어용 JSON 파일인 경우에는 YAML 설정 가져오기 메뉴에서 바로 사용할 수 없습니다. 여러 변환 도구를 번갈아 시도하지 말고 설정 제공자에게 호환되는 형식을 요청하세요. 구독 링크가 로그인 페이지, 만료 안내 또는 접근 오류 페이지를 반환하기도 합니다. 다운로드에 성공했더라도 이런 내용은 유효한 설정이 아닙니다. 클라이언트 로그에서 오류 유형을 확인할 수 있지만, 로그를 공유하기 전에 링크 매개변수와 계정 및 서버 인증 정보를 가리세요.
다운로드 실패가 표시되면 먼저 프록시를 켜지 않은 상태에서 Mac으로 일반 웹페이지에 접속할 수 있는지 확인하고 한 번 더 업데이트를 시도합니다. 구독 다운로드 문제를 해결하려고 설정이 끝나지 않은 시스템 프록시를 반복해서 켜지 마세요. 작동하지 않는 로컬 포트로 요청이 전송될 수 있습니다. 구독이 정상적으로 로드되고 정책 그룹이 표시되면 다음 단계로 넘어갑니다. 자동 업데이트 주기는 나중에 설정해도 됩니다. 처음에는 수동 업데이트와 활성화가 정상적으로 작동하는지 확인하세요. 형식과 코어의 차이는 프로토콜 안내서에서 자세히 확인할 수 있습니다.
2. 규칙 모드와 정책 그룹 선택
‘프록시’ 페이지로 이동해 ‘아웃바운드 모드’ 또는 ‘실행 모드’를 찾고, 처음 사용할 때는 ‘규칙’을 선택합니다. 규칙 모드는 현재 설정의 규칙에 따라 각 요청을 프록시로 보내거나 직접 연결하거나 차단합니다. 모든 사이트의 용도를 자동으로 알아내는 기능은 아니며, 실제 처리 방식은 구독에 포함된 규칙에 따라 달라집니다. 페이지가 비어 있다면 전체 모드로 바꿔 보기 전에 이전 단계로 돌아가 현재 설정이 활성화됐는지 확인하세요.
이어서 정책 그룹을 확인합니다. 설정에는 수동 선택, 자동 선택, 장애 복구 등 여러 유형의 그룹이 포함될 수 있으며, 그룹 이름은 설정 작성자가 정하므로 구독마다 다릅니다. 수동으로 선택해야 하는 그룹을 열어 사용 가능한 아웃바운드 항목을 선택하세요. 그룹 안에서 다른 정책 그룹을 참조한다면 그 그룹의 선택 상태도 확인합니다. 자동 선택 그룹은 기존 방식대로 두어도 되며, 가이드를 완료하려고 모든 그룹을 수동으로 바꿀 필요는 없습니다. 클라이언트에 연결 테스트 기능이 있다면 문제를 찾는 데 활용할 수 있지만, 한 번 성공했다고 모든 사이트와 프로토콜에 정상 접속할 수 있는 것은 아닙니다.
‘정책 그룹 이름’, ‘그룹 내 항목’, ‘실행 모드’를 구분하세요. 이름이 ‘자동’인 그룹이 현재 규칙에서 사용되고 있다는 보장은 없습니다. 노드를 선택했다고 모든 트래픽이 그 노드를 통과하는 것도 아닙니다. 그룹 안에 DIRECT가 표시되면 보통 직접 연결을 뜻하고, REJECT는 연결 거부를 뜻합니다. 둘 다 원격 프록시 서버가 아닙니다. 일상적인 설정에서는 먼저 구독 안내에 따라 기본 아웃바운드 그룹을 선택한 다음 연결 기록에서 요청이 예상한 경로로 처리되는지 확인하세요.
‘전체’ 모드는 보통 코어에 들어온 연결을 전체 정책에 따라 처리하며, 명확한 목표가 있을 때 잠시 비교하는 용도로 적합합니다. Mac의 모든 앱을 제어한다는 뜻은 아닙니다. ‘직접 연결’은 코어에 들어온 연결을 바로 외부로 내보내는 방식이며, macOS 시스템 프록시를 끄는 것과는 다릅니다. 처음 설정할 때 모든 모드를 번갈아 시험할 필요는 없습니다. 규칙 모드를 유지하고 현재 선택을 기억해 두세요. 정책 그룹 간 참조 관계를 더 알아보려면 용어집을 참고하세요. 우선 재현 가능한 기본 설정을 마칩니다.
3. 코어를 실행하고 시스템 프록시 켜기
설정과 정책을 선택한 다음 클라이언트 홈 화면이나 상태 영역에서 코어 실행 상태를 확인합니다. 앱을 열면 코어가 자동으로 시작되는 클라이언트도 있고, 시작 또는 연결 버튼을 눌러야 하는 경우도 있습니다. 포트 사용 중이나 설정 로드 실패 같은 오류가 있으면 시스템 트래픽을 전환하기 전에 먼저 해결하세요. 메뉴 막대 아이콘이 보인다는 것만으로 코어가 로컬 프록시 포트에서 정상적으로 요청을 받고 있다고 판단할 수는 없습니다. 이 단계에서는 macOS 프록시 설정을 변경하는 다른 클라이언트도 잠시 중지해 설정이 서로 덮어쓰이지 않도록 합니다.
‘설정 → 일반’ 또는 ‘설정 → 네트워크’로 이동해 ‘시스템 프록시로 설정’을 켭니다. 일부 클라이언트는 메뉴 막대 메뉴에도 같은 이름의 스위치를 제공합니다. 이 기능을 켜면 macOS 시스템 프록시를 따르는 앱의 요청이 로컬 클라이언트로 전달되고, 코어가 규칙에 따라 처리합니다. macOS에서 보조 프로그램 설치나 권한 승인을 요청하면 요청한 앱의 이름과 용도를 확인한 뒤 승인하세요. 권한 부여에 실패하면 클라이언트가 표시하는 안내를 확인하고, 이유를 모르는 상태에서 시스템 암호를 반복 입력하지 마세요.
처음 연결을 확인할 때는 ‘강화 모드(TUN)’를 끈 상태로 두고 ‘LAN 연결 허용’도 함께 켜지 마세요. 전자는 가상 네트워크 인터페이스와 라우팅, 추가 권한이 필요하고, 후자는 다른 기기에서 이 Mac의 프록시에 접속하도록 하는 기능입니다. 둘 다 이 Mac의 브라우저를 기본적으로 테스트하는 데 필요하지 않습니다. 먼저 시스템 프록시만으로 연결 경로를 하나씩 확인하세요. 터미널, 게임 또는 다른 앱이 시스템 프록시를 사용하지 않는다면 기본 확인을 마친 뒤 필요에 따라 TUN을 알아보세요. 모든 네트워크 스위치를 한꺼번에 켜지 않는 것이 좋습니다.
로컬 포트는 클라이언트에 현재 표시된 값을 기준으로 합니다. 혼합 포트의 일반적인 예는 7890이지만, 클라이언트나 설정에 따라 다른 포트를 사용할 수 있으므로 예시를 보고 임의로 바꾸지 마세요. 시스템 프록시 값은 보통 클라이언트가 자동으로 입력합니다. 이전에 수동 설정을 했다면 ‘시스템 설정 → 네트워크 → 현재 네트워크 서비스 → 세부사항 → 프록시’에서 이전 주소가 남아 있는지 확인하세요. 조직에서 관리하는 기기에서 프록시 변경이 제한된 경우 관리 정책을 따르고 조직이 요구하는 설정을 덮어쓰지 마세요.
시스템 프록시를 켠 뒤에는 클라이언트를 계속 실행 상태로 둡니다. 메인 창을 닫으면 인터페이스만 숨겨지는 경우가 많고, 메뉴 막대에서 계속 실행되는지는 클라이언트 설정에 따라 달라집니다. ‘종료’를 선택하면 코어도 중지될 수 있으므로 두 동작을 구분하세요. 지금은 터미널을 테스트하거나 브라우저 전용 프록시 확장을 추가하지 말고, 시스템 프록시를 사용하는 브라우저로 다음 단계의 테스트를 진행합니다. 시스템 프록시를 따르지 않는 앱까지 처리해야 한다면 기본 확인을 마친 뒤 프로토콜 안내서의 네트워크 및 코어 설명을 읽어 보세요. 서로 다른 두 가지 처리 방식을 동시에 점검하는 상황을 피할 수 있습니다.
4. 연결 및 규칙 적용 여부 확인
Safari 또는 시스템 프록시 설정을 사용하는 다른 브라우저를 열고 새 탭에서 이전에 정상적으로 접속하던 사이트를 방문해 기본 네트워크가 연결되어 있는지 확인합니다. 그런 다음 프록시 경로를 확인할 사이트에 접속하세요. 클라이언트 스위치의 색상만 보거나 웹페이지가 열리는지만으로 결론을 내리지 마세요. 브라우저 캐시가 사용될 수 있고 사이트 자체에 일시적인 장애가 있을 수도 있습니다. 실제 요청과 클라이언트 처리 기록을 함께 확인해야 합니다.
클라이언트의 ‘연결’ 페이지를 열어 둔 상태에서 테스트 페이지를 새로고침하고 해당 도메인이나 대상 주소의 연결이 표시되는지 확인합니다. 규칙, 정책 체인 또는 아웃바운드 정보가 제공된다면 예상한 처리 방식과 일치하는지 살펴보세요. 직접 연결해야 하는 요청은 직접 연결되고, 프록시가 필요한 요청은 선택한 정책 그룹을 거치는지 확인합니다. 짧은 연결은 금방 사라질 수 있으니 로그를 확인하거나 요청을 다시 보내세요. 로그 상세 수준은 클라이언트마다 다르므로 도메인 기록이 자세히 보이지 않는다고 해서 요청이 코어를 거치지 않았다고 단정하지 마세요.
요청은 보이는데 대상 사이트가 열리지 않는다면 요청이 코어에 도달했을 가능성이 있습니다. 선택한 아웃바운드를 사용할 수 있는지, 구독이 유효한지, 규칙에서 요청을 차단하거나 다른 정책 그룹으로 보냈는지 확인하세요. 조건은 한 번에 하나만 바꿉니다. 예를 들어 같은 정책 그룹에서 아웃바운드 항목 하나를 바꾼 뒤 다시 테스트하세요. 포트, DNS, 모드, 구독을 동시에 바꾸면 어떤 변경이 영향을 줬는지 알 수 없습니다. 설정 전체를 먼저 삭제할 필요도 없습니다. 기존 기록만으로도 문제 범위를 좁힐 수 있습니다.
브라우저 요청이 전혀 표시되지 않는다면 먼저 시스템 프록시가 켜져 있는지 확인합니다. 브라우저에 별도의 프록시 확장이나 사용자 지정 프록시 설정이 있는지도 살펴보고 코어 실행 상태를 점검하세요. 시스템 설정에 남은 이전 포트나 다른 클라이언트의 프록시 설정이 현재 앱으로 요청이 전달되는 것을 막을 수 있습니다. 시스템 프록시를 껐다가 다시 켜 클라이언트가 설정을 새로 적용하도록 해 보세요. 그래도 해결되지 않으면 ‘현재 설정 → 코어 실행 → 로컬 포트 → 시스템 프록시’ 순서로 확인합니다. 자주 발생하는 증상과 해결 방법은 도움말 센터에서 확인할 수 있습니다.
브라우저는 정상인데 터미널 명령이 실패하더라도 전체 설정이 잘못됐다고 볼 수는 없습니다. 많은 명령줄 도구는 macOS 시스템 프록시를 사용하지 않으며, 별도의 프록시 옵션이나 환경 변수가 필요합니다. 지원하는 프로토콜도 도구마다 다릅니다. 처음 연결을 확인할 때는 브라우저 요청과 연결 기록이 일치하는지 확인하면 충분합니다. 터미널 사용은 별도로 설정하세요. 마찬가지로 외부 IP 주소를 확인해도 해당 조회 요청의 경로만 알 수 있을 뿐, 모든 앱이 같은 출구를 사용한다는 뜻은 아닙니다. 확인이 끝나면 규칙 모드를 유지하고 다음에 비교할 수 있도록 현재 활성화된 설정과 정책 그룹을 기록해 두세요.
사용 후: 프록시 끄기 및 네트워크 복구
클라이언트를 종료하기 전에 메뉴 막대나 설정에서 ‘시스템 프록시’를 먼저 끄세요. TUN을 켰다면 TUN도 끈 다음 클라이언트를 종료합니다. 클라이언트가 중지된 뒤에도 시스템 요청이 작동하지 않는 로컬 포트로 전송되는 상황을 막을 수 있습니다. 클라이언트에 종료 시 설정을 자동으로 복구하는 기능이 있더라도 처음에는 직접 한 번 확인하는 것이 좋습니다. 창만 닫고 클라이언트를 계속 실행할 때는 필요에 따라 프록시를 유지하면 됩니다. 매번 구독을 다시 가져올 필요는 없습니다.
앱이 비정상 종료된 뒤 모든 웹페이지가 열리지 않으면 클라이언트를 다시 실행하고 시스템 프록시를 끄세요. 앱을 시작할 수 없다면 현재 네트워크 서비스의 프록시 설정에서 로컬 루프백 주소와 이전 포트를 가리키는 항목이 남아 있는지 확인합니다. 해당 클라이언트가 설정했고 더 이상 사용하지 않는 것이 확실한 항목만 삭제하세요. 업무용 기기에 조직에서 설정한 프록시는 함부로 제거하지 마세요. 일반 네트워크 연결을 복구한 뒤 클라이언트 로그에서 시작 문제를 확인하면 됩니다. 처음부터 Mac의 네트워크 설정 전체를 재설정할 필요는 없습니다.
평소에는 보통 세 가지만 확인하면 됩니다. 구독 업데이트가 성공했는지, 현재 정책이 필요한 방식인지, 필요할 때 시스템 프록시를 켰는지 확인하세요. 구독을 업데이트하면 그룹 이름과 기본 선택이 바뀔 수 있으므로 접속 방식이 달라졌다면 다른 설정을 바꾸기 전에 정책 그룹부터 확인합니다. 기본 설정은 여기까지입니다. 프로토콜 선택, 코어 호환성, 구독 형식에 관한 자세한 내용은 프로토콜 안내서에서 확인할 수 있습니다. 일상적인 웹 브라우징을 위해 모든 고급 옵션을 미리 바꿀 필요는 없습니다.