SETUP / FOUR STEPS

Clash 애플 버전
구독 및 연결 가이드

“구독 가져오기 → 프록시 모드 선택 → 연결 → 확인” 순서로 처음 설정을 마치세요. 클라이언트가 설치되어 있고 구독을 사용할 수 있다면 약 10분 안에 설정할 수 있습니다. 문제가 생기면 해당 단계에서 멈춰 점검하면 되며, 매번 다시 설치할 필요는 없습니다.

시작하기 전에 신뢰할 수 있는 서비스 제공자가 발급한 유효한 구독 URL을 준비하고, 기기에서 인터넷에 정상적으로 접속할 수 있는지 확인하세요. 연결 중인 다른 VPN이나 프록시 도구는 종료합니다. 클라이언트는 설정을 읽고 연결을 처리하는 앱이며, 설치만으로 사용할 수 있는 노드가 생기지는 않습니다. 구독 URL에는 계정 접근 정보가 포함될 수 있으므로 복사한 뒤 클라이언트에서 바로 사용하고, 공개 채팅방이나 스크린샷, 출처가 불분명한 변환 사이트에 공유하지 마세요.

클라이언트를 아직 설치하지 않았다면 다운로드 페이지에서 운영체제와 프로세서 아키텍처에 맞는 설치 항목을 선택하세요. iOS에서는 Clash Plus의 앱 스토어 링크를 이용할 수 있으며, 관련 프로젝트 정보는 clashplus.io에서 확인할 수 있습니다. macOS에서는 설치 후 앱이 정상적으로 열리는지 먼저 확인하세요. 이 문서는 첫 연결에 필요한 설정만 다룹니다. 네트워크 스택, DNS 항목, 플랫폼별 설치 방법은 전체 플랫폼 가이드에서 확인하세요.

STEP 01 / SUBSCRIPTION

구독을 가져와 설정 활성화하기

클라이언트를 열고 “설정” 또는 “구독” 화면에서 추가 메뉴를 찾습니다. 일부 클라이언트는 오른쪽 위의 더하기 버튼으로 추가하고, 다른 클라이언트는 URL 입력란을 바로 제공합니다. 링크에서 가져오기를 선택한 뒤 구독 URL 전체를 붙여 넣으세요. 이름이 필요하면 “일상용”처럼 용도를 알아보기 쉽게 입력할 수 있습니다. 이름은 이 기기에서 구분하기 위한 것으로 구독 내용에는 영향을 주지 않습니다. 주소 앞뒤에 공백이나 줄바꿈, 메신저가 덧붙인 문장부호가 없는지 확인한 다음 가져오기, 다운로드 또는 저장을 누르세요.

가져오기를 시작하면 클라이언트가 먼저 구독 URL에 요청을 보내고 응답받은 설정을 파싱합니다. 성공 상태가 표시될 때까지 기다린 뒤 새 설정이 목록에 나타나는지, 프록시 화면에 정책 그룹이나 노드가 표시되는지 확인하세요. “주소 저장 완료”를 “설정 불러오기 완료”로 착각하지 마세요. 일부 클라이언트는 구독 항목을 먼저 만들기 때문에 백그라운드 다운로드에 실패해도 목록에 기록이 남습니다. 해당 항목의 상세 정보에서 업데이트 시간, 오류 메시지 또는 설정 미리보기를 열어 실제 내용을 가져왔는지 확인하세요.

구독 다운로드에 성공하면 설정 항목을 눌러 현재 사용할 설정으로 지정합니다. 선택 표시, 현재 설정 이름 또는 활성 상태가 화면에 나타나는지 확인하세요. 프록시 화면에서 내용이 바뀌었는지도 살펴봅니다. 이전 설정의 정책 그룹이 계속 표시된다면 설정 화면으로 돌아가 편집 항목만 선택한 것은 아닌지, 실제로 활성화했는지 확인하세요. 처음에는 테스트에 사용할 현재 설정을 하나만 남기면 선택을 혼동할 가능성이 줄어듭니다. 다른 저장된 구독을 삭제할 필요는 없습니다.

가져오기에 실패하면 먼저 오류 단계 확인

“연결 시간 초과”, “호스트를 찾을 수 없음”은 구독 요청이 정상적으로 완료되지 않았을 가능성이 큽니다. 기기의 네트워크 연결, 만료된 URL 여부, 서비스 제공자의 접속 안내를 먼저 확인하세요. “파싱 실패”, “지원하지 않는 필드”는 내용을 가져왔지만 형식이 클라이언트와 호환되지 않는다는 뜻입니다. 현재 클라이언트용 구독 링크인지 확인하고, 계정 관리 페이지나 구매 페이지, 브라우저 로그인이 필요한 주소를 복사하지 않았는지 살펴보세요. 구독 서비스가 여러 형식을 제공한다면 현재 클라이언트와 코어가 지원하는 형식을 선택하세요.

