CONFIG / 설정 노트
트래픽이 들어와 규칙에 따라 나가기까지, 설정 항목별로 연결 처리 방식을 살펴보세요.
Clash는 규칙 기반 트래픽 분할을 중심으로 한 프록시 도구 생태계입니다. 클라이언트는 설치와 설정 관리, 시스템 연동을 담당하고 코어는 실제 연결을 처리합니다. 모든 설정을 한 번에 익힐 필요는 없습니다. 먼저 설정이 정상적으로 로드되고 정책 그룹을 선택할 수 있는지 확인한 뒤 모드, DNS, 규칙을 차례로 살펴보세요. 아래 예시는 기존 설정을 이해하는 데 참고할 수 있는 개별 항목이며, 구독을 대체하는 완전한 연결 설정은 아닙니다.
규칙 모드에서는 코어가 위에서 아래로 규칙을 확인하고, 처음 일치하는 규칙을 지정된 정책으로 전달합니다. 별도로 처리할 사이트는 일반 규칙보다 앞에 두고, 마지막에 MATCH로 나머지 연결을 처리하세요. 아래의 Proxy는 정책 그룹 이름이므로 설정에 정의된 이름과 정확히 일치해야 합니다. 변경한 뒤에는 클라이언트의 연결 화면에서 대상 도메인, 일치한 규칙, 실제 연결 경로를 확인할 수 있습니다. 결과가 예상과 다르면 구독 전체를 계속 바꾸기보다 규칙 순서부터 점검하세요.
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxyrule은 규칙에 따라 연결 경로를 선택하고, global은 코어로 들어온 연결을 전역 정책에 전달하며, direct는 대상에 바로 연결합니다. 모드 설정만으로 시스템 프록시나 TUN이 적용되는 것은 아니며, 모든 앱의 트래픽이 코어로 전달된다는 뜻도 아닙니다. 처음에는 규칙 모드를 유지하고 특정 사이트에서 문제가 생길 때만 잠시 전역 모드로 바꿔 비교해 보세요. 두 모드 모두 연결되지 않으면 설정, 정책 그룹, 네트워크를 계속 점검해야 합니다. 전역 모드를 만능 해결책으로 여기지 마세요. 클라이언트 화면에서 모드를 바꾼 뒤에는 현재 실행 중인 설정을 기준으로 결과를 확인하세요.
# 규칙 모드
mode: rule
# 다른 선택값: global, direct
# mode: globalFake-IP는 DNS 조회에 매핑용 주소를 반환하고, 코어는 이를 이용해 후속 연결을 원래 도메인과 연결하므로 도메인 규칙을 적용하기 쉽습니다. 정상적인 트래픽 가로채기와 DNS 경로가 함께 설정되어야 하며, 항목만 입력한다고 시스템의 DNS 조회가 클라이언트로 전달되는 것은 아닙니다. LAN 기기나 특정 앱에서 호환성 문제가 생기면 해당 도메인을 필터링하고 조회 및 연결 기록을 확인하세요. 클라이언트나 구독에서 이미 적용한 DNS 설정을 우선 사용하고, 원인을 파악하기 어려워지지 않도록 여러 DNS 옵션을 동시에 바꾸지 마세요.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
fake-ip-filter:
- "*.lan"정책 그룹을 사용하면 규칙과 실제 연결 경로를 따로 관리할 수 있습니다. select 그룹은 화면에서 항목을 직접 선택할 수 있으므로, 규칙은 그룹 이름만 지정하면 되고 선택을 바꿀 때마다 수정할 필요가 없습니다. 아래 예시는 내장된 DIRECT만 사용하므로 모든 항목이 직접 연결되며 원격 프록시 기능은 제공하지 않습니다. 실제로 사용하려면 합법적으로 받은 설정을 가져온 다음, 사용 가능한 노드를 정확한 이름으로 그룹에 추가하세요. 클라이언트에서 프록시를 찾을 수 없다고 표시되면 이름과 대소문자, 참조 관계를 확인하고 현재 활성화된 설정을 수정했는지도 살펴보세요.
proxy-groups:
- name: Proxy
type: select
proxies:
- DIRECT
rules:
- MATCH,ProxyYAML은 들여쓰기로 계층을 나타냅니다. 목록 앞의 하이픈과 콜론 뒤의 공백도 파싱 결과에 영향을 줍니다. 수정 전에는 복사본을 내보내고, 한 번에 한 종류의 항목만 바꾼 뒤 다시 로드하세요. 구독 업데이트로 원본 파일이 다시 생성될 수 있으므로 계속 유지해야 하는 포트나 규칙은 클라이언트가 지원하는 오버라이드 또는 병합 기능에 넣는 편이 좋습니다. 배열을 교체하거나 추가하는 순서는 클라이언트마다 다를 수 있으니 저장 후 실행 설정을 확인하세요. 편집기에서 보이는 텍스트만으로 코어에 변경 사항이 적용됐다고 판단하지 마세요.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
# 들여쓰기는 공백으로 하고 탭은 사용하지 마세요
dns:
enable: true먼저 연결만 설정하려면 빠른 시작을 확인하세요. 용어 설명이 필요하면 용어집을 참고하세요. 위 창의 예시에는 직접 연결 경로만 포함되어 있으며, 설정 구조를 설명하기 위한 것입니다.
CLIENTS / 플랫폼별 클라이언트
먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 알맞은 클라이언트를 선택하세요. 설치 파일과 시스템 요구 사항은 다운로드 페이지에서 확인할 수 있습니다.
일반적인 데스크톱 사용에는 Clash Plus부터 확인하고 Clash Verge Rev, FlClash 등과 비교해 보세요. 설치 전에 시스템의 ‘설정 → 시스템 → 시스템 정보’에서 프로세서 종류를 확인하세요. 컴퓨터 브랜드만으로 아키텍처를 판단하면 안 됩니다. 처음 실행한 뒤 설정을 가져오고 클라이언트에서 시스템 프록시를 켜세요. 더 많은 앱의 트래픽을 처리하려면 TUN 권한 안내를 확인하세요.
Clash for Windows는 더 이상 유지 관리되지 않으며 다운로드 페이지에서 보관된 버전으로 안내합니다. 기존 클라이언트에서 옮길 때는 설정을 내보내고 포트와 정책 그룹 선택을 기록하세요. 기존 프로그램 폴더 전체를 새 클라이언트에 덮어쓰지 마세요.
다운로드 페이지로 이동Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 칩 정보를 확인해 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash 등을 확인할 수 있습니다. 앱을 ‘응용 프로그램’ 폴더로 옮긴 뒤 실행하고, 실제로 표시되는 안내에 따라 시스템 프록시 또는 네트워크 확장 권한을 허용하세요. 필요한 권한은 클라이언트마다 다를 수 있습니다.
키체인 확인 창이 반복해서 뜨면 요청을 보낸 앱이 방금 실행한 클라이언트인지 확인한 뒤 가이드에 따라 권한 기록을 점검하세요. 클라이언트를 종료한 뒤에도 웹페이지가 열리지 않으면 시스템 네트워크 설정에서 프록시가 해제되었는지 확인하세요.
다운로드 페이지로 이동다운로드 페이지에서 Clash Plus, Clash Meta for Android, FlClash, Surfboard 순으로 확인할 수 있습니다. 설치 파일을 선택할 때 기기의 아키텍처를 확인하세요. 설정을 가져와 실행하면 시스템에서 VPN 연결을 요청하므로 권한을 허용하세요. 연결이 설정되면 일반적으로 상태 표시줄에 관련 아이콘이 나타납니다. 아이콘은 네트워크 통로가 만들어졌다는 뜻일 뿐, 설정에 포함된 모든 연결 경로가 작동한다는 의미는 아닙니다.
백그라운드에서 계속 실행해야 한다면 시스템의 배터리 관리와 백그라운드 제한을 확인하세요. Surfboard를 사용한다면 설정 형식이 호환되는지도 확인해야 합니다. 파일 확장자만으로 바로 가져올 수 있다고 판단하면 안 됩니다.
다운로드 페이지로 이동iPhone 및 iPad 사용자는 다운로드 페이지에서 Clash Plus의 App Store 링크를 열고 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치한 뒤 클라이언트에서 제공하는 방법으로 구독이나 설정을 가져오고, 처음 연결을 활성화할 때 시스템의 VPN 설정 추가를 허용하세요. 권한을 허용한 다음 현재 설정과 정책 그룹을 확인하세요. ‘설정 추가 허용’을 누르는 것만으로 연결 설정이 모두 끝나는 것은 아닙니다.
모바일 데이터와 Wi-Fi는 DNS 설정이나 네트워크 제한이 다를 수 있습니다. 네트워크를 바꾼 뒤 접속 문제가 생기면 먼저 연결 기록과 설정 상태를 확인한 다음 문제 해결 가이드에 따라 항목별로 점검하세요.
다운로드 페이지로 이동데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판의 패키지 형식에 맞는 설치 방법을 확인하세요. 설치 후에는 데스크톱 환경의 시스템 프록시 설정이 적용됐는지 확인해야 합니다. 터미널 도구는 프록시 환경 변수를 따로 설정해야 하는 경우가 많으므로 브라우저에서 접속된다는 이유만으로 모든 프로그램이 연결됐다고 판단하지 마세요.
서버와 라우터에서 사용할 경우 다운로드 페이지의 코어 섹션에서 mihomo를 확인하세요. 코어를 직접 실행하려면 설정 경로, 서비스 권한, 로그를 직접 관리해야 합니다. 처음이라면 GUI 클라이언트로 설정 간 관계를 익히는 편이 좋습니다.
다운로드 페이지로 이동QUICKSTART / 3단계 시작하기
확인 가능한 연결 절차부터 마친 다음 고급 옵션을 조정하세요.
클라이언트의 ‘설정’ 또는 ‘Profiles’ 페이지를 열고 링크 가져오기를 선택한 뒤, 합법적으로 받은 구독 주소를 붙여 넣으세요. YAML 파일이 있다면 로컬 파일 가져오기를 선택하면 됩니다. 다운로드와 파싱이 끝날 때까지 기다린 다음 해당 설정을 선택하세요. 화면에 설정 이름이나 업데이트 시간이 표시되는 경우가 많습니다. 파싱 오류가 나타나면 링크가 계정 로그인 페이지가 아니라 설정 텍스트를 반환하는지 먼저 확인하세요.
구독 주소에는 계정 접근 정보가 포함될 수 있으므로 전체 주소를 공개 게시판에 올리지 마세요. 가져오기에 성공했다는 것은 파일을 인식했다는 뜻일 뿐, 정책 그룹과 연결 경로까지 사용할 수 있다는 의미는 아닙니다. 처음에는 원본 파일을 보관해 두세요. 가져오면서 바로 수정하면 되돌리기 어려울 수 있습니다.
‘프록시’ 또는 ‘정책 그룹’ 페이지에서 규칙 모드를 선택한 다음, 주요 정책 그룹에서 사용할 수 있는 연결 경로를 선택하세요. 설정에 여러 단계의 정책 그룹이 포함되어 있다면 최종 선택 항목이 나올 때까지 그룹을 더 살펴봐야 할 수 있습니다. 그룹 이름은 설정 작성자가 정한 표기일 뿐, 연결이 정상인지 알려 주지는 않습니다. 먼저 기존 규칙과 DNS 설정을 유지해 변수를 줄이세요.
데스크톱에서는 이어서 시스템 프록시를 켜고, 모바일에서는 안내에 따라 VPN 연결을 설정하세요. TUN은 더 많은 트래픽을 처리해야 하는 상황에 적합하지만 권한과 라우팅 설정이 필요합니다. 브라우저에서 이미 규칙에 따라 접속할 수 있다면 ‘모든 기능’을 켜려고 모든 트래픽 처리 옵션을 한꺼번에 활성화할 필요는 없습니다.
브라우저에서 접속 가능한 사이트를 열고 클라이언트의 ‘연결’ 또는 ‘로그’ 페이지에서 해당 요청과 일치한 규칙, 사용된 정책을 확인하세요. 요청은 보이지만 접속이 실패한다면 연결 경로와 DNS를 점검하세요. 요청 자체가 보이지 않으면 앱이 시스템 프록시를 사용하는지, 포트 번호가 일치하는지 먼저 확인하세요.
확인할 때는 한 번에 한 항목만 바꾸고 다시 접속해 결과를 비교하세요. 네트워크에 문제가 생겼을 때를 대비해 연결을 일시 중지하고 시스템 프록시를 복구하는 방법도 알아 두세요. 전체 가이드에서 설정 업데이트, 모드 전환, 자주 발생하는 오류를 처리하는 순서를 확인할 수 있습니다.
OPEN SOURCE / 프로젝트 관계
이름 하나만 보는 것보다 프로젝트의 출처, 클라이언트 유지 관리, 설정 업데이트를 구분하는 편이 도움이 됩니다.
Clash는 규칙 기반 프록시와 YAML 설정을 중심으로 사용자 생태계를 형성했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티에서 관련 코어와 GUI 클라이언트가 계속 개발됐습니다. Clash Meta는 이후 mihomo로 이름이 바뀌었으므로 가이드, 설정 설명, 클라이언트 설정에서 두 이름을 모두 볼 수 있습니다. 이름 사이에 계승 관계가 있더라도 모든 구형·신형 설정 항목, 프로토콜, 클라이언트 기능이 완전히 호환된다는 뜻은 아닙니다.
특정 설정 항목이 적용되지 않으면 먼저 클라이언트의 정보 또는 코어 페이지에서 현재 사용하는 코어를 확인한 다음 해당 문서를 찾아보세요. 오래된 가이드로 기본 개념을 이해할 수는 있지만, 현재 기능의 지원 범위를 판단하는 근거로 삼아서는 안 됩니다. 특히 DNS, TUN, 규칙 제공자 관련 설정은 코어 기능과 클라이언트 통합 방식에 따라 달라질 수 있습니다.
Clash Verge Rev, FlClash 등의 GUI 클라이언트는 주로 설정 관리, 화면 표시, 시스템 프록시와 권한 연동을 담당합니다. mihomo는 설정을 파싱하고 규칙을 적용해 연결을 구성합니다. 클라이언트와 코어 프로젝트는 각자 다른 일정으로 유지 관리되므로, 앱 화면이 바뀌었다고 코어 동작도 함께 바뀌는 것은 아닙니다. 플랫폼과 실제 필요에 맞춰 다운로드 항목을 선택하세요. 이름에 Clash가 들어간다는 이유만으로 기능이 같다고 판단할 필요는 없습니다.
오픈소스 라이선스는 코드를 사용, 수정, 배포할 때 지켜야 할 조건을 설명할 뿐, 여러 프로젝트가 하나의 배포 주체를 공유한다는 뜻은 아닙니다. 이 사이트는 다운로드 정보와 한국어 안내를 정리하며, 각 클라이언트의 유지 관리 주체는 해당 프로젝트 자료를 기준으로 확인할 수 있습니다. 프로젝트 간 관계가 궁금하다면 Clash, Clash Meta, mihomo의 관계 정리를 읽고 설정을 옮길지 유지할지 결정하세요.
클라이언트를 업데이트하면 화면, 시스템 연동 또는 함께 제공되는 코어가 바뀔 수 있습니다. 구독 업데이트는 주로 노드, 정책 그룹, 규칙 내용을 변경합니다. 구독을 업데이트한 뒤 연결 문제가 생겼다면 앱을 바로 재설치하기보다 설정이 어떻게 바뀌었는지 먼저 비교하세요. 클라이언트 업그레이드 전에는 현재 설정을 내보내고 오버라이드 내용과 프록시 포트를 기록하세요. 새 환경에서 설정이 로드되는지 확인한 뒤 이전 파일을 정리하세요.
구독 관리에는 서비스 주소와 계정 권한이 관련됩니다. 클라이언트에서 특정 프로토콜을 읽을 수 있다고 해서 출처를 알 수 없는 링크까지 신뢰할 수 있는 것은 아닙니다. 출처를 확인했고 사용할 권한이 있는 설정만 가져오세요. 공개적으로 도움을 요청할 때는 구독 주소의 접근 매개변수, 계정 정보, 노드 인증 정보를 가리세요. 이 사이트는 설정 항목과 사용법을 안내하며, 범용 무료 노드라는 명목의 자료를 배포하거나 제3자 서비스의 연결을 보장하지 않습니다.
mihomo 프로젝트는 GPL-3.0 라이선스를 사용하며, 공개 저장소에서 구현 내용, 이슈 논의, 릴리스 정보를 확인할 수 있습니다. 직접 빌드하거나 수정한 프로그램을 배포하려면 라이선스와 관련 의존성 안내를 꼼꼼히 읽으세요. 일상적인 사용이 목적이라면 GUI 클라이언트부터 시작하면 되며, 먼저 빌드 환경을 준비할 필요는 없습니다.
오른쪽 명령은 공개 소스 코드를 로컬 디렉터리에 내려받기만 하며 클라이언트 설치, 프록시 연결, 시스템 네트워크 변경은 하지 않습니다. 복사한 뒤 Git이 설치된 터미널에서 실행하세요. 설정 항목의 뜻만 확인하려면 사이트의 설정 항목 참고나 용어집을 열어보는 편이 빠릅니다. 구현 내용을 확인해야 한다면 소스 코드와 프로젝트 문서를 함께 살펴보세요.
NOTES / 최근 업데이트
실제 사용 중 발생한 오류를 바탕으로 설정을 순서대로 점검하고, 원인을 파악할 수 있도록 연결 기록을 확인하세요.
연결됨으로 표시된다고 요청이 대상에 정상적으로 도착한 것은 아닙니다. 시스템 프록시, 포트 충돌, 정책 그룹 선택, 규칙 일치, DNS, Fake-IP 순서로 점검하세요. 요청이 코어에 전달되지 않은 경우와 전달된 뒤 연결이 실패한 경우를 구분하면 반복적인 재설치로 인한 혼선을 줄일 수 있습니다.
문제 해결 체크리스트 보기 →구독 가져오기 시간 초과, 파싱 실패, 인증서 오류는 각각 다르게 해결해야 합니다. 먼저 네트워크 요청이 성공했는지 확인한 뒤 응답을 설정으로 읽을 수 있는지 살펴보세요. 자동 업데이트 간격과 로컬 오버라이드의 관계도 알아두면 업데이트 후 수동 변경 사항이 사라지는 일을 방지할 수 있습니다.
업데이트 설정 확인 →‘열 수 없음’ 오류, 네트워크 확장 권한 요청, 키체인 팝업이 반복될 때는 먼저 팝업을 표시한 앱과 요청 권한을 확인한 다음 해당 시스템 설정에서 처리하세요. 이 글에서는 설정 위치를 단계별로 안내하고 앱 실행, 프록시 권한 허용, 연결 확인 과정을 구분해 설명합니다.
권한 안내 보기 →아직 클라이언트를 설치하지 않았다면 플랫폼별 다운로드 페이지에서 시작하세요. 연결은 되지만 특정 사이트에서 문제가 생긴다면 증상에 맞는 문제 해결 글을 먼저 확인하세요. 설정 구조를 바꿔야 할 때는 항목 참고 자료를 보며 하나씩 수정하고, 네트워크 설정 전체를 한꺼번에 바꾸지 마세요.
전체 글 보기 →