• mihomo 코어 · Linux 배포

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

Clash 다운로드 가이드 보기

config.yaml부터 TUN 투명 프록시까지, 단계별로 systemd 상시 실행 서비스를 설정하세요.

  • 오픈 소스 코드
  • 규칙 기반 라우팅
  • 한국어 설정 항목 안내

01 / CLIENT DOWNLOADS

Clash 클라이언트 다운로드

데스크톱에서는 GUI 클라이언트를, 서버와 라우터에서는 아키텍처에 맞는 mihomo 코어를 선택하세요.

클라이언트는 구독 관리와 GUI 조작, 시스템 연동을 담당하고 코어는 연결과 규칙 실행을 처리합니다. 먼저 운영체제, CPU 아키텍처, 설치 패키지 형식을 확인한 뒤 해당 설치 절차를 살펴보세요. 기존 설정이 있다면 가져오기 전에 백업해 로컬 규칙이 덮어쓰이지 않도록 하세요.

Windows

Clash Plus, Clash Verge Rev 등에서 클라이언트를 선택하세요. 처음 연결할 때는 시스템 프록시를 설정한 뒤 브라우저가 같은 포트를 사용하는지 확인하세요. 다른 앱의 트래픽까지 처리해야 한다면 TUN과 서비스 권한을 설정하세요.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. Clash macOS 다운로드 페이지에서 GUI 클라이언트와 아카이브 프로젝트를 확인할 수 있습니다. ClashX Meta 다운로드 안내를 볼 때는 유지보수 상태와 현재 macOS 버전의 호환성을 확인하세요.

다운로드 페이지로 이동

Android

기기 아키텍처에 맞는 Android 설치 파일을 선택하세요. 처음 실행할 때 시스템 VPN 권한을 허용하고, 연결 후 백그라운드 실행 제한을 확인하세요. 앱을 전환한 뒤 프록시 연결이 끊긴다면 구독을 반복해서 가져오기보다 배터리 최적화와 백그라운드 활동 설정을 먼저 살펴보세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인하세요. 설치 후 호환되는 설정을 가져오고 시스템 안내에 따라 VPN 구성을 추가하세요. 규칙과 정책 그룹의 지원 여부는 클라이언트에서 실제로 지원하는 기능을 기준으로 확인하세요.

다운로드 페이지로 이동

Linux

GUI 데스크톱에서는 Clash Verge Rev 또는 FlClash를 사용할 수 있습니다. Debian 계열과 RPM 계열에 맞는 패키지 형식을 선택하세요. GUI가 없는 서버에서는 mihomo를 직접 실행하면 됩니다. 먼저 uname -m으로 아키텍처를 확인한 뒤 디렉터리와 서비스를 설정하세요.

다운로드 페이지로 이동

설치 패키지 형식과 CPU 아키텍처는 별개입니다. 배포판에서 특정 패키지를 설치할 수 있어도 패키지에 포함된 바이너리가 현재 기기와 호환되는지 확인해야 합니다. GUI 클라이언트를 사용할 때는 독립 코어를 동시에 실행해 같은 포트를 점유하지 않도록 하세요.

전체 클라이언트 보기

02 / CONFIGURATION WORKSPACE

mihomo 설정 및 실행 방식

로컬 포트부터 상시 실행 서비스까지 필요한 설정을 단계별로 추가하세요.

아래 코드는 설정 항목 예시이며 전체 구독 설정이 아닙니다. 먼저 로컬 프록시 포트를 사용할 수 있게 한 다음 트래픽 처리와 규칙 참조를 설정하세요. 한 번에 한 종류의 항목만 수정하고 로그를 확인한 뒤 다음 단계로 넘어가면 설정 오류, 권한 문제, 상위 서버 연결 실패를 구분하기 쉽습니다.

mihomo 코어

