사용 설명서 / 완벽 가이드

Clash 완벽 가이드

설치부터 트래픽 분기까지, 트래픽 흐름을 따라 클라이언트를 설정합니다. 첫 연결만 빠르게 마치려면 빠른 시작 가이드를 먼저 확인하세요. 설정을 이해하거나 규칙을 검증하고 문제를 해결하려면 이 가이드의 관련 장을 참고하면 됩니다.

01 핵심 개념: 진입점, 정책, 출구

먼저 UI와 코어를 구분하세요

Clash 생태계의 클라이언트는 보통 UI와 코어, 두 계층으로 나뉩니다. UI는 설정 관리, 연결 상태 표시, 시스템 설정 변경을 담당하고, 코어는 로컬 진입점을 열어 두고 설정을 해석하며 규칙을 적용한 뒤 선택된 방식으로 연결을 만듭니다. mihomo는 이 생태계에서 널리 쓰이는 코어지만, 클라이언트 이름이나 아이콘, 메뉴 순서만으로 특정 코어 기능이 활성화됐다고 판단할 수는 없습니다. 설정이 작동하는지 확인하려면 현재 코어와 설정 형식, 해당 클라이언트가 설정을 어떻게 지원하는지 함께 살펴봐야 합니다. 예를 들어 코어가 지원하는 설정 항목에 UI 스위치가 없을 수 있고, 반대로 UI에서 저장한 스위치가 설정 적용 시 파일의 같은 항목을 덮어쓸 수도 있습니다.

연결은 어떤 경로를 거치나요?

데스크톱 브라우저를 예로 들면, 먼저 브라우저가 시스템 프록시를 사용할지 결정합니다. 시스템 설정을 따르는 경우 요청은 클라이언트가 수신 대기 중인 로컬 포트로 들어갑니다. 코어는 목적지를 확인한 다음 현재 모드에 따라 규칙을 조회하거나 글로벌 그룹을 사용하거나 직접 연결합니다. 규칙에 일치한 결과는 내장 정책일 수도 있고 설정 파일에 정의된 프록시 그룹일 수도 있으며, 프록시 그룹이 실제 출구를 선택합니다. 로그의 목적지 주소, 일치한 규칙, 정책 그룹, 출구는 서로 다른 항목입니다. 문제를 해결할 때는 이 경로를 따라 확인하세요. 웹페이지가 열리지 않는다고 바로 노드를 바꾸거나, 클라이언트에 스위치가 켜져 있다는 이유만으로 모든 프로그램의 트래픽이 경로에 들어왔다고 단정하지 마세요.

혼동하기 쉬운 경계가 하나 더 있습니다. 앱이 클라이언트를 거치지 않고 직접 네트워크에 접속하는 경우와, 클라이언트를 거친 뒤 DIRECT로 판정되는 경우는 모두 로컬 네트워크를 사용할 수 있지만, 후자의 경우에만 Clash의 정책 판정이 적용되며 보통 연결 기록에서도 확인할 수 있습니다. 반대로 목록에 연결 하나가 나타났다는 것은 코어가 요청을 받았다는 뜻일 뿐입니다. 웹페이지가 실제로 열리는지는 DNS 조회 결과, 출구 연결, 대상 서비스의 응답에 달려 있습니다. 목록에 기록이 있다는 것만으로 연결 성공을 판단할 수 없고, 클라이언트를 종료한 뒤에도 웹페이지가 열린다는 사실만으로 이전에 프록시 경로를 거치지 않았다고 단정할 수도 없습니다.

설정·구독·노드의 관계

설정은 함께 불러올 수 있는 옵션의 모음이며, 흔히 YAML 형식으로 제공됩니다. 노드는 프록시 출구의 연결 정보를 나타내고, 프록시 그룹은 여러 출구 중 선택하는 방식을 정하며, 규칙은 요청을 해당 정책으로 전달합니다. 구독은 전체 설정을 반환할 수도 있고, 노드 목록이나 클라이언트가 인식하는 다른 형식을 반환할 수도 있습니다. 가져온 뒤 노드 몇 개가 보인다고 해서 규칙, DNS 설정, 사용자 지정 프록시 그룹까지 함께 제공된 것은 아닙니다. 먼저 설정 화면에서 현재 선택된 항목을 확인하고, 프록시 그룹과 규칙 화면에 필요한 항목이 있는지 살펴보세요. 다른 설정으로 전환했을 때 그룹 이름이 같더라도 같은 출구가 포함됐다고 볼 수는 없습니다.

DNS는 도메인 이름을 IP 주소로 변환합니다. DNS 조회 성공과 출구 연결 성공은 별개의 문제입니다. 트래픽 진입 경로와 실제 설정에 따라 앱, 로컬 시스템 또는 코어에서 DNS 조회가 이뤄질 수 있습니다. 로그에 IP 주소만 표시된다면 도메인 규칙이 매칭될 정보가 충분하지 않을 수 있습니다. 로그에 도메인이 있고 규칙도 올바르게 매칭됐다면 프록시 그룹과 연결 수립 과정을 중점적으로 살펴보세요. 처음부터 DNS, 규칙, 진입점을 한꺼번에 바꿀 필요는 없습니다. 먼저 반복해서 확인할 수 있는 연결 하나를 만든 뒤 관련 장을 따라 설정을 확장하세요. 각 장을 마칠 때마다 정상 작동이 확인된 상태를 보존하면, 이후 문제가 생겼을 때 같은 상태로 되돌려 비교할 수 있습니다.

02 클라이언트 선택: 플랫폼과 설정 지원

플랫폼별로 후보를 좁히세요

Windows, macOS, Android, iOS에서는 Clash Plus부터 비교해 보세요. 이 가이드에서는 우선 확인할 클라이언트로 선정했습니다. Linux에서는 Clash Verge Rev를 먼저 살펴본 뒤 FlClash와 비교할 수 있습니다. 이 추천은 선택의 출발점일 뿐, 속도나 안정성 순위가 아닙니다. 시스템마다 네트워크 진입 방식, 권한 안내, 백그라운드 실행 방식이 다릅니다. 같은 이름의 클라이언트라도 플랫폼별로 설정 가져오기 형식, 로그 위치, 프록시 모드를 각각 확인하세요. 데스크톱 메뉴 위치를 모바일 조작 방법으로 그대로 적용할 수는 없습니다. 자세한 설치 경로는 다운로드 페이지를 확인하세요.

