Clash 구독 가져오기
및 기본 설정

시작 전: 기존 구독 준비

Clash 클라이언트를 설치해도 프록시 노드가 자동으로 제공되지는 않습니다. 시작하기 전에 사용할 수 있는 Clash 형식 구독 링크나 YAML 설정 파일을 준비하세요. 링크와 서비스 이용 가능 여부는 구독 제공업체가 관리합니다. 이 사이트는 클라이언트 다운로드와 사용 문서를 제공하며 구독은 배포하지 않습니다. 프로토콜 링크 하나나 긴 인코딩 문자열만 있다면 해당 형식을 클라이언트가 지원하는지 먼저 확인하세요. 이를 완성된 설정 파일로 간주해 바로 가져오면 안 됩니다.

처음 설정할 때는 기본값을 유지하는 것이 좋습니다. 다른 프록시나 VPN, 브라우저 프록시 확장 프로그램을 사용 중인지 확인하고, 테스트 중에는 트래픽 처리 방식을 하나만 명확히 유지하세요. 그래야 요청이 어디로 전달되는지 파악하기 쉽습니다. 회사나 학교에서 관리하는 기기는 프록시 설정, 네트워크 확장 프로그램, 서비스 설치가 제한될 수 있습니다. 기기 관리 정책을 따르고, 권한을 반복해서 높여 제한을 우회하려 하지 마세요.

구독 링크에는 계정 접근 토큰이 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 화면을 공유할 때는 전체 주소를 가리고, 로그를 점검할 때는 링크의 매개변수와 노드 인증 정보를 삭제하세요. 낯선 온라인 변환 사이트에 링크를 입력하지 마세요. 「코어」「설정」「노드」 같은 용어가 익숙하지 않다면 먼저 용어집을 확인한 다음 아래 첫 단계로 진행하세요.

1단계: 구독을 가져와 설정 적용하기

Clash 클라이언트를 열고 「설정」, 「구독」 또는 「Profiles」 페이지로 이동해 「새로 만들기」, 「가져오기」 또는 구독 주소 입력란을 찾으세요. 구독 제공업체에서 전체 링크를 복사해 붙여넣고, 앞뒤에 공백이나 줄바꿈, 메신저가 붙인 문장부호가 들어가지 않았는지 확인하세요. 도메인이나 경로만 복사하지 말고 링크의 쿼리 매개변수까지 모두 포함해야 합니다.

「가져오기」 또는 「다운로드」를 눌러 클라이언트가 내용을 가져와 분석할 때까지 기다리세요. 성공하면 보통 설정 이름이 표시된 카드가 나타나며, 일부 클라이언트는 업데이트 시각도 보여줍니다. 설정 카드가 표시되어도 해당 설정이 적용된 것은 아닙니다. 카드를 누르거나 「적용」, 「사용」 메뉴를 선택해 체크 표시가 나타나는지 확인한 다음 「프록시」 페이지에서 정책 그룹이 표시되는지 살펴보세요.

로컬 파일을 가져오려면 「파일에서 가져오기」 또는 클라이언트가 지원하는 드래그 앤 드롭 기능을 사용해 실제 YAML 파일을 선택하세요. 다른 형식의 파일 확장자만 .yaml로 바꾸지 마세요. 확장자를 바꿔도 파일 내부 구조는 달라지지 않습니다. 완성된 설정에는 보통 프록시 노드, 정책 그룹, 규칙 등이 포함됩니다. 규칙 몇 줄만 있는 예제 조각은 구독 제공업체가 제공한 설정을 대신할 수 없습니다.

실패 지점에 따라 가져오기 문제 해결

가져오기를 눌러도 계속 대기하거나 timeout, context deadline exceeded가 표시된다면 제한 시간 안에 내용을 가져오지 못한 경우가 많습니다. 먼저 기기 자체가 인터넷에 연결되는지 확인한 다음 구독 주소에 접속할 수 있는지 점검하세요. 첫 가져오기 중에는 사용할 수 있는 프록시가 아직 없으므로 새로 가져오는 설정으로 그 다운로드를 처리할 수 없습니다. 현재 이용 가능한 네트워크를 사용하거나 구독 제공업체에 사용할 수 있는 가져오기 방법을 문의하세요.

401 또는 403 응답이 오면 링크 만료 여부, 누락된 매개변수, 계정 접근 권한을 먼저 확인하세요. 서비스 측 접근 제한으로도 이런 응답이 발생할 수 있으므로 제공업체의 안내를 함께 살펴보세요. yaml: unmarshal errors 또는 특정 줄 번호가 포함된 분석 오류는 응답 내용이 예상한 구조와 다르다는 뜻입니다. 웹 오류 페이지, 로그인 화면, 다른 클라이언트 전용 구독이 YAML 파일로 잘못 처리됐을 수 있습니다.

