Clash 설정 노트

Clash 클라이언트 다운로드구독 가져오기 및 설정

운영체제에 맞는 클라이언트를 선택하고 구독 가져오기부터 시작하세요. 규칙 기반 라우팅과 연결 로그로 트래픽 경로를 확인할 수 있습니다.

  • 한국어 문서
  • YAML 예제

CONFIG WORKBENCH

Clash 설정 항목과 사용법

먼저 바꾸려는 항목이 설정 출처인지, 트래픽 경로인지, 원격 리소스 갱신 주기인지 확인하세요. 각각 별도의 설정 위치가 있습니다. 오른쪽 예시는 기존 설정에 병합해야 하는 일부 항목이며, 그대로 연결해 사용할 수 있는 완성된 구독이 아닙니다.

설정 출처와 프록시 그룹

전체 설정과 프록시 목록 구분하기

먼저 제공업체가 안내한 구독 종류를 확인하세요. 완전한 Clash 구독은 보통 클라이언트의 설정 페이지에서 가져오며, 노드뿐 아니라 프록시 그룹과 규칙도 함께 정의할 수 있습니다. 프록시 목록은 노드만 제공하고, 기본 설정에서 proxy-providers로 불러옵니다. 전체 설정을 프록시 목록처럼 사용하면 주소에 접속할 수 있어도 프록시 그룹에 노드가 표시되지 않을 수 있습니다. 형식을 확인해야 한다면 제공업체의 안내를 우선 참고하고, 접속 정보가 포함된 주소를 온라인 판별 도구에 입력하지 마세요.

가이드 보기
프록시 그룹에서 목록 참조하기

프록시 그룹의 use 목록에 프록시 목록 이름을 입력하세요. 목록을 단일 노드처럼 proxies에 지정하면 안 됩니다. 예시의 ‘수동 선택’ 그룹은 직접 연결과 지연 시간 테스트 그룹을 선택지로 두고 원격 목록도 참조합니다. ‘자동 지연 시간 테스트’ 그룹은 같은 목록에서 노드를 가져옵니다. 가져온 뒤 그룹에 예상한 선택지가 표시되는지 확인하고 연결을 테스트하세요. 그룹 이름을 바꾸면 참조하는 곳도 함께 바꿔야 합니다. 이름과 공백, 대소문자가 정의와 일치해야 합니다.

현재 활성화된 설정 확인하기

목록에 구독 이름이 보인다는 것은 클라이언트에 설정 항목이 추가됐다는 뜻일 뿐, 해당 설정이 코어에 적용됐다는 뜻은 아닙니다. 새 항목으로 전환한 뒤 프록시 페이지의 그룹 이름이 바뀌었는지 확인하세요. 전환되지 않는다면 로그에서 구문 오류나 지원하지 않는 항목이 있는지 살펴보세요. 기존 설정으로 비교할 수 있으므로 이 단계에서 클라이언트를 먼저 재설치할 필요는 없습니다. 개인 정보가 담긴 기록을 공유할 때는 스크린샷에서 링크의 쿼리 매개변수와 계정 정보, 불필요한 연결 정보를 가리세요.

config.yaml · 프록시 그룹
proxy-groups:
  - name: 수동 선택
    type: select
    proxies: [DIRECT, 자동 지연 시간 테스트]
    use: [remote]
  - name: 자동 지연 시간 테스트
    type: url-test
    use: [remote]
    url: https://example.com/
    interval: 300

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

운영체제와 프로세서 아키텍처를 먼저 확인한 뒤 설정 오버라이드, 연결 로그, 시스템 트래픽 처리 방식을 비교하세요. 다운로드 페이지에서 플랫폼별 클라이언트를 확인할 수 있습니다. 다른 프런트엔드로 바꾸더라도 구독 출처는 유지되지만, 기존 클라이언트의 로컬 설정까지 함께 옮겨진다고 가정하지 마세요.

Windows

