오픈 소스 클라이언트와 한국어 설정 자료

Clash 릴리스 허브 · 모든 플랫폼 클라이언트

Clash 다운로드 가이드 보기

Windows, macOS, Android, iOS 및 Linux용 클라이언트 다운로드 경로를 모아 구독 가져오기부터 규칙 문제 해결까지 한국어 문서로 안내합니다. 운영체제에 맞는 클라이언트를 선택한 뒤 가이드에 따라 시스템 프록시, 프록시 모드와 설정 업데이트를 완료하세요.

영구 무료 오픈 소스 멀티 플랫폼 한국어 문서
핵심 기능

구독, 규칙 분기, DNS 및 시스템 프록시

Clash 클라이언트의 주요 기능은 네 가지 영역으로 나뉩니다. 각 영역의 역할을 먼저 이해한 뒤 설정을 조정하면 규칙 미적용, 도메인 해석 오류, 시스템 트래픽 미연결 문제를 줄일 수 있습니다.

01 / PROFILE

구독 가져오기 및 설정 업데이트

구독 주소는 일반적으로 서비스 제공자가 생성하며, 클라이언트는 이를 가져와 선택 가능한 설정으로 저장합니다. 처음 가져올 때는 주소가 완전한지, 네트워크에서 접속 가능한지 확인하고 설정 목록에서 방금 가져온 항목을 명확히 선택해야 합니다. 그다음 시스템 프록시를 켜면 클라이언트가 내장 예시 설정이나 이전 설정을 계속 사용하는 일을 방지할 수 있습니다.

업데이트는 설정 내용을 다시 가져올 뿐, 작동하지 않는 링크를 자동으로 복구하지는 않습니다. 시간 초과, 빈 내용 또는 오류 페이지가 표시되면 먼저 구독 주소를 확인한 다음 현재 네트워크와 서버 상태를 점검하세요. 정상적으로 사용할 수 있는 설정을 하나 보관하고, 규칙을 수정하기 전에는 사본을 만들어 문법 오류가 발생했을 때 빠르게 복구할 수 있도록 하는 것이 좋습니다.

구독 가져오기 단계 보기 →
설정
현재 설정 원격 구독
✓
로컬 규칙 사본 config.yaml
편집
자동 업데이트 주기 필요에 따라 설정
플랫폼 안내

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

클라이언트마다 인터페이스, 코어 통합 방식과 시스템 권한 요구 사항이 완전히 같지는 않습니다. 먼저 해당 플랫폼으로 이동한 뒤 유지 관리 상태, 프로세서 아키텍처와 사용 환경을 기준으로 설치 파일을 선택하세요.

Windows

데스크톱에서 일상적으로 사용하기 좋습니다. 설치 전에 시스템 아키텍처를 확인하고, 처음 실행한 뒤 구독 가져오기, 규칙 모드 선택, 시스템 프록시 활성화 순서로 진행하세요. TUN을 사용하려면 필요한 시스템 권한을 허용해야 합니다.

다운로드 페이지로 이동

macOS

다운로드할 때 Apple Silicon과 Intel 프로세서를 구분하세요. 처음 실행할 때 앱 출처 확인을 요청할 수 있으며, 시스템 프록시나 TUN을 활성화할 때는 안내에 따라 네트워크 권한도 허용해야 합니다.

다운로드 페이지로 이동

Android

스마트폰과 태블릿에 적합합니다. 구독을 가져오면 시스템에서 VPN 연결 승인 메시지를 표시하며, 허용해야 클라이언트가 앱 트래픽을 처리할 수 있습니다. 배터리 절약 제한이 백그라운드 실행에 영향을 줄 수 있으므로 기기 설정에 맞게 조정하세요.

다운로드 페이지로 이동

iOS

App Store에서 해당 클라이언트를 받으세요. 처음 연결할 때 VPN 구성 추가를 요청하며, 승인하면 구독과 규칙 분기를 사용할 수 있습니다. 설정 내용과 시스템 프록시 권한은 iOS에서 통합 관리합니다.

다운로드 페이지로 이동

Linux

데스크톱 그래픽 클라이언트를 선택하거나 Mihomo 코어를 직접 실행할 수 있습니다. 서버와 라우터 환경에서는 설정 파일, 서비스 프로세스, 시작 권한과 방화벽 규칙을 직접 관리해야 합니다.

다운로드 페이지로 이동
전체 클라이언트 보기 →
빠른 시작