이미 로컬 YAML 파일로 저장했다면 “파일에서 가져오기”를 사용할 수 있습니다. 다만 파일은 저장 당시 내용의 사본이므로 원격 구독이 자동으로 업데이트되지 않을 수 있습니다. 처음부터 노드 항목을 수정하거나 파싱 오류가 난 줄을 삭제하지 마세요. 무작정 고치는 것보다 구독 제공자에게 호환 형식을 확인하는 편이 문제를 찾기 쉽습니다. 구독, 설정 파일, 프록시 노드의 차이는 용어 빠른 확인에서 살펴보세요.

STEP 02 / ROUTING

규칙 모드와 프록시 출구 선택

설정을 활성화한 다음 홈 화면, 설정 화면 또는 메뉴 막대에서 모드 메뉴를 열고 “규칙” 또는 “Rule”을 선택합니다. 규칙 모드는 현재 설정의 규칙 순서에 따라 대상별로 직접 연결, 프록시 또는 차단 등의 동작을 선택합니다. 설정에 포함된 트래픽 분기 규칙을 유지할 수 있어 처음 사용할 때 적합합니다. 메뉴에 “전역”과 “직접 연결”도 있다면 처음부터 반복해서 바꾸지 마세요. 특정 문제를 분리해 확인할 때만 임시로 모드를 바꾸고 원래 설정을 기록해 두세요.

이어서 “프록시” 화면에서 정책 그룹을 확인합니다. 그룹 이름은 설정 작성자가 정하므로 한국어, 영어 또는 용도를 나타내는 이름일 수 있으며, 반드시 “PROXY”라고 표시되는 것은 아닙니다. 기본 프록시 출구를 담당하는 선택 그룹을 열고 사용할 수 있는 노드를 선택하세요. 선택 항목 자체가 다른 정책 그룹이라면 펼쳐서 최종 출구까지 확인합니다. 그룹에서 DIRECT를 선택하면 해당 그룹에 전달된 연결은 직접 연결됩니다. 클라이언트가 규칙 모드여도 이 연결이 강제로 프록시 노드를 사용하지는 않습니다.

설정에 자동 테스트 그룹이 있다면 후보로 유지할 수 있지만, 먼저 클라이언트의 지연 시간 테스트를 실행해 결과가 정상적으로 나오는지 확인하세요. 테스트 결과는 지정된 테스트 주소의 연결 여부와 왕복 시간만 나타냅니다. 모든 웹사이트에 접속할 수 있다는 뜻도, 다운로드 속도를 보장한다는 뜻도 아닙니다. 특정 노드가 계속 시간 초과되면 결과가 정상적으로 나온 다른 노드로 바꿔 첫 연결을 확인하세요. 최저 수치를 얻으려고 테스트 주소, 간격, DNS를 한꺼번에 바꾸면 원인을 구분하기 어려워집니다.

라우팅 모드와 연결 방식 구분하기

규칙, 전역, 직접 연결은 “코어에 들어온 트래픽이 어떤 출구로 나갈지” 정하고, 시스템 프록시와 TUN은 “앱 트래픽이 코어에 어떻게 들어올지” 정합니다. 서로 다른 단계의 설정입니다. 모드만 전역으로 바꿔도 시스템 프록시를 따르지 않는 앱의 트래픽까지 처리되는 것은 아닙니다. 시스템 프록시만 켜도 노드 선택을 대신할 수는 없습니다. 처음에는 규칙 모드를 유지하고, 다음 단계에서 플랫폼에 맞는 연결 방식을 하나만 선택하세요.

전역 모드는 보통 코어에 들어온 연결을 전역 정책으로 보냅니다. 이 경우에도 해당 정책의 출구를 선택해야 합니다. 직접 연결 모드는 연결을 바로 보내는 방식이며 시스템 프록시를 끄는 것과는 다릅니다. 클라이언트의 트래픽 처리를 완전히 중단하려면 다음 단계에서 연결 상태와 시스템 연결 스위치를 모두 다뤄야 합니다. 정책 그룹 중첩과 url-test, fallback의 차이는 정책 그룹 관련 용어부터 살펴보세요. 첫 연결을 위해 설정을 직접 작성할 필요는 없습니다.

설정을 확인한 뒤 현재 모드와 선택한 정책을 기록하거나 구독 URL이 보이지 않도록 이 기기에서 스크린샷을 저장해 두세요. 다음 단계에서 연결을 확인할 때 대상이 다른 정책 그룹에 매칭된다면 해당 그룹으로 돌아가 조정할 수 있습니다. 선택한 노드가 저장되지 않았다고 오해하지 않도록 도움이 됩니다.

STEP 03 / SYSTEM ACCESS

연결을 시작하고 시스템 권한 승인하기

