iPhone에서 시작하는 Clash 클라이언트: App Store 계정과 구독 설정 가져오기

iOS에서 Clash 설정을 지원하는 클라이언트를 App Store에서 설치하고, 구독 링크와 VPN 구성을 가져와 첫 연결을 확인하는 방법을 안내합니다.

1. 설치 전 확인: 앱, App Store 국가 또는 지역, 설정 형식

iPhone에서는 Windows용 .exe나 Android용 .apk를 설치할 수 없고, Linux용 mihomo 바이너리를 iOS 앱처럼 실행할 수도 없습니다. 먼저 iOS 버전을 제공하는 클라이언트를 고른 뒤 지원하는 구독 형식을 확인하세요. 이름에 프록시나 VPN이 들어간다고 해서 Clash YAML 전체를 읽을 수 있는 것은 아닙니다.

2. App Store 계정: 본인 계정으로 앱 받기

App Store 국가 또는 지역과 시스템 요구 사항 확인

먼저 App Store에서 정확한 앱 이름을 검색하세요. “현재 국가 또는 지역에서 사용할 수 없음”이라고 표시되면 구독 링크를 계속 바꾸기보다 현재 App Store 국가 또는 지역을 확인해야 합니다. 구독은 설정 내용을 결정하고 Apple 계정의 국가 또는 지역은 스토어에서 볼 수 있는 앱을 결정합니다. 서로 다른 단계입니다.

  1. iPhone에서 ‘설정’ → 화면 상단의 이름 → ‘미디어 및 구입 항목’ → ‘계정 보기’ → ‘국가/지역’을 열어 현재 계정 지역을 확인하세요. 메뉴 이름은 iOS 버전에 따라 조금 다를 수 있습니다.
  2. 앱 상세 페이지의 ‘호환성’에서 최소 iOS 요구 사항, 개발자 이름, 가격 및 결제 방식을 확인하세요.
  3. 새 계정이 필요하다면 기기에서 제공하는 계정 생성 절차를 이용해 본인 이메일 주소와 인증 코드를 받을 수 있는 본인 전화번호로 가입하고, 이중 인증을 켜세요.
  4. Apple의 조건을 충족하고 해당 지역의 유효한 정보를 제공할 수 있을 때만 국가 또는 지역을 변경하세요. 먼저 계정 잔액, 구독, 가족 공유 관련 제한을 확인해야 합니다.

다른 사람이 제공하는 공유 계정을 구매하거나 빌리거나 로그인하지 마세요. 구입 내역, 이후 업데이트, 계정 복구는 모두 계정에 대한 통제권이 있어야 가능합니다. 구입 계정을 바꿔야 한다면 ‘미디어 및 구입 항목’ 계정과 기기 상단에 표시되는 iCloud 계정을 구분하세요. 앱 하나를 설치하려고 기기 전체에서 iCloud 계정을 로그아웃하지 말고, 다른 사람의 기기 관리 요청도 수락하지 마세요.

다운로드 후 앱이 맞는지 확인

스토어에서 설치한 뒤 앱을 한 번 실행하고 도움말이나 정보 페이지에서 가져오기 메뉴와 지원 형식을 확인하세요. 앱 설명에 특정 노드 URI만 지원한다고 되어 있다면 Clash YAML 전체를 바로 업로드하지 마세요. 스토어에 표시되는 가격, 지역별 제공 여부, 버전 요구 사항은 해당 시점의 페이지를 기준으로 합니다. 이 글에서는 특정 앱을 항상 다운로드할 수 있다고 전제하지 않습니다.

3. 구독 링크 준비: 전체 매개변수와 접근 정보 유지

구독 링크에는 보통 계정별 토큰이 포함됩니다. 복사할 때 경로 전체와 물음표 뒤의 쿼리 매개변수, 대소문자를 그대로 유지하세요. 메신저에서 줄바꿈이 들어가거나 끝에 문장 부호가 붙거나 공백이 함께 복사되면 요청이 실패할 수 있습니다. 구독 주소를 공개 변환 사이트, 공개 댓글, 스크린샷에 노출하지 마세요.