플랫폼별 후보 및 설치 전 확인 사항
플랫폼클라이언트 후보확인 사항
WindowsClash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu, Clash for Windows(지원 종료)시스템 아키텍처, 시스템 프록시, 서비스 권한
macOSClash Plus, Clash Verge Rev, FlClash, ClashX Meta(지원 종료)칩 종류, 네트워크 확장 권한
AndroidClash Plus、Clash Meta for Android、FlClash、Surfboard설치 파일 아키텍처, VPN 권한, 백그라운드 제한
iOSClash Plus(App Store)시스템 호환성 요구 사항, VPN 구성 권한
LinuxClash Verge Rev、FlClash배포판 패키지 형식, 아키텍처, 데스크톱 프록시 지원

일상적인 작업으로 클라이언트 비교하기

처음 설정할 때는 옵션의 개수보다 현재 상태를 쉽게 확인할 수 있는지가 중요합니다. 최소한 네 곳을 확인하세요. 설정 화면에서 사용 중인 파일을 명확히 알 수 있는지, 프록시 화면에서 각 그룹의 현재 선택 항목을 볼 수 있는지, 연결 화면에서 테스트 요청을 목적지별로 구분할 수 있는지, 종료 후 시스템의 기존 설정을 복원할 수 있는지 살펴보세요. 주된 용도가 구독 가져오기와 출구 전환이라면 이 항목만으로도 기본적인 비교가 가능합니다. 로컬 규칙을 덮어써야 한다면 별도의 오버라이드 설정이나 병합 기능이 있는지, 원격 업데이트 후 어떤 순서로 적용되는지도 확인해야 합니다. 관련 기능이 보이지 않는다면 로컬 복사본으로 먼저 시험하고, 구독 원본 하나만 작업 파일로 사용하지 마세요.

여러 기기를 사용하는 경우 규칙을 관리할 주 기기를 먼저 정하고, 나머지 기기에는 같은 기본 설정을 가져오세요. 데스크톱은 특정 앱만 대상으로 먼저 시험할 수 있는 경우가 많지만, 모바일은 대개 시스템 VPN 진입점에 의존합니다. 따라서 상태 표시줄 아이콘과 앱 내 로그를 함께 확인해야 합니다. 기기에 업무용 VPN이 이미 있다면 두 VPN이 시스템 제한 안에서 함께 작동할 수 있는지 먼저 확인하세요. 함께 사용할 방법이 없다면 임시 테스트 때문에 조직에서 요구하는 네트워크 설정을 제거하지 마세요. 되돌리는 방법도 클라이언트 선택 기준에 포함해야 합니다. 예를 들어 기존 클라이언트의 로컬 파일은 보관하되, 두 클라이언트가 같은 시스템 프록시 진입점을 동시에 수정하지 않도록 하세요.

마이그레이션은 형식부터, 기능은 그다음 비교하세요

지원이 중단된 Clash for Windows나 ClashX Meta에서 옮길 때는 먼저 사용할 수 있는 설정 파일을 내보내고 주요 프록시 그룹의 선택 항목을 기록하세요. 새 클라이언트에는 복사본을 가져와 코어가 불러오는지 확인한 뒤 그룹 이름, 노드 유형, 규칙 매칭 결과를 비교합니다. 이전 UI의 시작 프로그램 등록, 포트, 시스템 프록시, 서비스 모드는 대개 앱 자체 설정이므로 YAML과 함께 옮겨질 것으로 기대해서는 안 됩니다. 같은 설정이 이전 클라이언트에서는 작동하고 새 클라이언트에서는 오류가 난다면, 첫 번째 호환되지 않는 항목을 확인하고 코어 차이인지, 클라이언트 오버라이드인지, 구독 형식 차이인지 살펴보세요. 기능별 메뉴 위치는 클라이언트 선택 가이드와 비교할 수 있습니다. 작동이 확인된 기준 상태를 확보한 뒤 나머지 설정을 옮길지 결정하세요.

사용 중인 구독이 없다면 6장의 로컬 예제로 설정, 규칙, 로그의 세 가지 위치를 확인할 수 있습니다. 서비스를 먼저 구매하거나 출처를 알 수 없는 출구로 일상 트래픽을 보내지 않아도 됩니다. 이 예제는 직접 연결과 거부 동작을 비교하기 위한 것이며, 프록시 프로토콜 지원 여부를 확인하는 용도로는 사용할 수 없습니다. 신뢰할 수 있는 구독 출처가 있다면 복사본으로 필요한 프로토콜, 프록시 그룹, 규칙 제공자를 시험해 보세요. 단순히 “가져오기 성공”만 확인해서는 클라이언트를 제대로 선택했다고 할 수 없습니다.

03 설치: 설치 파일 선택과 초기 상태 설정

기기 아키텍처와 시스템 환경 확인

다운로드 전에 현재 기기의 시스템 정보를 확인하세요. 다른 기기의 설치 파일을 보고 추측해서는 안 됩니다. Windows에서는 설정의 시스템 정보에서 시스템 종류를 확인하고, macOS에서는 이 Mac에 관하여에서 Apple 칩과 Intel 프로세서를 구분하세요. Linux에서는 터미널에서 uname -m을 실행해 현재 환경의 머신 아키텍처를 확인할 수 있습니다. 일반적인 결과는 x86_64와 aarch64이며, 배포판에 맞는 패키지 형식도 선택해야 합니다. 아키텍처와 패키지 형식은 별개의 조건입니다. CPU가 맞더라도 한 배포판의 패키지를 다른 배포판에서 사용할 수 있다고 볼 수는 없습니다. 해당 플랫폼용 빌드가 없다면 파일 이름이 비슷한 패키지를 억지로 설치하지 말고 같은 플랫폼에서 사용할 다른 클라이언트를 선택하세요.

Android에서 여러 설치 파일을 제공한다면 먼저 기기가 지원하는 앱 아키텍처를 확인하고 맞는 파일을 선택하세요. 모든 클라이언트가 범용 패키지를 제공하는 것은 아닙니다. iOS는 다운로드 페이지의 App Store 링크에서 앱 상세 페이지로 이동하세요. 필요한 OS 버전은 App Store에 표시된 내용을 기준으로 합니다. Android에서는 앱 설치 시 현재 출처의 앱 설치를 허용해야 할 수 있는데, 이는 VPN 연결 권한과는 별개입니다. 데스크톱에서 보안 경고가 나타나면 파일 출처와 해당 릴리스 안내를 먼저 확인하세요. 조직의 관리 정책이 설치를 제한한다면 승인된 설치 방법을 이용하고, 시스템이나 조직의 보호 기능을 끄지 마세요.

