도움말 / FAQ

Clash for iOS 자주 묻는 질문

설정 가져오기부터 연결 문제 해결까지 기기와 증상별로 답변을 찾아보세요. 데스크톱 시스템의 TUN, 시스템 프록시, UWP 루프백 문제는 문제 해결 섹션에서 따로 다룹니다.

01 / 개념과 모드

입문 가이드

클라이언트, 설정, 연결 방식을 먼저 구분하세요.

Clash는 코어인가요, 설정 파일인가요, iPhone 클라이언트인가요?

Clash는 일반적으로 설정에 따라 프록시 연결을 처리하는 코어와 그 생태계를 가리킵니다. 휴대폰에 실제로 설치하는 것은 그래픽 인터페이스를 갖춘 클라이언트입니다. 설정 파일에는 프록시, DNS, 트래픽 분기 규칙이 정의되며, 구독은 설정을 가져오고 업데이트하는 방법 중 하나입니다. 먼저 사용 중인 클라이언트 이름을 확인한 뒤 해당 앱의 가져오기 메뉴를 이용하세요. 설정 파일은 설치 파일이 아닙니다.

구독 링크, 설정 파일, 노드는 어떻게 다른가요?

구독 링크는 설정을 가져오는 주소이고, 설정 파일은 클라이언트가 읽는 데이터로 보통 프록시 항목, 정책 그룹, 규칙을 포함합니다. 노드는 설정 파일에서 선택할 수 있는 프록시 출구 중 하나입니다. 구독을 가져온 뒤에는 해당 설정을 현재 설정으로 선택하고 정책 그룹의 출구도 확인해야 합니다. 구독 주소에 계정 정보가 포함될 수 있으니 공개 스크린샷이나 게시물에 올리지 마세요.

규칙·전역·직접 연결 모드, 무엇을 선택해야 하나요?

평소에는 규칙 모드를 사용하세요. 요청이 설정 파일의 규칙에 따라 출구로 연결됩니다. 전역 모드는 프록시 요청을 선택한 프록시 출구로 보내므로 짧게 비교하거나 문제를 확인할 때 유용합니다. 직접 연결 모드는 프록시 출구를 거치지 않습니다. 모드를 바꿔도 만료된 구독이나 사용할 수 없는 노드가 복구되지는 않습니다. 특정 사이트의 접속 결과가 예상과 다르면 현재 설정의 규칙과 정책 그룹부터 확인하세요.

iPhone의 연결 스위치와 컴퓨터의 시스템 프록시는 같은 기능인가요?

아닙니다. iPhone 클라이언트는 보통 iOS VPN 설정으로 관련 네트워크 트래픽을 처리하며, 처음 연결할 때 시스템 권한을 요청합니다. 데스크톱 클라이언트의 시스템 프록시는 대개 운영체제의 프록시 설정을 변경하는 방식입니다. 각 앱이 이 설정을 따르는지는 앱 자체 동작에 따라 다릅니다. 문제를 확인할 때는 먼저 기기와 트래픽 처리 방식을 구분한 다음 해당 클라이언트의 연결 상태를 확인하세요.

02 / 가져오기와 권한

플랫폼별 안내

시스템 권한부터 확인하고 설정의 출처를 차례대로 점검하세요.

iPhone에 처음 설치한 뒤 VPN 구성을 허용하려면 어떻게 하나요?

먼저 클라이언트에서 설정을 가져와 선택한 다음 연결 스위치를 켜세요. iOS에서 VPN 구성 추가 안내가 표시되면 허용을 누르고 시스템 안내에 따라 기기 인증을 완료하세요. 클라이언트로 돌아와 연결 상태를 확인합니다. 안내를 취소했다면 다시 연결을 시도해 권한 요청을 띄울 수 있습니다. 설정 앱의 VPN 항목에 이미 구성이 있는지도 확인해 서로 충돌하는 VPN 서비스를 동시에 연결하지 않도록 하세요.

Clash 구독 링크를 iPhone에 어떻게 가져오나요?

클라이언트의 설정 파일 또는 Profile 화면에서 URL 다운로드를 선택하고 전체 구독 주소를 붙여 넣으세요. 저장한 뒤 가져오기가 끝나면 새 설정을 현재 설정으로 선택합니다. 형식 오류가 표시되면 주소를 열었을 때 로그인 페이지나 일반 웹페이지가 아니라 클라이언트에서 지원하는 설정 형식이 반환되는지 확인하세요. 버튼 이름은 클라이언트마다 다를 수 있으니 현재 화면을 기준으로 진행하세요.

