첫 연결 · 사용 가이드

Clash 구독 가져오기
및 연결 설정 가이드

설정 페이지에서 시작해 ‘구독 가져오기 → 프록시 모드 선택 → 연결 → 확인’ 순서로 처음 설정을 마치세요. 클라이언트와 유효한 구독을 준비했다면 약 10분이면 진행할 수 있습니다. 구독 다운로드와 시스템 권한 승인에 걸리는 시간은 환경에 따라 다릅니다.

Clash YAML 구독 규칙 모드 시스템 프록시 / VPN 연결 기록 확인

단계 01 · 설정

구독을 가져와 설정 활성화

클라이언트 왼쪽 메뉴에서 ‘설정’을 열고 ‘새로 만들기’, ‘가져오기’ 또는 더하기 버튼을 찾으세요. 서비스 제공업체가 안내한 Clash / mihomo 호환 구독 URL을 준비해 전체 주소를 URL 입력란에 붙여넣은 다음 ‘다운로드’ 또는 ‘가져오기’를 누릅니다. 여기에 입력할 것은 구독 URL이지 서비스 제공업체의 홈페이지, 로그인 페이지, 결제 페이지가 아닙니다. 클라이언트는 이 주소에서 설정 내용을 가져오므로, 브라우저에서 웹사이트가 열린다고 해서 유효한 구독이라는 뜻은 아닙니다.

클립보드에서 가져오려면 먼저 URL 전체를 복사한 뒤 클라이언트로 돌아와 ‘클립보드에서 가져오기’를 선택하세요. 입력란에 설명 문구, 공백, 줄바꿈이 섞이지 않았는지 확인하고, 특히 메신저에서 전달하는 과정에 URL 뒷부분이 잘리지 않았는지 살펴보세요. 구독 URL에는 계정 접근 정보가 포함되는 경우가 있으므로 인증 정보처럼 안전하게 보관하세요. 문제를 문의할 때는 오류 내용을 공유하기 전에 전체 URL과 구독 화면에 표시된 민감한 정보를 가리세요.

URL 다운로드가 끝나면 설정 카드를 선택하세요

다운로드가 끝나면 보통 설정 목록에 이름이 표시된 카드가 나타납니다. 카드를 누르거나 ‘활성화’ 버튼을 눌러 선택 표시, 현재 설정 안내 또는 활성 상태가 나타날 때까지 진행하세요. 가져오기 성공과 사용 중 상태는 다릅니다. 목록에 파일이 있다는 것은 설정이 저장되었다는 뜻일 뿐입니다. 해당 설정을 선택해야 코어가 정책 그룹과 규칙을 불러옵니다. 그런 다음 ‘프록시’ 페이지에서 설정에 정의된 정책 그룹이 표시되는지 확인하세요. 이전 내용이 계속 보이면 설정 페이지로 돌아가 선택 항목을 확인하세요.

처음 활성화할 때 클라이언트가 구문을 검사하거나 코어를 다시 불러올 수 있습니다. 작업이 끝날 때까지 기다린 뒤 다음 단계로 진행하세요. 구문 오류가 발생하면 오류 메시지에 YAML, 들여쓰기, 필드 유형 또는 특정 줄 번호가 언급되는지 확인하세요. 오류가 난 줄을 무작정 삭제해 실행하지 마세요. 다른 정책에서 해당 줄을 참조할 수 있습니다. 서비스 제공업체가 Clash 형식이라고 안내한 구독을 다시 받아오고, 현재 클라이언트의 코어가 해당 설정을 지원하는지 확인하는 편이 안전합니다.

로컬 파일 및 구독 업데이트

config.yaml 또는 .yml 파일을 받았다면 ‘파일에서 가져오기’를 이용해 해당 파일을 선택하세요. 클라이언트가 드래그 앤 드롭을 명시적으로 지원하는 경우에만 파일을 설정 영역으로 끌어다 놓습니다. 로컬 파일은 이전이나 임시 테스트에 유용하지만, 일반적으로 서비스 제공업체가 원격 구독을 수정해도 자동으로 업데이트되지 않습니다. URL 설정에서 정기 업데이트를 지원한다면 설정 카드의 편집 메뉴에서 업데이트를 켜고 서비스 안내에 따라 간격을 지정하세요. 업데이트 후에도 원하는 설정이 활성화되어 있는지 확인해야 합니다.