오류가 발생했다고 같은 구독을 여러 개 연달아 만들지 마세요. 하나만 남겨 주소를 확인하고 업데이트를 시도하세요. 교체가 필요하다면 새 설정과 기존 설정에 서로 다른 이름을 지정하고, 새 설정이 정상 작동하는 것을 확인한 뒤 기존 항목을 삭제하세요. 구독 업데이트는 보통 원격 내용을 다시 가져오므로 구독 원문을 직접 수정해도 덮어써질 수 있습니다. 처음 사용할 때는 규칙을 수정하지 않는 편이 좋습니다. 로컬 변경 사항을 장기간 유지해야 한다면 로컬 오버라이드와 설정 관리를 확인하세요.

설정 목록에 명확히 선택된 항목이 있고, 「프록시」 페이지에 해당 정책 그룹이 표시되며, 클라이언트가 로드 실패를 계속 알리지 않으면 이 단계가 끝난 것입니다. 이 상태를 확인한 다음 프록시 모드를 선택하세요. 네트워크 설정을 한꺼번에 모두 켤 필요는 없습니다.

2단계: 규칙 모드와 프록시 정책 선택

「프록시」 또는 홈 화면의 「모드」 설정으로 이동해 「규칙」 또는 Rule을 선택하세요. 이 모드에서는 현재 설정의 규칙에 따라 요청을 하나씩 판별한 뒤 지정된 정책으로 처리합니다. 일상적인 사용에 적합하지만 어떤 사이트를 프록시로 보내고 직접 연결할지는 구독 설정에 따라 달라집니다. 클라이언트가 지역 이름만으로 이를 미리 정하는 것은 아닙니다.

이어서 정책 그룹을 확인하세요. 흔히 「프록시」, 「노드 선택」, 「자동 선택」 등의 이름을 사용하지만 구독 제공업체가 다른 이름을 지정할 수도 있습니다. 프록시 연결을 담당하는 그룹을 펼쳐 사용 가능한 노드를 선택하거나 설정에 포함된 자동 선택 그룹을 고르세요. 그룹이 여러 단계로 나뉘어 있다면 최종 선택까지 확인하세요. 겉에 보이는 그룹 이름만 보고 내부 선택이 DIRECT이거나 사용할 수 없는 이전 노드라는 사실을 놓칠 수 있습니다.

클라이언트의 연결 테스트나 지연 시간 테스트는 노드를 고르는 데 도움이 될 수 있지만, 테스트에 성공해도 해당 시점에 특정 테스트 대상에 연결할 수 있었다는 뜻일 뿐 모든 사이트와 앱에서 사용할 수 있다는 보장은 없습니다. 처음에는 노드 하나를 선택해 다음 단계를 확인하고, 페이지가 로드되는 동안 계속 노드를 바꾸지 마세요. 노드를 바꿔도 일부 앱은 기존 연결을 계속 사용할 수 있으므로 필요하면 테스트 페이지를 다시 열거나 해당 앱의 연결을 종료한 뒤 재시도하세요.

「전역」 모드라고 해서 기기의 모든 앱이 트래픽 처리 대상이 되는 것은 아닙니다. 이 모드는 코어로 들어온 요청의 처리 방식을 바꿉니다. 앱 요청이 Clash 클라이언트로 전달되는지는 시스템 프록시, TUN 또는 앱 자체의 프록시 설정에 달려 있습니다. 규칙 모드를 선택해도 시스템 프록시가 자동으로 켜지지 않습니다. 두 설정은 서로 다른 단계이므로 다음 단계에서 연결을 따로 설정해야 합니다.

프록시 페이지가 비어 있다면 첫 단계로 돌아가 설정이 적용되어 있는지 확인하세요. 노드는 보이지만 가이드에 나온 그룹 이름을 찾을 수 없다면 같은 이름의 그룹을 직접 만들지 말고 현재 설정의 실제 그룹을 사용하세요. 정책 그룹 유형, 규칙 순서, MATCH의 의미는 고급 설정에 해당합니다. 기본 연결을 완료한 뒤 고급 설정 가이드를 확인하세요. 이 단계에서는 규칙 모드가 선택되어 있고 관련 프록시 정책이 사용 가능한 연결 경로를 선택했는지만 확인하면 됩니다.

3단계: 연결을 켜고 트래픽 처리 방식 확인

