본문으로 건너뛰기

클라이언트 다운로드 · 중국어 설정 가이드

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

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기부터 시작해 규칙 기반 라우팅을 설정하면 각 연결의 경로를 파악할 수 있습니다.

  • Mihomo 코어
  • 코어 GPL-3.0
  • 규칙 기반 라우팅

설정 하나로 자주 쓰는 6가지 기능

설정, 트래픽 진입점, 출구를 먼저 구분한 뒤 스위치를 조정하세요. 아래 예시는 Mihomo의 주요 기능을 설명하며, 메뉴 이름은 사용하는 클라이언트에 따라 다를 수 있습니다.

구독 링크와 로컬 설정

구독은 원격 설정을 가져오는 주소이지, 설치 파일이나 연결 스위치가 아닙니다. 클라이언트의 구독 페이지에서 원격 구독을 추가하고 서비스 제공자가 준 링크를 붙여 넣으세요. 다운로드가 끝나면 해당 설정을 선택합니다. 먼저 Clash 또는 Mihomo 형식을 지원하는지 확인한 다음 프록시 그룹이 불러와졌는지 살펴보세요. 로컬 파일을 직접 관리하는 대신 구독을 사용하면 노드와 규칙을 한곳에서 업데이트할 수 있지만, 다운로드한 내용을 직접 수정하면 다음 업데이트 때 덮어씌워질 수 있습니다. 계속 유지해야 하는 포트나 규칙 변경은 클라이언트의 오버라이드, 병합 또는 확장 기능을 사용하세요. 구독 주소에는 접근 인증 정보가 포함될 수 있으므로 공개 스크린샷에 노출하지 마세요.

구독 가져오기 단계 보기 →
기본 로컬 설정 · YAML 문법 예시
mode: rule
mixed-port: 7897
allow-lan: false
log-level: info

# 클라이언트의 구독 페이지에서 구독 추가
# 이 조각은 연결 가능한 전체 설정이 아닙니다

기기별 클라이언트 선택

Clash 클라이언트 다운로드 페이지

전체 클라이언트 보기 →

먼저 운영체제를 고른 뒤 프로세서 아키텍처와 설치 방식을 확인하세요. 다운로드 페이지에서 선택 가능한 클라이언트와 시스템 요구 사항, 유지 관리 상태를 확인할 수 있습니다. 이 링크는 해당 플랫폼 페이지로 이동하며 설치 파일을 바로 다운로드하지는 않습니다.

데스크톱에서는 Clash Plus, Clash Verge Rev, FlClash를 비교해 보세요. 설치 전에 시스템 설정에서 프로세서와 운영체제 종류를 확인하고 맞는 설치 파일을 선택합니다. 처음 설정할 때는 프록시 클라이언트를 하나만 실행해 포트 충돌이나 시스템 프록시 설정 변경이 반복되지 않도록 하세요.

설치가 끝나면 구독을 가져와 설정을 선택한 다음 시스템 프록시를 켜세요. 명령줄 도구가 여전히 연결되지 않는다면 시스템 프록시를 읽는지 확인하고, 필요하면 프록시 주소를 별도로 설정하세요. 기존 클라이언트에서 옮길 때는 원래 설정을 복사해 보관하되, 새 프로그램과 기존 프로그램이 동시에 네트워크를 제어하지 않도록 하세요.

다운로드 페이지로 이동 Windows 클라이언트

Mac 사용자는 먼저 ‘이 Mac에 관하여’에서 Apple 칩인지 Intel 프로세서인지 확인한 뒤 알맞은 아키텍처를 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 인터페이스와 설정 관리 방식이 다릅니다. 일상적인 사용을 위해 구독 업데이트와 시스템 프록시 설정이 편리한지 비교해 보세요.

처음 실행할 때는 시스템 안내에 따라 필요한 권한을 허용하세요. 시스템 프록시를 켠 뒤 네트워크 설정에서 현재 프록시 상태를 확인할 수 있습니다. TUN이 필요하다면 서비스 또는 네트워크 권한을 추가로 설정하세요. 다른 컴퓨터의 권한 설정을 이 기기에도 그대로 적용할 수 있다고 가정하지 말고, 운영체제를 업그레이드한 뒤에도 작동 상태를 다시 확인하세요.