시스템의 ‘정보’ 페이지에서 운영체제 종류를 확인하세요. 처음 사용하는 경우 시스템 프록시부터 테스트한 뒤 TUN을 켜는 것이 좋습니다. 지원이 종료된 Clash for Windows를 계속 사용 중이라면 기존 설정을 보존하고 현재 유지 관리 중인 대체 클라이언트와 비교해 보세요.

다운로드 페이지로 이동

Android

기기에 맞는 아키텍처의 설치 파일을 선택하고, 처음 연결할 때 시스템 VPN 권한 요청을 확인하세요. 화면을 잠근 뒤에만 연결이 끊긴다면 백그라운드 실행 및 배터리 설정을 먼저 확인하세요. 특정 앱만 프록시를 사용하지 않는다면 앱별 설정을 살펴보세요.

다운로드 페이지로 이동

iOS

다운로드 페이지에서 앱 스토어로 이동한 뒤 기기가 스토어에 안내된 시스템 요구 사항을 충족하는지 확인하세요. 가져온 다음에는 클라이언트에서 설정을 선택했는지, 시스템에서 VPN 연결을 허용했는지 각각 확인하세요. 두 상태가 모두 정상이라면 알려진 대상에 연결해 트래픽 경로를 테스트하세요.

다운로드 페이지로 이동

macOS

‘이 Mac에 관하여’에서 Apple 칩인지 Intel 프로세서인지 확인한 뒤 맞는 설치 파일을 선택하세요. 시스템 프록시 설정은 활성 네트워크 서비스에 따라 달라질 수 있습니다. 무선 네트워크나 도킹 스테이션의 유선 포트로 바꾼 뒤에는 클라이언트가 트래픽을 처리하고 있는지 다시 확인하세요.

다운로드 페이지로 이동

Linux

데스크톱 사용자는 배포판과 패키지 형식에 맞는 GUI 클라이언트를 선택하세요. 서버 사용자는 다운로드 페이지에서 독립 실행형 코어를 확인할 수 있습니다. 데스크톱 프록시 설정과 명령줄 프로그램이 사용하는 환경은 다를 수 있으므로 실제 사용할 앱으로 연결을 테스트하세요.

다운로드 페이지로 이동

모든 클라이언트 보기 → · 클라이언트 기능 비교

Clash 첫 연결, 3단계

설정 하나와 앱 하나로 연결부터 확인한 뒤 자동 시작, 자동 지연 시간 테스트, TUN을 차례로 추가하세요. 문제가 생기면 마지막으로 정상 작동을 확인한 상태로 돌아갈 수 있습니다.

  1. 01

    구독 가져오기

    설정 페이지에서 원격 항목을 추가하고 제공업체가 안내한 Clash 구독 주소를 붙여 넣은 뒤 저장하세요. 다운로드한 뒤 해당 항목을 활성화해야 합니다. 프록시 페이지에 설정에 정의된 그룹 이름과 후보 노드가 표시되면 다음 단계로 넘어가세요. 구독이 로컬 파일로 제공됐다면 파일 가져오기 메뉴를 선택하세요.

  2. 02

    모드와 노드 선택하기

    규칙 모드를 선택하고 테스트할 프록시 그룹에서 노드를 하나 직접 선택하세요. 먼저 자동 전환을 꺼두면 결과를 확인하기 쉽습니다. 데스크톱에서는 시스템 프록시를 켜고, 모바일에서는 클라이언트 안내에 따라 VPN을 연결하세요. 기기에서 다른 프록시나 VPN을 사용 중이라면 어떤 앱이 현재 트래픽을 처리하는지 먼저 확인하세요.

  3. 03

    연결 로그 확인하기

    프록시를 사용해야 하는 것으로 알려진 대상과 직접 연결해야 하는 대상을 각각 열어 보세요. 로그에서 일치한 규칙과 실제 아웃바운드를 확인하세요. 연결 기록 자체가 없다면 노드 지연 시간 탓으로 돌리기 전에 시스템 트래픽 처리 방식부터 확인하세요.

전체 가이드 보기 → · 증상별 문제 해결