첫 실행에서는 네트워크 진입점을 변경하지 마세요

앱을 실행한 뒤 설정, 프록시 그룹, 연결, 로그 화면을 열 수 있는지 먼저 확인하세요. 데스크톱에서는 보통 시스템 프록시와 TUN을 꺼 둔 채 시작해, 설정이 불러와지기도 전에 클라이언트가 기기 전체의 네트워크 동작을 바꾸지 않도록 하는 것이 좋습니다. 이때 시스템의 기존 프록시나 VPN 상태를 기록하세요. 특히 회사 기기에서는 자동 설정 주소를 확인해야 합니다. 다른 프록시 클라이언트를 설치한 적이 있다면 이전 프로그램이 시스템 트레이, 메뉴 막대 또는 백그라운드에서 계속 실행 중인지 확인하세요. 창을 닫는 것과 프로세스를 종료하는 것은 다릅니다. 두 프로세스가 포트를 차지하려 하거나 시스템 프록시 설정을 번갈아 쓰면 한 기기에서 연결이 됐다 끊기는 현상이 생길 수 있습니다.

로그에 포트 사용 중 오류가 나타나면 먼저 오류에 표시된 포트 번호를 확인하세요. 혼합 포트는 요청을 수신하고, 컨트롤 인터페이스는 UI나 제어 프로그램에서 사용합니다. 두 포트를 혼동해서는 안 됩니다. 기존 클라이언트가 포트를 사용 중이라면 해당 프로세스를 종료한 뒤 현재 코어를 다시 시작하세요. 두 클라이언트를 함께 사용해야 한다면 실제 적용되는 수신 설정을 변경하고, 그 포트를 사용하는 앱 설정도 함께 바꾸세요. 브라우저 주소만 바꾸고 코어의 수신 포트는 그대로 두거나, 설정 파일만 바꾸고 UI 오버라이드는 그대로 두면 연결 거부 문제가 남습니다. 로컬 프로그램 연결을 위해 LAN 접근까지 켤 필요는 없습니다. 첫 테스트에서는 루프백 주소만 사용하면 됩니다.

설치 문제와 연결 문제를 구분하세요

앱이 아예 열리지 않으면 시스템 오류 메시지를 기록하고 아키텍처, 시스템 요구 사항, 설치 파일 유형을 확인하세요. 앱은 열리지만 코어가 시작되지 않으면 코어 시작 로그, 설정 파싱, 포트 바인딩을 살펴봅니다. 코어가 예상한 주소에서 수신 대기 중임을 확인한 다음 구독 및 연결 문제를 점검하세요. 모바일 기기에서 VPN 권한을 아직 허용하지 않았다면 연결 화면에 트래픽이 나타나지 않는 것이 정상입니다. 먼저 설정을 가져오고 테스트 요청을 보낼 준비가 됐을 때 권한을 허용할 수 있습니다. 시작 시 자동 실행을 켰다면 검증을 마친 뒤 한 번 재부팅해 클라이언트와 진입점 스위치의 실제 상태가 예상과 일치하는지 확인하세요.

첫 설치 완료 여부를 벤치마크로 판단할 필요는 없습니다. 앱이 안정적으로 실행되고 설정과 로그 위치를 찾을 수 있으며, 현재 시스템이 변경됐는지 설명할 수 있으면 다음 단계로 넘어가도 됩니다. 시스템 프록시를 시험 삼아 켰다면 끈 뒤 운영체제의 프록시 설정이 실제로 복원됐는지 확인하세요. 앱을 종료한 뒤에도 인터넷이 연결되지 않으면 시스템이 더 이상 수신 대기하지 않는 로컬 포트를 가리키는지 먼저 확인합니다. 회사나 학교 네트워크에서 원래 프록시가 필요한 경우에는 무조건 끄지 말고 이전에 기록한 설정을 복원하세요. 설치 전의 네트워크 상태로 되돌릴 수 있어야 이후 규칙을 안심하고 시험할 수 있습니다.

04 구독 및 설정: 가져오기·활성화·백업

가져오는 항목과 신뢰 경계 파악하기

클라이언트는 보통 원격 링크와 로컬 파일 가져오기를 지원합니다. 원격 링크는 제공자의 업데이트를 계속 반영할 때 적합하고, 로컬 파일은 내용을 고정하거나 실험용 복사본을 보관할 때 유용합니다. 전체 설정에는 프록시 그룹, 규칙, DNS가 함께 들어 있을 수 있으므로 출처가 불분명한 설정은 단순한 노드 목록이 아닙니다. 가져오기 전에 링크가 예상한 제공자에게서 온 것인지 확인하세요. 구독 주소에 계정 정보나 접근 자격 증명이 포함될 수 있으니 공개 설정 변환 사이트, 스크린샷, 문의 게시판에 붙여 넣지 마세요. 형식 확인을 요청해야 한다면 자격 증명, 서버 주소, 사설 도메인을 제거한 일부 내용만 제공하고 필드명, 들여쓰기, 실제 오류 위치는 유지하세요.

설정 화면에서 원격 설정을 추가하고 구독 주소를 입력한 뒤 저장하세요. 다운로드가 끝나면 제공자 이름과 설정 유형을 확인하고 해당 설정을 선택한 뒤 코어의 로드 결과를 살펴봅니다. 가져오기 성공, 목록에서 선택됨, 코어 로드 성공은 서로 다른 단계입니다. 일부 클라이언트에서는 뒤의 두 단계 사이에 적용이나 다시 불러오기가 필요합니다. 알림창에 성공 메시지가 떴다고 설정이 적용됐다고 판단하지 마세요. 프록시 그룹 화면에서 필요한 그룹이 나타나는지 확인하고, 규칙 화면에서 알아보기 쉬운 규칙 하나를 찾은 뒤 새 연결로 검증하세요. 선택한 뒤에도 이전 설정의 그룹이 보인다면 로그로 돌아가 로드 실패 후 이전 상태로 복구된 것은 아닌지 확인하세요.

