Clash FAQ - Clash 클라이언트 다운로드와 설정 질문답변

클라이언트 선택 · 설정 항목 · 문제 해결

Clash 클라이언트 다운로드
자주 묻는 질문

먼저 클라이언트를 선택하고 설정 항목을 확인하세요. 플랫폼별 다운로드, YAML 예제, 자주 발생하는 문제 해결 경로를 정리해 설정을 하나씩 점검할 수 있습니다.

한국어 설정 안내 오픈소스 코어 참고 문제별 찾아보기

config.yaml 설정 FAQ

정적 설정 예시

자주 쓰는 설정 6가지를 필드와 답변 순으로 확인하세요. 예시 내용은 이 기기의 설정을 변경하지 않습니다.

  • 구독 가져오기

    구독 주소 · 예시

    https://example.com/sub?token=xxxx 구독 업데이트

    가져오기는 됐는데 프록시가 안 보이나요?

    먼저현재 설정이 활성화되어 있는지 확인하세요.

  • 프록시 모드

    규칙전역직접 연결

    전역 모드가 더 빠를까요?

    모드는트래픽 경로를 바꿀 뿐, 회선 품질을 높이지 않습니다.

  • 포트 설정

    mixed-port: 7890
    allow-lan: false

    7890 포트가 사용 중이면 어떻게 하나요?

    포트를 변경한 뒤시스템 프록시도 함께 변경하세요.

  • DNS

    enhanced-mode: fake-ip
    nameserver:
      - 223.5.5.5

    가상 주소가 표시되면 오류인가요?

    fake-ip가매핑된 주소를 반환하는 것은 정상입니다.

  • 라우팅 규칙

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

    뒤에 있는 규칙은 왜 적용되지 않나요?

    규칙은위에서부터 확인해 처음 일치하는 항목을 적용합니다.

  • 시작 로그

    infoStart initial configuration in progress
    infoMixed(http+socks) proxy listening at: 127.0.0.1:7890

    수신 대기 성공이원격 연결 성공을 뜻하지는 않습니다.

운영체제별 안내

Clash 다운로드

설치 파일을 고를 때는 운영체제와 프로세서 아키텍처를 먼저 확인하세요. 데스크톱 GUI 클라이언트는 일상적인 사용에, 독립형 코어는 서버와 라우터에 적합합니다. 설치 방식은 서로 다릅니다. 다운로드 센터에서 클라이언트, 시스템 요구 사항, 보관 상태를 확인할 수 있으며, 홈에는 플랫폼별 링크만 안내합니다.

Windows

Clash Plus를 우선 확인하고 Clash Verge Rev, FlClash 등 GUI 클라이언트와 비교해 보세요. 먼저 ‘설정 → 시스템 → 시스템 정보’에서 운영체제 종류를 확인하세요. 설치 후 실행되지 않으면 런타임 환경과 보안 알림을 점검하고, 설정 폴더를 반복해서 덮어쓰지 마세요.

다운로드 페이지로 이동

macOS

‘이 Mac에 관하여’에서 Apple 칩인지 Intel 프로세서인지 확인한 뒤 맞는 설치 파일을 선택하세요. 처음 실행하는 것과 시스템 프록시 권한을 부여하는 것은 별개입니다. 앱이 열려도 시스템 트래픽이 프록시를 통과한다는 뜻은 아닙니다. 더 많은 앱의 트래픽을 처리하려면 안내 문서에 따라 네트워크 확장 또는 TUN을 설정하세요.

다운로드 페이지로 이동

Android

Clash Plus, Clash Meta for Android 등의 클라이언트 중에서 선택할 수 있습니다. 설정을 가져온 뒤에는 시스템 VPN 권한도 확인하세요. 화면을 잠근 후 연결이 끊기면 배터리 최적화와 백그라운드 제한을 먼저 점검하세요. VPN 앱을 동시에 여러 개 켜면 시스템이 현재 연결을 다른 앱으로 대체할 수 있습니다.

다운로드 페이지로 이동

iOS

다운로드 센터에서 Clash Plus의 App Store 페이지로 이동할 수 있습니다. 공식 사이트는 clashplus.io입니다. 가져오기 전에 구독 형식이 호환되는지 확인하고, VPN 구성을 추가할 때는 시스템 안내에 따라 권한을 허용하세요. 설정에 프록시나 정책 그룹이 없으면 연결 스위치만 켜도 보완되지 않습니다.