다운로드 페이지로 이동 macOS 클라이언트

스마트폰과 태블릿에서는 Clash Plus, Clash Meta for Android, FlClash, Surfboard를 비교해 볼 수 있습니다. 설치 파일의 아키텍처가 기기와 맞아야 하고 설정 형식도 클라이언트와 호환되어야 합니다. 링크 이름만으로 호환 여부를 판단하지 마세요. 가져온 뒤 설정이 활성화되었는지 확인하고 연결을 시작하세요.

처음 연결할 때는 대개 시스템 VPN 권한을 허용해야 합니다. 앱을 백그라운드로 전환한 뒤 연결이 끊긴다면 먼저 배터리 절약 정책과 백그라운드 실행 제한을 확인하고 클라이언트 로그를 살펴보세요. 다른 VPN, 업무 프로필 또는 기기 관리 정책이 연결에 영향을 줄 수 있으니 현재 어떤 앱이 네트워크 경로를 사용 중인지 확인하세요.

다운로드 페이지로 이동 Android 클라이언트

iPhone과 iPad 사용자는 다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동해 호환성, 기능 설명, 스토어에 표시된 정보를 확인할 수 있습니다. 제품 공식 사이트는 clashplus.io입니다. 먼저 앱을 설치한 뒤 앱에서 지원되는 구독이나 설정을 가져오세요.

연결할 때 안내에 따라 VPN 구성을 추가하도록 허용하세요. Wi-Fi와 셀룰러 네트워크를 바꾼 뒤 접속 결과가 달라지면 먼저 연결을 다시 설정하고 현재 정책을 확인하세요. 데스크톱 클라이언트의 서비스 모드와 시스템 프록시 메뉴, 휴대폰의 네트워크 권한은 서로 다른 기능이므로 같은 이름의 스위치를 일일이 찾을 필요는 없습니다.

다운로드 페이지로 이동 iOS 클라이언트

데스크톱 환경에서는 Clash Verge Rev와 FlClash를 비교하고 배포판, 패키지 형식, 프로세서 아키텍처를 먼저 확인하세요. GUI 클라이언트는 구독, 정책 선택, 스위치 관리를 제공하므로 화면에서 직접 조작하려는 사용자에게 적합합니다. 설치한 뒤에는 데스크톱 환경에서 시스템 프록시를 지원하는지도 확인하세요.

서버와 라우터에서 사용할 경우 다운로드 페이지의 Mihomo 코어 섹션을 확인하세요. 코어를 사용하려면 설정 파일, 실행 권한, 서비스 관리 방법을 직접 준비해야 하며 GUI 클라이언트와는 다릅니다. 라우팅을 변경하기 전에는 복구 방법을 마련하세요. 특히 원격으로 관리하는 기기는 변경 후 기존 관리 연결이 끊기지 않도록 주의해야 합니다.

다운로드 페이지로 이동 Linux 클라이언트

오픈소스 생태계와 유지 관리

Mihomo 코어와 클라이언트의 관계

Clash는 규칙에 따라 네트워크 연결을 처리하는 도구의 한 종류이자 여러 클라이언트가 공유하는 설정 생태계의 이름입니다. 코어, 인터페이스, 구독의 역할을 이해하면 소프트웨어 이름만 보는 것보다 선택과 문제 해결에 도움이 됩니다.

Mihomo 오픈소스 저장소 보기 ↗

프로젝트의 계보: 이름이 비슷해도 유지 관리 상태는 다릅니다

기존 Clash 관련 프로젝트의 유지 관리가 중단된 뒤 커뮤니티에서는 여러 코어 포크와 GUI 클라이언트가 나왔습니다. Mihomo는 규칙 기반 프록시 설정 생태계를 이어 확장하고, Clash Verge Rev와 FlClash 같은 클라이언트는 일상적인 조작을 위한 인터페이스를 제공합니다. 예전 가이드의 스크린샷, 메뉴, 설치 방법이 현재 소프트웨어와 다를 수 있습니다. 다운로드 링크를 찾을 때는 프로젝트의 전체 이름을 먼저 확인하고 지원 플랫폼과 유지 관리 안내를 살펴보세요. 파일 이름에 Clash가 들어 있다는 이유만으로 현재 기기에 적합하다고 판단해서는 안 됩니다.

