HANDBOOK / SETUP

Clash 사용 문서: 구독 가져오기부터 작동 확인까지

이 페이지는 하나의 완전한 작업 흐름입니다: 준비 → 구독 가져오기 → 모드 선택 → 연결 시작 → 확인. 순서대로 진행하면 첫 설정을 마칠 수 있으며, 각 단계마다 앵커가 제공되어 목차에서 언제든 이동할 수 있습니다. 클라이언트를 아직 설치하지 않았다면 먼저 다운로드 페이지에서 운영체제에 맞는 버전을 받으세요.

클라이언트 화면 차이에 대하여

이 글은 특정 클라이언트의 스크린샷에 얽매이지 않고 흐름을 중심으로 설명합니다. Clash Plus, Clash Verge Rev, FlClash 등 클라이언트마다 메뉴 이름이 약간 다릅니다—일부 클라이언트에서는 '구독'이 '설정' 또는 'Profiles'로 표시되며, '시스템 프록시'는 '시스템 프록시로 설정'이라고 쓰여 있는 경우도 있습니다. 이름이 일치하지 않을 때는 기능으로 판단하세요: 링크를 붙여넣을 수 있는 페이지가 구독 입력창이고, 전체 스위치 모양의 버튼이 연결 스위치입니다. 클라이언트별 차이와 선택 방법은 클라이언트 비교 가이드에서 확인할 수 있습니다.

STEP 01

준비 작업: 클라이언트와 구독 링크

시작하기 전에 두 가지를 준비해야 합니다: 설치된 클라이언트 하나, 사용 가능한 구독 링크 하나.

  1. 클라이언트 설치

    다운로드 페이지에서 운영체제에 맞는 클라이언트를 선택해 설치를 완료하세요. 전 플랫폼에서 가장 추천되는 것은 Clash Plus이며, Windows/Linux에서는 Clash Verge Rev도 자주 선택됩니다. 설치 과정은 일반 소프트웨어와 동일하며, Windows 사용자가 SmartScreen 경고를 만났을 때의 처리 방법은 블로그 글 《Windows에서 Clash 설치하는 전체 과정》을 참고하세요.

  2. 구독 링크 받기

    구독 링크는 이용 중인 서비스 제공업체가 제공하며, 보통 사용자 패널의 '구독' 또는 '원클릭 구독' 영역에서 복사 버튼을 눌러 얻을 수 있습니다. 이는 일반적인 HTTPS 주소로, 다음과 같은 형태입니다:

    https://example-provider.com/api/v1/client/subscribe?token=a1b2c3d4e5

    이 링크의 뒤에는 노드, 정책 그룹, 분기 규칙이 포함된 완전한 Clash 설정 파일이 있습니다. 링크는 계정 인증 정보와 같으므로 공개적으로 게시하지 마세요. 본 사이트는 어떠한 구독 서비스도 제공하지 않으니, 링크 발급에 대해서는 이용 중인 서비스 제공업체에 문의하세요.

STEP 02

구독 가져오기

이전 단계에서 복사한 링크를 클라이언트에 전달하면 클라이언트가 전체 설정을 다운로드하여 저장합니다.

클라이언트마다 가져오기 입력창의 위치가 약간 다르므로 아래 표를 참고해 해당 페이지를 찾으세요:

클라이언트 구독 입력창 조작 방법
Clash Plus 메인 화면 '구독' 탭 링크 붙여넣기 → '추가' 클릭 → 다운로드 완료까지 대기
Clash Verge Rev 왼쪽 '구독' 페이지 상단 입력창에 붙여넣기 → '가져오기' 클릭 → 해당 설정 카드를 클릭해 선택
FlClash 하단 '설정' 페이지 우측 하단 + 버튼 → 'URL' 선택 → 붙여넣은 후 저장
Clash Meta for Android '설정' → 새 설정 → URL 링크 입력 후 저장, 목록으로 돌아가 해당 설정 선택