다운로드 시간 초과가 발생하면 먼저 기기의 기본 네트워크가 정상인지, 구독이 유효한지 확인한 뒤 다시 다운로드해 보세요. DNS, TUN, 포트를 한꺼번에 바꾸지는 마세요. 다운로드 결과가 웹페이지 내용이거나 필수 설정이 없다는 안내가 나오면 서비스 제공업체 페이지에서 구독 유형을 확인하세요. 형식 변환 및 구독 오류에 대한 자세한 내용은 도움말 센터를 참고하세요. 설정이 활성화되고 프록시 페이지에 선택할 수 있는 정책 그룹이 표시되면 실행 모드를 선택할 수 있습니다.

단계 02 · 트래픽 분배

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

‘개요’ 또는 ‘프록시’ 페이지로 이동해 ‘모드’ 항목에서 실행 모드를 규칙 / Rule로 설정하세요. 이 설정은 코어로 들어온 요청을 어떻게 분배할지 결정합니다. 규칙 모드에서는 설정의 규칙을 위에서부터 적용하며, 요청은 직접 연결되거나 정책 그룹으로 전달되거나 거부될 수 있습니다. 처음 사용할 때는 구독에 포함된 규칙을 그대로 두고 연결을 먼저 확인하세요. 이후 자체 규칙을 추가하면 문제가 생겼을 때 변경 지점을 찾기 쉽습니다.

‘전역 / Global’은 보통 코어로 들어온 트래픽을 전역 정책에 전달하므로 잠깐 비교 테스트할 때 유용합니다. ‘직접 연결 / Direct’는 보통 코어로 들어온 트래픽을 대상에 바로 연결합니다. 어느 쪽도 클라이언트를 끄는 기능은 아니며 시스템 프록시 설정을 대신하지 않습니다. 특히 전역 모드를 선택해도 모든 앱의 트래픽이 자동으로 수집되는 것은 아닙니다. 앱의 트래픽이 코어로 들어오는지는 시스템 프록시, 명시적 프록시, TUN 등의 연결 방식에 달려 있습니다.

정책 그룹을 펼쳐 출구 선택

프록시 페이지에서 프록시 트래픽을 처리하는 정책 그룹을 찾아 펼친 다음 현재 구독에서 사용할 수 있는 출구를 선택하세요. 그룹 이름은 구독 설정에 따라 다르며 한국어, 중국어 또는 영어일 수 있으므로 특정한 이름을 찾을 필요는 없습니다. 정책 그룹이 다른 그룹을 가리킬 수도 있습니다. 상위 그룹을 선택한 뒤에도 하위 그룹의 실제 선택을 확인해 요청이 최종적으로 어떤 출구를 통해 나가는지 파악하세요.

설정에 ‘자동 선택’과 같은 그룹이 있다면 이를 선택할 수 있습니다. 코어가 해당 그룹의 테스트 방식에 따라 구성원을 선택합니다. 수동 선택 그룹은 현재 선택을 유지하므로 출구를 고정해야 할 때 적합합니다. 클라이언트의 연결 테스트 또는 지연 시간 테스트 버튼을 눌러 결과가 나올 때까지 기다린 다음 테스트를 통과한 항목을 선택하세요. 테스트 시간 초과는 이번 확인에 실패했다는 뜻일 뿐이며 테스트 주소, 네트워크 또는 출구가 원인일 수 있습니다. 테스트에 성공해도 참고 자료일 뿐, 실제 대상 사이트에 접속해 확인해야 합니다.

기본 규칙을 유지해 변경 변수를 줄이세요