mihomo는 설정을 해석하고 포트를 열어 규칙에 따라 트래픽을 처리합니다. GUI 클라이언트는 바깥에서 구독 관리와 시스템 연동을 제공합니다. 먼저 mixed-port를 설정해 HTTP 또는 SOCKS를 지원하는 앱이 로컬 주소로 연결하도록 한 뒤, 설정 검사 명령으로 YAML 구문을 확인하세요. GUI 스위치에만 의존하는 방식보다 파일을 직접 관리하는 방식이 서버와 원격 터미널에 적합하지만 디렉터리, 권한, 로그를 직접 관리해야 합니다. 관리 인터페이스는 로컬에서만 수신하도록 설정해 네트워크에 직접 노출하지 마세요.

mixed-portmodeexternal-controller
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090

먼저 로컬 수신 주소를 확인하세요.

설정 항목은 서로 참조합니다. 노드는 정책 그룹에 들어가고 정책 그룹은 규칙에서 사용됩니다. DNS와 라우팅 설정은 트래픽이 예상대로 코어에 전달되는지에도 영향을 줍니다. 설정 검사를 통과해도 파일을 읽을 수 있다는 뜻일 뿐이므로 실제 요청을 보내 검증해야 합니다.

config.yaml 설정 항목 안내 보기

03 / FIRST CONNECTION

Linux 빠른 시작 3단계

먼저 연결을 검증한 뒤 투명 프록시를 활성화하세요.

GUI 클라이언트와 코어 직접 실행은 조작 방법이 다르지만 검증 순서는 같습니다. 설정 출처를 확인하고 코어를 실행한 뒤 앱 트래픽이 실제로 프록시를 통과하는지 확인하세요. 구독을 가져왔다고 네트워크 연결까지 성공한 것은 아닙니다.

STEP 01

클라이언트와 설정 디렉터리 선택

데스크톱 사용자는 GUI 클라이언트를 설치한 뒤 화면 안내에 따라 설정을 가져오세요. 명령줄로 배포할 때는 파일을 ~/.config/mihomo/config.yaml에 저장하세요. 기존 파일을 먼저 백업한 다음 구독이 전체 설정인지 노드만 포함한 Provider인지 확인하세요. 두 형식은 가져오는 위치가 다르므로 확장자만 바꿔 서로 대체할 수 없습니다.

설정 URL은 구독 제공자가 안내하며, 이 사이트의 다운로드 페이지에서는 소프트웨어만 제공하고 노드는 제공하지 않습니다. 원격 서버에서는 디렉터리 소유권도 확인해 일반 사용자로 실행할 때 관리자가 만든 파일을 읽지 못하는 일이 없도록 하세요.

STEP 02

설정을 확인하고 코어 실행

명령줄로 배포할 때는 먼저 설정 검사를 실행해 들여쓰기, 항목, 정책 참조가 올바른지 확인한 뒤 코어를 실행하세요. 처음에는 info 로그를 유지하고 수신 주소가 설정과 일치하는지 살펴보세요. 포트가 이미 사용 중이라면 먼저 점유 중인 프로세스를 확인하세요. 포트를 반복해서 바꾸면서 앱에는 이전 프록시 주소를 그대로 두지 마세요.

mihomo -t -d ~/.config/mihomo
mihomo -d ~/.config/mihomo

GUI 클라이언트에서는 보통 설정을 활성화하고 서비스를 시작하면 됩니다. 버튼 위치는 클라이언트 화면을 기준으로 확인하세요.

STEP 03

요청과 규칙 적용 확인

먼저 명시적 프록시를 사용해 요청을 보내고 앱이 로컬 포트에 연결되는지, 로그에 해당 연결이 표시되는지 확인하세요. 다음으로 시스템 프록시를 켜고 브라우저를 점검한 뒤 필요하면 TUN을 활성화하세요. 트래픽 처리 단계를 추가할 때마다 요청 테스트를 반복하면 문제가 어느 단계에서 발생하는지 파악할 수 있습니다.

curl -I -x http://127.0.0.1:7890 https://example.org

