iOS에서 Clash 사용하기: App Store에서 클라이언트 다운로드 및 설정 가져오기

먼저 확인할 점: iOS에는 데스크톱 버전 Clash가 아닌 호환 클라이언트를 설치해야 합니다

Windows, macOS, Android에서 사용하는 Clash, Clash Meta 또는 mihomo 설정의 설치 파일을 iPhone에 그대로 복사해 실행할 수는 없습니다. iOS 앱은 Apple이 허용한 배포 방식을 통해 설치해야 하며, Network Extension의 Packet Tunnel 기능으로 트래픽을 처리합니다. 실제로는 App Store에서 Clash 설정, 프록시 구독 또는 해당 프로토콜을 읽을 수 있는 클라이언트를 받아야 합니다.

핵심은 앱 이름에 “Clash”가 들어가는지가 아니라, 내 설정 형식을 해석할 수 있는지입니다. 일부 iOS 클라이언트는 완전한 Clash YAML을 지원해 `proxy-groups`, `rules`, `rule-providers` 같은 필드를 인식합니다. 반면 일부 클라이언트는 서비스 제공자가 변환한 전용 구독만 받습니다. Shadowsocks, Trojan, VMess 같은 단일 노드 프로토콜은 지원하지만 Clash 설정 파일을 직접 가져올 수 없는 앱도 있습니다.

세 가지 조건으로 클라이언트 적합성 확인하기

설정 호환성: 제품 설명에 Clash YAML, Clash Meta 설정 또는 구독 제공자가 안내한 iOS 형식 지원 여부가 명시되어 있어야 합니다.
프로토콜 호환성: 설정에 사용하는 프로토콜이 클라이언트 지원 목록에 있어야 합니다. 프로토콜 이름이 같아도 전송 계층, TLS, Reality, 플러그인 매개변수 등의 확장 기능을 확인해야 합니다.
규칙 호환성: 트래픽 분할이 필요하다면 규칙 집합, 정책 그룹, DNS 설정을 지원하는지 확인하세요. 단일 노드 연결만 지원하는 앱으로는 복잡한 규칙을 완전히 재현할 수 없습니다.

mihomo는 Clash Meta 프로젝트에서 이후 사용된 커널 이름입니다. 설정에 mihomo 확장 필드가 포함되어 있다면 일반적인 Clash 호환이 완전한 호환을 의미하지는 않습니다. 일부 최신 프록시 매개변수, 규칙 유형 또는 DNS 동작은 특정 커널에서만 인식될 수 있습니다. 가져온 뒤 앱에 “알 수 없는 필드” 또는 “설정 구문 분석 실패”가 표시되면 구독이 만료되었다고 단정하기보다 오류가 가리키는 줄 번호와 필드를 먼저 확인하세요.

App Store에서 클라이언트 다운로드하기: 먼저 지역 및 구입 기록 확인

App Store에 표시되는 결과는 iPhone의 현재 위치보다 Apple ID에 설정된 국가 또는 지역의 영향을 받습니다. 어떤 앱은 한 지역에서는 보이지만 다른 지역에서는 검색되지 않을 수 있습니다. 이미 구입한 앱은 구입 기록에서 다시 다운로드할 수 있는 경우도 있습니다. 계정에서 반복적으로 로그아웃하거나 지역을 변경하기 전에 아래 순서대로 확인하세요.

방법 1: 직접 검색하고 개발자 정보 확인

「App Store」를 열고 오른쪽 아래의 「검색」을 누릅니다.
클라이언트의 전체 이름을 입력하세요. “Clash”만 검색하면 결과가 너무 광범위합니다.
앱 상세 페이지에서 개발자 이름, 아이콘, 최근 업데이트 날짜, 시스템 요구 사항, 지원 웹사이트를 확인합니다.
“호환성” 항목에서 현재 iOS 버전이 요구 사항을 충족하는지 확인하세요. 예를 들어 앱이 iOS 16.0을 요구하는데 기기가 iOS 15.8이라면 현재 버전을 설치할 수 없습니다.
가격 또는 다운로드 버튼을 누른 뒤 Face ID, Touch ID 또는 Apple ID 암호로 인증합니다.