구독과 출구를 확인한 뒤 트래픽 연결을 시작하세요. 먼저 다른 VPN, 프록시 클라이언트, 네트워크를 제어할 수 있는 도구를 일시적으로 종료해 두 앱이 시스템 프록시나 라우팅 설정을 동시에 바꾸지 않도록 합니다. 시스템 프록시와 TUN, 여러 보조 스위치를 한꺼번에 켜지 마세요. 한 가지 명확한 방식으로 먼저 연결한 다음 실제 앱 사용에 필요한 기능을 추가하세요. 이렇게 하면 접속 문제의 원인이 설정, 노드 또는 시스템 연결 중 어디에 있는지 판단하기 쉽습니다.

iOS: 연결하고 VPN 구성 추가 허용

Clash Plus 메인 화면에서 연결 스위치를 찾습니다. 처음 연결할 때 iOS에서 VPN 구성 추가를 묻는 시스템 확인 창이 표시될 수 있습니다. 요청을 보낸 앱이 방금 연 클라이언트인지 확인하고 허용을 누른 다음 시스템 안내에 따라 기기 인증을 완료하세요. 클라이언트로 돌아와 연결 상태가 연결됨으로 바뀔 때까지 기다립니다. 방금 권한 요청을 취소했다면 연결을 다시 누르고 승인하세요. 버튼을 눌렀다는 이유만으로 연결에 성공했다고 판단하지 마세요.

권한을 승인한 뒤 시스템 설정의 VPN 관련 화면에서 구성과 연결 상태를 확인할 수 있습니다. 상태 막대에 VPN 표시가 나타나는지는 기기 모델과 화면 설정에 따라 다르므로 유일한 확인 기준으로 삼지 마세요. 시스템 화면에서 다른 앱이 연결 중이라고 표시되면 해당 연결을 끊고 현재 클라이언트로 돌아와 연결을 시작하세요. iOS는 시스템의 네트워크 기능으로 트래픽을 연결하므로 데스크톱 안내를 그대로 따라 무선 네트워크 세부 정보에 기기의 프록시 포트를 추가할 필요가 없습니다.

macOS: 코어를 먼저 실행한 뒤 시스템 프록시 켜기

클라이언트를 열고 코어가 실행 중인지 확인한 다음 “시스템 프록시”를 켭니다. 클라이언트에 따라 설정 화면이나 메뉴 막대 메뉴에서 스위치를 찾을 수 있습니다. 시스템 프록시를 켜면 해당 설정을 따르는 앱의 트래픽이 클라이언트의 로컬 리스닝 포트로 전달됩니다. 브라우저에서 프록시를 수동으로 설정했거나 프록시 제어 확장 프로그램을 설치했다면 앱 자체 설정이 현재 연결 방식을 덮어쓰지 않도록 시스템 설정 사용으로 되돌리세요.

리스닝에 실패하거나 포트가 이미 사용 중이라는 오류가 나오면 클라이언트의 실제 mixed-port 값을 먼저 확인한 뒤 다른 프로그램이 같은 포트를 사용 중인지 살펴보세요. 모든 클라이언트가 같은 포트를 사용하는 것은 아닙니다. 이 기기에서만 사용할 때는 보통 “LAN 연결 허용”을 켤 필요가 없습니다. 이 옵션은 다른 기기에서 리스닝 서비스에 접근하게 하는 기능이며 프록시를 켜기 위한 필수 조건이 아닙니다. 포트와 리스닝 주소의 의미는 용어 빠른 확인에서 살펴보세요.

대상 앱이 시스템 프록시를 사용하지 않고 현재 클라이언트가 해당 기능을 지원하는 경우에만 TUN을 고려하세요. macOS 클라이언트에 따라 보조 서비스, 가상 네트워크 인터페이스 또는 네트워크 확장 등 서로 다른 방식을 사용할 수 있어 필요한 권한도 다릅니다. 현재 앱의 설치 안내에 따라 시스템 메시지에 대응하고, 안내를 그대로 따라 하기 위해 시스템 보안 기능을 끄지 마세요. 버전별 차이와 권한 설정은 전체 플랫폼 설치 및 설정 가이드를 참고하세요. 첫 연결 확인은 시스템 프록시만으로 진행할 수 있습니다.

STEP 04 / VERIFICATION

연결 상태와 규칙 분기 확인

연결 상태가 정상이면 브라우저에서 새 탭을 열고 정상적으로 접속할 수 있는 일반 웹페이지에 방문해 기본 연결이 유지되는지 확인하세요. 그런 다음 현재 설정에서 프록시를 사용해야 하는 대상에 접속하고 클라이언트의 “연결” 또는 “활동” 화면을 함께 엽니다. 방금 보낸 요청을 찾아 대상 도메인, 적용된 규칙, 사용된 정책 경로를 확인하세요. 표시 항목은 클라이언트마다 다르지만 연결이 직접 연결인지, 프록시 그룹으로 전달됐는지, 규칙에 의해 차단됐는지는 확인할 수 있어야 합니다.

