첫 실행 체크리스트mihomo / Clash

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

Clash 다운로드 빠른 시작 보기

기기에 맞는 설치 파일을 선택한 다음 구독 가져오기, 규칙 분기, 시스템 프록시를 설정하세요. 코어 설정을 변경하려면 고급 설정 가이드를 참고하세요.

영구 무료오픈 소스한국어 설정 안내

사용 중인 기기에 맞는 플랫폼 선택

Windows Android iOS macOS Linux
설정 전후 비교

직접 설정하다 보면 어디서 막힐까요?

설정 파일, 수신 대기 포트, 분기 규칙은 각각 다른 트래픽을 처리합니다. 문제가 어느 단계에서 생겼는지 먼저 확인한 뒤 해당 설정만 바꾸면, 노드를 계속 바꾸는 것보다 원인을 찾기 쉽습니다.

YAML을 직접 작성하면 필드를 빠뜨리기 쉽습니다

노드, 정책 그룹, 규칙을 처음부터 구성할 때는 들여쓰기와 필드명이 코어 문법에 맞아야 합니다. 설정을 불러오지 못한다고 구독 링크가 반드시 잘못된 것은 아닙니다. 먼저 클라이언트의 설정 오류 메시지를 확인하고 파일 구조를 살펴보세요.

포트 설정과 시스템 프록시가 일치하지 않습니다

설정에서 mixed-port를 지정했는데 시스템 프록시가 다른 포트를 가리키면 브라우저가 프록시를 거치지 않고 연결하거나 오류가 날 수 있습니다. 수신 대기 포트를 바꿨다면 운영체제의 프록시 주소도 함께 확인하세요.

규칙은 있는데 예상대로 트래픽이 분기되지 않습니다

규칙 모드는 위에서부터 순서대로 요청을 확인합니다. 앞쪽의 범위가 넓은 규칙이 요청을 먼저 처리할 수 있습니다. 규칙이 가리키는 정책 그룹 이름과 클라이언트가 현재 규칙 모드인지도 확인하세요.

클라이언트 초기 설정 후 항목별로 점검

일상적인 켜기·끄기는 인터페이스에서, 재사용할 규칙은 설정 파일에서 관리합니다. 두 가지를 함께 활용하세요. 먼저 클라이언트에서 연결을 확인한 뒤 필요한 YAML 설정만 수정하고, 처음부터 모든 옵션을 한꺼번에 바꾸지는 마세요.

‘설정’에서 구독 가져오기

서비스 제공자가 안내한 구독 주소를 붙여 넣고 설정이 정상적으로 로드됐는지 확인한 다음 ‘프록시’에서 정책 그룹을 선택하세요. 가져오기에 성공했다는 것은 클라이언트가 설정을 읽었다는 뜻일 뿐, 시스템 트래픽이 프록시를 통과한다는 의미는 아닙니다.

수신 대기 포트와 시스템 프록시 맞추기

먼저 설정의 혼합 포트는 그대로 두고 클라이언트에서 시스템 프록시를 켜세요. 다른 프로그램이 포트를 사용 중이라면 포트를 변경한 뒤 프록시 주소도 함께 업데이트해야 클라이언트와 시스템의 포트가 일치합니다.

규칙 모드에서 트래픽 경로 확인하기

규칙 모드로 전환한 뒤 연결 기록에서 대상 도메인에 어떤 규칙이 적용됐고 어느 정책 그룹으로 연결됐는지 확인하세요. 특정 앱에만 트래픽이 표시되지 않을 때 TUN 모드 사용을 검토하면 됩니다.

config.yaml구조 예시
mixed-port: 7890
mode: rule
proxy-groups:
  - name: 직접 선택
    type: select
    proxies:
      - DIRECT
설정 항목 빠르게 보기

구독부터 트래픽 분기까지, 용도별 설정 찾기

왼쪽에서 주제를 선택해 구체적인 설정 방법을 확인하세요. 아래 예시는 필드 간 관계를 보여 주며, 실제 노드와 구독 내용은 사용 중인 설정을 기준으로 해야 합니다.

설정 / profiles

완전한 설정인지 먼저 확인하세요

클라이언트의 ‘설정’ 탭에서 구독 주소를 붙여 넣고 가져오기를 실행하세요. 설정이 목록에 표시되면 현재 설정으로 지정합니다. 일반적인 전체 YAML에는 노드, 정책 그룹, 규칙이 함께 포함됩니다. 노드 목록만 제공하는 링크라면 서비스 제공자에게 Clash 호환 형식이 있는지 문의해야 할 수 있습니다. 구독을 업데이트하기 전에 현재 선택된 설정을 기록해 두고, 업데이트 후 정책 그룹이 정상적으로 표시되는지 확인하세요. 구독 주소는 비공개 정보이므로 로그 캡처나 공개 문의 게시물에 올리지 마세요. 설정을 가져온 다음 시스템 프록시를 켜면 설정 문제와 네트워크 트래픽 처리 문제를 따로 점검할 수 있습니다.

