App Store에서 설치하기 전: Clash 설정 호환성 확인

먼저 사용 중인 설정을 가져올 수 있는 클라이언트인지 확인한 다음 설치하세요. 특정 프록시 프로토콜 지원, Clash 구독 지원, 전체 Clash YAML 지원은 서로 다른 조건입니다. 데스크톱의 mihomo가 같은 파일을 읽더라도 iOS 클라이언트는 노드만 가져오고 규칙이나 정책 그룹은 무시하거나 일부 필드를 인식하지 못할 수 있습니다.

  1. 개발자와 앱 페이지를 확인하세요. 개발자가 안내한 경로에서 App Store를 열거나, App Store에서 제품명을 검색한 뒤 개발자 이름을 확인하세요. 이름과 아이콘이 비슷하다는 이유만으로 같은 클라이언트라고 판단할 수는 없습니다.
  2. iOS 버전을 확인하세요. iPhone에서 「설정」→「일반」→「정보」를 열어 iOS 버전을 확인한 다음, App Store 상세 페이지의 「정보」에 있는 「호환성」과 대조하세요. 현재 스토어 지역에서 이용할 수 없다고 표시되면 먼저 개발자가 안내한 출시 지역을 확인하세요. 출처가 불분명한 설치 링크를 App Store 링크로 오인하지 마세요.
  3. 가져올 수 있는 설정 범위를 확인하세요. 구독 URL만 있다면 「원격 설정」이나 「구독」 지원 안내를 찾고, YAML 파일이 있다면 로컬 파일 가져오기 안내를 확인하세요. 사용자 지정 트래픽 분기를 사용한다면 proxy-groups, rules 및 원격 규칙 세트도 지원하는지 확인하세요.

구독 URL 가져오기: 전체 설정인지 확인

서비스 제공자가 Clash용 또는 현재 클라이언트와 호환된다고 명시한 구독 URL을 우선 사용하세요. 구독 URL은 보통 HTTPS 주소처럼 보이므로 확장자만으로 내용을 판단할 수 없습니다. 같은 서비스에서도 전체 설정, 노드 목록, 계정 관리 페이지를 각각 제공할 수 있습니다.

  1. 서비스의 구독 페이지에서 전체 URL을 복사하고 물음표 뒤의 매개변수도 그대로 유지하세요. 개인 구독 URL을 공개 채팅이나 스크린샷, 온라인 변환 사이트에 올리지 마세요. URL에 구독 내용을 바로 불러올 수 있는 토큰이 포함되어 있을 수 있습니다.
  2. 클라이언트의 설정 관리 화면을 열고 원격 설정 추가 또는 URL 가져오기를 선택한 뒤 주소 입력란에 URL을 붙여 넣으세요. 식별용 설정 이름은 원하는 대로 지정하면 됩니다. 이름은 구독 내용에 영향을 주지 않으며 프록시 서버 주소도 아닙니다.
  3. 저장한 다음 처음으로 업데이트하세요. 다운로드 또는 파싱이 성공했는지 확인하고, 설정에 예상한 노드와 정책 그룹이 생성되었는지 살펴보세요. 원본 설정에 트래픽 분기 규칙이 있었다면 노드 목록만 가져온 것이 아니라 규칙도 유지되었는지 확인해야 합니다.
  4. 새 설정을 현재 설정으로 지정하세요. 저장, 업데이트, 활성화는 각각 다른 작업입니다. 목록에 새 항목이 보여도 실행 중인 연결이 새 설정으로 전환된 것은 아닙니다.

결과 메시지를 보고 어느 단계에서 실패했는지 확인하세요. 로그에 HTTP 401 또는 403이 명시되어 있다면 구독 권한과 서비스의 접근 조건부터 확인하세요. 다운로드는 성공했지만 파싱에 실패했다면 웹 페이지나 로그인 응답, 또는 다른 클라이언트 전용 구독 형식을 받은 것은 아닌지 확인하세요. 새 설정을 테스트할 때까지 기존에 사용하던 설정은 남겨 두는 것이 좋습니다.

