클라이언트 설치 · 구독 설정 · 한국어 문서

Clash 클라이언트다운로드 및 설정

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기, 시스템 프록시, 규칙 기반 라우팅을 설정한 다음 로그에서 연결 경로를 확인하세요.

  • 한국어 문서
  • 오픈 소스 코어
  • 멀티 플랫폼 설정
프록시 코어mihomo규칙 및 프로토콜 처리
오픈 소스 라이선스GPL-3.0mihomo 코어에 적용
설정 파일 형식YAML가져오기 전에 호환성 확인
설정 구조

구독, 규칙 및 연결 경로

클라이언트는 설정 화면을 제공하고, 코어는 연결을 처리하며, 구독에는 사용할 설정이 담깁니다. 이 세 가지를 먼저 구분한 뒤 프록시 모드를 조정하면 문제가 발생한 부분을 더 빠르게 찾을 수 있습니다. 아래 설정 예시는 각 항목의 관계를 이해하기 위한 것으로, 실제 기능 지원 여부는 선택한 클라이언트와 코어 문서를 확인하세요.

설정 기능

Clash 규칙 및 구독 관리

규칙 순서에 따라 연결 경로 결정

규칙 모드는 도메인과 대상 주소 등의 조건에 따라 연결 경로를 선택하며, 가장 먼저 일치하는 규칙이 적용됩니다. 모든 연결을 하나의 경로로 보내는 대신 로컬 서비스, 개발 도구와 기타 트래픽을 각각 나눠 처리할 수 있습니다. 규칙을 수정할 때는 구체적인 조건을 위에, 기본 규칙을 마지막에 두고 규칙에서 참조하는 프록시 그룹이 정의되어 있는지 확인하세요. 접속에 문제가 생기면 연결 기록에서 어떤 규칙이 적용됐는지 먼저 확인한 뒤 규칙을 수정할지 프록시 그룹을 조정할지 판단하세요. 노드만 바꿔서는 규칙 순서 오류를 해결할 수 없습니다.

# PROXY는 이미 정의된 프록시 그룹이어야 합니다
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
설치 파일

플랫폼별 Clash 클라이언트 선택

전체 클라이언트 보기

먼저 운영체제와 프로세서 아키텍처를 확인한 다음 클라이언트별 설정 관리 방식을 비교하세요. 데스크톱은 보통 시스템 프록시부터 시작하고, 모바일은 시스템 VPN 권한이 필요합니다. 서버나 라우터에서는 코어를 직접 사용할 수도 있습니다. 설치 파일 이름이 비슷해도 시스템 요구 사항이 같다는 뜻은 아니므로, 구형 기기라면 다운로드 페이지의 호환성 안내를 확인하세요. 클라이언트 자체는 프록시 서비스를 제공하지 않습니다. 설치 후에는 정당하게 제공받은 구독이나 설정 파일을 준비하고 선택한 코어와 호환되는지 확인해야 합니다.

Windows

데스크톱 브라우저와 개발 도구, 일반 앱에 적합합니다. 먼저 기기 아키텍처에 맞는 설치 파일을 선택하고 구독을 가져온 뒤 시스템 프록시를 켜세요. 더 많은 앱의 트래픽을 연결해야 한다면 TUN 서비스를 설정하면 됩니다. 스토어 앱 접속에 문제가 생기면 UWP 루프백 제한과 일반 네트워크 오류를 구분하세요. 바로 클라이언트를 다시 설치할 필요는 없습니다.

다운로드

macOS

설치 전에 시스템 정보에서 Apple Silicon인지 Intel 프로세서인지 확인하세요. 처음 실행할 때 시스템 안내에 따라 앱과 네트워크 권한을 설정한 뒤 현재 네트워크 서비스에서 프록시가 적용되는지 점검하세요. 무선 네트워크를 바꾸거나 다른 VPN을 켠 뒤에는 라우팅과 DNS를 다시 확인해 네트워크 변경 문제를 구독 문제로 오인하지 않도록 하세요.

다운로드

Android

휴대전화 아키텍처에 맞는 설치 파일을 선택하고, 처음 연결할 때 시스템 VPN 권한을 허용하세요. 백그라운드 실행은 시스템 배터리 정책의 영향을 받으므로 화면을 끈 뒤 연결이 끊기면 백그라운드 활동 권한과 배터리 절약 설정을 먼저 확인하세요. 다른 VPN 앱도 설치되어 있다면 어떤 앱이 현재 네트워크를 처리하는지 확인한 뒤 연결 상태를 판단하세요.

