iOS Clash 클라이언트 설치: App Store 다운로드 및 설정 파일 가져오기

설치 전 확인: 클라이언트와 설정 형식

iPhone에서 Clash 설정을 사용하려면 이름에 Clash가 들어간 앱을 찾는 데 그치지 말고, 어떤 설정 형식과 코어를 지원하는지, 현재 App Store 지역에서 다운로드할 수 있는지 확인해야 합니다. 원래 Clash 프로젝트는 공식 iOS 클라이언트를 통합해 배포하지 않습니다. iOS 호환 앱은 여러 개발자가 제공하므로 인터페이스와 기능이 서로 다릅니다.

‘프록시 구독 지원’이 ‘완전한 Clash YAML 지원’을 뜻하는 것은 아닙니다. 노드만 읽는 클라이언트가 있는가 하면, 정책 그룹과 규칙까지 가져올 수 있는 클라이언트도 있고, 자체 형식만 지원하는 앱도 있습니다. Mihomo는 흔히 Clash Meta라고 불리는 코어입니다. Mihomo용 설정에는 구형 Clash 코어에서 지원하지 않는 프로토콜이나 필드가 포함될 수 있으므로, 가져오기 전에 앱 설명에서 설정 형식과 코어 정보를 확인하세요.

• 완전한 YAML 파일이 있는 경우: proxies, proxy-groups, rules를 지원하는지 확인하고, 설정에 사용된 프로토콜도 지원되는지 살펴보세요.
• 구독 링크만 있는 경우: 제공업체가 Clash 또는 Mihomo 설정을 제공하는지, 노드 URI만 포함된 구독인지 확인하세요.
• 노드 하나만 있는 경우: ss:// 등의 노드 URI는 완전한 YAML이 아닙니다. 보통 ‘노드 추가’ 또는 URI 가져오기 메뉴에서 추가해야 합니다.
• 여러 기기에서 사용할 경우: iPad와 iPhone의 App Store 제공 여부, 최소 지원 OS 버전, 구매 내역을 각각 확인하세요.

App Store에서 다운로드: 지역·시스템·개발자 확인

다운로드 페이지에서 앱 상세 페이지로 이동

1. 이 사이트의 클라이언트 다운로드 페이지를 열고 iOS 항목을 선택한 다음 App Store의 앱 상세 페이지로 이동하세요.
2. 앱 이름과 개발자를 확인하고 ‘호환성’ 및 버전 안내를 읽어 보세요. 이름이 비슷해도 설정 형식이 완전히 다른 앱일 수 있습니다.
3. ‘받기’ 또는 가격 버튼을 누르고 안내에 따라 Apple 계정을 인증하세요. 가격과 지원 기기는 현재 App Store 페이지를 기준으로 확인해야 합니다.
4. 처음 실행한 뒤 ‘정보’ 또는 ‘설정’에서 앱 버전과 코어 정보를 먼저 확인하고, 사용할 설정 형식을 선택하세요.

‘현재 국가 또는 지역에서는 이 앱을 사용할 수 없습니다’라는 안내가 표시되면 보통 구독 문제가 아니라 App Store 배포 지역 문제입니다. App Store 다운로드 지역은 주로 구매에 사용하는 Apple 계정의 국가 또는 지역에 따라 결정됩니다. ‘설정’ → ‘일반’ → ‘언어 및 지역’을 바꿔도 App Store 계정 지역은 변경되지 않습니다.

앱을 찾을 수 없거나 설치할 수 없는 경우

• 시스템 버전 확인: ‘설정’ → ‘일반’ → ‘정보’에서 iOS 또는 iPadOS 버전을 확인한 뒤 App Store에 표시된 최소 요구 사항과 비교하세요.
• 구매 계정 확인: ‘설정’ → ‘Apple 계정’ → ‘미디어 및 구입 항목’에서 현재 사용 중인 계정을 확인하세요. 구형 시스템에서는 ‘Apple ID’로 표시될 수 있습니다.
• 코어와 앱 구분: 데스크톱 설치 파일은 iPhone에서 직접 실행할 수 없습니다. 로컬 파일 가져오기 메뉴도 앱 설치 메뉴가 아닙니다.

계정 지역을 변경하면 잔액, 구독, 결제 수단에 영향을 줄 수 있습니다. 변경 전 Apple의 계정 변경 안내를 확인하세요. 앱을 다운로드하기 위해 출처가 불분명한 기기 관리 프로필을 설치하지 마세요.

구독 링크 가져오기: 원격 주소 저장 및 설정 불러오기

원격 설정은 노드와 규칙을 정기적으로 업데이트해야 할 때 적합합니다. 링크에는 보통 접근 인증 정보가 포함되므로 비밀번호처럼 안전하게 관리하세요. 여기서 말하는 ‘구독 업데이트’는 설정 내용을 다시 다운로드하는 것으로, App Store 앱 업데이트와는 다릅니다.

