오픈 소스 프로젝트 · mihomo 코어 지속 업데이트

ClashX 공식Clash 전 플랫폼 클라이언트 다운로드

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 YAML 설정으로 연결을 구성한 다음, 규칙 기반 라우팅과 TUN 모드로 네트워크 접속을 설정하세요.

  • 영구 무료
  • 오픈 소스
  • 중국어 문서
CONFIGURATION FACTS
CORE
mihomo
LICENSE
GPL-3.0
PLATFORMS
5개 플랫폼
FORMAT
YAML 설정

TRAFFIC / CONFIGURATION

시스템 연결 및 규칙 설정

먼저 트래픽이 코어에 들어오는 방식을 정한 뒤, 연결의 출구를 선택하세요.

프록시를 지원하는 앱을 로컬 포트에 연결

시스템 프록시는 운영체제의 프록시 주소를 클라이언트의 로컬 수신 포트로 지정합니다. 브라우저처럼 시스템 설정을 따르는 앱의 연결은 코어로 전달된 뒤 현재 모드에 따라 출구가 선택됩니다. 처음 설정한다면 이 방법부터 시작하는 것이 좋습니다. 구독을 가져오고 코어를 실행한 다음 클라이언트에서 시스템 프록시를 켜세요. 시스템 프록시와 TUN의 차이는 연결 범위이지 노드 속도가 아닙니다. 시스템 프록시를 따르지 않는 앱은 직접 연결될 수 있습니다. 설정의 혼합 포트는 HTTP와 SOCKS 요청을 모두 받지만, 시스템 설정을 실제로 변경하는 것은 클라이언트의 스위치입니다.

  • 로컬 수신 포트: 시스템 프록시에 입력한 포트가 실제 수신 포트와 일치해야 합니다.
  • 연결 확인: 연결 목록에서 테스트 요청이 실제로 코어를 통과하는지 확인하세요.
  • 종료 전 복구: 클라이언트를 끄기 전에 시스템 프록시를 해제해 설정이 남지 않도록 하세요.
LEARN MORE →
config.yaml
mixed-port: 7890allow-lan: falsemode: rulelog-level: info# 시스템 프록시는 클라이언트 화면에서 활성화

PACKAGES / PLATFORMS

Clash 플랫폼별 다운로드

먼저 운영체제를 선택한 뒤 프로세서 아키텍처와 설치 방식을 확인하세요. 클라이언트 다운로드와 프록시 서비스는 별개이므로 설치 후 사용할 수 있는 설정도 준비해야 합니다.

Windows

Clash Plus를 먼저 살펴보고 Clash Verge Rev, FlClash, Clash Nyanpasu와 비교해 보세요. 설치 후 설정을 가져온 다음 시스템 프록시를 켜세요. TUN이 필요하면 서비스와 권한을 추가로 설정해야 합니다. 로컬 포트가 사용 중이라면 반복해서 재설치하기 전에 해당 포트를 점유한 프로세스부터 확인하세요.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 각각 다른 인터페이스를 제공하며, ClashX Meta를 찾을 때는 보관 상태인지 확인해야 합니다. 처음 실행할 때 보안 경고가 나타나면 먼저 배포 출처를 확인하고 운영체제 안내에 따라 권한을 허용하세요.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택하고 구독 형식이 클라이언트와 호환되는지 확인하세요. 처음 연결할 때는 VPN 요청을 승인해야 합니다. 백그라운드 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 먼저 확인한 다음 구독 만료 여부를 살펴보세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하세요. 공식 사이트는 clashplus.io입니다. 설정을 가져오고 VPN 구성 추가를 허용한 다음 정책과 노드를 선택하세요. 시스템의 VPN 표시는 터널이 연결됐다는 뜻일 뿐입니다. 실제 라우팅 결과는 요청 기록도 함께 확인해야 합니다.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 Clash Verge Rev와 FlClash부터 살펴보고 배포판에 맞는 패키지 형식을 선택하세요. 서버와 라우터에서는 mihomo 코어를 별도로 배포하고 설정 디렉터리, 서비스 권한, 시작 방식을 구성할 수 있습니다. 명령줄 배포는 데스크톱 클라이언트 설치와 다릅니다.

다운로드 페이지로 이동
모든 클라이언트 보기 →

FIRST CONNECTION

Clash 구독 가져오기와 연결 확인

