초보자용 3단계: 구독 가져오기 → 모드 선택 → 시스템 프록시 켜기

가이드 보기 →

Clash 오픈소스넷 · 클라이언트 및 설정 정보

Clash 클라이언트 다운로드노트북 및 전 플랫폼 설정 가이드

Clash 다운로드 가이드 보기

기기에 맞는 클라이언트를 선택하고 구독을 가져와 설정한 다음, 규칙 기반 프록시와 한국어 가이드를 참고해 연결 방식을 조정하세요.

  • 오픈소스 코어 mihomo
  • 규칙 기반 프록시
  • 한국어 가이드
플랫폼별 다운로드

기기에 맞는 Clash 클라이언트 선택

운영체제와 프로세서부터 확인한 뒤 다운로드 페이지에서 설치 파일을 선택하세요.

전체 클라이언트 보기 →

클라이언트는 창, 설정 관리와 시스템 연동을 담당하고 코어는 실제 연결과 규칙 매칭을 처리합니다. 같은 구독이라도 클라이언트가 지원하는 설정 형식과 코어 기능에 따라 바로 사용할 수 있는지가 달라집니다. 파일 확장자가 같다고 모든 항목이 호환되는 것은 아닙니다. 처음 설치할 때는 GUI에서 시작해 검증된 설정을 가져오고 기본 연결을 확인한 다음 사용자 규칙을 추가하세요.

노트북을 여러 네트워크에서 사용한다면 기본 설정을 하나 보관해 두세요. 학교, 회사와 가정의 네트워크는 인증 방식이 다를 수 있습니다. 웹페이지가 열리지 않는다면 먼저 프록시를 일시 중지하고 현재 네트워크에 로그인하거나 인증한 다음 클라이언트를 다시 켜세요. 인증이 끝나기 전에 구독을 연달아 업데이트하면 네트워크 오류를 구독 만료로 오해할 수 있습니다.

클라이언트를 설치했다고 바로 연결할 수 있는 것은 아닙니다. 프록시 서버, 구독과 사용 권한은 사용자가 직접 준비해야 합니다. 이 사이트는 소프트웨어 다운로드 경로와 설정 정보를 제공하며 프록시 서비스를 제공하지 않습니다. 소프트웨어를 선택할 때는 클라이언트 비교를 참고하고, 처음 연결할 때는 구독 가져오기 가이드를 따라 진행하세요. 유지 관리가 중단된 클라이언트는 이전 설정을 확인하거나 마이그레이션할 때만 사용하는 것이 좋습니다.

기기 연결도 · 설정 탐색기

주요 기능과 설정 항목

오른쪽 항목을 클릭해 기능, 사용 범위와 관련 설정을 확인하세요. 먼저 항목 하나를 이해한 뒤 설정 한 곳만 변경하세요.

규칙 기반 프록시

규칙 모드는 설정된 순서에 따라 연결을 매칭하고 각 대상을 직접 연결, 프록시 그룹 또는 차단 정책으로 전달합니다. 사내 시스템, 코드 저장소와 일반 웹사이트를 함께 이용하는 노트북에 적합합니다. 먼저 프록시 그룹 이름이 존재하는지 확인하고, 구체적인 도메인 규칙을 포괄적인 규칙보다 앞에 둔 뒤 마지막에 기본 규칙을 남겨 두세요. 전역 모드와 달리 직접 연결 경로를 유지할 수 있지만 결과는 규칙 구성에 따라 달라집니다. 연결이 예상과 다르면 스위치 색상만 보지 말고 연결 기록에서 어떤 규칙이 적용됐는지 확인하세요.

rules: ['DOMAIN-SUFFIX,github.com,PROXY']
오픈소스 생태계와 유지 관리

Clash, mihomo와 클라이언트의 관계

UI, 코어와 설정을 나누어 보면 다운로드 선택과 문제 원인을 더 쉽게 파악할 수 있습니다.

프로젝트의 역사와 설정 호환성