데스크톱에서는 홈 화면이나 설정에서 「시스템 프록시」를 찾아 켜세요. 이 옵션은 일반적으로 운영체제에서 지원하는 프록시 설정을 클라이언트의 로컬 수신 주소로 지정합니다. 그러면 브라우저처럼 시스템 프록시를 따르는 앱의 요청이 코어로 전달됩니다. 켠 뒤에는 클라이언트를 계속 실행해 두세요. 창을 닫아도 트레이로 최소화되는 클라이언트가 있지만, 「종료」하면 로컬 프록시 서비스가 중단될 수 있습니다.

처음에는 로컬 포트를 변경하지 마세요. 온라인 예제에서 mixed-port: 7890을 자주 볼 수 있지만 실제 포트는 클라이언트마다 다를 수 있으므로 현재 설정을 기준으로 하세요. 로그에 address already in use가 표시되거나 수신 포트 바인딩에 실패하면 다른 Clash 클라이언트나 프로그램이 포트를 사용 중인지 확인하세요. 중복 실행 중인 프로그램을 종료한 뒤 다시 시도하세요. 브라우저에 임의의 새 포트를 입력하는 것으로 해결하려 하지 마세요.

Android와 iOS에서는 보통 「연결」 또는 시작 버튼을 눌러 네트워크 트래픽 처리를 시작합니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하거나 VPN 연결을 허용하라는 메시지가 표시될 수 있습니다. 방금 설치하고 직접 실행한 클라이언트에서 나온 요청인지 확인한 뒤 승인하세요. 여기서 VPN은 시스템이 제공하는 트래픽 처리 인터페이스를 뜻합니다. 상태 표시줄에 VPN 아이콘이 나타나도 구독 노드를 사용할 수 있다는 뜻은 아니므로 4단계에서 실제 접속을 확인해야 합니다.

시스템 프록시가 작동한 다음 TUN 설정

브라우저에서는 접속되지만 시스템 프록시를 따르지 않는 앱이 있다면 TUN 모드를 고려할 수 있습니다. TUN은 가상 네트워크 인터페이스와 라우팅을 통해 요청을 처리하며, 관리자 권한이나 서비스 모드, 네트워크 확장 프로그램, 시스템 VPN 승인이 필요할 수 있습니다. 필요한 조건은 플랫폼과 클라이언트에 따라 다릅니다. 현재 클라이언트의 안내에 따라 설치하거나 권한을 승인하세요. 서비스 시작에 실패하면 우선 해당 오류를 해결하고, 오류가 계속되는 동안 DNS 설정을 바꾸지 마세요.

처음 테스트할 때는 트래픽 처리 경로를 하나만 명확히 유지하세요. TUN으로 전환하려면 먼저 시스템 프록시를 끈 다음 TUN을 켜서 확인하면 됩니다. 클라이언트에서 두 기능을 함께 사용하도록 안내한다면 해당 안내를 따르세요. 다른 VPN, 가상 네트워크 어댑터, 보안 프로그램이 라우팅에 영향을 줄 수 있으므로 테스트 중에는 여러 트래픽 처리 도구를 동시에 실행하지 마세요. 회사 내부망에 연결된 기기라면 기존 네트워크 상태를 기록하고 업무에 지장이 없는지 확인하세요.

이 단계가 끝나면 데스크톱에서는 시스템 프록시가 켜져 있거나 TUN이 예상대로 시작되어 있어야 합니다. 모바일에서는 연결 상태가 표시되고 시스템 권한이 승인되어 있어야 합니다. 옵션을 켜자마자 다시 꺼진다면 「로그」에서 시작 단계의 오류를 확인하고 첫 번째 관련 메시지를 기록한 뒤 도움말 센터에서 해결 방법을 찾아보세요. 시작 버튼을 반복해서 눌러도 권한 문제나 포트 충돌은 해결되지 않습니다.

4단계: 접속과 규칙 적용 확인

브라우저를 열고 평소 직접 연결되는 사이트에 접속해 기본 네트워크가 정상인지 확인하세요. 그런 다음 규칙에서 프록시를 사용하도록 지정한 사이트 등 프록시로 연결되어야 하는 사이트에도 접속해 보세요. 클라이언트의 연결 아이콘만 확인해서는 안 됩니다. 페이지가 제대로 로드되는지, 요청이 코어로 전달되는지, 어떤 연결 경로가 선택되었는지를 함께 확인해야 설정이 적용되었는지 판단할 수 있습니다.

Clash 클라이언트의 「연결」 페이지를 열고 테스트 페이지를 새로고침한 다음 해당 도메인이나 앱의 요청을 찾으세요. 연결이 짧게 유지되는 경우에는 페이지가 로드된 뒤 기록이 사라질 수 있으므로 「로그」를 확인하고 다시 새로고침하세요. 요청에 적용된 규칙, 정책 그룹, 최종 노드 또는 DIRECT를 확인합니다. 규칙 모드에서 직접 연결과 프록시 요청이 함께 표시되는 것은 정상입니다. 모든 기록을 같은 노드로 표시하려고 전역 모드로 바꿀 필요는 없습니다.

