• mihomo 코어
  • YAML 설정
  • 규칙 분기

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

플랫폼별 클라이언트를 선택하고 구독 가져오기, 규칙 분기, 설정 항목을 확인하세요.

오픈소스 생태계 한국어 문서 설정 참고

CLIENT ROUTES

플랫폼별 Clash 클라이언트 선택

먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일과 사용 안내를 살펴보세요.

설치 파일, 설정, 트래픽 처리 방식은 각각 확인하세요

같은 플랫폼이라고 설치 파일을 서로 바꿔 쓸 수 있는 것은 아닙니다. 데스크톱에서는 프로세서 아키텍처를, 모바일에서는 운영체제 요구 사항을 확인하고, 설치 파일 형식이 운영체제의 설치 방식에 맞는지도 살펴보세요. 처음 사용한다면 GUI 클라이언트에서 설정 페이지로 구독을 가져오고 프록시 페이지에서 정책을 선택한 다음 로그에서 연결 결과를 확인하는 편이 좋습니다. 독립 실행형 코어만 다운로드하면 설정 편집기, 트레이 메뉴, 시스템 프록시 스위치까지 함께 설치되는 것은 아닙니다.

클라이언트는 설정을 읽고 연결을 처리하며, 구독 내용은 설정 제공자가 관리합니다. 설치를 마친 뒤에도 사용할 수 있는 구독 링크나 로컬 설정 파일이 필요합니다. 아무 웹페이지 주소나 구독 주소로 사용하거나, 같은 설정 오류를 해결하려고 클라이언트를 여러 개 반복 설치하지 마세요. 기존 설정을 옮길 수 있는지는 이름이 비슷한 소프트웨어인지가 아니라 대상 코어가 지원하는 필드와 프로토콜, 클라이언트의 오버라이드 방식에 따라 달라집니다.

시스템 프록시, 모바일 VPN, TUN은 트래픽을 처리하는 서로 다른 방식입니다. 데스크톱의 시스템 프록시는 보통 해당 설정을 따르는 앱에만 적용되며, 터미널 도구는 프록시 환경 변수를 별도로 설정해야 할 수 있습니다. TUN은 가상 네트워크 인터페이스, 라우팅, 권한과 관련되므로 기본 연결이 정상인 것을 확인한 뒤 활성화하는 편이 좋습니다. 다운로드 페이지에서 플랫폼별 링크와 설치 안내를 확인하고, 구체적인 선택 기준은 클라이언트 선택 가이드를 참고하세요.

전체 클라이언트 보기 →

CONFIG ROUTEBOOK

규칙, 프록시 그룹, DNS

트래픽이 향하는 경로를 따라 필드 간 관계를 살펴보고 필요한 설정 예시를 확인하세요.

구체적인 규칙을 앞에, 기본 규칙을 뒤에 배치하세요

규칙 모드에서는 파일에 적힌 순서대로 연결을 확인하고, 일치하는 규칙이 있으면 해당 정책을 적용한 뒤 검사를 멈춥니다. 도메인 규칙은 특정 웹사이트에, IP 주소 규칙은 알려진 네트워크 대역에 적합합니다. 두 종류를 함께 쓸 때는 DNS 해석 방식과 적용 범위를 유의하세요. 우선 적용할 구체적인 조건을 먼저 배치하고, 범위가 넓은 지역 규칙을 그다음에 둔 뒤 MATCH로 나머지를 처리하세요. 규칙 대상은 DIRECT, REJECT 또는 이미 정의한 프록시 그룹 이름일 수 있습니다. 문제를 확인할 때는 노드만 반복해서 바꾸기보다 연결 기록에서 실제로 적용된 규칙을 살펴보는 편이 원인을 찾기 쉽습니다.

rules:
  - DOMAIN-SUFFIX,local,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-KEYWORD,github,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy
mihomo코어
GPL-3.0mihomo 오픈소스 라이선스
5개 플랫폼클라이언트 다운로드 지원

설정 예시는 필드 이해를 돕기 위한 것으로, 완전한 구독 설정을 대체하지 않습니다

위 예시는 규칙, 프록시 그룹, DNS의 일부 구조를 각각 보여 주며 실제 프록시 서버는 포함하지 않습니다. 예시를 기존 설정에 넣기 전에 같은 최상위 필드가 이미 있는지 확인하세요. rules나 dns를 중복으로 작성하면 해석 결과가 달라지거나 앞의 내용이 뒤의 내용으로 덮어써질 수 있습니다. YAML은 공백으로 들여쓰기하며 같은 단계의 들여쓰기를 일관되게 유지해야 합니다. 목록 항목과 상위 필드의 관계도 그대로 보존해야 합니다.

클라이언트 화면의 스위치가 원본 구독 파일을 직접 수정하는 것은 아닙니다. 설정에 따라 실행 중에 병합되거나 오버라이드 파일을 통해 적용될 수 있으므로 현재 적용 중인 설정과 로그를 기준으로 확인하세요. 계속 유지해야 하는 규칙은 클라이언트가 공식 지원하는 오버라이드 기능을 우선 사용하세요. 자동 업데이트되는 구독 파일을 직접 편집하면 다음에 가져올 때 변경 내용이 사라질 수 있습니다. 전체 필드 관계와 병합 범위는 설정 종합 가이드에서 확인할 수 있습니다.

