iOS용 Clash 클라이언트 설치 및 설정 파일 가져오기

먼저 확인하세요: Clash 설정 지원이 mihomo 코어 사용을 의미하지는 않습니다

iPhone용 프록시 클라이언트는 세 가지를 따로 확인해야 합니다. 현재 App Store 지역에서 설치할 수 있는지, 보유한 설정 형식을 읽을 수 있는지, 노드에서 사용하는 프로토콜을 지원하는지입니다. 앱 이름에 Clash가 들어가거나 소개에 “Clash 구독 지원”이라고 적혀 있다는 것만으로 mihomo 설정 항목을 모두 지원한다고 볼 수는 없습니다.

Clash YAML은 설정 형식이고, mihomo는 프록시 코어이며, iOS 클라이언트는 설정 관리와 노드 선택, 시스템 네트워크 확장을 담당합니다. 일부 클라이언트는 YAML을 가져온 뒤 자체 내부 형식으로 변환하고, 다른 클라이언트는 노드만 추출해 기존 규칙과 DNS 설정은 가져오지 않습니다. 따라서 “가져오기 성공”과 “원래 설정대로 작동”하는지는 별도로 확인해야 합니다.

• 전체 설정: 일반적으로 proxies, proxy-groups, rules가 포함되며, DNS, 규칙 제공자와 노드 제공자가 들어갈 수도 있습니다.
• 노드 구독: 주로 서버 정보를 제공합니다. 가져온 뒤에도 정책 그룹과 트래픽 분기 규칙은 클라이언트나 별도의 설정에서 지정해야 합니다.
• 클라이언트 전용 형식: 앱 안내에 따라 가져와야 합니다. 파일 확장자만 .yaml로 바꿔서는 안 됩니다.

App Store에서 설치하기: 지역·개발자·시스템 요구 사항 확인

다운로드 페이지에서 App Store 찾기

1. 이 사이트의 다운로드 센터를 열고 iOS 플랫폼을 선택해 현재 안내 중인 클라이언트와 설치 방법을 확인하세요.
2. 해당 App Store 페이지에서 앱 이름, 개발자, 버전 기록, ‘호환성’ 항목의 최소 iOS 요구 사항을 확인하세요.
3. 앱 소개에서 지원하는 설정 형식을 확인하세요. Clash YAML, 원격 구독, 파일 가져오기와 필요한 프로토콜 지원 여부를 중점적으로 살펴보면 됩니다.
4. 가격과 구매 조건을 확인한 뒤 설치하세요. 설치 후 앱을 한 번 실행해 설정 관리와 연결 메뉴가 있는지 확인하고 설정을 가져오세요.

검색 결과에 이름이 비슷한 앱이 함께 표시될 수 있습니다. 아이콘만 보고 판단하거나 검색 광고 위치를 호환성의 근거로 삼지 마세요. App Store의 개발자 정보와 앱 자체 문서를 확인하는 편이 출처를 파악하는 데 도움이 됩니다.

App Store에서 찾을 수 없다면 계정 지역부터 확인하세요

App Store에서 앱을 이용할 수 있는지는 주로 구매에 사용하는 Apple 계정의 국가 또는 지역에 따라 달라집니다. 프록시를 켠다고 자동으로 지역이 바뀌지는 않습니다. ‘설정’ → ‘사용자 이름’ → ‘미디어 및 구입 항목’ → ‘계정 보기’ → ‘국가/지역’에서 확인할 수 있습니다. iOS 버전에 따라 메뉴 이름은 조금 다를 수 있습니다. 지역 변경은 잔액, 기존 구독, 결제 수단에 영향을 줄 수 있으므로 Apple의 안내를 먼저 확인하고, 앱 하나를 설치하기 위해 무리하게 변경하지 마세요.

“현재 국가 또는 지역에서는 이 앱을 사용할 수 없습니다”라는 메시지가 표시되면 현재 지역에서 설치할 수 있고 필요한 설정 형식을 지원한다고 명시된 클라이언트를 우선 선택하세요. 모르는 사람이 공유한 Apple 계정을 사용하거나, 출처가 불분명한 기업용 인증서 또는 기기 관리 권한을 허용해 프록시 도구를 설치하지 마세요.

구독 링크 가져오기: 저장·업데이트·설정 선택

원격 구독은 노드를 주기적으로 업데이트해야 할 때 적합합니다. 먼저 서비스 제공업체에서 Clash 전용 구독 주소를 받으세요. 같은 계정에서 Clash용, 범용 노드용, 다른 클라이언트용 형식을 함께 제공할 수 있으므로 링크 모양만으로 응답 형식을 판단할 수 없습니다.