다운로드·파싱·로드 단계별 문제 해결

다운로드에 실패하면 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인한 뒤 링크 만료 여부, 인증 제한, 기기 시간 설정을 살펴보세요. 일부 서비스는 로그인 페이지나 오류 페이지를 반환합니다. 네트워크 계층에서는 요청이 완료된 것으로 보여도 본문이 설정 파일이 아니어서 다음 단계에서 파싱 오류가 날 수 있습니다. 구독 링크를 업데이트할 때 기존 프록시가 필요하다면 클라이언트를 막 설치했거나 설정이 손상된 상태에서 시작 순서 문제가 생길 수도 있습니다. 이전에 작동한 로컬 복사본으로 연결을 복구한 뒤 업데이트하고, 출처를 모르는 구독 주소를 계속 바꿔 넣지 마세요. 다른 오류 상황은 구독 가져오기 실패 자가 진단 목록을 참고하세요.

파싱에 실패하면 첫 번째 오류와 그 앞뒤 줄부터 확인하세요. YAML 들여쓰기에는 공백을 사용하고 같은 계층에서는 들여쓰기 수준을 통일해야 합니다. 규칙 목록의 각 항목에는 목록 표시 기호를 유지하세요. 필드명 오타, 존재하지 않는 정책 그룹 참조, 문서 구조 자체를 파싱할 수 없는 문제는 서로 다른 오류입니다. 파싱은 통과했지만 로드에 실패한다면 코어가 지원하는 필드와 프로토콜, 외부 규칙 리소스를 확인하세요. 로그에 프록시 그룹에 사용할 수 있는 구성원이 없다고 나오면 그룹에서 참조하는 이름이나 제공자가 현재 설정에 실제로 있는지 확인하세요. 바로 그룹을 삭제하지 마세요. 다른 규칙에서 참조 중인 그룹을 삭제하면 오류가 다음 위치로 옮겨갈 뿐입니다.

원격 원본·로컬 오버라이드·백업을 분리하세요

원격 설정을 장기적인 수동 편집 공간으로 사용하지 마세요. 구독을 한 번 업데이트하는 것만으로도 파일 전체가 교체되어 기존 사용자 지정 규칙과 주석이 사라질 수 있습니다. 클라이언트가 별도 오버라이드를 지원한다면 로컬 변경 사항을 그곳에 저장하고, 변경 내용이 기존 규칙 앞에 삽입되는지, 끝에 추가되는지, 필드 전체를 대체하는지 먼저 확인하세요. 오버라이드를 지원하지 않는다면 별도의 로컬 작업 복사본을 보관하고 업데이트 후 필요한 변경 사항을 직접 병합할 수 있습니다. 백업은 마지막으로 정상 작동이 확인된 원본, 로컬 오버라이드, 아직 검증되지 않은 실험본을 구분해야 합니다. 자격 증명이 포함된 원본은 접근이 제한된 곳에 보관하세요. 여러 설정을 함께 관리하는 방법은 Profile 및 다중 설정 관리를 참고하세요.

05 프록시 모드: 규칙·글로벌·직접 연결

모드는 출구 판정을 바꾸며 진입점은 바꾸지 않습니다

규칙 모드는 설정 순서에 따라 규칙을 확인하며, 대상별로 출구를 나누는 일상적인 사용에 적합합니다. 글로벌 모드는 코어에 들어온 연결을 글로벌 정책 선택에 맡기며, 규칙 때문에 차이가 생기는지 잠시 비교할 때 유용합니다. 직접 연결 모드는 코어에 들어온 연결을 목적지에 바로 연결하므로 프록시 경로와 비교할 수 있습니다. 모드를 바꿔도 시스템 프록시가 자동으로 켜지지 않으며, 시스템 프록시를 사용하지 않는 앱이 코어로 들어오지도 않습니다. 글로벌 모드가 기기 전체를 가로채는 것은 아니며, 직접 연결 모드가 클라이언트를 종료하는 것도 아닙니다. 어떤 프로그램이 세 모드에서 모두 똑같이 작동한다면 모드를 계속 바꾸기보다 해당 프로그램의 연결이 클라이언트에 실제로 표시되는지 먼저 확인하세요.

코어에 들어온 연결의 출구 선택 방식
모드판정 방식확인 항목
규칙처음으로 일치한 규칙의 정책 적용매칭 조건, 정책 그룹, 그룹 내 구성원
글로벌현재 선택된 글로벌 그룹 적용글로벌 그룹에서 노드·하위 그룹·직접 연결 중 무엇을 선택했는지
직접 연결코어가 목적지에 직접 연결직접 연결 경로의 DNS 조회와 접근 가능 여부

같은 목적지로 비교 테스트하기

데스크톱에서는 시스템 프록시를 따르는 브라우저를 사용하거나 테스트 도구 하나에서 로컬 프록시를 명시적으로 지정하세요. 접근 권한이 있고 상태가 비교적 안정적인 대상을 선택합니다. 연결 화면을 열어 목적지, 시간, 프록시 모드, 매칭된 정책, 실제 출구를 기록하세요. 테스트 환경이 규칙 모드라면 대상이 전용 규칙에 매칭됐는지, 마지막 기본 규칙에 매칭됐는지 먼저 확인합니다. 진입점과 설정을 그대로 둔 채 글로벌 모드로 전환하고 글로벌 그룹에서 실제로 선택한 출구를 확인한 다음 새 요청을 보냅니다. 기존 웹페이지의 장시간 연결, 캐시된 결과, 백그라운드 재시도는 비교를 방해할 수 있습니다. 필요하면 해당 페이지나 앱을 닫고 다시 시도하되 시스템 네트워크 설정 전체를 지울 필요는 없습니다.

글로벌 모드에서는 접속되지만 규칙 모드에서는 안 된다고 해서 규칙 문법 오류라고 단정할 수는 없습니다. 규칙이 정확히 매칭됐지만 다른 그룹으로 전달됐거나, 해당 그룹이 사용할 수 없는 출구를 선택했을 수도 있습니다. 두 요청의 최종 출구를 비교한 뒤 규칙 선택 문제인지 출구 자체의 문제인지 판단하세요. 두 모드에서 같은 노드를 선택했는데도 결과가 다르다면 목적지가 서로 다른지, 이전 연결이 비교에 섞였는지 확인합니다. 웹페이지는 주 도메인뿐 아니라 여러 하위 리소스 도메인으로 요청을 보낼 수 있습니다. 메인 페이지가 열렸다고 API, 이미지, 로그인 리소스도 모두 같은 규칙을 따라 전달됐다는 뜻은 아닙니다. 실제로 실패한 연결을 기준으로 확인하세요.

