오픈 소스 프로젝트 · 모든 플랫폼의 클라이언트 지속 업데이트

Clash 입문 가이드 다운로드 및 설정

Clash 다운로드 가이드 보기

사용할 기기와 방식에 맞춰 클라이언트 선택, 구독 가져오기, 시스템 프록시 설정을 한곳에서 안내합니다. 먼저 기본 연결을 구성한 뒤 필요에 따라 TUN, DNS와 규칙을 조정하세요.

영구 무료 오픈 소스 한국어 문서 규칙 기반 분기
CONFIGURATION WORKSPACE

설정 파일부터 시스템 트래픽 제어까지

Clash 클라이언트의 그래픽 인터페이스는 주로 설정 관리, 실행 모드 전환, 시스템 네트워크 진입점 제어를 담당합니다. 코어는 설정 파일에 따라 연결을 처리하고, 클라이언트는 자주 쓰는 작업을 화면의 설정으로 정리합니다. 아래에서 실제 설정 순서에 따라 헷갈리기 쉬운 항목을 나누어 살펴봅니다.

설정 파일 Profiles
현재 파일 config.yaml
자동 업데이트
설정 덮어쓰기
활성 설정으로 지정 사용 중

설정 파일 가져오기 및 업데이트

설정 파일에는 보통 프록시 제공자, 정책 그룹, 분기 규칙, 포트와 DNS 매개변수가 포함됩니다. 처음 사용할 때는 먼저 구독 링크의 출처를 확인한 뒤 클라이언트의 설정 또는 구독 화면에서 가져오세요. 가져오기에 성공했다고 해서 파일을 바로 사용할 수 있는 것은 아니며, 해당 파일을 활성 설정으로 지정해야 합니다. 구독을 업데이트하면 클라이언트가 원격 내용을 다시 가져옵니다. 로컬에서 직접 수정한 내용은 덮어써질 수 있으므로, 장기간 사용할 사용자 지정 규칙은 덮어쓰기나 병합 설정에 넣는 편이 좋습니다. 구독 업데이트에 실패하면 링크가 완전한지, 네트워크에 접속할 수 있는지, 시스템 시간이 정확한지, 원격 서비스가 유효한 YAML을 반환하는지 순서대로 확인하세요.

권장 설정 순서

먼저 설정 파일을 가져와 활성화하고, 정책 그룹에서 자주 사용할 출구를 선택한 다음 시스템 프록시를 켜 브라우저 접속을 확인하세요. 앱이 시스템 프록시를 따르지 않을 때만 TUN을 추가로 설정합니다. DNS 조정은 기본 연결이 안정된 뒤로 미루는 것이 좋습니다. 그래야 문제가 구독 내용, 프록시 진입점, 라우팅, DNS 해석 중 어디에서 발생했는지 구분하기 쉽습니다.

규칙 모드와 전역 모드

규칙 모드는 설정 파일의 규칙에 따라 직접 연결, 프록시 또는 차단을 결정하므로 일상적인 사용에 적합합니다. 전역 모드는 대부분의 연결을 현재 전역 정책으로 보내므로 규칙 누락 여부를 짧게 점검할 때 유용합니다. 직접 연결 모드는 프록시를 우회합니다. 모드를 바꾼다고 만료된 구독이 복구되거나 꺼진 시스템 프록시가 자동으로 켜지지는 않습니다. 판단할 때는 설정 상태와 진입점 상태를 나누어 확인하세요.

PLATFORM DOWNLOADS

운영체제에 맞는 클라이언트 선택

플랫폼마다 설치 형식, 시스템 권한, 프록시 진입점이 다릅니다. 다운로드 페이지에는 현재 사용할 수 있는 그래픽 클라이언트, 유지 관리가 중단된 보관 클라이언트, 서버용 코어 파일을 플랫폼별로 정리했습니다. 홈페이지는 플랫폼 안내만 제공하며 설치 파일을 직접 배포하지 않습니다.

Windows

시스템 프록시와 TUN을 지원하는 GUI 클라이언트입니다. 설치 전 아키텍처를 확인하고 UWP 앱이 프록시를 우회하면 루프백 설정을 점검하세요.