설치 후 먼저 세 가지 설정 완료

플랫폼마다 화면에 표시되는 이름은 조금 다를 수 있지만 초기 설정 순서는 대체로 같습니다. 순서대로 진행하면 다운로드, 설정과 연결 문제를 나누어 판단할 수 있습니다.

전체 가이드 보기 →
  1. 01

    구독 설정 가져오기

    설정 또는 구독 페이지를 열고 전체 주소를 붙여 넣은 뒤 업데이트를 실행하세요. 가져오기가 완료되면 설정 목록에서 방금 받은 항목을 선택합니다. 목록이 비어 있으면 먼저 브라우저에서 링크에 접속할 수 있는지 확인하고, 곧바로 프록시 모드나 DNS를 수정하지 마세요.

  2. 02

    규칙 모드 선택

    프록시 모드 설정으로 이동해 처음에는 규칙 모드를 선택하는 것이 좋습니다. 그런 다음 정책 그룹을 열고 설정에서 사용할 수 있는 정책을 선택하세요. 글로벌 모드는 더 많은 요청을 하나의 정책으로 보내므로 임시 테스트에는 쓸 수 있지만, 규칙 문제를 점검하는 첫 단계로는 적합하지 않습니다.

  3. 03

    프록시 활성화 및 확인

    데스크톱에서는 먼저 시스템 프록시를 활성화하고, 모바일에서는 VPN 승인을 확인한 다음 일반 웹페이지에 접속해 연결을 확인하세요. 브라우저는 작동하지만 다른 앱이 작동하지 않는다면 해당 앱이 시스템 프록시를 따르는지 점검하고, 필요하면 TUN 모드와 시스템 권한 안내를 확인하세요.

프로젝트 및 자료 출처

오픈 소스 생태계, Mihomo 코어와 유지 관리 범위

Clash는 코어, 그래픽 클라이언트, 규칙 프로젝트와 설정 도구로 구성된 오픈 소스 생태계를 이루고 있습니다. 각 요소의 관계를 이해하면 업데이트 출처와 문제의 책임 범위를 판단하는 데 도움이 됩니다.

프로젝트 역사와 클라이언트 생태계

Clash는 처음에 규칙 기반 프록시 코어와 설정 형식으로 널리 사용되었고, 이후 여러 운영체제용 그래픽 클라이언트가 등장했습니다. 일부 초기 클라이언트는 이미 유지 관리가 중단되었지만 이름은 오래된 가이드와 검색 결과에서 여전히 자주 보입니다. 현재 클라이언트를 선택할 때는 예전 이름만 기준으로 삼지 말고 유지 관리 상태, 코어 지원, 시스템 호환성과 설치 출처를 우선 확인하세요.

그래픽 클라이언트는 주로 구독 관리, 정책 전환, 시스템 프록시, 로그 확인과 코어 수명 주기 관리를 담당합니다. 실제로 규칙 매칭, DNS 처리와 연결 전달을 수행하는 부분은 대개 코어입니다. 화면이 비슷해 보여도 동일한 코어 기능이나 설정 호환 범위를 사용한다는 뜻은 아닙니다.

Mihomo와 Clash 설정의 관계

Mihomo는 Clash 설정 체계를 계승하고 확장했으며, 지속적으로 유지 관리되는 많은 클라이언트가 Mihomo를 통합합니다. 일반적인 proxies, proxy-groups, rules 및 dns 섹션은 여전히 설정의 핵심이지만, 코어와 클라이언트에 따라 확장 필드 지원 여부가 다를 수 있습니다. 설정 조각을 복사하기 전 해당 필드가 현재 코어에 적용되는지 확인하세요.

코어 자체는 일반적으로 완전한 데스크톱 인터페이스를 제공하지 않습니다. 일반 사용자는 코어가 통합된 그래픽 클라이언트를 선택하는 편이 좋고, 서버·소프트 라우터·자동화 환경에서는 코어를 직접 실행한 뒤 설정 파일, 명령줄 인자 또는 시스템 서비스로 실행 과정을 관리할 수 있습니다.

사이트 업데이트 및 콘텐츠 관리 방식

다운로드 페이지에서 플랫폼별 클라이언트 경로를 정리하고 지속 유지 관리 프로젝트와 보관 프로젝트를 구분합니다. 버전과 설치 파일 정보는 다운로드 페이지에서 관리하고, 홈에서는 플랫폼 안내만 제공해 오래된 글이나 검색 요약에서 만료된 파일을 바로 받는 일을 줄입니다. 가이드는 안정적인 작업 흐름을 기준으로 작성하며, 인터페이스 이름이 바뀌면 해당 단계만 업데이트합니다.