메뉴 위치첫 실행
설정 → 구독 링크 가져오기 → 현재 설정으로 지정
프록시 → 정책 그룹 선택

매개변수별 설명이 필요하면 고급 설정 가이드 →를 확인하세요. 규칙 세트, 정책 그룹, DNS, TUN, 로컬 재정의를 각각 다루므로 첫 실행 때 전부 설정할 필요는 없습니다.

설치

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

먼저 운영체제를 선택한 다음 다운로드 페이지에서 같은 플랫폼의 클라이언트를 비교하세요. 설치 파일 형식, CPU 아키텍처, 권한 요구 사항은 대상 기기에 맞춰 확인해야 합니다. 코어만 필요한 서버나 라우터 사용자는 다운로드 페이지의 mihomo 섹션을 확인하세요.

전체 클라이언트 보기 →

Windows

기기 아키텍처와 시스템 요구 사항을 확인한 다음 클라이언트 카드에서 설치 파일을 선택하세요. 설치 후 ‘설정’에서 구독을 가져오고 시스템 프록시가 켜져 있는지 확인합니다. 일부 앱이 계속 직접 연결된다면 시스템 프록시 설정을 따르는 앱인지 먼저 확인하세요.

Windows 다운로드 →

macOS

Apple Silicon과 Intel 기기에 맞는 설치 파일을 선택하세요. 클라이언트를 처음 실행할 때 시스템 안내에 따라 권한을 허용합니다. 메뉴 막대에 연결됨으로 표시되는데도 브라우저가 프록시를 사용하지 않는다면 클라이언트에서 현재 설정과 시스템 프록시 상태를 확인하세요.

macOS 다운로드 →

Android

설정을 가져온 뒤 시스템 팝업에 따라 VpnService 권한을 허용해야 클라이언트가 기기에 VPN 인터페이스를 만들 수 있습니다. 화면을 잠근 뒤 연결이 자주 끊긴다면 구독을 반복해서 삭제하지 말고 배터리 최적화, 자동 시작, 백그라운드 실행 권한을 확인하세요.

Android 다운로드 →

iOS

다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동하세요. 설치 후 앱 안내에 따라 설정을 가져오고, 처음 연결할 때 시스템 VPN 권한을 허용합니다. 규칙이나 정책 그룹을 바꾸려면 클라이언트 화면에서 설정하세요.

iOS 다운로드 →

Linux

데스크톱 사용자는 GUI 클라이언트의 배포 패키지 형식을 비교하고, 서버나 라우터 사용자는 독립 코어를 확인하세요. 설치 전에 배포판, 프로세서 아키텍처, 실행 방식을 확인하고 설정 파일을 읽고 쓸 수 있는 경로를 준비하세요.

Linux 다운로드 →

하나의 구독이 모든 클라이언트에서 작동하는 것은 아닙니다. 먼저 서비스 제공자가 제공하는 설정 형식을 확인하고, 대상 클라이언트가 해당 프로토콜과 규칙 문법을 지원하는지 살펴보세요. 기기를 바꿀 때는 해당 기기의 네트워크 권한과 시스템 프록시 설정도 다시 확인해야 합니다.

오픈 소스 생태계와 설정 기준

클라이언트, 코어, 설정의 관계 이해하기

Clash는 규칙 기반 프록시 도구 생태계를 가리키는 이름입니다. GUI 클라이언트는 설정 가져오기, 전환, 연결 확인을 위한 인터페이스를 제공하고, 코어는 설정을 해석하고 연결을 만들며 규칙을 실행합니다. 설치 파일을 선택할 때는 운영체제를 확인한 뒤 코어가 지원하는 설정 문법을 살펴보세요.

프로젝트 발전 과정

기존 Clash, Clash Meta, 이후의 mihomo는 각각 유지 관리 단계가 다릅니다. 화면에 비슷한 이름이 표시되더라도 같은 코어를 사용한다고 볼 수는 없습니다. 새로운 프로토콜, 규칙 유형, DNS 매개변수는 특정 코어에서만 지원될 수 있습니다. 설정을 불러오는 중 오류가 발생하면 앱 이름만으로 호환성을 판단하지 말고, 클라이언트에 표시된 코어와 구독에 사용된 문법을 먼저 확인하세요.

코드와 라이선스