구독 링크가 만료됐거나 업데이트에 실패하면 어떻게 하나요?

먼저 구독 주소가 빠짐없이 입력됐는지, 계정이나 구독 서비스가 아직 유효한지 확인하세요. 기존 노드 목록만으로 업데이트 성공 여부를 판단하면 안 됩니다. 휴대폰 네트워크에서 구독 서비스에 접속할 수 있는지 확인한 뒤 설정 화면에서 수동 업데이트를 실행하고 구체적인 오류 메시지를 살펴보세요. 로그인 페이지, 빈 내용 또는 형식 오류가 반환되면 구독 제공업체에 주소와 형식을 문의하세요. 업데이트 전에 사용할 수 있는 기존 설정을 보관해 두면 비교하기 쉽습니다.

로컬 config.yaml 가져오기에 실패하면 무엇부터 확인해야 하나요?

먼저 파일 확장자와 클라이언트가 지원하는 가져오기 방법을 확인한 다음 YAML 들여쓰기에 같은 종류의 공백이 사용됐는지 살펴보세요. proxies, proxy-groups, rules 같은 최상위 필드는 올바른 계층에 있어야 합니다. 정책 그룹에서 참조하는 프록시 이름도 항목에 지정된 이름과 일치해야 합니다. 웹페이지에서 복사한 설명 문구를 파일에 함께 넣지 마세요. 원본 설정을 먼저 가져온 뒤 성공하면 항목별로 수정해 문제를 찾아보세요.

03 / 설정 관리

고급 설정

설정을 전환할 때 정책 그룹과 DNS 설정도 함께 달라지는지 확인하세요.

여러 Profile을 전환하려면 어떻게 하나요? 전환 후 다시 연결해야 하나요?

설정 파일 목록에서 원하는 Profile을 선택하고 현재 설정으로 표시됐는지 확인하세요. 클라이언트에 따라 즉시 다시 불러오기도 하고, 연결을 끊었다가 다시 연결해야 할 수도 있습니다. 설정마다 정책 그룹과 규칙이 다를 수 있으므로 전환 전후에 이전 설정의 출구 선택을 그대로 적용하지 마세요. 전환 후 접속에 문제가 생기면 현재 설정 이름, 연결 상태, 정책 그룹 선택 순으로 확인하세요.

구독은 언제 업데이트하나요? 수동 수정 내용도 덮어쓰나요?

구독 제공업체가 프록시 항목이나 규칙을 변경했거나 기존 노드를 사용할 수 없을 때 설정 화면에서 수동 업데이트할 수 있습니다. URL로 관리되는 설정은 업데이트 과정에서 원격 내용으로 로컬 내용이 대체될 수 있습니다. 구독으로 생성된 파일을 직접 수정했다면 먼저 별도의 설정으로 저장하세요. 업데이트가 끝나면 현재 Profile, 정책 그룹, 규칙 모드를 확인하세요. 업데이트 완료 안내만 보고 끝내지 마세요.

Fake-IP DNS 모드가 로컬 네트워크 기기에 영향을 주나요?

Fake-IP는 조건에 맞는 도메인에 매핑된 주소를 반환하고, 코어는 이 매핑을 바탕으로 연결을 처리합니다. 로컬 네트워크 기기 검색, 일부 게임, 실제 DNS 응답에 의존하는 앱에는 별도 규칙이 필요할 수 있습니다. 문제가 생기면 먼저 규칙 모드와 직접 연결 모드에서 차이가 있는지 확인한 다음 설정의 dns.enhanced-mode와 fake-ip-filter를 살펴보세요. 기존 DNS 설정을 이해하지 못한 채 설정 전체를 교체하지 마세요.

LAN 연결 허용은 언제 켜야 하나요?

같은 LAN에 있는 다른 기기에서 이 기기가 제공하는 프록시를 실제로 사용해야 할 때만 LAN 연결 허용 옵션을 확인하세요. 옵션을 켠 뒤에도 수신 주소와 포트, 기기 방화벽, 같은 네트워크에서의 접근 가능 여부를 점검해야 합니다. 스위치만 켠다고 다른 기기 설정까지 완료되는 것은 아닙니다. 이 기기에서만 클라이언트를 사용한다면 보통 다른 기기에 프록시 연결을 허용할 필요가 없습니다.

