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

시작 전 확인: 클라이언트, 구독 주소 및 시스템 시간

설정을 시작하기 전에 기기에 현재 유지 관리되고 있는 Clash 그래픽 클라이언트가 설치되어 있는지 확인하세요. 클라이언트마다 같거나 비슷한 설정 형식을 사용할 수 있지만 메뉴 구성은 통일되어 있지 않습니다. 이 가이드는 특정 클라이언트의 고정된 버튼 위치에 의존하지 않고 기능 이름을 기준으로 경로를 설명합니다. 화면에서 동일한 한국어 문구를 찾을 수 없다면 Profiles는 설정 목록, Proxies는 프록시 및 정책, Connections는 현재 연결, Logs는 실행 로그를 뜻한다는 점을 참고해 해당 영어 이름을 찾아보세요.

다음으로 유효한 구독 주소 또는 클라이언트가 읽을 수 있는 YAML 설정 파일을 준비해야 합니다. Clash 클라이언트 자체는 구독 내용을 생성하지 않습니다. 구독 주소는 일반적으로 사용 중인 네트워크 서비스 제공업체가 제공하므로 계정 페이지에서 전체 링크를 복사하고 매개변수를 직접 삭제하지 마세요. 로컬 YAML 파일을 받은 경우 가져오기에서 「파일에서 가져오기」를 선택하면 이후 과정은 구독 가져오기와 거의 같습니다.

기기의 날짜, 시간, 시간대가 올바른지 확인하세요. 시스템 시간 오차로 HTTPS 연결, 구독 업데이트 또는 원격 리소스 읽기가 실패할 수 있습니다. 데스크톱 기기에서는 자동 시간 설정을 활성화하는 것이 좋고, 모바일 기기는 일반적으로 시스템 기본 네트워크 시간을 유지하면 됩니다. 또한 시스템 프록시를 변경하거나 VPN을 설정하는 다른 도구는 잠시 종료하세요. 여러 프로그램이 같은 네트워크 경로를 동시에 제어하면 문제 원인을 판단하기 어려워집니다.

처음 설정할 때는 최소한의 연결 흐름만 완성하면 됩니다. 연결이 성공하기 전에 DNS, 포트, 규칙 세트, 스크립트와 오버라이드 설정을 동시에 변경하지 마세요. 고급 설정은 서로 의존하므로 한 번에 너무 많이 바꾸면 어떤 항목에서 문제가 발생했는지 확인하기 어렵습니다. 설정 필드, 정책 그룹, 규칙 및 DNS의 정의는 이 페이지의 절차를 완료한 뒤 용어집에서 확인할 수 있습니다. 플랫폼별 설치 권한, 시작 시 실행 및 시스템 차이는 모든 플랫폼 설치 및 설정 가이드에서 다룹니다.

구독을 가져오고 현재 설정으로 선택

Clash 클라이언트를 연 뒤 먼저 「설정」, 「구독」 또는 Profiles 페이지로 이동합니다. 데스크톱에서는 보통 창의 사이드바에 진입점이 있고, 모바일에서는 대개 홈 화면의 설정 영역에 있습니다. 「새로 만들기」, 「추가」, 「URL에서 가져오기」 또는 더하기 버튼을 찾아 전체 구독 주소를 입력란에 붙여 넣으세요. 이름은 알아보기 쉬운 짧은 문구로 입력하거나 클라이언트가 자동 생성한 이름을 그대로 사용해도 됩니다. 주소 앞뒤에 공백이나 줄바꿈이 없는지 확인한 다음 저장, 다운로드 또는 가져오기를 실행합니다.

가져오는 동안 원격 설정을 읽습니다. 성공하면 목록에 새 설정 항목이 나타나며, 보통 설정 이름, 업데이트 시간 또는 업데이트 버튼이 표시됩니다. 이때 바로 페이지를 나가지 말고 해당 설정을 클릭해 현재 사용할 설정으로 지정하세요. 일부 클라이언트는 체크 표시, 어두운 배경 또는 「활성화」 문구로 현재 항목을 나타냅니다. 다른 클라이언트는 가져온 뒤 자동으로 전환하지만 그래도 한 번 직접 확인하는 것이 좋습니다. 구독을 목록에 저장하는 것만으로는 실행 중인 코어에 설정이 로드되었다고 볼 수 없습니다.

