Clash 생태계 · 클라이언트 및 설정 안내

Clash 클라이언트다운로드 및 설정

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기부터 규칙 기반 라우팅까지 확인하세요. mihomo 커널과 연결 설정도 살펴볼 수 있습니다.

오픈 소스 커널 한국어 문서 멀티 플랫폼 설정
CONFIGURATION / ROUTING

구독, 규칙 및 시스템 연결

클라이언트 UI는 설정을 관리하고 커널은 설정을 실행합니다. 먼저 설정의 출처를 확인하고, 연결이 로컬 프록시 포트로 들어오는지 살펴본 다음 규칙에 따라 출구를 정하세요. 각 단계마다 문제를 확인할 위치가 다릅니다.

CONFIG.YAML

설정 기능 한눈에 보기

각 항목에서 주요 조작법과 설정 예시를 확인할 수 있습니다. 클릭하거나 키보드로 조작하거나 포커스가 이동하면 자동 전환이 멈춥니다.

구독 가져오기 및 설정 활성화

구독 링크에는 전체 설정이 포함될 수도 있고 노드 목록만 들어 있을 수도 있습니다. 먼저 클라이언트의 구독 또는 설정 화면에서 링크를 추가하세요. 업데이트가 완료되면 해당 설정을 선택하고 정책 그룹이 표시되는지 확인합니다. 노드만 포함된 데이터는 보통 프록시 그룹에서 참조해야 하며, 규칙과 정책 그룹은 기본 설정에서 제공해야 합니다. 클라이언트마다 로컬 설정을 덮어쓰는 방식이 다르므로 다운로드한 파일을 직접 수정하면 다음 업데이트 때 변경 내용이 사라질 수 있습니다. 구독 주소에 접근 정보가 포함될 수 있으니 캡처하거나 백업·공유하기 전에 민감한 내용을 삭제하세요.

정책 그룹 참조 예시
proxy-groups: - name: PROXY type: select proxies: [DIRECT]rules: - MATCH,PROXY

이 예시는 구조만 보여 줍니다. 프록시 출구를 선택하려면 PROXY 그룹에 실제 노드를 추가해야 합니다.

구독 가져오기 단계 보기 →
PACKAGES / SELECT SYSTEM

Clash 전체 플랫폼 다운로드

설치 파일은 먼저 운영체제에 맞춰야 하고, 그다음 CPU 아키텍처를 확인해야 합니다. 이름이 비슷한 클라이언트라면 프로젝트가 꾸준히 관리되는지, 현재 구독 프로토콜을 지원하는지도 확인하세요. 설치가 끝나도 프로그램을 실행할 수 있을 뿐, 실제로 연결하려면 사용 가능한 설정과 정책 선택, 시스템 연결 권한이 필요합니다.

Windows

처음 설치한다면 Clash Plus를 먼저 살펴보고, UI 취향에 따라 Clash Verge Rev, FlClash, Clash Nyanpasu를 비교해 보세요. 다운로드 전에 시스템 정보에서 CPU 아키텍처를 확인하세요. 이전 클라이언트는 마이그레이션이나 보관 목적의 참고 자료로 활용할 수 있습니다.

실행한 뒤 가져온 설정을 활성화하고 혼합 포트가 대기 중인지 확인한 다음 시스템 프록시를 켜세요. 일반 브라우저는 연결되는데 특정 앱만 작동하지 않는다면 해당 앱이 시스템 프록시를 사용하는지 확인해야 합니다. 스토어 앱은 로컬 루프백 접근 제한이 원인일 수도 있으므로 노드를 계속 바꾸는 것만으로 원인을 판단하지 마세요.

다운로드 Windows 클라이언트

macOS

Apple Silicon과 Intel 기기는 각각 맞는 아키텍처를 선택해야 합니다. GUI 클라이언트는 Clash Plus, Clash Verge Rev, FlClash를 비교해 볼 수 있습니다. ClashX Meta 아카이브는 기존 환경을 옮길 때 참고하고, 클라이언트를 선택하기 전에 유지 관리 상태를 확인하세요.

앱을 응용 프로그램 폴더에 넣은 다음 처음 설정을 진행하고, 시스템 안내에 따라 필요한 권한을 부여하세요. 다른 프록시 도구를 설치했던 적이 있다면 시스템 프록시 설정이나 백그라운드 서비스가 남아 있는지 확인하세요. 메뉴 막대의 켜기·끄기와 설정 선택은 각각 확인해야 합니다. 창을 닫았다고 커널까지 중지된 것은 아닐 수 있습니다.

다운로드 macOS 클라이언트

Android

기기 아키텍처에 맞는 설치 파일을 선택하고 Clash Plus를 먼저 확인해 보세요. Clash Meta for Android, FlClash, Surfboard도 비교할 수 있습니다. 앱마다 지원하는 구독 형식이 다를 수 있으므로 옮기기 전에 형식을 확인하고 같은 파일을 모든 클라이언트에 그대로 가져오지 마세요.

