현상에 따라 계속 문제 해결
구독 업데이트, 포트 충돌, 시스템 프록시, 모바일 권한 및 연결 실패와 관련된 자주 발생하는 문제를 확인하세요.
자주 묻는 질문 열기클라이언트 화면의 실제 순서에 따라 구독 가져오기, 프록시 모드 선택, 연결 시작, 결과 확인의 네 단계를 완료하세요. 이 글은 처음 사용할 수 있게 만드는 데 필요한 작업만 다루며, YAML 필드와 DNS, 규칙 문법 같은 심화 내용은 설정 참고 자료에서 설명합니다.
시작하기 전에 서비스 제공자가 제공한 구독 주소 또는 바로 가져올 수 있는 YAML 설정 파일과, 설치가 완료된 Clash 그래픽 클라이언트를 준비해야 합니다. 구독 주소는 보통 https://로 시작하는 링크이며 YAML 파일은 대개 .yaml 또는 .yml 확장자를 사용합니다. 둘 중 하나만 있으면 되며, 웹 관리 페이지 로그인 주소나 요금제 페이지 주소, QR 코드 스크린샷을 구독 텍스트로 붙여 넣지 마세요.
클라이언트가 아직 설치되지 않았다면 먼저 클라이언트 다운로드 페이지에서 플랫폼을 선택하세요. Windows와 macOS는 설치 후 그래픽 인터페이스를 바로 열 수 있는 경우가 많습니다. Android와 iOS는 처음 연결할 때 시스템 VPN 권한 요청이 표시되므로 승인이 필요합니다. Linux 데스크톱은 앱 메뉴에서 실행해야 할 수 있고, 서버 환경은 코어와 명령줄 설정을 사용하는 편이 적합하므로 이 가벼운 가이드에서는 다루지 않습니다.
첫 설정을 진행할 때는 실행 중인 다른 프록시, VPN 또는 네트워크 필터링 도구를 잠시 종료하는 것이 좋습니다. 여러 프로그램이 시스템 프록시를 동시에 변경하거나 같은 포트를 사용하면 클라이언트에는 실행 중으로 표시되지만 브라우저가 현재 설정을 거치지 않는 문제가 생길 수 있습니다. 기존 프로그램을 종료한 뒤 Clash 클라이언트를 실행하면 포트 충돌과 라우팅 충돌을 줄일 수 있습니다. 회사나 학교 네트워크에서 고정 프록시를 요구한다면 기존 설정을 먼저 기록해 두어 나중에 복원할 수 있게 하세요.
시스템 시간이 정확한지도 확인해야 합니다. 구독 서비스와 일부 암호화 연결은 올바른 시간 정보에 의존하므로 날짜나 시간대가 크게 어긋나면 구독 업데이트 실패, 연결 핸드셰이크 실패 또는 인증서 오류가 발생할 수 있습니다. 확인이 끝나면 클라이언트 창을 열어 둔 상태로 다음 단계에서 설정을 가져오세요.
클라이언트를 연 뒤 설정, Profiles, 구독 또는 설정 파일 페이지로 이동하세요. 이곳에서 클라이언트가 불러올 설정을 관리합니다. 새로 설치한 상태에서는 목록이 비어 있거나 로컬 예시 설정이 포함되어 있을 수 있습니다. 예시 파일을 바로 수정하지 말고 새 구독 추가 기능으로 별도 항목을 만드는 것이 좋습니다. 그러면 나중에 구독을 새로 고칠 때 로컬 테스트 내용과 섞이지 않습니다.
설정 페이지에서 추가 버튼을 찾으세요. 일반적으로 오른쪽 위의 더하기 아이콘, URL에서 가져오기, 설정 다운로드, 원격 설정 만들기 또는 Import로 표시됩니다. URL 유형을 선택한 뒤 준비한 구독 주소 전체를 입력란에 붙여 넣으세요. 이름을 입력해야 한다면 주 사용 구독이나 모바일 기기처럼 용도를 쉽게 구분할 수 있는 이름을 사용하면 됩니다. 전체 링크를 이름에 넣을 필요는 없습니다. 업데이트 간격은 클라이언트 기본값으로 두어도 되며 처음부터 자동 업데이트 시간을 조정할 필요는 없습니다.
가져오기, 다운로드 또는 저장을 클릭하면 클라이언트가 구독 내용을 요청하고 YAML을 분석합니다. 페이지에 새 설정 항목이 나타날 때까지 기다리세요. 성공한 항목에는 보통 설정 이름, 업데이트 시간 또는 새로 고침 버튼이 표시되며 일부 클라이언트는 즉시 해당 설정으로 전환합니다. 항목이 나타났지만 현재 설정이 되지 않았다면 항목을 다시 클릭하거나 활성화, 선택, 활성 설정으로 지정 등의 작업을 수행하세요. 현재 설정이 활성화되어야 프록시 페이지에 이 구독이 정의한 정책 그룹과 노드가 표시됩니다.
이어서 프록시 페이지를 열어 내용을 확인하세요. 정상이라면 노드 선택, 자동 선택, 장애 조치, 해외 서비스 또는 직접 연결 서비스 같은 정책 그룹이 표시됩니다. 정책 그룹 이름은 설정 제공자가 정하므로 예시와 다를 수 있습니다. 프록시 페이지가 여전히 비어 있다면 설정 페이지로 돌아가 현재 활성 표시가 방금 가져온 항목에 있는지 확인한 뒤 새로 고침 또는 다시 불러오기를 실행하세요. 클라이언트 로그에 YAML 분석 오류가 표시된다면 콘텐츠는 다운로드했지만 설정 구조가 코어 검사를 통과하지 못한 것입니다. 이 경우 구독을 다시 가져오거나 자주 묻는 질문에서 설정 불러오기 실패 처리 순서를 확인하세요.
로컬 YAML 파일을 받았다면 URL 구독 메뉴가 아니라 파일에서 가져오기, Import File 또는 드래그 앤 드롭 가져오기를 선택하세요. 가져온 뒤에는 설정 목록에서 해당 항목을 선택해야 합니다. 로컬 파일에는 원격 구독처럼 자동 새로 고침 기능이 기본으로 포함되지 않으므로 서비스 내용이 바뀌면 파일을 다시 다운로드하거나 직접 교체해야 합니다. YAML 내부 필드는 이 글에서 다루지 않습니다. proxies, proxy-groups 및 rules의 관계를 알아보려면 설정 파일 참고 자료에서 항목별로 확인하세요.
설정을 불러온 뒤 프록시, Proxies 또는 모드 페이지로 이동하세요. 먼저 전체 모드 선택기를 찾습니다. 일반적으로 규칙, 전체 및 직접 연결 세 가지 옵션이 제공되며 영어로는 Rule, Global, Direct에 해당합니다. 첫 설정에서는 규칙 모드를 권장합니다. 이 모드에서는 각 연결이 설정 파일의 규칙을 위에서부터 차례로 적용해 프록시 정책, 직접 연결 또는 차단 중 하나를 결정하므로 일반 웹사이트와 로컬 네트워크가 모두 같은 경로를 사용할 필요가 없습니다.
전체 모드는 대부분의 트래픽을 하나의 정책이나 노드로 보내므로 특정 노드로 사이트에 접속할 수 있는지 임시로 확인할 때 유용하지만, 설정을 잘 모르는 상태에서 기본 모드로 사용하기에는 적합하지 않습니다. 직접 연결 모드는 프록시 정책을 우회하며 문제가 프록시 경로와 관련 있는지 빠르게 확인할 때 사용합니다. 세 모드는 트래픽 처리 방식만 바꾸며 구독을 삭제하거나 노드 자체를 수정하지 않습니다. 점검이 끝나면 언제든 규칙 모드로 돌아갈 수 있습니다.
규칙 모드를 정한 뒤 정책 그룹을 확인하세요. 각 정책 그룹은 규칙이 최종적으로 연결하는 선택 창이며, 내부에 실제 노드가 있거나 다른 자동 선택 그룹이 포함될 수 있습니다. 먼저 노드 선택, 프록시 선택 또는 Proxy와 가장 비슷한 이름의 주요 정책 그룹을 펼치세요. 자동 선택이나 지연 시간 선택 항목이 있다면 자동 정책을 먼저 선택하고, 구체적인 노드만 있다면 서비스 제공자가 사용 가능으로 표시한 노드를 하나 선택하세요.
일부 클라이언트는 노드 옆에 지연 시간 테스트 버튼을 제공합니다. 테스트 결과는 클라이언트와 테스트 대상 사이의 응답 상태만 보여 주며 모든 웹사이트의 실제 속도를 의미하지는 않습니다. 처음 연결할 때 최저 수치를 반복해서 찾을 필요는 없습니다. 결과가 반환되고 노드가 사용 불가 상태가 아니면 계속 진행하세요. 모든 노드가 시간 초과되면 먼저 구독을 새로 고친 뒤 로컬 네트워크에서 일반 웹페이지가 정상적으로 열리는지 확인하세요. 이때 DNS, 포트, 규칙을 동시에 바꾸지 마세요. 무엇이 변화를 일으켰는지 판단하기 어려워집니다.
설정에는 스트리밍, 메신저, 인공지능 서비스 또는 소프트웨어 다운로드용 독립 정책 그룹이 포함될 수도 있습니다. 처음에는 기본 선택을 유지하고 주요 프록시 그룹만 조정해도 됩니다. 이러한 하위 그룹은 주 프록시 그룹을 참조하는 경우가 많으므로 주 그룹을 정하면 관련 규칙도 참조 관계를 따라 사용 가능한 출구를 얻게 됩니다. 정책 그룹, 노드 및 규칙의 용어 차이는 용어 안내서에서 빠르게 확인할 수 있습니다.
일부 클라이언트는 모드를 기억하고, 일부 설정은 덮어쓰기 기능으로 실행 매개변수를 고정합니다. 규칙 모드를 선택한 뒤 다른 페이지로 이동했다가 돌아와 화면에 Rule 또는 규칙이 계속 표시되는지 확인하세요. 매번 다른 모드로 자동 변경된다면 설정 페이지의 덮어쓰기, 설정 병합 또는 시작 설정을 확인하세요. 의미를 알 수 없는 모드 덮어쓰기는 잠시 끈 뒤 규칙 모드를 다시 선택하세요. 주요 정책 그룹이 사용 가능한 노드를 가리키도록 유지한 다음 실제 시스템 연결을 시작합니다.
클라이언트 홈 화면, 개요 또는 General 페이지로 돌아가 코어 상태를 확인하세요. 일부 클라이언트는 실행할 때 코어를 자동으로 시작하지만, 다른 클라이언트는 시작, Start 또는 서비스 스위치를 직접 눌러야 합니다. 코어가 실행되면 페이지에 포트, 모드 또는 연결 정보가 표시되고 트레이 아이콘 상태가 바뀔 수도 있습니다. 시작을 누른 직후 중지된다면 먼저 로그 페이지에서 마지막 몇 줄을 확인하세요. 흔한 원인은 설정 분석 실패, 다른 프로그램이 포트를 사용 중인 경우 또는 시스템 서비스 권한이 완료되지 않은 경우입니다.
포트가 사용 중이면 시작 버튼을 반복해서 누르지 마세요. 먼저 다른 프록시 클라이언트를 종료하고 작업 관리자나 시스템 활동 모니터에서 기존 프로세스가 끝났는지 확인한 뒤 현재 클라이언트를 다시 시작하세요. 그래도 실패하면 설정에서 혼합 포트 또는 HTTP, SOCKS 포트를 확인하세요. 포트 필드와 그 관계는 설정 참고 자료의 내용이므로 일반 필드 설명을 참고하세요. 처음에는 여러 포트를 동시에 변경하지 않는 것이 좋습니다.
코어가 실행되면 시스템 프록시, System Proxy 또는 시스템 프록시로 설정 스위치를 켜세요. 이 작업은 시스템 프록시 설정을 따르는 브라우저와 데스크톱 앱을 Clash의 수신 포트로 연결합니다. Windows는 보통 클라이언트가 시스템 프록시 설정을 변경하고, macOS는 네트워크 설정 권한 확인을 요구할 수 있습니다. Android와 iOS는 VPN 연결 승인 창을 표시하며, Linux의 자동 적용 여부는 데스크톱 환경과 클라이언트 통합 방식에 따라 달라집니다.
시스템 권한 요청이 나타나면 방금 연 클라이언트에서 보낸 요청인지 확인한 뒤 승인하세요. 모바일 상태 표시줄의 VPN 아이콘은 시스템이 로컬 트래픽 가로채기 경로를 만들었다는 뜻일 뿐, 대상 웹사이트에 실제로 접속할 수 있다는 보장은 아닙니다. 최종 결과는 설정과 노드에 따라 달라지므로 다음 단계에서 확인해야 합니다. 데스크톱에서 시스템 프록시를 켠 직후 자동으로 꺼진다면 권한, 서비스 구성 요소 또는 시스템 네트워크 설정 저장 실패가 원인일 수 있습니다. 우선 클라이언트가 제공하는 정상적인 권한 승인 절차로 서비스를 다시 시작하세요.
시스템 프록시는 프록시 설정을 따르는 프로그램만 가로챌 수 있습니다. 일부 게임, 명령줄 프로그램, 스토어 앱 또는 자체 네트워크 스택을 구현한 소프트웨어는 이를 우회할 수 있습니다. 클라이언트의 TUN, 가상 네트워크 어댑터 또는 강화 모드는 더 넓은 시스템 트래픽을 가로채는 기능이지만 가상 네트워크 장치와 라우팅 권한이 필요합니다. 처음에는 시스템 프록시로 브라우저를 확인하고, 특정 앱이 시스템 프록시를 읽지 않는 것이 확실할 때 TUN을 고려하세요.
TUN을 켜기 전에 다른 VPN 도구를 종료하고 클라이언트 안내에 따라 서비스를 설치하거나 승인한 뒤 네트워크가 다시 연결될 때까지 기다리세요. 활성화 후 시스템 전체에서 인터넷이 되지 않으면 즉시 TUN을 끄고 일반 시스템 프록시가 작동하는지 확인하세요. 그런 다음 문제 해결에서 권한, 라우팅 충돌, DNS 순서로 점검하세요. 시스템 프록시와 TUN 스위치를 모두 반복해서 켰다 끄면 현재 트래픽 경로를 확인하기 어려워집니다.
Clash 그래픽 인터페이스의 창을 닫은 뒤에도 일부 플랫폼에서는 트레이에 남아 있고, 일부 플랫폼에서는 완전히 종료됩니다. 처음 테스트하는 동안에는 클라이언트 프로세스를 종료하지 마세요. 시스템 트레이, 메뉴 막대 또는 최근 작업에서 클라이언트가 계속 실행 중인지 확인하세요. 부팅 시 자동 연결을 원한다면 연결 확인이 끝난 뒤 시작 프로그램과 시스템 프록시 자동 활성화를 설정하세요. 완료되지 않은 설정이 매번 부팅 과정에 적용되는 일을 피할 수 있습니다.
브라우저를 열어 자주 사용하는 웹페이지를 새로 고친 뒤 클라이언트의 연결, Connections 또는 로그 페이지로 돌아가세요. 정상이라면 목록에 브라우저가 요청한 도메인, 대상 주소, 일치한 규칙 및 선택된 정책이 표시됩니다. 새 연결이 계속 들어오면 브라우저 트래픽이 Clash에 도달한 것입니다. 목록이 전혀 변하지 않는다면 시스템 프록시가 켜져 있는지, 브라우저가 별도 프록시 설정을 사용하는지, 현재 클라이언트가 백그라운드에서 실행 중인지 확인하세요.
연결 목록의 규칙 정보는 매우 유용합니다. 예를 들어 로컬 웹사이트에 DIRECT가 표시되면 규칙에 따라 직접 연결된다는 뜻입니다. 프록시가 필요한 사이트에는 주요 프록시 그룹이나 특정 노드가 표시되어야 합니다. 모든 요청이 같은 경로로 표시된다면 먼저 현재 모드가 전체 또는 직접 연결로 잘못 선택되지 않았는지 확인하세요. 웹페이지가 열리는지만으로 설정이 올바르다고 판단하지 마세요. 원래 직접 연결되는 사이트라면 프록시 경로가 작동하는지 증명할 수 없습니다.
이어서 신뢰할 수 있는 네트워크 출구 확인 페이지에 접속해 표시된 출구 지역이나 네트워크 정보를 기록하세요. 직접 연결 모드로 전환해 한 번 새로 고친 다음 규칙 모드로 돌아와 다시 새로 고치고 두 결과를 비교하세요. 규칙 모드에서 프록시가 필요한 확인 요청이 선택한 노드를 사용하고, 직접 연결 모드에서는 한국 국내 네트워크 출구로 돌아온다면 시스템 프록시, 코어, 정책 그룹이 완전한 연결 경로를 구성한 것입니다. 비교가 끝나면 규칙 모드로 복원하세요.
출구 결과가 바뀌지 않았지만 클라이언트 연결 목록에 요청이 표시된다면 해당 요청이 어떤 규칙과 일치했는지 확인하세요. 일부 확인 사이트는 규칙에 따라 직접 연결로 지정되어 있을 수 있으며, 이는 프록시가 작동하지 않는다는 뜻이 아닙니다. 프록시 정책으로 처리되어야 하는 다른 대상을 테스트하고 연결 상세 정보에서 정책 경로를 확인하세요. 특정 정책이 선택되는 이유와 규칙의 위에서 아래로 이어지는 적용 방식은 규칙 문법 참고 자료에서 다룹니다.
완전한 확인을 위해 두 종류의 요청을 모두 테스트하세요. 하나는 직접 연결이 예상되는 웹사이트이고 다른 하나는 프록시를 거쳐야 하는 웹사이트입니다. 직접 연결 사이트는 정상적으로 열리고 연결 기록에 DIRECT 또는 해당 직접 연결 그룹이 표시되어야 합니다. 프록시 사이트에는 프록시 정책 그룹과 실제 노드가 표시되어야 합니다. 두 결과가 모두 예상과 일치해야 규칙 모드가 연결되었을 뿐 아니라 트래픽 분배 방향도 올바르다고 판단할 수 있습니다.
구독 새로 고침도 한 번 테스트하세요. 설정 페이지로 돌아가 새로 고침을 클릭하고 업데이트 시간이 변경되었으며 현재 설정이 계속 선택되어 있는지 확인하세요. 새로 고침이 끝나면 프록시 페이지를 다시 열어 주요 정책 그룹의 선택이 유지되는지 확인합니다. 일부 구독은 업데이트 과정에서 정책 내용을 다시 만들기 때문에 기존에 선택한 노드가 삭제되면 클라이언트가 기본 항목으로 돌아갈 수 있습니다. 이 경우 사용 가능한 노드를 다시 선택하면 되며 클라이언트를 재설치할 필요는 없습니다.
확인이 끝나면 다음 네 가지 핵심 정보를 기억해 두세요. 활성 설정 이름, 실행 모드, 주요 정책 그룹 선택, 시스템 프록시 또는 TUN 상태입니다. 이후 접속할 수 없을 때 이 네 가지를 먼저 대조하면 설정 전환, 모드 변경, 노드 비활성화, 시스템 가로채기 해제 중 무엇이 문제인지 빠르게 찾을 수 있습니다. YAML을 수정해야 한다면 정상적으로 불러와지는 설정을 먼저 보관해 두어 문법 문제가 생겼을 때 되돌릴 수 있게 하세요.
아래에서는 이 가이드의 주요 흐름을 막는 흔한 문제만 다룹니다. DNS, Fake-IP, 규칙 덮어쓰기 또는 복잡한 시스템 라우팅이 관련된 경우 자주 묻는 질문과 설정 참고 자료를 확인하세요.
먼저 새 설정이 목록에 저장되기만 한 것이 아니라 현재 설정으로 지정되었는지 확인하세요. 그런 다음 새로 고침 또는 다시 불러오기를 실행하고 로그에 YAML 분석 오류가 표시되는지 확인합니다. 구독 다운로드 결과가 웹 로그인 페이지나 오류 안내라면 실제 구독 주소가 아닐 가능성이 있으므로 서비스 페이지로 돌아가 올바른 링크를 다시 복사하세요.
노드 테스트 성공은 테스트 요청이 노드에 도달했다는 뜻일 뿐입니다. 시스템 프록시가 켜져 있는지, 브라우저 요청이 연결 목록에 표시되는지, 요청이 어떤 정책과 일치했는지 계속 확인하세요. 연결 목록에 브라우저 요청이 없다면 시스템 가로채기 문제입니다. 요청은 들어왔지만 연결에 실패한다면 노드와 대상 웹사이트의 실제 접속 가능성을 다시 확인하세요.
먼저 실행 모드가 전체가 아니라 규칙인지 확인한 다음 국내 웹사이트 요청이 DIRECT와 일치하는지 확인하세요. 규칙 모드에서도 프록시 그룹으로 들어간다면 설정의 규칙 범위나 순서를 조정해야 합니다. 처음에는 정상적인 다른 설정으로 확인해 보고, 규칙을 직접 수정할 때는 설정 파일 매뉴얼을 참고하세요.
시스템 프록시 스위치가 실제로 켜진 상태를 유지하는지 확인하고, 브라우저에 별도 프록시나 직접 연결 예외가 설정되어 있지 않은지 확인하세요. 데스크톱에서는 다른 프록시 프로그램이 동시에 실행 중인지도 점검해야 합니다. 모바일에서는 상태 표시줄에 현재 VPN 연결이 계속 표시되는지, 절전 정책이 클라이언트를 종료하지 않았는지 확인하세요.
구독 업데이트, 포트 충돌, 시스템 프록시, 모바일 권한 및 연결 실패와 관련된 자주 발생하는 문제를 확인하세요.
자주 묻는 질문 열기일반 필드, DNS, 프록시 노드, 정책 그룹, 규칙 문법, 덮어쓰기 및 병합 방식을 확인하세요.
설정 참고 자료 열기