이전 연결이 판단에 영향을 주지 않도록 정책을 바꾼 뒤에는 해당 웹페이지를 닫고 새 요청을 보내세요. 클라이언트에서 특정 연결을 끊을 수 있다면 관련 항목만 끊어도 됩니다. 파일을 전송하거나 회의하는 중에 모든 연결을 지우지 마세요. 규칙과 정책을 바꿔도 이미 설정된 연결은 기존 출구를 계속 사용할 수 있습니다. 설정이 적용되지 않았다고 단정할 필요는 없습니다.

출구 결과를 연결 기록과 대조하기

출구를 확인하려면 프록시 연결 상태에서 신뢰할 수 있는 공인 IP 확인 페이지에 접속한 뒤 프록시를 끊었을 때의 결과와 비교하세요. 확인 페이지 자체에도 규칙이 적용되므로 클라이언트에서 어떤 정책이 매칭됐는지 먼저 살펴봅니다. DIRECT가 적용됐다면 출구가 바뀌지 않는 것이 규칙에 따른 정상적인 결과입니다. 출구 확인은 해당 요청의 네트워크 경로만 보여 줍니다. 기기의 모든 앱이 같은 경로를 사용한다는 뜻은 아니며, 대상 앱을 직접 테스트하는 과정도 대신할 수 없습니다.

이어서 설정에서 직접 연결되어야 하는 대상을 골라 다시 확인하고, 연결 기록에 DIRECT가 표시되는지 살펴보세요. 그런 다음 프록시 대상도 확인해 정책 이름과 선택한 노드가 일치하는지 비교합니다. 이 과정으로 “트래픽이 클라이언트에 들어왔는지”와 “규칙이 예상한 출구를 선택했는지”를 함께 확인할 수 있습니다. 처음 설정할 때 복잡한 속도 테스트를 할 필요는 없습니다. 요청이 안정적으로 연결되고, 정책이 올바르게 적용되며, 실제 데이터가 오가면 확인을 마칠 수 있습니다.

문제가 생기면 정해진 순서로 점검

클라이언트에 연결됨으로 표시되지만 활동 화면에 브라우저 요청이 전혀 없다면 시스템 프록시가 켜져 있는지, 브라우저가 시스템 설정을 우회하는지, 다른 VPN이 트래픽을 처리 중인지 먼저 확인하세요. 요청 기록은 있지만 대상에서 계속 시간 초과가 발생한다면 유효한 다른 노드로 바꾸어 다시 시도하고 직접 연결 대상은 접속되는지 비교합니다. 특정 앱에서만 문제가 생기면 해당 앱이 시스템 프록시를 지원하는지 확인하세요. 브라우저가 정상이라고 해서 모든 앱이 연결됐다고 볼 수는 없습니다.

기록에 REJECT가 표시되면 노드를 계속 바꾸기보다 적용된 규칙을 확인하세요. 로그에 도메인 확인 오류가 나타나면 기존 설정을 보존한 채 구독에서 지원하는 DNS 설정이 있는지 확인합니다. 인터넷에서 찾은 DNS 설정 전체를 바로 덮어쓰지 마세요. 원인을 찾을 때는 한 번에 설정 하나만 바꾸고 같은 대상을 다시 테스트해야 변경 효과를 판단할 수 있습니다. DNS, TUN 또는 플랫폼 라우팅을 자세히 점검해야 한다면 전체 플랫폼 가이드에서 운영체제별 항목을 확인하세요.

구독 제공자나 프로젝트 유지관리자에게 문제를 설명해야 한다면 클라이언트 이름, 운영체제, 오류가 발생한 단계, 대상에 프록시가 적용됐는지, 민감한 정보를 제거한 오류 메시지를 기록하세요. 구독 URL 전체나 설정에 포함된 인증 정보, 개인 접속 기록이 담긴 전체 로그를 그대로 올리지 마세요. “연결 실패”만 표시된 스크린샷보다 문제를 재현할 수 있는 작업 순서가 원인을 찾는 데 더 도움이 됩니다.

이제 첫 연결에 필요한 네 단계를 마쳤습니다. 이후에는 필요할 때 클라이언트에서 구독을 업데이트하고, 검증을 마친 설정을 기준으로 보관하면 됩니다. 다른 클라이언트를 선택하려면 클라이언트 목록으로 돌아가세요. 규칙, 정책 그룹, 네트워크 스택 용어는 용어 빠른 확인에서 살펴볼 수 있습니다. 일상적으로 사용하기 위해 모든 설정 항목을 미리 익힐 필요는 없습니다.

클라이언트 다운로드