받은 항목먼저 할 일자주 하는 실수
HTTPS 구독 링크구독 API 주소인지 확인한 뒤 원격 설정으로 추가계정 로그인 페이지를 구독 주소로 착각
로컬 YAML 파일‘파일’ 앱에 저장한 다음 클라이언트의 파일 가져오기 메뉴 사용파일을 가져오면 원격 업데이트도 자동으로 된다고 생각
단일 노드 URI노드 추가 또는 클립보드 가져오기 기능 사용단일 노드를 규칙과 정책 그룹이 포함된 전체 설정으로 착각
QR 코드신뢰할 수 있는 출처에서 내용을 확인한 뒤 스캔웹 로그인용 QR 코드를 설정 QR 코드로 착각

내보내기 형식이 여러 개라면 클라이언트 문서에서 지원한다고 명시한 형식을 우선 선택하세요. 제공자가 ‘Clash’와 ‘Clash Meta’ 항목을 각각 제공하더라도 반환되는 내용은 다를 수 있습니다. 파일 확장자만 바꿔 변환하려고 하지 마세요. JSON 파일 이름을 .yaml로 바꿔도 내부 구조는 달라지지 않습니다.

Safari에서 주소가 열린다는 것은 브라우저가 응답을 받았다는 뜻일 뿐, 그 응답이 유효한 구독이라는 뜻은 아닙니다. 로그인 페이지나 오류 페이지, 인증 페이지도 HTTP 200을 반환할 수 있습니다. 응답 유형을 확인해야 한다면 클라이언트의 가져오기 로그나 제공자 문서를 이용하세요. 공개적인 문제 해결 자료에는 원본 토큰을 노출하지 마세요.

4. 설정 가져오기: 업데이트 후 사용할 설정과 정책 그룹 선택

원격 구독 가져오기 순서

클라이언트마다 메뉴 이름이 ‘설정’, ‘구독’, ‘Profiles’, ‘원격 리소스’ 등으로 다를 수 있습니다. 아래에서는 특정 앱의 메뉴를 모든 iOS 클라이언트의 공통 화면으로 가정하지 않고, 작업의 의미를 기준으로 설명합니다.

  1. 설정 관리 화면으로 이동해 원격 설정 추가 또는 URL에서 가져오기를 선택하세요.
  2. 구독 주소 전체를 붙여넣고 ‘일상 설정’처럼 알아보기 쉬운 이름을 지정하세요. User-Agent 설정이 있다면 제공자나 클라이언트 문서에서 요구하는 값만 입력하세요.
  3. 다운로드 또는 업데이트를 실행하세요. 앱에 가져오기 성공이 명확히 표시될 때까지 기다린 다음 노드 수와 업데이트 시간을 확인하세요.
  4. 새로 가져온 항목을 현재 사용할 설정으로 지정하세요. 앱에 따라 저장만 되고 실행 중인 설정은 자동으로 전환되지 않을 수 있습니다.
  5. 정책 그룹으로 이동해 사용 가능한 노드를 하나 선택하세요. 첫 연결 확인에서는 자동 속도 측정 그룹에 의존하지 말고 수동으로 선택하는 편이 좋습니다.
  6. 실행 모드를 선택할 수 있다면 먼저 규칙 모드를 사용하세요. 연결 후 로그에서 어떤 규칙이 적용됐는지 확인하면 됩니다.

전체 Clash 설정에는 보통 proxies, proxy-groups, rules 등의 필드가 있습니다. proxy-providers로 원격 노드 리소스를 참조할 수도 있습니다. YAML 텍스트가 보인다고 해서 로컬 노드 목록까지 포함된 설정이라고 단정할 수는 없습니다. 외부 provider에 의존한다면 해당 리소스를 다운로드할 수 있는지도 확인하세요.

로컬 파일과 원격 리소스를 따로 확인