SOURCE & MAINTENANCE

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

코어, 클라이언트, 설정 제공자를 구분해 현재 환경에 맞는 자료인지 확인하세요.

프로젝트의 흐름: 이름은 비슷해도 유지 관리 경로는 다릅니다

Clash는 규칙 기반 프록시 프로젝트로 널리 사용되기 시작했고, 이후 설정 형식과 GUI, 여러 코어를 중심으로 생태계가 형성됐습니다. 원본 프로젝트와 일부 초기 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티는 각자의 방향으로 개발을 이어 왔습니다. 검색 결과에 나오는 오래된 가이드는 과거 인터페이스나 구형 코어, 보관 처리된 설치 파일을 기준으로 할 수 있습니다. 제목에 Clash가 들어 있다고 해서 현재도 사용할 수 있다고 판단하지 마세요. 자료를 볼 때는 클라이언트 이름과 사용 코어, 안내에 언급된 기능을 함께 확인해야 합니다.

이 사이트는 유지 관리가 중단된 클라이언트와 현재 선택할 수 있는 경로를 구분해 안내합니다. 다운로드 수나 평점, 확인되지 않은 커뮤니티 규모를 선택 기준으로 내세우지 않습니다. 지원이 끝난 클라이언트는 기존 환경을 이해하거나 데이터를 옮기는 데 참고할 수 있지만, 일상적으로 사용할 제품은 현재도 유지 관리 중이며 운영체제 요구 사항에 맞는지 우선 확인하세요. 마이그레이션 전에 기존 설정과 오버라이드 내용을 보관하고 프록시 프로토콜, 프록시 그룹 참조, 규칙 세트 경로, 시작 설정을 점검하세요. 구독 링크만 옮기고 로컬 맞춤 설정을 빠뜨리지 않도록 주의해야 합니다.

코어와 인터페이스: 연결 기능과 조작 환경의 역할

mihomo는 Clash 생태계에서 지속적으로 개발되는 오픈소스 프록시 코어로, Clash Meta의 개발 흐름을 이어 왔습니다. 코어는 프로토콜 처리, 규칙 매칭, DNS, 네트워크 연결을 담당하고 GUI 클라이언트는 구독 관리, 정책 선택, 로그 확인, 시스템 프록시, 서비스 관리 등의 기능을 제공합니다. 둘의 업데이트 주기는 다를 수 있습니다. 특정 필드의 지원 여부는 Clash라는 이름을 쓰는 모든 클라이언트가 지원한다고 추측하지 말고, 현재 코어 문서와 클라이언트의 통합 방식을 확인하세요.

같은 기능도 인터페이스마다 구현 방식이 다를 수 있습니다. 예를 들어 시작 시 자동 실행이 화면만 열 수도 있고 백그라운드 서비스까지 시작할 수도 있습니다. 기본 창을 닫아도 프록시가 중지되는 대신 창만 숨겨질 수 있습니다. 스위치 이름이 아니라 실제 실행 상태를 확인해야 합니다. 모바일에서는 시스템 VPN 상태와 노드 연결 결과도 구분해야 합니다. 시스템에 VPN 연결 완료로 표시되더라도 트래픽 처리 경로가 만들어졌다는 뜻일 뿐, 대상 웹사이트에 접속할 수 있다는 보장은 아닙니다.

오픈소스 근거: 코드, 라이선스, 변경 기록 확인

mihomo의 코드와 라이선스는 공개 저장소에서 확인할 수 있습니다. GPL-3.0은 해당 프로젝트의 오픈소스 라이선스 조건을 설명하며 모든 GUI 클라이언트나 구독 서비스에도 같은 조건이 적용된다는 뜻은 아닙니다. 소스 코드와 릴리스 노트, 이슈 토론을 읽으면 기능 범위와 알려진 문제를 파악하는 데 도움이 됩니다. 소프트웨어를 사용할 때는 현지 법률과 네트워크 관리 규정, 관련 서비스 약관을 따라야 합니다. 공개된 코드와 실제 실행 설정은 별개의 문제이므로 설정 출처도 꼼꼼히 확인하세요.

이 사이트는 클라이언트와 문서로 연결되는 경로를 안내할 뿐, 소개된 모든 프로젝트를 대표하지 않으며 프록시 서버 계정이나 구독 서비스도 제공하지 않습니다. 구독 링크에는 접속 정보가 포함될 수 있으므로 로그나 스크린샷을 공유할 때 URL 매개변수, 계정, 서버 주소 등 민감한 정보는 가리세요. 문제가 생기면 운영체제, 클라이언트 이름, 작업 단계, 오류 메시지 일부를 설명하면 진단에 도움이 됩니다. 다만 전체 구독 설정을 토론 게시판에 공개해서는 안 됩니다.

업데이트 방식: 클라이언트, 코어, 구독을 따로 관리