설정 소스 → 연결 방식 → 요청 확인 순서로 진행하고, 문제가 생겨도 같은 순서로 되짚어 보세요.

  1. STEP 01 / PROFILE

    클라이언트 설치 및 구독 가져오기

    다운로드 페이지에서 운영체제에 맞는 클라이언트를 선택하세요. 설정 또는 구독 페이지를 열고 서비스 제공업체가 제공한 Clash 호환 구독 주소를 붙여 넣습니다. 다운로드가 끝나면 현재 설정으로 지정하세요. 설정 이름이 보인다고 활성화된 것은 아닙니다. 노드 목록과 정책 그룹이 표시되는지도 확인하세요.

    노드 링크 하나나 Base64 텍스트만 받았다면 먼저 클라이언트가 해당 형식을 가져올 수 있는지 확인하세요. 변환이 필요하면 신뢰할 수 있는 로컬 처리 방법을 우선 사용하세요. 구독 링크에는 계정 및 트래픽 정보가 연결될 수 있으므로 출처가 불분명한 온라인 도구에 붙여 넣지 마세요.

  2. STEP 02 / ROUTE

    규칙 모드와 연결 방식 선택

    정책 그룹에서 사용할 수 있는 노드를 하나 선택한 다음 실행 모드를 규칙으로 설정하세요. 데스크톱에서는 먼저 시스템 프록시를 켜고 브라우저로 기본 연결을 테스트할 수 있습니다. 연결이 정상인지 확인한 뒤 필요에 따라 TUN을 활성화하세요. 모바일에서는 운영체제 안내에 따라 VPN 권한을 승인하세요.

    전역 모드와 TUN은 같은 스위치가 아닙니다. 전역 모드는 코어에 들어온 연결에 어떤 정책을 적용할지 정하고, TUN은 트래픽을 코어로 전달하는 방식을 결정합니다. 전역 모드라고 해서 기기의 모든 앱이 처리되는 것도 아닙니다.

  3. STEP 03 / VERIFY

    연결 기록에서 일치 규칙 확인

    테스트할 사이트에 접속하면서 클라이언트의 연결 목록을 엽니다. 대상 도메인, 일치 규칙, 정책 그룹, 최종 노드를 확인해 요청 경로가 예상과 일치하는지 살펴보세요. 한 번의 지연 시간 테스트는 특정 테스트 대상만 반영하며 다운로드 속도나 모든 서비스의 접속 품질을 나타내지 않습니다.

    페이지가 열리지 않으면 먼저 연결이 코어에 들어왔는지 확인하세요. 기록이 없다면 시스템 프록시, VPN 권한, 라우팅을 점검하고, 기록은 있지만 연결에 실패한다면 DNS, 노드 연결 상태, 규칙 대상을 확인하세요. 설정은 한 번에 하나씩 바꾸고 재현 가능한 점검 결과를 남기세요.

첫 설정에서 알아둘 세 가지

설치 파일에는 프록시 서비스가 포함되지 않습니다. 클라이언트는 설정을 읽고 연결을 처리하며, 노드는 설정 소스에서 제공됩니다. 구독을 성공적으로 가져와도 모든 노드가 현재 사용 가능하다는 뜻은 아닙니다. 서비스 상태와 실제 요청을 함께 확인하세요.

연결 성공이 올바른 라우팅을 뜻하지는 않습니다. 로컬 기기, 회사 네트워크, 프린터 서비스에는 직접 연결 경로가 필요할 수 있습니다. TUN을 켠 뒤 이런 서비스에 문제가 생기면 모든 요청을 프록시 노드로 보내기보다 LAN 라우팅과 제외 항목부터 확인하세요.

로컬 수정 사항은 계속 유지되도록 저장해야 합니다. 구독 업데이트가 직접 수정한 내용을 덮어쓸 수 있습니다. 계속 사용할 사용자 규칙은 클라이언트가 지원하는 덮어쓰기 또는 병합 기능에 추가하고, 업데이트 후 규칙 순서와 정책 그룹 이름을 다시 확인하세요. 화면 구성은 클라이언트마다 다르므로 플랫폼별 문서를 참고하세요.

전체 가이드 보기 →

OPEN SOURCE / RESPONSIBILITY

Clash 생태계와 mihomo 코어

인터페이스, 코어, 설정 소스를 구분해야 기능 지원 여부와 문제 원인을 정확히 판단할 수 있습니다.

프로젝트 역사와 이름의 관계