가져오기 과정은 세 가지 관찰 가능한 지점으로 나뉩니다. 링크를 붙여넣고 확인하면 클라이언트에 다운로드 진행률이나 짧은 로딩 상태가 표시됩니다. 다운로드가 끝나면 구독 목록에 이름과 업데이트 시간이 표시된 항목이 나타납니다. '프록시' 페이지로 전환하면 정책 그룹과 노드 목록을 볼 수 있는데, 노드 목록이 보이면 가져오기가 성공했다는 뜻이므로 다음 단계로 넘어가면 됩니다. 확인 후 오랫동안 반응이 없거나 오류가 발생하면 대부분 링크가 완전히 복사되지 않았거나 네트워크가 연결되지 않은 경우이며, 해결 방법은 문서 맨 아래 문제 해결을 참고하세요.

또 다른 가져오기 방법

구독 링크가 없고 config.yaml 파일만 있는 경우, 같은 입력창에서 '로컬에서 가져오기'를 선택하거나 파일을 클라이언트 창에 바로 드래그하면 됩니다. 설정 파일의 각 필드가 의미하는 내용은 이 페이지의 설정 파일 한눈에 보기를 참고하세요.

STEP 03

프록시 모드 선택

구독을 가져온 뒤에는 먼저 모드 설정을 확인하세요. 모드는 '어떤 트래픽이 프록시를 거칠지'를 결정하며, 모드를 잘못 선택하는 것은 초보자 단계에서 가장 흔한 문제 원인입니다.

규칙 모드(Rule)

설정 파일의 rules 항목을 위에서부터 하나씩 대조합니다. 다이렉트 규칙에 해당하는 트래픽은 프록시를 거치지 않고, 나머지는 정책 그룹에 따라 전달됩니다. 평상시에는 이 모드를 사용하며, 분기 처리는 구독 제공자가 관리하므로 대부분 수동 개입이 필요하지 않습니다.

글로벌 모드(Global)

모든 규칙을 무시하고 모든 트래픽을 현재 선택된 노드로 보냅니다. '특정 사이트가 규칙에 매칭되지 않는 것인지'를 임시로 점검할 때 적합하며, 확인이 끝나면 반드시 규칙 모드로 돌아가야 합니다. 그렇지 않으면 로컬 트래픽까지 프록시를 거치게 됩니다.

다이렉트 모드(Direct)

모든 트래픽이 노드를 거치지 않고 직접 연결됩니다. 프록시를 임시로 끄면서 클라이언트 실행은 유지하는 것과 같으며, 속도 비교나 프록시 요인 배제에 사용할 수 있습니다.

모드 전환 스위치는 보통 클라이언트 메인 화면이나 '프록시' 페이지 상단에 세 옵션이 나란히 표시되며, 클릭하면 즉시 전환되어 바로 적용됩니다. 이는 설정 파일의 다음 필드에 해당합니다:

mode: rule        # 선택 가능한 값: rule / global / direct, rule 유지를 권장

모드를 규칙(Rule)으로 확인한 뒤, '프록시' 페이지의 정책 그룹에서 노드를 하나 선택하세요—보통 기본 정책 그룹의 이름은 PROXY이거나 서비스 제공업체가 지정한 이름입니다. 그룹을 열어 노드를 클릭하면 선택이 완료됩니다. 노드를 어떻게 고를지는 다음 확인 단계에서 지연 시간 테스트와 함께 설명합니다.

STEP 04

연결 시작