다운로드 페이지로 이동

Linux

데스크톱 환경에서는 Clash Verge Rev와 FlClash를 확인하고 배포판에 맞는 패키지를 선택하세요. 명령줄만 사용하는 환경이라면 mihomo 코어를 확인한 뒤 설정 경로, 서비스 권한, 로그 출력을 별도로 지정해야 합니다. 데스크톱 앱의 설치 방법을 라우터 시스템에 그대로 적용하지 마세요.

다운로드 페이지로 이동

클라이언트 전체 보기 →

자주 묻는 설정 항목

Clash 설정 및 사용 FAQ

클라이언트 UI, 실제로 실행 중인 코어, 현재 설정 파일을 구분해서 확인하세요. 클라이언트마다 메뉴 이름은 다를 수 있지만 포트, 모드, DNS, 규칙은 설정 항목을 기준으로 하나씩 점검할 수 있습니다. 아래 조각은 일부 설정을 설명하기 위한 예시이며, 바로 연결할 수 있는 완전한 구독 설정은 아닙니다.

구독을 가져왔는데도 프록시가 표시되지 않는 이유는 무엇인가요?

profiles / proxies

먼저구독 업데이트가 정상적으로 완료됐는지 확인한 다음 현재 설정이 선택되어 있는지 확인하세요. 클라이언트의 ‘설정’ 또는 ‘구독’ 페이지에서 서비스 제공자가 준 주소를 추가하고, 업데이트 후 프록시와 정책 그룹이 표시되는지 살펴보세요. 주소가 브라우저에서 열린다고 해서 응답 내용이 Clash 설정과 호환되는 것은 아닙니다. 로그인 페이지, 만료 안내, 일반 텍스트 오류는 YAML로 사용할 수 없습니다. 업데이트에 실패하면 DNS를 서둘러 바꾸기보다 상태 코드와 로그부터 확인하세요. 구독 링크에는 개인 접근 정보가 포함되는 경우가 많으므로 화면을 공유하거나 문의를 올리기 전에 전체 주소를 가리세요. 공개 예시에는 도메인과 매개변수 이름만 남기세요.

‘설정 가져오기 성공’과 ‘노드 사용 가능’은 별개입니다. 전자는 클라이언트가 내용을 받아들였다는 뜻이고, 후자는 실제로 연결해 봐야 알 수 있습니다. 설정을 바꾼 뒤에는 정책 그룹에서 원하는 노드가 선택되어 있는지 확인하세요. 직접 수정한 내용은 다음 구독 업데이트 때 덮어써질 수도 있습니다.

구독 가져오기 방법 보기 →

규칙·전역·직접 연결, 어떤 모드를 선택해야 할까요?

mode

일반적으로는 규칙 모드를 선택해 설정에 따라 요청을 분기하는 것이 좋습니다. 규칙 문제인지 임시로 확인하려면 전역 모드와 비교해 보세요. 전역 모드로 바꿔도 회선 자체가 빨라지지는 않으며, GLOBAL에 해당하는 프록시도 선택해야 합니다. 직접 연결 모드는 코어로 들어온 요청을 프록시 없이 처리하므로 로컬 네트워크를 점검할 때 유용합니다. 세 모드는 코어에 들어온 트래픽의 경로만 바꿉니다. 모든 앱의 트래픽을 자동으로 가져오지는 않으므로 시스템 프록시를 따르지 않는 프로그램은 별도로 프록시를 설정하거나 필요에 따라 TUN을 사용해야 합니다.

mode: rule

rules를 위에서부터 확인합니다. 실제로 적용할 정책은 일치한 규칙에 따라 결정됩니다.

mode 및 공통 설정 항목 보기 →

7890 포트가 사용 중이면 숫자만 바꾸면 되나요?

mixed-port / allow-lan

포트를 바꿀 수는 있지만, 먼저 포트를 사용 중인 프로세스가 이전 인스턴스인지 확인하세요. 한 기기에서 프록시 클라이언트를 여러 개 실행하면 수신 대기 충돌이 발생하기 쉽습니다. 필요 없는 인스턴스를 종료하는 편이 설정을 무작정 바꾸는 것보다 원인을 파악하기 쉽습니다. 포트를 바꿔야 한다면 mixed-port를 사용 중이지 않은 값으로 변경하고 설정을 다시 불러온 뒤, 로그에 새 수신 주소가 표시되는지 확인하세요. 이어서 시스템 프록시와 앱의 프록시 포트도 함께 변경해야 합니다. 그렇지 않으면 브라우저가 이전 주소로 계속 연결합니다. allow-lan은 LAN 접근을 허용할지 정하는 항목이지, 로컬 포트 충돌을 해결하는 스위치가 아닙니다. 이 기기에서만 사용한다면 접근 범위를 제한하기 위해 false로 두는 편이 좋습니다.

