CLASH SYSTEM BIOS 오픈 소스 코드 · 지속적으로 유지 관리되는 클라이언트

Clash 클라이언트 다운로드 센터 모든 플랫폼 클라이언트 및 설정 참고

기기에 맞는 클라이언트를 선택한 뒤 구독 가져오기, 정책 그룹 선택, 시스템 프록시 설정을 차례로 진행하세요. 사이트에서는 무료 클라이언트, 오픈 소스 코어, 한국어 설정 문서를 한곳에 정리해 설치 후에도 필드와 오류 상황을 쉽게 확인할 수 있습니다.

영구 무료 오픈 소스 5가지 기기 플랫폼 YAML 설정 참고 문제 해결 단계

BIOS SETUP / CLIENT FUNCTIONS

Clash 핵심 기능 및 설정 메뉴

왼쪽에서 기능을 선택하세요. 오른쪽에서는 처리 대상, 적용 상황, 작업 순서와 놓치기 쉬운 설정 범위를 설명합니다.

PROFILE INPUT / YAML

구독 링크, 원격 설정 및 로컬 YAML

Clash 클라이언트는 보통 구독 주소에서 설정을 가져오며, 로컬 YAML 파일을 직접 불러올 수도 있습니다. 구독 주소는 설정을 가져오는 경로이고, YAML 파일에는 포트, 프록시 노드, 정책 그룹, 규칙, DNS 같은 구체적인 항목이 저장됩니다. 처음 사용할 때는 전체 주소를 설정 관리 화면에 추가하고 클라이언트가 파싱을 마칠 때까지 기다린 다음 새 설정을 현재 설정으로 지정하세요. 웹페이지 주소를 노드로 착각하거나 링크 일부가 누락된 경우, 또는 일반 텍스트를 가져온 경우에는 설정을 인식하지 못할 수 있습니다.

가져오기에 성공한 뒤 같은 주소를 곧바로 반복해서 추가하지 마세요. 먼저 설정 이름, 업데이트 시간, 프록시 그룹이 표시되는지 확인한 다음 정책 화면에서 노드를 선택하세요. 원격 설정을 업데이트하면 제공자가 관리하는 일부 내용이 교체되며, 로컬에서 직접 수정한 내용은 다음 업데이트 때 덮어써질 수 있습니다. 장기간 유지할 규칙은 클라이언트의 오버라이드, 병합 또는 스크립트 설정에 작성하는 편이 적합합니다. 전체 작업 순서는 사용 가이드에서 확인할 수 있습니다.

DEVICE DOWNLOAD MAP

기기별 Clash 다운로드 페이지

홈페이지에서는 플랫폼만 안내합니다. 클라이언트 모델, 프로세서 아키텍처, 시스템 요구 사항과 설치 파일은 다운로드 센터에서 통합 제공합니다.

DEV 00 / WINDOWS

Windows 클라이언트

Windows 데스크톱 기기용입니다. 다운로드 페이지에서는 GUI 클라이언트별 현재 유지 관리 상태를 구분하고, 일반적인 x64 기기에 맞는 설치 항목을 제공합니다. 처음 설치한 뒤 설정을 가져오고 시스템 프록시를 활성화하세요. 더 많은 앱 트래픽을 제어해야 한다면 서비스 모드와 TUN 권한을 추가로 확인하세요.

[ Windows 다운로드 ]

DEV 01 / MACOS

macOS 클라이언트

macOS 설치 파일은 Intel과 Apple Silicon을 구분해야 합니다. 먼저 ‘이 Mac에 관하여’에서 칩 유형을 확인한 뒤 맞는 파일을 선택하세요. 처음 실행할 때 시스템 설정에서 앱 권한을 허용해야 할 수 있으며, TUN이나 시스템 확장을 활성화할 때는 클라이언트 안내에 따라 승인을 완료해야 합니다.

[ macOS 다운로드 ]

DEV 02 / ANDROID

Android 클라이언트