04 / 증상별 문제 해결

문제 해결

기기가 네트워크에 연결되는지 확인한 뒤 설정, 권한, 앱의 트래픽 처리 방식을 점검하세요.

iPhone VPN 스위치가 켜지지 않거나 연결 후 인터넷에 접속할 수 없을 때는 어떻게 해결하나요?

먼저 사용할 수 있는 설정을 선택했는지, iOS VPN 권한을 허용했는지 확인하세요. 그런 다음 시스템의 VPN 화면에서 다른 연결이 사용 중인지 살펴봅니다. VPN을 켤 수 있지만 접속이 안 된다면 일반 네트워크에서 휴대폰 자체가 인터넷에 연결되는지 확인한 뒤 현재 정책 그룹, 노드, 규칙 모드를 점검하세요. 다른 VPN이나 네트워크 필터 앱을 잠시 끄고 다시 시도한 다음 클라이언트 로그에서 처음 나타난 구체적인 오류를 확인하세요.

노드 속도 테스트는 정상인데 연결이 시간 초과되면 어디부터 확인하나요?

속도 테스트는 테스트 당시 지정된 대상에 도달할 수 있었는지만 보여 주며 실제 요청의 성공을 보장하지 않습니다. 먼저 휴대폰 네트워크, 현재 Profile, 정책 그룹이 여전히 같은 노드를 가리키는지 확인하세요. 서로 다른 대상에 접속해 특정 사이트 문제인지 전반적인 시간 초과인지 구분합니다. 그런 다음 로그에서 DNS, 연결, 인증 오류를 살펴보세요. 여러 노드에서 모두 시간 초과가 발생하면 구독 정보와 기기 네트워크를 확인하세요.

데스크톱 Clash TUN 모드에서 권한 부족이 표시되면 어떻게 하나요?

TUN을 사용하려면 클라이언트가 가상 네트워크 인터페이스를 만들거나 관리할 수 있어야 합니다. 권한을 부여하는 방법은 Windows, macOS, Linux와 클라이언트에 따라 다릅니다. 먼저 현재 클라이언트의 권한 안내를 읽고 설정 화면에 따라 시스템 권한을 허용하거나 서비스를 설치한 뒤 TUN을 다시 켜세요. 계속 실패하면 기존 VPN, 가상 네트워크 어댑터 또는 보안 소프트웨어가 인터페이스를 사용 중인지 확인하세요. iPhone의 시스템 VPN 권한은 데스크톱 TUN 권한과 다릅니다.

Windows에서 시스템 프록시를 켰는데 일부 앱에는 왜 적용되지 않나요?

시스템 프록시는 해당 설정을 읽는 앱에만 적용됩니다. 일부 프로그램은 자체 네트워크 설정을 사용하거나 직접 연결합니다. 먼저 클라이언트가 실행 중이고 시스템 프록시가 켜져 있는지 확인한 뒤 브라우저에서 비교 테스트를 해 보세요. 특정 앱에만 적용되지 않는다면 해당 앱의 프록시 설정을 확인하세요. 더 많은 트래픽을 처리해야 한다면 클라이언트의 TUN 모드 지원 여부와 권한 요구 사항을 검토하세요. 원인을 추측하며 포트를 반복해서 바꾸지 마세요.

Windows UWP 앱이 로컬 프록시를 사용하지 못할 때 루프백은 어떻게 확인하나요?

일부 UWP 앱은 Windows 네트워크 격리 때문에 로컬 프록시 주소에 직접 연결할 수 없습니다. 먼저 일반 데스크톱 프로그램이 같은 프록시 포트로 연결되는지 확인한 다음 대상 UWP 앱에 루프백 예외가 있는지 살펴보세요. Windows 터미널에서 CheckNetIsolation LoopbackExempt -s를 실행하면 현재 예외 목록을 확인할 수 있습니다. 예외를 추가해야 한다면 대상 앱의 패키지 패밀리 이름을 확인한 뒤 사용 중인 클라이언트의 루프백 설정 안내에 따라 진행하세요.

클라이언트 다운로드