클라이언트 업데이트는 보통 인터페이스와 통합 구성 요소에 영향을 주고, 코어 업데이트는 프로토콜 지원이나 필드 동작을 바꿀 수 있습니다. 구독 업데이트는 설정 제공자가 배포한 노드와 규칙 내용을 교체합니다. 이 세 가지 업데이트를 구분해서 이해하세요. 구독 업데이트에 성공했다고 클라이언트까지 업데이트된 것은 아닙니다. 새 클라이언트를 설치해도 기존 구독에 새 기능이 자동으로 추가되는 것은 아닙니다. 업그레이드 전에 변경 사항을 읽고 현재 사용 가능한 설정을 백업하며 로컬 오버라이드 위치를 기록해 두면 차이가 생겼을 때 항목별로 비교할 수 있습니다.

업데이트 후 문제가 생기면 먼저 설정이 정상적으로 로드됐는지 확인하고, 규칙 대상과 프록시 그룹 참조를 살펴본 다음 DNS, 포트, 트래픽 처리 방식의 변화를 비교하세요. 모든 설정을 한꺼번에 바꾸면 어떤 변경이 결과에 영향을 줬는지 파악하기 어렵습니다. 다운로드 페이지에서는 클라이언트를, 가이드 페이지에서는 첫 연결 절차를, 설정 종합 가이드에서는 각 필드를 확인할 수 있습니다. 이 순서대로 살펴보면 설치, 설정, 네트워크 문제를 구분하기 쉽습니다.

METACUBEX / MIHOMO

mihomo 소스 코드 보기

저장소를 복제하면 코드와 프로젝트 안내를 살펴볼 수 있지만, GUI 클라이언트가 설치되거나 프록시 구독이 생성되지는 않습니다.

프로젝트 저장소 열기 ↗
git clone https://github.com/MetaCubeX/mihomo.git

첫 연결 점검 순서

먼저 설정 페이지에서 구독이 다운로드됐고 현재 설정으로 선택되어 있는지 확인하세요. 목록에 기록이 있는 것만으로는 충분하지 않습니다. 다음으로 프록시 페이지에서 규칙이 참조하는 프록시 그룹에 사용할 수 있는 대상이 있는지 확인하고, 규칙 모드를 선택한 뒤 현재 기기에 맞는 트래픽 처리 방식을 활성화하세요. 접속할 사이트를 하나 정해 연결 기록의 도메인, 적용 규칙, 최종 출구를 확인합니다. 로그에 해당 연결이 전혀 없다면 노드가 고장 났다고 단정하지 말고 먼저 앱의 트래픽이 클라이언트를 거치는지 확인하세요.

일부 웹사이트에만 접속할 수 있다면 실패한 요청과 성공한 요청의 차이를 비교하세요. DNS 해석 단계에서 오류가 났는지, 연결이 된 뒤 시간 초과가 발생했는지, 같은 프록시 그룹 전체가 실패하는지, 특정 규칙만 잘못된 대상으로 연결하는지 살펴보세요. 지연 시간 테스트는 특정 조건에서의 연결 상태를 참고하는 지표일 뿐 실제 서비스 요청을 대신하지는 않습니다. 빠른 시작 가이드에 따라 기본 설정을 마친 다음 TUN, 사용자 지정 DNS, 시작 시 자동 실행 등을 하나씩 활성화하면 문제를 추적하기 쉽습니다.

자주 묻는 질문과 문제 해결

Clash 구독 링크를 가져왔는데도 연결되지 않는 이유는 무엇인가요?

먼저 설정이 활성화됐는지 확인한 다음 프록시 그룹 선택, 실행 모드, 시스템 프록시를 점검하세요. 가져오기가 완료됐다는 것은 설정을 읽었다는 뜻일 뿐입니다. 첫 연결 단계 보기 →

Clash로 인터넷에 접속할 수 없을 때 DNS부터 바꿔야 하나요?

먼저 요청이 클라이언트에 도달하는지 확인한 뒤 DNS 해석 실패와 연결 실패를 구분하세요. 여러 필드를 한꺼번에 바꾸지 않는 것이 좋습니다. 문제 해결 질문과 답변 보기 →

규칙 모드와 전역 모드는 어떻게 다른가요?

규칙 모드는 규칙에 따라 연결 경로를 선택하고, 전역 모드는 전역 정책을 사용하며, 직접 연결 모드는 프록시 없이 연결합니다. 모드를 바꾼다고 트래픽 처리 방식까지 바뀌는 것은 아닙니다. 모드별 차이 보기 →

로컬 규칙이 구독 업데이트로 바뀌지 않게 하려면 어떻게 해야 하나요?

클라이언트가 지원하는 오버라이드나 병합 기능을 사용하고 생성된 실행 설정을 확인하세요. 자동으로 다운로드되는 원본 파일만 직접 수정하지 마세요. 오버라이드와 병합 안내 보기 →

READING NOTES

Clash 설정 및 사용 가이드

설정 구조, 인터페이스 메뉴, 프록시 모드를 더 살펴보세요.