LINUX 데스크톱 클라이언트 · MIHOMO 코어

Clash for Linux 클라이언트 다운로드.

Clash 다운로드 사용 가이드 보기

Linux 데스크톱에서 클라이언트 설치, 구독 관리, 규칙 분기를 시작하세요.

오픈 소스 한국어 설정 가이드 규칙 분기 rules
기기별 선택
Windows Android iOS macOS Linux

데스크톱에서 자주 쓰는 설정 5가지

Clash Linux 기능과 선택 기준.

GUI 클라이언트는 버튼과 설정 목록, 데스크톱 연동을 담당하고 코어는 연결을 처리합니다. 실제 사용 상황에 따라 설정이 무엇을 바꾸는지 먼저 확인한 뒤 필요한 기능만 켜세요. 모든 옵션을 한꺼번에 활성화할 필요는 없습니다.

TUN 모드와 연결 가로채기

브라우저는 인터넷에 연결되는데 터미널이나 다른 앱은 같은 경로를 이용하지 않는다면, 먼저 해당 앱이 시스템 프록시를 따르는지 확인하세요. TUN 모드는 가상 네트워크 인터페이스로 더 많은 연결을 처리하므로 트래픽을 통합 관리해야 하는 데스크톱 환경에 적합하지만, 서비스 설치나 추가 권한이 필요한 경우가 많습니다. 활성화하기 전에 일반 시스템 프록시가 정상 작동하는지 확인하고, 라우팅과 DNS를 하나씩 점검하면 문제가 생겨도 이전 상태로 되돌리기 쉽습니다. 브라우저만 사용한다면 시스템 프록시로 충분한 경우가 많습니다. 다른 VPN이나 컨테이너 네트워크를 함께 사용한다면 라우팅이 겹치지 않는지 살펴보세요.

tun.enable · tun.auto-route · dns.enhanced-mode

규칙 분기와 매칭 순서

규칙 모드는 모든 연결을 같은 출구로 보내는 방식이 아닙니다. 설정에 적힌 순서대로 규칙을 확인하며 도메인, 주소, 규칙 세트 등을 기준으로 매칭한 뒤 지정된 정책 그룹으로 연결합니다. 일상적인 사용에서는 로컬 네트워크 서비스는 직접 연결하고 나머지는 용도별로 분기할 수 있습니다. 규칙 제공기를 이용하면 큰 규칙 목록을 별도로 관리할 수 있지만, 클라이언트가 해당 설정 항목을 지원해야 합니다. 규칙을 조정할 때는 연결 목록에서 어떤 규칙이 적용됐는지 먼저 확인한 뒤 순서를 바꾸세요. 문제를 찾기 위해 전역 모드로 전환할 수는 있지만, 규칙 분기 설정을 대신할 수는 없습니다.

rules · rule-providers · proxy-groups

시스템 트레이와 로그인 시 자동 시작

창 닫기, 클라이언트 종료, 백그라운드 코어 중지는 서로 다른 동작입니다. 시스템 트레이를 지원하는 클라이언트는 창을 닫은 뒤에도 계속 실행할 수 있고 현재 모드를 쉽게 확인할 수 있습니다. Linux 데스크톱에서 트레이 아이콘이 표시되는지는 데스크톱 환경과 확장 기능에 따라 달라지므로 아이콘이 사라져도 코어가 종료된 것은 아닐 수 있습니다. 로그인 시 자동 시작을 설정했다면 다시 로그인해 구독이 불러와지는지, 서비스 권한이 유지되는지 확인한 뒤 시스템 프록시 상태도 점검하세요. 서비스를 직접 관리해야 한다면 코어가 중복 실행되지 않도록 주의하세요. 포트 충돌이 발생할 수 있습니다.

external-controller · mixed-port

구독 업데이트와 로컬 오버라이드