‘파일’ 앱에서 config.yaml을 가져올 때는 파일이 일반 텍스트이고 들여쓰기에 공백을 사용하는지 확인하세요. 문서 편집기에서 복사한 굽은 따옴표를 사용하지 말고, YAML 들여쓰기에 탭을 넣지 마세요. 오류에 줄 번호가 표시되면 해당 줄과 바로 위 줄의 콜론, 따옴표, 들여쓰기를 먼저 살펴보세요.

데스크톱 파일의 ./rules/ 같은 상대 경로가 해당 파일이 iPhone 앱 샌드박스에 들어 있다는 뜻은 아닙니다. 기본 설정만 가져오면 규칙 세트 파일이 누락될 수 있습니다. 클라이언트가 지원하는 리소스 가져오기 방식을 우선 사용하세요. 수정하기 전 원본 설정을 보관하고, 테스트 내용을 유일한 원격 설정에 바로 덮어쓰지 마세요.

5. VPN 승인: 구성 추가는 허용하되 낯선 관리 프로파일은 설치하지 않기

처음 연결을 시작하면 iOS에서 보통 “VPN 구성을 추가하려고 합니다”라는 시스템 알림이 표시됩니다. 요청한 앱 이름을 확인한 뒤 허용을 누르고, 기기에서 요구하면 잠금 암호를 입력하거나 시스템 인증을 완료하세요. 이 승인을 통해 앱이 시스템 VPN 구성을 만들 수 있으며, 이후 네트워크 확장을 사용하기 위한 필수 단계입니다.

  1. 클라이언트로 돌아가 연결 스위치를 누른 뒤 상태가 ‘연결 중’에서 ‘연결됨’으로 바뀔 때까지 기다리세요.
  2. ‘설정’ → ‘일반’ → ‘VPN 및 기기 관리’ → ‘VPN’을 열고 현재 구성이 방금 설치한 클라이언트의 것인지 확인하세요.
  3. 다른 VPN 앱이 연결되어 있다면 먼저 직접 연결을 끊고 이번 설정을 테스트하세요. 전환 과정이나 자동 재연결이 서로 간섭하는 일을 막을 수 있습니다.

iOS 클라이언트는 보통 시스템 Network Extension을 통해 터널 트래픽을 처리합니다. 데스크톱에서 TUN을 직접 켜거나 네트워크 어댑터를 수정하고 기본 경로를 설정하는 방식과 다릅니다. iPhone에서 트래픽을 처리하려고 데스크톱 가이드의 가상 네트워크 어댑터 매개변수를 그대로 복사하거나 시스템이 특정 로컬 포트를 열도록 요구하지 마세요.

6. 첫 연결 확인: 터널, 노드, 규칙, DNS 구분하기

상태 막대에 VPN이 표시되면 터널이 만들어졌다는 뜻입니다. 모든 사이트 요청이 프록시를 거치거나 선택한 원격 노드를 사용할 수 있다는 뜻은 아닙니다. 아래 순서대로 확인하고, 설정은 한 번에 하나씩만 바꾸세요. 테스트 시간과 네트워크 유형, 정책 그룹 선택, 오류 내용을 기록해 두세요.

  1. 기본 인터넷 연결 확인: 먼저 클라이언트 연결을 끊고 Safari에서 평소 접속할 수 있는 HTTPS 페이지를 엽니다. 로컬 네트워크에도 연결되지 않는다면 Wi-Fi 로그인 인증이나 셀룰러 데이터 권한부터 확인하세요.
  2. 시스템 시간 확인: ‘설정’ → ‘일반’ → ‘날짜 및 시간’으로 이동해 시간과 시간대가 올바른지 확인하세요. 기기 시간이 크게 어긋나면 TLS 인증서 검증에 문제가 생길 수 있습니다.
  3. 연결 후 규칙 확인: 프록시를 사용할 것으로 예상되는 사이트에 접속한 뒤 클라이언트의 연결 기록에서 도메인, 적용된 규칙, 정책 그룹, 최종 노드를 확인하세요. 홈 화면의 연결 스위치만 보고 판단하지 마세요.
  4. 출구 IP 확인: 신뢰할 수 있는 출구 IP 조회 페이지를 참고용으로 사용하세요. 해당 요청이 프록시를 거쳤음을 확인한 경우에만 조회 결과로 프록시 출구를 판단할 수 있습니다. 규칙에 따라 직접 연결했다면 로컬 출구가 표시되는 것이 정상입니다.
  5. 네트워크를 바꿔 재검사: Wi-Fi와 셀룰러 네트워크에서 각각 한 번씩 테스트하세요. 셀룰러 네트워크에서만 실패하면 ‘설정’ → ‘셀룰러’에서 해당 앱의 데이터 사용 권한을 확인하고 통신사 네트워크에서 발생한 오류를 기록하세요.