이름이 같거나 비슷하다는 사실만으로 동일한 앱이라고 볼 수 없습니다. 개발자 이름, App Store 상세 페이지, 구독 제공자의 문서를 모두 대조해 확인하세요. App Store 링크를 받았다면 아이콘만 보고 고르지 말고 링크를 직접 열어 확인하는 것이 우선입니다.

방법 2: 구입 항목에서 다시 다운로드

이전에 같은 Apple ID로 앱을 받은 적이 있다면 「App Store」→오른쪽 위 계정 프로필→「구입 항목」 또는 「앱」을 차례로 열고 앱 이름을 검색하세요. 가족 공유를 사용 중이라면 “나의 구입 항목”과 가족 구성원의 항목을 구분해야 합니다. 앱이 현재 지역의 스토어에서 내려간 경우 구입 기록에서도 더 이상 다운로드할 수 없을 수 있으며, 이는 App Store의 현재 상태에 따라 달라집니다.

지역이 맞지 않을 때는 먼저 계정 제한 확인

Apple ID 지역 설정은 일반적으로 「설정」→상단의 Apple 계정→「미디어 및 구입 항목」→「계정 보기」→「국가 또는 지역」에 있습니다. 지역을 변경하려면 Apple에서 계정 잔액, 활성 구독, 대여 항목, 예약 주문, 가족 공유 관계를 먼저 정리하도록 요구할 수 있습니다. 또한 변경하려는 지역에서 유효한 결제 수단과 청구 정보가 필요할 수 있습니다.

앱 페이지에 “이 App은 현재 국가 또는 지역에서 사용할 수 없습니다”가 표시된다면 문제는 App Store 지역 설정에 있으며, 노드·DNS·시스템 프록시 장애가 아닙니다. 페이지는 열리지만 버튼에 기기 비호환이 표시된다면 시스템 버전 또는 하드웨어 호환성 문제입니다. 두 경우의 해결 방법은 서로 다릅니다.

첫 실행: “VPN 구성 추가” 시스템 알림 이해하기

클라이언트가 처음 프록시를 시작하면 iOS에 “VPN 구성을 추가해야 합니다” 또는 비슷한 시스템 알림이 표시됩니다. 승인하면 Face ID, Touch ID 또는 잠금 화면 암호로 인증하라는 메시지가 나타날 수 있습니다. 이 과정은 Network Extension의 VPN 구성을 만들어 앱이 선택한 트래픽을 로컬 Packet Tunnel로 전달하도록 합니다.

승인이 완료되면 상태 표시줄이나 제어 센터에 VPN 표시가 나타날 수 있습니다. 여기서 “VPN”은 iOS가 네트워크 터널 인터페이스를 통합해 표시하는 명칭이며, 클라이언트가 반드시 기존 기업용 VPN에 연결되었다는 뜻은 아닙니다. Clash 클라이언트는 일반적으로 이 터널에서 규칙 매칭, DNS 처리, 프록시 전달을 수행합니다.

첫 VPN 승인 절차

먼저 정상적으로 구문 분석되는 설정을 가져옵니다.
클라이언트 홈 화면에서 해당 설정을 선택하고 정책 그룹에서 사용할 수 있는 노드를 고릅니다.
“시작”, “연결” 또는 클라이언트에 표시된 해당 스위치를 누릅니다.
시스템에 VPN 구성 추가 알림이 표시되면 “허용”을 누릅니다.
Face ID, Touch ID 또는 기기 암호 인증을 완료합니다.
클라이언트로 돌아가 상태가 “중지됨”에서 “연결됨”으로 바뀌었는지 확인합니다.

처음에 “허용 안 함”을 눌렀다면 클라이언트의 시작 스위치를 다시 눌러 승인을 요청할 수 있습니다. 그래도 표시되지 않으면 「설정」→「일반」→「VPN 및 기기 관리」→「VPN」으로 이동해 해당 클라이언트의 구성이 이미 있는지 확인하세요. iOS 버전에 따라 문구는 조금 다를 수 있지만, 보통 「VPN 및 기기 관리」 안에 있습니다.

기존 VPN 구성으로 인한 충돌