구독 링크는 설정을 가져오는 데 사용하고, 클라이언트의 자동 업데이트 기능은 지정한 간격에 따라 설정을 다시 불러옵니다. 노트북이 절전 모드인 동안에는 예약 작업이 실행되지 않는 경우가 많으며, 깨어난 뒤 업데이트를 보충하는지는 클라이언트 구현에 따라 다릅니다. 네트워크를 자주 바꾸는 기기라면 먼저 수동 업데이트를 실행해 결과를 확인한 다음 적절한 주기를 설정하세요. 원격 설정을 직접 수정하면 다음 업데이트 때 덮어써질 수 있으므로 로컬 규칙, 포트, 정책 변경은 클라이언트가 지원하는 오버라이드 기능에 넣는 편이 좋습니다. Profile을 바꾸기 전에 기존 설정을 보관하고 현재 클라이언트에만 적용되는 옵션도 기록해 두세요.

proxy-providers · update-interval

mihomo 코어와 GUI

GUI에 특정 프로토콜 이름이 표시된다고 해서 현재 코어가 이를 처리할 수 있다는 뜻은 아닙니다. 실제 지원 여부는 포함된 코어와 설정 항목에 따라 달라집니다. mihomo는 Clash Meta의 프로젝트 흐름을 이어 프로토콜, 규칙, TUN 기능 등을 계속 발전시키고 있습니다. 클라이언트를 고를 때는 구독을 가져올 수 있는지뿐 아니라 서비스 권한, 로그, 업데이트 메뉴가 명확한지도 살펴보세요. 기존 Clash 설정은 마이그레이션의 출발점으로 활용할 수 있지만 새 설정 항목이 구형 클라이언트와 호환되지 않을 수 있습니다. 전체 설정을 한 번에 옮기기보다 최소 설정으로 먼저 실행한 뒤 규칙 세트를 차례로 추가하면 문제를 찾기 쉽습니다.

proxies · log-level · external-controller

기능을 켜기 전에 설치 패키지부터 확인하세요

운영체제별 Clash 클라이언트 선택.

같은 구독을 여러 기기에서 사용할 수 있지만 권한 부여 방식, 설치 패키지, 백그라운드 실행 방식은 운영체제마다 다릅니다. 다운로드 페이지에서 시스템에 맞는 클라이언트를 확인하세요. 데스크톱에서는 먼저 프로세서 아키텍처를, 모바일에서는 운영체제 버전을 확인하면 됩니다. 사용과 유지 관리가 편한 클라이언트를 고른 다음 인터페이스를 비교하세요.

Windows

Clash Plus부터 비교한 뒤 Clash Verge Rev, FlClash 등도 살펴볼 수 있습니다. 스토어 앱의 연결까지 처리해야 한다면 시스템 프록시와 루프백 접근은 별개라는 점을 알아두세요. 노드만 계속 바꾸는 것으로 해결되지 않습니다. 설치 전 시스템 아키텍처를 확인하고 기존 클라이언트를 옮길 때는 이전 코어를 종료해 수신 포트 충돌을 방지하세요.

다운로드 페이지로 이동 →

macOS

Apple Silicon 또는 Intel에 맞는 설치 패키지를 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 인터페이스의 특징이 다르므로 메뉴 막대 조작 방식과 서비스 설치 방법도 확인하세요. 처음 실행할 때 시스템 권한 안내가 나타나면 내용을 먼저 읽어보세요. 프록시 사용에 모든 권한이 필요한 것은 아닙니다.

다운로드 페이지로 이동 →

Android

사용 방식에 따라 Clash Plus, Clash Meta for Android, FlClash 중에서 선택할 수 있습니다. 연결을 시작할 때 요청하는 VpnService 권한은 로컬 가상 인터페이스를 만드는 데 사용하며, 일반적으로 다른 VPN과 동시에 사용할 수 없습니다. 연결이 잠시 후 끊긴다면 앱을 바로 재설치하기보다 배터리 절약 설정과 백그라운드 제한부터 확인하세요.

다운로드 페이지로 이동 →

iOS

Clash Plus는 App Store에서 설치할 수 있으며 공식 웹사이트는 clashplus.io입니다. 설정을 가져온 뒤 시스템 안내에 따라 VPN 구성을 승인하고 클라이언트로 돌아와 정책을 선택하세요. 모바일 데이터와 Wi-Fi를 전환한 뒤 문제가 생기면 연결 상태와 해당 설정이 계속 선택되어 있는지 먼저 확인하세요.