노드 테스트와 실제 서비스 확인의 차이

클라이언트의 지연 시간 테스트는 보통 특정 테스트 주소를 대상으로 하며, 모든 사이트와 프로토콜에서 잘 작동한다는 보증이 아닙니다. 테스트 주소에 빠르게 응답한 노드라도 실제 앱의 업로드, 장시간 연결, 특정 목적지에서는 결과가 다를 수 있습니다. 테스트 실패도 테스트 주소에 접근할 수 없어서일 수 있으며, 모든 목적지에서 노드가 작동하지 않는다는 뜻은 아닙니다. 그룹 안에서 출구를 바꾸려면 먼저 같은 테스트 주소의 결과를 기록한 다음 실제 목적지로 다시 확인하세요. 자동 선택 그룹은 테스트 주소, 간격, 현재 선택 항목도 살펴봐야 합니다. 두 번 직접 확인하는 사이에 출구가 바뀌었을 수 있으므로 그룹 이름만 보고 경로가 계속 같았다고 판단하지 마세요.

첫 연결의 구체적인 절차는 노드 선택·지연 시간 테스트·적용 확인을 참고하세요. 비교를 마친 뒤 평소 사용할 모드로 되돌리고 비교 중 바꾼 글로벌 그룹도 확인합니다. 외부 IP 확인 서비스로 출구를 확인하는 경우 그 서비스는 해당 요청 하나만 볼 수 있으므로 같은 기기의 모든 트래픽을 대표하지는 않습니다. 클라이언트의 동일한 연결 기록과 출구 정보를 함께 비교하는 편이 더 유용합니다. 해당 기록을 일관되게 설명할 수 있게 된 다음 직접 규칙을 작성하세요.

06 규칙 기반 트래픽 분기: 문법·순서·로컬 테스트

구체적인 조건을 먼저, 기본 규칙은 마지막에 작성하세요

대부분의 규칙은 쉼표로 유형, 매칭 값, 대상 정책을 구분합니다. 예를 들어 DOMAIN,example.org,DIRECT는 정확한 도메인 하나에 매칭되고, DOMAIN-SUFFIX,example.org,DIRECT는 하위 도메인까지 포함합니다. 키워드 매칭은 범위가 더 넓어 같은 문자열이 포함된 다른 도메인에도 적용될 수 있으므로, 사용하기 전에 기대하는 대상의 범위를 정하세요. 정책에는 DIRECT, REJECT 또는 설정에 실제로 존재하는 프록시 그룹 등을 사용할 수 있습니다. 온라인 예제의 Proxy는 그룹 이름일 뿐이므로 모든 구독에 해당 그룹이 있다고 가정하면 안 됩니다. 그룹 이름의 대소문자와 공백, 참조 관계가 현재 설정과 일치하는지 확인하세요.

코어는 규칙을 순서대로 확인하고 처음 매칭된 항목을 적용합니다. 더 구체적인 조건을 찾으려고 다음 규칙까지 내려가지 않습니다. 예외 처리할 정확한 도메인을 먼저 두고, 그다음 접미사나 지역 분류처럼 범위가 넓은 조건을 배치한 뒤 마지막에 MATCH 기본 규칙을 두세요. 예외 규칙을 같은 도메인의 접미사 규칙 뒤에 놓으면 두 조건이 모두 설정돼 있어도 실제로는 예외 규칙에 도달하지 못합니다. 문제를 해결할 때 대상 도메인이 파일에 있는지만 검색하지 말고, 앞쪽의 더 넓은 규칙이 요청을 먼저 가로채는지 확인하세요. 클라이언트의 오버라이드 기능이 규칙을 파일 끝에만 추가한다면 기존 MATCH 규칙보다 앞에 배치할 수 있는지도 확인해야 합니다.

별도 설정으로 규칙 우선순위 검증하기

다음은 mihomo 호환 클라이언트에서 불러올 수 있는 최소 예제입니다. 로컬에서만 수신 대기하며 구독이나 프록시 노드는 필요하지 않습니다. 기존 설정을 먼저 저장한 뒤 예제를 로컬 YAML 파일로 따로 보관하세요. 불러온 뒤 모드가 규칙이고 포트가 7890인지 확인합니다. 포트가 사용 중이라면 빈 포트를 선택하고 아래 두 명령도 함께 수정하세요. 클라이언트에서 포트나 모드를 오버라이드한다면 UI와 시작 로그에 표시된 실제 값을 기준으로 합니다. 테스트 중에는 시스템 프록시나 TUN을 켤 필요가 없습니다. 명령은 HTTP 프록시를 지원하는 curl을 사용합니다. PowerShell에서 curl이 별칭으로 인식된다면 curl.exe를 사용하세요.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - DOMAIN,example.org,REJECT
  - DOMAIN-SUFFIX,example.org,DIRECT
  - MATCH,DIRECT
curl -I --max-time 10 --proxy http://127.0.0.1:7890 https://example.org/
curl -I --max-time 10 --proxy http://127.0.0.1:7890 https://example.com/

첫 번째 명령은 정확한 도메인 거부 규칙에 매칭되어 프록시 터널 연결 실패가 표시될 수 있습니다. 두 번째 명령은 마지막 기본 규칙을 따르며, 응답을 받을 수 있는지는 현재 네트워크에서 목적지에 접근할 수 있는지에 달려 있습니다. 앞의 두 규칙 순서를 바꾸고 다시 불러온 뒤 첫 번째 명령을 실행해 보세요. 이번에는 로그에 거부가 아니라 접미사 직접 연결이 표시되어야 합니다. 예상 응답 코드가 아니라 두 로그의 정책 차이를 기준으로 판단하세요. 두 명령 모두 로컬 포트에 연결하지 못하면 설치 장으로 돌아가 수신 상태를 확인하세요. 포트에는 연결되지만 정책 차이가 보이지 않는다면 현재 설정과 모드, 클라이언트가 오버라이드를 저장했는지 확인합니다.

