오픈 소스 생태계 · 모든 플랫폼 설정 안내서

Clash 중문 가이드
클라이언트 및 설정 안내

Clash 다운로드 튜토리얼 보기

모든 플랫폼의 클라이언트, 구독 가져오기 절차와 mihomo 설정 안내를 한곳에 정리했습니다. 설치 패키지 선택부터 프록시 모드, 규칙, DNS, 시스템 프록시와 TUN 설정까지 단계별로 진행할 수 있습니다.

  • 영구 무료
  • 오픈 소스
  • 한국어 문서
  • mihomo 커널
PLATFORMS 05 CORE mihomo LICENSE GPL-3.0 CONFIG YAML MODES rule / global / direct

CONFIGURATION BROWSER

규칙, 구독 및 시스템 트래픽 처리

Clash의 주요 기능은 설정 로드, 트래픽 식별과 프록시 정책 실행에 집중됩니다. 실제 설정 구조에 따라 아래에서 나누어 설명하므로 구독, 규칙 또는 시스템 네트워크 처리를 먼저 다뤄야 하는지 판단하기 쉽습니다.

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
MATCH,PROXY

규칙은 순서대로 매칭

규칙 모드는 연결 대상을 위에서 아래로 확인합니다. 도메인 접미사 규칙은 특정 사이트를 처리할 때 적합하고, GEOIP는 대상 주소를 기준으로 분류할 수 있으며, MATCH는 앞선 규칙에 매칭되지 않은 연결을 처리하도록 마지막에 둡니다. 실제 설정에서는 범위가 좁고 의도가 분명한 규칙을 앞에 배치한 뒤 일반 규칙과 최종 정책을 이어서 구성해야 합니다. 이렇게 하면 잘못된 매칭을 줄이고 로그의 규칙 이름으로 설정을 쉽게 추적할 수 있습니다. 수정 후에는 먼저 문법이 유효한지 확인하고 설정을 다시 로드하여 이전 규칙이 커널에서 계속 실행되지 않도록 하세요.

PLATFORM DOWNLOADS

운영체제에 맞는 클라이언트 선택

설치 패키지는 운영체제와 프로세서 아키텍처에 맞아야 합니다. 다운로드 페이지에서는 플랫폼별 사용 가능한 클라이언트, 적합한 용도와 시스템 요구 사항을 안내합니다. 여기에서는 먼저 해당 플랫폼 그룹으로 이동한 다음 구체적인 클라이언트를 비교하세요.

Windows

트레이 제어, 시스템 프록시, TUN 모드와 그래픽 규칙 관리가 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash, Clash Nyanpasu와 보관된 클라이언트를 비교할 수 있습니다. 설치 전에 시스템 아키텍처를 확인하고, TUN을 처음 활성화할 때 표시되는 권한 요청을 처리하세요.

다운로드 페이지로 이동

macOS

Apple Silicon 및 Intel Mac에 적합합니다. 프로세서에 따라 설치 패키지가 다르므로 파일 이름의 macOS 표기만으로 판단하면 안 됩니다. 데스크톱 클라이언트에서 메뉴 막대 제어, 시스템 프록시와 규칙 전환을 관리할 수 있으며, 네트워크 확장 또는 TUN을 활성화한 뒤에는 시스템 설정에서 권한이 적용되었는지 확인해야 합니다.

다운로드 페이지로 이동

Android

스마트폰, 태블릿 및 일부 Android 기기에 적합합니다. 구독을 가져온 뒤 VPN 연결 권한을 허용하고 시스템의 백그라운드 제한에 맞춰 실행 방식을 조정해야 합니다. 네트워크를 전환한 후 연결이 끊기면 먼저 배터리 최적화, 상시 알림과 DNS 설정을 확인한 다음 설정을 바꿀지 판단하세요.

다운로드 페이지로 이동

iOS