설정을 선택한 뒤 수동 업데이트를 한 번 실행하세요. 이를 통해 구독 주소에 접근할 수 있고 설정 형식을 해석할 수 있는지 확인하는 동시에 최신 내용을 저장할 수 있습니다. 업데이트가 끝나면 「프록시」 또는 Proxies 페이지로 이동합니다. Proxy, Auto, Streaming, Final 또는 기타 사용자 지정 이름과 같은 정책 그룹이 보이면 설정이 로드된 것입니다. 정책 그룹 이름은 설정 제공업체가 정하므로 예시와 정확히 같을 필요는 없습니다.

가져온 직후 형식 오류가 표시되면 주소 문제와 파일 내용 문제를 먼저 구분하세요. 누락된 쿼리 매개변수가 없도록 서비스 페이지에서 구독 주소를 다시 복사하고, 웹페이지 주소나 계정 관리 주소 또는 구독 안내 문구를 구독 주소 자체로 착각하지 않았는지 확인합니다. 클라이언트에 YAML 구문 분석 실패가 표시된다면 반환된 내용이 호환되는 설정 파일이 아니거나 파일의 들여쓰기 및 필드 구조가 잘못되었을 가능성이 큽니다. 오류가 난 줄을 무작정 삭제해 강제로 로드하지 마세요. 삭제한 부분에 정책 그룹, 규칙 또는 DNS 의존성이 포함되어 있을 수 있습니다.

구독 주소는 계정 설정의 일부이므로 스크린샷, 로그 공유 또는 공개 문서에 게시하지 않는 것이 좋습니다. 다른 사람에게 오류를 보여줘야 한다면 오류 유형과 메뉴 위치만 남기고 전체 URL은 가리세요. 설정이 선택되어 있고 정책 그룹이 표시되는 것을 확인한 뒤 프록시 모드 설정으로 이동합니다. 이 시점에는 실행 가능한 설정이 클라이언트에 있지만 네트워크 트래픽이 반드시 해당 설정을 통과하는 것은 아닙니다.

규칙 모드를 선택하고 정책 그룹 확인

「프록시」, 「모드」 또는 Proxies 페이지로 이동해 규칙, 글로벌, 직접 연결이라는 세 가지 일반적인 모드를 찾습니다. 처음에는 「규칙」 모드를 선택하는 것이 좋습니다. 규칙 모드는 설정 파일의 규칙을 위에서부터 대조하며 도메인, IP, 프로세스 또는 규칙 집합에 따라 연결을 직접 연결할지, 차단할지, 지정된 정책 그룹으로 전달할지 결정합니다. 일상적인 사용에 적합하며 대부분의 구독 설정도 이 방식으로 기본 설계되어 있습니다.

「글로벌」 모드는 제어할 수 있는 대부분의 연결을 현재 글로벌 정책으로 일괄 전달합니다. 규칙 분할 때문에 접근 문제가 발생했는지 짧게 확인할 때는 유용하지만 모든 상황의 기본값으로 사용하기에는 적합하지 않습니다. 글로벌 모드를 활성화하면 원래 직접 연결해야 하는 로컬 서비스나 로컬 네트워크 주소의 경로도 바뀔 수 있습니다. 「직접 연결」 모드는 프록시를 우회하며 사용을 일시 중지하거나 비교 테스트를 할 때 주로 사용합니다. 직접 연결은 클라이언트를 종료한다는 뜻이 아니므로 시스템 프록시가 계속 켜져 있을 수 있습니다. 문제 확인이 끝난 뒤에는 연결 스위치도 확인하세요.

규칙 모드를 선택한 뒤 페이지의 주요 정책 그룹을 확인합니다. 「선택」, 「select」 또는 수동 선택 속성이 있는 정책 그룹은 사용할 수 있는 항목을 지정해야 합니다. url-test, fallback 또는 load-balance 속성이 있는 정책 그룹은 일반적으로 설정 로직이 자동으로 처리합니다. 클라이언트에 표시되는 정책 그룹은 별도의 구독 목록이 아니라 설정 파일이 연결 경로를 구성하기 위해 사용하는 논리 계층입니다. 상위 정책 그룹을 변경하면 해당 그룹을 참조하는 하위 규칙도 새 선택을 사용합니다.

