iOS 클라이언트와 설정 호환성
iPhone에서 Clash 설정을 사용하려면 먼저 두 가지를 확인하세요. 앱이 iOS용인지, 구독 제공업체의 설정 형식을 지원하는지 확인해야 합니다. 데스크톱 설치 파일은 iPhone에 직접 설치할 수 없습니다. 앱 이름에 Clash가 들어가도 모든 mihomo 설정 항목을 지원한다는 뜻은 아닙니다.
Clash 클라이언트는 보통 설정 가져오기, 프록시 그룹 선택, 연결 전환 기능을 그래픽 인터페이스로 제공합니다. 기반 프록시 구현은 Clash, Clash Meta(mihomo) 또는 Clash 설정과 호환되는 다른 구현일 수 있습니다. 앱 아이콘이나 검색 이름만 보지 말고 앱 설명, 업데이트 내역, 설정 문서를 확인해 호환성을 판단하세요.
앱을 먼저 확인하고 구독 형식을 살펴보세요
- 플랫폼: App Store 상세 페이지에 iPhone 또는 iOS 호환 여부가 표시되어야 합니다. 이름만 같은 macOS 앱 페이지로 대신하면 안 됩니다.
- 형식: 앱이 전체 Clash YAML, 원격 설정 링크, 노드 목록 중 무엇을 지원하는지 확인하세요. 세 가지는 가져오는 방법이 서로 다릅니다.
- 기능: 설정에서 특정 프록시 프로토콜, 규칙 세트, mihomo 확장 항목을 사용한다면 현재 iOS용 클라이언트가 해당 기능을 지원하는지 확인하세요.
- 유지 관리: 업데이트 날짜, 시스템 요구 사항, 개발자 정보를 확인하세요. 설치 후에는 앱 버전을 기록해 두면 이후 호환성 문제를 파악하기 쉽습니다.
앱을 고를 때는 이 사이트의 다운로드 페이지에서 iOS 카테고리를 확인해 Clash Plus 등의 클라이언트를 찾아볼 수 있습니다. App Store에는 Stash처럼 Clash 설정을 지원하는 앱도 있습니다. 설정과 호환된다는 말이 같은 코어를 사용하거나 메뉴, 기능, 가격이 같다는 뜻은 아닙니다. 현재 사용 중인 스토어 지역에서 앱을 제공하는지는 App Store 상세 페이지에서 확인하세요.
App Store에서 다운로드 및 설치
설치 전 iOS 버전과 스토어 지역 확인
- iPhone에서 ‘설정’ → ‘일반’ → ‘정보’로 이동해 iOS 버전을 확인하세요. App Store 앱 상세 페이지의 ‘호환성’에서 최소 시스템 요구 사항을 확인합니다.
- ‘설정’ → Apple 계정 이름 → ‘미디어 및 구입 항목’ → ‘계정 보기’ → ‘국가/지역’으로 이동해 확인하세요. App Store에서 앱을 볼 수 있는지는 미디어 및 구입 항목에 사용하는 계정의 국가 또는 지역에 따라 달라집니다.
- 신뢰할 수 있는 프로젝트 안내나 이 사이트의 클라이언트 다운로드 페이지를 통해 App Store로 이동하세요. 스토어에서 직접 검색한다면 검색 순위만 보고 설치하지 말고 앱 이름, 개발자, 설명을 하나씩 확인하세요.
- ‘받기’ 또는 가격 버튼을 누르고 화면 안내에 따라 인증하세요. 유료 구매 및 구독 조건은 앱 상세 페이지를 기준으로 확인하고, 클라이언트 구매 비용과 노드 서비스 비용을 혼동하지 마세요.
- 설치가 끝나면 앱을 열어 설정 화면에 들어갈 수 있는지 먼저 확인한 다음 구독 링크를 준비하세요. 이 단계에서는 사용할 수 있는 노드가 아직 없을 수 있으므로 연결은 꺼 둬도 됩니다.
앱이 검색되지 않는다면 해당 지역에서 제공하지 않거나, 이름이 바뀌었거나, 일시적으로 내려갔거나, 시스템과 호환되지 않을 수 있습니다. 그렇다고 iPhone에서 Clash 설정을 사용할 수 없다는 뜻은 아닙니다. 개발자가 안내하는 App Store 링크에서 제공 상태를 확인하세요. 같은 이름의 앱을 찾으려고 출처가 불분명한 구성 프로파일을 다운로드하지 마세요.
스토어 계정의 국가 또는 지역을 변경하면 계정 잔액, 기존 구독, 결제 수단에 영향을 줄 수 있습니다. 앱 하나를 설치하려고 무작정 변경하지 말고 먼저 Apple의 계정 국가 및 지역 안내를 확인하세요. 회사나 학교에서 관리하는 iPhone은 앱 설치, VPN 추가, 계정 설정 변경이 제한될 수도 있습니다.
구독 링크 준비와 형식 확인
구독 링크는 보통 서비스 제공업체의 계정 페이지에서 발급하며, Clash 클라이언트가 노드, 프록시 그룹, 규칙을 가져오는 데 사용합니다. 앱을 설치한다고 사용할 수 있는 노드가 자동으로 생기지는 않습니다. App Store 앱 공유 링크도 구독 링크와는 다릅니다.
가져오기 전에 네 가지 확인
- 서비스 상태: 계정 이용 기간이 남아 있고 트래픽을 모두 사용하지 않았는지, 기기 수 또는 동시 연결 제한에 iPhone을 추가할 수 있는지 확인하세요.
- 출력 형식: 계정 페이지에서 Clash 형식 또는 해당 클라이언트 전용 형식을 선택하세요. mihomo 전용 형식이라면 iOS 클라이언트의 호환 안내도 확인해야 합니다.
- 전체 주소: 물음표 뒤의 매개변수까지 포함해 HTTPS 주소 전체를 복사하세요. 액세스 토큰을 빠뜨리거나 안내 페이지 주소를 복사하지 않도록 주의하세요.
- 보안 유지: 링크에 액세스 토큰이 포함될 수 있으므로 공유하면 설정 접근 권한도 함께 넘기는 셈입니다. 공개 스크린샷이나 단체 채팅, 타사 변환 사이트에 올리지 마세요.
| 받은 항목 | 권장 메뉴 | 확인할 점 |
|---|---|---|
| 원격 Clash YAML 링크 | URL에서 설정 추가 | 가져온 뒤 노드, 프록시 그룹, 규칙이 인식되는지 확인 |
| 로컬 YAML 파일 | 파일에서 가져오기 | 파일을 가져와도 원격 업데이트 주소가 자동으로 연결되지는 않음 |
| 단일 노드 공유 링크 | 노드 추가 또는 노드 가져오기 | 일반적으로 전체 트래픽 분산 규칙은 포함되지 않음 |
| 웹페이지 또는 JSON API 주소 | 먼저 제공업체에 확인 | 로그인 페이지나 오류 페이지는 YAML 설정으로 읽을 수 없음 |
전체 설정에는 최상위 항목으로 proxies, proxy-groups, rules가 자주 포함됩니다. proxy-providers를 사용해 원격 노드를 참조할 수도 있습니다. 인코딩된 노드 주소만 여러 개 들어 있는 경우 전체 설정으로 바로 가져올 수 있다고 단정할 수 없습니다. 형식 오류가 발생하면 앱을 반복해서 재설치하기보다 제공업체에 호환되는 형식으로 제공해 달라고 요청하세요.
구독 가져오기 및 설정 적용
URL에서 가져오는 순서
- Clash 클라이언트에서 설정 목록을 열고 새 설정을 추가한 다음 ‘URL에서’, ‘설정 다운로드’ 또는 이에 해당하는 메뉴를 선택하세요.
- ‘일상 사용-iPhone’처럼 알아보기 쉬운 이름을 입력하세요. 방금 복사한 구독 링크는 주소 입력란에 붙여 넣습니다. 이름과 주소를 각각 입력해 메모 문구가 링크에 섞이지 않도록 하세요.
- 다운로드하거나 저장하세요. 처음 구독을 가져오려면 현재 네트워크에서 구독 서버에 접속할 수 있어야 합니다. 사용할 수 있는 노드를 가져오지 않은 상태라면 클라이언트가 이 구독만으로 프록시 연결을 만들어 낼 수는 없습니다.
- 설정 목록으로 돌아가 오류 없이 항목이 파싱되었는지 확인한 다음 현재 설정으로 지정하세요. 목록에 추가하는 것만으로 설정이 적용되는 것은 아닐 수 있습니다.
- 프록시 그룹 또는 프록시 화면을 열어 노드가 표시되는지 확인하세요. 먼저 테스트할 노드를 하나 지정하고 연결을 시작하면 자동 선택이나 장애 조치까지 한꺼번에 고려하지 않고 문제를 확인할 수 있습니다.
설정에는 수동 선택, 자동 지연 시간 측정, 장애 조치 등 서로 다른 프록시 그룹이 있을 수 있습니다. 수동 그룹은 구성원을 직접 선택해야 하며, 자동 그룹은 설정된 테스트 주소와 간격, 선택 로직에 따라 작동합니다. 그룹 이름이 보인다고 구성원이 정상이라는 뜻은 아니므로 구성원 목록과 테스트 결과도 확인하세요.
구독 업데이트가 모든 설정을 초기화하는 것은 아닙니다
첫 연결 테스트가 성공한 뒤 앱에서 지원하는 자동 업데이트를 켜세요. 업데이트 간격을 지정할 수 있다면 우선 24시간으로 설정해 볼 수 있습니다. iOS의 백그라운드 작업은 시스템 스케줄에 따라 실행되므로 정해진 시간에 반드시 완료된다고 보장할 수 없습니다. 연결에 문제가 생기면 직접 한 번 업데이트하고 마지막 업데이트 시간과 오류 메시지를 확인하세요.
원격 업데이트를 하면 구독 파일에 직접 적용한 로컬 수정 사항이 덮어써질 수 있습니다. 규칙을 계속 조정해야 한다면 클라이언트에서 제공하는 오버라이드, 병합 또는 별도 규칙 기능을 우선 사용하고 적용 범위를 확인하세요. 복사본을 저장하지 않은 채 원격 설정을 수정한 뒤 다음 업데이트에도 변경 사항이 남아 있을 거라고 기대하지 마세요.
VPN 권한 허용 및 연결 확인
처음 연결 스위치를 켜면 iOS에서 앱이 VPN 설정을 추가하도록 요청하는 시스템 안내가 보통 표시됩니다. ‘허용’을 선택한 뒤 기기 암호, Face ID 또는 Touch ID로 인증하세요. 이 권한은 앱이 시스템 네트워크 터널을 만들도록 허용하는 것으로, Apple 계정 접근 권한을 주는 것은 아닙니다.
권한을 허용한 뒤 ‘설정’ → ‘일반’ → ‘VPN 및 기기 관리’ → ‘VPN’에서 추가된 설정을 확인할 수 있습니다. 조직에서 관리하는 기기라면 관리자 정책에 따라 설정이 제한될 수 있습니다. 제한을 우회하려고 출처를 모르는 관리 설정을 삭제하지 말고 기기 관리자에게 문의하세요.
iPhone에서는 데스크톱 시스템 프록시 설정을 그대로 따라 하지 마세요
iOS에서 이러한 연결은 보통 Network Extension의 Packet Tunnel을 통해 네트워크 트래픽을 처리합니다. 데스크톱 시스템 프록시에 127.0.0.1:7890을 입력하는 방식과는 다릅니다. 데스크톱 설정의 포트가 iPhone의 트래픽을 처리한다는 근거가 되지는 않으며, 데스크톱 설정의 tun 항목이 iOS 클라이언트에서도 작동한다고 볼 수 없습니다.
VPN이 연결됨으로 표시된다는 것은 터널이 만들어졌다는 뜻일 뿐, 노드가 작동하거나 트래픽 분기가 올바르다는 뜻은 아닙니다. 확인할 때는 터널 상태, 노드 연결 가능 여부, 규칙 적용 결과를 각각 살펴보세요.
- 터널 확인: Clash 클라이언트로 돌아가 연결 스위치가 켜져 있는지 확인하고, 시스템 VPN 화면에 연결됨으로 표시되는지도 확인하세요.
- 노드 확인: 현재 프록시 그룹의 구성원에 지연 시간 테스트를 실행하세요. 테스트 성공은 테스트 대상에 연결할 수 있다는 뜻입니다. 시간 초과는 테스트 주소에 접속할 수 없어서 발생할 수도 있으므로 이 결과만으로 노드가 고장 났다고 판단하지 마세요.
- 요청 확인: Safari에서
https://example.com/을 연 다음 프록시로 접속해야 하는 웹사이트도 방문하세요. 첫 번째 사이트는 기본 HTTPS 요청 확인용이며, 접속 지역을 판단하는 용도는 아닙니다. - 규칙 확인: 연결 기록이나 로그에서 해당 도메인을 찾아 적용된 규칙, 프록시 그룹, 최종 노드를 확인하세요. 규칙 결과가
DIRECT인 요청은 VPN을 켜도 자동으로 프록시를 거치지 않습니다. - 네트워크 변경: Wi-Fi와 셀룰러 네트워크에서 각각 확인하세요. 비교가 쉽도록 네트워크를 바꾸기 전후에 같은 노드와 같은 대상 사이트를 사용하세요.
처음에는 규칙 모드를 사용하는 것이 좋습니다. 분기 설정 문제인지 확인할 때 글로벌 모드를 잠시 사용할 수 있지만 테스트가 끝나면 원래 모드로 되돌리세요. 글로벌 모드로 만료된 구독, 잘못된 인증 정보, 호환되지 않는 프로토콜을 해결할 수는 없습니다. 다른 VPN이나 네트워크 필터링 앱이 현재 터널과 충돌할 수 있으므로 문제를 확인할 때는 활성 VPN 연결을 하나만 유지하세요.
가져오기 실패 및 인터넷 연결 문제 해결
| 증상 | 판단 기준 | 다음 단계 |
|---|---|---|
| 구독 다운로드 시 401 또는 403 오류 | 토큰 만료, 권한 부족 또는 서버 제한이 원인일 수 있음 | 계정 상태를 확인하고 유효한 링크를 다시 복사하세요. 필요한 경우 제공업체에 문의하세요. |
| 404 오류가 반환됨 | 구독 경로가 없거나 주소가 변경됨 | 계정 페이지에서 주소를 다시 확인하세요. 경로를 임의로 추측하지 마세요. |
| YAML 파싱 오류 발생 | 응답이 웹페이지, 오류 메시지 또는 호환되지 않는 설정일 수 있음 | 출력 형식을 확인하고 오류가 발생한 항목과 줄 번호를 기록하세요. |
| 가져오기는 성공했지만 노드가 없음 | 비어 있는 프록시 그룹만 있거나 원격 provider 가져오기에 실패했을 수 있음 | 노드 출처와 provider 업데이트 로그를 확인하세요. |
| VPN은 연결되지만 웹페이지가 열리지 않음 | 노드, 규칙, DNS 또는 네트워크 환경에 문제가 있을 수 있음 | 현재 노드, 연결 기록, DNS 오류를 차례로 확인하세요. |
| Wi-Fi에서는 되지만 셀룰러에서는 안 됨 | 셀룰러 권한, 네트워크 경로 또는 요금제 상태 차이가 원인일 수 있음 | ‘설정’ → ‘셀룰러’에서 앱 권한을 확인한 다음 다른 노드로 테스트하세요. |
DNS 및 Fake-IP 설정을 데스크톱에서 그대로 가져오지 마세요
노드 테스트는 통과했지만 도메인에 접속할 수 없다면 먼저 로그에 DNS 조회 시간 초과가 있는지 확인한 다음 설정의 DNS 항목과 클라이언트 지원 범위를 살펴보세요. Fake-IP는 매핑된 주소로 도메인과 연결을 연동하는 방식입니다. DNS 주소를 하나 더 추가한다고 모든 문제가 해결되는 것은 아닙니다. 일부 로컬 네트워크 서비스나 앱은 별도의 호환 설정이 필요할 수 있으므로, 무작정 모드를 바꾸면 새로운 변수가 생길 수 있습니다.
먼저 현재 iOS 클라이언트에 맞는 설정을 제공업체에서 받아 사용하고, 원본은 보관한 채 한 번에 한 항목씩 변경하세요. 구독에 클라이언트가 지원하지 않는 항목이 있다면 호환 설정을 사용하거나 문서에 따라 조정해야 합니다. mihomo 데스크톱에서 사용할 수 있는 모든 매개변수가 iOS에서도 지원된다고 볼 수는 없습니다.
문제 문의 시 재현에 필요한 정보 제공
- iPhone 모델, iOS 버전, Clash 클라이언트 이름과 앱 버전
- 구독 다운로드, 설정 파싱, VPN 권한 허용, 웹페이지 접속 중 어느 단계에서 실패했는지
- Wi-Fi와 셀룰러 네트워크에서 각각 나타난 결과와 선택한 노드가 같은지 여부
- 개인 정보를 가린 오류 메시지, 규칙 적용 기록, 문제가 발생한 시간
모든 설정을 먼저 삭제할 필요는 없습니다. 복구할 수 있도록 복사본을 저장한 뒤 수동 업데이트, 설정 다시 선택, 재연결 테스트를 진행하세요. 로컬 설정이 손상되었거나 VPN 설정 잔여 항목이 시작에 영향을 주는 것이 확실할 때만 앱 안내에 따라 초기화하세요. 기본 사용 방법은 사용 안내에서 확인하고, 연결 문제는 문제 해결에서 더 살펴보세요.