클라이언트 다운로드 · 한국어 설정 가이드

Clash 다운로드 센터전 플랫폼 클라이언트와 규칙 설정

Clash 다운로드 가이드 보기

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기, 규칙 분류, TUN 모드를 설정하세요.

전체 가이드 보기

Clash
설정 경로

rules.yaml
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

규칙 분류를 사용하면 대상별로 지정한 정책을 적용해 모든 요청이 같은 경로를 거치지 않도록 할 수 있습니다. 클라이언트에서 규칙 모드를 선택한 다음 설정의 rules 섹션에 조건을 지정하세요. 규칙은 위에서 아래로 확인하며, 먼저 일치한 항목이 적용됩니다. MATCH는 기본 처리 규칙으로 맨 마지막에 두세요. 예시의 PROXY는 기존 정책 그룹과 일치해야 하므로 이름만 복사해서는 안 됩니다. 전역 모드와 달리 규칙 모드에서는 로컬 서비스를 직접 연결할 수 있습니다. 앱별 분류보다 도메인 규칙이 한 앱에서 여러 서비스를 이용할 때 더 적합합니다.

이 예시는 설정 항목 간의 관계를 보여 주기 위한 것으로, 그대로 실행할 수 있는 완성된 설정 파일이 아닙니다. 프록시 출구, 정책 그룹, 제공자, 규칙은 서로 일치해야 합니다. 클라이언트에 따라 일부 항목이 인터페이스에서 생성되거나 덮어써질 수도 있습니다. 처음 설정할 때는 한 부분만 변경하고 다시 불러온 뒤 로그를 확인한 다음 다음 항목을 수정하세요. 이렇게 하면 문법 오류, 참조 누락, 네트워크 연결 실패를 구분할 수 있어 한 번에 너무 많은 값을 바꿔 되돌리기 어려워지는 상황을 피할 수 있습니다.

proxy-groups · url-test
proxy-groups:
  - name: AUTO
    type: url-test
    use: [subscription]
    url: https://www.gstatic.com/generate_204
    interval: 300
rule-providers
rule-providers:
  local:
    type: file
    behavior: classical
    path: ./rules/local.yaml
rules:
  - RULE-SET,local,DIRECT
dns · fake-ip
dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter:
    - "*.lan"
tun · stack
tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
mixed-port
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller
external-controller: 127.0.0.1:9090
secret: "your-local-secret"
allow-lan: false
전체 가이드 보기

CLIENT / PLATFORM

Clash 클라이언트 다운로드

운영체제, 프로세서 아키텍처, 필요한 코어를 먼저 확인한 뒤 설치 파일을 선택하세요. 클라이언트 다운로드와 구독 서비스는 별개입니다. 앱을 설치해도 프록시 출구가 자동으로 생기지는 않으며, 설정을 가져온 뒤에는 유효 기간, 정책 선택, 현재 네트워크를 확인해야 합니다. 다운로드 페이지에서 플랫폼별 클라이언트와 설치 방법, 유지 관리 상태를 확인할 수 있으므로 설정 가이드에서 설치 파일을 찾을 필요가 없습니다.

Windows

데스크톱 브라우저, 개발 도구, 시스템 프록시가 필요한 앱에 적합합니다. 다운로드 전에 시스템 정보에서 아키텍처를 확인하세요. 설치 후 구독을 가져오고 시스템 프록시를 켠 다음 브라우저 연결을 확인하면 됩니다. Clash Plus, Clash Verge Rev 등은 서비스 설치 메뉴가 다를 수 있으므로 TUN을 켜기 전에 필요한 권한을 설정하세요.

시스템에서 다른 프록시 도구를 사용 중이라면 포트와 라우팅이 서로 덮어쓰지 않도록 먼저 프록시 연결을 해제하세요. 클라이언트를 종료한 뒤에도 인터넷에 연결되지 않으면 시스템 프록시에 이전 주소가 남아 있는지 확인하세요. 앱을 바로 다시 설치할 필요는 없습니다.

다운로드 페이지로 이동

macOS