다운로드로 이동

macOS

Apple Silicon 또는 Intel 빌드를 선택하세요. 처음 실행할 때 보안 승인이 필요하며 명령줄 도구에는 환경 변수나 TUN이 필요할 수 있습니다.

다운로드로 이동

Android

Android VPN 인터페이스를 사용합니다. 구독을 가져온 뒤 VPN 연결과 필요한 백그라운드 활동을 허용해 절전 기능의 중단을 막으세요.

다운로드로 이동

iOS

iOS 네트워크 확장을 사용합니다. 처음 연결할 때 VPN을 허용하고 구독을 가져온 뒤 현재 용도에 맞는 정책 그룹을 확인하세요.

다운로드로 이동

Linux

데스크톱은 GUI, 서버와 라우터는 Mihomo 코어를 사용할 수 있습니다. 아키텍처와 패키지를 맞추고 TUN 또는 TProxy, DNS, 자동 시작을 설정하세요.

다운로드로 이동

그래픽 클라이언트와 코어의 차이

그래픽 클라이언트는 설정 가져오기, 정책 전환, 로그 확인, 시스템 스위치를 제공해 개인 기기에 적합합니다. 코어는 설정을 읽고 연결을 처리하므로 명령줄, 서비스 관리, 네트워크 라우팅에 익숙한 사용자에게 적합합니다. 둘은 같은 설치 형태가 아니며, 처음에는 그래픽 클라이언트로 시작하는 편이 문제를 찾기 쉽습니다.

모든 클라이언트 보기 →
OPEN SOURCE CONTEXT

오픈 소스 생태계와 설정의 경계

Clash는 특정 플랫폼의 단일 설치 파일이 아니라 코어, 그래픽 클라이언트, 규칙 프로젝트, 설정 도구가 함께 구성하는 생태계입니다. 이 경계를 이해하면 업데이트가 어디에서 왔는지 판단하기 쉽고, 클라이언트 화면 문제와 코어 설정 문제를 혼동하는 것도 피할 수 있습니다.

프로젝트 역사

초기 Clash 코어는 YAML 설정, 규칙 매칭, 정책 그룹 선택을 기반으로 한 사용 방식을 정립했고 이후 Windows, macOS, Android 등 플랫폼용 그래픽 클라이언트가 등장했습니다. 일부 초기 프로젝트는 이미 유지 관리가 중단되었지만 해당 설정 구조와 사용 습관은 여전히 널리 남아 있습니다. 현재 사용할 때는 이전 가이드의 클라이언트 이름만 보고 사용 가능 여부를 판단하지 말고, 프로젝트 유지 관리 상태, 대상 시스템 지원 여부, 사용 중인 코어 브랜치를 함께 확인해야 합니다.

코어와 클라이언트

Mihomo는 Clash Meta 관련 기능을 이어받아 확장하며 설정 해석, 수신 포트 생성, 규칙 처리, 정책 그룹 실행, DNS 로직을 담당합니다. 그래픽 클라이언트는 그 위에 조작 화면을 제공하며, 클라이언트마다 업데이트 방식, 설정 덮어쓰기 구조, 시스템 통합 방식이 다를 수 있습니다. 따라서 같은 구독도 클라이언트마다 진입점 이름이 다를 수 있지만, 문제 해결의 핵심 흐름은 같습니다. 설정이 유효한지, 코어가 실행 중인지, 시스템 트래픽이 수신 진입점으로 들어오는지, 규칙이 예상한 정책에 매칭되는지를 확인하세요.

규칙 및 구독 생태계

구독은 보통 서비스 제공자가 생성하고, 규칙 집합은 별도로 관리되는 오픈 소스 프로젝트에서 제공될 수 있습니다. 클라이언트는 이 내용을 읽고 실행할 뿐 원격 구독의 형식 오류를 수정하지 않습니다. 가져오기 전 링크의 출처와 용도를 확인하고, 개인 접속 정보가 포함된 구독 주소를 로그, 스크린샷, 코드 저장소에 공개하지 마세요. 사용자 지정 규칙을 장기간 관리해야 한다면 개인 덮어쓰기와 원격 구독을 분리해 저장하여 구독 업데이트 때마다 다시 수정하지 않도록 하세요.

