시스템에 맞는 클라이언트를 고르고 구독 가져오기, 규칙 기반 분기, TUN 모드를 설정해 첫 실행부터 유지 관리까지 차례로 확인하세요.
설정 안내 / CONFIGURATION
먼저 설정 파일이 정상적으로 작동하게 한 뒤 트래픽을 처리할 범위와 분기 규칙을 조정하세요. 클라이언트는 조작 화면을 제공하고, 코어는 연결을 처리하며, 구독은 노드와 설정 정보를 제공합니다. 이 셋은 서로 다른 요소입니다. 설치를 마쳤다고 바로 프록시를 사용할 수 있는 것은 아닙니다. 연결하려면 유효한 설정과 접속 가능한 서버가 필요합니다.
아래에는 실제 사용 순서에 따라 주요 설정을 정리했습니다. 클라이언트마다 메뉴 이름은 조금씩 다를 수 있으므로 버튼 위치보다 설정의 기능을 기준으로 확인하세요. 문제가 생기면 이 흐름을 따라 되짚어 보세요. 설정이 활성화됐는지, 프록시 그룹을 올바르게 선택했는지, 앱 트래픽이 코어에 전달되는지, 규칙이 어떤 출구를 선택했는지 확인하면 됩니다.
설정 또는 구독 페이지에 서비스 제공자가 안내한 링크를 추가하고 다운로드가 끝나면 해당 설정을 선택하세요. 구독 이름이 보인다고 적용된 것은 아닙니다. 프록시 화면에 노드와 프록시 그룹이 나타나는지 확인한 뒤 연결을 테스트하세요. 구독에는 노드, 규칙, DNS 설정 등이 포함될 수 있으며, 구성은 제공자가 어떤 형식으로 제공하는지에 따라 다릅니다. 가져오기 오류가 나면 클라이언트를 반복해서 재설치하지 말고 다운로드 상태와 설정 파싱 로그부터 확인하세요. 구독 링크에는 개인을 식별하는 접근 정보가 포함되는 경우가 많습니다. 화면 캡처나 문의, 메모 공유 시 주소 전체를 가리세요. 로컬 설정을 수정해야 한다면 업데이트 때 덮어쓰이지 않도록 클라이언트의 오버라이드 기능을 우선 사용하세요.
# 가져온 뒤 확인할 순서
설정 다운로드 완료
→ 설정을 선택하고 활성화
→ 프록시 화면에 노드와 프록시 그룹이 표시됨
→ 사용할 출구 선택
→ 실제로 사이트에 접속규칙 모드는 설정에 따라 각 연결의 경로를 정하므로 로컬 서비스와 외부 사이트를 함께 이용하기 좋습니다. 전역 모드는 코어로 들어온 연결을 전역 정책에 따라 처리하며, 특정 대상의 접속 결과를 잠시 비교할 때 유용합니다. 직접 연결 모드는 프록시를 거치지 않을 때의 동작을 확인하는 데 사용합니다. 세 모드는 트래픽이 코어에 들어온 뒤 처리되는 방식을 바꿀 뿐, 어떤 앱의 트래픽이 코어에 들어오는지는 결정하지 않습니다. 전역 모드로 바꿔도 연결 기록이 없다면 노드를 계속 바꾸기보다 시스템 프록시나 TUN이 트래픽을 가져오는지 먼저 확인하세요. 점검이 끝나면 원래 모드와 프록시 그룹 선택을 복원해 이후 테스트에 영향을 주지 않도록 하세요.
# config.yaml: 일상적인 트래픽 분기를 위한 모드 설정
mode: rule
# 코어에서 자주 사용하는 모드 값
# rule 규칙에 따라 출구 선택
# global 전역 정책에 따라 처리
# direct 직접 연결로 전송규칙 목록은 위에서부터 연결을 확인하며, 규칙과 일치하면 보통 그 아래 항목은 더 이상 검사하지 않습니다. 우선 적용할 도메인은 범위가 넓은 규칙보다 위에 배치하고, 마지막에는 MATCH로 기본 출구를 지정하세요. 사용자 규칙에 지정한 정책 이름은 현재 설정에 있어야 하며, 철자와 대소문자도 일치해야 합니다. 처음 수정할 때는 DIRECT로 특정 대상 하나를 테스트하고, 연결 로그에서 예상한 규칙이 적용되는지 확인한 다음 실제 프록시 그룹으로 바꾸세요. 노드만 바꾸는 것과 달리 규칙 기반 분기는 대상별로 다른 경로를 지정할 수 있지만 DNS, 도메인 정보, 규칙 순서에 더 큰 영향을 받습니다. 출처가 불분명한 규칙을 통째로 기존 구독 설정에 덮어쓰지 마세요.
# 예시: 순서 확인용이며 마지막 줄은 필요에 따라 조정
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECTTUN은 가상 네트워크 인터페이스로 트래픽을 가져오므로 더 많은 앱을 처리해야 할 때 유용하지만, 연결 속도를 높이는 기능은 아닙니다. 활성화하기 전에 시스템 프록시로 구독과 출구가 정상적으로 작동하는지 확인하고, 클라이언트 안내에 따라 서비스를 설치하거나 권한을 부여하세요. 다른 VPN, 가상 네트워크 어댑터, 보안 소프트웨어를 함께 사용하면 라우팅과 DNS가 서로 영향을 줄 수 있습니다. 활성화한 뒤에는 외부 사이트뿐 아니라 LAN 기기와 로컬 개발 서비스도 테스트하세요. 문제가 생기면 먼저 TUN을 끄고 결과를 비교한 뒤 라우팅, 인터페이스 인식, DNS 설정을 확인하세요. 예시는 관련 필드만 보여 주므로 기존 설정과 무관하게 전체를 그대로 바꾸면 안 됩니다.
# mihomo TUN 관련 필드 예시
tun:
enable: false
stack: mixed
auto-route: true
auto-detect-interface: true
# 활성화 전에 권한과 실행 중인 VPN 상태 확인평소에는 구독 만료 여부, 설정 업데이트 결과, 클라이언트 실행 상태를 중점적으로 확인하세요. 구독을 업데이트한 뒤에는 노드 목록과 프록시 그룹이 예상대로 유지되는지 확인합니다. 클라이언트를 업그레이드하기 전에는 로컬 오버라이드, 규칙, 필요한 설정을 저장하고 릴리스 노트를 읽으세요. 노드 속도 측정은 특정 테스트 대상에 대한 응답을 보여 줄 뿐, 실제 사이트 접속이나 다운로드 대역폭을 대신하지 않습니다. 문제가 생기면 발생 시간, 대상, 모드, 로그의 오류 유형을 기록하고 한 번에 변수 하나만 조정하세요. 로그를 공유하기 전에는 구독 주소, 인증 정보, 개인 네트워크 정보를 삭제하고, 점검을 마치면 임시로 높인 로그 수준을 평소 설정으로 되돌리세요.
# 일상 점검 목록
[ ] 구독 업데이트 완료, 현재 설정 활성화
[ ] 프록시 그룹 선택이 예상과 일치
[ ] 로컬 오버라이드 백업 완료
[ ] 로그 수준을 info로 복원
[ ] 종료 후 시스템 프록시가 원래대로 복원됐는지 확인이 코드는 필드와 점검 순서를 설명하기 위한 것으로, 프록시 노드가 포함된 완전한 설정 파일이 아닙니다. 구독을 사용 중이라면 기존 설정을 보존한 채 작은 범위부터 오버라이드하세요. 직접 작성할 때는 프록시 정의, 프록시 그룹 참조, 규칙 대상 간의 관계도 함께 맞춰야 합니다. 기본 사용 절차는 입문 가이드에서, 필드 간 의존성과 고급 설정은 전체 설명서에서 확인하세요.
규칙 / 전역 / 직접 연결
먼저 규칙 모드를 사용하고 프록시 그룹에서 노드나 자동 선택 정책을 고르세요. 전역 모드는 잠깐 비교 테스트할 때 적합하지만 모든 앱의 트래픽을 클라이언트로 자동 전달하지는 않습니다. 직접 연결도 코어가 선택하는 출구일 뿐, 시스템 프록시를 끄거나 클라이언트를 종료하는 것과는 다릅니다.
브라우저에서는 접속되지만 특정 앱만 실패한다면 해당 앱의 연결 기록이 있는지 먼저 확인하세요. 기록이 있으면 규칙과 출구를 살펴보고, 없다면 앱의 프록시 설정, 환경 변수, TUN이 처리하는 범위를 확인하세요. 이 두 유형을 구분하면 구독을 계속 바꾸는 것보다 원인을 찾기 쉽습니다.
시스템 프록시는 주로 운영체제의 프록시 설정을 따르는 앱에서 사용됩니다. 명령줄 도구, 게임, 자체 네트워크 설정을 사용하는 소프트웨어는 프록시를 별도로 지정해야 할 수 있습니다. TUN은 처리 범위를 넓힐 수 있지만 시스템 권한, 라우팅, 다른 네트워크 소프트웨어의 영향을 받으므로 모든 연결이 같은 방식으로 처리된다고 보장할 수는 없습니다.
기존 연결과 새 연결도 구분해야 합니다. 일부 앱은 기존 연결을 재사용하므로 모드를 바꾼 뒤 대상 페이지를 다시 열거나 연결을 새로 만들어 확인하세요. 테스트할 때 모드, 프록시 그룹, 연결 로그 정보를 함께 기록해야 변화가 어느 단계에서 비롯됐는지 판단할 수 있습니다.
플랫폼별 클라이언트 / CLIENT SHELF
처음 선택한다면 Clash Plus를 먼저 살펴보고, 사용하기 편한 인터페이스와 시스템 지원 여부를 기준으로 다른 클라이언트와 비교해 보세요. 같은 계열의 코어를 사용하더라도 클라이언트마다 설정 관리, 권한 요청, 서비스 실행 방식이 다를 수 있습니다. 설치 파일은 운영체제뿐 아니라 프로세서 아키텍처에 맞춰 선택하세요. 실행되지 않거나 형식이 지원되지 않는다는 메시지가 나와도 구독 문제와 혼동하지 마세요.
다운로드 페이지에서 클라이언트, 아키텍처별 다운로드, 설치 안내를 확인할 수 있으며 버전 정보도 해당 페이지를 기준으로 확인하세요. 현재 환경이 안정적으로 작동한다면 화면을 바꾸기 위해 모든 설정을 한꺼번에 옮길 필요는 없습니다. 먼저 설정을 백업하고 새 클라이언트에서 별도로 테스트한 뒤 기존 앱을 삭제할지 결정하세요. 두 클라이언트가 동시에 시스템 프록시를 변경하는 상황을 피할 수 있습니다.
Clash Plus를 먼저 사용해 보거나 Clash Verge Rev, FlClash, Clash Nyanpasu와 비교해 보세요. 설치 전에 시스템 아키텍처를 확인하고, 처음 실행한 뒤 구독을 가져와 시스템 프록시를 켜고 브라우저 접속을 테스트하세요.
TUN이 필요할 때 클라이언트 서비스와 관리자 권한을 확인하세요. 방화벽 알림은 실제 기능에 맞춰 처리하고 보안 기능 전체를 무작정 끄지 마세요. 프록시를 켠 뒤 모든 접속이 실패하면 로컬 수신 포트가 이미 사용 중인지, 코어가 실행됐는지, 시스템 프록시 주소가 클라이언트와 일치하는지 먼저 확인하세요.
다운로드 페이지로 이동Clash Plus, Clash Verge Rev, FlClash를 선택 기준으로 살펴볼 수 있으며, 보관된 ClashX Meta는 과거 사용 환경을 알아볼 때 적합합니다. Apple Silicon과 Intel용 설치 파일은 기기의 프로세서에 맞춰 선택하세요.
시스템 프록시, 백그라운드 서비스, 네트워크 확장 권한은 각각 의미가 다르므로 클라이언트 안내에 따라 하나씩 확인하세요. 설치 후 브라우저에서는 되지만 터미널에서 접속되지 않는다면 터미널 도구가 시스템 프록시를 사용하는지 살펴보세요. 다른 VPN을 사용 중이라면 하나를 종료한 뒤 테스트해 인터페이스나 DNS 충돌을 노드 문제로 오인하지 않도록 하세요.
다운로드 페이지로 이동다운로드 페이지에서 Clash Plus, Clash Meta for Android, FlClash, Surfboard를 비교할 수 있습니다. 가져오기 전에 구독 형식이 클라이언트와 호환되는지 확인하세요. 구독을 다운로드할 수 있다고 해서 포함된 모든 프로토콜을 현재 클라이언트가 해석할 수 있는 것은 아닙니다.
연결을 시작할 때 시스템 안내에 따라 VPN 권한을 허용하세요. 화면을 잠근 뒤 연결이 끊기거나 앱을 전환한 뒤 작동하지 않는다면 배터리 최적화, 백그라운드 활동 제한, 상시 알림 설정을 확인하세요. 앱별 분기 설정은 트래픽 처리 범위에도 영향을 줄 수 있으므로 특정 앱을 점검할 때 제외 여부를 확인하고 모바일 데이터와 Wi-Fi에서 각각 테스트하세요.
다운로드 페이지로 이동iOS용 Clash 클라이언트는 Clash Plus를 우선 추천합니다. 다운로드 페이지에서 App Store와 공식 사이트 clashplus.io로 이동할 수 있습니다. 설치 후 호환되는 설정을 가져오고, 시스템 안내에 따라 VPN 구성을 추가한 뒤 연결을 시작하세요.
Wi-Fi와 모바일 데이터 사이를 전환한 뒤 실제 접속을 다시 확인하는 것이 좋습니다. 설정을 가져올 수 없다면 링크가 웹페이지나 오류 메시지가 아니라 클라이언트가 지원하는 내용을 반환하는지 확인하세요. 상태 표시줄의 VPN 아이콘만 보고 작동 여부를 판단하지 말고 현재 프록시 선택과 대상 사이트 접속 결과도 확인하세요.
다운로드 페이지로 이동데스크톱에서는 Clash Verge Rev와 FlClash를 비교해 보세요. 설치할 때는 배포판에 맞는 패키지 형식을 확인해야 합니다. 서버나 라우터에서 사용하려면 mihomo 코어를 살펴볼 수 있지만, 코어 자체에는 데스크톱 클라이언트처럼 설정을 관리하는 화면이 없습니다.
데스크톱 시스템 프록시, 터미널 환경 변수, 백그라운드 서비스는 각각 따로 확인해야 합니다. 서비스를 통해 실행하면 설정 파일 위치, 실행 사용자, 권한이 직접 실행할 때와 다를 수 있습니다. 이 기기의 연결 문제를 해결하려고 LAN 수신을 바로 허용하지 마세요. 다른 기기와 공유해야 한다면 접근 제어를 설정하고 방화벽 경계를 확인하세요.
다운로드 페이지로 이동프로젝트 출처 / OPEN SOURCE
클라이언트를 고를 때는 이름만 볼 것이 아니라 프로젝트 출처와 기능 범위를 구분해야 합니다. Clash 도움말 센터는 다운로드 링크와 사용 자료를 정리하며, 각 클라이언트의 개발팀은 아닙니다. 구체적인 기능, 라이선스 범위, 유지 관리 상태는 해당 프로젝트의 안내를 확인하세요. 이 사이트는 프록시 노드를 제공하지 않으며, 클라이언트만으로 사용 가능한 서버나 구독을 대신할 수도 없습니다.
Clash는 처음에 규칙 기반 프록시 코어를 중심으로 생태계를 이루었고, 이후 여러 운영체제용 GUI 클라이언트가 등장했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티에서 호환 코어와 인터페이스를 개발했으며, 그중 mihomo는 Clash Meta의 기술 방향을 이어갔습니다. 따라서 가이드에는 Clash, Clash Meta, mihomo 같은 이름이 계속 등장하지만 모든 상황에서 서로 바꿔 쓸 수 있는 것은 아닙니다.
오래된 가이드에 나온 버튼 위치, 지원 프로토콜, 설정 필드는 달라졌을 수 있습니다. 설정을 불러올 수 없다면 바탕 화면 아이콘만 보고 판단하지 말고 실제로 사용하는 클라이언트와 코어를 확인하세요. 보관된 클라이언트는 과거 환경을 알아볼 때 참고하고, 새로 설치할 때는 현재 시스템에 적합하며 계속 유지 관리되는 프로그램을 우선 살펴보세요.
GUI 클라이언트는 구독 관리, 시스템 프록시 전환, 설정 화면을 담당하고, 코어는 프로토콜 처리, 라우팅, DNS 등의 기능을 담당합니다. 규칙 세트는 별도 프로젝트에서 관리될 수도 있습니다. 클라이언트에 설정 항목이 추가됐다고 모든 코어가 같은 이름의 필드를 지원하는 것은 아닙니다. 한 앱에서 가져올 수 있는 구독이라고 해서 다른 앱도 전부 처리할 수 있는 것은 아닙니다.
오픈소스 저장소를 통해 기능 구현 방식, 라이선스, 알려진 문제를 확인할 수 있지만 특정 노드가 현재 네트워크에 적합하다는 증거가 되지는 않습니다. 문제를 제보할 때는 클라이언트 이름, 운영체제, 재현 단계, 민감 정보를 가린 오류 내용을 함께 적으세요. 연결 실패 화면만 올리는 것보다 해당 기능을 담당하는 프로젝트에 문의하는 편이 대체로 효과적입니다.
mihomo는 Clash 스타일의 YAML 설정을 폭넓게 지원하며 프로토콜, 규칙, DNS 기능을 확장했습니다. 옮길 때는 필드와 프로토콜을 하나씩 확인하고, 특히 프록시 그룹 이름, 규칙 공급자, 로컬 파일 경로, TUN 설정을 살펴보세요. 파싱에 성공했다는 것은 문법과 구조가 검사됐다는 뜻일 뿐, 실제 연결도 확인해야 합니다.
기존 설정의 사본을 보관하고 노드와 기본 규칙부터 옮긴 뒤 오버라이드, 스크립트, 복잡한 DNS 설정을 단계적으로 복원하세요. 구독 업데이트가 로컬 파일을 덮어쓴다면 클라이언트가 지원하는 병합 또는 오버라이드 기능에 사용자 설정을 넣으세요. 그러면 구독은 노드 업데이트를, 로컬 설정은 개인별 분기 방식을 맡아 역할을 분명히 나눌 수 있습니다.
구독 업데이트는 주로 노드와 설정 정보를 가져옵니다. 클라이언트 업그레이드는 인터페이스, 시스템 연동, 패키지 구성 요소를 바꿉니다. 코어 업데이트는 프로토콜과 라우팅 기능에 영향을 줄 수 있습니다. 이 세 가지 업데이트는 항상 동시에 이뤄지는 것이 아니며 같은 작업으로 보면 안 됩니다. 일부 클라이언트는 앱을 배포할 때 코어도 함께 제공하고, 다른 클라이언트는 코어를 별도로 바꾸는 기능을 제공하므로 실제 안내를 확인하세요.
안정적으로 사용 중이라면 릴리스 노트를 주기적으로 확인하되 모든 구성 요소를 한꺼번에 바꿀 필요는 없습니다. 업그레이드 전에 구독 출처와 로컬 오버라이드를 저장하고, 업그레이드 후 같은 대상을 이용해 브라우저, 자주 쓰는 앱, LAN 서비스를 테스트하세요. 특정 앱만 문제가 생기면 트래픽 처리 범위를 확인하고, 새 연결이 모두 실패하면 코어 실행 상태, 설정 파싱, 노드 접속 가능성을 점검하세요.
최근 글 / FIELD NOTES
기본 연결이 정상적으로 작동한 다음 개인별 규칙과 시스템 연동을 설정하세요. 아래 글은 날짜 역순으로 정렬되어 있으며 규칙 우선순위, 첫 실행 점검, Windows 설치 중 발생하는 권한 및 포트 문제를 다룹니다. 현재 환경을 확인하며 읽고, 특정 플랫폼용 절차를 다른 시스템에 그대로 적용하지 마세요.
자주 쓰는 규칙 유형의 작성법과 매개변수를 살펴보고, 위에서부터 규칙을 적용하는 방식과 no-resolve의 역할, MATCH 기본 규칙의 위치를 설명합니다.
글 읽기 →첫 실행 후 반드시 확인할 혼합 포트, 구독 가져오기, 모드 선택, 연결 테스트를 정리하고 플랫폼별 초보자가 놓치기 쉬운 단계도 짚어 봅니다.
글 읽기 →설치부터 구독 가져오기, 시스템 프록시 활성화, 서비스 모드 설정까지 Windows 환경을 차례로 구성합니다. 방화벽 알림, 포트 사용 중, 자동 시작이 작동하지 않는 문제의 해결 방법도 설명합니다.
글 읽기 →