처음에는 가장 상위의 기본 정책 그룹만 조정하면 되며, 스트리밍, 메신저, 다운로드 또는 지역별 분류 그룹을 하나씩 변경할 필요는 없습니다. 먼저 설정 제공업체가 권장하는 기본 항목을 선택하고 프록시 페이지로 돌아가 선택이 유지되었는지 확인하세요. 정책 그룹이 비어 있거나 펼칠 수 없거나 모든 항목이 사용할 수 없음으로 표시되면 시스템 프록시를 켜지 말고 이전 단계로 돌아가 구독을 다시 업데이트하세요. 빈 정책 그룹은 설정 내용이 완전히 로드되지 않았거나 구독 변환 결과가 클라이언트 코어와 호환되지 않는다는 뜻일 수 있습니다.

모드와 정책 그룹을 설정하면 Clash는 수신한 연결을 처리하는 방법을 알게 됩니다. 하지만 운영체제는 아직 앱 트래픽을 클라이언트로 전달하지 않습니다. 다음 단계에서는 「시스템 프록시」와 「TUN」 중 하나의 제어 방식을 선택해야 합니다. 두 방식은 적용 범위가 다르므로 플랫폼 동작을 이해하지 못한 상태에서 동시에 반복해 켜고 끄는 것은 권장하지 않습니다.

시스템 프록시 활성화, 필요할 때 TUN 사용

Windows, macOS 및 데스크톱 환경의 Linux 클라이언트에서는 처음 연결할 때 「시스템 프록시」부터 사용하는 것이 좋습니다. 클라이언트 설정 페이지 또는 홈 화면의 스위치에서 System Proxy, 시스템 프록시 설정 또는 시스템 프록시 항목을 찾아 켜세요. 클라이언트가 운영체제의 HTTP 및 HTTPS 프록시를 로컬 수신 포트로 지정합니다. 브라우저와 시스템 프록시 설정을 따르는 데스크톱 앱은 이후 요청을 Clash로 전달합니다.

활성화한 뒤 포트 충돌을 처리하는 경우가 아니라면 운영체제의 프록시 주소를 직접 수정하지 마세요. 클라이언트는 보통 로컬 주소와 mixed-port에 해당하는 포트를 자동으로 입력하고 스위치를 끄면 시스템 설정을 복원합니다. 포트를 클라이언트의 수신 값과 다른 숫자로 직접 바꾸면 시스템 프록시는 켜진 것처럼 보여도 앱이 로컬 서비스에 연결되지 않습니다. 포트 설정의 자세한 관계는 고급 문제 해결 항목이므로 설치 가이드의 공통 설정 섹션에서 계속 확인할 수 있습니다.

Android와 iOS 그래픽 클라이언트는 일반적으로 시스템 VPN 인터페이스를 통해 로컬 터널을 만듭니다. 연결 버튼을 누르면 시스템에 VPN 설정 또는 연결 권한 요청이 표시됩니다. 권한을 승인하면 상태 표시줄에 VPN 아이콘이 나타날 수 있고 클라이언트의 연결 버튼 상태도 바뀝니다. 이 권한은 클라이언트가 로컬 네트워크 인터페이스를 만들도록 허용한다는 뜻일 뿐, 구독과 정책이 올바르다는 의미는 아닙니다. 따라서 다음 단계의 확인도 반드시 진행해야 합니다.

TUN 모드는 시스템 프록시 설정을 따르지 않는 앱과 일부 UDP, 명령줄 및 시스템 수준 연결을 제어할 때 사용합니다. 데스크톱에서 브라우저와 일반 앱만 필요하다면 먼저 시스템 프록시로 확인을 완료하세요. 명령줄 도구, 게임 런처 또는 특정 앱이 시스템 프록시를 읽지 않을 때 다른 중복 제어 항목을 끄거나 클라이언트 안내에 따라 TUN을 활성화합니다. Windows에서 TUN을 켜려면 관리자 권한이 필요할 수 있고, macOS에서는 네트워크 확장 또는 보조 서비스 설치를 요청할 수 있습니다. Linux에서는 권한, 라우팅 및 방화벽 규칙의 영향을 받습니다.