처음 연결할 때 시스템 VPN 권한이 필요합니다. 백그라운드에서 한동안 실행한 뒤 연결이 끊긴다면 배터리 최적화와 백그라운드 실행 제한을 확인하세요. 앱별 분기와 도메인 규칙은 서로 다른 설정 계층입니다. 테스트할 때 앱, 연결 네트워크, 적용된 정책을 기록해 모바일 네트워크 전환으로 인한 오판을 줄이세요.

다운로드 Android 클라이언트

iOS

Clash Plus는 App Store에서 설치할 수 있으며, 프로젝트 공식 사이트는 clashplus.io입니다. 앱에서 구독을 추가한 뒤 시스템 안내에 따라 VPN 구성을 허용하고, 현재 선택한 정책과 연결 상태를 확인하세요.

데스크톱 설정의 로컬 경로, 시스템 프록시 포트, 네트워크 어댑터 매개변수를 휴대폰에 그대로 적용해서는 안 됩니다. 설정 가져오기 오류가 발생하면 먼저 프로토콜과 필드의 호환성을 확인하세요. 네트워크 전환 후 일시적으로 연결되지 않는다면 여러 설정을 연달아 바꾸기보다 연결을 다시 설정하고 로그를 확인해야 문제를 비교하기 쉽습니다.

다운로드 iOS 클라이언트

Linux

데스크톱에서는 Clash Verge Rev와 FlClash를 비교하고 배포판의 패키지 형식에 맞는 설치 파일을 선택할 수 있습니다. 서버와 라우터에서 사용하는 독립 mihomo 커널은 별도로 확인하세요. 이 경우 설정 디렉터리, 프로세스 관리, 시스템 연결을 직접 구성해야 합니다.

GUI의 프록시 스위치가 터미널 프로그램에 영향을 주지 않을 수도 있습니다. 명령줄 도구가 자체 프록시 옵션이나 환경 변수를 사용할 수 있기 때문입니다. TUN을 활성화하기 전에 권한과 기본 경로를 확인하세요. 백그라운드 서비스를 설정할 때는 실행 사용자, 로그 위치, 재시작 방법을 함께 기록해 시스템 업데이트 후에도 환경을 복구할 수 있게 하세요.

다운로드 Linux 클라이언트

클라이언트는 연결을 관리하고 구독은 설정 데이터를 제공합니다. 두 항목의 업데이트 주기는 다를 수 있습니다. 구독은 정상적으로 업데이트되지만 설정이 시작되지 않는다면 먼저 커널 파싱 오류를 확인하세요. 설정이 시작됐는데 앱의 연결 기록이 없다면 시스템 연결 방식을 살펴보세요. 다운로드 페이지에서 시스템 요구 사항과 각 클라이언트의 다운로드 경로를 확인할 수 있으며, 버전 정보도 해당 페이지를 기준으로 확인하세요.

모든 클라이언트 보기 →

Linux 펭귄 그래픽: Font Awesome Tux, CC BY 4.0 라이선스 적용.

OPEN SOURCE / TRACEABLE REFERENCES

Clash 오픈 소스 생태계와 커널 관계

현재 설정에 적합한 클라이언트인지 판단할 때는 프로젝트 출처, 커널 기능, 업데이트 안내를 확인해야 합니다. 오픈 소스 코드는 구현과 변경 내역을 살펴볼 수 있게 해 줍니다. 실제 사용 결과에는 클라이언트 패키징 방식, 설정 내용, 기기의 연결 설정이 더 큰 영향을 줍니다.

프로젝트의 흐름: Clash, Meta, mihomo

Clash는 처음에 설정 기반 프록시 커널로 등장해 노드, 정책 그룹, 규칙을 구성하는 방식을 만들었습니다. 이후 이를 기반으로 한 데스크톱 및 모바일 UI가 등장했습니다. 원본 프로젝트의 유지 관리가 중단된 뒤에도 커뮤니티 파생 프로젝트는 계속 발전했고, Clash.Meta는 이후 mihomo라는 이름으로 관리되고 있습니다. 예전 가이드에는 이전 이름이 그대로 남아 있는 경우가 많습니다. 비슷한 설정을 찾았다면 Clash라는 이름이 붙은 모든 프로그램을 같은 것으로 보지 말고 어떤 커널을 사용하는지 확인하세요.

이런 배경을 알면 오래된 설정을 가져올 수는 있어도 실행할 때 특정 필드를 지원하지 않는다는 오류가 발생하는 이유를 이해할 수 있습니다. 구독 형식이 비슷하다고 기능까지 같은 것은 아닙니다. 기술 자료를 확인할 때는 먼저 프로토콜 지원 여부와 필드 정의를 살펴보세요. 새로운 프로토콜, 확장 규칙, DNS 옵션을 사용한다면 대상 클라이언트 안내에서 해당 기능이 포함되어 있는지도 확인해야 합니다.