1. 설정 제공업체에서 전체 링크를 복사하고, https://로 시작하는지, 끝에 공백이나 줄바꿈이 섞이지 않았는지 확인하세요. URL의 쿼리 매개변수를 임의로 삭제하지 마세요.
2. 클라이언트에서 ‘설정’ 또는 ‘구독’ 메뉴를 찾아 원격 설정 추가, URL에서 가져오기 등의 기능을 선택하세요.
3. ‘일상 분기’처럼 알아보기 쉬운 이름을 입력하고 링크를 붙여 넣은 뒤 다운로드하세요. 처음에는 수동으로 업데이트해 성공 여부를 확인한 다음 자동 업데이트를 설정하는 것이 좋습니다.
4. 가져오기 결과와 파싱 안내를 확인하세요. 저장에 성공하면 해당 설정을 현재 설정으로 지정해야 합니다. 목록에 표시되는 것만으로는 활성화된 것이 아닙니다.
5. 정책 그룹에서 노드 개수와 선택 상태를 확인한 뒤 연결을 켜세요. 규칙 모드에서는 정책 그룹이 실수로 DIRECT에 머물러 있지 않은지도 확인하세요.

클라이언트에서 구독 유형을 선택하라고 하면 제공업체가 안내한 형식에 맞추세요. 노드 목록 구독만으로 규칙 그룹이 자동으로 추가되지는 않습니다. 완전한 설정을 ‘노드 구독’ 메뉴에 넣는 것이 적절하지 않을 수도 있습니다. 가져온 뒤 노드만 있고 기존 규칙이 없다면, 노드를 계속 바꾸기 전에 가져오기 유형부터 확인하세요.

파일·클립보드로 가져오기: 설정 본문과 링크 구분

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

설정을 ‘파일’ 앱의 ‘나의 iPhone’ 또는 iCloud Drive에 저장하세요. 클라이언트의 설정 페이지로 돌아가 파일에서 가져오기를 선택한 다음 시스템 파일 선택기에서 .yaml 또는 .yml 파일을 여세요. 일부 앱은 ‘공유’ 메뉴로 가져올 수도 있습니다. 대상 앱이 표시되는지는 지원하는 파일 형식에 따라 달라집니다.

로컬 파일을 가져오면 보통 설정 사본이 클라이언트에 저장되며, 원본 파일의 변경 사항이 자동으로 반영되지는 않습니다. 클라우드 드라이브의 원본을 수정한 뒤에는 클라이언트에서 다시 가져오거나 앱의 편집 기능을 사용하세요. 원격 링크로 만든 설정은 다음 업데이트 때 로컬 수정 사항이 덮어쓰일 수 있습니다. 계속 유지할 규칙은 클라이언트가 지원하는 오버라이드 또는 병합 기능에 넣으세요.

클립보드에 복사할 내용

• 완전한 YAML 텍스트: ‘클립보드에서 설정 가져오기’를 사용하세요. 복사할 때 들여쓰기를 유지하고 Markdown의 백틱 세 개는 함께 복사하지 마세요.
• HTTPS 링크: 원격 설정 메뉴를 사용하세요. URL을 YAML 본문으로 파싱하지 않도록 주의하세요.
• 노드 URI: 노드 가져오기 메뉴를 사용하세요. 원하는 트래픽 분기 구성을 만들려면 이후 규칙과 정책 그룹도 필요합니다.

iOS에서 다른 앱의 붙여넣기를 허용할지 물을 수 있습니다. 이 권한은 VPN 승인과 별개입니다. 이전에 거부했다면 입력창을 길게 눌러 직접 붙여 넣어 보세요. 해당 옵션을 제공하는 iOS 버전에서는 앱 설정에서 ‘다른 앱에서 붙여넣기’ 권한을 확인할 수 있습니다. iOS 18에서는 ‘설정’ → ‘앱’ → 해당 클라이언트에서 확인하세요.

최소 설정으로 YAML 파싱 확인하기

아래 설정은 가져오기와 규칙 파싱을 확인하기 위한 예시이며, 모든 연결이 직접 연결되고 프록시 노드는 포함하지 않습니다. 클라이언트에서 추가 필드를 요구하면 해당 앱의 설정 문서를 따르세요. 이 예시는 원격 프록시에 연결할 수 있는 구독이 아닙니다.

mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

YAML 들여쓰기에는 탭이 아닌 공백을 사용하세요. rules는 목록이며 각 규칙 앞의 하이픈은 문법의 일부입니다. 설정에 정의한 정책 그룹 이름은 규칙에서 참조하는 이름과 정확히 일치해야 합니다. 예를 들어 규칙이 ‘프록시 선택’을 가리킨다면 같은 이름의 정책 그룹이 설정에 있어야 합니다. 마지막 MATCH는 앞선 규칙에 일치하지 않은 연결을 처리하므로 보통 맨 끝에 둡니다.

