Clash 클라이언트 · 한국어 설정 가이드

Clash 클라이언트 다운로드

Clash 다운로드 가이드 보기

플랫폼에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 규칙 기반 라우팅, 연결 확인 순서로 진행하세요.

오픈 소스 코어YAML 설정한국어 문서
플랫폼 선택

Clash 다운로드 플랫폼

클라이언트 전체 보기 →

먼저 운영체제를 확인한 다음 프로세서 아키텍처를 확인하세요. 다운로드 페이지에서 클라이언트 선택, 설치 방법, 시스템 요구 사항을 한눈에 볼 수 있습니다. 여기의 링크를 누르면 해당 플랫폼 페이지로 바로 이동합니다.

Windows

데스크톱 브라우저와 일반 앱 사용에 적합합니다. 시스템 정보에서 프로세서 종류를 확인하고, 설치 후 설정을 가져온 다음 시스템 프록시를 켜세요. 시스템 프록시를 따르지 않는 앱까지 연결해야 한다면 가이드에 따라 TUN을 설정하세요. 처음 연결하기 전에는 여러 네트워크 설정을 한꺼번에 바꾸지 마세요.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 시스템의 ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. 설치 후 안내에 따라 네트워크 기능을 허용하세요. 클라이언트를 바꾸기 전에는 기존 클라이언트의 시스템 프록시를 먼저 끄세요. 백그라운드 프로세스가 포트를 계속 점유하거나 네트워크 설정을 바꾸는 일을 방지할 수 있습니다.

다운로드 페이지로 이동

Android

스마트폰과 태블릿에서 사용할 수 있습니다. 기기 아키텍처에 맞는 설치 파일을 선택하고 구독을 가져온 뒤 VPN 연결을 허용하세요. 일반적으로 VPN 채널은 한 번에 하나의 앱만 사용할 수 있습니다. 연결이 시작되지 않으면 다른 VPN 앱이 실행 중인지 먼저 확인하세요. 백그라운드 연결이 자주 끊긴다면 배터리 최적화와 백그라운드 실행 권한을 확인하세요.

다운로드 페이지로 이동

iOS

iPhone과 iPad에서 사용할 수 있습니다. 다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있으며, 공식 사이트는 clashplus.io입니다. 설치 후 설정을 가져오고 VPN 권한을 허용한 다음 클라이언트에서 연결을 시작하세요. 사용 전에 구독 형식이 클라이언트에서 지원되는지 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 그래픽 클라이언트를 선택하고 배포판의 패키지 관리 방식에 따라 설치할 수 있습니다. 서버나 라우터에서는 다운로드 페이지에서 코어를 확인할 수 있지만, 설정과 서비스 권한, 라우팅은 직접 관리해야 합니다. 그래픽 인터페이스가 실행되었다고 해서 네트워크 연결이 자동으로 처리되는 것은 아닙니다. 프록시 진입 경로와 규칙 적용 여부도 확인하세요.

다운로드 페이지로 이동
설정 기능

Clash 주요 기능

라우팅 규칙부터 네트워크 연결 처리까지, 다섯 가지 설정은 각각 다른 문제를 해결합니다. 먼저 각 기능의 역할을 이해한 뒤 필요한 항목만 활성화하세요. 아래는 mihomo 설정 예시이며, 클라이언트의 메뉴 이름과 사용 가능한 옵션은 다를 수 있습니다. 예시 조각을 완성된 설정 파일처럼 가져오지 마세요.

규칙 기반 라우팅: 규칙을 확인한 뒤 정책 선택

규칙 모드에서는 설정에 적힌 순서대로 연결을 확인하고, 일치하는 규칙의 정책에 따라 처리합니다. 구체적인 도메인 규칙은 포괄적인 규칙보다 앞에 두고, 나머지 연결은 마지막의 MATCH로 처리하세요. 정책 그룹은 선택할 출구를 정하고, 규칙은 어떤 연결을 해당 그룹으로 보낼지 정합니다. 두 기능은 서로 대체할 수 없습니다. 모든 연결을 하나의 출구로 보내는 전역 모드와 달리 규칙 모드는 직접 연결을 유지하고 용도별로 프록시 트래픽을 나눌 수 있습니다. 설정을 바꾼 뒤에는 연결 기록에서 적용된 규칙을 확인하고 순서를 조정할지 판단하세요.

config.yaml · rules
mode: rule
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

규칙은 위에서 아래로 확인되며, MATCH는 마지막에 둡니다.

먼저 클라이언트 기본 옵션으로 안정적인 기준을 마련한 뒤 기능을 하나씩 추가하세요. 전체 매개변수와 정책 그룹 유형, 규칙 세트 관리 방법은 설정 심화 가이드에서 확인하세요. 익숙하지 않은 필드는 용어집에서 역할을 먼저 살펴보세요.