iPhone과 iPad에서는 App Store를 통해 해당 클라이언트를 설치합니다. 처음 연결할 때 시스템 VPN 설정을 확인해야 하며, 이후 클라이언트에서 구독을 가져오고 정책 그룹을 선택한 뒤 연결 로그를 확인할 수 있습니다. 모바일 네트워크와 Wi-Fi의 DNS 동작은 다를 수 있으므로 문제를 점검할 때 각각 테스트해야 합니다.

다운로드 페이지로 이동

Linux

데스크톱 Linux, 서버와 커널을 직접 실행해야 하는 장치에 적합합니다. 그래픽 클라이언트는 구독과 정책 관리에 편리하고, mihomo 커널은 systemd, 컨테이너 또는 다른 관리 도구로 운영하기 좋습니다. 배포 전에 설정 디렉터리, 수신 주소, 로그 위치와 서비스 계정 권한을 명확히 정해야 합니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

QUICK START

설치부터 규칙 모드까지 3단계

처음부터 모든 옵션을 한꺼번에 조정할 필요는 없습니다. 먼저 클라이언트가 설정을 정상적으로 로드하고 연결을 수립하도록 한 다음 규칙, DNS, TUN과 LAN 공유를 처리하면 문제 해결 경로가 더 명확해집니다.

  1. 01

    클라이언트 설치 및 커널 실행 확인

    다운로드 페이지에서 해당 플랫폼으로 이동한 뒤 운영체제와 프로세서 아키텍처에 맞는 클라이언트를 선택하세요. 설치가 끝나면 클라이언트를 먼저 열어 설정 디렉터리, 커널 상태와 로그 메뉴를 사용할 수 있는지 확인합니다. Windows와 macOS는 시스템 통합 기능을 처음 활성화할 때 권한을 요청할 수 있으며, Android와 iOS에서는 VPN 설정 확인 화면이 나타납니다. 이 단계에서는 프로그램이 정상적으로 시작되는지만 확인하고 TUN, LAN 공유 또는 복잡한 DNS 옵션은 서두르지 마세요. 클라이언트가 실행 직후 종료되면 먼저 설정 파일 문법, 포트 사용 여부와 시스템 권한을 확인해야 합니다.

  2. 02

    구독 가져오기 및 프록시 그룹 확인

    구독 또는 설정 페이지에 서비스 제공업체가 제공한 구독 주소를 붙여 넣고 다운로드나 업데이트를 실행하세요. 가져오기가 완료되면 프록시 그룹, 노드와 규칙 정보가 표시되어야 합니다. 먼저 사용 가능한 정책을 선택한 다음 클라이언트 로그에 설정 로드 오류가 나타나는지 확인하세요. 구독 주소와 노드 내용은 서비스 제공업체가 관리하고, Clash 클라이언트는 설정을 읽어 실행합니다. 두 요소를 나누어 판단해야 합니다. 업데이트에 실패하면 주소가 완전한지, 네트워크가 연결되는지, 시스템 시간이 정확한지와 로컬 캐시를 차례로 확인하고, 아직 유효한 기본 설정을 반복해서 덮어쓰지 마세요.

  3. 03

    규칙 모드 활성화 및 시스템 프록시 확인

    프록시 모드를 규칙으로 설정하고 시스템 프록시를 켠 다음 직접 연결 대상과 프록시 정책이 필요한 대상을 각각 방문하세요. 규칙 모드는 연결 대상에 따라 정책을 선택하는 방식이며 모든 트래픽이 같은 경로를 거친다는 뜻은 아닙니다. 브라우저에서는 작동하지만 특정 앱에서 작동하지 않는다면 먼저 해당 앱이 시스템 프록시를 읽는지 확인하고, 읽지 않는 경우에 TUN 모드를 검토하세요. 확인이 끝난 뒤 DNS, Fake-IP, 헬스 체크와 시작 시 자동 실행을 조정하세요. 매번 한 종류의 설정만 변경하고 변경 전 설정을 보관해야 문제가 생겼을 때 정확히 되돌릴 수 있습니다.