Apple Silicon 또는 Intel에 맞는 설치 파일을 선택하세요. 처음 실행할 때는 시스템 안내에 따라 앱 사용을 허용하세요. 시스템 프록시를 따르지 않는 프로그램까지 처리해야 한다면 클라이언트의 서비스 모드와 가상 네트워크 어댑터 지원 여부를 확인하세요. 설치 성공과 프록시 연결 성공은 서로 다른 상태이므로 각각 확인해야 합니다.

기존 클라이언트에서 옮길 때는 새 클라이언트로 가져오기 전에 구독 주소, 사용자 지정 규칙, 정책 그룹 선택을 저장하세요. 앱 데이터 폴더 전체를 그대로 바꾸지 마세요. 프로젝트마다 설정 파일과 서비스 등록 방식이 호환되지 않을 수 있습니다.

다운로드 페이지로 이동

Android

다운로드할 때 프로세서 아키텍처를 확인하세요. 잘 모르겠다면 먼저 기기 정보를 확인하고 클라이언트 설치 안내를 읽으세요. Clash Plus, Clash Meta for Android, FlClash는 설정 화면이 다르므로 구독 형식을 확인한 뒤 가져와야 합니다. 연결을 시작할 때 시스템의 VPN 연결 허용이 필요하며, 앱별 트래픽 분류는 클라이언트의 해당 설정에서 조정할 수 있습니다.

화면을 잠근 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행 제한, 다른 VPN 앱부터 확인하세요. 백그라운드 실행을 허용한 뒤 문제를 재현하고 로그를 살펴 시스템이 프로세스를 종료했는지 확인하세요. 모든 연결 끊김을 구독 만료 탓으로 돌릴 필요는 없습니다.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 사이트 clashplus.io를 확인할 수 있습니다. 설치 후 앱 내 설정 메뉴에서 구독을 가져오고, 시스템 안내에 따라 VPN 구성을 추가한 뒤 사용할 정책을 선택하세요. 상태 표시줄에 VPN이 표시되더라도 터널이 설정되었다는 뜻일 뿐이므로 실제 대상 서비스에 접속해 프록시 출구가 작동하는지 확인해야 합니다.

Wi-Fi와 모바일 데이터 간 전환 후 문제가 생기면 먼저 네트워크에 다시 연결하고 구독의 정책 선택을 확인하세요. 특정 앱만 접속할 수 없다면 규칙 적용 결과를 확인해 문제를 좁히세요. 시스템의 네트워크 설정을 전부 삭제하는 방법을 반복해서 시도하지 않는 것이 좋습니다.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 Clash Verge Rev 또는 FlClash를 시작점으로 삼고, 배포판의 패키지 관리 방식에 맞는 설치 형식을 선택할 수 있습니다. 그래픽 인터페이스의 시스템 프록시 설정이 터미널 명령까지 적용되는 것은 아닙니다. 명령줄 도구에는 프록시 환경 변수를 따로 설정하거나 올바르게 구성된 TUN 라우팅을 적용해야 할 수 있습니다.

서버와 라우터 사용자는 다운로드 페이지의 Mihomo 코어 섹션에서 코어를 확인하고 설정 경로, 서비스 시작, 로그를 직접 관리할 수 있습니다. 수동으로 배포하기 전에 실행 사용자와 수신 대역을 확인하세요. 제어 인터페이스는 외부에 직접 공개하지 말고 로컬 주소에만 바인딩하는 것이 좋습니다.

다운로드 페이지로 이동

전체 클라이언트 보기 →

SOURCE / CONFIGURATION

오픈소스 코어와 클라이언트의 관계

Clash 생태계는 설정 파일, 프록시 정책, 트래픽 규칙을 중심으로 구성됩니다. 인터페이스 이름이 비슷하다고 코어까지 같은 것은 아닙니다. 클라이언트를 선택할 때는 프로젝트 유지 관리 상태, 실제 사용 코어, 지원하는 설정 항목을 함께 확인하세요. 이런 정보가 화면 이미지보다 설정 호환 여부를 판단하는 데 더 도움이 됩니다.

프로젝트 역사와 커뮤니티 포크