다운로드

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 제품 공식 사이트는 clashplus.io입니다. 설치 후 호환되는 설정을 가져오고 시스템 안내에 따라 VPN 구성을 추가하세요. 시스템에 VPN 상태가 표시되는 것은 네트워크 확장이 활성화되었다는 뜻일 뿐입니다. 예상한 연결 경로를 사용하는지는 규칙과 접속 기록을 함께 확인해야 합니다.

다운로드

Linux

데스크톱 사용자는 배포판의 패키지 관리 방식에 맞춰 GUI 클라이언트를 선택할 수 있습니다. 명령줄 도구는 프록시 환경 변수도 별도로 확인해야 합니다. 그래픽 데스크톱의 시스템 프록시 설정이 터미널이나 백그라운드 서비스에 전달되지 않을 수 있습니다. TUN을 사용하려면 서비스 권한, 라우팅 및 기존 네트워크 관리 도구를 확인하세요. 하나씩 활성화하면 문제를 찾기 쉽습니다.

다운로드

다운로드 페이지에서 플랫폼별 클라이언트와 시스템 요구 사항을 확인할 수 있습니다. 설치 방법, 서비스 권한 및 플랫폼별 차이는 플랫폼 가이드에서 확인하세요. 이미 사용할 수 있는 설정이 있다면 아래 연결 단계로 바로 넘어가도 됩니다.

빠른 시작

구독 가져오기부터 연결 확인까지

전체 가이드 보기

처음 설정할 때는 변수를 최대한 줄이세요. 프록시 클라이언트 하나만 실행하고 사용 가능 여부가 확인된 설정 하나로 시작한 뒤 DNS, 규칙과 가상 네트워크 어댑터를 동시에 바꾸지 마세요. 재현 가능한 연결을 한 번 확인한 후 자동 실행이나 개인 오버라이드를 단계적으로 추가하세요. 한 번에 설정 하나만 바꾸면 문제가 생겨도 마지막으로 정상 작동한 상태로 쉽게 되돌릴 수 있습니다.

  1. 구독을 가져와 선택

    설정 관리에서 원격 설정을 추가하고 서비스 제공자가 안내한 전체 주소를 붙여 넣은 뒤 내용이 모두 가져와질 때까지 기다리세요. 그런 다음 해당 설정을 선택하고 프록시 그룹과 규칙이 불러와졌는지 확인하세요. 가져오기 기록만 있고 설정을 활성화하지 않았다면 기본 화면의 스위치가 켜져 있어도 코어가 예상한 설정을 사용하지 않을 수 있습니다. 구독 업데이트에 실패하면 주소에 불필요한 공백이 있는지, 구독이 만료됐는지 확인한 다음 클라이언트 로그를 살펴보세요. 모든 설정을 반복해서 삭제하지 마세요.

    구독 가져오기 단계 보기 →

  2. 규칙 모드와 연결 방식 선택

    프록시 모드를 규칙으로 설정하고 수동 선택이 필요한 프록시 그룹에서 연결 경로를 고른 다음 시스템 프록시를 켜세요. 전역 모드는 잠깐 비교하거나 문제를 확인할 때 적합하며 모든 문제를 해결하는 스위치로 사용해서는 안 됩니다. 대상 앱이 시스템 프록시를 따르지 않는다는 점을 확인한 경우에만 TUN을 고려하세요. TUN을 켜도 유효한 규칙과 사용할 수 있는 연결 경로가 필요합니다. 가상 네트워크 어댑터는 트래픽이 코어로 들어오는 방식을 바꿀 뿐 구독의 연결 매개변수를 대신하지 않습니다.

    시스템 프록시 설정 보기 →

  3. 규칙 적용 결과와 실제 접속 확인

    프록시를 거쳐야 하는 웹사이트를 열고 클라이언트의 연결 기록에서 도메인, 적용된 규칙과 연결 경로를 확인하세요. 이어서 로컬 네트워크 서비스에도 접속해 직접 연결이 필요한 트래픽이 유지되는지 확인합니다. 지연 시간 테스트 성공은 테스트 요청이 완료됐다는 뜻일 뿐 실제 웹페이지, 다운로드 또는 앱에서의 동작을 보장하지 않습니다. 브라우저는 정상인데 특정 앱만 실패한다면 해당 앱의 프록시 연결 방식을 먼저 확인하세요. 모든 접속이 실패한다면 구독, DNS와 로컬 포트를 차례로 점검하세요.

    규칙 및 확인 방법 보기 →
오픈 소스 생태계

코어 출처와 업데이트 범위

Mihomo 프로젝트 보기

