Windows
일반적인 데스크톱 사용자는 Clash Plus 또는 Clash Verge Rev부터 살펴보세요. 설치 전에 “설정 → 시스템 → 시스템 정보”에서 시스템 종류를 확인한 뒤 다운로드 페이지의 요구 사항과 대조하세요. 처음 실행하면 구독을 가져오고 시스템 프록시를 켜면 됩니다. 일부 앱이 시스템 프록시를 따르지 않을 때만 TUN 모드를 고려하세요. 처음부터 권한, 라우팅, DNS를 한꺼번에 변경하지 않는 편이 좋습니다.
기기에 맞는 Clash 클라이언트를 선택하고 구독 가져오기부터 시작하세요. 그런 다음 규칙 분기와 TUN 모드를 설정하면 됩니다. 기본 연결과 고급 설정은 나누어 확인할 수 있습니다.
영구 무료오픈 소스한국어 문서
플랫폼을 고른 다음 클라이언트를 선택하세요
Clash 다운로드 플랫폼 및 설치 방법
데스크톱에서는 계속 유지 관리되는 GUI 클라이언트를 우선 선택하세요. 모바일에서는 시스템 권한과 구독 형식을 먼저 확인하면 됩니다. 다운로드 페이지에서 플랫폼별 클라이언트, CPU 아키텍처, 설치 요구 사항을 확인할 수 있습니다. 이 페이지에서는 선택 항목만 안내하며, 운영체제가 다른 설치 파일을 한데 섞어 소개하지 않습니다.
macOS
먼저 “이 Mac에 관하여”에서 칩을 확인하세요. Apple Silicon과 Intel 프로세서는 서로 다른 설치 파일을 사용합니다. 설치 후에는 시스템 안내에 따라 네트워크 관련 기능을 허용하세요. 클라이언트를 바꿀 때는 기존 프로그램을 종료하고 시스템 프록시를 끈 다음 새 프로그램을 실행하세요. 두 클라이언트가 동시에 프록시 설정을 변경하면 브라우저는 연결되지만 다른 앱은 연결되지 않는 문제가 생길 수 있습니다.
Android
최근 기기의 대부분은 ARM64를 사용하지만, 구형 기기는 프로세서 아키텍처를 확인해야 합니다. Clash Plus, Clash Meta for Android, FlClash는 설정 메뉴가 서로 다르지만 구독 가져오기를 먼저 해야 하는 점은 같습니다. 연결할 때 시스템 VPN 요청을 허용하세요. 화면을 잠근 뒤 연결이 끊기면 배터리 최적화와 백그라운드 제한을 먼저 확인하세요. 모든 백그라운드 문제를 구독 만료 탓으로 돌릴 필요는 없습니다.
iOS
다운로드 페이지에서 Clash Plus의 App Store 페이지와 공식 웹사이트 clashplus.io로 이동할 수 있습니다. 설치 후 기존 구독을 추가하고, 처음 연결할 때 시스템 안내에 따라 VPN 구성을 허용하세요. 상태 표시줄의 VPN 표시는 네트워크 확장이 실행 중이라는 뜻일 뿐입니다. 정책 선택과 실제 웹 접속도 확인해야 하며, 다른 VPN 앱이 현재 연결에 영향을 줄 수도 있습니다.
Linux
데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 선택하고 배포판에 맞는 패키지를 설치하세요. 서버와 라우터에서 사용할 경우 다운로드 페이지의 mihomo 코어 항목을 확인하면 됩니다. GUI 클라이언트와 명령줄 코어는 설치 방법이 다릅니다. 데스크톱 프록시 환경 변수, 브라우저 프록시, TUN 라우팅도 각각 별도로 적용되므로 설치 후 앱이 실제로 어떤 네트워크 경로를 사용하는지 확인해야 합니다.
전체 클라이언트 보기 →
클라이언트를 사용 중인데 인터넷에 연결되지 않나요? 클라이언트 이름, 실행 모드, 로그 오류를 먼저 기록한 다음 도움말을 확인하세요. 반복해서 재설치할 필요는 없습니다.
규칙·DNS·연결 설정
필요한 설정 항목을 골라 확인하세요. 아래 YAML은 기능별 예시이며 단독으로 실행할 수 있는 전체 설정이 아닙니다. 예시에 나오는 PROXY 정책 이름은 실제 설정에 정의해야 합니다. 클라이언트마다 메뉴 이름이 다를 수 있으므로 적용된 설정과 코어 로그를 기준으로 확인하세요.
규칙 분기: 위에서부터 순서대로 대상 매칭
규칙은 위에서부터 차례로 확인하며, 처음 일치하는 규칙의 정책을 적용합니다. 도메인 규칙은 특정 웹사이트에, IP 규칙은 명확한 대역에 적합하며 MATCH는 마지막에 두어 나머지 트래픽을 처리합니다. 특정 웹사이트를 직접 연결하려면 연결 기록에서 실제 도메인과 일치한 규칙을 확인한 뒤, 더 구체적인 규칙을 일반 규칙보다 앞에 배치하세요. 전역 모드와 달리 규칙 모드에서는 연결마다 서로 다른 정책을 적용할 수 있습니다. 지속적으로 사용할 변경 사항은 로컬 오버라이드에 저장해야 구독 업데이트 후에도 유지됩니다.
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYTUN 모드: 시스템 네트워크 트래픽 가로채기
TUN은 가상 네트워크 인터페이스를 만들어 시스템 프록시 설정을 읽지 않는 앱의 트래픽도 규칙 처리 과정으로 전달합니다. 데스크톱에서는 보통 서비스 모드나 관리자 권한이 필요하며, 모바일에서는 시스템 VPN 인터페이스를 사용합니다. 켜기 전에 비슷한 네트워크 도구를 종료하고 정상 작동하는 설정을 백업하세요. auto-route는 라우팅에 영향을 주고 DNS 하이재킹은 이름 확인 경로를 바꾸므로, 스위치가 켜졌다는 이유만으로 연결이 성공했다고 판단할 수 없습니다. 인터넷이 끊기면 먼저 TUN을 끄고 기본 네트워크를 확인한 뒤 권한, 기본 경로, DNS 로그를 점검하세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53구독 관리: 제공 설정과 로컬 변경 구분하기
구독 링크는 완전한 Clash YAML을 반환할 수도 있고 노드 목록만 반환할 수도 있으므로, 가져오기 전에 서비스 제공자가 안내한 형식을 확인하세요. GUI 클라이언트의 구독 가져오기는 설정을 다운로드하고 전환하는 기능이며, proxy-providers는 설정 파일 안에서 프록시 목록을 관리하는 기능입니다. 서로 다른 항목입니다. 구독을 업데이트하기 전에 로컬 규칙과 오버라이드를 백업하고, 업데이트 후 현재 설정이 계속 선택되어 있는지 확인하세요. 구독 주소의 토큰은 접근 자격 증명과 같습니다. 스크린샷, 로그, 질문에 첨부하는 내용에서는 반드시 가리세요. 실제 주소를 잘 모르는 온라인 변환 서비스에 입력하지 마세요.
proxy-providers:
local-nodes:
type: file
path: ./providers/nodes.yaml
proxy-groups:
- name: PROXY
type: select
use:
- local-nodesDNS 설정: 먼저 이름 확인 경로 점검하기
웹페이지는 열리지 않지만 프록시 연결은 성립한다면 도메인 이름 확인 실패, 노드 연결 불가, 잘못된 규칙 선택을 구분해야 합니다. Fake-IP는 예약된 주소에 도메인을 매핑해 연결 단계에서도 코어가 도메인 정보를 유지하도록 합니다. 실제 서버 주소가 아니며 DNS 오류를 뜻하지도 않습니다. 암호화 DNS를 설정할 때는 DNS 서버의 도메인 자체를 어떻게 확인할지도 고려해야 합니다. 우선 작동하는 상위 DNS 서버를 유지하고 분기 정책을 하나씩 추가하세요. LAN 기기 이름, 프린터 또는 특정 앱에 문제가 생기면 DNS 기능을 전부 끄기보다 로그를 확인해 fake-ip-filter 적용 여부를 살펴보세요.
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://1.1.1.1/dns-queryLAN 공유: 리스닝 주소와 방화벽 함께 점검하기
LAN 연결을 허용하면 같은 신뢰할 수 있는 네트워크의 기기가 이 컴퓨터의 프록시 포트에 연결을 시도할 수 있습니다. allow-lan만 켜서는 충분하지 않습니다. 리스닝 주소, 시스템 방화벽, 네트워크 격리 설정도 연결에 영향을 줍니다. 다른 기기에서는 자기 자신의 루프백 주소가 아니라 컴퓨터의 LAN 주소를 입력해야 합니다. 컴퓨터가 절전 모드에 들어가거나 주소가 바뀐 뒤에도 다시 확인하세요. 실제 사용하는 인터페이스에만 리스닝하도록 제한하고 방화벽에서 허용할 출발지 대역도 제한하는 것이 좋습니다. 공용 네트워크에서 프록시 포트를 직접 열지 말고, 외부 제어 포트를 프록시 포트로 입력해서도 안 됩니다.
mixed-port: 7890
allow-lan: true
# 리스닝 주소를 이 컴퓨터의 실제 LAN 주소로 변경
bind-address: 192.168.1.10외부 제어: 관리 인터페이스와 프록시 포트 구분하기
external-controller는 패널에서 연결 정보를 읽고, 정책 그룹을 전환하거나 일부 실행 상태를 변경할 수 있도록 관리 API를 제공합니다. 브라우저 요청을 중계하지 않으므로 mixed-port를 대신할 수 없습니다. 로컬에서만 사용할 때는 루프백 주소에 바인딩하고 별도의 인증 키를 설정하세요. 원격 관리는 인증과 네트워크 접근 제한을 별도로 설계해야 합니다. 외부 패널에 연결되지 않으면 주소, 포트, 키가 일치하는지 먼저 확인한 뒤 브라우저의 교차 출처 및 보안 컨텍스트 제한을 점검하세요. 클라이언트 화면에서 변경한 내용이 영구 저장되는지는 설정 생성 및 오버라이드 방식에 따라 다릅니다.
external-controller: 127.0.0.1:9090
# 설명용 예시입니다. 사용 전에 별도의 무작위 키로 바꾸세요
secret: "your-controller-secret"
코어 / 클라이언트 / 설정
mihomo 코어와 Clash 클라이언트의 관계
먼저 트래픽을 전달하는 코어, 조작을 담당하는 GUI, 연결 정보를 제공하는 구독을 구분하세요. 세 요소는 각각 관리되며 업데이트 주기도 다릅니다. 이 사이트는 다운로드 경로와 설정 문서를 정리하며 프록시 구독을 제공하거나 각 클라이언트 개발팀을 대표하지 않습니다.
프로젝트의 발전 과정과 유지 관리 범위
Clash는 규칙 기반 프록시 코어에서 출발해 생태계를 형성했으며, GUI 클라이언트는 그 위에 설정 선택, 시스템 프록시, 연결 확인 등의 기능을 제공합니다. 원래 프로젝트와 일부 초기 데스크톱 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티에서 여러 분기가 이어졌습니다. mihomo는 Clash Meta의 개발 방향을 이어받아 규칙, DNS, TUN, 다양한 프록시 프로토콜을 지원합니다. 이름이 비슷하다고 같은 소프트웨어인 것은 아니며, 오래된 안내서에 나온 버튼이 현재 클라이언트에도 있다는 뜻도 아닙니다.
자료를 찾을 때는 사용 중인 GUI 클라이언트와 내장 코어를 먼저 확인한 다음 해당 문서를 참고하세요. 화면의 메뉴 이름만 같다고 충분하지 않습니다. 클라이언트에 따라 설정을 직접 생성하거나, 오버라이드 파일을 병합하거나, 편집 가능한 항목을 제한할 수 있습니다. 다른 클라이언트의 전체 설정을 그대로 덮어쓰면 기존 구독 관리가 우회되거나 관리 API와 리스닝 설정이 덮어써질 수 있습니다. 마이그레이션 전에 기존 설정과 로컬 변경 사항을 보관하고, 새 프로그램이 정상적으로 실행되는지 확인한 뒤 항목별로 옮기세요.
GUI는 조작을, 코어는 연결을 담당합니다
Clash 클라이언트는 보통 트레이 메뉴, 시작 프로그램 등록, 시스템 프록시, 구독 다운로드, 설정 편집을 담당합니다. 실제 연결 처리, 도메인 이름 확인, 규칙 적용은 코어가 맡습니다. 화면에 “실행 중”이라고 표시되어도 프로세스가 동작 중이라는 뜻일 뿐, 구독이 유효하거나 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 문제를 나눠서 확인하세요. 클라이언트가 실행되는지, 설정을 불러오는지, 노드 연결이 성립하는지, 규칙이 예상한 정책에 일치하는지, 도메인 이름 확인이 성공하는지 점검해야 합니다.
시스템 프록시와 TUN도 서로 다른 계층에서 동작합니다. 시스템 프록시는 이 설정을 따르는 앱에 로컬 포트로 연결하도록 안내하며, 일부 명령줄 도구는 프록시 환경 변수를 별도로 설정해야 합니다. TUN은 가상 인터페이스와 라우팅을 이용해 더 많은 트래픽을 처리하지만 권한과 네트워크 환경의 영향을 더 크게 받습니다. 브라우저는 접속되는데 특정 프로그램은 되지 않는다고 해서 노드가 끊겼다고 단정할 수 없습니다. 연결 목록에 해당 프로그램이 나타나는지 먼저 확인한 뒤 프록시 진입 경로와 정책 규칙 중 무엇을 점검할지 결정하세요. 모든 스위치를 한꺼번에 켜는 것보다 원인을 찾기 쉽습니다.
구독은 설정을 제공하며 클라이언트가 서비스를 만들어 주지는 않습니다
설치가 끝나도 기존 구독이나 직접 설정한 연결 정보가 필요합니다. 구독에는 노드, 정책 그룹, 규칙, DNS가 포함될 수도 있고 프록시 목록만 포함될 수도 있습니다. 가져오기 중 형식 오류가 발생하면 응답 내용이 Clash YAML인지 먼저 확인하세요. 브라우저에서 링크를 열었을 때 로그인 페이지나 오류 페이지가 표시된다면 클라이언트도 이를 설정으로 읽을 수 없습니다. 구독이 빈 목록을 반환하거나 인증에 실패하거나 시간 초과가 발생한다면 로컬 프록시 포트를 바꾸기보다 서비스 상태, 링크 유효성, 다운로드 경로를 확인해야 합니다.
구독 링크의 토큰은 자격 증명으로 취급해야 합니다. 스크린샷을 공유할 때 주소 전체를 가리고, 설정을 내보내기 전에 계정 관련 내용을 삭제하세요. 공개적으로 도움을 요청할 때는 필요한 오류와 민감 정보를 가린 설정 조각만 남기면 됩니다. 타사 구독 변환 서비스를 사용하면 원본 링크가 다른 서비스에 전달되므로, 이용 전에 데이터가 처리되는 방식을 확인하세요. 구독 업데이트가 로컬 설정 업데이트를 의미하는 것은 아닙니다. 클라이언트가 규칙을 다시 생성할 수 있으므로 개인별 분기 규칙은 지원되는 오버라이드 방식으로 저장하고, 업데이트 후 실제 적용된 내용을 확인하세요.
오픈 소스 기록은 확인 자료이지 실행 검증을 대신하지 않습니다
mihomo는 GPL-3.0 라이선스를 사용하며 소스 코드와 개발 기록은 저장소에서 확인할 수 있습니다. GUI 클라이언트마다 프로젝트, 라이선스, 릴리스 안내가 다르므로 각각 확인하세요. 오픈 소스의 실질적인 장점은 구현과 변경 내역을 검토할 수 있고 호환성 문제와 관련된 논의를 찾을 수 있다는 것입니다. 특정 네트워크 환경, 구독 링크, 설정 조합의 작동을 보장하지는 않습니다. 이 사이트는 확인할 수 있는 자료 대신 검증되지 않은 다운로드 수, 평점, 속도 측정 수치를 내세우지 않습니다.
문제를 보고할 때는 운영체제와 클라이언트 이름, 관련 설정, 재현 가능한 절차를 함께 제공하세요. 로그는 오류 전후의 필요한 부분만 첨부하고 구독, 키, 개인이 접속한 대상은 가려야 합니다. “address already in use”는 리스닝 포트 충돌을, “connection refused”는 대상 포트에서 연결을 거부했음을 나타냅니다. 이름 확인이 실패했다면 DNS 경로를 추가로 확인해야 합니다. “인터넷이 안 돼요”라고만 적는 것보다 실제 오류 문구를 보존하는 편이 유용하며, 클라이언트·설정·서버 문제를 구분하는 데도 도움이 됩니다.
업데이트 순서와 되돌릴 수 있는 설정
클라이언트, 코어, 구독, 지리 데이터베이스는 각각 별개의 업데이트 대상입니다. 클라이언트 업데이트는 화면과 서비스 구성 요소를 바꿀 수 있고, 코어 업데이트는 프로토콜과 설정 항목에 영향을 줄 수 있습니다. 구독 업데이트는 연결 정보와 규칙을 바꾸며 GeoIP 데이터 업데이트는 지역 정보에 의존하는 매칭 결과를 바꿉니다. 한 번에 한 종류만 변경하고 변경 전 상태를 기록하세요. 문제가 생기면 모든 설정을 초기화하기보다 가장 최근에 변경한 항목을 되돌리는 편이 원인을 찾기 쉽습니다.
처음 설정할 때는 규칙 모드로 브라우저 접속을 확인한 뒤 다른 앱을 테스트하고, 마지막으로 TUN, LAN 공유, 외부 패널을 고려하세요. 테스트할 때는 웹페이지가 열리는지만 보지 말고 연결 목록의 도메인, 일치한 규칙, 최종 적용된 정책이 예상과 맞는지도 확인해야 합니다. 연결은 성공했어도 정책이 잘못됐다면 조정이 필요합니다. 사용자 설정은 별도 파일에 저장하고 YAML을 수정할 때는 공백으로 들여쓰기하세요. 같은 이름의 최상위 항목을 중복 정의하지 않도록 주의하고, 클라이언트에 적용한 뒤 로그에서 설정이 정상적으로 로드됐는지 확인한 다음 다음 단계로 넘어가세요.
문서로 이동하고 문제를 해결하는 순서
처음 사용한다면 구독 가져오기 안내부터 시작하세요. 가져오기, 설정 선택, 규칙 모드 전환, 프록시 활성화 순서로 연결을 완료하면 됩니다. 이미 연결되지만 웹사이트별 경로를 조정하려면 고급 설정에서 정책 그룹, 규칙 세트, 오버라이드를 확인하세요. 익숙하지 않은 용어는 용어집에서 먼저 찾아보세요. 설정 항목의 이름만 보고 기능을 추측하지 않는 편이 좋습니다. 설정 흐름을 명확히 유지하면 여기저기서 가져온 조각을 복사해 서로 덮어쓰는 일을 줄일 수 있습니다.
켠 뒤 인터넷에 전혀 접속할 수 없다면 다른 프록시 도구를 종료하고 일반 네트워크가 작동하는지 확인한 다음 구독 유효성, 현재 선택된 설정, 정책 그룹, DNS 로그 순으로 점검하세요. 일부 웹사이트만 문제가 있다면 곧바로 재설치하지 말고 해당 연결의 규칙과 대상을 먼저 살펴보세요. 클라이언트를 종료한 뒤에도 접속되지 않으면 시스템 프록시 설정이 남아 있는지, 기존 네트워크 설정이 복구됐는지 확인하세요. 증상별 답변은 도움말 센터에서 확인할 수 있습니다. 이 페이지에서는 점검 순서를 안내하며 모든 문제를 하나의 스위치 설정으로 뭉뚱그리지 않습니다.
설정 가이드 및 문제 해결 문서
구독 형식, 인증서 오류, 모바일 백그라운드 실행은 서로 다른 설정 계층과 관련이 있습니다. 증상에 맞는 문서를 읽고 문제가 어느 계층에서 발생하는지 파악한 다음 해당 옵션을 변경하세요. 최근 게시된 문서 3편을 소개합니다.
프록시 사용 중 Android 배터리가 빨리 닳는다면: 백그라운드 실행 유지, 배터리 최적화 예외, Clash 설정
백그라운드 상시 실행, 잦은 상태 확인, DNS 조회부터 살펴보고 정상적인 네트워크 사용량과 시스템이 서비스를 반복 종료해 발생하는 추가 소모를 구분합니다. 기기의 배터리 관리 설정을 확인한 뒤 클라이언트 옵션을 조정하세요. 모든 문제를 배터리 절약 기능 해제로 해결하려고 하지 마세요.
문서 읽기 →구독 형식 이해하기: Clash YAML, Base64 노드 링크, 구독 변환의 차이와 사용법
전체 설정, 인코딩된 노드 목록, 단일 프로토콜 링크는 서로 같은 형식이 아닙니다. 각 데이터의 구조, 클라이언트에서 가져올 수 있는 형식, 변환 서비스가 접근하는 정보를 설명합니다. 가져오기에 실패하면 먼저 형식을 확인한 뒤 필드와 설정 병합을 살펴보세요.
문서 읽기 →프록시 사용 후 웹페이지에 인증서 오류가 표시될 때: HTTPS 인증서 문제의 주요 원인과 단계별 해결 방법
시스템 시간, 이름 확인 경로, 패킷 캡처 인증서, 문제가 있는 노드를 차례로 확인하세요. Fake-IP가 웹사이트 인증서를 발급하는 것은 아니며 인증서 경고를 무시해서도 안 됩니다. 브라우저 오류 문구와 인증서 주체를 기록한 다음 네트워크 경로에서 무엇이 달라졌는지 찾아보세요.
문서 읽기 →