HTTP 응답을 받았다는 것은 요청 경로에서 응답이 왔다는 뜻이지 모든 도메인이나 규칙이 정상이라는 뜻은 아닙니다. 실제로 사용할 사이트를 선택해 추가로 확인하세요.

Clash Verge Rev 사용법을 확인할 때는 먼저 GUI 클라이언트 절차에 따라 설정을 가져온 뒤 항목 안내를 참고해 내부 동작을 이해하세요. 환경 변수는 해당 변수를 읽는 프로세스에만 영향을 주며 시스템 프록시가 모든 연결을 처리하는 것도 아닙니다. 터미널은 되지만 브라우저가 안 된다면 구독을 바로 바꾸지 말고 각각의 연결 경로를 확인하세요.

전체 가이드 보기

04 / SOURCE & OPERATIONS

오픈 소스 프로젝트와 배포 시 유의 사항

프로젝트 출처를 확인하고 실행 로그로 배포 상태를 점검하세요.

Clash for Linux는 클라이언트 다운로드와 배포 자료를 정리하는 사이트이며 모든 클라이언트의 개발팀은 아닙니다. 페이지의 명령은 Linux에서 자주 사용하는 예시이므로 실행 전에 배포판, 데스크톱 환경, 현재 권한을 고려하세요. 오픈 소스 라이선스, 기능 지원, 유지보수 상태는 각 프로젝트에서 따로 확인해야 합니다.

Clash 생태계와 mihomo의 관계

Clash 생태계에는 프록시 코어, GUI 클라이언트, 주변 설정 도구가 포함되며 이름이 비슷하다고 같은 프로젝트인 것은 아닙니다. mihomo는 Clash.Meta 프로젝트를 이어 발전한 코어로, Clash 스타일의 설정 구조를 유지하면서 프로토콜과 실행 기능을 확장했습니다. 기존 설정을 옮길 때는 항목별로 확인하고 모든 클라이언트가 같은 항목을 지원한다고 가정하지 마세요. 알 수 없는 항목이 있다면 창 제목만 보지 말고 실제 실행 중인 코어를 확인하세요.

이 사이트에서는 mihomo의 Linux 배포를 중심으로 안내하고 GUI 클라이언트 섹션에서는 설치 경로 선택을 돕습니다. 클라이언트의 구독, 오버라이드, 서비스 모드에는 자체 설정 계층이 추가될 수 있어 코어에 전달되는 내용이 가져온 파일과 완전히 같지 않을 수 있습니다. 참조 오류를 확인할 때는 원본 구독, 로컬 오버라이드, 실행 설정을 구분하세요.

소스 코드와 오픈 소스 라이선스

mihomo 소스 코드는 MetaCubeX/mihomo 저장소에서 확인할 수 있으며 GPL-3.0 라이선스를 따릅니다. 소스 코드, 빌드 안내, 이슈 기록을 살펴보면 특정 항목의 지원 여부와 동작 변화가 코어에서 비롯된 것인지 클라이언트 통합에서 비롯된 것인지 확인하는 데 도움이 됩니다. 소스가 공개되어 있어도 다운로드한 파일을 바로 실행할 수 있는 것은 아닙니다. 저장소를 복제하면 프로젝트 파일을 받게 되며, 빌드에는 업스트림 안내에 따른 도구 체인이 필요합니다.

오른쪽 명령을 복사하면 저장소를 가져와 구현을 살펴보거나 직접 빌드할 수 있습니다. 일반 데스크톱 사용자는 다운로드 페이지에서 클라이언트를 선택하면 됩니다. 서드파티 GUI 클라이언트는 각자 출시 일정을 관리하므로 코어 프로젝트의 라이선스나 업데이트 기록을 모든 클라이언트의 정보로 대신할 수 없습니다.

업데이트 전에 복구 가능한 설정을 보관하세요

