• Clash 생태계 · 한국어 사용 가이드

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

기기에 맞는 클라이언트를 선택하고 구독 가져오기부터 규칙 설정까지 진행한 뒤 연결 설정을 하나씩 확인하세요.

오픈소스 코어YAML 설정한국어 단계별 안내

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

먼저 운영체제와 프로세서 아키텍처를 확인한 다음 GUI 클라이언트를 선택하세요. 다운로드 페이지에서 설치 경로, 지원 플랫폼, 유지 관리 상태를 한눈에 확인할 수 있습니다. 처음부터 명령줄 코어를 사용할 필요는 없습니다.

Windows

데스크톱 브라우저, 개발 도구, 일상적인 업무에 적합합니다. 먼저 Clash Plus를 살펴보고 Clash Verge Rev, FlClash 등의 인터페이스와 설정 방식을 비교해 보세요. Clash for Windows 대체 프로그램을 찾는다면 기존 설정을 먼저 내보내고 사용자 지정 규칙과 포트를 기록해 두세요. 기존 폴더를 바로 덮어쓰지 않는 것이 좋습니다.

다운로드하기

macOS

먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple Silicon용과 Intel용 설치 파일을 구분하세요. 처음 실행할 때 네트워크 확장 프로그램이나 보조 서비스에 시스템 권한을 허용해야 할 수 있습니다. 일반적인 브라우저 연결에는 시스템 프록시를 먼저 사용하고, 다른 앱의 트래픽까지 처리해야 한다면 클라이언트 안내에 따라 TUN과 필요한 권한을 설정하세요.

다운로드하기

Android

모바일에서는 보통 시스템 VPN 인터페이스를 통해 트래픽을 처리합니다. 설치 후 설정을 가져오고 VPN 권한 요청을 승인하세요. 다른 VPN에 연결되어 있다면 먼저 인터페이스 충돌 여부를 확인해야 합니다. 화면을 잠근 뒤 연결이 끊긴다면 구독을 반복해서 가져오기보다 배터리 최적화, 백그라운드 실행 권한, 자동 시작 설정을 확인하세요.

다운로드하기

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하거나 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 처음 연결할 때 VPN 구성을 추가하도록 허용해야 합니다. 가져오기에 성공한 뒤에도 사용할 수 있는 프록시 그룹을 선택해야 합니다. 구독 내용, 노드 프로토콜, 클라이언트 지원 범위에 따라 설정의 정상 작동 여부가 달라집니다.

다운로드하기

Linux

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 사용하세요. 서버나 라우터 사용자는 Mihomo 코어 다운로드를 확인할 수 있습니다. 명령줄로 배포하려면 설정 경로, 서비스 권한, 프로세스 관리도 별도로 준비해야 합니다. 설치가 끝났다고 해서 트래픽이 이미 프록시를 통과하는 것은 아닙니다.

다운로드하기
전체 클라이언트 보기 →

규칙, 프록시 그룹 및 네트워크 설정

아래 예시는 mihomo 설정 문법을 기준으로 설정 항목 간 관계를 보여줍니다. 각 예시는 일부 설정만 담은 조각이며, 바로 연결할 수 있는 완전한 설정이 아닙니다. GUI 클라이언트에서 지원하는 필드와 덮어쓰기 방식은 각각 확인해야 합니다.

구체적인 조건부터 매칭하고 나머지 트래픽을 처리하세요

규칙 모드는 목록 순서대로 연결을 확인하고, 일치하는 규칙을 찾으면 해당 정책을 적용한 뒤 다음 규칙으로 넘어가지 않습니다. 도메인 접미사 규칙은 사이트와 하위 도메인을 함께 처리할 때 유용하고, 키워드 규칙은 매칭 범위를 주의해야 합니다. 먼저 구체적인 서비스 규칙을 배치하고, 다음에 주소 조건을 둔 뒤 마지막에 MATCH로 나머지를 처리하세요. 전역 모드와 달리 규칙 모드에서는 직접 연결과 프록시를 함께 사용할 수 있습니다. 예시의 PROXY는 설정에 실제로 존재하는 프록시 그룹 또는 프록시 이름이어야 합니다. 규칙만 추가하고 사용할 출구가 없다면 연결은 실패합니다.