다운로드 페이지로 이동 →

Linux

GUI 데스크톱 클라이언트로는 Clash Verge Rev와 FlClash를 우선 비교할 수 있습니다. Debian·Ubuntu 계열은 DEB 패키지부터 확인하고, RPM 계열은 해당 패키지가 제공되는지 살펴보세요. 설치 후에는 프로그램 실행, 코어 시작, 시스템 프록시 적용 여부를 각각 확인하세요. 트레이 아이콘만 보는 것보다 세 단계를 따로 점검하는 편이 정확합니다.

다운로드 페이지로 이동 →

전체 클라이언트 보기 →

첫 연결은 이 순서로 진행하세요

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

클라이언트에는 사용할 수 있는 프록시 서비스가 포함되어 있지 않습니다. 사용할 권한이 있는 구독이나 로컬 설정을 준비한 다음 아래 순서대로 진행하세요. 처음에는 꼭 필요한 옵션만 변경하고 정상 작동하는 기준 상태를 남겨 두세요. 이후 TUN을 켜거나 규칙을 추가할 때 비교 기준으로 쓸 수 있습니다.

  1. 설정을 가져와 선택 상태 확인

    구독 또는 설정 화면에 링크를 붙여 넣거나 로컬 YAML 파일을 가져오세요. 다운로드와 구문 분석이 끝나면 설정이 목록에 표시되는지 확인하고 현재 설정으로 지정하세요. 가져오기에 성공했다고 해서 사용 설정까지 완료된 것은 아닙니다. 프록시 그룹이 비어 있다면 구독 내용이 완전한지, 현재 코어에 맞는 형식인지 확인하세요.

    구독 링크에는 접근 자격 증명이 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 도움을 요청할 때는 링크 전체가 보이지 않도록 가리고 공개 게시판에 올리지 마세요. 업데이트에 실패하면 먼저 오류 내용을 확인해 링크 만료, 네트워크 요청 실패, 설정 문법 오류를 구분하세요.

  2. 규칙 모드와 정책 선택

    먼저 규칙 모드를 사용하고 프록시 그룹에서 이용 가능한 정책을 선택한 다음 시스템 프록시를 켜세요. 속도 테스트는 현재 테스트 대상의 응답 상태를 파악하는 데 도움이 되지만 모든 웹사이트의 실제 사용 경험을 보여주지는 않습니다. 정책을 고른 뒤 자주 쓰는 서비스도 직접 열어 확인하세요. 한 번의 테스트에서 모드, DNS, 노드를 동시에 바꾸면 어떤 변경이 영향을 줬는지 판단하기 어렵습니다.

    브라우저는 정상인데 다른 앱이 연결되지 않을 때 앱의 프록시 설정이나 TUN 처리 범위를 확인하세요. 관리자 권한이 필요한 작업은 따로 점검해 서비스 설치 실패를 구독 문제로 오해하지 않도록 하세요.

  3. 연결을 확인하고 정상 설정 보관

    확인하려는 서비스를 열고 클라이언트의 연결 목록에서 도메인, 적용된 규칙, 연결 출구를 확인하세요. 로그에 오류가 있다면 발생 시각과 직전 작업을 기록하세요. 속도 테스트 결과만 달라졌다고 클라이언트 오류라고 단정할 수는 없습니다. 확인을 마친 뒤 로컬 오버라이드를 백업하고 구독 업데이트 주기와 로그인 시 자동 시작을 설정하세요.

    테스트를 마치면 시스템 프록시를 끄고 일반 연결이 복구됐는지 확인하세요. Linux에서 터미널 환경 변수를 수정했다면 별도로 되돌려야 합니다. 데스크톱의 프록시 스위치를 꺼도 셸에 설정된 프록시 변수는 자동으로 삭제되지 않습니다.

전체 사용 가이드 보기 →

프로젝트 관계와 유지 관리 범위

오픈 소스 Clash 생태계와 mihomo.

클라이언트는 인터페이스만 보고 선택하기 어렵습니다. 설정을 해석하는 구성 요소, 데스크톱 서비스를 관리하는 주체, 업데이트 출처를 알아두면 기기를 바꾸거나 기존 설정을 옮길 때 시행착오를 줄일 수 있습니다. 이 사이트에서는 다운로드 경로와 사용 정보를 정리하며, 클라이언트와 코어는 각 프로젝트에서 관리합니다.