페이지는 열렸지만 관련 기록이 전혀 없다면 새로고침으로 새 요청이 발생했는지 먼저 확인하세요. 브라우저 캐시, 다른 프록시 확장 프로그램, 앱 자체 프록시, 다른 VPN 때문에 확인 결과가 예상과 다를 수 있습니다. 브라우저 프록시 확장 프로그램을 잠시 끄고 테스트 페이지를 다시 열어 보세요. 같은 브라우저의 시크릿 창을 사용하면 캐시 영향을 줄일 수 있지만, 시크릿 창이 시스템 프록시를 우회하거나 연결 경로를 바꾸지는 않습니다.

증상에 따라 문제 범위 좁히기

새 요청 기록이 전혀 없다면 시스템 프록시나 모바일 연결 옵션이 실제로 켜져 있는지 확인한 뒤 테스트 앱이 해당 트래픽 처리 방식을 따르는지 살펴보세요. 로그에 connection refused가 표시되면 대상 주소를 함께 확인해 로컬 수신 서비스가 시작되지 않았는지, 원격 연결이 거부되었는지 구분하세요. 이 문구만 보고 구독이 만료됐다고 단정하지 마세요.

요청이 표시되고 프록시 노드도 선택되어 있는데 페이지가 계속 시간 초과된다면 같은 정책 그룹에서 사용할 수 있는 다른 노드를 선택해 다시 테스트하세요. 전역 모드에서는 접속되지만 규칙 모드에서는 실패한다면 클라이언트를 계속 재설치하기보다 해당 도메인에 적용된 규칙과 정책을 확인하세요. 비교 테스트가 끝나면 규칙 모드로 돌아가고, 문제가 발생한 도메인과 적용된 규칙을 기록해 두면 추가로 원인을 찾기 쉽습니다.

로그에 도메인 확인 실패나 DNS 조회 시간 초과가 계속 나타나면 먼저 기기 네트워크와 현재 설정이 정상인지 확인한 뒤 DNS 설정 안내를 살펴보세요. DNS 주소를 모두 바꾸고, TUN을 켜고, 규칙을 수정하고, 노드까지 변경하지 마세요. 접속이 복구되더라도 어느 설정이 원인이었는지 알기 어려워집니다. 관련 설정을 한 번에 하나씩 바꾸고 결과를 기록한 다음 효과가 없는 변경은 되돌리세요.

인증서 경고가 표시되면 브라우저 경고를 무시하지 마세요. 먼저 시스템 날짜와 시간을 확인하고, 패킷 캡처 도구의 인증서가 설치되어 있는지 또는 다른 네트워크 필터링 프로그램이 연결에 관여하는지 살펴보세요. 프록시에 연결할 수 있어도 인증서 오류를 무시해도 되는 것은 아닙니다. 절전 모드에서 복귀한 뒤 연결이 안 되거나 구독 업데이트에 실패하거나 앱이 계속 직접 연결되는 등 다른 문제는 도움말 센터의 문제 해결에서 확인할 수 있습니다.

사용 종료와 다음 실행

접속과 규칙 적용이 예상대로 작동하는 것을 확인하면 기본 설정이 완료된 것입니다. 정상 작동하는 설정을 유지하고 오버라이드 스크립트나 여러 구독을 급히 추가하지 마세요. 다음에 시작할 때는 설정이 계속 선택되어 있는지, 정책 그룹 선택이 바뀌지 않았는지 확인한 뒤 시스템 프록시나 모바일 연결을 켜세요. 시작 시 자동 실행은 클라이언트 실행 여부만 정합니다. 자동 연결이나 시스템 프록시 자동 설정은 별도 옵션일 수 있으므로 각각 확인해야 합니다.

사용을 마칠 때는 데스크톱에서 먼저 시스템 프록시를 끄고, 모바일에서는 연결을 해제하세요. TUN을 사용하는 기기는 TUN을 먼저 끈 다음 클라이언트를 종료합니다. 클라이언트가 갑자기 종료된 뒤 브라우저에 접속할 수 없다면 운영체제에 로컬 포트를 가리키는 수동 프록시 설정이 남아 있는지 확인하고 불필요한 설정을 끄세요. 규칙 세트, Fake-IP, 외부 제어 설정을 더 조정하려면 고급 설정 가이드를 확인하세요. 정상 작동을 확인한 기본 설정에서 여러 항목을 한꺼번에 시험하지 마세요.