코어, GUI 클라이언트, 구독 콘텐츠, 규칙 세트는 각각 별도로 업데이트해야 합니다. 소프트웨어를 업그레이드하기 전에 사용 중인 설정과 서비스 유닛을 저장하고 관련 변경 사항을 확인한 뒤 설정 검사를 실행하세요. Provider 업데이트는 데이터 출처를 바꾸는 것이며 코어 업그레이드와 다릅니다. 로컬 규칙을 수정해도 구독 서버에는 자동으로 반영되지 않습니다. 각 파일을 누가 관리하는지 파악해야 다음 갱신 때 수정 사항이 덮어써지는 일을 막을 수 있습니다.

Linux 바이너리를 직접 교체했다면 실행 권한, 서비스 경로, TUN에 필요한 권한이 그대로 유효한지 확인하세요. 먼저 포그라운드에서 실행을 검증한 다음 상시 실행 서비스를 재시작하세요. 실패하면 오류 출력을 보관하고 설정, 파일 접근, 네트워크 연결 순서로 문제를 확인하세요.

노출은 최소화하고 실행 상태는 확인하세요

단일 기기에서 사용할 때는 프록시 포트와 제어 인터페이스가 루프백 주소에서만 수신하도록 하고 allow-lan: false를 유지하세요. 로컬 네트워크에 서비스를 제공해야 한다면 수신 주소, 방화벽 범위, 접근 제어를 명확히 설정하세요. 제어 인터페이스는 코어 관리용이므로 프록시가 작동한다는 이유만으로 외부에 열지 마세요. 구독 URL도 공개된 이슈에 붙여 넣지 마세요.

systemd를 사용한다면 로그를 가장 먼저 확인하세요. 서비스가 실행 중으로 표시되어도 구독을 읽지 못하거나 DNS 설정에 문제가 있을 수 있습니다. 반대로 특정 웹페이지가 열리지 않는다고 서비스가 종료된 것은 아닙니다. 수신 포트, 명시적 프록시 요청 한 번, 관련 로그를 함께 확인하면 모드를 계속 바꾸는 것보다 원인을 찾기 쉽습니다.

연결 전 자주 묻는 질문

설치하면 노드도 제공되나요? 소프트웨어와 구독은 별도로 제공되므로 사용할 수 있는 설정을 직접 가져와야 합니다. Clash VPN 구독의 접속 권한, 콘텐츠 형식, 유효 기간은 제공자가 관리합니다. 클라이언트 설치에 성공했다고 구독을 바로 사용할 수 있는 것은 아닙니다.

전역 모드로 모든 연결 문제를 해결할 수 있나요? 포트, DNS, 권한 확인을 대신할 수 없습니다. 먼저 트래픽이 코어에 전달되는지 확인한 뒤 모드를 바꿔 규칙 적용 문제인지 판단하세요. 테스트가 끝나면 원래 사용하려던 모드로 되돌리세요.

TUN과 시스템 프록시 중 무엇을 선택해야 하나요? 먼저 시스템 프록시로 검증 가능한 기준 상태를 만드세요. 프록시 설정을 읽지 않는 앱이 있을 때 TUN을 활성화하면 됩니다. 두 방식은 트래픽을 처리하는 지점이 다르므로 한쪽에서 성공했다고 다른 쪽도 올바르게 설정된 것은 아닙니다.

문제별 해결 방법 보기 코어 및 설정 용어 보기

05 / DEPLOYMENT NOTES

설정 분석과 문제 해결

실제 배포 과정에서 필요한 내용을 추가로 확인하고, 첫 설치 절차에 모든 매개변수를 한꺼번에 넣지 마세요.

처음 연결을 마친 뒤 정기 업데이트, 항목 구성, 모바일 백그라운드 설정을 살펴보세요. 문서의 예시는 기존 설정과 함께 사용해야 합니다. 복사하기 전에 항목이 속한 계층을 확인하고, 수정 후 실행 설정을 점검하세요. 같은 요청을 수정 전후에 보내 결과를 비교하면 됩니다.

전체 게시글 보기