문제 해결 자료는 가능한 한 문제를 구독, 설정, 노드, 규칙, DNS와 시스템 연동 단계로 나누어 설명합니다. 클라이언트 인터페이스가 달라도 같은 방식으로 원인을 좁혀 갈 수 있습니다. 이 사이트는 프록시 구독이나 네트워크 서비스를 제공하지 않으며, 클라이언트 설치·설정 구조·로컬 문제 해결에 초점을 둡니다.

자주 묻는 질문

아래 질문은 다운로드나 처음 설정하기 전에 확인하기 좋습니다. 더 자세한 분류별 문답은 도움말 센터에 정리되어 있습니다.

Clash for Windows 유지 관리가 중단된 후에는 무엇을 선택해야 하나요?

다운로드 페이지에서 현재 시스템에 맞고 계속 유지 관리되는 클라이언트를 우선 선택하세요. 이전할 때는 구독을 다시 가져오는 것이 좋으며, 기존 클라이언트의 내부 설정 전체를 그대로 복사하는 것은 권장하지 않습니다. 이전 설정에 사용자 지정 규칙이 있다면 먼저 사본을 저장한 뒤 새 클라이언트로 항목별 이전하세요.

구독 가져오기는 성공했는데 왜 연결되지 않나요?

현재 설정이 선택되어 있는지, 정책 그룹에 선택된 항목이 있는지, 시스템 프록시 또는 모바일 VPN 권한이 활성화되어 있는지 차례로 확인하세요. 그런 다음 실행 로그를 확인해 구독 내용, 노드 연결, DNS 해석과 규칙 매칭 중 어디에서 문제가 발생했는지 구분합니다.

시스템 프록시와 TUN 모드를 반드시 동시에 켜야 하나요?

아니요. 시스템 프록시는 운영체제 프록시 설정을 따르는 소프트웨어에 사용하고, TUN은 더 다양한 네트워크 연결을 처리합니다. 처음 설치할 때는 시스템 프록시부터 테스트해 설정이 정상인지 확인한 후, 앱에 따라 TUN을 켤지 결정하세요.

사용자 지정 규칙을 수정했는데 왜 적용되지 않나요?

먼저 규칙 문법, 배치 순서와 현재 프록시 모드를 확인한 뒤 설정을 다시 불러오세요. 규칙은 순서대로 매칭되므로 앞의 범용 규칙이 요청을 먼저 처리할 수 있습니다. 로그의 매칭 기록을 통해 실제로 어떤 규칙이 실행되었는지 확인할 수 있습니다.

도움말 센터로 이동 →
설정 및 문제 해결 문서

최근 Clash 사용 가이드

구독 업데이트, HTTPS 인증서 오류와 DNS 매개변수 설정을 다루는 실용 문서입니다. 각 글은 하나의 구체적인 문제에 집중해 증상에 따라 해결 단계를 쉽게 찾을 수 있도록 구성했습니다.

입문 가이드

Clash 구독 업데이트 실패 해결법: 주요 원인 점검 및 자동 업데이트 주기 설정

구독 가져오기 시간 초과, 404 응답 또는 빈 내용은 업데이트 실패의 대표적인 세 가지 원인입니다. 네트워크, 링크, 서버 순서로 점검하는 방법과 자동 업데이트 주기 설정법을 설명합니다.

전체 내용 읽기
문제 해결

Clash를 켠 후 브라우저에 인증서 오류가 표시될 때: HTTPS 오류와 프록시의 관계

인증서가 유효하지 않거나 NET::ERR_CERT 오류가 발생하는 원인은 노드 경로, 시스템 시간 또는 로컬 패킷 캡처 프로그램일 수 있습니다. 원인별 차이와 확인 순서를 단계별로 설명합니다.

전체 내용 읽기
고급 설정

Clash DNS 설정 자세히 보기: nameserver, fallback 및 DNS 가로채기 매개변수 작성법

DNS 섹션은 도메인 해석 경로와 규칙 매칭에 영향을 줍니다. nameserver, fallback, fallback-filter와 가로채기 매개변수의 용도 및 조합 방법을 항목별로 설명합니다.

전체 내용 읽기
전체 문서 보기 →