mihomo는 오픈 소스 코어로 공개된 소스 코드와 라이선스 정보를 제공합니다. GPL-3.0은 소프트웨어의 사용, 수정, 재배포 조건을 설명하며 노드 서비스 제공을 보장하지 않습니다. GUI 클라이언트를 선택할 때는 해당 클라이언트 프로젝트의 안내도 별도로 확인하세요. 코어가 오픈 소스라는 사실과 GUI 클라이언트의 유지 관리 상태는 별개의 문제입니다.

설정 관리 범위

클라이언트는 설정을 읽고 상태를 표시하며, 구독 내용은 일반적으로 사용 중인 서비스 제공자가 관리합니다. 구독은 가져왔지만 노드를 사용할 수 없다면 설정 업데이트 시각, 정책 그룹 옵션, 연결 기록을 확인하세요. 클라이언트 설치에 실패했다면 패키지 형식과 시스템 요구 사항을 점검해야 합니다. 두 문제를 구분하면 해결 과정을 더 명확하게 정리할 수 있습니다.

업데이트 후 확인할 항목

클라이언트를 업데이트하기 전에 사용 중인 설정과 주요 로컬 재정의를 기록해 두세요. 업데이트 후에는 먼저 코어가 시작되는지 확인하고, 구독, 정책 그룹, 규칙 모드, 시스템 프록시를 점검합니다. 코어를 바꾸거나 유지 관리가 오래 중단된 버전으로 이동했다면 기존 설정의 규칙 제공자, DNS, TUN 필드를 특히 확인하세요. 기존 설정이 항상 호환된다고 가정하지 마세요.

mihomo 소스 코드 보기git clone https://github.com/MetaCubeX/mihomo.git

명령 복사는 공개 소스 코드를 로컬에서 확인할 때만 사용하며 GUI 클라이언트 설치에는 필요하지 않습니다. 일반 사용자는 설치 파일 페이지에서 기기에 맞는 클라이언트를 선택하면 됩니다. 규칙이나 DNS를 수정해야 한다면 고급 설정 가이드를 참고해 항목별로 설정하세요.

첫 실행 시 자주 묻는 질문

연결 전에 확인할 항목

설정 로드, 트래픽 처리, 규칙 적용 순서로 점검하세요. 한 번에 하나의 설정만 변경해야 어떤 변경이 연결에 영향을 줬는지 파악하기 쉽습니다.

전체 가이드 보기 →
구독을 가져왔는데 브라우저가 계속 직접 연결되는 이유는 무엇인가요?

가져오기는 설정을 불러오는 단계일 뿐입니다. 해당 설정이 현재 설정으로 지정됐는지 확인한 다음 규칙 모드와 정책 그룹을 선택하고 시스템 프록시를 켜세요. 이어서 연결 기록에 브라우저 요청이 표시되는지 확인합니다. 기록이 없다면 시스템 프록시 스위치와 포트를 먼저 점검하세요. 가이드에 따라 차례로 확인하기 →

규칙 모드와 전역 모드 중 무엇을 먼저 선택해야 하나요?

일상적인 사용에는 설정의 규칙에 따라 요청을 처리하는 규칙 모드를 선택하세요. 전역 모드는 문제를 비교해 볼 때 잠시 사용할 수 있습니다. 전역 모드에서는 정상인데 규칙 모드에서 예상대로 작동하지 않는다면 규칙 순서와 정책 그룹 이름을 확인하세요. 테스트가 끝나면 원하는 모드로 되돌리세요. 모드 전환 방법 보기 →

mixed-port를 바꾼 뒤 프로그램이 연결되지 않는 이유는 무엇인가요?

새 포트를 다른 프로그램이 사용 중인지 확인하고 운영체제나 앱의 프록시 주소가 이전 포트를 계속 가리키는지도 살펴보세요. 설정 파일을 수정한 뒤에는 클라이언트를 다시 로드해야 합니다. YAML만 바꾸고 시스템 프록시를 업데이트하지 않으면 두 설정이 일치하지 않습니다. 연결 점검 단계로 돌아가기 →

TUN 모드는 언제 켜야 하나요?

먼저 시스템 프록시로 기본 연결을 확인하세요. 대상 앱이 시스템 프록시를 따르지 않고 더 많은 트래픽을 처리해야 하는 경우에만 클라이언트 안내에 따라 TUN 사용에 필요한 시스템 권한을 허용하세요. 켠 뒤 LAN 접근에 문제가 생기면 라우팅과 DNS 설정을 각각 확인합니다. TUN 설정 안내 보기 →

활용 팁

궁금한 주제 더 읽기

아래 글은 게시일 순으로 정리했습니다. 구독 형식, Android 백그라운드 연결, 코어 선택 등 첫 설정 후 자주 이어지는 문제를 다룹니다.

전체 글 보기 →