Clash, Meta, Mihomo의 관계

Clash 생태계는 규칙 기반 프록시 코어와 이를 기반으로 만든 클라이언트로 이루어져 있습니다. 기존 Clash 프로젝트의 유지보수가 중단된 뒤 커뮤니티에서 여러 호환 구현이 이어졌습니다. Mihomo는 Clash.Meta 프로젝트의 계보를 이어받아 호환되는 설정을 바탕으로 프로토콜, 규칙과 DNS 기능을 확장해 지원합니다. 검색 결과에 여러 이름이 함께 표시될 수 있으므로, 호환성은 제품 이름에 Clash가 포함됐는지만 보고 판단하지 말고 실제 클라이언트가 사용하는 코어를 확인하세요.

오픈 소스 프로젝트의 저장소에서 코드, 커밋 기록, 이슈와 라이선스를 확인할 수 있습니다. 특정 필드 지원 여부를 확인하거나 이미 논의된 문제를 찾아볼 때 유용합니다. 커뮤니티 프로젝트가 하나의 팀에서 관리되는 것은 아닙니다. 코어, GUI와 구독 서비스는 각각 다른 일정으로 업데이트됩니다. 이 사이트는 다운로드 경로와 사용 문서를 정리하며, 브랜드 이름이 모든 상위 프로젝트를 공동으로 유지보수한다는 뜻은 아닙니다. 구체적인 배포 출처와 라이선스 범위는 해당 프로젝트의 안내를 확인하세요.

클라이언트, 코어와 구독은 각각 업데이트

클라이언트 업데이트는 보통 인터페이스, 시스템 연동 또는 함께 제공되는 코어를 변경합니다. 구독 업데이트는 서비스 제공자의 설정을 다시 가져오는 것으로, 두 작업은 서로를 대신할 수 없습니다. 일부 클라이언트는 코어를 내장하고 다른 클라이언트는 별도 업데이트 기능을 제공하므로 실행 전에 각 프로젝트의 릴리스 노트를 확인하세요. 설정을 파싱할 수 없다면 문법이 호환되지 않는 문제인지 원격 콘텐츠 이상인지 먼저 확인한 다음 소프트웨어 업데이트, 설정 수정 또는 구독 제공자 문의 중 필요한 조치를 선택하세요. 여러 부분을 한꺼번에 변경하지 마세요.

업그레이드 전에 현재 사용할 수 있는 설정과 개인 오버라이드를 보관하고 프록시 모드, 연결 방식 등 주요 설정을 기록하세요. 업그레이드 후에는 설정이 불러와지는지 확인하고 일상적인 접속과 LAN 서비스를 점검하세요. 필요하면 로그에서 변경된 부분을 비교합니다. 오래된 클라이언트는 실행되더라도 새 프로토콜이나 시스템 호환성 수정 사항이 빠져 있을 수 있습니다. 유지보수가 중단된 앱은 과거 설정을 이해할 때 참고하고, 일상적으로는 계속 관리되고 현재 시스템과 호환되는 앱을 우선 선택하세요.

규칙은 재사용하되 접근 정보는 별도로 보호

오픈 소스는 라이선스에 따라 코드를 열람하고 사용할 수 있다는 뜻이지, 프록시 서비스를 무료로 이용할 수 있거나 구독 내용을 공개해도 된다는 뜻은 아닙니다. 구독 주소에는 계정 접근 권한이 포함되는 경우가 많고, 설정 파일에도 서버 인증 정보가 들어 있을 수 있습니다. 오류를 제보할 때는 오류가 난 필드, 규칙 순서와 실행 환경을 남기되 구독 주소와 인증 정보를 삭제하세요. 정리된 최소 재현 사례를 제공하면 전체 설정을 공개하는 것보다 논의하기 쉽고 문제도 더 빠르게 찾을 수 있습니다.

사용 팁

연결 확인 및 문제 해결

전체 글 보기

아래 글에서는 첫 연결, 노드 시간 초과와 지연 시간 테스트에 관한 흔한 문제를 다룹니다. 증상에 맞는 경로를 선택하세요. 프록시가 적용됐는지 아직 확인하지 않았다면 연결 확인부터 시작하고, 여러 요청에서 같은 설정으로 실패한다면 시간 초과 원인을 살펴보세요. 테스트 수치와 실제 사용감이 다르다면 왕복 시간, 처리량과 패킷 손실을 구분해야 합니다. 구독을 반복해서 다시 가져오기보다 문제가 발생했을 때의 로그를 보관하는 편이 도움이 됩니다.