처음 연결할 때는 실행 모드를 규칙 모드로 설정하고 프록시 정책 그룹에서 사용할 수 있는 출구를 선택하는 두 가지만 변경하는 것이 좋습니다. 규칙 순서, DNS 모드, 연결 포트를 동시에 바꾸지 마세요. 특정 사이트의 연결 경로가 예상과 다르면 연결 기록에서 적용된 규칙을 먼저 확인한 뒤 덮어쓸지 결정하세요. 규칙 기반 트래픽 분배는 각 요청의 대상과 일치 조건에 따라 결정됩니다. 사이트가 속한 지역이나 브라우저 페이지 언어만으로 실제 출구를 정확히 알 수는 없습니다.

이 가이드에서는 정책 그룹 유형과 규칙 작성 방법을 다루지 않습니다. 자동 선택, 장애 조치 또는 규칙 집합 구독을 이해하려면 mihomo 고급 설정 가이드를 참고하세요. 지금은 현재 모드와 정책 그룹 선택을 확인하고 다른 설정은 그대로 두면 네트워크 연결 단계로 넘어갈 수 있습니다. 설정을 그대로 유지하면 문제가 생겼을 때 여러 스위치를 반복해서 바꾸지 않고도 원인을 차례로 확인할 수 있습니다.

단계 03 · 네트워크 연결

시스템 프록시 또는 VPN 연결 켜기

클라이언트 메인 화면으로 돌아가 코어가 실행 중인지 확인한 다음 기기에 맞는 네트워크 연결을 켜세요. 코어 실행, 실행 모드, 시스템 연결은 서로 별개의 단계입니다. 코어는 요청을 처리하고, 모드는 트래픽 분배 방식을 정하며, 시스템 연결은 앱의 요청을 코어로 전달합니다. 클라이언트 창이 열려 있거나 모드가 규칙으로 설정되어 있다는 것만으로 브라우저가 프록시를 사용한다고 볼 수는 없습니다.

macOS 및 Windows: 시스템 프록시부터 켜기

클라이언트 홈 화면, 설정 페이지 또는 메뉴 막대 메뉴에서 ‘시스템 프록시’를 찾아 켜세요. macOS에서는 일부 클라이언트가 메뉴 막대에 빠른 전환 메뉴를 제공합니다. 시스템에서 보조 서비스 권한을 요청하면 앱 이름과 작업 목적을 확인한 뒤 안내에 따라 승인하세요. 프록시를 켜면 시스템 네트워크 설정의 해당 프록시 항목에 로컬 주소가 표시되는 경우가 많습니다. 확인을 위해 시스템 설정 전체를 수동으로 다시 입력하기보다는 클라이언트가 프록시 설정과 복구를 관리하도록 하세요.

그런 다음 브라우저에서 새 탭을 열고 테스트할 사이트에 접속하세요. 시스템 프록시 설정을 따르는 브라우저는 대부분 새 요청을 클라이언트로 전달합니다. 이미 연결된 장시간 연결은 이전 경로를 계속 사용할 수 있으므로 설정을 바꾼 뒤에는 새 요청을 보내야 합니다. 다른 VPN이나 프록시 프로그램도 실행 중이라면 시스템 프록시 설정이 서로 덮어써지지 않도록 하나를 먼저 일시 중지하세요. 클라이언트에서 포트 사용 중이라고 알리면 중복 실행된 인스턴스가 있는지 확인한 뒤 도움말 센터에서 포트 충돌 해결 방법을 살펴보세요.

Android 및 iOS: 연결을 누르고 시스템 권한 승인

모바일 클라이언트 홈 화면에서 ‘연결’ 또는 시작 버튼을 누르세요. 처음 연결할 때 시스템에서 VPN 연결을 만들거나 VPN 구성을 추가할지 묻는 경우 승인한 뒤 클라이언트로 돌아와 연결됨 상태가 될 때까지 기다립니다. 시스템에 VPN 표시가 나타나면 기기에 연결 통로가 설정되었다는 뜻입니다. 모든 요청이 원격 프록시를 사용한다는 뜻은 아니며, 설정의 직접 연결 규칙에 따라 요청이 대상에 바로 연결될 수도 있습니다.