Clash 생태계에서는 규칙 기반 프록시 설정을 중심으로 다양한 클라이언트와 가이드가 만들어졌습니다. 기존 프로젝트와 일부 데스크톱 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티는 호환 구현과 새로운 GUI를 계속 개발하고 있습니다. 따라서 ‘Clash’를 검색하면 구형 클라이언트, 호환 코어 또는 새로운 앱 이름이 함께 나올 수 있습니다. 익숙한 이름만 보고 결정하지 말고 어떤 계층의 소프트웨어인지, 현재도 유지 관리되는지 확인하세요.

mihomo는 이 생태계에서 지속적으로 개발되는 오픈소스 코어이며, 프로젝트 저장소는 MetaCubeX 조직에 있습니다. 관련 설정 방식을 이어받아 확장했지만 새로운 프로토콜, 규칙 기능과 네트워크 기능은 각각 지원 조건이 다릅니다. 이전 가이드는 기본 구조를 이해하는 데 도움이 되지만 현재 코어 문서를 대신할 수는 없습니다. 알 수 없는 항목이나 구문 분석 오류가 발생하면 실행 중인 코어와 문서의 적용 범위를 먼저 확인한 뒤 해당 항목을 유지하거나 바꾸거나 삭제할지 결정하세요.

GUI와 코어의 역할

클라이언트는 보통 구독 저장, 설정 편집, 연결 표시, 프록시 모드 전환과 시스템 서비스 설치를 담당합니다. 코어는 최종 생성된 설정을 읽고 규칙 매칭, 도메인 조회와 프록시 연결을 처리합니다. GUI에 스위치가 보인다고 해서 원본 구독 파일에 같은 이름의 항목이 반드시 있는 것은 아닙니다. 일부 옵션은 클라이언트 자체 설정에 저장되며, 다른 옵션은 실행 시 코어 설정에 병합됩니다.

문제를 확인할 때는 먼저 두 가지를 살펴보세요. 설정이 코어에 전달되어 실행됐는지, 앱의 트래픽이 실제로 코어에 들어오는지 확인하면 됩니다. 코어가 시작되지 않았다면 설정 구문 분석과 포트 사용 여부를 확인하세요. 코어는 정상인데 연결 기록이 없다면 시스템 프록시, 앱별 프록시 또는 TUN 라우팅을 확인하세요. 구독, DNS와 방화벽을 한꺼번에 바꾸는 것보다 이 경계를 따라 확인하는 편이 원인을 명확히 파악하기 쉽습니다.

공개 코드와 커뮤니티 자료

mihomo 코드는 GPL-3.0 라이선스를 따릅니다. 공개 저장소에서 소스 코드, 커밋 기록, 릴리스 노트와 이슈 논의를 확인할 수 있습니다. 오픈소스 라이선스는 코드 사용과 배포 조건을 정하는 것이며, 모든 서드파티 클라이언트에 같은 라이선스가 적용된다는 뜻도 프록시 서비스가 무료라는 뜻도 아닙니다. 클라이언트를 선택할 때는 각 프로젝트 안내를 별도로 확인하고, 구독을 선택할 때는 서비스 제공자의 신뢰성과 이용 조건을 따로 판단하세요.

커뮤니티 질문을 확인할 때는 같은 운영체제, 코어와 오류 문구가 있는 사례를 찾아보세요. “인터넷이 안 돼요”라는 한마디만으로는 원인을 찾기 어렵습니다. 문제가 발생한 앱, 연결 방식, 적용된 규칙과 특정 네트워크에서만 발생하는지 기록하면 도움이 됩니다. 설정이나 로그를 공유하기 전에 구독 주소의 인증 정보, 서버 비밀번호와 개인 도메인을 삭제하세요. 공개 게시물에는 재현 조건이 필요하며 개인 설정 전체를 올릴 필요는 없습니다.

업데이트와 롤백 준비

클라이언트 업데이트, 코어 업데이트와 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 UI와 서비스 연동을 바꿀 수 있고, 코어 업데이트는 프로토콜과 설정 항목에 영향을 줄 수 있으며, 구독 업데이트는 프록시 목록, 그룹과 규칙을 바꿀 수 있습니다. 변경하기 전에 현재 정상 작동하는 조합을 기록하고 필요한 로컬 재정의 설정을 내보내 두세요. 한 번에 한 계층씩 변경해야 차이가 생겼을 때 어떤 릴리스 노트를 확인해야 할지 알 수 있습니다.