Clash 오픈 소스 생태계와 mihomo 코어

프로젝트의 흐름: 이어지는 설정 형식과 달라진 유지 관리

초기 Clash는 YAML 하나에 프록시, 프록시 그룹, 규칙을 함께 구성해 노드 관리와 트래픽 판단을 분리할 수 있게 했습니다. 이후 다양한 GUI 프런트엔드와 파생 코어가 등장해 이 구조를 이어갔지만, 유지 관리 현황과 지원하는 설정 항목은 서로 다릅니다. 특히 Clash for Windows는 지원이 종료됐으므로 예전 문서의 메뉴 위치와 설치 안내를 현재 클라이언트에 그대로 적용하지 마세요. 다른 클라이언트로 옮길 때는 최소 설정으로 핵심 기능부터 확인하고 연결이 되면 사용자 설정을 복원하는 것이 좋습니다.

커뮤니티 유지 관리: 문제에 맞는 프로젝트 기록 확인하기

오픈 소스 저장소의 소스 코드, 릴리스 기록, 이슈 논의에서 구체적인 동작을 확인할 수 있습니다. 창이 열리지 않거나 트레이가 작동하지 않거나 시작 시 자동 실행에 문제가 있다면 사용 중인 GUI 프런트엔드를 먼저 살펴보세요. 같은 최소 설정에서 여러 프런트엔드가 동일한 규칙 오류를 내면 공통으로 사용하는 코어를 확인하세요. 커뮤니티 보고서를 참고할 때는 플랫폼, 시스템 환경, 재현 절차를 함께 비교해야 합니다. 제목이 같아도 원인은 다를 수 있으며, 특히 ‘인터넷에 연결할 수 없음’은 설정 적용, DNS 조회, 노드 연결 등 여러 문제와 관련될 수 있습니다.

코어의 역할: 인터페이스는 관리하고 코어는 실행합니다

mihomo는 Clash Meta에서 파생됐으며 GPL-3.0 라이선스를 사용합니다. GUI 클라이언트는 주로 설정 관리, 상태 표시, 시스템 통합을 담당합니다. 실제 프로토콜 연결과 규칙 매칭, 일부 DNS 동작은 코어가 처리합니다. 같은 코어를 사용하는 클라이언트라도 기본 설정, 시스템 프록시 설정, 오버라이드 방식이 다르면 동작이 달라질 수 있습니다. 반대로 클라이언트에서 설정 항목을 인식하더라도 코어가 해당 항목에서 참조하는 모든 값을 지원한다는 뜻은 아닙니다. 호환성 문제가 생기면 먼저 인터페이스에서 가져오지 못한 것인지, 코어가 불러오지 못한 것인지 구분하세요.

업데이트 방식: 앱, 코어, 설정을 따로 관리하기

앱 업데이트는 인터페이스와 시스템 권한을 바꿀 수 있고, 코어 업데이트는 설정 지원 범위와 실행 동작에 영향을 줄 수 있습니다. 구독 새로고침은 주로 원격 설정 내용을 갱신합니다. 세 가지 업데이트는 별도로 확인하세요. 변경 전에 적용 중인 정책과 필요한 오버라이드를 기록하고, 변경한 뒤에는 같은 테스트 대상으로 로그를 비교하세요. 클라이언트와 구독을 한 번에 바꾸면 문제가 발생했을 때 프로그램 변경과 설정 변경 중 무엇이 원인인지 파악하기 어렵습니다. 되돌릴 수 있도록 로컬 설정 사본을 보관하고, 접속 정보가 포함된 파일은 안전한 비공개 위치에 저장하세요.

Clash 설정 및 문제 해결 노트

상황에 맞는 글을 선택하세요. 첫 연결은 트래픽 경로부터 확인하고, 설정을 수정할 때는 항목별 설명을 참고하세요. 연결은 되지만 속도가 불안정하다면 원인을 단계별로 비교해 보세요.

모든 글 보기 →

Clash 최신 버전 다운로드