클라이언트를 실행하는 것만으로는 '로컬에서 포트를 대기 중인' 상태일 뿐이며, 시스템 트래픽을 그쪽으로 향하게 하는 단계가 하나 더 필요합니다.

  1. 데스크톱: 시스템 프록시 스위치 켜기

    클라이언트 설정 또는 메인 화면에서 '시스템 프록시' 스위치를 찾아 켭니다. 이 단계는 실제로 운영체제의 프록시 설정을 Clash가 대기 중인 혼합 포트(기본값 127.0.0.1:7890)로 지정하는 것이며, 브라우저 등 시스템 프록시 설정을 따르는 대부분의 애플리케이션이 자동으로 프록시를 거치게 됩니다. macOS는 처음 켤 때 권한 요청 대화상자가 나타나며 안내에 따라 시스템 비밀번호를 입력하면 됩니다. Windows에서는 스위치를 켠 후 '설정 → 네트워크 및 인터넷 → 프록시'에서 해당 항목을 확인할 수 있습니다.

  2. 모든 트래픽을 처리해야 할 때: TUN 모드

    일부 애플리케이션(명령줄 도구, 일부 게임 및 클라이언트 소프트웨어)은 시스템 프록시 설정을 읽지 않습니다. 이런 애플리케이션도 프록시를 거치게 하려면 'TUN 모드'를 켜세요. 클라이언트가 가상 네트워크 카드를 생성하여 네트워크 계층에서 모든 트래픽을 처리합니다. TUN 모드는 관리자/시스템 확장 권한이 필요하며, 처음 켤 때 클라이언트 안내에 따라 권한 승인과 서비스 설치를 완료하세요. 시스템 프록시와 TUN 중 하나만 선택하면 되며 동시에 켤 필요는 없습니다.

  3. 모바일: VPN 통로 승인

    Android 클라이언트에서 메인 화면의 시작 버튼을 탭하면 시스템이 VPN 연결 요청을 표시합니다. '확인'을 누르면 상태 표시줄에 열쇠 아이콘이 나타나며 연결이 완료됩니다. iOS에서는 Clash Plus를 처음 실행할 때도 VPN 설정 추가를 요청하며, 시스템 팝업에서 허용하면 되고 이후의 시작/종료는 앱 안에서 한 번의 탭으로 처리할 수 있습니다.

시작 오류: 포트가 사용 중

시작할 때 bind: address already in use라는 메시지가 표시되면 7890 포트가 다른 프로그램(주로 종료되지 않은 또 다른 프록시 클라이언트)에 의해 사용 중이라는 뜻입니다. 사용 중인 프로세스를 찾고 포트를 변경하는 구체적인 명령어는 블로그 글 《Clash 포트 사용 중 오류 해결법》을 참고하세요.

STEP 05

작동 여부 확인

'웹페이지가 열린다'는 것만으로 프록시 상태를 판단하지 말고, 명령어로 한 번 확인하면 결론이 명확하고 재현 가능합니다.

터미널을 열고(Windows 10 이상은 curl.exe가 기본 내장되어 있어 PowerShell과 CMD 모두에서 바로 사용할 수 있습니다) 아래 명령어를 실행하여 요청이 Clash의 로컬 혼합 포트를 강제로 거치도록 합니다:

curl -I -x http://127.0.0.1:7890 https://www.google.com/generate_204

결과의 첫 줄에 HTTP/2 204 또는 HTTP/1.1 204 No Content가 표시되면 '로컬 → Clash → 노드 → 목적지 사이트'로 이어지는 전체 경로가 정상 작동 중이라는 뜻입니다. 흔히 발생하는 세 가지 실패 결과와 의미는 다음과 같습니다:

  • Connection refused: Clash가 7890 포트를 대기하고 있지 않은 경우—클라이언트가 실행되지 않았거나 설정의 포트가 7890이 아닌 경우이며, 이전 단계로 돌아가 확인하세요;
  • timed out: 요청이 노드까지 도달한 뒤 멈춘 경우—현재 노드를 사용할 수 없는 상태이므로 다른 노드로 다시 시도하세요;
  • 200이 반환되고 내용이 통신사 안내 페이지인 경우: 요청이 아예 외부로 나가지 않은 상태이므로 모드가 다이렉트로 잘못 설정되어 있는지 확인하세요.

노드 지연 시간 테스트

