Clash 생태계 · 설정 문서

Clash 프록시 클라이언트

운영체제에 맞는 클라이언트를 선택하고 mihomo 코어와 YAML 설정을 살펴보세요. 구독을 가져온 뒤 규칙 기반 라우팅을 확인하는 방법도 안내합니다.

코어 소스 공개한국어 설정 가이드

클라이언트 설정 기능

구독 전체를 클라이언트에서 가져오며, 노드 제공 소스는 코어가 설정에 따라 읽습니다.

구독 및 노드 제공 소스

설정 목록에 호환되는 구독 URL을 붙여 넣고 다운로드 및 파싱이 끝날 때까지 기다린 다음 해당 설정을 현재 설정으로 지정하세요. 직접 입력한 정보와 달리 원격 구독은 새로고침할 수 있으며, 노드 이름이 바뀌면 기존 선택에도 영향을 줄 수 있습니다. 노드 제공 소스만 있다면 proxy-providers로 별도 로드한 뒤 프록시 그룹에서 참조할 수 있습니다. 두 링크 모두 YAML을 반환하더라도 서로 바꿔 쓸 수 있는 것은 아닙니다. 업데이트에 성공했는데 노드가 보이지 않으면 먼저 전달된 콘텐츠의 유형을 확인하고, 프록시 그룹이 올바른 제공 소스를 참조하는지 점검하세요.

providers.yaml
proxy-providers:  office:    type: file    path: ./providers/office.yamlproxy-groups:  - name: PROXY    type: select    use: [office]

YAML 설정 참고 자료 보기 →

플랫폼별 설치 파일 선택

먼저 운영체제로 필터링한 뒤 프로세서 아키텍처, 설치 방식, 유지 관리 상태를 확인하세요. 기존 클라이언트에서 옮기는 경우 새 클라이언트의 앱 데이터 폴더를 덮어쓰지 말고 구독이나 설정 파일을 가져오세요.

Windows

시스템 정보에서 기기 아키텍처를 확인하세요. 처음 사용한다면 시스템 프록시를 켜고 브라우저 연결 기록이 생성되는지 살펴보세요. 시스템 프록시를 사용하지 않는 앱까지 연결해야 한다면 클라이언트의 TUN 지원 여부와 권한 안내를 확인하세요. 기존 설정을 옮기기 전에는 이전 프로그램을 종료해 두 클라이언트가 동시에 프록시 설정을 변경하거나 수신 포트를 점유하지 않도록 하세요.

다운로드 페이지로 이동

macOS

‘이 Mac에 관하여’에서 Apple Silicon과 Intel 중 어떤 프로세서인지 확인한 뒤 해당 설치 파일을 선택하세요. 프록시를 처음 켠 다음에는 시스템 네트워크 설정에서 현재 네트워크 서비스에 해당 설정이 적용됐는지 확인할 수 있습니다. 클라이언트를 종료한 뒤에도 앱이 로컬 프록시 포트에 연결을 시도한다면 구독을 반복해서 가져오기보다 시스템 프록시가 해제됐는지 확인하세요.

다운로드 페이지로 이동

Android

시스템에서 지원하는 ABI에 맞춰 설치 파일을 선택하세요. 프로세서가 특정 명령어 집합을 지원하더라도 현재 시스템에 해당 패키지를 설치할 수 있다는 뜻은 아닙니다. 처음 연결할 때는 시스템 안내에 따라 VPN 권한을 허용하세요. 화면을 잠근 뒤 연결이 끊긴다면 알림 영역의 상태를 기록하고 앱의 백그라운드 실행 제한과 다른 VPN 서비스의 연결 점유 여부를 확인하세요.

다운로드 페이지로 이동

iOS

App Store에서 클라이언트와 시스템의 호환 조건을 확인하세요. 설정을 가져오고 VPN 구성 추가를 허용한 뒤 클라이언트로 돌아와 선택된 설정과 프록시 그룹을 확인하세요. 상태 표시줄에 VPN 연결이 표시되는데도 대상 앱을 사용할 수 없다면 먼저 브라우저에서 같은 대상에 접속해 보세요. 그런 다음 해당 앱의 연결 기록을 확인해 터널 시작 문제와 요청 전달 문제를 구분하세요.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 배포판에 맞춰 패키지 형식을 선택할 수 있습니다. 예를 들어 Debian 계열에는 DEB를, 해당 배포판에는 RPM을 사용할 수 있습니다. GUI가 없는 기기에 배포할 경우 코어를 독립 실행할 수 있지만 설정 디렉터리, 서비스 권한, 로그는 직접 관리해야 합니다. 시작에 성공한 뒤에도 시스템 설정, 환경 변수 또는 다른 연결 방식을 통해 앱의 요청이 코어로 전달되는지 확인하세요.

다운로드 페이지로 이동

모든 클라이언트 보기 →

