● 설정 인덱스CLASH / YAML

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

운영체제에 맞는 설치 파일을 찾고 구독을 가져온 다음, 규칙 기반 라우팅과 YAML 필드를 하나씩 확인하세요.

오픈소스 코어 생태계한국어 설정 필드 가이드
설치하기OS / ARCH

운영체제에 맞는 Clash 설치 파일

먼저 운영체제를 선택한 뒤 CPU 아키텍처와 설치 파일 형식을 확인하세요. 다운로드 페이지에서 플랫폼별 클라이언트와 시스템 요구 사항을 볼 수 있습니다. 이름이 같은 앱이라도 운영체제에 따라 코어가 다르거나 오버라이드 방식이 지원되지 않을 수 있습니다.

전체 클라이언트 보기 →

프로젝트와 출처CORE / GUI

Clash 오픈소스 생태계와 프로젝트별 역할

이름이 비슷한 앱을 발견하면 설정을 옮기기 전에 프로젝트의 계보, 코어 출처, 클라이언트 유지보수 상태부터 확인하세요.

Mihomo 소스 코드 저장소 ↗

git clone https://github.com/MetaCubeX/mihomo.git

프로젝트 계보: 이름으로 문서의 적용 범위 파악하기

Clash는 처음에는 규칙 기반 설정을 사용하는 프록시 코어를 가리켰고, 이후 여러 데스크톱 및 모바일 도구를 통칭하는 이름으로도 쓰였습니다. Mihomo는 Clash Meta의 개발 흐름을 이어가므로, 예전 문서에 나오는 Meta가 현재의 Mihomo 프로젝트를 뜻할 수 있습니다. 오래된 자료를 볼 때는 원본 코어, 후속 포크, 특정 UI의 사용법 중 무엇을 다루는지 먼저 확인하세요. 버튼 이름이나 설정 화면이 바뀌어도 YAML 문법까지 함께 바뀌는 것은 아닙니다. 반대로 화면이 비슷하다고 해서 예전 설정의 확장 필드가 여전히 지원된다고 볼 수도 없습니다.

커뮤니티 자료: 저장소 기록과 클라이언트 안내 살펴보기

Mihomo는 GPL-3.0 라이선스로 소스 코드를 공개합니다. 저장소에서는 코드, 이슈 논의, 릴리스 정보를 확인할 수 있습니다. 데스크톱이나 모바일 클라이언트는 각각 별도로 관리되므로 같은 코어를 사용하더라도 라이선스나 배포 방식이 같지는 않습니다. 커뮤니티 이슈를 참고할 때는 운영체제, 연결 방식, 실제 오류 메시지가 일치하는지 먼저 확인하세요. 증상만 같다고 해결 방법까지 항상 적용되는 것은 아닙니다. 위의 복제 명령은 코어 소스 코드를 내려받아 읽거나 개발할 때 사용하는 것으로, GUI 클라이언트 설치를 대신하지 않으며 구독도 가져오지 않습니다.

역할 구분: UI는 설정을 만들고 코어는 네트워크 처리를 실행

GUI 클라이언트는 보통 구독 다운로드, 설정 전환, 시스템 프록시 제어, 로그 표시를 담당합니다. 코어는 최종 설정을 해석하고 리스닝, DNS, 규칙 매칭, 출구 연결을 처리합니다. 설정이 적용되려면 클라이언트가 해당 값을 최종 파일에 기록하는지, 코어가 그 필드를 읽는지, 운영체제가 관련 네트워크 작업을 허용하는지 모두 확인해야 합니다. 클라이언트를 옮길 때는 새 클라이언트에 원본 설정을 먼저 가져와 연결을 확인한 다음 로컬 오버라이드를 하나씩 복원하세요. 클라이언트 비교는 클라이언트 비교를 참고하고, UI 모양만으로 선택을 결정하지 마세요.

업데이트 방식: 앱, 코어, 구독은 따로 관리

앱 업데이트는 설정 저장 위치나 UI 메뉴를 바꿀 수 있고, 코어 업데이트는 지원 필드와 네트워크 동작을 바꿀 수 있습니다. 구독 새로고침은 제공자가 배포한 프록시, 프록시 그룹, 규칙을 교체할 수 있습니다. 이 세 가지 변경은 분리해서 진행하세요. 업데이트 전에 다시 가져올 수 있는 설정과 로컬 오버라이드를 저장하고, 현재 연결 방식을 기록해 두세요. 업데이트 후에는 활성 설정이 올바른지 확인한 뒤 로컬 포트가 열려 있는지, 자주 쓰는 사이트에 어떤 규칙이 적용되는지 살펴보세요. 문제가 생기면 방금 변경한 한 단계만 되돌려 원인 파악에 필요한 설정이 덮어써지지 않도록 하세요.

설치와 설정에 관한 자주 묻는 질문

7890 포트가 열려 있으면 시스템이 이미 프록시를 사용하고 있다는 뜻인가요?

꼭 그렇지는 않습니다. mixed-port는 코어가 프록시 요청을 받는 포트만 지정합니다. 시스템이나 앱도 실제 리스닝 주소와 포트를 사용하도록 설정해야 합니다. 일부 앱은 자체 네트워크 설정을 사용하므로 시스템 프록시를 켜도 별도 설정으로 연결할 수 있습니다. 먼저 포트 설정 필드를 확인한 다음 클라이언트의 연결 화면에 방금 보낸 요청이 표시되는지 살펴보세요.

구독을 새로고침한 뒤 이전에 선택한 출구가 사라진 이유는 무엇인가요?

구독 새로고침으로 그룹 이름, 항목 이름, 구성원 순서가 바뀔 수 있습니다. UI가 저장한 선택 항목이 삭제된 구성원을 가리키면 클라이언트는 현재 그룹에서 사용할 수 있는 항목으로 돌아갈 수 있습니다. 먼저 현재 사용 중인 설정을 확인하고 새로고침 전후의 프록시 그룹과 오버라이드 참조를 비교하세요. 그룹 유형 같은 낯선 용어는 용어집에서 확인할 수 있습니다.

하나의 설정을 다른 기기로 완전히 옮길 수 있나요?

기본 필드는 대체로 옮기기 쉽지만 가상 네트워크 인터페이스, 네트워크 인터페이스 이름, 로컬 파일 경로, 클라이언트 오버라이드 스크립트는 기기 환경에 따라 달라질 수 있습니다. 먼저 대상 클라이언트가 지원하는 가져오기 형식을 확인한 뒤 기기와 무관한 규칙과 정책을 옮기세요. 설정이 정상인지 확인한 다음 대상 기기에서 시스템 프록시와 연결 권한을 다시 설정하고, 이전 기기의 경로를 그대로 가져오지 마세요.

Clash 기술 가이드

클라이언트 비교, 연결 문제 해결, 모바일에서 처음 설정을 가져오는 방법을 확인하세요.

전체 글 보기 →