원본 Clash에서 mihomo까지

Clash는 설정 파일, 정책 그룹, 규칙 분기를 중심으로 사용하는 방식을 정립했고 이를 바탕으로 여러 GUI 클라이언트가 등장했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤 커뮤니티에서는 다양한 방향으로 개발을 이어갔습니다. Clash Meta는 이후 mihomo라는 이름으로 발전했으며, 현재도 유지 관리되는 여러 클라이언트가 이를 코어로 채택하고 있습니다. 다만 클라이언트마다 코어 업데이트 주기는 다를 수 있습니다.

따라서 이름에 Clash가 들어간다고 기능까지 모두 같은 것은 아닙니다. 특정 프로토콜 지원 여부는 현재 코어의 기능을, 트레이·단축키·오버라이드 지원 여부는 GUI 클라이언트를 확인해야 합니다. 두 구성 요소의 역할을 나누어 보면 같은 설정이 클라이언트에 따라 다르게 작동하는 이유도 이해하기 쉽습니다.

오픈 소스 코드와 설정 호환성

mihomo의 소스 코드와 프로젝트 문서는 공개되어 있습니다. 일반 데스크톱 사용자에게 오픈 소스의 실질적인 장점은 설정 항목을 추적하고 이슈 논의를 살펴보며 기능의 지원 범위를 확인할 수 있다는 점입니다. 누구나 소스에서 직접 빌드해야 한다는 뜻은 아닙니다. GUI 클라이언트를 설치한 뒤에는 해당 클라이언트가 제공하는 코어와 서비스 관리 방식을 사용하세요. 여러 방식을 섞으면 문제를 찾기 어려워질 수 있습니다.

설정을 옮기기 전 기존 설정의 사본을 보관한 뒤 프로토콜 유형, 규칙 세트 참조, DNS 설정을 확인하세요. 클라이언트 전용 스크립트나 오버라이드는 구독 파일에 포함되지 않을 수 있으므로 링크 하나만 복사했다고 모든 설정이 이전된 것은 아닙니다. 코어 계열과 프로토콜 선택에 관해서는 기술 참고 자료의 코어 설명도 확인하세요.

업데이트 전후에 확인할 항목

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 유지 관리 경로입니다. 클라이언트 업데이트는 인터페이스와 시스템 연동을 바꿀 수 있고, 코어 업데이트는 설정 항목의 동작을 조정할 수 있으며, 구독 업데이트는 노드·정책 그룹·규칙을 교체할 수 있습니다. 변경 사항이 생기면 먼저 어느 부분이 업데이트됐는지 확인한 뒤 로그와 설정을 대조하세요. 문제를 하나의 스위치 탓으로 돌릴 필요는 없습니다.

평소 정상 작동하는 설정과 오버라이드를 기록해 두세요. 업데이트 후에는 자주 쓰는 서비스를 확인하고 로컬 네트워크 접근, 절전 후 복귀, 네트워크 전환도 점검하세요. 클라이언트를 자주 바꾸기보다 복원 가능한 설정을 보관하는 편이 장기적인 안정성에 도움이 됩니다. 보관된 클라이언트는 이전 자료를 참고할 때 활용할 수 있습니다.

mihomo 소스 코드 보기

아래 명령은 공개 저장소를 로컬에 복제할 뿐 프로그램을 설치하거나 서비스를 시작하지 않습니다. 일반 사용자는 GUI 클라이언트를 이용하면 됩니다. 구현을 살펴보거나 개발에 참여하려는 경우에만 Git과 빌드 환경을 준비하세요.

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

설정 기록과 플랫폼 팁

최근 사용 가이드.

기본 연결을 마쳤다면 여러 설정 전환, 백그라운드 실행, 클라이언트 선택을 살펴보세요. 아래 글은 최신 글부터 정렬했으며 작업 방법과 선택 기준을 함께 담아 관련 문제가 생길 때 찾아보기 편합니다.

전체 글 보기 →