설정 가이드 / Configuration
클라이언트 인터페이스는 조작을 담당하고 코어는 연결을 처리합니다. 먼저 트래픽이 클라이언트로 들어오는지 확인한 다음 어떤 규칙이 적용됐는지 살펴보세요. 두 영역을 나눠 확인하면 모드를 계속 바꾸는 것보다 원인을 쉽게 찾을 수 있습니다.
처음 사용할 때는 설정 파일부터 준비해야 합니다. 클라이언트를 설치했다고 프록시 연결까지 자동으로 설정되는 것은 아니며, 구독 주소도 별도로 준비해야 하는 경우가 많습니다. 가져온 뒤에는 해당 설정이 선택되어 있는지, 정책 그룹이 있는지 확인하고 앱의 필요에 따라 시스템 프록시나 TUN을 켜세요. 아래 설정 예시는 항목 간 관계를 설명하기 위한 것으로 프록시 서버를 포함하지 않으며, 실제로 사용할 수 있는 구독을 대신하지 않습니다.
규칙 모드에서는 설정에 적힌 순서대로 연결을 확인하며, 가장 먼저 일치하는 규칙이 연결 경로를 결정합니다. 도메인 접미사, 대상 주소, 기본 규칙은 각각 쓰임새가 다르므로 구체적인 규칙을 포괄적인 규칙보다 앞에 배치하세요. 클라이언트의 ‘프록시’ 또는 ‘설정’에서 규칙 모드를 선택한 다음 ‘연결’에서 적용된 규칙을 확인할 수 있습니다. 전역 모드와 달리 규칙 모드에서는 직접 연결과 프록시 연결을 함께 사용할 수 있어 모든 요청을 같은 경로로 보낼 필요가 없습니다. 예시는 모두 직접 연결만 사용하며 문법 설명을 위한 것입니다. 정책 이름을 바꾸기 전 해당 정책 그룹이 설정에 있는지 확인하세요.
대상: Clash 규칙 문법을 지원하는 데스크톱 및 모바일 클라이언트
Clash# 구체적인 도메인 규칙을 앞에, 기본 규칙을 뒤에 배치
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- GEOIP,CN,DIRECT
- MATCH,DIRECT
# DIRECT: 직접 연결
# REJECT: 연결 거부
# GEOIP를 사용하려면 해당 지역 데이터가 있어야 합니다TUN 모드는 가상 네트워크 인터페이스와 라우팅 설정으로 트래픽을 처리하므로 시스템 프록시를 사용하지 않는 앱에 적합합니다. 데스크톱에서는 보통 서비스를 설치하거나 관리자 권한을 허용한 뒤 ‘설정’에서 TUN을 켭니다. 모바일에서는 대개 시스템 VPN 권한을 통해 트래픽을 처리합니다. TUN과 규칙 모드는 서로 대체하는 기능이 아닙니다. TUN은 트래픽이 코어로 들어오는 방식을, 규칙 모드는 들어온 트래픽의 연결 경로를 결정합니다. 다른 VPN이나 가상 네트워크 인터페이스, 기업 네트워크 정책을 사용 중이라면 기존 설정을 먼저 기록해 두세요. 문제가 생기면 스위치 상태만 확인하지 말고 라우팅과 DNS도 점검해야 합니다.
대상: TUN과 필요한 권한을 지원하는 클라이언트. 지원 항목은 사용 중인 코어에 따라 다릅니다.
# mihomo TUN 설정 예시
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
# DNS 리다이렉션에는 코어의 DNS 설정도 필요합니다
# 사용 전 다른 VPN과 가상 네트워크 인터페이스를 확인하세요
# 클라이언트 인터페이스에서 이 항목을 덮어쓸 수 있습니다전체 구독 설정에는 프록시, 정책 그룹, 규칙이 함께 들어갈 수 있지만 프록시 제공자는 기존 설정에 프록시 항목만 추가합니다. 처음 가져올 때는 보통 ‘프로필’에서 원격 구독을 추가하고 저장한 뒤 해당 프로필을 선택해 업데이트가 정상적으로 됐는지 확인합니다. 정기 업데이트는 원격 콘텐츠를 다시 가져오므로 다운로드한 파일을 직접 수정하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 장기적으로 수정하려면 클라이언트의 오버라이드 또는 병합 기능을 사용하세요. 오른쪽 예시는 파일 간 관계를 보여 주는 로컬 제공자 문법입니다. 파일 경로는 코어의 작업 디렉터리를 기준으로 하며 임의의 시스템 경로를 뜻하지 않습니다.
대상: 원격 설정 관리는 클라이언트에 따라 다르며, 제공자 예시는 mihomo에 적용됩니다.
# 로컬 파일에 proxies 목록이 있어야 합니다
proxy-providers:
local:
type: file
path: ./providers/local.yaml
proxy-groups:
- name: 수동 선택
type: select
use:
- local
# 공개 스크린샷이나 로그에 구독 주소가 노출되지 않도록 하세요Clash, Clash Premium, mihomo는 설정 기능과 유지 관리 상태가 서로 다릅니다. 인터페이스 이름이 비슷해도 같은 항목을 모두 지원하는 것은 아닙니다. mihomo는 Clash Meta의 설정 체계를 이어받았으며, 현재 여러 클라이언트에서 연결 처리에 사용됩니다. 일부 클라이언트만 코어 전환을 지원하고 나머지는 코어가 고정되어 있으므로 같은 절차를 적용할 수 없습니다. 알 수 없는 필드나 지원되지 않는 프로토콜이 나타나면 로그를 확인하고 클라이언트가 사용하는 코어를 파악한 뒤 설정 문서를 참고하세요. 실행 파일만 따로 교체하면 클라이언트 인터페이스와 호환되지 않을 수 있으므로 제품에서 제공하는 업데이트 방법을 우선 사용하세요.
대상: 코어 선택 및 설정 마이그레이션. 모든 클라이언트가 코어 전환을 지원하는 것은 아닙니다.
| 이름 | 확인할 내용 |
|---|---|
| Clash | 기본 규칙 문법과 원래 설정 체계 |
| Clash Premium | 기존 설정에서 사용하는 전용 확장 필드 |
| mihomo | Clash Meta의 후속 프로젝트. 현재 문서에서 필드 지원 여부 확인 |
호환되는 설정 파일은 여러 플랫폼에서 재사용할 수 있지만 수신 포트, 파일 경로, 시스템 권한은 각 기기에서 따로 확인해야 합니다. 데스크톱에서는 보통 시스템 프록시를 먼저 확인한 뒤 필요에 따라 TUN을 켭니다. 모바일에서는 VPN 권한을 먼저 허용해야 합니다. 마이그레이션할 때는 이전 기기의 절대 경로를 그대로 복사하거나 모든 클라이언트가 같은 구독 형식을 읽는다고 가정하지 마세요. 대상 제품이 지원하는 형식을 확인한 다음 설정을 가져와 선택하고 정책 그룹을 점검하세요. 연결이 확인된 뒤 시작 프로그램 등록이나 백그라운드 실행을 설정하면 설정 문제와 시스템 제한을 구분하기 쉽습니다.
대상: 5개 플랫폼 간 설정 마이그레이션. 자세한 설치 절차는 전체 플랫폼 가이드를 참고하세요.
| 플랫폼 | 시스템 설정 확인 경로 |
|---|---|
| Windows | 설정 → 네트워크 및 인터넷 → 프록시 |
| macOS | 시스템 설정 → 네트워크 → 현재 네트워크 → 세부 정보 → 프록시 |
| Android | 시스템 설정의 VPN 및 배터리 관리 |
| iOS | 설정 → 일반 → VPN 및 기기 관리 |
| Linux | 데스크톱 프록시 설정, 서비스 권한, 터미널 환경 변수 |
다운로드 / Platforms
먼저 운영체제와 프로세서 아키텍처를 확인한 다음 인터페이스, 설정 지원 범위, 권한 요구 사항을 비교하세요. 다운로드 센터에서 설치 파일과 시스템 요구 사항을 한눈에 확인할 수 있으며, 이 페이지의 플랫폼별 링크를 누르면 해당 분류로 바로 이동합니다.
Clash Plus, Clash Verge Rev, FlClash 등 데스크톱 클라이언트 중에서 선택하세요. 새로 설치한다면 계속 유지 관리되는 제품을 우선 고려하고, Clash for Windows는 보관된 참고 자료로만 활용하세요. 기존 설정은 옮길 수 있지만 이전 클라이언트의 확장 스크립트, 서비스 설정, 절대 경로를 그대로 복사하지 마세요.
설치 후 설정을 가져와 시스템 프록시를 켜세요. 브라우저에서는 접속되지만 터미널에서는 안 될 경우 클라이언트를 바로 재설치하기보다 터미널 환경 변수를 먼저 확인하세요. TUN이 필요한 앱은 서비스 권한과 가상 네트워크 인터페이스를 따로 점검해야 합니다.
다운로드 페이지로 이동 →Apple Silicon과 Intel 기기는 각각 맞는 설치 파일을 선택해야 합니다. ‘이 Mac에 관하여’에서 칩 정보를 확인할 수 있습니다. Clash Plus, Clash Verge Rev, FlClash는 데스크톱 인터페이스를 제공하며, ClashX Meta는 유지 관리가 중단됐으므로 마이그레이션 전에 기존 설정을 복사해 두세요.
처음 실행할 때 시스템 보안 알림과 네트워크 권한을 확인하세요. 시스템 프록시는 보통 현재 네트워크 서비스에 적용되므로 유선과 무선 네트워크를 바꾼 뒤 다시 확인해야 합니다. TUN은 클라이언트에 필요한 서비스나 권한이 있어야 하며 브라우저 설정만 바꾸는 것으로는 사용할 수 없습니다.
다운로드 페이지로 이동 →Clash Plus, Clash Meta for Android, FlClash, Surfboard를 비교해 볼 수 있습니다. 제품마다 지원하는 설정 형식이 다르므로 구독을 지원한다고 해서 모든 Clash 필드와 호환되는 것은 아닙니다. 설치 파일의 아키텍처는 기기에 맞춰야 하며, 잘 모르겠다면 다운로드 페이지의 선택 안내를 먼저 확인하세요.
처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 다른 VPN도 사용 중이라면 설정 문제를 판단하기 전에 시스템에서 현재 어느 서비스가 활성화되어 있는지 확인해야 합니다.
다운로드 페이지로 이동 →App Store에서 Clash Plus를 다운로드할 수 있으며, 제품 정보는 clashplus.io에서 확인하세요. 가져오기 전에 클라이언트가 지원하는 설정 형식을 확인하세요. 링크와 로컬 파일을 가져오는 메뉴는 제품 인터페이스에 따라 다르며 파일 확장자만으로 호환 여부를 판단할 수 없습니다.
설정을 저장한 뒤 VPN 권한을 허용하고 연결 경로를 선택해 연결하세요. Wi-Fi와 셀룰러 데이터의 접근 권한을 각각 확인해야 합니다. 문제를 진단할 때는 먼저 설정이 선택되어 있는지 확인하고 연결 상태를 살펴보세요. 특정 사이트 하나의 문제를 클라이언트 전체의 오류로 오해하지 않도록 주의해야 합니다.
다운로드 페이지로 이동 →데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있습니다. 서버나 라우터 환경에서는 mihomo 코어를 직접 실행하는 방법도 고려해 보세요. 먼저 배포판의 패키지 형식과 프로세서 아키텍처를 확인하세요. 데스크톱 설치 파일이 모든 기기에서 실행되는 범용 파일은 아닙니다.
터미널 프로그램은 일반적으로 데스크톱 시스템 프록시를 자동으로 사용하지 않습니다. 프로그램에서 지원하는 방식에 따라 프록시 환경 변수를 설정하거나 권한을 올바르게 구성한 TUN을 사용하세요. 원격으로 관리할 때는 복구 가능한 연결 경로를 먼저 확보한 뒤 기본 경로와 DNS를 변경해야 관리 세션이 끊기는 일을 막을 수 있습니다.
다운로드 페이지로 이동 →오픈 소스 참고 자료 / Source
Clash는 생태계를 가리키는 이름이며 모든 플랫폼에서 공통으로 사용하는 단일 설치 파일이 아닙니다. 문서를 확인할 때는 클라이언트 이름, 사용 중인 코어, 설정 출처를 함께 확인하세요. 특정 제품의 사용법을 모든 클라이언트에 공통으로 적용하지 않도록 주의해야 합니다.
데스크톱과 모바일 운영체제를 지원합니다. 설치 방식, 시스템 권한, 백그라운드 정책이 다르므로 각 기기에서 연결 동작을 확인해야 합니다.
mihomo 프로젝트는 소스 코드와 라이선스 전문을 공개합니다. 이 라이선스는 코어 프로젝트에 관한 것으로, 각 클라이언트나 스토어 앱의 라이선스까지 뜻하지는 않습니다.
프록시, 정책 그룹, 규칙을 하나의 기본 설정에 구성하거나 외부 규칙 세트와 제공자를 참조할 수 있습니다. 들여쓰기와 필드 지원 여부도 중요합니다.
초기 Clash 클라이언트는 YAML로 프록시와 라우팅 규칙을 설정하는 사용 방식을 정착시켰습니다. 기존 프로젝트의 유지 관리 상태가 바뀐 뒤에도 커뮤니티 클라이언트와 후속 코어는 계속 발전해 왔습니다. 따라서 이전 가이드의 버튼 이름, 다운로드 경로, 확장 필드가 현재 환경과 다를 수 있습니다. 마이그레이션할 때 기본적인 설정 구조는 유지하되 코어 지원 여부를 다시 확인하세요. 특히 DNS, TUN, 외부 리소스 경로를 점검해야 합니다. 과거 설정이 가져와진다는 것은 파싱에 성공했다는 뜻일 뿐, 기존 환경과 모든 동작이 같다는 의미는 아닙니다.
클라이언트는 보통 설정 다운로드, 정책 선택, 트레이 메뉴, 시스템 서비스를 관리하고 코어는 포트 수신, 규칙 적용, 연결을 담당합니다. 일부 인터페이스 스위치는 실행 전에 설정 파일을 생성하거나 실행 중 제어 인터페이스를 통해 값을 변경합니다. 따라서 구독 파일을 편집한 직후에는 화면에 표시된 값과 실제 적용된 값이 다를 수 있습니다. 문제를 확인할 때는 현재 선택된 설정, 실행 로그, 연결 세부 정보를 먼저 살펴본 뒤 오버라이드 사용 여부를 확인하세요. 구독 파일, 인터페이스 포트, 시스템 프록시를 한꺼번에 수정하면 어떤 변경이 결과에 영향을 줬는지 파악하기 어렵습니다.
클라이언트, 코어, 구독, 규칙 리소스 업데이트는 서로 다른 작업입니다. 클라이언트를 업데이트해도 만료된 구독이 자동으로 복구되지는 않으며, 구독을 다시 다운로드해도 구형 코어가 새 필드를 지원하게 되지는 않습니다. 업데이트 전에는 로컬 오버라이드와 사용자 지정 규칙을 저장하고 제품 릴리스 노트를 확인한 다음 한 번에 한 계층만 업데이트하세요. 업데이트 후에는 같은 앱과 대상에서 다시 테스트하고 차이를 기록하세요. 되돌려야 할 경우 설정 백업이 스위치 상태를 기억해 복원하는 것보다 안전합니다. 구독 주소에 접근 자격 증명이 포함될 수 있으므로 공개 토론이나 스크린샷에 올리지 마세요.
오픈 소스 저장소에서는 필드 정의, 라이선스, 알려진 문제를 확인할 수 있지만 임의의 클라이언트 설치 파일을 받는 대체 경로는 아닙니다. mihomo 저장소에는 코어 수준의 변경 사항이 기록됩니다. 인터페이스 버튼이 작동하지 않거나 서비스 설치에 실패하는 문제는 해당 클라이언트에 먼저 문의하세요. 문제를 제보할 때는 운영체제, 아키텍처, 재현 절차, 민감 정보를 제거한 로그를 함께 제공하세요. 구독 주소, 프록시 인증 정보, 외부 컨트롤러 키는 삭제해야 합니다. 특정 앱만 인터넷에 연결되지 않는다면 단순히 연결 실패라고 쓰지 말고 시스템 프록시나 TUN이 트래픽을 처리하는 방식도 설명하세요.
git clone https://github.com/MetaCubeX/mihomo.git이 명령은 코어 소스 코드를 가져옵니다. 실행 전에 Git을 설치해야 합니다.
먼저 현재 설정이 정상적으로 불러와지는지 확인한 다음 대상 앱의 트래픽이 클라이언트에 들어오는지 살펴보고 마지막으로 규칙과 연결 경로를 점검하세요. 시스템 프록시를 켰는데 연결 기록이 보이지 않으면 앱이 시스템 프록시를 사용하는지 먼저 확인해야 합니다. 기록은 보이지만 대상에 연결되지 않는다면 적용된 규칙, 도메인 조회, 선택된 연결 경로를 확인하세요. 지연 시간 테스트 결과는 테스트 대상과 방식에 따라 달라지므로 웹 페이지, 터미널, 다른 앱까지 정상적으로 접속된다고 단정할 수 없습니다. 계층별로 정보를 확인하면 권한, 설정, 네트워크 문제를 혼동하지 않을 수 있습니다.
전체 절차가 필요하다면 구독 가져오기 및 첫 연결 가이드부터 확인하세요. 설정 파싱이나 연결 문제가 발생하면 자주 묻는 질문과 문제 해결 안내를 참고하세요. 설치, 시스템 권한, 플랫폼별 설정은 전체 플랫폼 가이드에서 기기별로 확인할 수 있습니다.
기록 / Articles
구체적인 문제에 맞춰 읽어 보세요. iPhone 설정 가져오기, 구독 파싱 실패, 혼합 포트와 연결 모드의 기본 개념을 다룹니다. 먼저 해당 단계를 찾아본 다음 클라이언트에서 설정을 확인하세요.
iOS에서 Clash 설정을 지원하는 클라이언트를 App Store에서 받는 방법과 링크, 파일, QR 코드로 구독을 가져오는 방법을 안내합니다. VPN 권한 허용과 백그라운드 실행 설정도 함께 설명합니다.
글 읽기 →구독 링크 만료, 잘못된 응답 형식, YAML 들여쓰기 오류, 코어의 새 필드 미지원 문제를 바깥 단계부터 차례로 확인하고 로그에 나타나는 오류의 의미를 설명합니다.
글 읽기 →초보자가 자주 막히는 10가지 질문을 모았습니다. 클라이언트와 코어의 관계, 규칙 모드와 전역 모드의 차이, 7890 포트의 역할, 구독 업데이트 주기 등을 설명하고 각 항목의 설정 위치를 안내합니다.
글 읽기 →