1. 원본 주소 복사: 제공업체의 복사 버튼을 사용해 웹페이지 제목이나 앞뒤 공백, 메신저가 덧붙인 문장부호까지 복사하지 않도록 하세요.
2. 원격 설정 추가: 클라이언트의 설정 관리 화면에서 ‘추가’, ‘URL에서 가져오기’, ‘원격 설정’과 같은 메뉴를 찾으세요. 앱마다 메뉴 구성이 다르며, 이 명칭은 기능을 설명하는 예시이지 모든 클라이언트에 공통으로 적용되는 경로는 아닙니다.
3. 첫 다운로드 실행: 알아보기 쉬운 이름을 입력해 저장한 다음, 한 번 직접 업데이트하고 다운로드와 파싱이 끝날 때까지 기다리세요.
4. 가져온 내용 확인: 노드나 정책 그룹이 표시되는지 확인하세요. 앱에서 규칙 수를 보여 준다면 규칙도 함께 불러왔는지 살펴보세요.
5. 현재 설정으로 선택: 일부 앱에서는 설정을 여러 개 저장할 수 있지만 동시에 활성화할 수 있는 설정은 하나뿐입니다. 저장한 뒤 방금 가져온 항목을 선택하세요.

업데이트에 실패하면 먼저 오류 종류를 확인하세요. 401 또는 403은 접근 권한이나 서버 제한과 관련된 경우가 많고, 404가 표시되면 주소가 유효한지 확인해야 합니다. 파싱 오류라면 응답 내용과 클라이언트의 지원 범위를 살펴보세요. 브라우저에서 주소가 열린다고 해서 YAML이 반환된다는 뜻은 아닙니다. 로그인 페이지나 오류 메시지가 표시될 수도 있습니다.

파일과 QR 코드로 가져오기: 내용 확인 후 가져오기 방법 선택

‘파일’ 앱에서 YAML 가져오기

로컬 파일은 기존 설정을 옮기거나 구독 다운로드를 일시적으로 사용할 수 없을 때 유용합니다. 먼저 .yaml 또는 .yml 파일을 ‘파일’ 앱의 ‘나의 iPhone’ 또는 iCloud Drive에 저장한 다음, 클라이언트에서 ‘파일에서 가져오기’를 선택하세요. 앱이 공유 확장 기능을 지원한다면 ‘파일’ 앱에서 파일을 길게 눌러 ‘공유’를 선택한 뒤 해당 클라이언트로 보낼 수도 있습니다.

• 파일은 UTF-8 인코딩의 일반 텍스트여야 합니다. 서식 있는 문서나 웹페이지 보관 파일, PDF의 확장자만 바꾼 파일은 사용할 수 없습니다.
• YAML 들여쓰기에는 공백을 사용하세요. 편집기에서 들여쓰기가 탭으로 바뀌지 않도록 하고, 따옴표와 콜론도 원래 형식을 유지해야 합니다.
• 설정에 포함된 외부 리소스 주소를 확인하세요. 기본 파일이 로컬에 있어도 proxy-providers나 rule-providers까지 오프라인에서 사용할 수 있는 것은 아닙니다.
• 가져오면 일반적으로 앱 내부에 사본이 생성됩니다. ‘파일’ 앱에서 원본을 수정해도 자동으로 동기화되지 않을 수 있으므로 다시 가져와야 할 수 있습니다.

아래 내용은 구조를 확인하기 위한 일부 예시이며, 그대로 연결할 수 있는 전체 설정이 아닙니다. ‘수동 선택’이라는 정책 그룹을 참조하므로 실제로 사용하려면 해당 정책 그룹과 사용 가능한 노드도 설정해야 합니다.

mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - MATCH,수동 선택

가져온 뒤 정책 그룹을 찾을 수 없다는 메시지가 나오면 rules에서 참조하는 이름과 proxy-groups의 이름이 정확히 일치하는지 확인하세요. 데스크톱 설정을 iPhone으로 옮길 때는 노드 부분만 볼 것이 아니라 로컬 파일 경로, 리스닝 포트, 코어 전용 설정 항목도 확인해야 합니다.

QR 코드에는 노드 하나만 들어 있을 수도 있습니다

QR 코드는 텍스트를 담는 수단일 뿐, 하나의 통일된 구독 형식이 아닙니다. HTTPS 구독 주소, ss://나 trojan:// 같은 단일 노드 링크, 또는 특정 앱 전용 가져오기 명령이 들어 있을 수 있습니다. 가져온 뒤 노드 하나만 표시된다면 QR 코드에 애초에 노드 하나만 담겼을 가능성이 큽니다. 기존 규칙까지 가져왔다는 뜻은 아닙니다.

1. 클라이언트에서 QR 코드 스캔 기능을 여세요. 처음 사용할 때는 필요한 경우 카메라 접근을 허용하세요.
2. QR 코드가 같은 휴대전화에 있다면 클라이언트가 지원하는 사진 보관함 인식 기능을 사용하세요. 해당 기능이 없다면 제공업체에 원본 텍스트 링크를 요청하세요.
3. 인식 후 미리보기에서 원격 설정 주소인지, 노드 정보인지, 알 수 없는 명령인지 확인한 다음 저장 여부를 결정하세요.
4. 가져오기가 끝나면 설정 목록과 정책 그룹을 확인하세요. ‘스캔 성공’ 메시지만 보고 끝내지 마세요.