rules:
  - DOMAIN-SUFFIX,google.com,PROXY
  - DOMAIN-KEYWORD,github,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

왼쪽에서 설정 항목을 선택한 뒤 오른쪽의 설정 조각을 확인하세요. 직접 전환하면 자동 재생이 중지됩니다. 전체 정의는 용어집에서, 증상별 해결 방법은 문제 해결에서 확인하세요.

구독 가져오기와 연결 확인, 3단계

먼저 최소한으로 연결을 구성한 뒤 규칙과 고급 기능을 추가하세요. 각 단계에서 확인 결과를 기록해 두면 문제가 생겼을 때 설치부터 다시 하지 않고 해당 단계로 돌아갈 수 있습니다.

  1. 설정을 가져와 선택하기

    클라이언트의 ‘구독’ 또는 ‘설정’ 화면에서 URL 가져오기를 선택하고 전체 링크를 붙여 넣은 뒤 저장하세요. 다운로드와 파싱이 끝나면 방금 가져온 설정을 선택하고, 구독 항목만 추가된 것이 아니라 프록시 그룹이나 규칙이 표시되는지 확인하세요. 로그인 페이지나 오류 메시지가 반환된다면 다른 클라이언트로 바꿔도 원본 링크 문제는 해결되지 않습니다.

    로컬 파일을 가져올 때는 확장자와 텍스트 인코딩을 확인해 웹페이지를 YAML 파일로 잘못 저장하지 않도록 하세요. 처음 적용하기 전에 설정 이름을 기록하세요. 구독이 여러 개라면 현재 선택된 항목을 확인하고, 이후 업데이트도 같은 항목에 적용해야 합니다.

  2. 규칙 모드와 출구 선택

    프록시 모드를 ‘규칙’으로 설정하고 설정에 있는 주요 프록시 그룹을 열어 사용 가능한 출구를 선택하세요. 데스크톱에서는 시스템 프록시를 활성화하고 모바일에서는 VPN 권한을 승인하세요. 전역 모드는 임시 비교에 사용할 수 있지만 작동하지 않는 노드를 복구하지는 않습니다. 직접 연결 모드라고 해서 클라이언트 프로세스가 종료되는 것도 아닙니다.

    처음 연결할 때는 여러 프록시 프로그램을 동시에 켜지 마세요. 브라우저에 프록시 전환 확장 프로그램이 있다면 시스템 설정을 덮어쓰지 않는지 먼저 확인하세요. TUN, LAN 공유, 사용자 지정 DNS는 기본 연결이 정상 작동한 뒤 설정해 권한과 라우팅 변수를 줄이세요.

  3. 연결 기록으로 결과 확인

    대상 웹사이트를 연 뒤 ‘연결’ 또는 ‘로그’ 화면에서 해당 도메인을 찾아 매칭 규칙, 프록시 그룹, 실제 출구를 확인하세요. 기록은 보이지만 접속이 실패한다면 출구와 DNS를 확인하세요. 기록이 전혀 없다면 먼저 앱이 시스템 프록시를 따르는지, 트래픽이 클라이언트에 들어오는지 확인해야 합니다.

    일상적으로 직접 연결하는 사이트를 비교 대상으로 삼아 한 페이지의 결과만으로 전체 네트워크를 판단하지 마세요. 설정은 한 번에 하나씩 바꾸고, 변경한 뒤에는 연결을 다시 시도하세요. 문제가 생기면 단순히 ‘인터넷이 안 된다’고 설명하기보다 운영체제, 클라이언트 이름, 실행한 작업, 오류 메시지 원문을 기록하면 원인을 찾는 데 도움이 됩니다.

전체 가이드 보기 →

오픈소스 코어와 클라이언트 생태계