포트 점유 문제 해결 방법 보기 →

config.yaml · 로컬 혼합 포트 예시

mixed-port: 7891
allow-lan: false
mode: rule

DNS 오류가 나면 nameserver부터 바꿔야 하나요?

dns / enhanced-mode

먼저 도메인 이름을 해석하지 못한 것인지, 해석은 됐지만 연결에 실패한 것인지 구분하세요. dns.enable, 현재 코어에서 지원하는 설정 항목, 앱이 실제로 해당 DNS 경로를 사용하는지 확인하세요. fake-ip가 매핑된 주소를 반환하는 것은 정상 동작이므로, 공인 IP처럼 보이지 않는다는 이유만으로 설정 오류라고 판단하면 안 됩니다. nameserver는 상위 DNS 서버입니다. fallback도 모든 요청에 한 번씩 적용되는 단순한 예비 스위치가 아니므로 필터 조건과 코어 동작을 함께 살펴봐야 합니다. 브라우저의 자체 암호화 DNS가 예상한 경로를 우회할 수도 있습니다. 문제를 점검할 때는 한 번에 변수 하나만 변경하고, 변경 전후 로그를 기록하세요. DNS 서버를 모두 동시에 바꾸는 것보다 원인을 찾기 쉽습니다.

아래는 설정 항목 구조 예시일 뿐입니다. 로컬 DNS가 루프백 주소에서 수신 대기한다고 해서 시스템이 자동으로 이를 사용한다고 볼 수는 없습니다. DNS 가로채기가 필요한지, TUN과 어떻게 함께 사용할지는 클라이언트의 트래픽 처리 방식을 확인하세요. 설정을 업데이트한 뒤에는 앱과 시스템의 캐시도 살펴봐야 합니다.

DNS 설정 항목과 해석 경로 보기 →

config.yaml · DNS 일부 설정 예시

dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: fake-ip
  nameserver:
    - 223.5.5.5

규칙을 올바르게 작성했는데 왜 적용되지 않나요?

rules / proxy-groups

먼저 규칙 모드가 선택되어 있는지 확인하고, 규칙 목록의 맨 위부터 살펴보세요. 규칙은 처음 일치하는 항목에서 처리를 멈춥니다. 앞쪽의 범위가 넓은 규칙이 요청을 먼저 처리했을 수 있습니다. MATCH는 보통 마지막에 기본 처리용으로 두며, 너무 앞에 배치하면 뒤의 규칙이 적용되지 않습니다. 규칙 끝의 정책 이름은 설정에 정의된 프록시 또는 정책 그룹 이름과 정확히 일치해야 합니다. 여기서 PROXY는 예시 이름일 뿐 모든 설정에 기본으로 포함된 예약 정책이 아닙니다. 문제를 확인할 때는 연결 세부 정보에서 실제 요청 도메인, 적용된 규칙, 최종 출구를 확인하세요. 웹페이지에 표시된 결과만 보고 추측하지 마세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 설정을 변경한 뒤 요청을 새로 시작하세요.

규칙 문법과 적용 순서 보기 →

config.yaml · PROXY라는 이름의 정책 그룹을 먼저 정의해야 합니다

rules:
  - DOMAIN-SUFFIX,google.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

연결됨으로 표시되는데 인터넷이 안 되나요?

log-level / connections

‘연결됨’은 대개 로컬 서비스나 네트워크 트래픽 처리가 시작됐다는 뜻이며, 원격 노드가 사용 가능하다는 의미는 아닙니다. 먼저 프록시를 끄고 일반 웹사이트에 접속해 로컬 네트워크가 정상인지 확인한 다음, 시작 로그에서 설정 파싱, 포트 수신 대기, 권한 오류를 살펴보세요. 그다음 대상 페이지를 열어 연결 목록에 요청이 표시되는지 확인합니다. 기록이 없다면 시스템 프록시나 TUN을 먼저 점검하고, 기록은 있지만 시간 초과가 발생한다면 정책 그룹 선택, DNS, 원격 연결을 확인하세요. Clash 노드 속도 측정 결과는 지정된 테스트 주소에 대한 응답만 보여 줍니다. 지연 시간이 낮아도 모든 웹사이트에 접속할 수 있는 것은 아닙니다. 앱이 갑자기 종료되면 오류 로그부터 보관한 뒤 설정, 코어 파일, 시스템 런타임 환경을 점검하세요. 데이터 폴더 전체를 바로 삭제하지 마세요.