시스템 프록시는 켜졌지만 브라우저에서 적용되지 않음

먼저 클라이언트 커널이 실행 중인지 확인한 다음 시스템 프록시 포트가 설정의 mixed-port와 일치하는지 점검하세요. 브라우저에 별도의 프록시 설정이나 확장 프로그램이 있으면 운영체제 설정을 덮어쓸 수도 있습니다. 전체 점검 절차는 문제 해결에서 확인하세요.

규칙 모드와 전역 모드 중 무엇을 선택할까

일상적인 사용은 규칙 모드부터 시작해 각 대상이 규칙에 따라 직접 연결 또는 프록시 정책으로 이동하도록 하는 것이 좋습니다. 전역 모드는 프록시 경로를 짧게 확인할 때 적합하고, 직접 연결 모드는 문제가 프록시 설정에서 비롯되었는지 확인할 때 유용합니다. 모드를 전환한 뒤에는 같은 대상을 다시 테스트하세요.

TUN은 언제 활성화해야 할까

대상 프로그램이 시스템 프록시를 읽지 않거나 더 넓은 범위의 네트워크 트래픽을 처리해야 할 때 TUN을 고려하세요. 활성화하기 전에 기존 DNS와 라우팅 상태를 기록해 두세요. 인터넷 연결 끊김, DNS 이상 또는 LAN 접속 문제가 발생하면 먼저 TUN을 끄고 시스템 프록시로 되돌려 비교하세요.

구독을 업데이트하면 사용자 지정 규칙이 덮어써질까

클라이언트의 설정 구성 방식에 따라 다릅니다. 구독에서 생성된 전체 설정을 직접 편집하면 업데이트 때 교체될 수 있습니다. proxy-providers, 오버라이드 또는 별도 규칙 파일을 사용하면 원격 소스와 로컬 수정을 분리할 수 있습니다. 수정하기 전에 사용 가능한 설정 사본을 먼저 내보내세요.

전체 튜토리얼 보기 →

OPEN SOURCE CONTEXT

Clash 생태계, mihomo 커널 및 설정 호환성

규칙 프록시 핵심부터 멀티 플랫폼 클라이언트까지

Clash 생태계는 프록시 커널, 설정 형식과 다양한 플랫폼의 그래픽 클라이언트로 구성됩니다. 커널은 설정을 해석하고 연결을 수립하며 규칙을 매칭하고 로그를 출력합니다. 그래픽 클라이언트는 설치와 업데이트, 구독 관리, 시스템 프록시, 권한 요청과 시각적 조작을 담당합니다. 이 역할을 이해하면 문제를 더 직접적으로 진단할 수 있습니다. 설정 해석 오류는 커널 로그를 확인하고, 트레이나 메뉴 이상은 클라이언트 인터페이스를 살펴보며, 시스템 트래픽이 프록시로 들어오지 않으면 운영체제 통합을 점검하세요.

클라이언트마다 비슷한 커널을 사용할 수 있지만 인터페이스 기능이 완전히 같지는 않습니다. 어떤 클라이언트는 데스크톱 규칙 편집을 강조하고, 어떤 클라이언트는 크로스 플랫폼 사용에 적합하며, 또 어떤 클라이언트는 이전 환경을 위해 보관 상태로 유지됩니다. 선택할 때는 인터페이스만 비교하지 말고 현재 유지 관리 상태, 대상 플랫폼, 프로세서 아키텍처, 설정 호환성 및 TUN, 스크립트, 오버라이드 등의 필요 여부도 함께 확인하세요.

mihomo와 Meta 기능 개발 방향

mihomo는 Clash Meta의 기능 방향을 이어받아 규칙 유형, 프록시 프로토콜, DNS 강화 모드, TUN과 provider 등을 지속적으로 유지 관리합니다. 많은 최신 Clash 그래픽 클라이언트가 mihomo를 핵심 구성 요소로 사용하므로 동일한 YAML 설정을 여러 플랫폼에서 재사용할 수 있습니다. 다만 클라이언트가 자체 오버라이드 파일, 데이터베이스 또는 인터페이스 필드를 추가할 수 있으므로 이전할 때는 원본 설정을 먼저 내보내고 대상 클라이언트의 지원 범위를 다시 확인해야 합니다.