iOS에서는 일반적으로 한 번에 하나의 개인용 VPN 터널만 활성 상태로 유지할 수 있습니다. 기업 기기의 주문형 VPN, 다른 프록시 클라이언트, 광고 차단 앱, 회사 관리 구성 등이 Network Extension을 동시에 사용하려 할 수 있습니다. 연결 스위치를 켜자마자 꺼지거나 다른 앱의 VPN 연결이 끊기는 현상이 나타날 수 있습니다.

「설정」→「VPN」을 열어 현재 실제로 연결된 구성이 무엇인지 확인합니다.
다른 네트워크 필터링 또는 VPN 앱을 잠시 끈 뒤 대상 클라이언트만 단독으로 테스트합니다.
기존 구성을 더 이상 사용하지 않는다면 해당 VPN 상세 페이지에서 삭제할 수 있습니다. 단, 조직에서 요구하는 관리 구성은 삭제하지 마세요.
감독 모드 기기에 설정이 조직에서 관리된다고 표시되면 관리자에게 제한 사항을 확인해야 합니다. 개인 앱으로 시스템 정책을 우회할 수는 없습니다.

방법 1: 구독 URL로 설정 가져오기

구독 URL은 노드와 규칙을 정기적으로 업데이트해야 할 때 적합합니다. 일반적으로 `https://`로 시작하는 주소이며, 클라이언트가 원격 콘텐츠를 다운로드해 로컬 설정으로 저장합니다. URL에는 계정 식별 정보가 포함될 수 있으므로 계정 인증 정보처럼 취급하고 채팅방, 스크린샷, 공개 웹페이지에 게시하지 마세요.

표준 가져오기 절차

구독 제공자의 제어판에서 iOS 또는 Clash 호환 구독 주소를 복사합니다.
클라이언트를 열고 「설정」, 「Profiles」 또는 비슷한 이름의 페이지로 이동합니다.
오른쪽 위의 “+”를 누르고 「URL에서 다운로드」, 「Download from URL」 또는 「구독」을 선택합니다.
URL 입력란에 전체 주소를 붙여 넣습니다. 이름에는 “일상 설정”처럼 알아보기 쉬운 이름을 입력할 수 있습니다.
「다운로드」, 「저장」 또는 「완료」를 누르고 구문 분석 결과를 기다립니다.
설정 목록으로 돌아가 방금 가져온 설정을 누른 뒤 현재 활성 설정으로 지정합니다.

클라이언트마다 메뉴 이름은 조금씩 다르지만 데이터 흐름은 같습니다. 구독 URL → 원격 콘텐츠 다운로드 → 설정 구문 분석 → 로컬 저장 → 활성 설정 지정 순서입니다. 구독 제공자가 전용 딥 링크를 설정한 경우가 아니라면 Safari에 URL만 붙여 넣는다고 자동으로 가져와지지는 않습니다.

업데이트 주기 설정 방법

노드 변경이 잦다면 자동 업데이트 주기를 12시간 또는 24시간으로 설정할 수 있습니다. 너무 자주 업데이트하면 요청 횟수가 늘고 서버의 빈도 제한에 걸릴 수 있습니다. 노드 이름, 트래픽 정보 또는 만료 시간이 바뀌지 않는다면 설정 상세 페이지에서 먼저 수동 업데이트한 뒤 마지막 업데이트 시간과 오류 메시지를 확인하세요.

가져오기 결과	문제가 발생한 계층	다음 단계
401 또는 403 오류	구독 인증	구독 주소를 다시 복사하고 계정 상태와 링크 재설정 여부를 확인합니다
시간 초과 오류	다운로드 경로	Wi-Fi와 셀룰러 네트워크를 전환하며 Safari에서 구독 도메인에 접속되는지 테스트합니다
YAML 구문 분석 실패	설정 형식	오류가 발생한 줄 번호를 확인하고 클라이언트가 해당 필드를 지원하는지 확인합니다
가져오기는 성공했지만 노드가 없음	구독 콘텐츠	웹페이지, 로그인 페이지 또는 빈 설정을 가져온 것은 아닌지 확인합니다
업데이트 후에도 이전 노드가 표시됨	로컬 캐시	활성 설정으로 다시 지정하고 필요한 경우 클라이언트를 종료한 뒤 재시작합니다

방법 2: “파일” 앱으로 YAML 설정 가져오기

