데스크톱 브라우저와 일반 앱에서 사용하기 좋습니다. 먼저 Clash Plus를 확인하고, 인터페이스나 설정 관리 방식을 비교하고 싶다면 Clash Verge Rev, FlClash 등도 살펴보세요. 시스템 프록시와 서비스 모드는 별도 설정입니다. 처음 연결할 때는 시스템 프록시부터 확인한 다음 필요에 따라 TUN을 활성화하세요.
다운로드하기Clash중문사이트 · mihomo 사용 설명서
Clash 클라이언트다운로드 및 사용 안내
플랫폼에 맞는 클라이언트를 선택하고 구독 가져오기부터 규칙 기반 라우팅까지 살펴보세요. mihomo 설정과 연결 확인 방법도 안내합니다.
설정 안내
Clash 설정 구조
규칙부터 네트워크 진입점까지
클라이언트는 설정을 가져오고 편집해 보여 주며, 코어는 설정을 해석하고 연결을 처리합니다. 진입 포트, 프록시 그룹, 매칭 규칙의 역할을 먼저 구분한 다음 네트워크 모드를 조정하면 문제 발생 시 원인을 해당 단계에서 찾을 수 있습니다. 아래 예시는 각 필드의 용도를 설명하는 조각으로, 그대로 연결할 수 있는 완성된 구독 설정이 아닙니다. 노드 정보는 기존 설정에서 제공해야 합니다.
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
규칙은 위에서 아래로 확인하며, 처음 일치한 항목이 연결 정책을 결정합니다. 구체적인 도메인 규칙을 앞에 두고, 그다음 지역 규칙으로 직접 연결이 필요한 트래픽을 처리한 뒤, 마지막 MATCH로 나머지 연결을 지정합니다. 예시의 PROXY는 미리 정의한 프록시 그룹이어야 하며 DIRECT는 기본 직접 연결 정책입니다. 글로벌 모드로 출구만 바꾸는 것보다 규칙 모드에서 목적지별로 트래픽을 나눌 수 있습니다. 수정 후 설정을 다시 불러오고 연결 화면에서 적용된 규칙을 확인하세요. 구독을 업데이트하면 직접 편집한 내용이 덮어써질 수 있으므로, 규칙을 계속 유지하려면 클라이언트가 지원하는 오버라이드 위치에 저장하세요.
proxy-groups:
- name: PROXY
type: select
proxies:
- AUTO
- DIRECT
- name: AUTO
type: url-test
use:
- subscription
url: https://www.gstatic.com/generate_204
interval: 300
프록시 그룹을 사용하면 노드 묶음과 규칙의 대상 그룹을 따로 관리할 수 있습니다. select는 수동 선택에, url-test는 지정한 테스트 주소의 결과에 따라 후보를 자동 선택하는 데 사용합니다. 자동 그룹이라고 해서 모든 사이트에서 가장 빠른 노드를 고르는 것은 아닙니다. 예시는 subscription을 통해 같은 이름의 프록시 제공자를 참조하므로 사용 전에 해당 제공자 설정을 추가해야 합니다. 평소에는 PROXY가 AUTO를 가리키게 하고, 특정 작업에서는 필요한 노드를 직접 선택할 수 있습니다. 규칙을 하나씩 수정하는 대신 프록시 그룹을 바꾸면 매칭 방식은 그대로 두고 출구만 변경됩니다. 그룹 이름은 규칙에서 참조하는 이름과 일치해야 하며, 그룹끼리 서로 참조하는 순환 구조도 피해야 합니다.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
TUN은 가상 네트워크 인터페이스로 트래픽을 받아 시스템 프록시를 사용하지 않는 앱을 처리하는 데 적합합니다. 보통 관리자 권한이나 클라이언트의 서비스 모드가 필요합니다. 시스템 프록시와 달리 라우팅, 인터페이스, DNS까지 관여하므로 활성화하기 전에 일반 프록시 연결이 정상인지 확인하세요. 예시의 자동 라우팅은 트래픽 진입 경로를 바꾸며, 지원 여부는 운영체제와 클라이언트에 따라 다릅니다. 다른 VPN을 함께 사용한다면 먼저 라우팅 충돌을 확인하세요. 종료할 때는 클라이언트의 끄기 기능을 사용해 네트워크를 복구하고 프로세스만 강제 종료하지 마세요. 로컬 네트워크 접속에 문제가 생기면 라우팅과 방화벽도 점검해야 합니다.
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query
DNS 설정은 도메인 이름을 해석하는 방식을 정하며 도메인 기반 라우팅에도 영향을 줍니다. fake-ip 모드에서는 먼저 매핑 주소를 반환한 뒤 코어가 대상 도메인과 함께 연결을 처리합니다. 이 주소는 원격 사이트의 실제 주소가 아닙니다. 예시는 기본 필드만 보여 주므로 실제 네트워크에서 접근 가능한 업스트림 DNS를 선택해야 합니다. DNS 리슨을 켰다고 해서 시스템이 자동으로 해당 DNS를 사용하는 것은 아니므로 클라이언트의 DNS 연결 방식도 확인하세요. 일부 앱에 문제가 생기면 모든 DNS 기능을 끄기보다 필요에 따라 fake-ip-filter를 설정할 수 있습니다. 문제를 점검할 때는 먼저 DNS 응답을 확인한 뒤 규칙과 출구를 살펴보세요.
proxy-providers:
subscription:
type: file
path: ./providers/subscription.yaml
proxy-groups:
- name: PROXY
type: select
use:
- subscription
구독은 규칙과 프록시 그룹을 포함한 전체 설정일 수도 있고 노드 목록만 담은 데이터일 수도 있어 가져오기 방법을 구분해야 합니다. GUI 클라이언트에서는 보통 설정 화면에 전체 구독 주소를 입력합니다. proxy-providers는 노드 공급원을 별도로 관리하는 방식입니다. 예시는 로컬 제공자 파일을 읽으며, 파일에는 형식에 맞는 노드 데이터가 있어야 합니다. 먼저 서비스 제공자가 안내한 형식을 확인한 뒤 알맞은 가져오기 메뉴를 선택하세요. 업데이트에 실패하면 주소가 유효한지, 응답에 설정 내용이 포함됐는지, 로컬 네트워크에서 접근 가능한지 확인합니다. 구독 주소에는 계정 정보가 들어 있을 수 있으니 스크린샷이나 로그를 공유하기 전에 전체 링크를 가리세요.
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info
플랫폼이 달라도 비슷한 YAML 설정을 사용할 수 있지만 시스템 프록시, 백그라운드 실행, 권한 설정 방법은 다릅니다. mixed-port는 HTTP와 SOCKS가 함께 사용하는 리슨 포트이며 시스템 설정에 자동 반영되는지는 클라이언트에 따라 다릅니다. 예시는 로컬 기기에서만 리슨하므로 한 기기에서 먼저 연결을 확인하기에 적합합니다. 설정을 옮길 때는 포트 사용 여부, 파일 경로, 코어가 지원하는 필드를 확인하세요. 데스크톱의 서비스 설정을 휴대폰에 그대로 적용해서는 안 됩니다. 클라이언트를 고를 때는 먼저 운영체제 아키텍처와 프로젝트 유지 관리 여부를 확인한 뒤 인터페이스 기능을 비교하세요. 클라이언트와 설치 파일은 다운로드 센터에서 확인할 수 있습니다.
다운로드
운영체제에 맞는 Clash 클라이언트
기기 운영체제와 CPU 아키텍처를 먼저 확인하고, 현재 유지 관리 중인 GUI 클라이언트를 선택하세요. 지원 플랫폼에서는 Clash Plus를 우선 살펴볼 수 있으며, Linux 데스크톱에서는 Clash Verge Rev와 FlClash를 비교해 보세요. 다운로드 센터에는 다른 선택지와 보관된 클라이언트도 있어 기존 설정을 옮길 때 참고할 수 있습니다. 설치 파일은 프로그램을 제공할 뿐이며 구독과 사용 가능한 노드는 별도로 준비해야 합니다. 설치를 마쳐도 프록시 회선이 자동으로 제공되는 것은 아닙니다.
다운로드 전에 시스템 정보에서 Apple Silicon인지 Intel 프로세서인지 확인하세요. 설치 후에는 클라이언트 안내에 따라 네트워크 관련 권한을 허용한 뒤 설정을 가져옵니다. 브라우저에서는 연결되는데 터미널에서 적용되지 않는다면 구독을 계속 바꾸기보다 터미널 프로그램이 시스템 프록시를 사용하는지 확인하세요.
다운로드하기모바일에서는 Clash Plus, Clash Meta for Android 등의 클라이언트 중에서 선택하세요. 설정을 가져온 뒤 현재 설정과 프록시 그룹을 확인하고 VPN 연결을 허용합니다. 장시간 백그라운드에서 사용하려면 배터리 최적화 설정도 확인하세요. 앱별로 트래픽을 나눌 때는 프록시로 보낼 앱의 범위와 설정에 지정된 대상 규칙을 구분해야 합니다.
다운로드하기다운로드 센터에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 제품 정보는 공식 사이트 clashplus.io에서 확인하세요. 설치 후 앱에서 지원하는 방법으로 구독을 가져오고 시스템 안내에 따라 VPN 설정을 추가합니다. 클라이언트마다 지원하는 설정 필드가 다를 수 있으므로 설정을 옮길 때는 실제 가져오기 결과를 기준으로 확인하세요.
다운로드하기데스크톱에서는 Clash Verge Rev 또는 FlClash를 선택할 수 있고, 서버와 라우터에는 mihomo를 직접 배포하는 방법이 적합합니다. 패키지를 받기 전에 배포판, 패키지 관리자, CPU 아키텍처를 확인하세요. 명령줄로 배포하면 설정 디렉터리, 리슨 포트, 실행 사용자와 서비스 수명 주기를 직접 관리해야 합니다.
다운로드하기Clash for Windows에서 옮길 때는 먼저 기존 Profile과 사용자 지정 규칙을 백업한 뒤 새 클라이언트에서 가져오기 결과를 확인하세요. 이전 설정의 스크립트, 경로, 실험적 필드는 그대로 사용할 수 없을 수 있습니다. 시스템 프록시나 가상 네트워크 인터페이스를 두 클라이언트에서 동시에 켜지 마세요. 충돌을 노드 문제로 오해할 수 있습니다.
클라이언트 전체 보기 → Clash for Windows 대체 클라이언트 보기 →첫 연결
구독 가져오기, 노드 선택, 연결 확인
처음 사용할 때는 한 흐름대로 진행하면 됩니다. 클라이언트가 올바른 설정을 읽게 한 뒤 트래픽을 클라이언트로 보내고 실제 출구를 확인하세요. 변수를 한꺼번에 많이 바꾸지 않도록 기본 포트와 규칙은 우선 그대로 두는 편이 좋습니다. 아래에는 작업 순서를 간단히 정리했습니다. 버튼 위치, 시스템 프록시 설정, 자주 나오는 안내의 해결 방법은 전체 튜토리얼에서 확인할 수 있습니다.
-
구독을 가져와 현재 설정으로 선택
클라이언트의 설정 또는 구독 화면에 기존 주소를 붙여 넣고 다운로드와 분석이 끝날 때까지 기다린 다음 해당 설정을 현재 사용 항목으로 지정하세요. 목록에 설정 이름이 표시되면 노드나 프록시 그룹이 로드됐는지 확인합니다. 가져온 결과가 비어 있다면 먼저 구독 형식과 응답 내용을 확인하세요. 일반 웹페이지 주소, 계정 관리 페이지, 구독 주소는 서로 다른 항목입니다.
설정 파일은 보통 Profile이라고 부르며 원격 구독이나 로컬 YAML 파일에서 가져올 수 있습니다. 원격 업데이트는 해당 데이터를 새로고침할 뿐 사용자 지정 변경 사항이 반드시 유지되는 것은 아닙니다. 처음 가져온 뒤 설정 이름과 출처를 기록해 두면 여러 설정을 바꿔 사용할 때 현재 적용된 항목을 쉽게 확인할 수 있습니다.
구독 가져오기 단계 보기 → -
프록시 그룹과 규칙 모드 선택
프록시 화면에서 규칙이 참조하는 기본 프록시 그룹에 사용 가능한 노드를 지정하거나 미리 설정한 자동 그룹을 선택하세요. 지연 시간 테스트는 테스트 주소에 연결했을 때의 상태를 보여 주며 다운로드 속도나 모든 사이트의 체감 속도를 뜻하지는 않습니다. 먼저 규칙 모드를 사용해 설정이 목적지별로 직접 연결과 프록시 연결을 나누게 한 뒤 시스템 프록시나 모바일 연결 스위치를 켜세요.
글로벌 모드는 코어에 들어온 트래픽의 출구를 선택하는 방식만 바꾸며 모든 앱의 트래픽을 자동으로 가져오지는 않습니다. 시스템 프록시를 사용하지 않는 프로그램이라면 글로벌 모드로 전환해도 보통 진입 문제는 해결되지 않습니다. 먼저 프로그램 자체의 프록시 설정을 확인하고, 꼭 필요한 경우에만 튜토리얼에 따라 TUN을 설정하세요. 프록시 모드와 트래픽 연결 방식을 혼동하지 마세요.
시스템 프록시 설정 보기 → -
연결 기록으로 실제 경로 확인
프록시를 사용해야 하는 사이트를 열고 클라이언트의 연결 화면에 해당 도메인, 적용된 규칙, 최종 정책이 표시되는지 확인하세요. 신뢰할 수 있는 출구 IP 조회 페이지에서도 해당 요청의 출구를 확인하면 스위치 색상만 보고 판단하는 일을 줄일 수 있습니다. 직접 연결 대상 사이트에 로컬 출구가 표시되는 것은 규칙에 따른 정상 동작일 수 있으므로 설정 전체가 작동하지 않는다고 단정하지 마세요.
연결 기록이 없다면 먼저 시스템 프록시, 앱 자체 설정, VPN 권한을 확인하세요. 기록은 있지만 연결에 실패한다면 노드 상태와 DNS를 점검합니다. 지원을 요청할 때는 오류가 발생한 시간과 관련 로그를 남기되 구독 주소와 계정 정보는 가리세요. 클라이언트를 계속 재설치하기보다 진입, DNS 해석, 규칙, 출구 순서로 확인하면 원인을 찾기 쉽습니다.
연결 확인 방법 보기 →
오픈소스 생태계
Clash, mihomo, 클라이언트의 관계
Clash는 이 형식의 설정과 호환되는 프록시 도구를 통칭하는 말로도 자주 쓰이지만, 코어와 GUI, 구독 서비스의 역할은 서로 다릅니다. 세 요소의 관계를 이해하면 기능을 어느 구성 요소가 제공하는지 정확히 파악할 수 있고 클라이언트, 노드, 네트워크 회선 업데이트를 같은 문제로 혼동하지 않을 수 있습니다.
프로젝트의 변화와 유지 관리 범위
원래 Clash 프로젝트의 유지 관리가 중단된 뒤 생태계에는 여러 코어를 기반으로 한 클라이언트가 등장했습니다. mihomo는 Clash Meta의 기술 흐름을 이어받아 프록시 프로토콜, 규칙 매칭, DNS, TUN 등의 기능을 제공합니다. 이름이 비슷해도 같은 프로그램이라는 뜻은 아닙니다. 다운로드할 때는 클라이언트 이름과 코어 종류, 프로젝트 유지 관리 상태를 함께 확인하세요. 오래된 온라인 튜토리얼은 메뉴와 필드가 바뀌었을 수 있으므로 현재 클라이언트 화면과 대조해 읽어야 합니다.
코어는 연결을 처리하고 GUI는 조작을 관리
mihomo는 명령줄 프로그램으로 실행할 수 있습니다. GUI 클라이언트는 설정 전환, 프록시 그룹 선택, 로그 확인, 시스템 설정 등을 조작하기 쉬운 화면으로 제공합니다. 같은 코어를 사용해도 GUI 기능까지 모두 같은 것은 아닙니다. 구독 오버라이드, 트레이 메뉴, 서비스 설치 방식은 클라이언트가 별도로 구현할 수 있습니다. 설정 문법 문제는 코어 문서를 확인하고 버튼, 권한, 자동 시작 문제는 해당 클라이언트 안내를 참고하세요.
소스와 문서에서 기능 확인
mihomo의 소스 코드와 라이선스, 공개 이슈 논의는 MetaCubeX 조직의 프로젝트 저장소에서 확인할 수 있으며 코어는 GPL-3.0 라이선스를 사용합니다. 저장소를 살펴보면 설정 필드의 지원 여부와 알려진 문제인지, 수정 사항이 릴리스 절차에 들어갔는지 확인하는 데 도움이 됩니다. 아래 명령은 소스 코드만 다운로드하며 클라이언트를 설치하거나 프록시를 자동 설정하지 않습니다. 직접 빌드하고 배포하려면 저장소의 빌드 안내를 읽고 필요한 개발 환경을 준비하세요.
프로그램, 설정, 데이터 업데이트를 따로 관리
클라이언트, 코어, 구독, 규칙 데이터 업데이트는 서로 다른 작업입니다. 프로그램을 바꿔도 노드가 갱신되는 것은 아니며 구독을 새로고침해도 코어가 바뀌지는 않습니다. 업그레이드 전에 현재 작동하는 설정과 오버라이드 내용을 저장하고, 업그레이드 후에는 기본 연결부터 확인한 다음 확장 설정을 하나씩 복원하세요. 호환성 문제가 생기면 재현 조건과 오류 필드를 기록하고 최소 설정으로 먼저 확인하세요. 인증 정보가 포함된 구독 전체를 이슈 게시판에 공개하지 마세요.
Clash중문사이트는 다운로드 경로와 한국어 사용 안내를 제공하며 노드 서비스는 제공하지 않습니다. 회선 상태, 트래픽 용량, 구독 권한은 해당 서비스 제공업체가 결정합니다. 사용 전에 거주 지역의 법률과 네트워크 이용 규정을 확인하세요. 회사나 학교 기기에서 프록시와 라우팅을 변경할 때는 기기 관리 정책도 따라야 합니다. 문서의 예시는 설정 구조를 설명하기 위한 것으로 바로 사용할 수 있는 회선을 포함하지 않습니다.
최신 글
구독 가져오기 및 배포 가이드
기본 연결을 마친 다음 실제 문제에 맞춰 필요한 내용을 살펴보세요. 구독 형식에 따라 가져오기 메뉴가 달라지고 배포 방식에 따라 권한과 실행 위치가 달라집니다. 연결 확인으로 각 변경이 예상대로 적용됐는지 점검할 수 있습니다. 아래 글은 주제별 작업 방법을 보충하며 노드, 데이터 용량, 계정 상태에 대한 서비스 제공업체의 안내를 대신하지 않습니다.
Clash 구독 링크 가져오기: URL, YAML, Base64 형식 차이
클라이언트에 구독 주소를 붙여 넣고 자동 업데이트를 설정하는 방법을 소개합니다. 전체 YAML 설정과 Base64 노드 목록의 차이, 형식이 호환되지 않을 때 해결하는 방법도 다룹니다.
구독 가져오기 안내 읽기 →Linux에 Clash 배포하기: 데스크톱 클라이언트와 mihomo 명령줄 방식
Linux 데스크톱 GUI 클라이언트 설치부터 GUI가 없는 서버에서 mihomo 바이너리와 systemd를 사용한 상시 실행, 설정 디렉터리 및 포트 구성까지 안내합니다.
Linux 배포 방법 읽기 →Clash 첫 연결 확인 체크리스트: 속도 테스트와 노드 선택부터 프록시 적용 확인까지
순서대로 설정을 가져오고 노드를 선택한 뒤 지연 시간을 테스트하고 시스템 프록시를 켜세요. 연결 로그와 출구 IP로 트래픽이 실제 프록시를 통과하는지도 확인합니다.
첫 연결 체크리스트 읽기 →