프로토콜과 커널은 같은 개념이 아닙니다. 프로토콜은 클라이언트가 서버와 연결을 수립하는 방식을 정하고, 커널은 프로토콜을 구현하며 로컬 트래픽 분기 로직을 실행합니다. 프로토콜을 선택할 때는 서버 지원 여부, 네트워크 환경, 연결 수립 방식과 장치 리소스를 확인해야 하며, 커널과 클라이언트를 선택할 때는 설정 문법, 플랫폼 통합과 유지 관리 상태를 살펴야 합니다. SS, VMess, Trojan, VLESS, Hysteria2, TUIC과 커널 계열을 체계적으로 비교하려면 프로토콜 안내서를 참고하세요.

설정 업데이트 및 문제 위치 파악

신뢰할 수 있는 설정 절차는 복구 가능한 기본 설정, 별도로 업데이트할 수 있는 구독 소스, 추적 가능한 로컬 규칙 수정이라는 세 계층을 유지해야 합니다. 클라이언트를 업데이트할 때는 먼저 변경 사항을 읽고 설정 디렉터리를 백업하세요. 구독을 업데이트할 때는 프록시 그룹 이름이 바뀌었는지 확인하고, 규칙을 조정할 때는 명확한 이름을 사용한 뒤 로그에서 매칭 결과를 확인하세요. 커널, 구독, DNS와 TUN을 한 번에 수정하면 오류 원인을 구분하기 어려워집니다.

로그는 연결 문제를 판단하는 주요 근거입니다. 설정 로드 단계에서는 YAML 문법, 필드 유형과 파일 경로를 확인하고, 실행 단계에서는 DNS 해석, 규칙 매칭, 연결 시간 초과와 포트 수신을 살펴보세요. 시스템 통합 단계에서는 프록시 설정, 가상 인터페이스, 권한과 방화벽을 점검해야 합니다. 노드를 반복해서 바꾸는 것보다 현상을 계층별로 기록하는 편이 근본 원인을 찾기 쉽습니다. 기술 노트에서는 자주 발생하는 오류, 모바일 백그라운드 정책과 LAN 공유 등 구체적인 상황을 계속 정리합니다.

TECHNICAL NOTES

최신 설정 및 문제 해결 글

LAN 공유, 모바일 백그라운드 실행과 시작 오류를 중심으로 실행 가능한 절차를 정리했습니다. 각 글은 현상과 범위를 먼저 설명한 뒤 점검 순서를 제시하므로 기본 설정을 마친 후 문제별로 참고하기 좋습니다.

고급 설정

Clash LAN 공유 프록시: mixed-port 및 LAN 연결 허용 설정

mixed-port, allow-lan, 수신 주소와 방화벽의 관계를 설명하고 같은 Wi-Fi에 연결된 다른 기기가 이 장치의 프록시를 사용하도록 설정하는 방법을 안내합니다. 설정을 마친 뒤에는 신뢰할 수 있는 네트워크 범위를 제한하여 불필요한 인터페이스에 수신 포트가 노출되지 않도록 해야 합니다.

전체 글 읽기 →
문제 해결

Clash 시작 직후 종료 문제 해결: 설정 파일 오류, 포트 사용과 권한 문제

클라이언트를 두 번 클릭해도 반응이 없거나 시작 후 종료될 때 설정 문법, 포트 수신, TUN 권한과 커널 파일이라는 네 가지 단서를 순서대로 확인하세요. 글에서는 인터페이스 프로세스와 커널 프로세스를 구분하여 모든 시작 문제를 구독 탓으로 돌리지 않도록 설명합니다.

전체 글 읽기 →

전체 글 보기 →