Android 기기는 보통 ARM 아키텍처에 맞춰 설치 파일을 선택하며, 최근 기기라면 ARM64 버전을 먼저 확인하는 것이 좋습니다. 구독을 가져오면 시스템이 VPN 권한 대화상자를 통해 네트워크 연결을 확인합니다. 일정 시간 백그라운드에서 실행한 뒤 연결이 끊긴다면 배터리 절약 정책, 백그라운드 제한과 상시 VPN 설정을 확인하세요.

[ Android 다운로드 ]

DEV 03 / IOS

iOS 클라이언트

iPhone과 iPad는 App Store에서 사용 가능한 클라이언트를 설치합니다. 구독을 추가하면 시스템에서 VPN 구성을 승인해야 합니다. 클라이언트와 시스템 VPN 설정에서 연결 상태를 서로 확인할 수 있습니다. 셀룰러 네트워크와 Wi-Fi의 동작이 다르다면 DNS, 로컬 네트워크 권한과 현재 정책을 각각 점검하세요.

[ iOS 다운로드 ]

DEV 04 / LINUX

Linux 데스크톱, 서버 및 라우터 기기

Linux 사용자는 배포판에 맞는 데스크톱 클라이언트를 선택하거나 Mihomo 코어를 직접 사용할 수 있습니다. GUI 클라이언트는 데스크톱 환경에, 코어는 서버, 컨테이너와 라우터 기기에 적합합니다. 파일을 선택할 때는 시스템 아키텍처와 패키지 형식을 모두 확인해야 합니다. 명령줄로 실행하려면 설정 경로, 서비스 권한과 부팅 시 시작 방식을 준비해야 합니다.

[ Linux 다운로드 ]

ARCHITECTURE CHECK

설치 전에 프로세서 아키텍처 확인

macOS에서는 Intel과 Apple Silicon을 구분해야 하며, Android에서는 ARM64와 ARM이 흔히 사용됩니다. Linux에는 AMD64, ARM64, ARMv7 또는 기타 기기 아키텍처가 사용될 수 있습니다. 파일 이름의 아키텍처 표기가 기기와 일치하는지 반드시 확인하세요.

CLIENT OR CORE

일반 데스크톱 사용자는 GUI 우선 선택

그래픽 클라이언트는 설정 관리, 정책 전환, 로그 확인과 시스템 프록시 제어 기능을 제공합니다. Mihomo 코어는 명령줄, 서비스 관리, 설정 경로와 네트워크 권한에 익숙한 서버나 라우터 기기에 더 적합합니다.

FIRST BOOT

설치 완료가 프록시 활성화를 의미하지는 않습니다

클라이언트를 실행한 뒤에도 유효한 설정을 가져오고 정책 그룹과 노드를 선택한 다음 사용 환경에 맞게 시스템 프록시나 TUN을 활성화해야 합니다. 연결 확인에는 실제 접속, 외부 IP 상태와 실행 로그를 모두 포함해야 합니다.

OPEN SOURCE CONTEXT

Clash 오픈 소스 생태계와 유지 관리 범위

클라이언트, 코어, 설정 제공자와 이 사이트의 문서는 서로 다른 계층에 속합니다. 경계를 이해하면 다운로드와 문제 해결을 더 직접적으로 진행할 수 있습니다.

프로젝트 역사: 규칙 기반 프록시 코어에서 다중 클라이언트 생태계로

Clash는 처음에 규칙 기반 프록시 코어와 설정 형식으로 널리 사용되기 시작했습니다. 핵심 기능을 바탕으로 커뮤니티에서는 데스크톱, 모바일과 명령줄 클라이언트가 차례로 발전했습니다. 서로 다른 클라이언트는 프록시 노드, 정책 그룹, 규칙, DNS와 시스템 프록시 같은 개념을 일부 공유하지만, 인터페이스 구조, 유지 관리 상태, 지원 플랫폼과 확장 기능은 완전히 같지 않습니다. 따라서 ‘Clash’는 일반적으로 모든 플랫폼을 하나의 설치 파일로 아우르는 제품이 아니라 설정과 사용 방식으로 이루어진 생태계를 의미합니다.

