QUICK START / APPLE DEVICES
Clash 애플판 설정 가이드
구독 가져오기부터 연결 확인까지 4단계로 처음 설정을 마칩니다. Apple Silicon Mac, Intel Mac, iPhone, iPad에서 사용할 수 있습니다. 먼저 규칙 모드로 기본 연결을 확인한 다음 TUN과 사용자 지정 DNS를 살펴보세요.
시작하기 전에 클라이언트가 설치되어 있고 사용할 수 있는 구독이 있는지 확인하세요. Clash 애플판 클라이언트는 설정을 읽고 규칙을 적용해 연결을 처리합니다. 앱을 설치했다고 프록시 서비스까지 제공되는 것은 아닙니다. 구독은 서비스 제공자나 설정 관리자가 제공해야 하며, 현재 클라이언트가 사용하는 Clash / mihomo 설정 형식을 지원해야 합니다. 이 가이드는 일반적인 화면을 기준으로 처음 설정하는 방법을 안내합니다. 구독이 준비되어 있다면 약 10분이면 따라 할 수 있으며 YAML 문법을 미리 익힐 필요는 없습니다.
아직 설치하지 않았다면 먼저 macOS 클라이언트 다운로드 또는 iOS 클라이언트 다운로드로 이동하세요. Mac에서는 Apple 메뉴의 ‘이 Mac에 관하여’에서 프로세서를 확인할 수 있습니다. Apple 칩이면 arm64, Intel 프로세서면 x86_64를 선택하세요. 클라이언트별 기능 차이는 클라이언트 비교에서 확인할 수 있습니다. 보조 서비스나 네트워크 라우팅은 연결을 확인한 뒤 조정하세요.
1단계: 구독을 가져와 설정 활성화하기
이 단계의 목표는 사용할 수 있는 정책 그룹이 표시되는지 확인하는 것입니다. 아직 연결을 켜지 마세요. 클라이언트를 열고 ‘설정’, ‘구독’ 또는 ‘Profiles’ 화면으로 이동해 ‘추가’, ‘구독 추가’, ‘URL에서 가져오기’ 메뉴를 찾습니다. 원격 URL 방식을 선택하고 알아보기 쉬운 이름을 입력합니다. 예를 들어 ‘개인 원격 설정’이라고 적을 수 있습니다. 그런 다음 서비스 제공자가 안내한 구독 URL 전체를 붙여넣으세요. 이름은 기기에서만 사용하는 메모이며 연결에는 영향을 주지 않습니다.
URL을 붙여넣은 뒤 앞뒤에 공백이나 줄바꿈, 메신저가 덧붙인 안내 문구가 없는지 확인하세요. 구독 URL의 쿼리 매개변수에는 인증 정보가 포함될 수 있으므로 물음표 뒤 내용을 임의로 지우거나 URL을 공개 게시판에 올리지 마세요. 확인을 마치면 ‘저장’, ‘다운로드’ 또는 ‘업데이트’를 누르고 가져오기와 파싱이 끝날 때까지 기다립니다. 가져온 뒤 별도로 업데이트해야 한다면 해당 설정의 작업 메뉴에서 업데이트를 실행하세요.
설정 카드, 업데이트 시간 또는 업데이트 완료 안내가 표시되면 해당 설정의 ‘활성화’, ‘사용’ 또는 선택 표시를 눌러 적용합니다. 파일을 목록에 추가하는 것만으로는 현재 실행 중인 설정이 바뀌지 않을 수 있습니다. 이어서 ‘프록시’ 화면으로 이동해 정책 그룹과 노드가 표시되는지 확인하세요. 그룹 이름은 설정 작성자가 정하므로 ‘프록시 선택’, ‘자동 선택’ 또는 다른 이름일 수 있습니다. 정책 그룹이 화면에 표시되어야 다음 단계에서 프록시 정책을 선택할 수 있습니다.
로컬 YAML 파일을 사용하는 경우
받은 파일이 .yaml 또는 .yml이라면 ‘파일에서 가져오기’를 사용하세요. Mac에서는 파일 선택기에서 설정 파일을 선택합니다. iPhone과 iPad에서는 먼저 파일 앱에 저장한 뒤 클라이언트에서 가져오거나, 시스템 공유 메뉴에서 클라이언트가 제공하는 가져오기 기능을 이용할 수 있습니다. 가져온 다음에는 해당 설정을 선택해 활성화해야 합니다. 로컬 파일은 시간이 지나도 자동으로 최신 내용으로 바뀌지 않습니다. 업데이트 가능 여부는 파일에 포함된 원격 참조와 클라이언트의 업데이트 기능에 따라 달라집니다.
일반 웹페이지 URL, 단일 프로토콜 공유 링크, 완전한 Clash 설정 파일은 서로 다릅니다. ‘파싱 실패’, ‘필수 항목 누락’ 안내가 표시되거나 HTML 페이지가 다운로드되면 서비스 제공자에게 Clash 호환 구독 메뉴를 선택했는지 확인하세요. 오류를 없애려고 설정 키를 임의로 삭제하거나 수정하지 마세요. 처음 설정할 때 출처가 불분명한 온라인 변환 사이트에 구독을 넘기는 것도 피하는 것이 좋습니다. 구독에는 접근 인증 정보와 서비스 정보가 포함될 수 있습니다.
완료 기준: 설정을 선택했고 프록시 화면에 예상한 정책 그룹이 표시되며, 업데이트 중 새로운 파싱 오류가 발생하지 않아야 합니다. 이후 업데이트에 사용할 수 있도록 원본 구독 URL을 보관한 다음 2단계로 이동하세요.
2단계: 규칙 모드와 프록시 정책 선택하기
처음 사용할 때는 ‘규칙 / Rule’ 모드를 선택하세요. 모드 메뉴는 보통 홈 화면이나 프록시 화면 상단, 또는 Mac 메뉴 막대 아이콘의 메뉴에 있습니다. 규칙 모드는 설정에 포함된 도메인, IP 및 기타 조건에 따라 요청을 직접 연결할지 프록시로 보낼지 결정합니다. 모든 앱이 같은 출구를 사용해야 한다는 뜻도, 모든 트래픽이 프록시 서버를 거친다는 뜻도 아닙니다. 구독에 포함된 분기 규칙을 확인하기 좋은 시작점입니다.
규칙 모드로 전환한 뒤 방금 가져온 설정의 주요 프록시 정책 그룹을 여세요. 그룹에서 직접 선택할 수 있다면 서비스 제공자가 사용 가능하다고 안내한 노드를 누르고 선택 표시가 해당 항목으로 이동했는지 확인합니다. 구독에 ‘자동 선택’ 그룹이 있다면 해당 정책을 선택해도 됩니다. 그룹 이름은 통일되어 있지 않으므로 ‘기본’, ‘추천’ 같은 문구만으로 동작을 판단하지 말고 현재 선택된 항목을 확인하세요.
모드와 정책 그룹은 서로 다른 문제를 다룹니다. 모드는 ‘어떤 요청을 프록시로 보낼지’를 정하고, 정책 그룹은 ‘프록시가 필요한 요청을 어디로 보낼지’를 정합니다. 따라서 규칙 모드를 선택했더라도 프록시 그룹이 DIRECT로 설정되어 있으면 해당 그룹에 걸린 요청은 직접 연결될 수 있습니다. 반대로 노드를 선택해도 직접 연결 규칙이 적용되는 사이트가 자동으로 프록시를 사용하지는 않습니다. 다음 단계에서 연결 기록을 확인해 두 가지 설정이 어떻게 적용됐는지 살펴봅니다.
전역·직접 연결 모드와 TUN의 차이
‘전역 / Global’ 모드는 보통 코어로 들어오는 트래픽을 전역 정책으로 처리합니다. 이때도 실제 출구로 사용할 정책을 선택해야 합니다. 잠깐 비교 테스트할 때는 쓸 수 있지만 문제가 생길 때마다 이 모드로 바꾸는 것은 적절한 해결책이 아닙니다. ‘직접 연결 / Direct’은 보통 코어로 들어오는 트래픽을 대상에 바로 연결하며, 프록시 출구가 접속에 영향을 주는지 비교할 때 사용할 수 있습니다. 코어에 따라 내부 처리 방식이 다를 수 있으므로 실제 연결 기록을 기준으로 판단하세요.
TUN은 트래픽을 가져오는 방식이지 규칙 모드와 나란히 선택하는 분기 모드가 아닙니다. TUN을 켜도 규칙 모드를 사용할 수 있습니다. 전역 모드로 바꾼다고 시스템 프록시를 읽지 않는 앱의 문제가 자동으로 해결되는 것도 아닙니다. 처음에는 두 설정을 동시에 바꾸지 마세요. 규칙 모드를 유지한 채 다음 단계에서 Mac은 시스템 프록시를 켜고, iPhone은 클라이언트의 기기 VPN 연결을 설정합니다.
클라이언트에 연결 또는 지연 시간 테스트 기능이 있다면 정책을 고를 때 참고할 수 있습니다. 다만 테스트 성공은 해당 테스트 요청에 응답이 있었다는 뜻일 뿐, 모든 웹사이트와 로그인 서비스, 앱에 접속할 수 있다는 의미는 아닙니다. 한 번의 테스트 수치만 보고 노드를 계속 바꾸지 마세요. 사용할 수 있는 정책 하나를 선택해 전체 설정을 마친 뒤 실제 사용 경험에 따라 조정하세요.
완료 기준: 모드가 규칙으로 표시되고 주요 프록시 정책 그룹에서 사용할 항목이 선택되어 있어야 합니다. 그룹 이름이나 테스트 결과만으로 연결이 작동한다고 단정할 수는 없습니다. 다음 단계에서 시스템이나 기기의 요청이 실제로 클라이언트에 들어오도록 설정합니다.
3단계: 시스템 또는 기기 연결 설정하기
트래픽 처리를 켜기 전에 설정과 정책부터 확인하세요. 테스트 전에 실행 중인 다른 프록시 클라이언트나 VPN 연결을 해제해 여러 앱이 시스템 프록시, 라우팅 또는 DNS를 동시에 바꾸지 않도록 합니다. 문제를 해결하려고 회사나 학교에서 관리하는 네트워크 설정을 삭제하지 마세요. 관리 기기에서 VPN이나 보조 서비스 설치가 제한되어 있다면 기기 관리 정책을 따르세요.
macOS: 코어를 실행하고 시스템 프록시 켜기
Mac 클라이언트 홈 화면에서 코어가 실행 중인지 확인하세요. 앱을 열 때 코어가 자동 실행되는 클라이언트도 있고 ‘시작’ 또는 연결 버튼을 눌러야 하는 클라이언트도 있습니다. 화면에 설정 오류가 표시되면 먼저 1단계로 돌아가 해결하세요. 그런 다음 홈 화면, 설정 또는 메뉴 막대 메뉴에서 ‘시스템 프록시’를 켭니다. 이 기능은 macOS 프록시 설정을 따르는 앱의 요청을 클라이언트로 전달합니다. 처음에는 변수를 줄이기 위해 TUN을 꺼 둡니다.
시스템 프록시를 켠 뒤 ‘시스템 설정 → 네트워크 → 현재 사용 중인 네트워크 서비스 → 세부사항 → 프록시’에서 로컬 프록시 주소가 설정됐는지 확인할 수 있습니다. macOS 버전에 따라 메뉴 이름이나 위치가 조금 다를 수 있습니다. 예시 포트를 고정값으로 생각하지 마세요. 실제 포트는 클라이언트에 표시된 혼합 포트 또는 HTTP·SOCKS 포트를 기준으로 합니다. 임의로 다른 흔한 숫자로 바꾸면 포트가 일치하지 않을 수 있습니다.
브라우저는 되는데 특정 앱에서 연결되지 않더라도 구독을 다시 가져오지는 마세요. 일부 터미널 도구, 게임, 자체 네트워크 연결 기능을 사용하는 앱은 시스템 프록시를 따르지 않습니다. 앱 내부에서 별도로 설정하거나 권한 요구사항을 확인한 뒤 TUN을 사용해야 할 수 있습니다. TUN은 보조 서비스, 관리자 인증, 라우팅 변경이 필요할 수 있습니다. 자세한 설정은 문제 해결 가이드를 참고하고, 이번에는 브라우저로 기본 연결을 확인하세요.
iOS / iPadOS: 기기 VPN 허용 및 연결
iPhone 또는 iPad의 클라이언트 홈 화면에서 ‘연결’이나 기본 스위치를 누릅니다. 처음 연결할 때 시스템에서 VPN 설정 추가를 허용할지 물을 수 있습니다. 설치해서 사용 중인 클라이언트에서 요청한 것인지 확인한 뒤 허용하고, 시스템 안내에 따라 암호를 입력하거나 생체 인증을 완료하세요. 인증이 끝나면 클라이언트로 돌아와 연결 중 상태가 연결됨으로 바뀔 때까지 기다린 뒤 웹사이트를 테스트합니다.
iOS에서는 VPN 설정을 통해 프록시 클라이언트가 네트워크 트래픽을 처리합니다. 이는 ‘전역 모드를 선택한 것’과는 별개입니다. 시스템에 VPN 연결됨으로 표시되더라도 각 요청의 경로는 구독 규칙과 정책에 따라 결정됩니다. 상태 막대에 VPN 아이콘이 표시되는지는 기기와 시스템 화면에 따라 다를 수 있으므로 클라이언트와 시스템 설정의 VPN 상태를 함께 확인하세요. 상단 아이콘만 확인하지 마세요.
연결을 누른 직후 끊어진다면 현재 설정이 유효한지, 다른 VPN이 네트워크를 처리 중이지 않은지 먼저 확인하고 클라이언트의 최근 오류 기록을 살펴보세요. 오류가 발생한 시간과 작업 순서를 기록하고 DNS, 포트, 모드를 연달아 바꾸지 마세요. Wi-Fi와 셀룰러 네트워크를 전환한 뒤 문제가 생겼다면 다시 연결한 다음 같은 테스트 사이트로 비교하세요. 네트워크 전환에 따른 차이를 구독 오류로 오해하지 않도록 주의해야 합니다.
완료 기준: Mac에서는 코어가 실행 중이고 시스템 프록시가 켜져 있어야 합니다. iPhone과 iPad에서는 클라이언트와 시스템 양쪽에서 연결 상태가 확인되어야 합니다. 이 상태는 트래픽을 전달할 준비가 됐다는 뜻일 뿐, 실제 결과는 4단계에서 확인해야 합니다.
4단계: 접속 및 규칙 작동 여부 확인하기
‘연결됨’ 표시만 보지 말고 실제 요청과 연결 기록으로 확인하세요. 먼저 클라이언트에서 ‘연결’, ‘세션’ 또는 ‘로그’ 화면을 엽니다. 그런 다음 브라우저에서 새 탭을 열고 설정상 프록시를 사용해야 하며 현재 네트워크 환경에서 테스트하기 적절한 사이트에 접속하세요. 가능하면 서비스 제공자가 안내한 테스트 대상을 사용해 사이트 자체의 문제를 클라이언트 문제로 오해하지 않도록 합니다. 기존 탭에 열려 있던 페이지라면 한 번 새로고침해 새 요청이 기록되도록 하세요.
연결 기록으로 돌아와 방금 접속한 도메인의 항목을 찾고 대상 주소, 적용된 규칙 또는 규칙 세트, 마지막으로 사용한 정책과 출구를 확인합니다. 표시 항목은 클라이언트마다 다릅니다. 정책 경로 전체를 보여 주는 클라이언트도 있고 최종 노드만 표시하는 클라이언트도 있습니다. 웹페이지가 열리고 기록된 경로도 설정과 일치해야 해당 요청이 예상한 경로로 처리된 것입니다.
이어서 설정상 직접 연결해야 하는 사이트에 접속한 뒤 같은 방법으로 기록을 확인하세요. 두 요청의 경로가 같을 필요는 없습니다. 이것이 규칙 모드의 역할입니다. macOS 시스템 프록시를 사용하더라도 프록시 설정을 따르지 않는 앱의 요청은 코어에 들어오지 않을 수 있습니다. 연결 목록에서 앱이 보이지 않는다고 해서 차단됐다고 단정하지 마세요. 먼저 브라우저로 확인한 다음 자주 쓰는 앱을 하나씩 테스트하세요.
결과가 예상과 다르면 단계별로 확인하기
웹페이지가 열리지 않지만 요청이 클라이언트에 기록된다면 적용된 규칙과 최종 정책이 예상과 일치하는지 먼저 확인한 뒤, 사용 가능하다고 확인된 다른 노드를 잠시 선택해 다시 테스트하세요. 페이지가 열리지 않고 해당 요청 기록도 전혀 없다면 구독을 바로 바꾸기보다 시스템 프록시, 기기 VPN, 앱 자체의 프록시 설정부터 확인하세요. 기록에 도메인 이름 확인 오류가 나타날 때 DNS 문제를 살펴봅니다. 한 번에 설정 하나만 바꾸고 변경 전 값을 기억해 두세요.
출구 IP만 확인해서는 모든 트래픽이 프록시를 사용한다고 증명할 수 없습니다. IP 조회 사이트 자체가 직접 연결 규칙에 해당할 수 있고 프로토콜과 앱에 따라 경로가 다를 수 있습니다. 웹페이지가 열렸다고 DNS 경로까지 예상대로라고 단정할 수도 없습니다. 처음 설정할 때는 대상 요청, 정책, 실제 접속 결과가 일치하는지 확인하면 됩니다. DNS 유출, UDP, IPv6, 라우팅 충돌 문제는 단계별 문제 해결 가이드에서 확인하세요. 이 가이드에서 네트워크 설정을 한꺼번에 모두 바꿀 필요는 없습니다.
연결을 해제하고 네트워크 복구 확인하기
설정이 끝난 뒤 정상적으로 연결을 해제하는지도 확인하세요. Mac에서는 클라이언트에서 시스템 프록시를 끕니다. TUN을 별도로 켰다면 함께 끈 뒤 앱을 종료합니다. iPhone과 iPad에서는 클라이언트에서 연결을 해제하고 시스템 VPN 상태를 확인하세요. 평소 직접 연결되는 사이트를 새로고침해 일반 네트워크가 계속 작동하는지 확인합니다. Mac 클라이언트를 종료한 뒤 인터넷이 되지 않는다면 시스템 프록시가 중지된 로컬 서비스를 계속 가리키는지 확인하세요. 복구 방법은 문제 해결 가이드를 참고하세요.
평소에는 구독 업데이트 후 현재 설정을 확인하고, 규칙 모드와 선택된 정책을 점검한 다음 연결을 설정하고 주요 앱으로 테스트하세요. 설정을 수정하기 전에 로컬 사본을 보관하면 업데이트 후 문제가 생겼을 때 원본과 비교할 수 있습니다. 문제가 생길 때마다 앱을 먼저 다시 설치하지 마세요. 정책, 구독 유효성, 시스템 네트워크 상태 문제는 설치 파일과 무관한 경우가 많습니다.