로컬 파일은 오프라인 보관, 규칙 수동 수정 또는 일회성 설정을 받을 때 적합합니다. 파일 확장자는 보통 `.yaml` 또는 `.yml`이며 텍스트 인코딩은 UTF-8이어야 합니다. iOS의 “파일” 앱에서 iCloud Drive, 다운로드 폴더 또는 기기 내 폴더의 파일을 호환 클라이언트로 전달할 수 있습니다.

“파일” 앱의 공유 기능으로 가져오기

먼저 설정 파일을 「파일」 앱의 “다운로드” 또는 “나의 iPhone”에 저장합니다.
YAML 파일을 길게 누르고 「공유」를 누릅니다.
공유 시트에서 대상 클라이언트를 선택합니다. 표시되지 않으면 「더 보기」를 눌러 찾으세요.
클라이언트가 열리면 가져오기를 확인하고 설정에 알아보기 쉬운 이름을 지정합니다.
설정 목록으로 이동해 해당 파일을 선택하고 연결을 시작합니다.

다른 방법으로는 클라이언트의 설정 페이지에서 “+”를 누르고 「파일에서 가져오기」 또는 「Import File」을 선택한 다음 시스템 파일 선택기에서 YAML 파일을 찾을 수 있습니다. 두 방법 모두 최종적으로 파일을 클라이언트 샌드박스에 복사합니다. 이후 “파일” 앱의 원본을 수정해도 보통 클라이언트에 자동 동기화되지 않으므로 다시 가져와야 합니다.

가져오기 전 최소 구조 확인

일반적인 Clash 설정에는 프록시, 정책 그룹, 규칙이 포함됩니다. 아래 예시는 구조 관계만 보여 주며 사용할 수 있는 노드는 포함하지 않습니다. 실제 필드는 구독 제공자가 생성하고 클라이언트 지원 범위와 일치해야 합니다.

mixed-port: 7890
mode: rule
log-level: info

proxies:
  - name: Example-Node
    type: ss
    server: 192.0.2.10
    port: 443
    cipher: aes-128-gcm
    password: example-password

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - Example-Node
      - DIRECT

rules:
  - DOMAIN-SUFFIX,example.com,PROXY
  - MATCH,DIRECT

`mixed-port: 7890`은 데스크톱 Clash 설정에서 흔히 사용하는 혼합 프록시 수신 포트입니다. iOS 클라이언트는 주로 시스템 Packet Tunnel로 트래픽을 처리하므로 이 포트를 사용자에게 노출하거나 사용하지 않을 수 있습니다. 클라이언트가 포트 필드를 무시한다고 해서 반드시 오류인 것은 아니며, 해당 클라이언트의 설정 문서와 실행 로그를 기준으로 판단해야 합니다.

YAML은 들여쓰기에 민감하므로 일반적으로 공백을 사용하고 Tab을 섞지 마세요. 콜론 뒤 공백 누락, 목록 들여쓰기 오류, 복사 과정에서 따옴표가 다른 문자로 바뀌는 문제 때문에 구문 분석이 실패할 수 있습니다. 오류가 18번째 줄을 가리키더라도 실제 원인은 17번째 줄의 닫히지 않은 따옴표나 잘못된 들여쓰기일 수 있습니다.

파일은 가져와졌지만 규칙이 예상대로 작동하지 않음

먼저 클라이언트 모드가 “규칙”인지 “전체” 또는 “직접 연결”인지 확인하세요. 규칙 모드는 `rules`를 위에서부터 대조해 처음 일치하는 규칙에서 멈춥니다. 전체 모드는 일반적으로 모든 처리 대상 트래픽을 하나의 정책으로 보내고, 직접 연결 모드는 프록시를 우회합니다. 메뉴에는 Rule, Global, Direct로 표시될 수도 있습니다.

설정이 원격 `rule-providers` 또는 `proxy-providers`를 참조한다면 로컬 YAML은 진입점일 뿐입니다. 처음 실행할 때도 규칙 집합이나 노드 제공자를 다운로드하려면 인터넷 연결이 필요합니다. 제공자 주소가 만료되면 기본 파일은 정상적으로 구문 분석되더라도 관련 정책 그룹이 비어 있을 수 있습니다. 이때는 기본 설정 파일만 보지 말고 제공자의 업데이트 시간과 다운로드 오류를 확인하세요.

가져온 뒤 노드·정책 그룹·연결 테스트 완료하기