도메인 규칙·주소 규칙·외부 데이터 구분하기

도메인 규칙은 코어가 도메인을 알아야 적용되고, 주소 규칙은 목적지 IP를 확인합니다. 연결에 주소만 표시되는 경우 도메인 접미사를 아무리 정확하게 작성해도 도움이 되지 않을 수 있습니다. 반대로 도메인 요청이 코어에 들어오면 일부 IP 규칙은 추가 DNS 조회를 유발할 수 있습니다. no-resolve를 지원하는 규칙 유형에서는 이 매개변수로 해당 규칙의 매칭만을 위한 조회를 방지할 수 있지만, DNS 자체를 비활성화하는 것은 아닙니다. GeoSite와 GeoIP는 각각 도메인 분류 데이터와 주소 분류 데이터에 의존합니다. 사용할 수 있는 분류와 각 분류에 포함된 항목은 실제로 탑재된 데이터에 따라 달라집니다. 규칙을 일괄 업데이트한 뒤 트래픽이 잘못 분기된다면 더 넓은 규칙으로 차이를 덮기보다 매칭 항목과 데이터 출처를 비교하세요. GeoIP 및 GeoSite 데이터 업데이트를 참고하세요.

07 TUN: 트래픽 처리 범위·권한·복구

진입점을 바꿔야 하는 경우

데스크톱 시스템 프록시는 주로 시스템 프록시 설정을 따르는 앱에서 사용합니다. 일부 프로그램은 별도의 네트워크 스택이나 자체 프록시 설정을 사용하거나 일반 HTTP 프록시로 전달할 수 없는 트래픽을 처리해야 합니다. 이런 경우 TUN은 가상 네트워크 인터페이스와 라우팅을 통해 더 많은 트래픽을 받아 코어에 전달하고 설정에 따라 처리할 수 있습니다. 실제 처리 범위는 로컬 라우팅, 제외 항목, 시스템 제한, 다른 가상 네트워크 인터페이스의 영향을 받으므로 스위치 상태만 보고 기기의 모든 연결이 포함됐다고 단정할 수 없습니다. 모바일에서는 보통 시스템 VPN 인터페이스가 트래픽을 전달합니다. 시스템 아이콘은 인터페이스가 만들어졌다는 뜻이지, 모든 연결이 특정 프록시 노드를 거친다는 뜻은 아닙니다.

프록시가 필요한 앱이 브라우저 하나뿐이고 기존 시스템 프록시로 요구 사항을 충족할 수 있다면 간단한 진입점을 그대로 사용해도 됩니다. 특정 앱의 트래픽이 코어에 들어오지 않는 것을 확인했거나 관련 트래픽 유형을 실제로 검증해야 할 때만 TUN으로 전환해 비교하세요. 시작하기 전에 시스템 프록시의 기존 상태, 현재 설정, 반복해서 확인할 수 있는 목적지를 기록하고 중요한 전송 작업이 진행 중이지 않은지 확인합니다. 조직에서 업무용 VPN을 설치했다면 허용된 동시 사용 방법이나 테스트 환경부터 확인하세요. 두 가상 인터페이스가 라우팅을 놓고 충돌하는 상황에서 스위치를 반복해서 켜고 끄면 테스트 결과를 비교하기 어려워집니다.

하나씩 활성화하고 라우팅 동작 확인하기

데스크톱에서는 추가 권한, 보조 서비스 또는 시스템 네트워크 권한이 필요한 경우가 많습니다. 구체적인 방식은 클라이언트 안내와 시스템 요구 사항을 따르세요. 먼저 비교에 사용할 시스템 프록시를 끄고, 검증된 설정은 유지한 채 TUN을 켠 다음 코어 로그에서 인터페이스 생성과 라우팅 설정이 성공했는지 확인합니다. 일부 클라이언트는 자동 라우팅과 네트워크 어댑터 자동 감지를 제공합니다. 자동 라우팅은 가상 인터페이스로 트래픽을 유도하고, 자동 감지는 실제 출구를 식별하는 기능입니다. 네트워크 어댑터가 여러 개 있거나 핫스폿을 전환했거나 다른 VPN이 실행 중이면 자동 선택 결과가 예상과 다를 수 있습니다. 현재 선택된 인터페이스와 실제 연결을 먼저 살펴보고, 한 번의 문제 해결 과정에서 프로토콜 스택과 DNS 정책까지 함께 바꾸지 마세요.

검증할 때는 기존에 시스템 프록시를 통해 들어오던 연결 하나, 시스템 프록시를 따르지 않던 연결 하나를 각각 보내고, 유지해야 하는 로컬 리소스도 테스트하세요. 앞의 두 연결은 연결 화면에서 진입점 변경이 예상한 차이를 만들었는지 확인할 수 있습니다. 로컬 리소스는 필요한 직접 연결이나 라우팅 제외가 여전히 작동하는지 확인하는 데 도움이 됩니다. 규칙이 DIRECT를 가리킨다는 것은 코어가 트래픽을 받은 뒤 직접 전달한다는 뜻입니다. 라우팅 제외는 트래픽이 코어에 아예 들어오지 않도록 할 수 있습니다. 두 방식은 로그와 표시되는 목적지, 문제 해결 위치에 서로 다른 영향을 줍니다. 로컬 리소스 하나를 복구하려고 광범위한 주소를 제외하거나, 원래 처리할 필요가 없는 로컬 서비스를 테스트 트래픽에 포함하지 마세요.

DNS와 정상 종료를 각각 검증하세요

TUN을 켠 뒤 도메인으로만 접속이 실패한다면 DNS 로그와 라우팅을 먼저 확인한 다음 클라이언트 DNS 설정과 시스템의 DNS 조회 경로를 살펴보세요. 같은 서비스의 IP 주소로 직접 접속하는 것은 올바른 도메인으로 인증서 검증과 가상 호스트 선택을 해야 하는 HTTPS 환경에서는 유효한 비교가 아닐 수 있습니다. 로컬 장치 이름, 사내 DNS 또는 로그인 포털을 사용하는 네트워크라면 TUN 활성화 전후에 각각 테스트하는 것이 특히 중요합니다. 사용자 지정 DNS 전달이나 DNS 가로채기 방식을 변경하기 전에 기본 설정이 적용된 작동 복사본을 보관하세요. 이상이 재현되면 기본 설정으로 복구한 뒤 한 번에 한 항목만 바꾸세요. 전체 동작 비교는 TUN 모드와 시스템 프록시 비교를 참고하세요.

