CONFIGURATION / 설정 개요
먼저 트래픽이 코어로 들어오는 방식을 정한 다음, 요청에 적용할 규칙을 결정하세요. 아래 설정 예시는 필드 간 관계를 보여줍니다. 노드 정보와 수신 주소는 사용 환경에 맞게 입력해야 합니다.
규칙 모드에서는 요청을 위에서 아래로 확인하고, 일치하는 규칙을 찾으면 지정된 프록시로 전달합니다. 이후 규칙은 더 이상 확인하지 않습니다. 구체적인 도메인 규칙을 앞에 두고, 지리적 IP 규칙을 배치한 뒤 MATCH로 나머지 트래픽을 처리하세요. 웹사이트가 잘못된 경로로 연결되면 연결 로그에서 적용된 규칙을 확인하고 프록시 그룹의 현재 선택 항목을 살펴보세요. 전역 모드와 달리 규칙 모드에서는 서비스마다 다른 경로를 지정할 수 있습니다. 단, 요청이 코어에 도달하고 도메인을 올바르게 식별할 수 있어야 합니다.
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY프록시 그룹은 규칙에서 사용할 안정적인 출구 이름을 제공합니다. 규칙은 항상 PROXY를 가리키도록 두고 그룹 안의 노드는 필요할 때 바꾸면, 노드를 변경할 때마다 규칙을 수정하지 않아도 됩니다. select는 수동 선택, url-test는 테스트 결과에 따른 선택, fallback은 순서대로 사용 가능한 출구를 찾을 때 적합합니다. 자동 테스트는 특정 테스트 주소의 연결 상태만 보여주며 모든 서비스의 성능을 보장하지 않습니다. 구독에 포함된 프록시 그룹을 사용할 때는 그룹 간 참조 관계를 파악하고 실제로 선택된 노드를 확인하세요. 그룹 이름을 실제 서버로 착각하지 않도록 주의해야 합니다.
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
- AUTO
- name: AUTO
type: url-test
use: [subscription]
url: https://www.gstatic.com/generate_204
interval: 300TUN은 가상 네트워크 인터페이스로 시스템 트래픽을 받아 시스템 프록시 설정을 따르지 않는 앱에서도 사용할 수 있습니다. 활성화하기 전에 일반 프록시 연결이 정상인지 확인하고, 클라이언트 안내에 따라 서비스를 설치하거나 권한을 허용하세요. 자동 라우팅은 시스템 네트워크 경로를 변경하므로 다른 VPN, 가상 머신 네트워크 또는 보안 소프트웨어와 함께 사용할 때 충돌 여부를 확인해야 합니다. TUN을 켜도 전역 프록시가 되는 것은 아닙니다. 코어에 들어온 트래픽의 출구는 현재 모드와 규칙에 따라 결정됩니다. TUN을 끌 때는 가상 인터페이스와 라우팅이 복구됐는지 확인하세요. 특히 네트워크를 전환하거나 절전 모드에서 깨어난 뒤에는 점검이 필요합니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53Fake-IP는 DNS 응답으로 예약된 IP 주소를 반환하고, 코어가 해당 주소를 원래 도메인에 다시 매핑하는 방식입니다. 따라서 이후 연결에서도 도메인 규칙을 사용할 수 있습니다. TUN과 함께 쓰기 좋지만 모든 DNS 요청이 자동으로 원격 서버에 전달되는 것은 아닙니다. 로컬 네트워크 탐색, 특수 인증 또는 실제 DNS 응답에 의존하는 앱에서 문제가 생기면 증상에 따라 fake-ip-filter를 추가할 수 있습니다. 설정을 바꾸기 전에 현재 DNS 설정을 기록하고, 한 번에 하나씩 변경한 뒤 관련 캐시를 지우고 확인하세요. 상위 DNS 서버와 필터 규칙을 동시에 바꾸면 원인을 찾기 어렵습니다.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
nameserver:
- https://dns.alidns.com/dns-query구독 링크로 노드나 전체 설정을 가져올 수 있으며, 가져오기 방식은 클라이언트가 지원하는 형식에 따라 다릅니다. 링크를 받으면 먼저 설정 화면에서 가져와 선택한 뒤, 프록시 그룹과 규칙이 실제로 표시되는지 확인하세요. 전체 Clash YAML과 노드 목록만 담긴 파일은 서로 다른 형식이며, 가져오기에 성공했다고 해서 설정이 활성화된 것은 아닙니다. 자동 업데이트 시 구독 원본 파일이 덮어써질 수 있습니다. 계속 유지해야 하는 규칙과 DNS 설정은 클라이언트의 오버라이드 기능에 추가하는 것이 좋습니다. 스크린샷이나 로그를 공유하기 전에 구독 주소를 가리세요. 서비스 접속 정보가 포함되어 있을 수 있습니다.
설정 관리
→ URL에서 가져오기
→ 설정 업데이트
→ 선택 후 활성화
→ 프록시 그룹 확인
→ 오버라이드 및 업데이트 간격 설정Clash 에코시스템에는 서로 다른 그래픽 인터페이스와 코어 구현이 있습니다. 인터페이스 이름이 비슷하다고 해서 모든 설정 필드가 호환되는 것은 아닙니다. mihomo는 Clash 스타일의 설정 구조를 이어받았으며, 자체적으로 지원하는 프로토콜과 네트워크 기능을 제공합니다. 코어를 바꾸기 전에 대상 클라이언트 문서에서 프로토콜, 규칙 제공자, TUN 설정을 지원하는지 확인하세요. 알 수 없는 필드나 파싱 오류가 발생하면 오류가 난 부분부터 범위를 좁히고 설정 전체를 삭제하지 마세요. 여기서 말하는 호환성은 설정을 맞추는 방법에 관한 것으로, 모든 클라이언트에서 코어를 바꿀 수 있다는 뜻은 아닙니다.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090DOWNLOAD / 플랫폼별 다운로드
먼저 시스템 아키텍처를 확인한 다음 설치 파일을 선택하세요. 그래픽 클라이언트는 설정과 연결을 관리하고, mihomo 코어는 요청을 처리합니다. 코어 파일만으로는 설정 목록, 시스템 프록시 전환 기능, 구독 관리 화면을 사용할 수 없습니다.
데스크톱에서는 Clash Plus, Clash Verge Rev, FlClash 중 하나를 선택하고 다운로드 페이지 안내에 따라 설치하세요. 처음 실행한 뒤 기존 구독을 가져와 코어가 실행되는지 확인한 후 시스템 프록시를 켜면 됩니다. 브라우저에서 웹사이트가 열린다고 해서 모든 앱의 트래픽이 프록시를 거치는 것은 아닙니다. 명령줄 도구는 프록시 환경 변수를 별도로 설정해야 할 수 있습니다.
TUN을 사용하려면 클라이언트 안내에 따라 서비스와 권한을 설정하세요. 처음부터 모든 트래픽 처리 방식을 한꺼번에 켤 필요는 없습니다. 포트가 이미 사용 중이라는 메시지가 나오면 다른 프록시 프로그램이 백그라운드에서 실행 중인지 확인하세요. 수신 포트를 바꾼 경우 앱에 설정한 수동 프록시 주소도 함께 변경해야 합니다. 클라이언트를 종료하기 전에 시스템 프록시를 끄면 설정이 남아 연결에 문제가 생기는 것을 줄일 수 있습니다.
다운로드 페이지로 이동다운로드 전에 시스템 정보에서 칩 종류를 확인하고 Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 설치 후 앱을 ‘응용 프로그램’ 폴더로 옮긴 다음 안내에 따라 네트워크 확장 프로그램이나 보조 서비스 권한을 설정하세요. 다른 네트워크 도구를 사용 중이라면 여러 프로그램이 같은 시스템 설정을 반복해서 바꾸지 않도록 기존 프록시 기능을 먼저 끄세요.
Clash Plus, Clash Verge Rev, FlClash는 설정 메뉴가 조금씩 다르지만 기본 흐름은 같습니다. 설정 가져오기, 설정 선택, 프록시 그룹 선택, 트래픽 처리 활성화 순으로 진행하세요. Wi-Fi를 바꾸거나 절전 모드에서 깨어난 뒤 웹사이트 접속에 문제가 생기면 먼저 현재 네트워크 서비스의 프록시 주소와 DNS를 확인한 다음 코어 로그를 살펴보세요. 메뉴 막대 아이콘만으로 연결 상태를 판단하지 마세요.
다운로드 페이지로 이동Android에서는 Clash Plus, Clash Meta for Android, FlClash 등의 클라이언트를 선택할 수 있습니다. 설치 전에 프로세서 아키텍처를 확인하세요. 잘 모르겠다면 다운로드 페이지의 패키지 유형 안내를 먼저 읽고, 맞지 않는 파일을 반복해서 설치하지 마세요. 구독을 가져오면 일반적으로 시스템에서 VPN 연결 권한을 요청합니다. 승인해야 해당 방식으로 앱 트래픽을 받을 수 있습니다.
모바일 운영체제는 백그라운드 실행을 제한할 수 있습니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 자동 시작, 백그라운드 데이터 설정을 확인하세요. 앱별 프록시와 도메인 규칙은 서로 다른 단계입니다. 앱이 프록시로 전달되는지는 트래픽 처리 설정이 결정하고, 전달된 뒤 사용할 출구는 규칙이 결정합니다. 다른 VPN이나 업무용 프로필 네트워크를 함께 사용할 때도 충돌에 유의하고, 클라이언트가 지원하는 범위에서 사용 방식을 정하세요.
다운로드 페이지로 이동iPhone 및 iPad 사용자는 다운로드 페이지에서 Clash Plus의 App Store 페이지를 열 수 있습니다. 제품 공식 사이트는 clashplus.io입니다. 설치 후 클라이언트에 맞는 구독이나 설정을 가져오고, 시스템 안내에 따라 VPN 구성을 추가하세요. 권한을 허용하면 트래픽을 처리할 준비가 된 것입니다. 이어서 설정과 프록시 그룹을 선택한 뒤 실제로 접속되는지 확인해야 합니다.
셀룰러 네트워크와 Wi-Fi에서는 접속 조건이 다를 수 있습니다. 한쪽 네트워크에서만 사용할 수 있다면 구독 업데이트, 노드 연결, DNS 조회를 각각 확인하세요. 자동 선택은 테스트 주소를 기준으로 동작하므로 모든 웹사이트에서 같은 결과를 보장하지 않습니다. 문제를 점검할 때는 먼저 수동으로 출구를 하나 지정해 원인을 확인한 뒤 자동 선택을 다시 사용하세요. 점검 중 출구가 계속 바뀌지 않도록 하는 것이 좋습니다.
다운로드 페이지로 이동그래픽 데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 설치할 수 있습니다. 데스크톱의 시스템 프록시를 모든 프로그램이 사용하는 것은 아닙니다. 터미널, 컨테이너, 백그라운드 서비스는 별도의 네트워크 설정을 사용할 수도 있습니다. 먼저 일반 사용자 세션에서 기본 연결을 확인한 뒤 TUN이나 서비스 실행이 필요한지 판단하면 권한 문제와 설정 문제를 구분하기 쉽습니다.
서버나 라우터에서 사용할 경우 다운로드 페이지의 코어 섹션에서 프로세서와 실행 환경에 맞는 mihomo를 선택하세요. 코어를 직접 실행한다면 설정 경로, 서비스 시작 순서, 로그 출력을 관리해야 합니다. 컨트롤 인터페이스는 일반적으로 로컬에서만 접속하도록 제한해야 합니다. 원격 관리가 필요하다면 인증 방식과 접근 범위를 먼저 설계하세요. 컨테이너의 루프백 주소는 컨테이너 자체를 가리키므로 호스트 주소로 사용할 수 없습니다.
다운로드 페이지로 이동SOURCE / 오픈 소스 및 유지 관리
공개 소스 코드, 설정 문서, 릴리스 노트를 통해 기능 범위를 확인하세요. 클라이언트, 코어, 구독은 각각 별도로 관리되므로 선택하거나 문제를 해결할 때 세 부분을 구분해야 합니다.
Clash는 규칙 기반 프록시 코어와 YAML 설정을 중심으로 에코시스템을 형성했으며, 이후 여러 포크와 그래픽 클라이언트가 등장했습니다. 원래 프로젝트와 후속 프로젝트의 유지 관리 상태는 서로 다릅니다. 오래된 클라이언트의 가이드를 모든 최신 클라이언트의 사용법으로 간주하지 마세요. mihomo는 Clash Meta 프로젝트의 기술 방향을 이어갑니다. 구체적인 동작은 현재 프로젝트 문서와 클라이언트에 실제로 통합된 기능을 기준으로 확인하세요. 예전 글을 참고할 때는 화면 캡처보다 필드의 의미와 적용 가능한 코어를 먼저 확인하는 것이 좋습니다.
설정 파일의 들여쓰기, 목록, 참조 관계는 모두 파싱에 영향을 줍니다. 수정하기 전에 정상 작동하는 사본을 저장하고 기능별로 한 번에 하나씩 변경하세요. 파싱 오류가 나면 로그에 표시된 필드와 주변 내용을 확인한 뒤, 해당 필드가 사용 중인 코어에서 지원되는지 살펴보세요. 파일을 불러올 수 있다는 사실만으로 노드 연결, 규칙 적용, 시스템 트래픽 처리까지 정상이라고 볼 수는 없습니다. 각 항목을 따로 확인해야 합니다.
그래픽 클라이언트는 설정 표시, 프로세스 관리, 시스템 기능 연동을 담당하고 코어는 규칙 파싱, 연결 생성, DNS 처리를 담당합니다. 두 구성 요소는 각각 업데이트될 수 있습니다. 따라서 인터페이스를 바꿔도 코어 동작은 그대로일 수 있고, 코어를 업데이트해도 구독 가져오기 메뉴는 달라지지 않을 수 있습니다. 클라이언트를 선택할 때는 플랫폼과 설치 방법뿐 아니라 서비스 실행 방식, 오버라이드 기능, 로그 위치, 설정 내보내기 방법도 확인하세요. 문제를 진단하거나 설정을 이전할 때 도움이 됩니다.
프로젝트마다 공개 범위와 라이선스 조건이 다르므로 같은 코어를 사용한다고 해서 앱 전체가 동일한 라이선스를 따른다고 단정할 수 없습니다. mihomo 저장소에서는 소스 코드와 라이선스 정보를 확인할 수 있으며, 기능 구현, 이슈 논의, 릴리스 기록을 살펴보는 데 유용합니다. 이 사이트는 다운로드 링크와 중국어 사용 안내를 함께 제공합니다. 실제 프로젝트의 릴리스, 스토어 배포, 구독 서비스는 각 프로젝트 관리자가 담당합니다.
클라이언트 업데이트는 앱 자체를, 코어 업데이트는 프로토콜과 네트워크 동작을, 구독 업데이트는 서비스 제공자가 제공하는 노드나 설정을 변경합니다. 노드가 작동하지 않으면 클라이언트를 바로 다시 설치하기보다 구독이 만료됐는지, 업데이트된 설정을 선택했는지 먼저 확인하세요. 알 수 없는 프로토콜이나 필드가 문제라면 코어의 지원 범위를 확인해야 합니다. 업데이트 전에 변경 사항을 읽고 현재 사용할 수 있는 설정을 보관하세요. 업데이트 후에는 수신 포트, 트래픽 처리 설정, 프록시 그룹 선택을 다시 확인해 기본값 변경으로 기존 환경에 문제가 생기지 않도록 하세요.
구독에는 서비스 제공자가 미리 설정한 DNS, 규칙, 프록시 그룹이 포함될 수 있습니다. 파일을 직접 수정하면 다음 업데이트 때 변경 내용이 덮어써질 수 있습니다. 오래 유지해야 하는 규칙은 클라이언트가 지원하는 오버라이드 또는 병합 기능을 사용하고 적용 순서를 확인하세요. 전체 구독 파일을 공개 게시판에 올리지 마세요. 문제를 신고할 때는 필요한 내용만 남긴 설정 일부와 시스템 환경, 관련 오류 행을 제공하면 됩니다.
먼저 코어가 수신 대기 중인지 확인하고, 다음으로 앱 요청이 연결 목록에 나타나는지 확인한 뒤 적용된 규칙과 실제 출구를 살펴보세요. 여러 노드를 계속 바꾸는 것보다 문제 지점을 쉽게 찾을 수 있습니다. 지연 시간 테스트는 지정된 주소만 대상으로 하므로 성공했다고 해서 실제 서비스의 연결까지 보장되지는 않습니다. 웹페이지가 열린다고 모든 앱이 같은 경로를 사용하는 것도 아닙니다. 명령줄 도구를 사용할 때는 현재 터미널에 프록시 환경 변수가 설정돼 있는지 확인하고, 테스트 전에 브라우저와 같은 방식으로 트래픽을 처리하는지 살펴보세요.
디버그 로그에는 방문한 도메인, 대상 주소, 로컬 경로가 포함될 수 있습니다. 공유하기 전에 문제와 관계없는 내용을 삭제하세요. 점검을 마친 뒤에는 일상적인 사용에 적합한 로그 수준으로 되돌려 불필요한 요청이 장기간 기록되지 않도록 하세요. 컨트롤 포트와 혼합 프록시 포트는 용도가 다릅니다. 전자는 관리 인터페이스용이고 후자는 프록시 요청을 받습니다. 관리 주소를 브라우저 프록시 설정에 입력하지 마세요. 기본 포트는 흔히 쓰이는 값일 뿐이므로 최종적으로는 클라이언트에 표시된 수신 정보를 확인해야 합니다.
클라이언트는 설정과 연결을 관리하지만 사용할 수 있는 프록시 서버를 자동으로 제공하지는 않습니다. 기존 서비스 구독을 가져오거나 직접 관리하는 노드 설정을 사용할 수 있습니다. 먼저 설정의 출처와 형식을 확인한 뒤 가져오세요. 공개 공유 링크는 이용 가능 여부와 접근 권한이 언제든 바뀔 수 있으므로 클라이언트의 정상 작동 여부를 확인하는 유일한 기준으로 삼지 않는 것이 좋습니다. 노드 및 구독 안내를 참고하세요.
규칙 모드와 전역 모드는 코어에 들어온 요청의 출구를 결정하고, TUN은 시스템 트래픽이 코어에 들어오는 방식을 결정합니다. 서로 다른 설정 항목입니다. TUN을 켠 뒤에도 규칙 기반 라우팅을 사용할 수 있으며, 전역 모드를 선택해도 모든 앱의 트래픽이 자동으로 처리되는 것은 아닙니다. 먼저 한 가지 트래픽 처리 방식으로 연결을 확인한 다음 필요에 따라 설정을 확장하세요. 자세한 내용은 프록시 모드 및 규칙 가이드를 참고하세요.
먼저 설정을 선택했는지 확인한 다음 시스템 프록시 또는 VPN 방식의 트래픽 처리가 작동하는지 살펴보세요. 연결 목록에 요청이 없다면 트래픽 처리 방식과 포트를 중점적으로 확인하고, 요청이 있다면 출구, 규칙, DNS 오류를 점검하세요. 노드, DNS 서버, 프록시 모드를 한꺼번에 바꾸면 어느 변경이 효과가 있었는지 파악하기 어렵습니다. 문제 해결에 안내된 순서대로 확인하세요.
먼저 클라이언트에서 제공하는 데이터 업데이트 및 네트워크 설정 메뉴를 사용하고, 현재 적용 중인 값을 확인한 뒤 변경 여부를 결정하세요. GeoIP는 주로 IP 위치 기반 규칙에 사용되며 모든 도메인 조회 문제를 해결하지는 않습니다. 포트는 로컬 프로그램과 코어 사이의 통신에 사용되므로 변경 후 수동 프록시 설정도 함께 수정해야 합니다. GeoIP 업데이트 안내와 포트 설정 안내를 각각 참고하세요.
NOTES / 사용 가이드
구체적인 증상에 맞춰 해결 단계를 확인하세요. 구독 업데이트, DNS 매핑, 트래픽 처리를 따로 점검하면 모든 네트워크 문제를 노드 장애로 오해하지 않을 수 있습니다.
클라이언트에 연결됨으로 표시되지만 웹페이지에 접속할 수 없다면 시스템 프록시, 포트 사용 여부, TUN 권한, DNS 설정, 규칙 적용, 노드 상태 순으로 확인해 문제 지점을 찾으세요.
문제 해결 목록 보기 →구독 업데이트 실패의 일반적인 원인을 오류 증상별로 정리합니다. 만료된 링크, 직접 연결 불가, 인증서 문제, 형식 비호환을 살펴보고 클라이언트별 자동 업데이트 간격 설정 위치도 안내합니다.
구독 업데이트 안내 보기 →DNS 조회 과정부터 시작해 Fake-IP가 예약된 주소를 사용해 연결을 빠르게 설정하는 원리를 설명하고, redir-host와 비교해 fake-ip-filter 허용 목록에 추가할 도메인도 안내합니다.
Fake-IP 매핑 알아보기 →