명령어 확인을 통과했다면, 클라이언트의 '프록시' 페이지에서 정책 그룹에 대해 지연 시간 테스트를 한 번 실행하세요(보통 정책 그룹 우측 상단의 번개 또는 속도 측정 아이콘). 테스트가 끝나면 각 노드 옆에 밀리초 단위 수치가 표시됩니다. 값이 낮을수록 응답이 빠르며, 값이 안정적이고 낮은 노드를 우선 선택하세요. 타임아웃(timeout)으로 표시되는 노드는 현재 사용할 수 없으니 선택하지 마세요. 지연 시간이 크게 흔들리거나 전체적으로 높게 나오는 원인과 대처법은 문제 해결을 참고하세요. 여기까지 진행하면 첫 설정이 완료된 것입니다.

REFERENCE

설정 파일 한눈에 보기

구독을 가져오는 것은 본질적으로 YAML 설정 파일을 하나 다운로드하는 것입니다. 핵심 필드 몇 가지를 알아두면 문제를 해결할 때 시간을 아낄 수 있습니다.

# config.yaml 핵심 필드(일부 발췌, 주석 포함)
mixed-port: 7890            # HTTP와 SOCKS5가 공유하는 혼합 리스닝 포트
allow-lan: false            # 같은 네트워크의 다른 기기가 이 프록시에 접속하도록 허용할지 여부
mode: rule                  # 프록시 모드: rule / global / direct
log-level: info             # 로그 레벨, 문제 해결 시 임시로 debug로 변경 가능
external-controller: 127.0.0.1:9090   # 외부 제어 API, 패널류 도구에서 호출

proxies: []                 # 노드 목록, 구독을 가져오면 서비스 제공업체의 설정으로 채워짐

proxy-groups:               # 정책 그룹: "어떤 종류의 트래픽을 어떤 노드에 맡길지" 정의
  - name: PROXY
    type: select
    proxies: []

rules:                      # 분기 규칙, 위에서 아래로 하나씩 매칭하며 일치하면 중단
  - DOMAIN-SUFFIX,cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY             # 기본 규칙: 위에서 매칭되지 않은 트래픽은 PROXY 그룹으로

설정을 직접 수정한 후에는 클라이언트에서 설정을 다시 불러오거나 커널을 재시작해야 적용됩니다. 구독형 설정은 매번 업데이트할 때 서비스 제공업체가 내려주는 내용으로 덮어씌워지므로, 장기적으로 커스터마이징하려면 클라이언트가 제공하는 '오버라이드/Merge' 기능을 사용하는 것을 권장합니다. DNS 관련 필드(nameserver, fallback 등)는 다소 복잡하여 별도 문서 《Clash DNS 설정 항목별 해설》에서 다룹니다.

TROUBLESHOOT

문제 해결

절차대로 진행했는데도 문제가 발생하면 먼저 여기서 해당 항목을 찾아보세요. 각 항목은 '증상 → 원인 → 해결'로 구성되어 있습니다.

구독 업데이트가 실패하고 타임아웃 또는 404 오류가 표시됨

먼저 두 가지 원인을 구분하세요. 404 또는 403이 표시되는 경우: 링크 자체가 만료된 것이므로 서비스 제공업체 패널로 돌아가 최신 링크를 다시 복사하세요. 일부 패널은 개편 후 기존 링크가 전부 무효화되기도 합니다. 타임아웃이 표시되는 경우: 구독을 다운로드하는 이 요청 자체가 네트워크에서 차단된 것이므로, 대부분의 클라이언트가 제공하는 '프록시로 구독 업데이트' 옵션을 사용 가능한 노드가 있는 상태에서 켜고 다시 업데이트하세요. 처음 가져올 때 사용할 수 있는 노드가 전혀 없다면 다른 네트워크 환경(예: 휴대폰 테더링)에서 먼저 한 번 가져오기를 완료하세요.

구독 가져오기는 성공했지만 프록시 페이지에 노드가 없음

보통 구독 내용이 비어 있거나 형식이 맞지 않는 경우입니다. 구독 목록에서 해당 설정의 파일 크기를 확인하거나 내용을 편집해 보세요. proxies 항목이 빈 배열이면 서비스 제공업체가 내려준 설정 자체에 노드가 없다는 뜻이며(요금제 만료 시 흔함) 클라이언트와는 무관합니다. 파일 내용이 YAML이 아니라 HTML이라면 링크가 구독 API가 아니라 웹페이지를 가리키고 있다는 뜻이므로 패널로 돌아가 'Clash' 형식으로 표시된 링크를 다시 복사하세요.

