설정 항목을 하나씩 살펴보며 구독, 코어, 시스템 네트워크의 역할을 구분해 보세요.
웹페이지는 열리는데 특정 앱에서 연결이 계속 실패한다면, 먼저 해당 앱의 트래픽이 클라이언트로 전달되는지 확인하세요. 구독은 가져왔지만 활성화할 때 오류가 난다면 설정 항목과 코어 지원 여부를 먼저 점검해야 합니다. 아래에서는 다섯 가지 기능별 설정 위치를 정리합니다. 예시에는 설정 일부만 포함되어 있으므로 프록시와 프록시 그룹이 있는 전체 설정 파일을 대신할 수 없습니다.
내부 네트워크 주소는 직접 연결하고 나머지 요청은 정책에 따라 처리하려면 프록시 모드를 ‘규칙’으로 설정하세요. 코어는 규칙을 위에서부터 확인하고 처음 일치하는 규칙을 적용하므로, 구체적인 도메인은 범용 규칙보다 앞에, MATCH는 마지막에 배치해야 합니다. 전역 스위치만 사용하는 방식과 달리 규칙을 활용하면 서비스별로 다른 연결 경로를 유지할 수 있습니다. 설정을 바꾼 뒤 ‘연결’에서 적용된 규칙과 정책을 확인하세요. 구독 업데이트로 로컬 수정 사항이 덮어써진다면 클라이언트의 오버라이드 기능에 사용자 설정을 저장하는 편이 좋습니다.
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT아래 예시는 문법만 보여 주며 세 규칙 모두 직접 연결됩니다. 실제 프록시 정책에는 설정 파일에 정의된 프록시 그룹을 지정해야 합니다.
규칙 순서와 MATCH 설명 보기 →설정에서 지원하지 않는 프로토콜이라는 안내가 표시되거나 unknown field 오류가 발생하면, 먼저 클라이언트에서 사용하는 코어를 확인하세요. mihomo는 Clash Meta 프로젝트의 개발을 이어받아 프로토콜, 규칙 제공자, 트래픽 스니핑 등의 기능을 확장했습니다. 데스크톱 앱의 인터페이스가 같더라도 모든 클라이언트가 동일한 설정 항목을 지원하는 것은 아닙니다. 원본 코어 설정과 비교해 마이그레이션할 때는 파일 이름만 바꾸지 말고 확장된 설정 항목을 하나씩 확인해야 합니다. 최소 설정으로 시작해 확장 기능을 단계적으로 켜면 오류 범위를 좁히고 쉽게 되돌릴 수 있습니다.
mode: rule
log-level: info
ipv6: false기본 설정 항목 예시입니다. IPv6 사용 여부는 현재 네트워크와 구독 환경에 맞춰 판단하세요.
mihomo와 원본 코어의 차이 보기 →링크를 가져온 뒤 먼저 구독 항목이 목록에 표시되는지 확인하고, 해당 항목을 현재 설정으로 선택하세요. 목록에 구독이 보인다고 코어에 로드된 것은 아닙니다. 로그에 파싱 오류가 있는지도 확인해야 합니다. 다운로드한 파일을 직접 편집하는 것보다 클라이언트 오버라이드를 사용하면 포트와 규칙 같은 로컬 설정을 업데이트 후에도 유지하기 쉽습니다. 업데이트에 실패하면 링크의 유효 기간, 응답 내용, 가져오기 경로를 확인한 뒤 프록시를 통해 업데이트해야 하는지 살펴보세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 전체 링크를 공개 게시판에 올리지 마세요.
profile:
store-selected: true
store-fake-ip: true이 설정은 정책 선택과 Fake-IP 매핑을 저장하는 용도이며, 구독을 다운로드하거나 구독 주소를 저장하지 않습니다.
구독 가져오기 방법 보기 →브라우저는 정상인데 터미널이나 다른 앱에서 연결되지 않으면 해당 앱이 수동 프록시 설정을 지원하는지 먼저 확인하세요. 시스템 프록시는 관련 설정을 따르는 프로그램에만 적용되며, TUN은 가상 네트워크 인터페이스를 통해 라우팅 조건에 해당하는 트래픽을 처리합니다. 사용 전에 클라이언트의 서비스 모드 또는 관리자 권한을 확인하고, 라우팅 충돌을 막기 위해 다른 VPN은 일시 중지하세요. TUN은 모든 연결 문제를 해결하는 만능 스위치가 아닙니다. 노드 자체를 사용할 수 없다면 켜도 연결에 실패합니다. 설정을 변경한 뒤 DNS, 연결 기록, LAN 접근 여부도 확인하세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: truemihomo 설정 일부 예시입니다. 실제 권한과 DNS 처리 방식은 플랫폼과 클라이언트에 따라 다릅니다.
TUN 및 시스템 프록시 문제 해결 보기 →같은 구독이 컴퓨터에서는 작동하지만 휴대폰에서 불러오기에 실패하더라도 링크가 만료됐다고 단정하지 마세요. 먼저 두 기기의 코어, 프로토콜 지원 및 설정 형식을 비교한 다음 로컬 파일 경로 등 플랫폼별 항목을 확인하세요. 규칙과 프록시 그룹은 대체로 재사용하기 쉽지만 TUN, 시스템 프록시, 시작 서비스는 기기별로 설정해야 합니다. 클라이언트 데이터 폴더 전체를 복사하기보다 구독을 옮기고 로컬 옵션을 다시 설정하는 편이 문제를 찾기 쉽습니다. YAML 들여쓰기에는 공백을 사용하세요. 가져온 뒤 기본 연결을 확인하고 사용자 규칙을 복원하세요.
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info포트는 예시이며 클라이언트에서 실제로 사용하는 포트는 인터페이스 설정에 따라 달라질 수 있습니다.
설정 이전 및 연결 확인 보기 →먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 클라이언트를 선택하세요.
Clash는 클라이언트 생태계이며 모든 기기에 같은 프로그램을 설치하는 것은 아닙니다. 다운로드 페이지에서 운영체제별 클라이언트를 확인하고 추천 항목과 지원이 중단된 보관용 프로젝트를 구분할 수 있습니다. 처음이라면 Clash Plus부터 시작해 보세요. 특정 클라이언트에 익숙하다면 설정 호환성을 확인한 뒤 선택해도 됩니다. 클라이언트를 설치해도 구독이 자동으로 생성되지는 않습니다. 연결에 필요한 설정은 사용 권한이 있는 서비스에서 받아야 합니다.
데스크톱에서 작업하거나 그래픽 인터페이스로 설정하려는 사용자에게 적합합니다. 다운로드 전에 시스템의 ‘정보’에서 기기 사양을 확인하고, 설치 후 서비스 모드와 시스템 프록시를 점검하세요.
Clash Plus와 Clash Verge Rev 등 다양한 클라이언트를 한 플랫폼 페이지에서 확인할 수 있습니다. 창이 갑자기 종료되면 오류를 기록한 뒤 실행 환경과 포트 사용 여부를 확인하세요. 반복해서 덮어 설치하는 것만으로는 원인을 파악하기 어렵습니다. 처음 테스트할 때는 프록시 클라이언트를 하나만 실행해 여러 프로그램이 시스템 프록시를 서로 변경하지 않도록 하세요.
다운로드 페이지로 이동Apple 메뉴의 ‘이 Mac에 관하여’에서 Apple Silicon인지 Intel인지 확인한 뒤 해당 아키텍처에 맞는 설치 파일을 다운로드하세요. 잘못된 파일을 설치하면 실행되지 않을 수 있습니다.
Clash Plus, Clash Verge Rev, FlClash는 각각 인터페이스가 다릅니다. 처음 실행할 때 시스템 안내에 따라 권한을 허용하고, 네트워크 확장 프로그램이나 보조 서비스가 필요하면 먼저 설명을 읽어 보세요. 브라우저가 여전히 이전 프록시를 사용한다면 클라이언트를 여러 개 실행하지 말고 시스템 네트워크 설정을 확인하세요. 설정을 옮길 때는 로컬 경로도 다시 점검해야 합니다.
다운로드 페이지로 이동휴대폰과 태블릿 사용자는 먼저 프로세서 아키텍처를 확인하고 기기에 맞는 패키지를 선택하세요. 처음 연결할 때 시스템에서 VPN 연결 권한을 요청합니다.
Clash Plus, Clash Meta for Android, FlClash, Surfboard는 설정 지원 범위가 서로 다르므로 파일 확장자만으로 호환 여부를 판단할 수 없습니다. 화면이 꺼진 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행 권한, 네트워크 전환 기록을 확인하세요. 앱별 라우팅 설정에 따라 프록시를 사용하는 앱이 달라질 수 있으니 현재 클라이언트 설정도 살펴보세요.
다운로드 페이지로 이동iPhone 및 iPad 사용자는 다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 설치한 뒤 앱 안내에 따라 설정을 추가하고 VPN 권한을 허용하세요.
처음 사용하기 전에 스토어 페이지에서 시스템 요구 사항을 확인하고 구독 형식이 지원되는지 살펴보세요. Clash Plus 공식 웹사이트는 clashplus.io이며 제품 정보를 확인할 수 있습니다. 네트워크를 전환한 뒤 연결 문제가 생기면 구독, DNS, 라우팅을 한꺼번에 변경하지 말고 앱 상태와 시스템 VPN 상태가 일치하는지 확인한 다음 다시 테스트하세요.
다운로드 페이지로 이동데스크톱 사용자는 배포판에 맞는 패키지 형식을 선택하세요. 다운로드 페이지에서 Clash Verge Rev와 FlClash를 받을 수 있습니다. 사용 전에 데스크톱 환경과 필요한 종속성을 확인하세요.
서버나 라우터 사용자는 코어 다운로드 섹션을 별도로 확인할 수 있습니다. 단, 명령줄 코어에는 그래픽 인터페이스가 없으며 모든 프로세스에 프록시를 자동으로 설정하지 않습니다. 터미널 프로그램은 프록시 옵션을 별도로 지정해야 할 수 있습니다. 서비스를 등록할 때는 실행 사용자, 작업 디렉터리, 설정 파일 읽기 권한을 확인하세요. 먼저 포그라운드에서 정상 실행되는지 확인한 다음 백그라운드 실행을 설정하세요.
다운로드 페이지로 이동Linux 펭귄 그래픽: Font Awesome, CC BY 4.0.
문제가 설치, 설정 파일 로드, 실제 요청 중 어느 단계에서 발생했는지 먼저 확인하세요. 한 번에 설정 하나만 바꾸고 결과를 기록하면 모든 스위치를 동시에 변경하는 것보다 원인을 찾기 쉽습니다.
먼저 프록시를 끈 상태에서 기존 네트워크에 접속할 수 있는지 확인한 뒤, 클라이언트에서 구독을 선택하고 정상적으로 불러왔는지 살펴보세요. 다음으로 프록시 모드, 프록시 그룹 선택, 시스템 프록시 상태를 확인하세요. 특정 앱만 실패한다면 해당 앱이 시스템 프록시를 따르는지 확인하고, 모든 요청이 실패하면 로그에서 구체적인 오류를 찾으세요. 설치 완료와 연결 성공은 다릅니다. 설치 파일, 구독 설정, 사용 가능한 연결 경로는 각각 별개의 단계입니다. 자세한 방법은 구독 설정 가이드를 참고하세요.
먼저 링크가 만료되지 않았는지, 전체 주소를 복사했는지, 서버가 설정 파일 대신 웹페이지를 반환하지는 않았는지 확인하세요. 다운로드는 되지만 로드되지 않는다면 설정 형식과 프로토콜 지원 여부를 점검해야 합니다. 재설치해도 만료된 구독 링크는 복구되지 않습니다. 현재 사용할 수 있는 설정은 보관하고 업데이트 오류를 기록한 뒤 문제 해결 안내에 따라 네트워크 요청 실패와 파싱 오류를 구분하세요.
두 기능을 항상 함께 켜야 하는 것은 아닙니다. 먼저 시스템 프록시로 브라우저 접속을 확인하고, 다른 앱의 트래픽도 처리해야 한다면 클라이언트 안내에 따라 TUN을 활성화하세요. 두 기능은 트래픽을 처리하는 경로가 다르므로 함께 사용할지는 플랫폼 구현과 필요에 따라 결정해야 합니다. TUN을 켠 뒤에는 라우팅, DNS, 다른 VPN과 충돌하는지 확인하세요. 스위치가 켜진 것만으로 정상 작동을 판단할 수는 없습니다. 기본 설정 순서에 따라 하나씩 확인하세요.
시작 시 자동 실행은 일반적으로 클라이언트 실행 여부만 제어하며, 구독 로드와 서비스 시작, 시스템 프록시 복구까지 모두 성공한다고 보장하지 않습니다. 먼저 시스템에 로그인한 뒤 클라이언트 상태와 로그를 확인하고, 시스템에서 시작 항목을 차단하지 않았는지 살펴보세요. TUN을 사용한다면 서비스 실행 상태도 확인해야 합니다. 먼저 수동으로 정상 연결한 다음 자동 실행 과정을 점검하면 구독 오류와 시작 권한 문제를 구분하기 쉽습니다. 설정 위치는 클라이언트 사용 가이드를 참고하세요.
프로젝트 출처와 유지 관리 범위
클라이언트 인터페이스, 프록시 코어, 구독 출처를 구분한 뒤 어떤 부분을 업데이트해야 하는지 확인하세요.
이 사이트는 설치 안내와 한국어 사용 자료를 정리합니다. 모든 클라이언트를 개발하는 곳도 아니며 프록시 노드를 제공하지도 않습니다. 다운로드 안내와 문제 해결 방법은 상위 프로젝트와 기기 환경에 맞춰 활용하세요. 지원하지 않는 설정 항목, 시작되지 않는 서비스, 구독 응답 오류가 발생하면 먼저 어느 구성 요소에서 문제가 생겼는지 확인해야 해결 방향을 정할 수 있습니다.
원본 Clash를 바탕으로 YAML 설정, 프록시 그룹, 규칙 기반 라우팅을 활용하는 방식이 자리 잡았습니다. 이후 여러 파생 코어와 그래픽 클라이언트가 등장했습니다. mihomo는 Clash Meta의 개발 방향을 이어받았습니다. 따라서 이전 가이드의 Clash Meta와 현재 문서의 mihomo는 대체로 같은 개발 계보를 가리키지만, 구체적인 설정 항목은 사용 중인 코어의 문서를 기준으로 확인해야 합니다.
일부 구형 클라이언트는 유지 관리가 중단되어 다운로드 페이지에 보관용으로 표시되어 있습니다. 보관된 프로그램이 실행된다고 해서 최신 프로토콜이나 새로운 시스템 환경을 지원하는 것은 아닙니다. 새 기기에는 계속 유지 관리되는 클라이언트를 우선 고려하세요. 구형 기기를 옮길 때는 설정을 먼저 백업하고 프로토콜 및 규칙 호환성을 확인한 뒤, 익숙한 이름만 보고 선택하지 마세요.
mihomo 소스 코드, 이슈 논의, 릴리스 기록은 공개 저장소에서 확인할 수 있으며 프로젝트는 GPL-3.0 라이선스를 사용합니다. 공개된 코드는 설정과 실행 동작을 이해하는 데 도움이 되지만, 그래픽 클라이언트마다 메뉴, 권한 설정 방식, 업데이트 주기가 같다는 뜻은 아닙니다. 각 클라이언트의 라이선스와 사용 안내는 해당 프로젝트에서 별도로 확인하세요.
버그가 의심되면 문제를 재현할 수 있는 최소 설정, 시스템 정보, 관련 로그를 먼저 저장하세요. 공유하기 전에 구독 주소, 인증 정보와 기타 개인정보를 삭제해야 합니다. 단순히 ‘연결 실패’라고 설명하는 것보다 재현 절차를 구체적으로 제시하면 논의에 도움이 되고, 서버 문제를 클라이언트 버그로 잘못 보고하는 일도 줄일 수 있습니다.
Clash Verge Rev, FlClash 등 그래픽 클라이언트는 구독 관리, 스위치, 로그 창을 제공하고 코어는 설정 파일을 파싱해 규칙을 적용하고 외부 연결을 구축합니다. 클라이언트가 설정을 병합하거나 덮어쓸 수 있으므로 로컬 파일을 편집한 뒤에는 구독 원본의 특정 행만 확인하지 말고 최종 적용된 내용을 확인해야 합니다.
인터페이스에는 연결됨으로 표시되는데 요청이 실패한다면 연결 기록에 대상 요청이 있는지, 어떤 규칙이 적용됐는지, 최종적으로 어떤 정책이 선택됐는지 확인하세요. 요청이 코어에 들어오지 않았다면 시스템 프록시나 TUN 라우팅을 확인하고, 요청이 들어왔다면 DNS와 외부 연결 오류를 점검하세요. 이렇게 하면 문제 범위를 구체적인 연결 단계로 좁힐 수 있습니다.
클라이언트 업데이트는 보통 인터페이스, 시스템 연동, 코어 기능을 변경합니다. 구독 업데이트는 설정에 포함된 프록시, 정책 또는 규칙의 출처를 바꿉니다. 두 작업은 서로 다릅니다. 구독 새로고침에 성공해도 클라이언트가 업데이트되는 것은 아니며, 클라이언트를 새로 설치해도 만료된 구독이 다시 작동하지는 않습니다. 업데이트하기 전에 안내를 읽고 사용할 수 있는 설정을 하나 보관하세요.
업그레이드 후에는 복잡한 오버라이드를 복원하기 전에 기본 웹 접속, LAN 접속, 자주 사용하는 앱을 먼저 확인하세요. 새 문제가 생기면 변경 전후의 동작을 기록하고 필요하면 정상 작동이 확인된 설정으로 되돌리세요. 오래 사용할 계획이라면 DNS, TUN, 사용자 규칙의 변경 사항을 간단히 기록해 두세요. 여러 차례 업데이트한 뒤에도 기존 설정을 복구하기 쉽습니다.
아래 명령은 소스 코드를 가져오기만 합니다. 클라이언트를 설치하거나 프록시를 자동으로 활성화하지 않습니다. 일반 사용자는 위의 설치 안내를 이용하세요. 설정 구현을 살펴보거나 이슈를 제출할 때는 저장소 문서를 확인하면 됩니다.
MetaCubeX / mihomo 저장소 열기 →git clone https://github.com/MetaCubeX/mihomo.git먼저 Git을 설치한 뒤 복사한 명령을 터미널에서 실행하세요.
증상에 맞는 안내를 찾아 오류 메시지 원문을 보관한 뒤 계속 확인하세요.
로그, 규칙, 시작 오류는 각각 다른 문제 경로에 해당합니다. 클라이언트가 시작되지 않으면 먼저 실행 환경을 확인하세요. 창은 열리지만 접속이 실패한다면 설정과 요청 로그를 살펴보고, 일부 웹사이트만 잘못된 경로로 연결된다면 규칙 순서를 먼저 확인하세요. 아래 글에서 각 항목을 자세히 설명하므로 기본 설정을 마친 뒤 이어서 확인할 수 있습니다. 문제가 생길 때마다 재설치부터 시작할 필요는 없습니다.
두 번 클릭하면 창이 잠깐 떴다가 사라지거나 시작 화면에서 멈추나요? 이 글에서는 WebView2 런타임, 포트 사용 여부, 손상된 설정 파일, 남아 있는 서비스 모드, 백신 차단 순으로 점검하고 플랫폼별 정리 및 재설치 방법을 안내합니다.
시작 충돌 해결 방법 보기 →규칙은 작성한 순서대로 위에서 아래로 확인하며 처음 일치하는 규칙이 적용됩니다. 이 글에서는 DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, IP-CIDR, GEOIP, MATCH 문법을 설명하고 no-resolve의 역할과 규칙 정렬 원칙을 안내합니다.
사용자 규칙 설명 보기 →mihomo(구 Clash Meta)는 원본 코어를 바탕으로 VLESS, Hysteria2, TUIC 등의 프로토콜을 지원하고 rule-providers 확장 문법과 sniffer 등의 설정 항목을 추가했습니다. 이 글에서는 두 코어의 차이를 항목별로 비교하고 설정을 옮길 때 주의할 점을 정리합니다.
코어 및 설정 항목 비교 보기 →