일부 초기 클라이언트는 이미 유지 관리가 중단되었지만, 오래된 튜토리얼과 기존 설정 때문에 여전히 검색될 수 있습니다. 클라이언트를 선택할 때는 화면 사용감보다 현재 유지 관리 상태, 시스템 지원 여부와 설정 호환성을 우선하세요. 다운로드 센터에서는 현재 유지 관리되는 클라이언트와 보관된 클라이언트를 구분해 표시하여, 오래된 문서의 이름을 현재 권장 항목으로 오해하지 않도록 합니다.

오픈 소스 생태계: 코드, 설정 형식과 그래픽 인터페이스의 계층

오픈 소스 코드를 통해 코어 동작, 설정 필드와 이슈 기록을 커뮤니티가 검토할 수 있으며, 여러 개발자가 플랫폼별 그래픽 인터페이스를 만들 수도 있습니다. 그래픽 클라이언트는 설정 관리, 시스템 프록시 전환, 트레이 조작, 로그 표시와 설치·업데이트를 담당합니다. 코어는 YAML을 읽고 네트워크 연결을 만들며 규칙 매칭을 실행하고 DNS와 TUN을 처리합니다. 문제가 발생하면 반복해서 재설치하기보다 오류가 인터페이스 계층, 설정 계층, 코어 또는 시스템 네트워크 계층 중 어디에 있는지 먼저 판단하는 편이 효과적입니다.

구독 서비스는 클라이언트 자체에 포함되지 않습니다. 클라이언트는 설정을 읽고 그 안의 노드, 정책 그룹과 규칙을 실행하며, 구독 내용은 해당 설정 제공자가 관리합니다. 노드 만료, 구독 권한이나 트래픽 상태는 설정 제공자 측에서 확인해야 합니다. YAML 파싱 실패, 포트 충돌, 시스템 프록시 미활성화와 TUN 권한 문제는 클라이언트 로그와 시스템 설정에서 확인하는 편이 적합합니다.

코어 관계: Mihomo는 일반적인 설정 기능을 계승하고 확장합니다

Mihomo는 현재 Clash 생태계에서 널리 사용되는 오픈 소스 코어 구현으로, 규칙, 정책 그룹, DNS와 프록시 프로토콜 같은 핵심 개념을 계승하면서 설정 필드와 실행 기능을 계속 확장하고 있습니다. 클라이언트가 Mihomo를 사용하는지, 어떤 필드를 지원하는지, 오버라이드를 어떻게 적용하는지는 해당 클라이언트의 안내를 기준으로 판단해야 합니다. 특정 코어가 지원하는 모든 필드를 오래된 임의의 클라이언트에 그대로 복사해도 설정이 정상적으로 파싱된다는 보장은 없습니다.

사이트의 설정 참고 자료는 일반적인 YAML 구조와 자주 사용되는 Mihomo 필드를 중심으로 하며, 필드 간 의존 관계도 설명합니다. 설정을 수정하기 전에는 복구 가능한 사본을 보관하고, 한 번에 관련 필드 한 그룹만 조정한 뒤 로그에서 설정이 로드되었는지 확인하세요. 포트, DNS, TUN, 규칙과 정책 그룹을 한꺼번에 바꾸면 오류 원인을 찾기 어려워집니다.

업데이트 방식: 버전 변경과 설정 업데이트를 별도로 처리

클라이언트 프로그램 업데이트와 구독 설정 업데이트는 서로 독립된 경로입니다. 프로그램 업데이트는 코어 변경, 인터페이스 조정과 시스템 호환성 수정을 포함할 수 있으며, 구독 업데이트는 주로 노드, 정책 그룹과 규칙 내용을 갱신합니다. 연결 문제가 발생했을 때 ‘구독 업데이트’와 ‘클라이언트 업그레이드’를 같은 단계로 취급해서는 안 됩니다. 먼저 현재 설정이 파싱되는지 확인하고, 클라이언트 유지 관리 상태와 시스템 호환 정보를 확인한 뒤 이전 여부를 결정하세요.

