플랫폼별 설치 파일부터 확인하고, 단계에 따라 구독을 가져온 뒤 규칙 기반 라우팅을 설정하세요.
mixed-port: 7890
mode: rule
rules:
- GEOSITE,cn,DIRECT
- GEOIP,CN,DIRECT
- MATCH,PROXY먼저 기기의 운영체제를 확인한 다음 프로세서 아키텍처를 확인하세요. 설치 파일은 클라이언트를 설치하고, 구독 설정은 프록시와 규칙을 제공하므로 각각 준비해야 합니다.
데스크톱과 노트북에 적합합니다. “설정 → 시스템 → 정보”에서 시스템 종류를 확인해 x64와 ARM 기기를 구분한 뒤 알맞은 클라이언트를 선택하세요. 다운로드 페이지에는 Clash Plus가 먼저 표시되고, 다른 GUI 클라이언트와 보관 프로젝트도 이어서 확인할 수 있습니다.
설치가 끝나면 시스템 프록시를 바로 켜기보다 먼저 클라이언트의 구성 목록을 여세요. 구성을 선택하지 않았거나 코어가 실행되지 않으면 시스템 프록시가 아직 연결 대기 중인 로컬 포트를 가리킬 수 있습니다. 처음 연결을 확인할 때는 포트와 시스템 설정이 서로 덮어쓰지 않도록 프록시 클라이언트 하나만 실행하는 편이 좋습니다.
다운로드 페이지로 이동먼저 Apple 메뉴의 “이 Mac에 관하여”에서 칩 정보를 확인하세요. Apple Silicon과 Intel은 각각 해당 아키텍처용 파일을 선택해야 합니다. 디스크 이미지를 연 뒤 클라이언트 안내에 따라 앱을 “응용 프로그램” 폴더로 옮기고, 해당 폴더에서 실행하세요.
시스템 프록시, 백그라운드 실행, 네트워크 확장은 각각 별도의 권한이 필요할 수 있습니다. 보안 경고가 표시되면 앱 출처와 경고 내용을 확인하고 시스템 보호 기능을 통째로 끄지 마세요. 다른 클라이언트로 바꾸기 전에는 기존 클라이언트를 종료하고 프록시 설정을 원래대로 복구해야 메뉴 막대 앱이 백그라운드에서 연결을 계속 제어하는 일을 막을 수 있습니다.
다운로드 페이지로 이동APK를 다운로드할 때는 기기에서 지원하는 프로세서 아키텍처에 맞는 파일을 선택하세요. 잘 모르겠다면 클라이언트에서 범용 패키지를 제공하는지 먼저 확인하면 됩니다. 설치 권한은 실제로 설치 파일을 여는 앱에 부여하고, 설치가 끝난 뒤 필요에 따라 권한을 원래대로 되돌릴 수 있습니다.
처음 연결할 때는 보통 시스템 VPN 권한 요청이 표시됩니다. 이는 클라이언트가 기기의 네트워크 트래픽을 로컬에서 처리하기 위한 단계이며, 특정 프록시 노드에 이미 연결되었다는 뜻은 아닙니다. 권한을 허용한 뒤에도 유효한 구성을 선택하고 정책을 지정해야 합니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행 제한, 다른 VPN 앱의 동시 실행 여부를 확인하세요.
다운로드 페이지로 이동다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 먼저 App Store의 시스템 요구 사항을 읽고 설치하세요. 구독 주소는 신뢰할 수 있는 출처에서 받은 뒤 클라이언트에 별도로 가져와야 합니다.
VPN 구성을 추가하도록 허용한 뒤 클라이언트로 돌아가 선택된 구성과 연결 상태를 확인하세요. 시스템의 VPN 표시는 관련 연결이 설정되었다는 뜻일 뿐, 모든 앱에 같은 라우팅 정책이 적용된다는 의미는 아닙니다. 연결을 확인할 때는 먼저 브라우저에서 테스트 대상에 접속한 뒤 필요한 앱의 연결 상태를 점검하세요. 시스템 네트워크 구성을 반복해서 삭제하지 마세요.
다운로드 페이지로 이동데스크톱 환경에서는 GUI 클라이언트를 우선 선택하고, 서버나 라우터에서는 Mihomo 코어를 직접 실행하는 방법을 고려하세요. Debian 계열과 RPM 계열 배포판은 각각의 패키지 관리 방식에 맞게 설치해야 합니다. AppImage는 흔히 쓰이는 포터블 배포 형식의 예시이며, 실제 제공 파일은 다운로드 페이지를 확인하세요. 모든 프로젝트가 모든 형식을 제공하는 것은 아닙니다.
설치 전에 배포판, 아키텍처, 데스크톱 환경을 확인하세요. 데스크톱 프록시 설정은 해당 설정을 따르는 앱에만 적용되는 경우가 많고, 터미널 도구는 프록시를 별도로 지정해야 할 수 있습니다. 코어를 직접 실행한다면 설정 파일 경로, 서비스 시작, 로그, 접근 권한도 직접 관리해야 합니다. GUI 클라이언트의 단계를 백그라운드 서비스에 그대로 적용할 수는 없습니다.
다운로드 페이지로 이동처음 설치한다면 Clash Plus부터 시작할 수 있습니다. 이미 안정적으로 설정해 사용 중이라면 코어 호환성, 구독 관리 방식, 시스템 트래픽 처리 방식을 먼저 비교하세요. 이름이 비슷한 클라이언트라도 지원하는 설정 범위가 완전히 같지는 않습니다. 예전 가이드와 현재 화면의 버튼 위치가 다를 수 있으니 “구성, 프록시, 설정, 로그” 같은 기능별 메뉴를 기준으로 찾아보세요.
보관된 클라이언트는 구형 환경을 확인하거나 마이그레이션할 때 참고할 수 있습니다. 설정 항목을 인식하지 못한다면 먼저 코어가 해당 항목을 지원하는지 확인한 뒤 설정 변경을 고려하세요. 설치 파일을 반복해서 바꿔도 구독 내용 자체의 문제는 해결되지 않는 경우가 많습니다. 다운로드 페이지에서는 설치 링크와 유지 관리 상태를 따로 표시해 일반 사용과 구형 환경 호환 목적을 구분할 수 있습니다.
아래는 설정 화면의 정적 예시입니다. 테마를 바꾸면 메뉴 위치를 확인할 수 있습니다. 실제 메뉴 이름은 선택한 클라이언트에 따라 다르며, 이 예시는 기기의 네트워크 설정을 변경하지 않습니다.
시스템 프록시는 운영체제의 프록시 주소를 클라이언트의 수신 포트로 지정해 시스템 설정을 따르는 브라우저와 데스크톱 앱에서 사용할 수 있습니다. 먼저 코어를 실행하고 구성을 선택한 다음 설정 화면에서 시스템 프록시를 켜세요. 브라우저 확장 프로그램이 시스템 설정을 덮어쓸 수 있고, 터미널은 환경 변수만 읽을 수도 있으므로 브라우저에서 연결된다고 터미널까지 프록시를 사용하는 것은 아닙니다. TUN보다 적용 범위를 확인하기 쉽습니다. 혼합 포트를 변경했다면 시스템 프록시 주소도 함께 확인하고, 문제가 생기면 요청이 클라이언트 연결 목록에 표시되는지 먼저 살펴보세요.
mode: rule
rules:
- GEOSITE,cn,DIRECT
- GEOIP,CN,DIRECT
- MATCH,PROXY규칙 모드는 목록 순서에 따라 도메인, 대상 주소 등의 조건을 확인하고, 일치하는 항목을 직접 연결 또는 지정된 정책 그룹으로 전달합니다. 예시의 PROXY는 실제 구성에 존재하는 정책 이름이어야 합니다. GeoSite 및 GeoIP 규칙은 관련 데이터베이스와 코어의 지원 여부에도 영향을 받습니다. 전역 모드와 달리 규칙 모드에서는 대상별로 연결 방식을 나눌 수 있습니다. 사이트가 예상과 다른 경로로 연결되면 연결 기록에서 적용된 규칙을 확인하고 규칙 순서를 조정하세요. 노드만 바꾸는 것으로 해결하려 하지 마세요. 구독을 업데이트하면 원본 파일에 직접 추가한 변경 사항이 덮어써질 수 있습니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: trueTUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하므로 시스템 프록시를 따르지 않는 프로그램에 사용할 수 있습니다. 다만 실제 적용 범위는 라우팅, 제외 항목, 시스템 권한에 따라 달라집니다. 먼저 일반 프록시 연결이 정상인지 확인한 다음 클라이언트의 TUN 기능을 켜고 안내에 따라 서비스를 설치하거나 권한을 부여하세요. 시스템 프록시보다 네트워크 계층 설정이 많아 다른 VPN이나 가상 네트워크 어댑터와 충돌할 가능성도 큽니다. 인터넷 연결이 끊기면 먼저 TUN을 꺼서 기본 상태로 복구한 뒤 라우팅과 DNS를 확인하세요. 유효한 구성을 가져오기 전에 TUN부터 켜는 것은 권장하지 않습니다.
구독을 가져오면 원격 구성이 목록에 추가될 뿐, 보통 해당 항목을 선택해야 코어에 적용됩니다. 먼저 구성 화면에 전체 구독 주소를 붙여 넣고 다운로드와 파싱이 완료될 때까지 기다린 다음 정책 그룹이 표시되는지 확인하세요. 업데이트 실패는 주소 만료, 네트워크 요청 실패, 형식 비호환 등 여러 원인으로 발생할 수 있으므로 알림만 보고 노드를 사용할 수 없다고 판단해서는 안 됩니다. 로컬 파일보다 원격 구독은 업데이트가 편리하지만 사용자 지정 내용이 덮어써질 수도 있습니다. 유지할 규칙은 클라이언트가 지원하는 오버라이드나 병합 기능으로 관리하고 원본 구성도 안전하게 보관하세요.
플랫폼에 따라 설치 방법이 달라지고, 프로세서 아키텍처에 따라 프로그램 실행 여부가 결정됩니다. 디스크 이미지나 APK 형식이 같아도 대상 기기는 다를 수 있습니다. 시스템 정보에서 아키텍처를 확인한 뒤 다운로드 페이지의 링크를 선택하세요. 파일 확장자만 보고 판단하지 마세요. GUI 클라이언트에는 구성과 설정 화면이 포함되지만, 코어 패키지는 실행 옵션과 서비스를 직접 관리해야 하는 사용자를 위한 것입니다. 용도가 다르므로 코어를 바로 다운로드해도 같은 조작 화면을 사용할 수 있는 것은 아닙니다. 기기를 바꿀 때 호환되는 구성은 재사용할 수 있지만 권한과 시스템 프록시는 다시 설정해야 합니다.
예시는 항목과 위치를 설명하기 위한 것이며, 기존 구독을 그대로 대체할 수 있는 완전한 구성 파일이 아닙니다. 실제로 실행하기 전에 정책 그룹, 규칙 데이터, 코어 기능이 서로 호환되는지 확인하세요.
설치 성공과 연결 가능 여부를 따로 확인하세요. 먼저 문제가 생겼을 때 되돌릴 수 있는 기본 설정을 만들고, 트래픽 처리 범위를 한 단계씩 넓히면 변경 원인을 찾기 쉽습니다.
“구성” 또는 “Profiles”를 열고 링크나 로컬 파일에서 가져오기를 선택하세요. 링크에는 전체 경로와 매개변수가 포함되어야 합니다. 가져온 뒤 해당 항목을 눌러 현재 구성으로 지정하고, 프록시 화면에 정책 그룹이 표시되는지 확인하세요. 설치 파일에는 사용할 수 있는 프록시 서비스가 포함되어 있지 않으므로 구독은 신뢰할 수 있는 출처에서 받아야 합니다.
목록에 구성이 있는데 정책 그룹이 보이지 않으면 현재 선택된 항목부터 확인한 뒤 로그에서 파싱 메시지를 살펴보세요. 구독 주소를 노드 서버 주소 입력란에 붙여 넣지 말고, 전체 구독 링크가 보이는 스크린샷을 공개하지 마세요. 링크의 접근 매개변수가 계정과 연결되어 있을 수 있습니다.
처음 사용할 때는 규칙 모드를 선택하고, 수동 선택이 필요한 정책 그룹에서 사용 가능한 항목을 지정하세요. 규칙 모드는 트래픽을 어떻게 매칭할지 정하고, 정책 그룹은 매칭된 트래픽을 어느 경로로 보낼지 결정합니다. 서로 다른 설정입니다. 전역 모드는 일부 문제의 범위를 좁히는 데 쓸 수 있지만 올바른 규칙 구성을 대신하지는 않습니다.
속도 측정 결과는 특정 조건에서의 결과일 뿐, 모든 사이트에서의 실제 사용 경험을 보장하지 않습니다. 특정 앱에 문제가 생기면 대상 도메인, 적용된 규칙, 오류 발생 시간을 기록하고 관련 정책 그룹을 확인하세요. 한 곳에서만 문제가 발생한다면 클라이언트 전체를 초기화하기 전에 해당 대상의 DNS 조회와 연결을 먼저 살펴보세요.
데스크톱에서는 먼저 시스템 프록시를 켜고 브라우저로 대상 사이트에 접속하면서 연결 목록을 확인하세요. 터미널에서 작동하지 않으면 프록시 환경 변수를 별도로 점검합니다. 다른 앱의 트래픽까지 처리해야 한다면 TUN 사용을 검토하세요. 모바일에서는 시스템 안내에 따라 VPN 연결을 허용하고 현재 구성이 활성화되어 있는지 확인하세요.
연결을 확인한 다음 시작 시 자동 실행을 설정하세요. 자동 실행은 앱을 시작할 뿐 시스템 프록시나 TUN까지 자동으로 켠다는 뜻은 아니므로 각각 확인해야 합니다. 클라이언트를 종료하기 전에는 먼저 트래픽 처리 기능을 끄세요. 종료 후에도 인터넷이 연결되지 않으면 시스템 프록시 설정이 로컬 포트를 가리키고 있는지 확인한 뒤 가이드에 따라 복구하세요.
클라이언트 화면, 프록시 코어, 구독 서비스는 서로 다른 계층입니다. 소프트웨어 이름만 비교하는 것보다 각 구성 요소의 역할을 이해하면 설치와 문제 해결에 도움이 됩니다.
Clash는 구성 파일, 규칙, 정책 그룹을 사용해 프록시 연결을 관리하는 방식을 처음 정립했습니다. 원 프로젝트와 일부 초기 GUI 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티는 관련 구성 생태계를 바탕으로 코어와 인터페이스를 개발해 왔습니다. 오늘날 Clash를 검색하면 과거 프로젝트, 후속 코어, 다양한 플랫폼의 클라이언트가 함께 표시될 수 있으며, 이를 모두 같은 주체가 유지 관리한다고 볼 수는 없습니다.
예전 가이드를 참고할 때는 어떤 클라이언트와 코어를 대상으로 작성했는지 먼저 확인하세요. 비슷한 이름의 설정도 구현 방식이 다를 수 있고, 이전 프로젝트가 지원하던 구성 범위가 새 항목까지 포함한다고 볼 수 없습니다. 평소에는 유지 관리가 계속되는 클라이언트를 선택하고 원본 구성을 복사해 둔 뒤 현재 문서에 따라 옮기는 편이 오래된 화면 캡처를 그대로 따르는 것보다 안전합니다.
Mihomo는 Clash 생태계의 프록시 코어로, 구성 파싱, 규칙 매칭, 아웃바운드 연결 및 관련 네트워크 기능을 처리합니다. GUI 클라이언트는 보통 구성 목록, 정책 그룹, 로그, 설정을 보여 주고 코어 실행과 시스템 트래픽 처리를 관리합니다. 창이 열려 있다고 코어가 실행 중인 것은 아니며, 코어가 정상 작동해도 앱 트래픽이 프록시로 전달된다는 보장은 없습니다.
따라서 문제는 단계별로 확인해야 합니다. 먼저 구성이 정상적으로 적용됐는지 확인하고, 다음으로 수신 포트가 열렸는지 살핀 뒤, 마지막으로 시스템 프록시나 TUN이 대상 앱의 트래픽을 처리하는지 확인하세요. 클라이언트마다 코어 빌드와 기본 설정이 다를 수 있습니다. 기능이 없을 때는 클라이언트 이름만으로 판단하지 말고 실제 코어가 해당 기능을 지원하는지 확인하세요.
오픈 소스 저장소에서는 구현, 라이선스, 릴리스 노트, 알려진 문제를 확인할 수 있습니다. 아래 명령은 Mihomo 소스 코드만 복제하므로 구현을 살펴보거나 빌드 환경을 준비하는 사용자에게 적합합니다. 일반적인 설치에는 저장소를 복제할 필요가 없으며 다운로드 페이지에서 GUI 클라이언트를 바로 선택하면 됩니다. 저장소의 빌드 방법은 해당 프로젝트의 안내를 따르세요.
문제를 제보하기 전에 관련 키워드로 기존 논의를 검색하고 운영체제, 클라이언트 이름, 재현 단계, 필요한 로그를 준비하세요. 공개하기 전에는 구독 주소, 계정 매개변수, 개인 서버 정보를 삭제해야 합니다. 커뮤니티 자료는 동작 원인을 파악하는 데 도움이 되지만, 게시물의 실험용 설정을 모든 기기에 그대로 적용해서는 안 됩니다.
클라이언트 업데이트는 화면과 시스템 연동을 바꿀 수 있고, 코어 업데이트는 프로토콜이나 구성 항목 처리 방식을 바꿀 수 있습니다. 구독 업데이트는 주로 노드, 정책, 규칙의 출처를 갱신합니다. 세 가지는 서로 다릅니다. 구독 새로고침에 성공해도 앱이 업데이트된 것은 아니며, 클라이언트를 다시 설치해도 만료된 구독 주소나 원격 서비스 문제가 자동으로 해결되지는 않습니다.
업데이트 전에 사용 중인 구성과 주요 설정을 기록하고 관련 변경 사항을 읽어 보세요. 업데이트 후 문제가 발생하면 먼저 실행 실패, 구성 파싱 실패, 특정 연결 실패 중 무엇인지 구분한 다음 원인을 좁히세요. 구형 클라이언트의 마이그레이션 안내는 유지 관리가 종료된 클라이언트 안내를 참고하세요. 포트, DNS, 시간 초과 문제는 문제 해결 매뉴얼에서 하나씩 확인할 수 있습니다.
로컬 컴퓨터에 Git이 설치되어 있어야 합니다. 클라이언트 설치 과정은 아닙니다.
git clone https://github.com/MetaCubeX/mihomo.git기본 연결에 성공한 뒤 구체적인 증상에 맞는 가이드를 확인하세요. 한 번에 하나의 설정만 변경하고 변경 전후 결과를 기록하면 포트, DNS, 라우팅이 동시에 바뀌어 원인을 놓치는 일을 줄일 수 있습니다.
클라이언트가 시작되지 않고 포트가 사용 중이라는 메시지가 표시되면 netstat, lsof 등의 명령으로 포트를 점유한 프로세스를 찾으세요. 그런 다음 mixed-port와 외부 컨트롤 포트를 변경하고 시스템 프록시 설정도 함께 확인하세요.
address already in use 오류가 발생하거나 프록시 클라이언트 여러 개를 동시에 실행할 때 참고하세요. 점유 프로세스를 확인한 뒤 종료하거나 포트를 변경하세요. 정체를 모르는 시스템 프로세스를 무작정 종료하지 마세요. 포트를 변경한 뒤에는 브라우저 확장 프로그램과 터미널에 이전 주소가 남아 있는지도 확인해야 합니다.
시스템 시간 오차, 중간자 가로채기, 노드 문제, DNS 오염 등으로 인증서 오류가 발생하는 원인을 살펴봅니다. 프록시와 관련된 상황을 구분하고 안전하게 해결하는 순서도 안내합니다.
인증서 경고가 표시되면 비밀번호나 결제 정보를 입력하지 말고 시스템 시간, 대상 도메인, 인증서 안내를 확인하세요. 출구 노드를 바꾼 뒤 접속이 복구되더라도 이는 문제 해결을 위한 단서일 뿐, 인증서 경고를 무시해도 된다는 뜻은 아닙니다. 브라우저의 인증서 검증을 끄는 방식으로 해결해서도 안 됩니다.
GeoIP 및 GeoSite 데이터 파일의 역할과 저장 위치, 수동·자동 업데이트 설정, config.yaml에서 GEOIP와 GEOSITE 규칙을 작성하는 일반적인 방법을 안내합니다.
규칙을 불러왔지만 대상 트래픽이 예상과 다르게 라우팅되거나 로그에 규칙 데이터 읽기 실패가 명확히 표시될 때 참고하세요. 먼저 사용 중인 데이터 형식과 실제 경로를 확인한 뒤 업데이트 절차를 점검하세요. 규칙을 추가하기 전에 코어가 해당 규칙 유형을 지원하는지도 확인해야 합니다.