가져오기에 성공했다는 것은 클라이언트가 문법을 받아들였다는 뜻일 뿐, 노드가 반드시 작동한다는 의미는 아닙니다. 이제 “설정 → 정책 그룹 → 노드 → 터널 → 실제 요청” 순서로 테스트해야 합니다. 정책 그룹 선택을 건너뛰면 iOS 초기 설정 후 “연결됨으로 표시되지만 웹페이지가 열리지 않는” 문제가 발생하기 쉽습니다.

1단계: 활성 설정 선택

설정 목록에서 대상 설정에 선택 표시가 있는지 확인합니다. 설정이 여러 개라면 그중 하나를 편집해도 현재 활성 설정으로 자동 전환되지 않습니다. 잘못된 이전 파일을 사용하지 않도록 설정 이름과 마지막 업데이트 시간을 기록해 두세요.

2단계: 정책 그룹 확인

「프록시」, 「정책」 또는 Proxies 페이지로 이동해 설정에 정의된 기본 정책 그룹을 찾습니다. 예를 들면 `PROXY`, `Proxy` 또는 “노드 선택”입니다. 노드를 하나 직접 선택하세요. 정책 그룹 유형이 `url-test`라면 클라이언트가 테스트 주소로 자동 선택할 수 있고, `select`라면 일반적으로 사용자가 직접 선택해야 합니다.

3단계: 지연 시간 테스트

지연 시간 테스트는 보통 HTTP 탐색을 사용하므로 전체 다운로드 속도와는 다릅니다. 노드에 180 ms가 표시되면 탐색 요청 왕복 시간이 약 0.18초라는 뜻이고, Timeout이면 설정된 시간 안에 유효한 응답을 받지 못했다는 뜻입니다. 일시적인 네트워크 흔들림을 고정적인 장애로 오판하지 않도록 먼저 두 번 연속 테스트하세요.

일부 노드만 시간 초과: 같은 지역의 다른 노드로 전환하세요. 문제는 대개 해당 노드나 경로에 있습니다.
모든 노드가 시간 초과: 구독, 직접 연결 네트워크, 시스템 시간, VPN 권한을 확인하세요.
지연 시간은 정상인데 웹페이지가 열리지 않음: 규칙 일치, DNS, 정책 그룹, 대상 웹사이트 자체를 확인하세요.
Wi-Fi에서는 되지만 셀룰러 네트워크에서는 안 됨: 「설정」→「셀룰러」에서 클라이언트의 데이터 사용 권한을 확인하세요.

4단계: 연결 시작 및 트래픽 확인

클라이언트 연결을 끄고 Safari에서 직접 연결해야 하는 웹사이트를 열어 기본 네트워크가 정상인지 확인합니다.
클라이언트로 돌아가 연결을 시작하고 상태가 “연결됨”으로 안정될 때까지 기다립니다.
클라이언트 로그를 열어 DNS, 규칙 매칭 또는 연결 오류가 나타나는지 확인합니다.
직접 연결되어야 하는 주소와 프록시를 사용해야 하는 주소를 각각 테스트합니다.
클라이언트에서 연결 기록을 제공한다면 요청에 적용된 규칙, 정책 그룹, 최종 노드를 확인합니다.

iOS의 일반적인 문제는 계층별로 해결하기

연결을 누르면 즉시 끊김

먼저 「설정」→「일반」→「VPN 및 기기 관리」→「VPN」에서 구성이 존재하는지 확인한 뒤 다른 VPN 또는 네트워크 필터링 앱을 끄세요. VPN 구성을 삭제하고 다시 만들어도 즉시 끊긴다면 클라이언트 로그에서 설정 초기화 실패, 메모리 제한, Network Extension 시작 실패가 있는지 확인합니다. iPhone을 재시작하면 확장 기능의 일시적인 비정상 상태를 정리할 수 있지만 잘못된 설정을 고쳐 주지는 않습니다.

Safari에서는 구독 주소가 열리지만 클라이언트에서 가져오기에 실패함

Safari에 표시되는 내용은 로그인 페이지, 오류 안내 또는 웹페이지로 감싼 구독일 수 있어 원본 설정이 아닐 수 있습니다. 클라이언트가 반환한 HTTP 상태와 콘텐츠 유형을 확인하세요. 구독 제공자가 Clash용, 범용, iOS 전용 형식을 구분한다면 현재 클라이언트에 맞는 주소를 복사해야 합니다.

