Windows
시스템의 ‘정보’ 페이지에서 운영체제 종류를 확인하세요. 처음 사용하는 경우 시스템 프록시부터 테스트한 뒤 TUN을 켜는 것이 좋습니다. 지원이 종료된 Clash for Windows를 계속 사용 중이라면 기존 설정을 보존하고 현재 유지 관리 중인 대체 클라이언트와 비교해 보세요.
다운로드 페이지로 이동운영체제에 맞는 클라이언트를 선택하고 구독 가져오기부터 시작하세요. 규칙 기반 라우팅과 연결 로그로 트래픽 경로를 확인할 수 있습니다.
CONFIG WORKBENCH
먼저 바꾸려는 항목이 설정 출처인지, 트래픽 경로인지, 원격 리소스 갱신 주기인지 확인하세요. 각각 별도의 설정 위치가 있습니다. 오른쪽 예시는 기존 설정에 병합해야 하는 일부 항목이며, 그대로 연결해 사용할 수 있는 완성된 구독이 아닙니다.
먼저 제공업체가 안내한 구독 종류를 확인하세요. 완전한 Clash 구독은 보통 클라이언트의 설정 페이지에서 가져오며, 노드뿐 아니라 프록시 그룹과 규칙도 함께 정의할 수 있습니다. 프록시 목록은 노드만 제공하고, 기본 설정에서 proxy-providers로 불러옵니다. 전체 설정을 프록시 목록처럼 사용하면 주소에 접속할 수 있어도 프록시 그룹에 노드가 표시되지 않을 수 있습니다. 형식을 확인해야 한다면 제공업체의 안내를 우선 참고하고, 접속 정보가 포함된 주소를 온라인 판별 도구에 입력하지 마세요.
프록시 그룹의 use 목록에 프록시 목록 이름을 입력하세요. 목록을 단일 노드처럼 proxies에 지정하면 안 됩니다. 예시의 ‘수동 선택’ 그룹은 직접 연결과 지연 시간 테스트 그룹을 선택지로 두고 원격 목록도 참조합니다. ‘자동 지연 시간 테스트’ 그룹은 같은 목록에서 노드를 가져옵니다. 가져온 뒤 그룹에 예상한 선택지가 표시되는지 확인하고 연결을 테스트하세요. 그룹 이름을 바꾸면 참조하는 곳도 함께 바꿔야 합니다. 이름과 공백, 대소문자가 정의와 일치해야 합니다.
목록에 구독 이름이 보인다는 것은 클라이언트에 설정 항목이 추가됐다는 뜻일 뿐, 해당 설정이 코어에 적용됐다는 뜻은 아닙니다. 새 항목으로 전환한 뒤 프록시 페이지의 그룹 이름이 바뀌었는지 확인하세요. 전환되지 않는다면 로그에서 구문 오류나 지원하지 않는 항목이 있는지 살펴보세요. 기존 설정으로 비교할 수 있으므로 이 단계에서 클라이언트를 먼저 재설치할 필요는 없습니다. 개인 정보가 담긴 기록을 공유할 때는 스크린샷에서 링크의 쿼리 매개변수와 계정 정보, 불필요한 연결 정보를 가리세요.
proxy-groups:
- name: 수동 선택
type: select
proxies: [DIRECT, 자동 지연 시간 테스트]
use: [remote]
- name: 자동 지연 시간 테스트
type: url-test
use: [remote]
url: https://example.com/
interval: 300
규칙 모드는 목록을 위에서 아래로 확인하며, 일반적으로 조건에 처음 일치한 규칙의 정책을 적용합니다. 특정 도메인에 예외를 적용하려면 더 넓은 범위의 규칙보다 앞에 배치하세요. 그렇지 않으면 예외에 도달하기 전에 요청이 먼저 일치합니다. 예시는 도메인 접미사로 프록시 그룹을 지정하고, 사설 주소는 직접 연결로 처리한 다음, 일치하지 않은 요청을 MATCH로 보냅니다. 기본 규칙을 앞에 두면 그 아래 규칙은 적용되지 않습니다.
DOMAIN-SUFFIX는 도메인 접미사와 일치하며, GEOIP는 대상 주소를 기준으로 분류 데이터를 조회합니다. 후자는 사이트의 문구나 언어, 등록 국가를 기준으로 분류하지 않습니다. 문제를 확인할 때는 연결 기록의 대상이 도메인인지 주소인지 먼저 확인한 뒤 일치한 규칙을 살펴보세요. IP 주소만 테스트해서는 도메인 접미사 규칙이 작동하는지 확인할 수 없습니다. no-resolve를 사용하면 도메인만 있는 요청에 대해 이 주소 규칙이 추가로 주소를 조회하지 않도록 할 수 있습니다.
브라우저는 기존 연결을 재사용하는 경우가 많아 규칙을 저장한 뒤 새로고침만 해서는 변경된 정책이 적용됐는지 알기 어렵습니다. 새 연결을 만들어 대상, 일치한 규칙, 실제 아웃바운드 세 항목을 기록하세요. 올바른 규칙과 일치했지만 예상과 다른 노드를 사용한다면 중복 규칙을 추가하기보다 해당 프록시 그룹의 선택 항목을 확인하세요. 구독에서 관리하는 규칙은 클라이언트가 지원하는 오버라이드 위치에 추가하는 것이 좋습니다.
rules:
- DOMAIN-SUFFIX,example.com,수동 선택
- GEOIP,private,DIRECT,no-resolve
- MATCH,수동 선택
원격 목록의 interval은 리소스를 가져오는 주기를, health-check 아래의 같은 이름 필드는 노드 상태를 확인하는 주기를 설정합니다. 단위는 모두 초입니다. 예시에서는 목록을 하루에 한 번 가져오고 5분마다 상태를 확인합니다. 상태 확인 주기를 짧게 해도 새 노드가 더 일찍 표시되지는 않습니다. 노드 변경 사항을 반영하려면 목록을 새로고침하거나 제공업체가 안내한 주기에 맞춰 가져오기 간격을 조정하세요. 예시 주소는 항목 설명용입니다.
클라이언트 설정 페이지의 예약 업데이트는 보통 전체 설정을 다시 다운로드합니다. 코어의 provider 주기는 특정 노드 목록을 가져옵니다. 전자는 프록시 그룹과 규칙을 바꿀 수 있지만, 후자는 기본 설정을 다시 다운로드하지 않습니다. 구독의 규칙을 수정했는데 변경 사항이 보이지 않는다면 먼저 어느 계층에서 변경했는지 확인한 다음 올바른 새로고침 메뉴를 선택하세요. 시스템이 절전 모드이거나 모바일 기기가 백그라운드에서 중지된 동안에는 업데이트가 늦어질 수도 있습니다.
요청이 실패하면 마지막으로 성공한 시각과 현재 오류부터 기록하세요. 도메인 조회에 실패했다면 네트워크와 DNS를 확인하고, 서버에서 접근을 거부했다면 구독 유효 기간과 권한 상태를 확인해야 합니다. 요청은 성공했지만 설정을 읽지 못한다면 응답이 설정 파일인지, 로그인 페이지나 오류 메시지인지 확인하세요. 사용 중인 기존 설정은 보존하고 새 항목만 따로 테스트하는 편이 모든 항목을 지운 뒤 다시 시도하는 것보다 되돌리기 쉽습니다.
proxy-providers:
remote:
type: http
url: https://example.com/provider.yaml
path: ./providers/remote.yaml
interval: 86400
health-check:
enable: true
url: https://example.com/
interval: 300
운영체제와 프로세서 아키텍처를 먼저 확인한 뒤 설정 오버라이드, 연결 로그, 시스템 트래픽 처리 방식을 비교하세요. 다운로드 페이지에서 플랫폼별 클라이언트를 확인할 수 있습니다. 다른 프런트엔드로 바꾸더라도 구독 출처는 유지되지만, 기존 클라이언트의 로컬 설정까지 함께 옮겨진다고 가정하지 마세요.
시스템의 ‘정보’ 페이지에서 운영체제 종류를 확인하세요. 처음 사용하는 경우 시스템 프록시부터 테스트한 뒤 TUN을 켜는 것이 좋습니다. 지원이 종료된 Clash for Windows를 계속 사용 중이라면 기존 설정을 보존하고 현재 유지 관리 중인 대체 클라이언트와 비교해 보세요.
다운로드 페이지로 이동기기에 맞는 아키텍처의 설치 파일을 선택하고, 처음 연결할 때 시스템 VPN 권한 요청을 확인하세요. 화면을 잠근 뒤에만 연결이 끊긴다면 백그라운드 실행 및 배터리 설정을 먼저 확인하세요. 특정 앱만 프록시를 사용하지 않는다면 앱별 설정을 살펴보세요.
다운로드 페이지로 이동다운로드 페이지에서 앱 스토어로 이동한 뒤 기기가 스토어에 안내된 시스템 요구 사항을 충족하는지 확인하세요. 가져온 다음에는 클라이언트에서 설정을 선택했는지, 시스템에서 VPN 연결을 허용했는지 각각 확인하세요. 두 상태가 모두 정상이라면 알려진 대상에 연결해 트래픽 경로를 테스트하세요.
다운로드 페이지로 이동‘이 Mac에 관하여’에서 Apple 칩인지 Intel 프로세서인지 확인한 뒤 맞는 설치 파일을 선택하세요. 시스템 프록시 설정은 활성 네트워크 서비스에 따라 달라질 수 있습니다. 무선 네트워크나 도킹 스테이션의 유선 포트로 바꾼 뒤에는 클라이언트가 트래픽을 처리하고 있는지 다시 확인하세요.
다운로드 페이지로 이동데스크톱 사용자는 배포판과 패키지 형식에 맞는 GUI 클라이언트를 선택하세요. 서버 사용자는 다운로드 페이지에서 독립 실행형 코어를 확인할 수 있습니다. 데스크톱 프록시 설정과 명령줄 프로그램이 사용하는 환경은 다를 수 있으므로 실제 사용할 앱으로 연결을 테스트하세요.
다운로드 페이지로 이동설정 하나와 앱 하나로 연결부터 확인한 뒤 자동 시작, 자동 지연 시간 테스트, TUN을 차례로 추가하세요. 문제가 생기면 마지막으로 정상 작동을 확인한 상태로 돌아갈 수 있습니다.
설정 페이지에서 원격 항목을 추가하고 제공업체가 안내한 Clash 구독 주소를 붙여 넣은 뒤 저장하세요. 다운로드한 뒤 해당 항목을 활성화해야 합니다. 프록시 페이지에 설정에 정의된 그룹 이름과 후보 노드가 표시되면 다음 단계로 넘어가세요. 구독이 로컬 파일로 제공됐다면 파일 가져오기 메뉴를 선택하세요.
규칙 모드를 선택하고 테스트할 프록시 그룹에서 노드를 하나 직접 선택하세요. 먼저 자동 전환을 꺼두면 결과를 확인하기 쉽습니다. 데스크톱에서는 시스템 프록시를 켜고, 모바일에서는 클라이언트 안내에 따라 VPN을 연결하세요. 기기에서 다른 프록시나 VPN을 사용 중이라면 어떤 앱이 현재 트래픽을 처리하는지 먼저 확인하세요.
프록시를 사용해야 하는 것으로 알려진 대상과 직접 연결해야 하는 대상을 각각 열어 보세요. 로그에서 일치한 규칙과 실제 아웃바운드를 확인하세요. 연결 기록 자체가 없다면 노드 지연 시간 탓으로 돌리기 전에 시스템 트래픽 처리 방식부터 확인하세요.
초기 Clash는 YAML 하나에 프록시, 프록시 그룹, 규칙을 함께 구성해 노드 관리와 트래픽 판단을 분리할 수 있게 했습니다. 이후 다양한 GUI 프런트엔드와 파생 코어가 등장해 이 구조를 이어갔지만, 유지 관리 현황과 지원하는 설정 항목은 서로 다릅니다. 특히 Clash for Windows는 지원이 종료됐으므로 예전 문서의 메뉴 위치와 설치 안내를 현재 클라이언트에 그대로 적용하지 마세요. 다른 클라이언트로 옮길 때는 최소 설정으로 핵심 기능부터 확인하고 연결이 되면 사용자 설정을 복원하는 것이 좋습니다.
오픈 소스 저장소의 소스 코드, 릴리스 기록, 이슈 논의에서 구체적인 동작을 확인할 수 있습니다. 창이 열리지 않거나 트레이가 작동하지 않거나 시작 시 자동 실행에 문제가 있다면 사용 중인 GUI 프런트엔드를 먼저 살펴보세요. 같은 최소 설정에서 여러 프런트엔드가 동일한 규칙 오류를 내면 공통으로 사용하는 코어를 확인하세요. 커뮤니티 보고서를 참고할 때는 플랫폼, 시스템 환경, 재현 절차를 함께 비교해야 합니다. 제목이 같아도 원인은 다를 수 있으며, 특히 ‘인터넷에 연결할 수 없음’은 설정 적용, DNS 조회, 노드 연결 등 여러 문제와 관련될 수 있습니다.
mihomo는 Clash Meta에서 파생됐으며 GPL-3.0 라이선스를 사용합니다. GUI 클라이언트는 주로 설정 관리, 상태 표시, 시스템 통합을 담당합니다. 실제 프로토콜 연결과 규칙 매칭, 일부 DNS 동작은 코어가 처리합니다. 같은 코어를 사용하는 클라이언트라도 기본 설정, 시스템 프록시 설정, 오버라이드 방식이 다르면 동작이 달라질 수 있습니다. 반대로 클라이언트에서 설정 항목을 인식하더라도 코어가 해당 항목에서 참조하는 모든 값을 지원한다는 뜻은 아닙니다. 호환성 문제가 생기면 먼저 인터페이스에서 가져오지 못한 것인지, 코어가 불러오지 못한 것인지 구분하세요.
앱 업데이트는 인터페이스와 시스템 권한을 바꿀 수 있고, 코어 업데이트는 설정 지원 범위와 실행 동작에 영향을 줄 수 있습니다. 구독 새로고침은 주로 원격 설정 내용을 갱신합니다. 세 가지 업데이트는 별도로 확인하세요. 변경 전에 적용 중인 정책과 필요한 오버라이드를 기록하고, 변경한 뒤에는 같은 테스트 대상으로 로그를 비교하세요. 클라이언트와 구독을 한 번에 바꾸면 문제가 발생했을 때 프로그램 변경과 설정 변경 중 무엇이 원인인지 파악하기 어렵습니다. 되돌릴 수 있도록 로컬 설정 사본을 보관하고, 접속 정보가 포함된 파일은 안전한 비공개 위치에 저장하세요.
상황에 맞는 글을 선택하세요. 첫 연결은 트래픽 경로부터 확인하고, 설정을 수정할 때는 항목별 설명을 참고하세요. 연결은 되지만 속도가 불안정하다면 원인을 단계별로 비교해 보세요.
속도 저하 원인을 노드, 회선, 로컬 환경 세 단계로 나눠 점검합니다. 노드 부하와 프로토콜, 저녁 시간대 혼잡, DNS와 TUN 설정, 규칙 오분류를 차례로 확인해 원인을 좁혀 보세요.
완성된 설정 파일을 순서대로 살펴보며 mixed-port, dns, proxies, proxy-groups, rule-providers, rules의 역할과 자주 쓰는 작성법을 설명합니다.
구독을 가져온 뒤 처음 연결하는 과정을 안내합니다. 프록시 그룹에서 노드를 선택하고 지연 시간을 일괄 테스트한 다음 시스템 프록시를 켜세요. IP 조회와 연결 로그로 트래픽이 실제로 프록시를 통과하는지 확인할 수 있습니다.