도메인 접속은 실패했지만 로그에 노드 연결이 표시된다면 DNS 조회 오류와 규칙 적용 결과를 확인하세요. IP 주소로 HTTPS 사이트에 직접 접속해 DNS가 정상인지 판단하지 마세요. 인증서 이름, SNI, 사이트의 가상 호스트 설정이 결과에 영향을 줄 수 있습니다.

포트의 용도도 구분해야 합니다. 노드 제공자가 원격 포트를 443이라고 명시했다면 해당 노드의 port 필드를 확인하세요. 데스크톱 가이드에서 자주 나오는 로컬 혼합 포트 7890은 원격 서버 포트가 아니며, iPhone에서 VPN을 설정할 때 공통으로 입력해야 하는 값도 아닙니다.

7. 가져오기 및 연결 오류: 증상에 따라 다음 단계 찾기

증상우선 확인할 항목다음 조치
구독 요청이 401 또는 403 반환토큰 유효 기간, 접근 권한, 요청 헤더 요구 사항제공자 계정에서 링크를 다시 복사하고 문서에서 User-Agent 요구 사항을 확인하세요
구독 요청이 404 반환경로가 완전한지, 이전 API 주소가 변경됐는지구독 메뉴에서 주소를 다시 확인하고 URL 쿼리 매개변수는 직접 삭제하거나 수정하지 마세요
파싱 오류 또는 노드 목록이 비어 있음응답이 HTML인지, 형식과 프로토콜을 지원하는지파싱 로그를 확인하고 내보내기 형식과 provider 다운로드 상태를 점검하세요
노드 속도 측정은 성공하지만 웹페이지가 열리지 않음속도 측정 주소, 대상 도메인 규칙, DNS, 최종 정책실제 웹페이지 요청 기록을 확인하세요. 한 번의 지연 시간 측정만으로 전체 연결을 판단하지 마세요
VPN 연결 후 모든 네트워크 연결이 끊김현재 사용 중인 설정, 선택한 노드, DNS 설정, 다른 VPN의 연결 상태먼저 연결을 끊어 네트워크를 복구한 다음 최소 설정부터 항목별로 테스트하세요
업데이트 후 설정이 원래대로 돌아감원격 설정 본문을 직접 수정했는지 확인하세요앱에서 지원하는 덮어쓰기 기능을 사용하고 업데이트 후 변경 사항이 적용됐는지 확인하세요

문제를 재현하는 데 필요한 최소 정보만 남기기

클라이언트 개발자나 구독 제공자에게 문의할 때 iOS 버전, 클라이언트 버전, 네트워크 유형, 오류 발생 시간, 민감 정보를 가린 로그를 첨부하세요. 구독 토큰, 노드 비밀번호, UUID 등의 인증 정보는 숨긴 뒤 공유하세요. 문제 설명 대신 전체 설정 파일을 공개하지 마세요.

첫 연결 확인을 마친 뒤 필요에 따라 자동 업데이트, 주문형 연결, 자동 정책 선택을 켜세요. 주문형 연결 기능이 있다면 스위치를 끈 뒤 바로 자동 재연결되지 않는지 확인하고, 화면 잠금과 Wi-Fi 전환도 테스트하세요. 기능을 하나 추가할 때마다 다시 확인하면 이후 문제가 구독 변경, 시스템 네트워크 변화, 정책 선택 중 무엇 때문인지 구분하기 쉽습니다.

Clash 다운로드