클라이언트에는 연결됨으로 표시되지만 브라우저에서 웹페이지가 열리지 않음

경로 순서대로 세 곳을 확인하세요. 첫째, '시스템 프록시' 스위치가 실제로 켜져 있는지 확인하세요(클라이언트가 실행 중이라고 해서 시스템 프록시가 반드시 적용된 것은 아닙니다). 둘째, 작동 여부 확인 절의 curl 명령어로 테스트해 보세요. 명령어는 통과하는데 브라우저가 안 된다면 브라우저에 자체 프록시 설정 기능이 있는 확장 프로그램이 설치되어 Clash와 충돌하는지 확인하세요. 셋째, 명령어도 타임아웃되면 노드를 바꿔서 다시 시도하세요—개별 노드 장애가 가장 흔한 원인입니다.

시작 오류 bind: address already in use

혼합 포트(기본값 7890)가 다른 프로세스에 의해 사용 중인 경우로, 시스템에 프록시 클라이언트가 두 개 동시에 설치되어 있거나 이전에 종료할 때 프로세스가 남아 있는 경우 흔히 발생합니다. 해결 방법은 두 가지입니다: 사용 중인 프로세스를 찾아 종료하거나, 설정에서 mixed-port를 사용하지 않는 다른 포트(예: 7891)로 변경하세요. 세 플랫폼별 프로세스 찾기 명령어와 포트 변경 방법은 전용 문서를 참고하세요.

노드 지연 시간 테스트가 전부 타임아웃되거나 수치가 계속 오르내림

전부 타임아웃되는 경우: 먼저 다이렉트 모드로 로컬 네트워크 자체가 정상인지 확인한 뒤 구독이 만료되었는지 확인하세요. 네트워크가 정상이고 구독도 유효하다면 대부분 서비스 제공업체 측 노드에 전반적인 장애가 발생한 것이므로 기다리거나 서비스 제공업체에 문의하세요. 수치가 크게 흔들리는 경우: 지연 시간 테스트는 테스트 순간의 경로 상태를 반영하는 것으로 로컬 네트워크와 노드 부하 양쪽의 영향을 받으므로, 여러 번 테스트한 값의 중간값을 기준으로 판단하고 단 한 번의 최저값에 집착하지 마세요. 성수기 시간대에 전반적으로 높게 나오는 것은 정상적인 현상입니다.

TUN 모드를 켰더니 오히려 전체 네트워크가 끊김

TUN 모드는 클라이언트의 시스템 서비스와 DNS 하이재킹 설정에 의존합니다. 먼저 처음 켤 때의 권한 승인/서비스 설치 단계가 모두 완료되었는지 확인하세요(Clash Verge Rev는 시스템 서비스 설치가 필요하고, FlClash는 관리자 권한이 필요합니다). 여전히 문제가 있다면 TUN을 끄고 시스템 프록시 모드로 돌아가 기본 경로가 정상 작동하는지 확인한 뒤, 설정의 dns 항목에 enhanced-mode: fake-ip가 활성화되어 있는지 확인하세요—TUN 모드는 보통 이 옵션과 함께 사용해야 하며 자세한 작성 방법은 DNS 설정 전용 문서를 참고하세요.

설정을 완료한 뒤

여러 기기 간 설정을 동일하게 유지하는 방법(구독 일괄 배포 / WebDAV 백업 / 수동 내보내기)은 《여러 기기 간 Clash 설정 동기화 방법 비교》를 참고하세요. 아직 어떤 클라이언트를 사용할지 정하지 못했다면 클라이언트 비교 가이드로 돌아가 비교한 뒤 설치하세요.

다운로드 페이지로 이동 전체 글 보기
Clash 클라이언트 다운로드