원본 Clash와 초기 그래픽 클라이언트 일부는 유지 관리가 중단되었으며, 현재 클라이언트 가운데 상당수는 이후 커뮤니티 코어를 사용합니다. Clash Meta는 관련 포크에서 사용하던 이름이고, mihomo는 현재 널리 쓰이는 코어 프로젝트 이름 중 하나입니다. 온라인 가이드에서는 이름을 혼용하기도 하므로 해당 문서가 어떤 프로젝트를 기준으로 하는지 확인해야 합니다. YAML 확장자가 같다는 이유만으로 모든 설정 항목이 작동한다고 볼 수는 없습니다.

오픈소스 프로젝트의 장점은 코드와 문서, 문제 논의를 공개적으로 확인할 수 있다는 점입니다. 재현 가능한 문제가 발생하면 프로젝트 문서와 관련 이슈를 먼저 확인한 뒤 민감 정보를 제거한 로그를 공유하세요. 알려진 호환성 문제와 로컬 설정 오류를 구분하는 데 도움이 됩니다. 커뮤니티 저장소는 구독 서비스가 아니며 제3자 프록시 출구의 작동을 보장하지도 않습니다.

그래픽 인터페이스와 프록시 코어

클라이언트 인터페이스는 보통 설정 가져오기, 정책 선택, 시스템 프록시 전환, 프로세스 관리를 담당하고 코어는 프로토콜 연결, 규칙 매칭, DNS, 트래픽 처리를 담당합니다. 같은 설정 파일도 클라이언트마다 다르게 작동할 수 있습니다. 코어의 지원 범위가 다르거나 인터페이스가 기본 항목을 자동으로 병합했을 수 있기 때문입니다. 문제를 확인할 때는 구독 원문만 비교하지 말고 실제 적용된 설정을 살펴보세요.

프로토콜 이름이 같아도 확장 매개변수까지 모두 같은 것은 아닙니다. 구독 제공자는 대상 코어와 호환되는 형식을 제공해야 합니다. 설정을 불러올 때 알 수 없는 항목, 누락된 정책, 제공자 읽기 실패가 표시되면 먼저 설정 간 참조 관계를 바로잡으세요. DNS를 반복해서 바꾸는 것으로 문법 오류나 참조 문제를 해결할 수는 없습니다. 연결을 테스트하려면 우선 코어가 설정을 정상적으로 불러와야 합니다.

업데이트와 설정 유지

클라이언트 업데이트, 코어 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 인터페이스와 서비스 관리 방식을 바꿀 수 있고, 코어 업데이트는 설정 지원 범위나 네트워크 동작에 영향을 줄 수 있습니다. 구독 업데이트는 제공자가 전달한 설정 내용을 바꿉니다. 업데이트 전에 현재 정상 작동 상태를 기록하고 로컬 설정과 사용자 지정 덮어쓰기를 따로 보관하세요. 업데이트 후에는 먼저 설정이 정상적으로 불러와지는지 확인한 다음 시스템 프록시, 규칙 적용, TUN을 각각 테스트하세요. 테스트를 위해 모든 옵션을 한꺼번에 켜지 마세요.

다운로드 센터는 플랫폼별 다운로드 경로와 한국어 사용 안내를 정리하며, 각 프로젝트의 릴리스 안내를 대신하지 않습니다. 가이드와 인터페이스의 명칭이 다르면 먼저 클라이언트와 코어 종류를 확인한 뒤 해당 문서를 찾아보세요. 유지 관리가 중단된 앱은 이전을 위한 참고 자료로 활용하는 편이 좋습니다. 새로운 시스템에서는 필요한 설정 항목을 지원하고 계속 관리되는 클라이언트를 우선 검토하세요. 노드 연결 시간 초과, 구독 가져오기 실패, 시스템 프록시에 남은 이전 설정을 확인하는 순서는 문제 해결 문서에서 확인할 수 있습니다.

NOTES / CONFIGURATION

Clash 설정 가이드

아래 세 글은 날짜 역순으로 정렬되어 있으며 코어 선택, 사용자 지정 규칙, DNS enhanced mode를 각각 다룹니다. 먼저 설정을 실행할 코어를 확인한 뒤 규칙 순서나 해석 방식을 변경하면 호환성 문제를 네트워크 장애로 오해할 가능성을 줄일 수 있습니다. 글의 설정 예시는 기존 정책 그룹과 함께 사용해야 하며 구독 전체를 그대로 덮어써서는 안 됩니다.

전체 글 보기 →