기존에 연결된 VPN이 있다면 터널이 서로 교체되지 않도록 먼저 연결을 끊고 다시 시도하세요. 일부 Android 클라이언트는 앱별 프록시 또는 앱 제외 설정을 제공합니다. 테스트할 때 브라우저가 제외되지 않았는지 확인하세요. iOS에서는 앱을 전환한 뒤 연결 문제가 생기면 상태 표시줄 아이콘만 보지 말고 클라이언트로 돌아와 실제 연결 상태를 확인하세요. 시스템 버전에 따라 권한 안내 문구가 다를 수 있으니 현재 기기에 표시되는 항목에 따라 진행하면 됩니다.

TUN 모드: 실제 연결이 필요할 때만 켜기

브라우저는 정상적으로 작동하지만 시스템 프록시를 따르지 않는 일부 앱의 트래픽이 클라이언트에 들어오지 않을 때 TUN을 고려하세요. TUN은 가상 네트워크 인터페이스와 라우팅 설정으로 트래픽을 연결하며, 데스크톱에서는 서비스 설치, 관리자 권한 또는 네트워크 확장 승인이 필요할 수 있습니다. 현재 클라이언트 안내에 따라 권한을 승인하고, 켠 뒤 명확한 시작 오류가 있는지 확인하세요. 시스템 프록시와 TUN을 항상 함께 켜야 하는 것은 아니며, 병행 여부는 클라이언트 구현과 권장 설정에 따라 달라집니다.

Linux 데스크톱에서 시스템 프록시를 일괄 적용할 수 있는지는 데스크톱 설정과 앱에 따라 다릅니다. 명령줄 도구에도 프록시를 별도로 지정해야 할 수 있습니다. 우선 브라우저로 기본 연결을 확인하고 여기서는 터미널 환경 변수 설정까지 다루지 않습니다. TUN, DNS, Fake-IP 연동은 고급 설정 가이드에서 살펴보세요. 이 단계가 끝나면 시스템 프록시가 켜져 있거나 VPN이 연결되어 있고, 클라이언트에 지속적인 시작 실패가 표시되지 않아야 합니다.

단계 04 · 확인

연결 및 규칙 적용 여부 확인

클라이언트의 ‘연결’ 페이지를 열어 화면을 볼 수 있도록 둔 다음 브라우저에서 정상적으로 접속할 수 있는 사이트를 방문하세요. 연결 목록에 새 도메인이나 대상 주소가 표시되는지 확인합니다. 짧은 연결은 금방 사라질 수 있으므로 웹페이지를 새로고침한 직후 확인하거나 목록에서 도메인을 검색하세요. 연결 목록이 없다면 ‘로그’를 열어 요청과 오류 정보를 확인합니다. 중요한 것은 화면의 총 트래픽 수치가 아니라 방금 보낸 요청을 구체적인 기록과 연결할 수 있는지입니다.

기록을 선택해 대상, 적용된 규칙, 정책 체인 또는 출구 항목을 확인하세요. 클라이언트마다 열 이름이 다르며 일부 정보만 표시될 수도 있습니다. 기록에 DIRECT라고 표시되면 해당 요청이 직접 연결 정책으로 처리된 것입니다. 설정의 프록시 정책 그룹을 거쳤다면 최종 선택도 확인하세요. MATCH가 적용된 경우 보통 앞선 규칙이 일치하지 않아 기본 규칙으로 넘어간 것이며, 이것만으로 설정 오류라고 볼 수는 없습니다.

직접 연결과 프록시 연결을 각각 테스트