업데이트 방식

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 독립적인 세 경로입니다. 클라이언트 업데이트는 화면과 플랫폼 통합을 바꾸고, 코어 업데이트는 설정 기능을 추가하거나 네트워크 처리 문제를 수정할 수 있으며, 구독 업데이트는 프록시 제공자, 정책 그룹, 규칙 내용을 바꿉니다. 업데이트 후 문제가 생기면 먼저 어느 계층에서 변화가 발생했는지 확인한 다음 해당 로그와 설정 차이를 살펴보세요. 안정적으로 사용하는 동안 모든 계층을 동시에 바꿀 필요는 없으며, 단계적으로 업데이트해야 되돌리거나 원인을 찾기 쉽습니다.

A

검토 가능한 설정

YAML 파일에는 수신 포트, DNS, 정책 그룹, 규칙 순서를 명확하게 작성할 수 있습니다. 수정하기 전에 작동하는 사본을 보관하고, 한 번에 한 종류의 매개변수만 조정하면 오류가 어느 설정에서 발생했는지 쉽게 판단할 수 있습니다.

B

로그로 원인 파악

연결 실패가 곧 노드 문제를 의미하지는 않습니다. 로그를 통해 설정 해석 실패, DNS 해석 오류, 규칙 매칭 결과, 포트 충돌, 시스템 진입점 미제어를 구분할 수 있습니다. 문제 해결은 구체적인 오류 메시지에서 시작하세요.

C

교체 가능한 구성 요소

구독, 규칙 집합, 코어, 그래픽 클라이언트는 서로 경계가 있습니다. 특정 그래픽 클라이언트의 유지 관리가 중단되면 호환 클라이언트로 옮길 수 있습니다. 이전하기 전 개인 덮어쓰기를 내보내고 플랫폼 권한과 시스템 프록시 설정을 다시 확인하세요.

TECHNICAL NOTES

최근 설정 및 문제 해결 노트

기술 노트는 첫 사용, DNS, 포트 충돌, 플랫폼별 문제를 중심으로 구성했습니다. 각 글에서 설정 위치, 명령의 용도, 판단 순서를 설명하므로 기본 가이드에서 다루지 않은 구체적인 증상을 확인할 때 유용합니다.

입문 가이드

Clash 초보자가 첫 주에 가장 많이 묻는 10가지: 구독 가져오기부터 시스템 프록시까지

클라이언트 선택, 구독 링크 가져오기, 규칙 모드와 전역 모드의 차이, 시스템 프록시가 작동하지 않는 이유, 정책 전환 후 확인할 위치를 한 번에 정리합니다. 각 질문을 클라이언트의 실제 설정 위치와 연결해 설명합니다.

전체 글 읽기 →
문제 해결

Clash DNS 누수 확인 방법: fake-ip·nameserver 누수 방지 설정 실전

브라우저 검사와 명령줄 조회부터 시작해 DNS가 클라이언트를 우회하는지 확인하고, enhanced-mode, nameserver, fallback의 관계를 단계별로 설명합니다. 설정을 바꿀 때는 한 번에 하나의 매개변수만 수정해 해석 경로와 프록시 경로가 동시에 변하지 않도록 합니다.

전체 글 읽기 →
문제 해결

Clash 포트 7890 사용 중일 때 해결 방법: 충돌 프로세스 확인부터 mixed-port 변경까지

Windows, macOS, Linux에서 수신 포트를 사용 중인 프로세스를 찾고, 남은 클라이언트인지 다른 네트워크 도구인지 판단하는 방법을 설명합니다. 클라이언트의 수신 포트와 시스템 프록시 설정을 함께 변경해 한쪽만 바꾼 뒤에도 연결되지 않는 문제를 피하세요.

전체 글 읽기 →

기본 연결부터 구성해야 한다면 입문 가이드에서 시작하세요. 명확한 오류 메시지가 보이면 오류 키워드로 관련 노트를 먼저 찾는 것이 좋습니다. 복잡한 플랫폼 설치, TUN 라우팅, 서비스 배포는 설치 가이드 모음에서 한곳에 다룹니다.

모든 글 보기 →