로컬 YAML 가져오기: 「파일」 선택기로 열기

전체 파일을 iOS의 「파일」 앱에 저장한 뒤 클라이언트에서 가져오세요. 먼저 「파일」→「둘러보기」에서 「나의 iPhone」 또는 「iCloud Drive」에 저장된 파일을 찾을 수 있습니다. 파일에 클라우드 다운로드 아이콘이 표시되면 먼저 열거나 다운로드해 기기에서 읽을 수 있는지 확인하세요. 압축 파일 안에 설정이 있다면 압축을 푼 다음 실제 .yaml 또는 .yml 파일을 선택하세요.

  1. 클라이언트의 설정 관리 화면에서 파일 가져오기를 선택하고 시스템 파일 선택기로 파일을 여세요. 공유 메뉴로 설정을 받을 수 있는 클라이언트라면 「파일」에서 파일을 길게 누르고 「공유」를 탭한 다음 클라이언트를 선택해도 됩니다.
  2. 줄 번호가 표시된 파싱 오류가 발생하면 해당 줄과 바로 앞 줄부터 확인하세요. 들여쓰기에는 공백을 사용하고 같은 단계의 목록 항목은 줄을 맞추며, -로 시작하는 항목은 해당 필드 아래에 배치하세요. 파일 이름을 .yaml로 바꿔도 웹 페이지나 노드 텍스트가 설정 파일로 변환되지는 않습니다.
  3. 가져온 결과를 확인한 뒤 현재 설정으로 지정하세요. 로컬 파일은 일반적으로 가져올 때 복사됩니다. 클라이언트가 원본 파일과의 동기화를 명시적으로 지원하지 않는 한, 「파일」 앱에서 원본을 수정한 뒤 다시 가져오고 현재 설정이 새 버전으로 전환되었는지 확인해야 합니다.

같은 파일이 컴퓨터에서는 작동하지만 iPhone에서 불러오지 못한다면 YAML 문법 오류와 클라이언트 필드 호환성 문제를 구분하세요. 예를 들어 설정에서 로컬 규칙 파일을 참조한다면 기본 YAML만 가져와서는 외부 규칙 파일이 포함되지 않을 수 있습니다. 데스크톱의 절대 경로도 iPhone에서 그대로 사용할 수 없습니다. 해당 클라이언트용으로 제공된 버전을 우선 사용하고, 오류를 없애려고 규칙 전체를 삭제하지 마세요.

간단한 예제로 규칙 들여쓰기 확인

아래는 Clash 형식의 최상위 필드 예시입니다. 규칙 목록의 작성 방식과 순서만 보여 주며 프록시 노드는 포함하지 않으므로 프록시 연결 테스트에는 사용할 수 없습니다. 실제 설정을 확인할 때는 구체적인 매칭 규칙을 기본 규칙보다 앞에 배치하세요. 규칙은 일반적으로 위에서부터 순서대로 검사해 처음 일치하는 규칙을 적용합니다.

mode: rule
rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,DIRECT

첫 연결: iOS의 VPN 구성 추가 허용

가져온 설정을 선택한 뒤 클라이언트에서 연결을 탭하세요. 터널을 처음 시작할 때 iOS에서 해당 클라이언트가 VPN 구성을 추가하도록 허용할지 묻는 경우가 많습니다. 알림이 방금 설치한 클라이언트에서 온 것인지 확인하고 「허용」을 탭한 다음 시스템 안내에 따라 인증을 완료하세요. 구독과 YAML은 클라이언트가 읽는 데이터이고, VPN 구성은 터널을 시작하는 데 쓰이는 iOS 시스템 설정입니다. 구독이나 YAML을 가져와도 VPN 구성 권한이 자동으로 허용되지는 않습니다.

  1. 클라이언트에서 연결 상태를 확인하세요. 연결되지 않거나 바로 끊긴다면 시작 로그를 먼저 살펴보고 현재 설정이 로드되었는지, 시스템 권한이 완료되었는지 확인하세요.
  2. iOS 18에서는 「설정」→「일반」→「VPN 및 기기 관리」→「VPN」에서 상태를 확인할 수 있습니다. 메뉴 이름이 다르면 「설정」에서 「VPN」을 검색하세요. 현재 연결된 항목이 다른 VPN이 아니라 이번에 설치한 클라이언트인지 확인해야 합니다.
  3. 처음 연결할 때 「허용 안 함」을 탭했다면 클라이언트로 돌아가 연결을 다시 시작하고 시스템 안내를 확인하세요. 회사나 학교에서 관리하는 기기라 연결이 제한되어 있다면 기기 관리자에게 정책을 확인하세요. 관리 프로파일을 임의로 제거하지 마세요.