QR 코드 이미지에도 인증 정보가 포함될 수 있으므로 공개 인식 서비스에 업로드하지 마세요. 카메라 권한을 거부했다면 시스템 설정에서 해당 앱을 찾아 권한을 확인하세요. iOS 18의 경우 보통 ‘설정’ → ‘앱’ → ‘앱 이름’에서 찾을 수 있습니다.

VPN 연결: 시스템 터널 권한을 허용하고 출구 노드 선택

설정을 준비한 뒤 프록시 정책 그룹에서 사용할 수 있는 노드를 하나 선택하고 클라이언트의 연결 스위치를 켜세요. 처음 연결할 때는 VPN 구성을 추가할지 묻는 시스템 팝업이 표시되는 경우가 많습니다. 방금 설치한 클라이언트에서 요청한 것이 맞는지 확인한 뒤 안내에 따라 허용하고 시스템 인증을 완료하세요. 이 권한은 앱이 시스템 네트워크 확장 기능으로 트래픽을 처리하도록 허용할 뿐, 모든 요청이 원격 노드를 거친다는 뜻은 아닙니다.

1. 시스템 설정 확인: ‘설정’ → ‘일반’ → ‘VPN 및 기기 관리’ → ‘VPN’에서 해당 항목과 연결 상태를 확인하세요. VPN만 관리하면 되며, 별도의 기기 관리 프로파일을 설치할 필요는 없습니다.
2. 프록시 모드 확인: 평소에는 규칙 모드를 사용하세요. 클라이언트에 전역 모드가 있다면 진단할 때만 잠시 사용하고 실제 출구 노드를 지정하세요.
3. 정책 그룹 선택 확인: 규칙에 지정된 그룹에서 DIRECT를 선택했다면 시스템에 VPN 연결로 표시되더라도 요청은 직접 연결됩니다.
4. 연결을 먼저 테스트한 뒤 조정: 먼저 기본 설정으로 한 번 연결해 보세요. DNS, 주문형 연결, 기타 고급 기능은 그다음 검토해 여러 변수를 동시에 바꾸지 않도록 하세요.

데스크톱에서 흔히 쓰는 ‘시스템 프록시’와 ‘TUN’ 스위치를 iOS에 그대로 적용할 수는 없습니다. iOS 클라이언트는 보통 Network Extension의 Packet Tunnel을 사용해 트래픽을 처리하며, 화면에 ‘TUN’이 표시되는지는 앱 설계에 따라 다릅니다. 데스크톱 안내를 그대로 따라 Wi-Fi의 HTTP 프록시 항목에 127.0.0.1:7890을 입력하지 마세요. 이 주소는 iPhone 자체를 가리키며, 앱이 해당 포트에서 실제로 연결을 수신할 때만 의미가 있습니다.

연결 확인 및 문제 해결

같은 요청으로 규칙 적용과 출구 확인

평소 프록시가 필요한 HTTPS 페이지를 열고 클라이언트의 연결 정보나 로그 화면을 함께 확인하세요. 규칙, 정책 그룹, 출구 노드가 표시된다면 이 세 항목을 모두 대조하세요. 도메인만 나타나고 응답이 성공하지 않았다면 DNS, 핸드셰이크 또는 원격 연결에 문제가 있을 수 있습니다. 출구 IP 조회 서비스를 사용할 때도 해당 요청 자체가 직접 연결로 분기되지 않았는지 확인하세요.

지연 시간 테스트는 지정한 테스트 대상의 당시 응답 상태만 보여 줍니다. 예를 들어 화면에 120 ms가 표시되어도 다운로드 속도를 뜻하지 않으며, 동영상이나 게임에 사용하는 서버에 연결할 수 있다는 보장도 없습니다. 이 수치는 읽는 방법을 보여 주는 예시일 뿐, 이 사이트에서 측정한 결과가 아닙니다. 실제 연결은 페이지 요청을 포함해 Wi-Fi와 셀룰러 네트워크에서 각각 확인하세요.

설정 업데이트와 문제 기록 남기기

노드에 연결할 수 없다면 먼저 원격 설정을 업데이트하고, 정책 그룹에서 여전히 사용 가능한 노드를 선택했는지 확인하세요. 앱에서 자동 업데이트를 지원한다면 하루 한 번부터 설정하고, 구체적인 주기는 서비스 제공업체의 안내를 따르세요. 매분 업데이트할 필요는 없습니다. 규칙 세트 업데이트와 노드 구독 업데이트는 별도로 진행될 수 있으므로 각각 결과를 확인하세요.

문제를 문의할 때는 iOS 버전, 클라이언트 버전, 설정 유형, Wi-Fi 또는 셀룰러 네트워크 사용 여부, 오류가 발생한 시간과 작업 순서를 기록하세요. 로그를 공유하기 전에 구독 주소, 노드 비밀번호, 토큰을 가리세요. ‘앱 설치 → 설정 가져오기 → 설정 선택 → VPN 권한 허용 → 요청 확인’ 순서로 하나씩 점검하면 반복해서 재설치하는 것보다 문제 지점을 찾기 쉽습니다. 자세한 가져오기 및 문제 해결 방법은 입문 가이드에서, 설정 개념은 전체 문서에서 확인할 수 있습니다.