이 사이트의 다운로드 페이지는 통합 목록을 통해 현재 파일 항목을 파싱하며, 목록에 유효한 정보가 있을 때만 페이지의 버전 영역을 표시합니다. 홈페이지에는 버전 번호를 표시하지 않아 특정 클라이언트의 프로그램 버전을 Clash 생태계 전체의 통합 버전으로 오해하지 않도록 합니다. 문서는 설정 개념, 플랫폼 차이와 오류 유형별로 계속 정리하여 설치 후에도 필요한 내용을 쉽게 찾을 수 있도록 합니다.

CONFIG IMPORT

구독 링크를 가져온 뒤 노드가 보이지 않나요?

먼저 링크가 클라이언트에서 읽을 수 있는 설정을 반환하는지 확인한 다음, 해당 설정이 현재 항목으로 지정되었는지 점검하세요. 파싱 로그에 YAML 문법 오류가 표시된다면 들여쓰기, 필드 유형과 목록 계층부터 확인하세요.

설정 가져오기 문제 확인 →

SYSTEM PROXY

클라이언트는 실행 중인데 브라우저에 프록시가 적용되지 않나요?

시스템 프록시가 활성화되어 있는지, 브라우저가 별도의 프록시 설정을 사용하는지, 현재 정책 그룹에서 노드가 선택되어 있는지 확인하세요. 이후 로그에서 브라우저 연결이 Clash 수신 포트로 들어오는지 확인합니다.

연결 문제 해결 보기 →

UWP LOOPBACK

Windows 스토어 앱이 연결되지 않나요?

일부 UWP 앱은 루프백 액세스 제한의 영향을 받습니다. 일반 데스크톱 앱이 프록시를 통해 연결되는 것을 확인한 뒤, 클라이언트에서 제공하는 UWP 루프백 설정을 점검하고 필요한 앱에만 해당 권한을 활성화하세요.

Clash UWP 루프백 확인 →

DNS ROUTE

DNS 경로 문제 여부는 어떻게 판단하나요?

시스템 리졸버, 브라우저 보안 DNS, Clash DNS 모듈과 업스트림 서버를 각각 확인하세요. 도메인 해석이 성공한 뒤에도 연결되지 않는다면 규칙, 노드와 IPv6 라우팅을 추가로 점검해야 합니다.

DNS 및 네트워크 모드 보기 →

LATEST TECH NOTES

Clash 설정 및 문제 해결 문서

최신 콘텐츠는 로그 분석, 노드 선택과 구독 가져오기를 중심으로 구성되어 있습니다. 각 문서는 반복해서 실행할 수 있는 하나의 점검 절차를 제공합니다.

문제 해결

Clash 실행 로그 읽는 법: 일반적인 오류 의미와 문제 해결 순서

로그 수준, 시간 순서와 핵심 필드를 바탕으로 설정 파싱, 포트 충돌, DNS, TUN과 연결 실패 등 일반적인 오류를 확인하는 방법을 설명합니다. 클라이언트는 실행되지만 연결 결과가 비정상일 때 단계별 점검에 적합합니다.

READ ARTICLE →
시작하기

Clash 노드 선택 방법: 지연 시간, 배율, 지역과 프로토콜 판단 기준

지연 시간 테스트의 한계, 배율이 트래픽에 미치는 영향, 지역 선택 원칙과 일반적인 프로토콜 차이를 설명합니다. 한 번의 측정 결과만으로 장기간 사용할 노드를 결정하지 않도록 반복 가능한 노드 선별 절차를 제시합니다.

READ ARTICLE →
시작하기

Clash 구독 링크 가져오기 가이드: 주소 형식, 설정 업데이트와 가져오기 실패 해결

구독 주소와 YAML 설정 파일의 차이를 정리하고, 클라이언트 가져오기, 수동 업데이트와 링크를 인식하지 못할 때의 점검 방법을 단계별로 설명합니다. 로컬 오버라이드와 원격 업데이트의 관계도 함께 다룹니다.

READ ARTICLE →