코어, GUI 클라이언트, 구독 서비스를 구분해야 기능을 제공하는 주체와 문제를 해결할 위치를 파악할 수 있습니다. 이 사이트는 다운로드 경로와 한국어 안내를 제공하며, 상위 프로젝트의 릴리스 기록이나 설정 문서를 대신하지 않습니다.

Clash, Meta, mihomo의 관계

Clash는 이 계열의 규칙 기반 프록시 도구가 발전하는 데 중요한 출발점이었으며, 그 설정 형식을 중심으로 클라이언트와 규칙 생태계가 형성됐습니다. Clash Meta는 이를 기반으로 기능을 확장했고, 이후 코어는 mihomo라는 이름으로 유지 관리되고 있습니다. 검색 결과에 여러 이름이 함께 표시될 수 있지만 항상 같은 프로그램을 가리키는 것은 아닙니다. 파일명만으로 기능 범위를 판단해서도 안 됩니다.

오래된 가이드에 나온 필드, 실행 인자, 프로토콜 지원이 현재 클라이언트에서 작동하지 않을 수 있습니다. 지원하지 않는 필드가 있다면 실제로 불러온 코어와 해당 문서를 먼저 확인한 뒤 설정을 수정할지 클라이언트를 바꿀지 결정하세요. 모든 고급 옵션을 한꺼번에 옮기기보다 정상 작동하는 설정을 백업해 두는 편이 안전합니다.

GUI 클라이언트와 코어는 별도로 관리됩니다

GUI 클라이언트는 트레이 메뉴, 구독 관리, 프록시 선택, 시스템 연동 기능을 제공하고 코어는 설정 파싱, 규칙 매칭, 네트워크 연결 처리를 담당합니다. 같은 코어를 사용하는 클라이언트라도 덮어쓰기 순서, 권한 설치 방식, 설정 저장 위치가 다를 수 있습니다. 인터페이스의 스위치 이름이 비슷해도 생성되는 설정까지 동일하다는 보장은 없습니다.

따라서 다른 클라이언트로 옮길 때는 설정 내용과 시스템 설정을 각각 확인해야 합니다. 포트, 자동 시작, 시스템 프록시, TUN 권한은 구독을 복사하는 것만으로 동기화되지 않는 경우가 많습니다. 이 사이트의 다운로드 페이지에서는 유지 관리 상태와 플랫폼별 다운로드 경로를 함께 안내합니다. 지원이 중단된 클라이언트에는 보관 표시를 해 두어 오래된 가이드가 어떤 프로그램을 기준으로 작성됐는지 확인할 수 있습니다.

공개 소스로 동작 방식 확인

mihomo 코어는 GPL-3.0 오픈소스 라이선스를 사용합니다. 소스 코드, 이슈, 릴리스 기록을 통해 설정 동작과 변경 이유를 확인할 수 있습니다. 오픈소스 라이선스는 코드 사용과 배포 조건을 규정하는 것으로, 특정 구독 서비스의 품질을 보장하지 않으며 설정 출처를 확인하는 절차를 대신하지 않습니다. GUI 클라이언트의 라이선스는 각 프로젝트 문서에서 따로 확인하세요.

기능을 확인하려면 먼저 필드 문서를 살펴보고 관련 이슈에 재현 조건이 있는지 확인하세요. 문제를 제보할 때는 최소 설정 조각과 민감 정보를 가린 로그를 첨부하고, 필요한 맥락을 충분히 남기세요. 전체 구독 내용이나 계정 정보는 올리지 마세요. 재현 단계가 없는 스크린샷만으로는 설정 문제와 프로그램 결함을 구분하기 어렵습니다.

업데이트 전에 호환성과 롤백 방법 확인

클라이언트를 업데이트하면 인터페이스, 코어, 시스템 보조 구성 요소가 함께 변경될 수 있습니다. 업데이트 전에 사용자 지정 규칙, 덮어쓰기 설정, 현재 적용 중인 설정을 저장하고 릴리스 노트에서 호환되지 않는 변경 사항을 확인하세요. 업데이트 후에는 기존에 정상 작동하던 연결부터 확인한 다음 새 기능을 단계적으로 활성화하세요. DNS 변경, TUN 전환, 설정 교체를 한 번의 테스트에서 동시에 하지 마세요.