연결 후 확인: 규칙과 노드를 각각 점검

VPN이 연결됨으로 표시되어도 터널이 시작되었다는 뜻일 뿐, 원격 노드와 DNS, 트래픽 분기 규칙이 모두 정상이라는 의미는 아닙니다. 먼저 같은 Wi-Fi에서 확인하고, 어느 단계에서 접속이 복구됐는지 파악하기 어렵지 않도록 노드 변경, 모드 전환, DNS 수정은 동시에 하지 마세요.

  1. 모드와 정책 그룹을 확인하세요. 클라이언트에서 규칙 모드를 제공한다면 규칙 모드가 선택되어 있는지 확인하고, 프록시를 사용해야 하는 정책 그룹에 사용 가능한 노드가 선택되어 있는지 살펴보세요. DIRECT가 선택되어 있으면 안 됩니다. 전역 모드에서 웹 페이지가 열린다는 사실만으로 규칙이 올바르게 적용된다고 볼 수는 없습니다.
  2. 직접 연결과 프록시 연결을 각각 테스트하세요. 설정에서 직접 연결될 것으로 예상하는 도메인과 프록시를 거칠 것으로 예상하는 도메인을 하나씩 골라 새 요청을 보내세요. 클라이언트에서 연결 목록이나 로그를 제공한다면 도메인별로 적용된 규칙과 실제 연결 경로를 확인하세요. 속도 측정 결과는 해당 테스트 요청의 성능만 보여 주며 대상 도메인 접속을 검증해 주지는 않습니다.
  3. 증상에 따라 한 가지씩 확인하세요. 일부 도메인만 실패한다면 앞쪽 규칙에 먼저 매칭되는지 확인하세요. 특정 노드만 계속 연결 시간 초과가 발생한다면 모드와 네트워크를 유지한 채 같은 정책 그룹에서 다른 노드로 테스트하세요. 여러 도메인에서 이름 확인 오류가 발생한다면 먼저 현재 Wi-Fi에서 웹 로그인이 필요한지 확인한 다음 클라이언트의 DNS 설정이 호환되는지 살펴보세요.
  4. 마지막으로 셀룰러 네트워크에서 테스트하세요. Wi-Fi에서 확인을 마친 뒤 Wi-Fi를 끄고 같은 설정과 노드를 유지한 채 동일한 도메인에 다시 요청하세요. 셀룰러 네트워크에서만 실패한다면 「설정」→「셀룰러」에서 클라이언트와 테스트에 사용하는 앱의 셀룰러 데이터 사용이 허용되어 있는지 확인하세요. 그런 다음 로그를 보고 DNS 확인 실패인지 연결 시간 초과인지 구분하세요.

구독 업데이트 후에 문제가 생겼다면 업데이트 성공 여부, 현재 설정의 변경 여부, 이전에 선택한 노드의 삭제 또는 이름 변경 여부부터 확인하세요. 지원을 요청할 때는 iOS 버전, 클라이언트 버전, 가져오기 방식, 처음 발생한 관련 오류를 기록하세요. 내용을 공유하기 전에 구독 URL과 토큰, 설정에 포함된 계정 정보를 삭제하세요.