오픈 소스 커뮤니티: 변경 내역으로 기능 확인

예를 들어 MetaCubeX/mihomo 소스 코드 저장소의 커밋, 릴리스 노트, 이슈 논의를 살펴보면 기능 변경을 파악하는 데 도움이 됩니다. 연결 문제가 발생하면 먼저 알려진 호환성 문제가 있는지 검색한 뒤 커널을 업데이트할지 설정을 바꿀지 결정하세요. 스타 수, 다운로드 횟수, UI 외관은 구체적인 호환성 안내를 대신할 수 없습니다. 이 사이트도 이를 기준으로 성능 순위를 매기지 않습니다.

문제를 제보할 때는 운영체제, 클라이언트 이름, 연결 모드, 재현 단계, 필요한 로그를 남기고 구독 주소, 노드 인증 정보 등 민감한 내용은 삭제하세요. 개인 설정 전체를 공유하는 것보다 재현 가능한 최소한의 설명이 커뮤니티에서 원인을 찾는 데 더 도움이 됩니다. 다른 사람이 만든 규칙 파일을 사용하기 전에는 관리 범위, 업데이트 주기, 라이선스를 확인해 오래된 규칙을 보편적인 해결책으로 여기지 않도록 하세요.

GUI 클라이언트: UI와 실행 계층은 따로 관리

GUI 클라이언트는 보통 구독 관리, 시스템 프록시 전환, 연결 목록, 로그 확인 기능을 제공하고 커널은 최종 설정을 읽어 연결을 처리합니다. UI에 설정 항목이 있다고 해서 내보낸 파일에도 같은 내용이 유지된다는 뜻은 아닙니다. 반대로 직접 수정한 필드가 실행 시 클라이언트에 의해 다시 생성될 수도 있습니다. 문제를 확인할 때는 실제 실행 중인 설정을 살펴보고 구독 원본, 로컬 덮어쓰기, 최종 병합 결과를 구분하세요.

처음 사용한다면 Clash Plus를 먼저 비교하고 플랫폼에 맞는 다른 클라이언트를 선택하세요. 덮어쓰기, 서비스 관리, UI 사용자 설정 기능이 더 필요하다면 클라이언트 비교를 참고해 항목별로 확인하세요. 이름만 보고 결정하지 않는 것이 좋습니다. 모바일에서는 백그라운드 실행과 배터리 소모를 고려하고, 데스크톱에서는 시스템 프록시, 권한, 기존 네트워크 도구와의 호환성을 확인하세요.

업데이트 확인: 프로그램, 커널, 구독을 따로 살펴보기

프로그램 업데이트는 UI와 서비스 구성 요소를 바꿀 수 있고, 커널 업데이트는 프로토콜 구현과 설정 검증 방식을 바꿀 수 있습니다. 구독 업데이트는 보통 노드나 규칙 데이터를 교체합니다. 각각 해결하는 문제가 다릅니다. 구독 업데이트에 실패하면 링크 유효성과 네트워크 접근을 먼저 확인하세요. 설정 파싱이 실패하면 필드와 형식을 살펴보고, 연결은 됐지만 접속에 문제가 있다면 규칙 적용 결과, DNS, 출구 상태를 확인하세요.

업그레이드 전에 정상 작동하는 설정과 로컬 덮어쓰기를 저장하고 업데이트 안내를 읽은 뒤, 업데이트 후 기존 테스트 절차로 다시 확인하세요. 주요 변수를 한 번에 하나씩만 바꿔야 프로그램 업데이트와 설정 변경 중 무엇이 원인인지 판단할 수 있습니다. 이전 버전으로 되돌릴 때도 데이터 형식을 확인해 새 클라이언트가 만든 설정을 구버전 환경에서 읽지 못하는 문제를 피하세요. 오래 사용하는 기기라면 설치 출처와 서비스 실행 방식도 기록해 복구에 대비하세요.

ARTICLES / PRACTICAL NOTES

Clash 설정 및 클라이언트 선택 가이드

첫 설치부터 노드 선택까지, 구체적인 문제에 필요한 사용 정보를 정리했습니다. 가이드를 읽을 때는 먼저 운영체제와 클라이언트가 일치하는지 확인한 뒤 단계를 적용하세요. 데스크톱 포트, 모바일 연결 권한, 커널별 프로토콜 지원은 서로 대체할 수 없습니다.

문제를 확인할 때는 현재 설정, 사용 모드, 테스트 앱, 오류 메시지를 포함해 전체 작업 과정을 기록하세요. 네트워크 상태는 시간에 따라 바뀌므로 한 번의 속도 테스트 결과는 당시 참고 자료일 뿐입니다. 프로토콜이나 클라이언트를 비교할 때 같은 네트워크와 테스트 대상을 사용하면 더 유용한 결과를 얻을 수 있습니다.

모든 글 보기 →