첫 VPN 연결: 시스템 승인 및 연결 확인

설정을 준비한 뒤 클라이언트의 연결 스위치를 누르세요. Network Extension을 사용하는 클라이언트는 터널을 처음 만들 때 iOS에서 ‘VPN 구성을 추가하려고 합니다’라는 시스템 확인 창을 표시할 수 있습니다. 요청한 앱이 방금 설치한 클라이언트인지 확인하고 ‘허용’을 누른 뒤 기기 암호나 인증 절차를 진행하세요.

이 단계는 앱이 VPN 구성을 생성하도록 허용하는 것이며, 루트 인증서를 설치하거나 기기를 조직 관리에 등록하는 절차가 아닙니다. 일반적인 프록시 터널 연결에는 HTTPS 복호화를 위한 설정이 필요하지 않습니다. 이후 인증서 설치나 기기 관리 등록을 요구하면 구체적인 목적과 출처를 먼저 확인하세요.

1. ‘설정’ → ‘일반’ → ‘VPN 및 기기 관리’ → ‘VPN’에서 해당 클라이언트의 구성과 연결 상태를 확인하세요. 메뉴 위치는 시스템 버전에 따라 조금 다를 수 있습니다.
2. 클라이언트로 돌아가 현재 설정과 규칙 모드를 확인하세요. 터널이 중복 생성되어 문제가 생기지 않도록 다른 프록시 또는 VPN 앱은 잠시 중지하세요.
3. Safari에서 새 요청을 한 번 보내고, 클라이언트의 연결 기록에서 대상 도메인, 적용된 규칙, 정책 그룹, 최종 노드를 확인하세요.
4. 직접 연결되어야 하는 대상과 프록시를 거쳐야 하는 대상을 각각 테스트하세요. VPN이 연결됨으로 표시되어도 터널이 만들어졌다는 뜻일 뿐, 노드·DNS·규칙이 모두 올바르다는 보장은 없습니다.

호환 클라이언트는 보통 시스템 터널 인터페이스로 트래픽을 처리하지만, 적용 범위는 앱 구현과 시스템 정책에 따라 다릅니다. 데스크톱의 tun, auto-route, 라우팅 권한 설정을 그대로 가져오지 마세요. iOS 클라이언트에서는 해당 필드를 무시하거나 앱 화면에서 별도로 설정해야 할 수 있습니다. 규칙 모드는 처리 중인 연결을 어떻게 분기할지 정하며, 모든 연결이 프록시 노드를 거쳐야 한다는 뜻은 아닙니다.

가져오기 실패·연결 문제: 안내에 따라 원인 확인

문제를 해결할 때는 한 번에 한 종류의 설정만 변경하세요. 먼저 설정을 가져오고, 파싱을 확인한 다음 터널과 노드를 점검하고, 마지막으로 규칙과 DNS를 확인합니다. 다운로드 시간이 초과되면 터널을 끊은 상태에서 먼저 테스트하세요. 설정 주소에 접속하려면 프록시가 필요한 경우 업데이트에 기존 연결이 필요합니다. 아직 가져오기에 성공하지 못한 설정으로 연결할 수는 없습니다.

문의를 보낼 때는 클라이언트 버전, 시스템 버전, 오류 발생 시간과 민감 정보를 제거한 로그를 제공하세요. 구독 토큰, 노드 비밀번호, 전체 설정을 공개하지 마세요. 스크린샷에는 오류 문구와 설정 유형을 남기고 계정 및 인증 정보는 가리세요.

정기 업데이트와 기기 변경: 복구에 필요한 정보 보관

• 업데이트 출처 기록: 원격 구독과 로컬 파일을 구분하고 출처를 기록해 오래된 파일을 최신 구독으로 착각하지 않도록 하세요.
• 업데이트 전 백업: 사용자 규칙, 정책 그룹 선택, 필요한 오버라이드 설정을 보관하세요. 원격 업데이트는 설정 전체를 대체할 수 있습니다.
• 기기 변경 후 재확인: 앱 데이터가 옮겨졌더라도 설정을 계속 가져올 수 있는지 확인하고 시스템 안내에 따라 VPN 권한을 다시 허용하세요.
• 삭제 전 연결 해제: 연결을 끈 뒤 클라이언트를 제거하세요. 남은 구성이 있다면 시스템의 VPN 화면에서 해당 항목을 확인하고 삭제하세요.

설치가 끝나면 같은 흐름을 따라 결과를 확인하는 것이 가장 중요합니다. 출처가 신뢰할 수 있는 앱인지, 설정 형식이 맞는지, 시스템 승인이 완료됐는지, 연결 로그로 트래픽 경로를 확인할 수 있는지 점검하세요. 그러면 업데이트 실패나 특정 앱의 네트워크 문제도 무작정 재설치하지 않고 원인을 좁힐 수 있습니다.