연결을 활성화한 뒤 클라이언트에 명확한 오류가 표시되는지 확인합니다. 정상이라면 실행 상태가 계속 켜져 있고 로그에 동일한 포트 사용 중, 권한 거부 또는 설정 로드 실패 메시지가 연속해서 반복되지 않습니다. 시스템 프록시 스위치가 자동으로 꺼진다면 클라이언트에 시스템 설정을 기록할 권한이 없는 것이 흔한 원인입니다. TUN이 시작 직후 중지된다면 관리자 권한, 네트워크 확장 권한 및 다른 VPN의 존재 여부를 확인하세요. 스위치를 빠르게 연속해서 누르지 마세요. 이전 프로세스가 포트를 해제하기 전에 새 인스턴스가 시작될 수 있습니다.

이제 설정, 모드, 정책과 시스템 제어가 하나의 연결 흐름을 이룹니다. 다음 단계에서는 웹페이지가 열리는지만 확인하지 말고 클라이언트 연결 기록을 통해 요청이 실제로 현재 설정을 거쳤는지 확인하세요. 브라우저 캐시나 원래 직접 연결할 수 있던 페이지를 설정 성공으로 잘못 판단하지 않도록 주의해야 합니다.

대상 페이지와 연결 기록으로 작동 여부 확인

클라이언트를 실행한 상태로 새 브라우저 창을 열고 현재 프록시 경로를 통해야 정상적으로 로드되는 대상 페이지에 접속합니다. 캐시의 영향을 줄이기 위해 구조가 단순하고 이전에 열어 보지 않은 페이지를 우선 선택하세요. 페이지가 로드되는 것은 첫 번째 확인 결과일 뿐입니다. Clash 클라이언트의 Connections, 연결 또는 로그 페이지로 돌아가 방금 방문한 도메인에 새로운 연결 기록이 생성되었는지 확인해야 합니다.

연결 기록에는 일반적으로 대상 도메인, 일치한 규칙 및 최종 사용 정책 그룹이 표시됩니다. 요청이 실제로 클라이언트에 들어왔고 규칙 모드가 예상한 정책으로 전달했는지만 확인하면 되며, 특정 표시 형식일 필요는 없습니다. 기록에 DIRECT가 표시되면 해당 요청이 설정에 따라 직접 연결로 판단된 것입니다. 설정에서 예상한 결과라면 정상입니다. 대상이 원래 프록시를 사용해야 하는데 DIRECT로 판단되었다면 같은 구독을 반복해서 가져오기보다 규칙 일치를 확인하세요.

일상적으로 직접 연결할 수 있는 웹사이트에도 접속해 기본 네트워크가 실수로 차단되지 않았는지 확인합니다. 규칙 모드의 목적은 요청마다 설정에 따라 다르게 처리하는 것이므로 프록시 경로와 직접 연결 경로를 모두 확인해야 합니다. 첫 번째 대상은 접속되지만 모든 로컬 서비스에 문제가 있다면 글로벌 모드가 여전히 켜져 있거나 TUN 라우팅에서 로컬 네트워크를 올바르게 제외하지 않았을 수 있습니다. 프록시 페이지에서 모드를 확인한 뒤 설정의 「로컬 네트워크 연결 허용」이 현재 요구 사항에 맞는지 점검하세요.

명령줄에서 확인할 때는 도구가 시스템 프록시를 읽는지 주의해야 합니다. 일부 명령은 기본적으로 데스크톱 시스템 프록시를 무시하므로 브라우저는 성공하고 명령줄은 실패할 수 있습니다. 이 경우 도구 설명서에 따라 프록시 환경 변수를 설정하거나 플랫폼 권한을 확인한 뒤 TUN을 사용하세요. 단일 명령의 결과만으로 전체 클라이언트가 작동하지 않는다고 판단하지 마세요. 앱 연결 방식, DNS 확인 경로 및 프록시 모드는 서로 다른 계층이므로 각각 확인해야 합니다.