구독 업데이트와 클라이언트 업데이트도 구분해서 확인해야 합니다. 전자는 원격 설정 내용을 바꾸고 후자는 프로그램 동작을 바꿉니다. 구독을 새로고침한 뒤에만 문제가 생겼다면 그룹 이름, 규칙 참조, 서비스 상태를 확인하세요. 프로그램 업데이트 후에만 문제가 생겼다면 릴리스 노트와 권한 상태를 비교하세요. 발생 순서를 정리하면 점검 범위를 줄일 수 있습니다.

mihomo 상위 프로젝트 소스 보기

아래 명령은 소스 코드를 복제할 뿐 클라이언트를 설치하거나 프록시 서비스를 실행하지 않습니다. 실행하려면 로컬에 Git이 설치되어 있어야 합니다. 일반 사용자는 저장소 문서를 바로 읽어도 됩니다.

mihomo 소스 코드 저장소 열기 ↗
git clone https://github.com/MetaCubeX/mihomo.git

사용 전에 구분해야 할 개념

구독을 가져왔는데도 연결되지 않는 이유는 무엇인가요?

가져오기에 성공했다는 것은 클라이언트가 내용을 받아 파싱했다는 뜻일 뿐입니다. 설정이 적용됐는지, 프록시 그룹에서 사용 가능한 출구를 선택했는지, 앱 트래픽이 실제로 클라이언트에 들어오는지도 확인해야 합니다. 먼저 연결 기록을 살펴본 뒤 노드, 규칙, 시스템 프록시 문제를 구분하세요. 관련 개념은 구독 및 설정 용어를 참고하세요.

시스템 프록시와 TUN 모드를 함께 켜야 하나요?

항상 둘 다 켜야 하는 것은 아닙니다. 시스템 프록시는 해당 설정을 따르는 앱에 적용되고, TUN은 가상 인터페이스로 트래픽을 처리합니다. 실제 처리 범위는 라우팅과 클라이언트 구현에 따라 달라집니다. 한 가지 방식으로 먼저 기준 상태를 만든 뒤 다른 방식이 필요한지 판단하세요. 정의는 네트워크 스택 용어에서 확인할 수 있습니다.

노드 탐지에 성공하면 모든 웹사이트에 접속할 수 있나요?

탐지 결과는 지정된 주소와 당시 연결 상태만 반영합니다. 대상 웹사이트의 DNS 조회, 규칙에 따른 출구, 필요한 프로토콜, 접근 제한은 다를 수 있으므로 실제 요청을 함께 확인해야 합니다. 탐지 결과만으로 판단하지 마세요. 자세한 설명은 프록시 및 프록시 그룹 용어를 참고하세요.

원격 구독을 새로고침한 뒤 사용자 지정 규칙이 사라지는 이유는 무엇인가요?

구독을 다운로드한 파일을 직접 수정했다면 새로고침 과정에서 파일이 다시 생성되어 변경 사항이 덮어써질 수 있습니다. 클라이언트에서 공식 지원하는 덮어쓰기 또는 병합 기능을 사용하고 최종 규칙 순서를 확인하세요. 로컬 규칙과 원격 설정의 차이는 설정 파일 용어에서 확인할 수 있습니다.

Linux 펭귄 그래픽은 Font Awesome Tux를 사용하며 CC BY 4.0에 따라 이용합니다. 플랫폼 그래픽은 운영체제 식별 목적으로만 사용됩니다.

사용 후기 및 주제별 가이드

최신 글 세 편에서는 모바일 백그라운드 권한, Fake-IP DNS 처리 과정, 기기 간 설정 동기화를 다룹니다. 기본 연결을 마친 뒤 실제 상황에 맞는 글을 확인하세요. 한 플랫폼의 조작 방법을 다른 기기에 그대로 적용하지 마세요.