업데이트가 중단됐다고 해서 기존 로컬 설정이 바로 작동하지 않는 것은 아닙니다. 다만 시스템 업데이트, 프로토콜 변경, 네트워크 환경 변화로 호환성 문제가 생길 수 있습니다. 마이그레이션하기 전에 구독 출처, 프록시 그룹 선택, 포트, 사용자 지정 규칙을 기록한 뒤 하나씩 복원하세요. 새 클라이언트가 설정을 읽는 것은 문법 검사를 통과한 첫 단계일 뿐입니다. 실제 연결과 규칙 적용 결과도 확인해야 합니다. 다운로드 페이지에서는 보관된 클라이언트와 현재 선택 가능한 옵션을 구분해 용도에 맞게 고를 수 있습니다.

역할 분리: 인터페이스, 코어, 서비스의 기능

GUI 클라이언트는 구독 관리, 정책 전환, 로그 표시를 담당합니다. 코어는 프로토콜 처리, 규칙 매칭, 연결 전달을 맡고 구독 제공자는 서버와 구독 내용을 관리합니다. 이 셋은 함께 사용되는 경우가 많지만 서로를 대체하지는 않습니다. 인터페이스가 실행된다고 구독이 정상적으로 업데이트된 것은 아니며, 구독 업데이트가 성공해도 출구에 연결할 수 있다는 뜻은 아닙니다. 문제를 확인할 때 이 세 계층을 차례로 살펴보면 불필요한 재설치와 반복적인 스위치 전환을 줄일 수 있습니다.

같은 기기에서 시스템 프록시와 TUN은 트래픽 진입점 역할을 합니다. 앱이 연결을 코어에 전달해야 규칙이 직접 연결 또는 프록시 경로를 결정할 수 있습니다. 연결 페이지에서 대상 앱의 요청을 찾을 수 없다면 규칙을 바로 수정하기보다 진입점부터 확인하세요. 요청이 표시되면 적용된 규칙과 프록시 그룹의 실제 선택을 살펴보세요. 이렇게 하면 ‘트래픽이 전달되지 않음’과 ‘전달 후 연결 실패’를 구분해 두 문제를 혼동하지 않을 수 있습니다.

소스 공개: 문서, 커밋, 라이선스로 프로젝트 살펴보기

Mihomo의 소스 코드, 이슈 토론, 릴리스 기록은 프로젝트 저장소에 공개되어 있으며 코어는 GPL-3.0 오픈소스 라이선스를 사용합니다. 설정 필드의 의미를 확인하려면 현재 프로젝트 문서를 먼저 살펴보고 릴리스 안내에서 지원 여부를 확인하세요. GUI 클라이언트는 라이선스가 서로 다를 수 있고 일부 설정을 별도로 감쌀 수도 있습니다. 같은 코어를 사용한다는 이유만으로 모든 클라이언트의 기능, 라이선스, 플랫폼 지원이 같다고 볼 수는 없습니다.

일반 사용자는 직접 빌드하지 않아도 문서를 읽을 수 있습니다. 개발자나 구현 방식을 살펴보려는 사용자는 아래 명령으로 코어 소스 코드를 가져올 수 있습니다. 이 명령은 코드 저장소만 다운로드하며 클라이언트를 설치하거나 구독을 가져오거나 시스템 네트워크를 변경하지 않습니다. 이슈를 확인할 때는 현재 운영체제, 코어, 오류 메시지와 관련된 내용을 우선 찾아보세요. 성공 화면 하나만으로 다른 기기에서도 같은 설정이 작동한다고 판단할 수는 없습니다.

Mihomo · 소스 코드 저장소
git clone https://github.com/MetaCubeX/mihomo.git

업데이트 순서: 설정을 보관하고 변경 사항 확인

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스, 권한, 설정 관리 방식을 바꿀 수 있습니다. 코어 업데이트는 프로토콜 지원을 추가하거나 일부 필드의 동작을 바꿀 수 있습니다. 구독 업데이트는 주로 서비스 제공자가 전달하는 내용을 교체합니다. 문제가 생기면 최근 변경한 계층이 무엇인지 먼저 기록한 뒤 관련 안내를 찾아보세요. 클라이언트, 구독, 규칙을 한꺼번에 바꾸면 원인을 파악하기 어렵습니다.