문의를 올릴 때는 운영체제, 클라이언트 이름, 코어 정보, 작업 순서, 오류 전후 로그 몇 줄을 함께 첨부하세요. 구독 인증 정보와 서버 로그인 정보는 가리되 설정 항목 이름과 오류 원문은 남겨 주세요. ‘연결할 수 없음’ 화면 한 장만으로는 보통 어느 단계에서 문제가 생겼는지 파악하기 어렵습니다.

증상별 문제 해결 방법 더 보기 →

프로젝트 및 문서 참고 자료

Clash 생태계와 mihomo 코어

다운로드 전에는 유지 관리 상태를, 설정 변경 전에는 코어 문서를 확인하세요. 이 사이트는 클라이언트 다운로드 링크와 사용 FAQ를 정리하며, 서로 다른 프로젝트의 기능·라이선스·배포 주기를 혼동하거나 커뮤니티 클라이언트를 하나의 공식 앱으로 묶어 소개하지 않습니다.

클라이언트는 조작 화면을, 코어는 연결 처리를 담당합니다

Clash 생태계의 데스크톱 및 모바일 앱은 GUI와 함께 프록시 코어를 포함하는 경우가 많습니다. 구독 관리, 트레이 메뉴, 시스템 프록시 스위치는 클라이언트 기능이며, 프로토콜 해석, 규칙 매칭, DNS 처리는 주로 코어가 담당합니다. 따라서 화면을 바꿔도 회선 품질이 달라지는 것은 아니며, 같은 YAML이라도 코어에 따라 확장 설정 항목의 지원 여부가 다를 수 있습니다. 설정 오류가 발생하면 먼저 실행 중인 코어를 확인한 뒤 해당 문서를 살펴보세요.

원 프로젝트·커뮤니티 포크·보관된 클라이언트를 구분하세요

원래 Clash 프로젝트의 공개 유지 관리가 중단된 뒤에도 커뮤니티에서 다양한 후속 프로젝트가 이어졌습니다. mihomo는 그중 지속적으로 개발되는 코어 프로젝트이며, 일부 클라이언트 UI와 오래된 안내에는 Clash Meta 같은 과거 이름이 남아 있습니다. 이름이 비슷하다고 배포 주체가 같은 것은 아닙니다. 클라이언트를 선택할 때 운영체제 지원, 실제 유지 관리 상태, 필요한 프로토콜을 함께 고려하세요. 보관된 앱은 이전 환경을 참고하는 용도로 사용할 수 있지만, 오래된 화면의 메뉴와 새 코어의 설정 항목을 일대일로 대응시키면 안 됩니다.

업데이트 전 변경 사항을 읽고 되돌릴 설정을 보관하세요

GUI 클라이언트와 내장 코어는 각각 별도로 업데이트될 수 있습니다. UI 문제 수정과 규칙 동작 변경도 서로 다른 작업입니다. 업데이트 전에 로컬 오버라이드, 규칙 파일, 필요한 설정을 백업하고 프로젝트 릴리스 노트에서 호환성 변경 사항을 확인하세요. 업데이트 후 문제가 생기면 기존 설정을 기준으로 최소한의 비교를 진행해 설정, 코어, 네트워크 트래픽 처리 방식 중 어디에서 원인이 발생했는지 확인하세요. 구독 제공자가 배포하는 내용은 클라이언트 업데이트와 별개이므로 앱을 업그레이드해도 만료되거나 사용할 수 없는 구독 주소가 복구되지는 않습니다.

최근 설정 노트

Clash 사용 및 문제 해결 글

전체 글 보기 →

세부 절차가 필요하면 아래 주제별 안내를 계속 읽어 보세요. 모드 문제는 트래픽 경로부터, 백그라운드 연결 끊김은 시스템 권한과 배터리 제한부터, 포트 충돌은 점유 프로세스부터 확인하세요. 서로 다른 계층의 문제를 모두 노드 장애로 단정하지 마세요.

Clash 최신 버전 다운로드