복구할 때는 클라이언트에서 TUN을 먼저 끄고 시스템 라우팅이 복구될 때까지 기다린 뒤, 원래 직접 연결되던 목적지에 접속해 보세요. 그다음 필요에 따라 기존 시스템 프록시를 복원합니다. 클라이언트가 비정상 종료됐다면 가상 인터페이스나 앱 관리 서비스가 여전히 작동 중인지, 시스템이 종료된 로컬 프록시 포트를 계속 가리키는지 먼저 확인하세요. 업무 네트워크에서는 라우팅 테이블을 무작정 비우거나 다른 VPN 설정을 삭제하지 마세요. 정상 종료와 비정상 종료의 차이를 기록하면 문제가 코어에 있는지, 서비스 정리에 있는지, 시스템 네트워크 상태에 있는지 판단하는 데 도움이 됩니다.

08 유지 관리: 업데이트·재검증·문제 복구

업데이트 대상을 네 가지로 나누세요

클라이언트 업데이트는 UI와 권한 처리 방식을 바꿀 수 있고, 코어 업데이트는 파싱이나 기능 동작에 영향을 줄 수 있습니다. 구독 업데이트는 노드와 규칙을 바꾸고, 규칙 데이터베이스 업데이트는 분류 결과를 바꿀 수 있습니다. 모든 항목을 한 번에 업데이트할 필요는 없습니다. 호환성 때문에 동시에 올려야 하는 경우가 아니라면 현재 정상 작동 상태를 기록하고 한 항목을 업데이트한 뒤 재검증하고 다음 항목으로 넘어가세요. 특히 “업데이트 후 일부 사이트만 접속됨” 같은 문제가 생겼을 때 마지막으로 바뀐 것이 구독인지 지리 데이터베이스인지 아는 편이 설정 이름을 전부 외우는 것보다 유용합니다. UI에서 자동 업데이트를 지원한다면 어떤 항목이 업데이트되는지, 현재 설정을 언제 다시 불러오는지 확인하세요.

백업에는 현재 설정 파일과 로컬 오버라이드뿐 아니라 프록시 그룹 선택, 진입 포트, 자동 업데이트 동작처럼 잊기 쉬운 설정도 포함해야 합니다. 구독 자격 증명과 복원 가능한 노드 정보는 접근이 제한된 곳에 보관하세요. 일반 스크린샷과 함께 동기화하거나 공개 공유하는 것은 피해야 합니다. 종료 후 복구할 수 있도록 활성화 전 시스템 설정도 기록해 두세요. 실제로 불러오는 방법을 알아야 백업이 유용합니다. 작동 중인 연결에 영향을 주지 않는 상황에서 백업 복사본을 가져와 UI에서 인식되는지, 참조하는 리소스가 여전히 사용 가능한지 확인한 뒤 원래 설정으로 돌아갈 수 있습니다. 외부 규칙 리소스는 바뀔 수 있으므로 YAML을 백업했다고 모든 의존 항목까지 백업된 것은 아닙니다.

영향 범위를 기준으로 문제 좁히기

사이트 하나만 실패한다면 해당 목적지와 실패한 하위 리소스의 연결 기록을 확인하고 정책과 출구를 살펴보세요. 앱 하나만 실패한다면 시스템 프록시를 따르는지, 별도의 프록시가 설정됐는지, 새 연결이 생성됐는지 비교합니다. 클라이언트를 켰을 때 기기 전체가 연결되지 않는다면 시스템 프록시 포트, TUN 인터페이스, 라우팅을 확인하세요. 같은 네트워크의 다른 기기도 접속할 수 없고 같은 설정을 실행하지 않는다면 상위 네트워크부터 점검합니다. 문제를 해결하는 동안 설정 전환, 네트워크 변경, TUN 활성화, DNS 수정 등을 한꺼번에 하지 마세요. 우연히 복구되더라도 어떤 조치가 원인이었는지 알 수 없습니다.

실패 기록에는 시도한 시간, 현재 설정, 진입점, 모드, 목적지, 매칭된 정책, 최종 출구를 적으세요. 구분하기 쉬운 새 요청을 한 번에 하나씩 보내 브라우저의 백그라운드 연결에 묻히지 않도록 합니다. 더 많은 단서가 필요하면 클라이언트가 지원하는 로그 수준을 잠시 높이고, 원인을 찾은 뒤 평소 수준으로 되돌리세요. 도메인, 기기 정보, 내부 주소, 구독 식별자가 포함된 로그를 그대로 공개하면 안 됩니다. 외부에 공유할 때는 정확한 오류 유형과 필요한 필드만 남기고 실제 환경을 알아낼 수 있는 값을 삭제하세요. 같은 오류가 반복된다면 대표 기록 한두 개가 긴 중복 로그보다 이해하기 쉽습니다.

작업 가능한 상태로 복구한 뒤 원인을 찾으세요

문제가 일상 업무에 영향을 준다면 마지막으로 검증된 설정, 모드, 진입점으로 먼저 돌아가고 불확실한 상태에서 계속 시험하지 마세요. 시스템 프록시가 더 이상 수신 대기하지 않는 포트를 가리킨다면 기존 설정부터 복구해야 합니다. TUN 문제라면 이전 장의 순서에 따라 종료한 뒤 일반 연결이 복구됐는지 확인하세요. 복구한 다음 같은 목적지로 다시 테스트하고, 실험은 설정을 복사해 이어갑니다. 원격 규칙 리소스가 있는 설정은 시작할 때 외부에서 리소스를 내려받아야 할 수 있습니다. 전체 재시작 후 테스트한 결과와 설정만 즉시 전환한 결과를 따로 기록하세요. 두 결과가 다르다면 캐시, 백그라운드 서비스, 시작 순서가 문제에 영향을 줬을 가능성이 큽니다.

자주 묻는 문제는 다운로드 페이지의 다운로드 FAQ와 사용 설명서를 참고해 설치 및 첫 연결 절차를 확인하세요. 평소 유지 관리에 많은 속도 테스트는 필요하지 않습니다. 유용한 테스트 사례 세 가지면 충분합니다. 직접 연결되어야 하는 연결 하나, 지정한 그룹을 거쳐야 하는 연결 하나, 반드시 사용 가능해야 하는 로컬 리소스 하나입니다. 업데이트 후에는 새 연결로 이 세 가지를 확인하고 이전과 달라진 점을 기록한 다음 추가 조정이 필요한지 판단하세요.