시작하기

구독 가져오기 및 연결 확인

전체 가이드 보기 →

처음 사용할 때는 가장 간단한 확인 절차부터 진행하세요. 설정이 로드되는지, 연결이 클라이언트에 표시되는지, 대상 요청이 예상대로 처리되는지 확인하면 됩니다. 아래 세 단계는 핵심 과정만 다루므로 모든 매개변수를 미리 알 필요는 없습니다. 클라이언트마다 버튼 위치는 다를 수 있지만 설정, 모드, 네트워크 진입 경로의 관계는 같습니다.

01 / 설정

구독 가져오기 및 활성화

설정 관리 페이지를 열고 구독 주소를 입력란에 붙여넣은 뒤 가져오기를 누르세요. 설정 항목이 나타나면 현재 설정으로 선택합니다. 로컬 파일을 사용하는 경우 파일 가져오기를 선택하고, 파일 내용이 클라이언트에서 지원하는 YAML인지 확인하세요. 웹페이지 내용이나 오류 메시지를 가져오면 안 됩니다.

이어서 파싱 오류가 있는지 확인하세요. 항목 이름이 표시되는 것만으로는 충분하지 않습니다. 코어가 해당 설정을 로드했는지도 확인해야 합니다. 가져오기에 실패하면 링크가 완전한지, 구독이 유효한지, 시스템 시간이 정확한지 먼저 점검하세요. 문제 원인을 혼동하지 않도록 DNS나 TUN은 당장 변경하지 마세요.

02 / 라우팅

모드와 네트워크 진입 경로 선택

일반적으로 규칙 모드로 시작한 뒤 프록시 페이지에서 설정의 정책 그룹과 출구를 선택합니다. 데스크톱에서는 먼저 시스템 프록시를 켜고, 모바일에서는 안내에 따라 VPN 권한을 허용하세요. TUN이 필요하다면 기본 연결이 확인된 뒤 활성화하고 클라이언트 안내에 따라 서비스를 설치하거나 권한을 부여하세요.

전역 모드는 규칙 문제와 연결 문제를 일시적으로 구분할 때 사용할 수 있습니다. 직접 연결 모드에서는 프록시 정책을 통해 요청을 전달하지 않습니다. 모드를 전환한다고 설정 점검을 대신할 수는 없습니다. 앱에서 프록시를 직접 설정했거나 다른 VPN이 실행 중이라면 요청이 어떤 네트워크 진입 경로로 들어가는지 먼저 확인하세요.

03 / 확인

요청을 보내고 연결 기록 확인

접속할 페이지를 연 다음 클라이언트로 돌아와 연결 기록을 확인하세요. 요청이 표시되는지, 적용된 규칙이 예상과 일치하는지, 선택한 정책과 출구가 올바른지 확인합니다. 직접 연결이 필요한 페이지나 로컬 네트워크 서비스도 점검하세요. 한 사이트만 확인하면 일반 네트워크 접근 문제를 놓칠 수 있습니다.

페이지가 열리지 않으면 먼저 연결 기록이 없는 경우와 기록은 있지만 연결에 실패한 경우를 구분하세요. 기록이 없다면 시스템 프록시, VPN 권한 또는 앱 설정을 확인하고, 기록이 있다면 출구, 구독, DNS 조회를 점검하세요. 여러 설정을 한꺼번에 바꾸기보다 오류 메시지를 저장하고 하나씩 다시 확인해야 원인을 찾기 쉽습니다.

오픈 소스 생태계

mihomo 코어와 클라이언트

프로젝트 소개 →

프로젝트 이력: 이름과 유지 관리 상태 구분

Clash 생태계에는 코어, 그래픽 클라이언트, 설정 도구, 컨트롤 패널이 포함됩니다. 이름이 비슷해도 같은 프로젝트라는 뜻은 아닙니다. 원래 Clash 프로젝트와 이후 커뮤니티 구현은 구분해서 살펴봐야 합니다. mihomo는 Clash Meta와 관련된 기술 흐름을 이어받은 오픈 소스 코어로, 현재 많은 클라이언트에서 사용됩니다. 오래된 가이드의 스크린샷이나 메뉴, 필드는 이미 유지 관리가 중단된 클라이언트에서 가져왔을 수 있으니 사용 중인 프로젝트의 문서를 기준으로 삼으세요.

다운로드 페이지에서는 보관된 클라이언트를 별도로 표시해 오래된 환경과의 호환성이 필요한 사용자가 알아볼 수 있도록 합니다. 클라이언트를 고를 때는 이름이 익숙한지보다 현재도 유지 관리되는지, 사용 중인 시스템에 맞는지를 우선 확인하세요. 홈페이지에는 구체적인 릴리스 번호를 표시하지 않고 클라이언트 릴리스 정보는 다운로드 페이지에 모아 두었습니다. 코어 릴리스와 그래픽 인터페이스 릴리스를 혼동하지 않도록 하기 위해서입니다.