마지막으로 한 번 껐다가 다시 켜는 테스트를 진행합니다. 먼저 시스템 프록시, VPN 또는 TUN을 끄고 일반 네트워크가 복구되는지 확인한 다음 다시 켜서 클라이언트가 안정적으로 연결 상태에 들어가는지 관찰하세요. 이 작업으로 시스템 프록시가 복원되지 않거나 권한이 일시적으로만 적용되거나 클라이언트 재시작 후 현재 설정이 로드되지 않는 문제를 발견할 수 있습니다. 다시 켠 뒤 구독을 재가져올 필요는 없으며 현재 설정이 계속 선택되어 있는지만 확인하면 됩니다.

연결 실패 시 역순으로 복구

연결을 켠 뒤 모든 페이지에 접속할 수 없다면 먼저 시스템 프록시, VPN 또는 TUN을 꺼서 기기를 원래 네트워크 상태로 되돌립니다. 직접 연결 네트워크 자체가 정상인지 확인한 뒤 Clash 설정으로 돌아가세요. 문제 해결 순서는 설정 순서의 반대로 진행해야 합니다. 먼저 연결 제어 스위치를 확인하고, 다음으로 프록시 모드와 정책 선택을 점검한 뒤, 마지막으로 구독을 다시 업데이트합니다. 이렇게 하면 문제가 운영체제의 제어 계층에 있는지 설정 내용 계층에 있는지 빠르게 판단할 수 있습니다.

첫 번째로 클라이언트가 계속 실행 중인지와 로컬 포트가 정상적으로 수신 대기 중인지 확인합니다. 포트 사용 중 오류가 발생하면 중복 실행된 클라이언트 인스턴스와 다른 프록시 도구를 먼저 종료한 뒤 현재 클라이언트를 다시 시작하세요. mixed-port, 시스템 프록시 포트 및 구독 설정을 동시에 변경하지 마세요. 여러 값이 서로 맞지 않을 수 있습니다. 재시작 후 포트 오류가 사라지면 시스템 프록시를 다시 켜서 확인합니다.

두 번째로 프록시 모드를 확인합니다. 글로벌 모드를 규칙 모드로 되돌리고 기본 정책 그룹을 구독 제공업체의 기본 항목으로 복원하세요. 그래도 실패한다면 잠시 직접 연결 모드로 전환할 수 있습니다. 직접 연결은 되지만 규칙 모드가 작동하지 않는다면 시스템 제어 자체는 정상이고 정책 선택 또는 규칙 대상에 문제가 있을 가능성이 큽니다. 직접 연결도 되지 않는다면 시스템 프록시 포트, TUN 권한 또는 다른 VPN과의 충돌을 우선 확인하세요.

세 번째로 구독 업데이트를 확인합니다. 프록시 제어를 끈 뒤 현재 설정을 다시 업데이트하고 HTTP 오류, 시간 초과 또는 YAML 구문 분석 메시지가 나타나지 않는지 확인하세요. 업데이트가 성공하면 해당 설정을 다시 선택하고 정책 페이지에서 그룹 내용이 복구되었는지 확인합니다. 구독을 계속 읽을 수 없다면 서비스 제공업체의 계정 페이지에서 주소 상태를 확인하세요. 실패 원인을 클라이언트 화면 탓으로 돌리지 않는 것이 좋습니다.

DNS 문제는 일반적으로 도메인에 접속할 수 없지만 일부 IP에 직접 연결하거나 기존 연결을 사용할 수 있는 형태로 나타납니다. 처음 설정할 때는 복잡한 DNS 설정 조각을 임의로 복사하지 않는 것이 좋습니다. 먼저 구독에 포함된 설정을 유지해 기본 연결을 확인하세요. fake-ip, nameserver, fallback 또는 DNS 유출을 처리해야 한다면 용어집의 네트워크 및 DNS 개념과 체계적인 설정 문서를 참고하세요. 심층적으로 확인할 때는 한 번에 하나의 필드만 변경하고 복구할 수 있는 원본 설정을 보관해야 합니다.