09 심화 가이드: 규칙 세트·DNS·통제된 배포

단일 규칙에서 관리 가능한 규칙 세트로

직접 작성한 규칙으로 요구 사항을 충족할 수 있다면 순서와 예외를 먼저 정리하세요. 규칙이 많아지면 mihomo 호환 규칙 제공자를 사용해 도메인이나 IP 대역 목록을 별도로 관리하는 방법을 고려할 수 있습니다. 도입 전에는 데이터 유형, 리소스 형식, 업데이트 시점을 확인하고 규칙 제공자에 선언된 동작이 실제 목록 내용과 일치하는지 살펴보세요. 외부 규칙을 기본 규칙 목록에 연결할 때도 참조 위치가 우선순위를 결정합니다. 원격 목록이 아무리 길어도 앞에서 이미 매칭된 항목보다 우선 적용되지는 않습니다. 규칙 세트 앞에 명확한 로컬 예외 몇 개를 두고 마지막에는 기본 정책을 분명히 지정하세요. 각 규칙 세트의 출처와 용도도 기록해야 합니다.

원격 의존 항목이 많을수록 콜드 스타트 동작을 더 꼼꼼히 테스트해야 합니다. 자주 사용하는 캐시가 있을 때 읽기에 성공했다고 새 기기에서 처음 실행할 때도 다운로드할 수 있는 것은 아닙니다. 배포 전에는 격리된 테스트 설정이나 새 환경에서 리소스에 접근할 수 있는지, 로드 실패가 로그에 어떻게 표시되는지, 기본 연결을 복구할 로컬 설정이 있는지 확인하세요. 캐시가 없는 상태를 흉내 내려고 현재 클라이언트의 데이터를 모두 삭제하지 마세요. 별도의 테스트 환경을 만들면 구독, 그룹 선택, 시스템 복구 정보까지 함께 지우는 일을 피할 수 있습니다. 사용 중인 클라이언트가 원격 리소스를 어떻게 업데이트하는지도 확인하세요. 코어가 지원한다고 해서 UI에도 같은 방식으로 저장 기능이 있다고 단정할 수는 없습니다.

문제를 기준으로 DNS를 조정하세요

DNS는 사내 전용 도메인 조회 오류나 목적지가 예상과 다른 DNS 경로에 명확히 전달되는 경우처럼 재현 가능한 문제를 바탕으로 조정해야 합니다. 먼저 앱 자체의 암호화 DNS 사용 여부, 시스템에서 사용하는 리졸버, 코어가 해당 연결을 처리하는지 기록한 뒤 어느 계층을 바꿀지 결정하세요. 일부 클라이언트는 특정 도메인에 사용할 DNS 서버를 지정할 수 있어 경계가 분명한 사내외 네트워크에 적합하지만, 규칙 적용 순서와 부트스트랩 DNS 조회도 함께 확인해야 합니다. 원격 DNS 서버에 연결하려면 도메인 조회가 필요한데 초기 조회 경로가 없으면 클라이언트 시작 시 모든 DNS 요청이 실패할 수 있습니다.

심화 설정에서 자주 사용하는 Fake IP는 앱에 코어가 연관 관계를 추적할 수 있는 가상 주소를 반환하고, 코어는 이후 연결에서 원래 도메인을 확인합니다. 이 주소는 대상 서비스의 실제 주소가 아니므로 표시됐다고 해서 DNS 서버가 잘못된 결과를 반환한 것은 아닙니다. 앱이 실제 주소나 사내 이름 조회에 특히 의존한다면 필터 항목을 바꾸기 전에 일부 도메인과 앱으로 호환성을 비교하세요. 외부 DNS 검사 사이트에서는 해당 사이트가 유발한 조회 경로만 확인할 수 있으므로 다른 앱이나 다른 트래픽 진입점까지 설명해 주지는 않습니다. Clash DNS 누출 여부를 판단하려면 누가 조회해야 하는지, 실제로 누가 조회했는지, 비교에 사용한 앱과 진입점이 같은지 명확히 해야 합니다.

GUI 클라이언트에서 코어 단독 실행으로 전환할 시점

직접 관리하는 Linux 호스트나 라우터에서 고정 설정을 실행하거나 서비스 로그와 시작 순서를 제어해야 할 때만 mihomo를 별도로 배포하는 방안을 고려하세요. 먼저 로컬 루프백 수신으로 설정과 규칙을 검증하고, 프록시 진입 포트와 컨트롤 인터페이스가 각각 어떤 용도인지 확인한 뒤 신뢰할 수 있는 네트워크에 공개할 필요가 있는지 결정합니다. 기본적으로 수신 범위는 좁게 유지하고 컨트롤 인터페이스와 프록시 포트를 인터넷에 직접 노출하지 마세요. 설정 파일에 구독이나 노드 자격 증명이 포함됐다면 읽기 권한을 제한해야 합니다. 다른 기기의 트래픽을 처리하기 전에 종료하거나 재시작한 뒤 라우팅이 복구되는지 확인하고, 기기를 직접 관리할 경로도 남겨 두세요. 개인용 데스크톱과 휴대전화에서만 사용할 목적이라면 GUI 클라이언트로 이 가이드의 주요 작업을 대부분 처리할 수 있습니다.

간단한 회귀 테스트 목록으로 심화 설정을 일상적으로 사용할 가치가 있는지 확인할 수 있습니다. 재시작 후에도 작업 상태가 복구되는지, 직접 연결과 프록시를 거쳐야 하는 목적지가 각각 지정된 정책에 매칭되는지, 구독 업데이트가 로컬 예외를 덮어쓰지 않는지, 진입점을 끈 뒤 시스템이 원래 상태로 복구되는지 점검하세요. 재현할 수 없는 항목이 있다면 해당 장으로 돌아가 확인 지점을 보완하고 문제 범위를 한 가지 변수로 좁히세요. 심화 설정의 기준은 설정 파일의 길이가 아니라 트래픽이 왜 해당 경로로 이동하는지 설명하고, 실제 동작이 예상과 다를 때 안전하게 되돌릴 위치를 찾을 수 있는지입니다.