첫 연결 3단계

  1. 설정을 가져와 활성화

    구독 또는 설정 페이지에서 제공업체가 안내한 호환 링크를 추가하거나 로컬 YAML 파일을 선택하세요. 목록에 파일이 표시되면 해당 파일을 현재 설정으로 지정해야 합니다. 가져오기에 실패했다면 응답이 설정 본문인지, 로그인 페이지나 서비스 안내 페이지인지 먼저 확인하세요. 스크린샷, 로그, 문제 보고서에 구독 URL을 노출하지 마세요.

  2. 규칙 모드를 선택하고 트래픽 연결

    규칙 모드를 선택하고 프록시 그룹에서 사용할 출구를 확인하세요. 데스크톱에서는 먼저 시스템 프록시를 사용하고, 모바일에서는 안내에 따라 VPN 권한을 허용하세요. TUN이 필요한지 판단하기 전에 연결 방식 하나를 먼저 검증하세요. 코어가 실행 중이라는 것은 시작되었다는 뜻일 뿐 앱 트래픽이 코어로 들어왔다는 의미는 아닙니다. 두 상태를 각각 확인해야 합니다.

  3. 연결 기록으로 라우팅 확인

    직접 연결될 것으로 예상되는 대상과 프록시를 거칠 것으로 예상되는 대상을 하나씩 골라 차례로 접속하고 연결 기록을 확인하세요. 대상 도메인, 적용된 규칙, 최종 출구를 비교합니다. 기록이 없다면 프록시 연결 설정을 먼저 확인하세요. 기록은 있지만 출구가 잘못됐다면 규칙 순서를 점검하세요. 적용된 규칙과 출구가 모두 예상과 일치한 뒤에야 원격 연결 문제를 살펴보세요.

전체 가이드 보기 →

오픈 소스 코어와 유지 관리 출처

원본 Clash와 후속 프로젝트

원본 Clash 설정은 프록시 노드, 프록시 그룹, 규칙을 중심으로 구성됩니다. 이후 여러 프로젝트가 이 구성을 이어받거나 확장했지만 이름이 비슷하다고 해서 배포 경로나 유지 관리 일정까지 공유하는 것은 아닙니다. 오래된 가이드에서는 화면의 메뉴 위치가 달라졌을 수 있습니다. 내용을 읽을 때는 코어 필드, 클라이언트 사용법, 특정 구독 제공업체의 변환 규칙 중 무엇을 다루는지 먼저 확인하세요.

UI, 코어, 구독의 역할

클라이언트는 설정 관리, 시스템 연결, 연결 기록을 담당하고 코어는 설정을 파싱해 규칙을 적용하고 연결을 생성합니다. 구독 제공업체는 전달할 콘텐츠를 관리합니다. 같은 구독을 사용해도 클라이언트에 따라 결과가 달라질 수 있습니다. 예를 들어 한 클라이언트가 DNS나 수신 설정을 추가로 삽입할 수 있습니다. 문제를 확인할 때는 구독 원본과 최종 적용 설정을 각각 보관하세요. 화면의 토글만 보는 것보다 둘의 차이를 비교하는 편이 정확합니다.

mihomo와 필드 호환성

mihomo는 Clash Meta 코어의 개발을 이어받아 프록시 프로토콜, 규칙 세트, 네트워크 스택 설정 옵션을 추가했습니다. 원본 설정에서 흔히 쓰는 기본 필드는 마이그레이션의 출발점으로 활용할 수 있지만, 같은 이름의 필드라도 허용 값과 연관 조건은 대상 코어의 기준을 따라야 합니다. 파싱에 실패하면 오류 메시지에서 처음 문제가 발생한 필드를 찾은 뒤 설정 참고 자료를 확인하세요. 용어가 낯설다면 용어 설명을 참고하세요.

릴리스 노트와 업그레이드 롤백

클라이언트 릴리스 노트와 코어 변경 내역은 따로 확인하세요. 업그레이드 전에 정상 작동하는 설정과 필요한 로컬 오버라이드를 보관하세요. 업그레이드 후에는 설정을 불러올 수 있는지 먼저 확인하고 시스템 프록시, DNS 경로, 규칙 적용을 점검하세요. 재현 가능한 문제를 보고할 때는 사용 플랫폼, 연결 방식, 최소 재현 설정을 적고 개인 도메인, 구독 매개변수, 노드 인증 정보는 제거하세요. 실제 결과를 먼저 설명한 다음 기대한 결과를 적으면 유지 관리자들이 문제 발생 계층을 파악하기 쉽습니다.

mihomo 소스 코드 받기

코어는 GPL-3.0 라이선스로 배포됩니다. 아래 명령은 소스 코드를 가져오는 용도이며 데스크톱 클라이언트 설치 명령이 아닙니다. GUI 클라이언트가 필요하다면 설치 파일 페이지로 돌아가 운영체제에 맞는 항목을 선택하세요.

git clone https://github.com/MetaCubeX/mihomo.git

클라이언트 소식

모든 글 보기 →