Clash 생태계에는 코어, 데스크톱 인터페이스, 모바일 클라이언트, 설정 도구가 포함됩니다. Clash Meta는 과거 자료를 검색할 때 자주 보이는 이름이며, mihomo는 관련 코어 개발 방향을 이어갑니다. 이전 가이드를 검색하면 두 이름이 함께 나올 수 있습니다. 실제 설정은 사용 중인 코어의 문서를 기준으로 해야 하며, 앱 이름만으로 지원 프로토콜과 필드를 단정해서는 안 됩니다.

ClashX는 macOS 클라이언트 계열을 가리키는 이름으로 쓰이며, 모든 플랫폼에서 같은 앱을 사용하는 것은 아닙니다. 이 사이트에서는 플랫폼별 설치 파일과 한국어가 아닌 중국어 안내를 정리해 유지 관리 중인 클라이언트와 보관된 프로젝트를 구분할 수 있도록 했습니다. 프로젝트마다 출시 주기가 다르며, 클라이언트 인터페이스가 비슷해도 코어 동작까지 같다는 뜻은 아닙니다.

오픈 소스 저장소와 커뮤니티 협업

mihomo 공개 저장소에서는 소스 코드, 라이선스, 이슈 토론, 릴리스 정보를 확인할 수 있습니다. 오픈 소스 협업은 구현을 살펴볼 수 있고, 구체적인 설정과 환경을 바탕으로 문제를 재현할 수 있다는 점에서 의미가 있습니다. GPL-3.0은 여기에 소개된 mihomo 코어의 라이선스이며 모든 서드파티 클라이언트나 앱 스토어 앱에 동일하게 적용되는 것은 아닙니다. 배포하거나 수정할 때는 각 프로젝트의 안내를 따로 확인하세요.

문제를 제보하기 전에 운영체제, 클라이언트 이름, 코어 정보, 재현 단계를 기록하세요. 로그는 재현에 필요한 부분만 남기고 구독 주소, 계정 정보, 노드 비밀번호, 기타 접속 정보를 가리세요. ‘특정 사이트가 열리지 않는다’는 현상을 DNS 확인 실패, 연결 실패, 규칙 선택 오류로 나누면 단순히 결과만 설명하는 것보다 원인을 찾기 쉽습니다.

클라이언트와 코어의 역할

클라이언트는 보통 설정 가져오기, 구독 업데이트, 트레이 메뉴, 시스템 프록시, 권한 서비스를 담당합니다. 코어는 설정을 해석하고 규칙을 실행하며 프록시 연결을 만들고 네트워크 요청을 처리합니다. 따라서 인터페이스의 스위치가 작동하지 않는다면 시스템 권한 문제일 수도 있고 설정이 덮어써졌을 수도 있습니다. 노드 목록만 확인해서는 원인을 찾기 어렵습니다.

클라이언트를 옮길 때는 먼저 설정을 내보내고 사용자 지정 항목을 기록하세요. 전체 YAML, 단일 노드 링크, 노드 제공자는 서로 다른 형식입니다. 하나를 가져올 수 있다고 해서 나머지도 바로 사용할 수 있는 것은 아닙니다. 프로토콜 지원, TUN 네트워크 스택, 규칙 동작도 코어에 따라 확인해야 합니다.

앱 업데이트와 구독 업데이트는 따로 확인

앱 설치 파일 업데이트, 코어 업데이트, 구독 새로고침, 규칙 집합 다운로드는 서로 다른 작업입니다. 구독 새로고침이 성공했다는 것은 원격 콘텐츠를 가져왔다는 뜻일 뿐입니다. 앱이 이전 설정을 계속 사용하거나 정책 그룹에 이전 선택이 남아 있을 수 있습니다. 업데이트를 마친 뒤에는 업데이트 시간 안내만 보지 말고 현재 활성화된 항목을 확인하세요.

호환성 문제가 생기면 먼저 백업한 다음 업데이트 전후의 설정 차이를 비교하세요. 클라이언트, 노드, DNS, 규칙을 한꺼번에 바꾸면 어떤 변경이 문제를 해결했는지 알기 어렵습니다. 장기간 실행할 환경이라면 복구할 수 있는 설정 사본을 보관하고 중요한 변경 사항을 로컬에 기록하세요.

NOTES / FIELD GUIDES

Clash 설정 및 문제 해결 가이드

포트, 구독 형식, Linux 배포까지 문제에 맞는 사용법을 확인하세요.

모든 글 보기 →