· 플랫폼별 사용 · 예상 읽는 시간 8분
iPhone용 Clash 클라이언트 설치: App Store 국가·지역 계정 및 구독 가져오기
iOS용 Clash 클라이언트를 App Store에서 받을 수 있는 조건과 해외 스토어 계정 이용 시 주의사항, 링크·파일·QR 코드로 설정을 가져온 뒤 첫 연결을 확인하는 방법을 안내합니다.
App Store에서 앱을 찾을 수 없다면: 스토어 국가·지역과 호환성 확인
먼저 개발자 공식 배포 페이지에서 App Store 앱 페이지를 연 다음, 개발자 이름과 최소 iOS 버전, 설정 파일 형식을 확인하세요. 검색 결과에 Clash라는 이름이 있어도 그것만으로 mihomo 코어를 사용하는지, 기존 Clash YAML 파일을 불러올 수 있는지 알 수 없습니다.
- 스토어 국가·지역: 앱 페이지에 현재 지역에서 사용할 수 없다고 표시되면, 먼저 「미디어 및 구입 항목」 계정의 국가 또는 지역을 확인하세요. 앱의 제공 여부는 App Store의 국가·지역별 카탈로그에 따라 달라집니다. 시스템 언어를 바꾸거나 네트워크를 전환해도 계정의 스토어 지역은 바뀌지 않습니다.
- 최소 iOS 버전: 앱 페이지의 「정보」→「호환성」에서 요구 버전을 확인한 뒤, 「설정」→「일반」→「정보」에서 현재 iOS 버전을 확인하세요. 예를 들어 앱이 iOS 17.0 이상을 요구하는데 기기가 iOS 16.7이라면, 스토어 지역을 바꿔도 버전 요구사항을 충족할 수 없습니다.
- 구독 형식: 완전한 Clash YAML 설정 파일이 있다면 해당 형식을 지원한다고 명시한 앱을 선택하세요. 앱이 자체 설정 형식만 지원한다면 구매 전에 구독 제공업체에 호환되는 가져오기 방법이 있는지 확인하세요. 단일 노드 링크를 가져올 수 있다고 해서 전체 규칙 기반 설정 파일도 읽을 수 있는 것은 아닙니다.
Apple 계정 국가·지역: 구입 계정 확인 후 변경 여부 결정
일반적인 확인 경로는 「설정」→「사용자 이름」→「미디어 및 구입 항목」→「계정 보기」→「국가/지역」입니다. 메뉴 이름은 iOS 버전에 따라 다를 수 있습니다. 여기서 확인할 것은 구입 항목에 사용하는 계정이며, 「일반」의 「언어 및 지역」 설정이 아닙니다.
현재 계정의 국가·지역을 변경하기 전에 확인할 사항
계정 잔액, 구독, 가족 공유 상태와 변경하려는 지역의 결제 요건을 먼저 확인하세요. Apple은 잔액을 모두 사용하고, 변경을 방해하는 구독을 취소한 뒤 현재 구독 기간이 끝날 때까지 기다리거나, 가족 공유 제한을 해결하도록 요구할 수 있습니다. 새 지역에서 유효한 결제 수단과 청구 주소가 필요할 수도 있습니다. 변경 전에 자주 사용하는 앱을 계속 다운로드할 수 있는지 확인하세요. 국가·지역 변경은 언제든 되돌릴 수 있는 설정이 아닙니다.
다른 국가·지역의 계정을 이미 보유한 경우
현지 이용 조건을 충족하는 본인 계정이 있고 그 계정으로 앱을 받아야 한다면, 먼저 해당 계정의 이중 인증 코드를 받을 수 있는지 확인하세요. 구입 계정만 전환하려면 「미디어 및 구입 항목」에서 변경하세요. Apple 계정 설정 페이지 아래쪽에서 iCloud 전체 계정에서 로그아웃하지 마세요. 앱 구입 내역은 다운로드 당시 사용한 계정에 연결되므로 나중에 업데이트하거나 다시 다운로드할 때 해당 계정이 필요할 수 있습니다. 공유 계정은 사용하지 말고, 다른 사람에게 비밀번호나 인증 코드를 알려주지 마세요.
구독 가져오기: 링크·YAML 파일·QR 코드 중 무엇을 선택할까
출처를 확인한 다음 내용도 확인하세요. HTTP 또는 HTTPS 링크는 갱신 가능한 구독 주소일 수도 있고 로그인 페이지일 수도 있습니다. QR 코드에는 구독 주소가 들어 있을 수도, 단일 노드 정보만 들어 있을 수도 있습니다. 완전한 Clash 설정 파일에는 일반적으로 최상위 필드로 proxies, proxy-providers, proxy-groups, rules가 포함되지만, 구체적인 구성은 설정마다 다릅니다. 원격 프로바이더를 사용한다면 클라이언트가 해당 필드를 지원하고 원격 콘텐츠를 가져올 수 있는지도 확인하세요.
- 구독 링크: 구독 제공업체 페이지에서 클라이언트와 호환되는 출력 형식을 선택한 뒤 URL 전체를 복사하세요. 앱의 「설정」 또는 「구독」 메뉴에서 추가 화면을 열고 URL 가져오기를 선택합니다. 저장한 다음 직접 새로고침하고 새 설정을 현재 설정으로 지정하세요. 갱신 시 401 또는 403 오류가 발생하면 토큰 만료 여부, 주소를 빠짐없이 복사했는지, 선택한 구독 메뉴가 올바른지 확인하세요. 200 응답을 받았는데도 파싱에 실패한다면 실제 내용이 HTML 로그인 페이지이거나 다른 형식인지 확인하세요.
- 로컬 파일: 신뢰할 수 있는
.yaml또는.yml파일을 「파일」 앱에 저장한 뒤 클라이언트의 파일 가져오기 메뉴에서 선택하세요. 클라이언트가 공유 확장 기능을 제공한다면 「파일」 앱에서 파일을 길게 누른 다음 「공유」를 선택해 해당 앱으로 전달할 수도 있습니다. 원본은 보관하고 복사본을 수정하세요. 파싱 오류가 발생하면 로그에 표시된 줄과 바로 위 줄의 들여쓰기, 콜론, 목록 계층을 확인하세요. 웹페이지나 텍스트 파일의 확장자만 YAML로 바꿔도 내용이 변환되지는 않습니다. 로컬 설정을 갱신하려면 보통 새 파일을 다시 가져와야 합니다. - QR 코드: 신뢰할 수 있는 QR 코드를 다른 기기에 표시한 다음 클라이언트의 QR 코드 스캔 메뉴에서 가져오세요. 같은 iPhone에 있는 스크린샷을 사용하려면 클라이언트가 사진 앱에서 QR 코드를 인식하는 기능을 지원해야 합니다. 해당 메뉴가 없다면 제공업체 페이지로 돌아가 링크를 복사하세요. 스캔 후 노드 하나만 추가됐다면 정책 그룹과 규칙까지 가져온 것으로 볼 수 없습니다. 카메라가 열리지 않으면 「설정」→「개인정보 보호 및 보안」→「카메라」에서 권한을 확인하세요.
첫 연결: 시스템 VPN·현재 설정·규칙 적용 여부 확인
- 현재 설정을 확인합니다. 가져온 뒤 설정 상세 화면에서 예상한 노드와 정책 그룹이 나타나는지 확인하세요. 정책 그룹이 원격 프로바이더에 의존한다면 먼저 새로고침하고 가져오기 결과를 확인합니다. 수동 선택 그룹에서 노드 하나를 지정해 문제를 확인하는 동안 출구 노드가 자동으로 바뀌지 않도록 하세요.
- VPN 구성 추가를 허용합니다. 시스템 VPN을 사용하는 클라이언트를 처음 실행하면 iOS에서 VPN 구성 추가를 허용하고 본인 인증을 요구할 수 있습니다. 직접 요청한 직후에 표시된 요청만 승인하세요. 이후 「설정」→「일반」→「VPN 및 기기 관리」→「VPN」에서 상태를 확인할 수 있습니다. 회사나 학교에서 관리하는 기기에서 구성을 추가할 수 없다면 관리자에게 문의하세요.
- 규칙 모드에서 두 가지 연결 경로를 확인합니다. 설정에서
DIRECT로 지정된 도메인 하나와 프록시 정책 그룹으로 지정된 도메인 하나를 골라 각각 요청을 보내세요. 클라이언트에 연결 로그가 있다면 도메인, 적용된 규칙, 정책 그룹, 최종 출구를 기록하세요. 웹페이지가 열리거나 상태 표시줄에 VPN 아이콘이 나타나는 것만으로는 해당 요청이 프록시를 거쳤다고 판단할 수 없습니다. - 네트워크를 바꿔 다시 확인합니다. 먼저 Wi‑Fi에서 테스트한 뒤 셀룰러 네트워크로 전환해 같은 노드와 테스트 도메인으로 다시 시도하세요. 한 네트워크에서만 실패한다면 설정을 바꾸기 전에 Wi‑Fi에 포털 로그인이 필요한지, 셀룰러 데이터 사용이 허용되어 있는지, 도메인 조회 단계와 연결 단계 중 어디서 실패하는지 확인하세요.
iOS 클라이언트의 VPN 연결은 보통 시스템의 Network Extension을 사용합니다. 앱이 Clash 설정을 지원하더라도 데스크톱 버전의 tun, mixed-port, external-controller 필드가 그대로 적용된다는 뜻은 아닙니다. 특정 트래픽을 가로채거나 로컬 포트를 열거나 사용자 지정 DNS를 사용하는 기능은 앱과 내장 코어의 구현에 따라 다릅니다.
설정을 가져왔는데 웹페이지가 열리지 않을 때: 실패 단계별 점검
| 증상 | 우선 확인할 항목 |
|---|---|
| 가져오기는 완료됐지만 정책 그룹이 비어 있음 | proxy-providers를 정상적으로 가져왔는지 확인하고 클라이언트가 프로바이더 형식을 지원하는지 확인하세요. 단일 노드 QR 코드를 스캔했다면 전체 설정을 다시 요청하세요. |
| VPN은 연결됐지만 요청이 직접 연결로 처리됨 | 직접 연결 모드가 선택되어 있는지 확인하세요. 규칙 모드라면 요청이 먼저 직접 연결 규칙에 적용됐는지도 확인합니다. 프록시 정책 그룹에서 현재 선택한 항목이 DIRECT인지도 살펴보세요. |
| 직접 연결은 되지만 프록시 요청이 시간 초과됨 | 같은 네트워크에서 정상 작동이 확인된 다른 노드로 전환해 보세요. 로그에 DNS 오류가 있으면 노드 도메인의 DNS를 확인하세요. 연결 시간 초과나 인증서 오류가 발생하면 각각 서버 주소와 포트, 기기의 날짜 및 시간을 확인하세요. |
| VPN을 켠 뒤 직접 연결과 프록시가 모두 실패함 | 먼저 VPN 연결을 끊고 기본 네트워크가 정상인지 확인하세요. 다른 VPN이나 DNS 설정이 테스트에 영향을 주는지도 살펴보세요. 한 번에 한 항목만 변경하고 변경 전후 결과를 기록해 구독, 노드, DNS를 동시에 바꾸지 않도록 하세요. |
예를 들어 로그에서 테스트 도메인에 최종적으로 MATCH,DIRECT가 적용된 것으로 표시된다면 해당 요청이 직접 연결 기본 규칙에 들어간 것입니다. 이 경우 예상한 규칙이 있는지, 순서가 올바른지, 규칙 세트가 정상적으로 로드됐는지 먼저 확인하세요. 로그에 요청이 예상한 프록시 그룹으로 들어간 것이 표시되는데 노드 연결이 시간 초과된다면 그때 노드와 현재 네트워크를 집중적으로 점검하면 됩니다. 이렇게 하면 규칙 분기 문제와 노드 연결 불가 문제를 구분할 수 있습니다.