업데이트 전에 사용자 지정 규칙과 오버라이드 내용을 저장하고, 클라이언트가 어떤 설정을 보존하는지, 어떤 설정이 구독 업데이트 때 다시 생성되는지 확인하세요. 업데이트 후에는 자주 사용하는 대상 하나에 연결해 규칙과 출구가 연결 기록에 표시되는지 살펴보면 됩니다. 모든 고급 설정을 바로 바꿀 필요는 없습니다. 기존 소프트웨어에서 옮길 계획이라면 새 클라이언트가 단독으로 정상 작동하는지 먼저 확인한 뒤 시작 프로그램과 서비스 모드를 설정하세요. 기존 클라이언트를 종료한 뒤 시스템 프록시도 예상한 상태로 복구됐는지 확인하세요.

설정의 한계: 예시는 문법을 설명할 뿐 완성된 구성을 대신하지 않습니다

이 페이지의 창과 코드는 설정 간 관계를 설명하기 위한 예시이며 설치 직후의 기본 상태나 바로 사용할 수 있는 완성된 프록시 설정이 아닙니다. 규칙 예시에 나온 프록시 그룹은 실제 설정에 있어야 하며, 지리 데이터베이스와 규칙 세트도 사용하는 구성에 맞게 준비해야 합니다. 조각난 설정을 구독 파일 끝에 그대로 붙이면 필드 중복, 들여쓰기 오류, 잘못된 참조가 생길 수 있습니다. 먼저 각 필드의 용도를 이해한 다음 클라이언트가 지원하는 병합 기능을 사용하세요.

구독 링크에는 계정 접근 정보가 포함될 수 있으므로 문제를 확인할 때 공유하는 스크린샷이나 로그에서 해당 정보를 숨기세요. 신뢰할 수 있는 출처에 필요한 정보만 제공하고 전체 설정을 공개 변환 도구에 함부로 업로드하지 마세요. 네트워크 기기를 공유하기 전에는 LAN 연결 허용 범위와 접근 제어도 확인해야 합니다. 규칙 기반 라우팅은 필요한 네트워크 경로를 지정하는 기능이지 서비스 제공자의 이용 규칙을 대신하거나 사용자가 준수해야 하는 관련 법률 및 네트워크 관리 요건을 바꾸는 기능은 아닙니다.

처음 사용한다면 구독 가져오기 및 연결 단계를 먼저 읽어보세요. 이미 연결할 수 있고 설정을 더 조정하려면 처음부터 익히는 사용 설명서를 확인하세요. 첫 번째 가이드는 실제 조작 순서에 따라 설명하고, 두 번째는 개념과 설정 계층을 중심으로 구성해 특정 문제가 생겼을 때 다시 찾아보기 좋습니다.

더 읽어보기

Clash 설정 최신 글

전체 글 보기 →

구독 공유, 출구 선택, 테스트 결과 해석 등 현재 궁금한 내용을 이어서 확인하세요. 글의 설정 방법은 클라이언트의 실제 설정과 함께 적용하면 됩니다. 모든 매개변수를 한 번에 바꿀 필요는 없습니다.

입문 가이드

Clash 노드 선택법: 지연 시간, 트래픽 배수, 지역, 프로토콜 비교

구독에 노드가 길게 나열되어 있을 때 지연 시간, 트래픽 배수, 출구 지역, 프로토콜 유형을 기준으로 고르는 방법과 프록시 그룹 자동 선택이 유용한 상황을 설명합니다. 먼저 접속 목적을 정한 다음 같은 조건에서 성능을 비교하세요.

네트워크 튜닝

Clash 속도 측정값과 실제 체감이 다른 이유: url-test 지연 시간 측정 원리

클라이언트의 지연 시간은 무엇을 측정하는지, 수치가 낮아도 느릴 수 있는 이유를 테스트 주소, 핸드셰이크 과정, 대역폭 차이를 바탕으로 설명하고 측정 결과를 올바르게 해석하는 방법을 안내합니다. 측정값은 참고 자료로 활용하고 실제 접속과 연결 기록으로 문제를 확인하세요.