이 사이트는 자료 정리와 사용 방법을 제공하며 모든 클라이언트의 공식 유지 관리 주체를 대표하지 않습니다. 각 소프트웨어의 지원 범위는 프로젝트 문서와 실제 실행 결과를 기준으로 확인하세요. 다운로드 페이지에서는 플랫폼별 경로를 모아 보고, 가이드 페이지에서는 최초 설정 절차를 따라갈 수 있습니다. 복잡한 증상은 문제 해결 핸드북에서 단계별로 확인하세요. 페이지 게시 시점을 클라이언트 업데이트 상태로 오해하지 않도록 홈 화면에는 소프트웨어 버전을 고정 표시하지 않습니다.

mihomo 소스 코드 보기

Git이 설치되어 있다면 명령어를 복사해 저장소를 가져올 수 있습니다. 이 작업은 소스 코드만 내려받으며 클라이언트 설치, 구독 생성이나 시스템 프록시 변경은 하지 않습니다. 빌드와 실행 요구 사항은 저장소 문서를 확인하세요.

MetaCubeX/mihomo 오픈소스 저장소 방문 ↗ 
git clone https://github.com/MetaCubeX/mihomo.git

설정과 문제 해결 가이드 읽는 순서

처음 설치할 때는 설정을 가져오고 프록시 그룹을 선택한 뒤 시스템 프록시를 켜세요. 같은 브라우저로 연결을 확인한 다음 TUN, 네트워크 공유나 사용자 규칙을 시도하세요. 정상 작동 상태를 하나 보관해 두면 이후 변경 사항을 비교하기 쉽습니다. 여러 클라이언트를 동시에 실행하면 포트와 프록시 설정이 충돌할 수 있으므로 테스트할 때는 필요한 클라이언트 하나만 남기세요.

특정 앱 하나만 접속되지 않는다면 앱 자체 프록시 설정을 확인하세요. 모든 연결이 실패한다면 기본 네트워크와 현재 설정이 정상인지 먼저 확인하고, 도메인 접속만 문제라면 DNS 경로를 점검하세요. 속도가 느리다고 곧바로 노드 문제인 것은 아닙니다. Wi-Fi 품질, 대상 서비스의 속도 제한, 규칙에 따른 우회 경로 또는 동시 다운로드도 원인일 수 있습니다. 자주 묻는 질문은 개념을 빠르게 확인할 때, 문제 해결 핸드북은 증상별로 원인을 추적할 때 유용합니다.

YAML을 편집할 때는 공백 들여쓰기, 목록 계층과 이름 참조에 주의하세요. 프록시 그룹이 참조하는 이름은 설정에 실제로 있어야 하며 규칙은 의도한 우선순위로 배치해야 합니다. 구독 설정을 직접 덮어쓰기 전에 클라이언트의 병합 방식을 확인하세요. 원격 설정의 임시 사본을 직접 편집하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 장기간 유지할 설정은 클라이언트에서 지원하는 재정의 또는 병합 메뉴를 사용하고, 업데이트 후 최종 적용된 설정을 확인하세요.

설정 및 네트워크 가이드

최신 Clash 가이드

구체적인 설정 항목과 오류 증상부터 살펴보고 변경의 원인과 결과를 연결해 확인하세요.

전체 글 보기 →

가이드를 읽을 때는 클라이언트 로그 창을 열어 두고 변경 전후의 설정 차이를 기록하세요. 글에 나오는 설정 예시는 해당 기능을 설명하기 위한 것으로, 그대로 실행할 수 있는 완성된 구독이 아닙니다. 복사하기 전에 기존 설정의 계층, 프록시 그룹과 실제 연결 정보를 맞춰야 합니다. 네트워크 공유, 서비스 권한이나 라우팅을 변경할 때는 신뢰할 수 있는 네트워크에서 진행하고 원래 설정으로 되돌릴 방법도 마련하세요.