현재 구독 규칙에 따라 직접 연결되어야 하는 사이트를 먼저 방문하고, 이어서 프록시를 사용해야 하는 사이트에 접속해 연결 기록과 실제 경로를 비교하세요. 사이트 이름만 보고 추측하지 말고 설정과 기록을 기준으로 판단하세요. 한 웹페이지에서 이미지, 스크립트, API 도메인으로 여러 요청을 보낼 수 있으며 각 요청에 서로 다른 규칙이 적용될 수 있습니다. 따라서 메인 페이지가 열렸다고 모든 트래픽 분배가 올바르다고 판단하지 말고, 실제로 실패한 도메인을 확인해야 합니다.

출구를 추가로 확인하려면 예상한 프록시 요청을 통해 신뢰할 수 있는 IP 조회 서비스를 이용한 뒤 직접 연결 결과와 비교할 수 있습니다. 조회 결과는 조회 도메인에 적용된 규칙의 영향을 받으므로 참고 자료로 활용하세요. 클라이언트의 정책 체인 기록을 대신할 수는 없습니다. 같은 출구가 표시되더라도 프록시가 작동하지 않는다고 단정할 수 없습니다. 테스트 요청 자체가 직접 연결 규칙에 걸렸을 수 있습니다. 최종 판단은 요청이 코어에 들어왔는지, 어떤 규칙이 적용되었는지, 대상에 접속할 수 있는지를 함께 확인해야 합니다.

설정, 연결, 출구 순으로 점검

연결 목록에 방금 보낸 요청이 전혀 없다면 먼저 대상 설정이 활성화되어 있는지 확인한 뒤 시스템 프록시 또는 VPN이 실제로 켜져 있는지, 테스트 앱이 제외되지 않았는지 살펴보세요. 브라우저에 캐시된 페이지가 표시되면 새 네트워크 요청이 없을 수 있으므로 새로고침한 뒤 다시 확인하세요. Linux 앱이나 프록시를 별도로 설정한 앱은 데스크톱 시스템 프록시를 사용하지 않을 수도 있으므로 앱의 연결 방식도 확인해야 합니다.

기록은 나타나지만 요청 시간이 초과되면 최종 출구가 2단계에서 선택한 항목과 같은지 확인한 뒤 같은 그룹의 다른 사용 가능한 항목을 시도하세요. 로그에 이름 확인 실패, 연결 거부 또는 인증 오류가 명시되어 있다면 각각 DNS, 대상 연결, 구독 인증을 점검하세요. 모든 오류를 규칙 문제로 간주하지 마세요. 로그를 공유하기 전에는 구독 URL, 접근 정보, 개인 도메인을 가리세요. 더 자세한 문제 해결 절차는 도움말 센터에서 확인하세요. 처음 설정하는 동안 너무 많은 항목을 한꺼번에 바꾸지 않는 것이 좋습니다.

종료 전에 연결을 끄고 업데이트 후 다시 확인

직접 연결과 프록시 연결이 모두 예상대로 작동하는지 확인했다면 현재 규칙 모드와 정책 선택을 그대로 유지하면 됩니다. 이후 구독을 업데이트하거나 네트워크 또는 출구를 바꾼 뒤에는 새 요청을 보내고 적용된 규칙과 대상 접속 상태를 확인하는 간단한 점검을 반복하세요. 매번 설정을 다시 가져올 필요는 없습니다. 구독 URL이나 설정 출처가 달라졌을 때만 첫 단계로 돌아가 출처를 바꾸세요.

프록시를 당분간 사용하지 않을 때는 클라이언트에서 시스템 프록시를 끄거나 VPN 연결을 해제한 뒤 앱을 종료하세요. 특히 데스크톱에서는 프로세스만 강제 종료해 로컬 포트를 가리키는 시스템 프록시 설정이 남지 않도록 주의해야 합니다. 종료 후 네트워크에 문제가 생기면 시스템 네트워크 설정에서 프록시 상태를 확인하거나 클라이언트를 다시 열어 연결을 끄세요. 이로써 구독, 모드, 네트워크 연결, 작동 확인까지 기본 설정을 마쳤습니다. 규칙, DNS 또는 로컬 설정을 조정하려면 고급 설정으로 넘어가세요.

고급 설정 가이드 더 보기 · 증상별 자주 묻는 질문 찾기