오픈소스 생태계 · 강의식 튜토리얼 사이트
Clash 클라이언트 다운로드와설정 강의
5대 플랫폼 설치 파일 링크를 한 페이지에 모아두었고, 구독 연동, 규칙 분기, 정책 그룹을 강의처럼 한 줄씩 풀어서 설명합니다. 핵심 설정 항목마다 빨간 펜 주석이 붙어 있어, 전체 문서를 다 읽지 않아도 따라 하기만 하면 됩니다.
코어 계열 mihomo / Clash Meta/GPL-3.0 오픈소스/Windows · macOS · Android · iOS · Linux
mixed-port: 7890 mode: rule log-level: info proxy-groups: - name: 수동 전환 type: select proxies: [자동 속도 테스트, HK-01, JP-02] - name: 자동 속도 테스트 type: url-test interval: 300 rules: - DOMAIN-SUFFIX,youtube.com,수동 전환 - GEOIP,CN,DIRECT - MATCH,수동 전환
설정 파일의 핵심 다섯 줄
실제로 돌아가는 설정 파일은 수백 줄이지만, 체감 성능을 좌우하는 건 결국 이 몇 줄입니다. 왼쪽은 원본 설정, 오른쪽은 여백 주석입니다. 빨간 글씨를 먼저 보고 설명을 읽으세요.
mode: rule
Clash에는 rule, global, direct 세 가지 실행 모드가 있습니다. global은 모든 트래픽을 같은 출구로 보내고, direct는 전부 직접 연결합니다. 실제로 써야 하는 건 rule 모드입니다. 트래픽이 들어오면 rules 목록을 위에서부터 하나씩 대조해서, 가장 먼저 걸린 규칙이 프록시로 갈지 직접 연결할지를 결정하고 이후 규칙은 보지 않습니다. 한국 국내 사이트는 직접 연결하고 해외 사이트는 프록시를 타는 설정이 동시에 성립하는 것도 바로 이 한 줄 덕분입니다. 튜토리얼에서 클라이언트의 이 모드 전환 스위치가 정확히 어디 있는지 안내합니다.
proxy-groups: - name: 자동 속도 테스트 type: url-test interval: 300
url-test 타입 정책 그룹은 interval초마다 그룹 내 노드에 탐지 요청을 보내 지연이 가장 낮은 노드로 자동 전환합니다. select 타입은 전적으로 수동 지정입니다. 흔한 조합은 가장 바깥에 select 그룹을 두어 직접 조작할 여지를 남기고, 그 안에 url-test 그룹을 넣어 일상적인 자동 최적 선택을 맡기는 방식입니다. 노드가 불안정할 때는 클라이언트 패널에서 select 그룹을 클릭해 출구를 바꾸면 되고, 설정 파일을 열어 한 글자도 고칠 필요가 없습니다.
rules: - DOMAIN-SUFFIX,youtube.com,수동 전환 - GEOIP,CN,DIRECT - MATCH,수동 전환
DOMAIN-SUFFIX는 도메인 접미사로 매칭하고, GEOIP는 목적지 IP의 소속 국가로 매칭하며, MATCH는 항상 걸리는 마지막 규칙입니다. 규칙을 작성하는 순서가 곧 판정 우선순위입니다. 정확한 도메인 규칙은 앞에 두고, GEOIP,CN,DIRECT로 한국 국내 트래픽을 지켜준 뒤, 마지막에 MATCH가 빠진 요청을 모두 받아줍니다. 분기 결과가 예상과 다르면 먼저 클라이언트의 연결 패널에서 해당 요청이 실제로 어떤 규칙에 걸렸는지 확인한 뒤 수정할 곳을 정하세요. 규칙표를 무작정 고치면 오히려 더 헝클어질 뿐입니다.
mixed-port: 7890
mixed-port는 같은 포트에서 HTTP와 SOCKS5 두 프록시 프로토콜을 동시에 받아들입니다. 브라우저, 시스템 프록시, 커맨드라인 도구를 모두 7890 하나로 통일할 수 있어 port와 socks-port 두 개를 따로 기억할 필요가 없습니다. 포트를 바꾸기 전에는 해당 포트가 다른 프로그램에 점유되지 않았는지 확인하세요. Windows에서는 netstat -ano, macOS와 Linux에서는 lsof -i로 확인합니다. 포트 충돌은 코어 실행 실패의 흔한 원인 중 하나이므로, 오류에 bind라는 단어가 보이면 이 부분을 먼저 확인하세요.
proxy-providers: main-sub: type: http interval: 86400
구독은 한 번 복사해 넣으면 끝나는 고정 노드 목록이 아니라, 주기적으로 가져오는 원격 리소스입니다. interval: 86400은 24시간마다 자동으로 갱신한다는 뜻으로, 서비스 제공처가 노드를 바꾸거나 도메인을 변경해도 클라이언트가 정해진 시간에 자동으로 동기화합니다. 노드 목록이 갑자기 비었다면 먼저 구독 링크가 만료되었거나 초기화되었는지 의심해보세요. 서비스 제공처의 사용자 페이지에서 새 링크를 복사해 다시 연동하면 보통 1분 안에 해결되며, 클라이언트를 재설치하거나 설정을 다시 쓸 필요는 없습니다.
3단계로 끝내는 첫 연결
튜토리얼 페이지의 요약 미리보기입니다. 목표는 하나, 첫 분기 테스트를 성공시키는 것입니다. 세부 내용과 변형 케이스는 전체 튜토리얼에서 다룹니다.
-
클라이언트 다운로드 및 설치
다운로드 페이지에서 플랫폼별로 파일을 선택하세요. Windows는 x64 설치 파일, macOS는 Intel과 Apple Silicon 두 종류로 나뉘며, 안드로이드는 주력 기종이라면 arm64를 선택합니다. 처음 실행할 때 안내에 따라 권한 승인을 완료하세요. Windows의 서비스 모드, macOS의 시스템 확장 허용 여부가 이후 TUN 모드가 정상 작동하는지를 결정하니 건너뛰지 마세요.
-
구독 링크 연동
서비스 제공처의 사용자 페이지에서 Clash 형식의 구독 URL을 복사한 뒤, 클라이언트의 「설정 / Profiles」 페이지를 열고 붙여넣어 다운로드하세요. 목록에 설정 파일이 나타나고 노드 수가 0이 아니면 연동 성공입니다. 노드가 비어 있다면 대부분 범용 Base64 링크를 복사한 경우이니, 다시 페이지로 돌아가 Clash 전용 링크로 바꿔주세요.
-
모드 선택 및 분기 확인
실행 모드를 rule로 설정하고, 정책 그룹에서 지연이 정상인 노드를 하나 고른 뒤, 한국 국내 사이트와 해외 사이트를 각각 접속해보세요. 둘 다 정상적으로 열리고 연결 패널에서 걸린 규칙이 예상과 맞다면 설정이 완료된 것입니다. 이후 일상적으로 할 일은 「노드 변경」 하나뿐입니다.
플랫폼별다운로드 바로가기
먼저 운영체제를 고르고, 다운로드 페이지에서 클라이언트를 선택하세요. 각 플랫폼에서 추천하는 클라이언트와 설치 파일 종류는 다운로드 페이지에 순서대로 정리되어 있고 뱃지로 표시되어 있습니다.
오픈소스 코어,출처가 명확합니다
다운로드하기 전에 무엇을 설치하는지부터 알아두세요. 이번 섹션에서는 코어의 유래, 클라이언트와 코어의 관계, 그리고 본 사이트의 운영 원칙을 다룹니다.
Clash는 2017년 오픈소스 프로젝트로 처음 등장했으며, 핵심은 Go 언어로 작성된 규칙 기반 프록시 코어입니다. 원작자의 저장소가 2023년 보관 처리된 이후 커뮤니티 분기인 Clash Meta가 유지보수를 이어받았고, 이후 mihomo로 이름을 바꿔 지금까지 활발히 릴리스되고 있습니다. 현재 다운로드하는 각 클라이언트 내부에서 실행되는 것도 이렇게 계승된 코어입니다.
이 코어를 중심으로 커뮤니티에서 다양한 그래픽 클라이언트가 만들어졌습니다. Windows와 macOS용 Clash Verge Rev, 크로스플랫폼 FlClash, 안드로이드용 Clash Meta for Android 등이 있습니다. 이들은 구독 관리, 노드 패널, 스위치 화면을 담당하고, 프로토콜 해석과 규칙 매칭은 모두 코어가 처리합니다. 즉 같은 config.yaml이 여러 클라이언트에서 대체로 호환되므로, 설정을 한 번 배우면 어디서든 쓸 수 있습니다.
코어와 클라이언트는 각각 독립적으로 릴리스됩니다. 코어 업데이트는 새로운 프로토콜과 필드 지원을 가져오고, 클라이언트 업데이트는 화면과 패키징을 따라갑니다. 클라이언트가 특정 필드를 인식하지 못한다면 대개 내장된 코어 버전이 오래된 경우이니, 클라이언트를 업그레이드하거나 설정에서 코어 채널을 전환하면 됩니다. 설정을 처음부터 다시 쓸 필요는 없습니다.
본 사이트는 노드나 구독 서비스를 제공하지 않으며, 두 가지 일만 합니다. 각 플랫폼 클라이언트의 설치 파일 링크를 한 페이지에 모으는 것, 그리고 설정 파일에서 체감 성능에 실제로 영향을 주는 필드를 명확히 설명하는 것입니다. 튜토리얼과 프로토콜 참고 자료는 코어 필드 변화에 맞춰 계속 갱신되며, 확실하지 않은 부분은 항상 클라이언트 내 실제 화면을 기준으로 삼습니다.
자주 묻는 질문핵심 4가지
초보자가 가장 많이 막히는 네 가지 지점에 대해 먼저 한 줄로 답을 드립니다. 펼치면 간단한 설명이 나오고, 더 자세한 진단 절차는 문제 해결 페이지에 있습니다.
구독 연동은 성공했는데 노드 목록이 비어 있나요?
대부분 링크 형식이 맞지 않는 경우입니다. 범용 Base64 구독은 변환을 거쳐야 Clash가 인식할 수 있으니, 서비스 제공처 페이지로 돌아가 「Clash 전용」 링크를 찾아 다시 연동하세요. 그래도 비어 있다면 링크가 만료되었거나 초기화되었는지 확인하세요. 전체 진단 과정은 문제 해결의 설치·설정 분류에 정리되어 있습니다.
모든 노드가 타임아웃되는데, 노드가 고장 난 건가요?
집단 타임아웃은 대부분 노드 문제가 아닙니다. 순서대로 확인하세요: 구독 만료 여부, 로컬 시스템 시간이 크게 틀리지 않았는지, 포트 점유 여부, 프로토콜 종류와 코어 버전의 호환 여부. 항목별 확인 방법은 이 진단 글에 자세히 정리되어 있습니다.
시스템 프록시를 켰는데 터미널 명령이 여전히 프록시를 타지 않나요?
정상적인 현상입니다. 브라우저는 시스템 프록시 설정을 읽지만, 터미널은 http_proxy / https_proxy 환경 변수만 인식하며 두 경로는 서로 무관합니다. 셸에 환경 변수를 설정하거나, TUN 모드를 켜서 전체 트래픽을 한 번에 처리하세요. TUN과 시스템 프록시의 메커니즘 차이는 개념 사전에 비교 항목이 있습니다.
select와 url-test 정책 그룹, 어느 걸 써야 하나요?
서로 충돌하지 않으며 보통 함께 사용합니다. url-test는 지연을 자동으로 감시해 최적 노드를 고르고, select는 수동으로 최종 결정할 수 있도록 남겨둡니다. 구독에 기본 포함된 설정은 대체로 이미 이렇게 중첩되어 있으니, 패널에서 select 그룹의 출구만 바꾸면 됩니다. 필드 의미는 개념 사전의 설정 파일 필드 분류에서 확인할 수 있습니다.
최신강의 보충 자료
진단 기록과 심층 분석을 날짜 역순으로 정리했습니다. 각 글은 하나의 구체적인 문제를 깊이 파고들며, 두루뭉술한 개괄은 다루지 않습니다.