코어와 클라이언트: 연결 처리와 설정 관리의 역할 구분

코어는 설정을 파싱하고 연결을 만들며 규칙을 매칭하고 DNS 및 네트워크 처리 로직을 실행합니다. 그래픽 클라이언트는 구독 관리, 모드 전환, 시스템 프록시, 로그 확인 등의 기능을 제공합니다. 따라서 같은 코어 기능이라도 클라이언트마다 스위치 이름이 다르거나 서비스 구성 요소가 대신 관리할 수 있습니다. 필드를 사용하기 전에는 코어가 이를 지원하는지, 클라이언트에서 직접 편집하거나 오버라이드할 수 있는지 모두 확인하세요.

클라이언트 업데이트와 코어 업데이트는 별개입니다. 인터페이스를 업데이트해도 네트워크 동작이 반드시 바뀌는 것은 아니며, 코어를 교체하면 설정 호환성이 달라질 수 있습니다. 문제를 확인할 때는 “업데이트했다”는 설명만 하기보다 클라이언트 이름, 시스템 환경, 활성화한 모드, 오류 메시지를 기록하세요. 문제를 재현해야 한다면 최소 설정을 사용하고 관련 없는 규칙과 오버라이드는 먼저 제거하세요.

오픈 소스 커뮤니티: 코드와 문서로 기능 확인

mihomo 공개 저장소에서는 소스 코드와 라이선스, 이슈 논의, 릴리스 정보를 확인할 수 있습니다. 라이선스는 GPL-3.0입니다. 오픈 소스 프로젝트는 구현 내용을 살펴볼 수 있고, 공개 기록을 통해 유지 관리 상태도 확인할 수 있습니다. 다운로드 페이지의 홍보 문구만으로 판단할 필요가 없습니다. 프로토콜 지원, 필드 동작, 알려진 문제는 코어 문서와 릴리스 정보를 참고하고, 클라이언트 인터페이스 기능은 해당 클라이언트의 문서를 확인하세요.

커뮤니티에 문제를 제보하기 전에 같은 증상이 보고된 적 있는지 검색하고 재현 절차를 정리하세요. 로그의 구독 주소, 접근 키, 출구 주소, 개인 접속 기록에는 민감한 정보가 포함될 수 있으므로 원문 전체를 공개하지 마세요. 정리한 오류 부분과 관련 설정 필드, 실제 관찰 결과를 공유하면 논의에 도움이 됩니다. 이 사이트는 한국어 안내와 사용 설명을 제공하며, 각 프로젝트의 유지 관리 책임과 라이선스는 해당 저장소를 기준으로 확인하세요.

업데이트 방식: 소프트웨어와 구독을 따로 관리

소프트웨어 업데이트는 클라이언트나 코어의 구현을 바꾸고, 구독 업데이트는 연결 정보와 정책, 규칙을 새로고침합니다. 두 업데이트는 따로 관리해야 합니다. 구독을 업데이트하기 전에 개인 수정 사항이 로컬 오버라이드로 저장되어 있는지 확인하세요. 소프트웨어를 업데이트하기 전에는 현재 설정과 필요한 옵션을 백업하고 네트워크 동작과 관련된 변경 사항을 읽어보세요. 원격 구독 원문에 개인 설정을 영구 보관하지 마세요. 다음 업데이트에서 수정 내용이 덮어써질 수 있습니다.

업그레이드 후 문제가 생기면 코어가 정상적으로 로드되었는지, 오버라이드가 계속 적용되는지, 시스템 프록시나 TUN이 다시 활성화되었는지 먼저 확인하세요. 네트워크가 정상이라면 특정 버전 번호를 따라가려고 설정을 자주 바꿀 필요는 없습니다. 새 기능이 필요하거나 알려진 문제를 해결해야 할 때 릴리스 정보를 확인한 뒤 업데이트를 진행하세요. 변경 전에는 복구 가능한 기준 설정을 남겨 두어야 소프트웨어, 설정, 현재 네트워크 환경 중 무엇이 원인인지 판단하기 쉽습니다.

최신 글

Clash 설정 및 문제 해결

모든 글 보기 →

기본 연결을 확인한 뒤 증상에 맞춰 자세히 점검하세요. 아래 글에서는 인증서 검증, 시작 로그, 연결 경로를 각각 살펴보고 문제가 어느 단계에서 발생하는지 설명한 다음 확인 순서를 안내합니다. 현재 설정은 유지한 채 한 번에 한 가지 조건만 바꿔가며 다시 확인하세요.