플랫폼에 맞는 클라이언트를 선택하고 mihomo 코어를 바탕으로 구독을 가져온 뒤 규칙을 설정하세요.
먼저 연결 하나가 정상 작동하는지 확인한 다음 고급 설정을 추가하세요. 한 번에 하나씩만 변경하세요.
먼저 기기의 운영체제를 확인한 뒤 프로세서 아키텍처를 확인하세요. 데스크톱에서는 유지 관리가 계속되는 GUI 클라이언트를 우선 선택하세요. 설치 후 설정을 열어 혼합 포트와 서비스 실행 상태를 확인합니다. 처음 사용할 때는 기본 네트워크 설정을 유지하고, 프록시 도구를 여러 개 동시에 켜거나 바로 TUN을 활성화하지 마세요. 설치 중 시스템 권한을 요청하면 서비스 설치, 네트워크 인터페이스 생성, 프록시 변경 중 어떤 작업에 필요한 권한인지 확인한 뒤 설정을 가져오세요.
설정 관리에서 서비스 제공업체가 안내한 Clash 구독 URL을 붙여넣고 가져오기를 누른 뒤 클라이언트가 처리를 마칠 때까지 기다리세요. 가져온 뒤에는 해당 설정을 선택하고 프록시 정책 그룹이 표시되는지 확인해야 합니다. 링크를 목록에 저장하는 것만으로는 설정이 적용되지 않습니다. 로컬 파일은 YAML 가져오기 기능을 사용하세요. 구독 주소에는 보통 계정 정보가 포함되므로 공개 변환 사이트에 올리거나 스크린샷 및 문의 내용에 전체 주소를 노출하지 마세요.
규칙 모드를 선택하고 정책 그룹에서 사용할 출구를 지정한 다음 시스템 프록시를 켜세요. 직접 연결해야 하는 사이트와 프록시가 필요한 사이트에 각각 접속하고, 연결 목록에서 적용된 규칙과 출구를 확인합니다. 브라우저에서는 되지만 다른 앱에서는 안 된다면 해당 앱이 시스템 프록시를 따르는지 먼저 확인한 뒤 TUN 사용 여부를 결정하세요. 정상 작동하는 설정을 저장해 두고, 문제가 생기면 원래 순서대로 되돌리세요. 반복해서 재설치하는 것보다 원인을 찾기 쉽습니다.
이 페이지에서는 플랫폼을 선택하세요. 설치 파일, 아키텍처 안내와 클라이언트별 정보는 다운로드 페이지에서 확인할 수 있습니다.
Clash Plus, Clash Verge Rev, FlClash 등의 GUI 클라이언트부터 살펴보세요. Clash for Windows 대체 클라이언트를 찾을 때는 화면이 비슷한지만 비교하지 말고 유지 관리 상태, 코어 호환성, 설정 이전 방법을 확인하세요. 이전 전에 사용자 규칙을 내보내고 기존 포트를 기록한 다음 시스템 프록시와 서비스 설정을 하나씩 복구하세요.
설치 파일의 아키텍처가 운영체제와 일치하는지 확인하세요. 이전 클라이언트가 백그라운드에서 실행 중이라면 먼저 종료하고 시스템 프록시를 확인해 두 프로그램이 포트를 동시에 사용하지 않도록 하세요. UWP 앱 연결이 필요하면 별도로 루프백 제한을 확인하세요.
다운로드 페이지 · Windows먼저 Apple Silicon인지 Intel인지 확인한 뒤 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 필요한 기능에 따라 비교할 수 있습니다. 이전 버전 ClashX Meta 설정을 사용한다면 코어 항목과 클라이언트 설정이 완전히 호환되지 않을 수 있다는 점에 유의하세요. 시스템 프록시와 TUN에 필요한 권한도 각각 확인해야 합니다.
처음 실행할 때 시스템 알림이 표시되면 시스템 설정의 안내에 따라 처리하세요. 앱을 실행하기 위해 보안 기능 전체를 끄지 마세요. 부팅 후 프록시 상태가 이상하면 로그인 항목, 백그라운드 서비스, 현재 네트워크 위치의 프록시 설정을 확인하세요.
다운로드 페이지 · macOS기기 아키텍처에 맞춰 Clash Plus, Clash Meta for Android, FlClash를 선택하거나 다운로드 페이지에서 Surfboard와 설정 방식의 차이를 확인하세요. Android 클라이언트는 보통 시스템 VPN 인터페이스로 트래픽을 처리합니다. 실행 전에 다른 VPN 앱이 같은 인터페이스를 사용 중인지 확인하고, 권한을 허용한 뒤 연결 기록을 살펴보세요.
백그라운드 연결 끊김이 반드시 구독 문제인 것은 아닙니다. 화면을 잠그기 전후로 상태가 달라지는지 확인한 다음 배터리 최적화와 백그라운드 제한을 살펴보세요. 계속 실행해야 하는 앱에만 필요한 권한을 조정하고, 모든 백그라운드 제한을 한꺼번에 해제하지 마세요.
다운로드 페이지 · Android다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인하세요. 설치 후 지원되는 구독 형식을 가져오고 시스템 안내에 따라 VPN 구성을 허용합니다. 데스크톱 클라이언트의 서비스 모드, 시스템 프록시 버튼, 포트 설정을 모바일 조작 방법에 그대로 적용하면 안 됩니다.
연결 후에는 앱을 열어 웹페이지가 정상적으로 표시되는지 확인하고, 네트워크 전환 및 화면 잠금 해제 후에도 연결되는지 테스트하세요. 특정 앱만 다르게 작동한다면 클라이언트 정책과 시스템 네트워크 권한을 함께 점검하세요. 사용 가능한 기능은 클라이언트 안내와 스토어 페이지를 기준으로 확인하세요.
다운로드 페이지 · iOS데스크톱에서는 Clash Verge Rev와 FlClash를 비교하고 배포판에 맞는 설치 파일을 선택하세요. 서버나 라우터에서 사용할 경우 코어 정보를 확인해 프로세서 아키텍처, 실행 권한, 서비스 관리 방법을 점검하세요. GUI에서 시스템 프록시를 설정하는 것과 명령줄 프로그램이 프록시 환경 변수를 읽는 것은 별개의 문제입니다.
배포 전에 기존 DNS 및 라우팅 설정을 기록하세요. 특히 원격 세션에서 네트워크 설정 전체를 바로 바꾸지 마세요. TUN을 활성화하려면 먼저 복구 방법을 마련한 뒤 라우팅이 현재 관리 연결에 영향을 주는지 확인하세요.
다운로드 페이지 · Linux구체적인 문제에서 시작해 설정 파일, 트래픽 진입 경로, 분기 정책을 구분해 보세요.
구독 URL을 설정 관리의 가져오기 입력란에 붙여넣고 다운로드 및 처리가 끝날 때까지 기다린 뒤 새 설정을 현재 사용 항목으로 지정하세요. Clash 설정과 Base64 노드 목록은 서로 다른 형식입니다. 처리가 실패하면 먼저 제공업체에 구독 형식을 확인하세요. 자동 업데이트는 설정 변경 사항을 가져오는 기능일 뿐, 정책이 적절한지 판단해 주지는 않습니다. 우선 하루 간격으로 업데이트하고 시간 초과가 발생하면 프록시를 통한 업데이트를 시도하세요. 구독 주소에는 인증 정보가 포함되므로 로그를 공유하기 전에 주소와 인증 정보를 삭제하세요.
구독 가져오기 단계 보기 →rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY규칙 모드는 설정에 적힌 순서대로 규칙을 확인하며, 처음 일치하는 항목이 연결 경로를 결정합니다. 예시에서는 지정한 도메인에 프록시를 사용하고, 중국 본토 IP는 직접 연결한 뒤, 나머지 연결은 MATCH로 처리합니다. PROXY는 정의된 정책 그룹 또는 프록시 이름이어야 합니다. 실제 설정에서는 내부 네트워크 주소, 도메인 조회 결과, 데이터베이스 사용 가능 여부도 고려해야 하므로 몇 줄짜리 예시를 완전한 규칙 집합으로 사용하면 안 됩니다. 변경 후 연결 세부 정보에서 적용된 규칙을 확인하고 더 구체적인 도메인 규칙을 추가할지 판단하세요.
규칙 분기 가이드 보기 →tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53TUN은 가상 네트워크 인터페이스를 만들어 시스템 프록시를 따르지 않는 일부 앱의 트래픽도 코어에서 처리할 수 있도록 합니다. 트래픽이 들어온 뒤에는 현재 프록시 모드와 규칙에 따라 출구가 결정됩니다. 활성화하기 전에 클라이언트 서비스 권한을 확인하고 다른 VPN, 가상 네트워크 어댑터, 보안 소프트웨어와 충돌하는지 점검하세요. 예시 항목은 mihomo 기준이며 실제 사용 가능 여부는 코어와 운영체제 문서를 확인해야 합니다. 활성화 후 인터넷이 끊기면 먼저 TUN을 끄고 기본 연결을 복구한 뒤 라우팅과 DNS를 각각 확인하세요. 여러 항목을 동시에 바꾸면 되돌리기 어려워집니다.
TUN 설정 및 복구 방법 보기 →일상적으로는 규칙 모드를 선택해 설정에 적힌 규칙에 따라 직접 연결 또는 프록시를 사용하세요. 전역 모드는 프록시 출구가 작동하는지 일시적으로 확인할 때 편리하지만 모든 앱의 트래픽을 자동으로 가져오지는 않습니다. 직접 연결 모드에서는 코어에 들어온 연결이 대상에 바로 접속합니다. 시스템 프록시와 TUN은 트래픽을 코어로 보내고, 프록시 모드는 트래픽을 어디로 보낼지 결정합니다. 두 설정을 혼동하지 마세요. 문제를 확인할 때는 먼저 요청이 연결 목록에 표시되는지 확인한 뒤 모드를 바꿔 비교하고, 점검이 끝나면 기존 규칙 모드로 되돌리세요.
모드와 시스템 프록시 알아보기 →dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://1.1.1.1/dns-queryDNS는 도메인을 IP 주소로 변환하며 도메인 규칙과 IP 규칙의 판정에도 영향을 줍니다. fake-ip는 매핑 주소를 사용해 도메인 정보를 유지하고, redir-host는 실제 조회 결과 주소를 반환하는 방식에 가깝습니다. 두 방식은 네트워크 환경에 맞춰 선택해야 합니다. 예시는 핵심 항목만 보여 주며 모든 환경에 적용되는 설정은 아닙니다. 일부 사이트에서 문제가 생기면 먼저 운영체제, 브라우저, 클라이언트가 각각 어떤 DNS를 사용하는지 확인한 뒤 DNS 가로채기가 대상 트래픽에 적용되는지 살펴보세요. 기존 설정을 보관하고 한 번에 한 항목씩 변경하세요.
mihomo DNS 설정 자세히 보기 →프로젝트 간 관계를 파악하고 되돌릴 수 있는 설정을 보관하세요. 변경 사항은 연결 기록으로 검증하세요.
Clash 생태계는 규칙 기반 프록시 코어를 중심으로 여러 GUI 클라이언트가 발전하며 형성됐습니다. 원 프로젝트의 유지 관리 상태가 변하면서 커뮤니티는 호환 구현과 다양한 플랫폼용 인터페이스를 계속 개발해 왔습니다. 이제 Clash 다운로드를 검색하면 오래된 클라이언트, 커뮤니티 포크, 코어 프로젝트가 함께 표시되는 경우가 많습니다. 선택할 때는 프로젝트 이름, 유지 관리 상태, 사용 코어를 각각 확인하고 설치 파일 이름만으로 기능을 판단하지 마세요. 이 사이트는 설치부터 검증까지 이어서 진행할 수 있도록 플랫폼별 다운로드와 설정 문서를 함께 제공합니다. 사이트 이름이 등록된 모든 커뮤니티 프로젝트를 같은 팀이 개발한다는 뜻은 아닙니다.
mihomo는 Clash 생태계에서 발전한 오픈 소스 프록시 코어이며, 한때 Clash.Meta라는 이름을 사용했습니다. 프로토콜 연결, DNS 처리, 규칙 매칭을 담당하고 GUI 클라이언트는 이를 바탕으로 구독 관리, 시스템 프록시, 서비스 설치, 설정 인터페이스를 제공합니다. 인터페이스의 스위치가 설정 파일의 항목과 항상 일대일로 대응하는 것은 아니며, 클라이언트가 실행할 때 설정을 병합하거나 덮어쓸 수도 있습니다. 따라서 문제를 확인할 때는 구독 원문만 보지 말고 최종 적용된 설정을 확인하세요. 항목의 사용 가능 여부는 실제 실행 중인 코어의 문서를 기준으로 판단해야 합니다.
오픈 소스 저장소에는 코드, 이슈 논의, 커밋 기록, 릴리스 노트가 있어 단편적인 기능 홍보보다 호환성을 판단하는 데 유용합니다. 설정 항목 파싱 오류가 발생하면 먼저 항목 이름과 오류 문구를 검색해 알려진 제한이 있는지 확인한 뒤 코어 업데이트나 설정 변경을 검토하세요. 아래 명령은 mihomo 소스 코드를 내려받기만 하며 GUI 클라이언트를 설치하거나 시스템 프록시를 변경하지 않습니다. 일반 사용자는 직접 빌드하지 않고 클라이언트를 사용해도 됩니다. 개발하거나 코드를 검토하려는 경우 저장소의 빌드 안내와 라이선스 조건을 확인하세요.
구독 업데이트는 노드, 정책 그룹, 규칙 내용을 변경합니다. 클라이언트 업데이트는 인터페이스, 권한, 시스템 연동 방식에 영향을 줄 수 있고 코어 업데이트는 프로토콜 및 설정 호환성을 바꿀 수 있습니다. 세 가지를 한 번에 처리하지 마세요. 업데이트 전에 정상 작동하는 설정과 필요한 사용자 덮어쓰기 항목을 보관하고 릴리스 노트를 읽은 뒤 하나씩 진행하세요. 업데이트 직후 문제가 발생했다면 어느 계층이 바뀌었는지 비교한 다음 해당 부분만 되돌리세요. 포트 충돌을 해결하려고 구독을 반복 새로 고치거나 형식 오류를 덮으려고 클라이언트를 재설치하지 마세요.
구독 업데이트 실패: 다운로드 시간 초과, 인증서 오류, 형식 파싱 오류를 먼저 구분하세요. 서비스 제공업체가 설정 파일이 아닌 로그인 페이지를 반환하지 않는지 확인한 다음 필요하면 업데이트 간격을 조정하거나 프록시를 통해 업데이트하세요. 자세한 방법은 구독 업데이트 오류 문제 해결을 참고하세요.
연결됨으로 표시되지만 웹페이지가 열리지 않음: 요청이 연결 목록에 들어오는지 확인한 뒤 시스템 프록시, 포트 사용 여부, 정책 선택, DNS를 차례로 점검하세요. 연결 버튼이 켜져 있다는 것은 서비스가 실행 중일 수 있다는 뜻일 뿐, 대상 사이트 접속까지 성공했다는 의미는 아닙니다. 자세한 내용은 웹페이지가 열리지 않을 때 확인할 항목을 참고하세요.
설정 업데이트 후 사용자 규칙이 사라짐: 원격 구독이 기존 파일을 덮어쓸 수 있습니다. 클라이언트의 덮어쓰기, 병합 또는 확장 기능을 사용해 로컬 변경 사항을 보존하고 적용 순서를 확인하세요. 장기간 관리할 설정 구조를 만들려면 기초부터 고급까지 전체 가이드를 이어서 읽어 보세요.
클라이언트를 종료해도 인터넷에 연결되지 않음: 시스템에 로컬 포트를 가리키는 프록시 설정이 남아 있는지, 가상 인터페이스가 정상적으로 종료됐는지 확인하세요. 먼저 시스템의 기본 네트워크 연결을 복구한 뒤 클라이언트를 다시 실행하세요. 기본 개념, 설치와 설정, 문제 해결 방법은 FAQ 분류 페이지에서 증상별로 찾아볼 수 있습니다.
최근 게시물 세 편을 날짜순으로 확인하고 구체적인 문제부터 자세한 해결 방법을 살펴보세요.
모바일에서 Clash 배터리가 빨리 닳는 원인을 살펴보고 Android 배터리 최적화 예외와 백그라운드 제한, iOS 백그라운드 정책 설정 및 TUN 상시 실행의 장단점을 안내합니다.
배터리 소모 문제 해결 →클라이언트에 구독 URL을 붙여넣고 로컬 YAML 파일을 가져오는 방법을 설명합니다. Clash 설정 형식과 Base64 노드 목록의 차이, 변환 방법도 비교합니다.
가져오기 가이드 보기 →dns 섹션의 nameserver, fallback, fallback-filter, enhanced-mode를 항목별로 설명하고 fake-ip와 redir-host의 차이, DNS 가로채기를 사용할 상황을 안내합니다.
DNS 설정 자세히 보기 →