모든 노드가 갑자기 동시에 작동하지 않음

먼저 구독 만료일과 트래픽 한도를 확인한 뒤 프록시를 끈 직접 연결 네트워크를 테스트하세요. 이어서 「설정」→「일반」→「날짜 및 시간」으로 이동해 “자동으로 설정”을 켭니다. 시스템 시간이 어긋나면 TLS 인증서 검증에 영향을 줄 수 있습니다. 모두 정상이라면 구독을 수동으로 업데이트하고 로그를 확인하세요. 처음부터 모든 설정을 삭제하지는 마세요.

연결 후 일부 앱에서 트래픽이 흐르지 않음

클라이언트에서 주문형 연결, LAN 우회, IPv6 또는 DNS 관련 옵션이 활성화되어 있는지 확인하세요. 일부 앱은 특수 네트워크 인터페이스나 사용자 지정 DNS를 사용해 Safari와 다르게 작동할 수 있습니다. 먼저 전체 모드로 임시 전환해 비교하세요. 전체 모드에서는 작동하지만 규칙 모드에서 작동하지 않으면 대개 규칙이나 정책 그룹 문제입니다. 두 모드 모두 작동하지 않으면 노드와 터널을 확인하세요.

LAN 기기에 접속할 수 없음

Clash 클라이언트는 설정에 따라 사설 주소를 처리할 수 있습니다. 일반적인 LAN 대역은 `192.168.0.0/16`, `10.0.0.0/8`, `172.16.0.0/12`입니다. 프린터, 라우터 또는 NAS에 접속해야 한다면 이 주소들이 직접 연결로 설정되어 있는지 확인하고 클라이언트에 “LAN 우회” 옵션이 있는지도 확인하세요. 사설 주소를 원격 프록시로 보내지 마세요.

백그라운드에서 일정 시간 후 연결이 끊김

iOS는 백그라운드 리소스를 관리하지만 정상적으로 작동하는 Network Extension은 시스템 조건이 허용하는 동안 터널을 유지할 수 있습니다. 자주 끊긴다면 저전력 모드, 클라이언트 충돌 기록, 주문형 연결 규칙, 네트워크 전환 상황을 확인하세요. 고정 Wi-Fi에서 30분, 고정 셀룰러 네트워크에서 30분, 이후 Wi-Fi와 셀룰러를 전환하며 각각 테스트해 어느 단계에서 끊기는지 확인할 수 있습니다.

설정 업데이트 및 일상적인 관리

안정적으로 사용한 뒤에는 구독 업데이트, 오래된 설정 정리, 장애 기록에 중점을 두고 관리하세요. DNS, 규칙, 노드 매개변수를 매일 바꿀 필요는 없습니다. 문제가 생겼을 때 최근 정상 작동한 설정을 보존해 두면 새 구독의 변경인지 기기 환경의 변화인지 빠르게 구분할 수 있습니다.

구독 설정은 12시간 또는 24시간마다 한 번씩 업데이트하고, 실패하면 마지막으로 성공한 내용을 유지합니다.
YAML을 수동으로 수정하기 전에 백업을 복사하고 이름에 날짜를 표시하세요. 예: “규칙 수정-2026-07-29”.
현재 사용하는 설정과 최근 정상 작동한 설정만 남겨 이름이 같은 여러 설정으로 인한 혼동을 피하세요.
클라이언트를 업데이트한 뒤 먼저 기존 설정을 테스트하세요. 앱, 구독, 시스템 설정을 동시에 업데이트하지 마세요.
장애를 신고할 때 iOS 버전, 클라이언트 버전, 발생 시간, 네트워크 유형, 로그 오류를 기록하되 구독 URL과 노드 인증 정보는 공개하지 마세요.

전체 진단 순서는 App Store 사용 가능 여부 → 클라이언트와 설정 호환성 → VPN 시스템 승인 → 구독 또는 파일 구문 분석 → 정책 그룹 선택 → 노드 연결성 → 규칙 및 DNS로 고정할 수 있습니다. 한 번에 한 계층만 변경해야 테스트 결과를 비교할 수 있습니다.