QUICK START / CLASH

Clash 사용법

구독 가져오기 → 프록시 모드 선택 → 연결 활성화 → 작동 확인. 클라이언트와 유효한 구독이 있다면 이 순서대로 첫 설정을 마칠 수 있습니다.

서비스 제공업체에서 받은 구독 주소 전체 또는 클라이언트 커널과 호환되는 YAML 설정 파일을 준비하세요. 클라이언트 자체에는 사용할 수 있는 프록시 노드가 포함되어 있지 않습니다. 프로그램만 설치해서는 구독이나 노드 설정을 대신할 수 없습니다. 이 가이드는 브라우저의 첫 접속을 확인 대상으로 삼습니다. 복잡한 분기 규칙과 DNS 설정은 config.yaml 설정 참고를 확인하세요.

1단계: 구독을 가져와 설정 활성화

클라이언트를 열고 ‘구독’, ‘설정’ 또는 비슷한 설정 관리 화면으로 이동해 ‘추가’, ‘가져오기’나 더하기 메뉴를 찾으세요. 구독 주소를 사용하는 경우 링크 가져오기를 선택하고 URL 입력란에 주소 전체를 붙여 넣습니다. 여러 설정을 구분할 수 있도록 이름을 지정해도 됩니다. 이름은 구독 내용에 영향을 주지 않습니다. 주소 앞뒤에 공백이나 줄바꿈이 없고 메신저에서 복사할 때 문장 부호가 붙지 않았는지 확인한 뒤 저장 또는 다운로드를 누르세요.

구독 주소는 서비스 제공업체의 홈페이지나 계정 로그인 페이지와 다릅니다. 올바른 주소를 열면 설정 데이터나 클라이언트가 읽을 수 있는 구독 데이터가 반환됩니다. 웹페이지 주소를 붙여 넣으면 HTML이 표시되거나 형식 오류가 발생할 수 있습니다. 복사할 때는 서비스 제공업체가 안내한 Clash 또는 mihomo 호환 구독 링크를 사용하세요. 주소에 계정 인증 정보가 포함될 수 있으므로 전체 링크를 공개 게시판에 올리거나 주소가 보이는 전체 화면 캡처를 문제 해결용으로 업로드하지 마세요.

저장한 뒤 구독 다운로드가 끝날 때까지 기다리세요. 클라이언트에 따라 새 설정이 자동으로 활성화되기도 하고, 설정 항목을 누르거나 체크 표시 또는 ‘사용’ 버튼을 눌러야 하기도 합니다. 현재 설정 표시가 있는지 확인한 다음 ‘프록시’ 화면으로 이동하세요. 설정에 포함된 정책 그룹과 선택 항목이 보이면 가져오기가 완료되고 설정이 다음 단계까지 로드된 것입니다. 구독 이름만 표시되는 것으로는 해당 파일이 현재 실행 설정으로 적용됐다고 볼 수 없습니다.

로컬 YAML 파일 사용

설정 파일을 받았다면 가져오기 메뉴에서 ‘파일에서 가져오기’를 선택해 로컬의 .yaml 또는 .yml 파일을 연 다음 현재 설정으로 지정하세요. YAML 전체 내용을 구독 URL 입력란에 붙여 넣으면 안 됩니다. 로컬 파일 가져오기는 일반적으로 그 시점의 내용만 저장합니다. 업데이트 출처를 별도로 지정하지 않았다면 서비스 제공업체의 구독과 함께 자동으로 업데이트된다고 가정하지 마세요.

처음 가져올 때는 노드 비밀번호, 프로토콜 필드, 규칙을 바로 수정하지 않는 것이 좋습니다. 먼저 원본 설정으로 연결하면 문제를 확인할 범위를 줄일 수 있습니다. 클라이언트에서 지원하지 않는 필드라는 오류가 나오면 해당 구독 형식이 커널 요구사항과 맞는지 확인하세요. 오류가 난 줄을 곧바로 삭제하면 안 됩니다. 일부 노드 프로토콜이나 필드는 mihomo 지원이 필요해 구형 클라이언트에서 읽지 못할 수 있습니다. 클라이언트 선택 가이드를 먼저 확인한 뒤 클라이언트를 바꿀지 결정하세요.

다운로드 실패 시 먼저 구독 출처 확인

시간 초과, 인증 실패 또는 구문 분석 오류가 발생하면 먼저 기기가 인터넷에 정상적으로 연결되어 있는지 확인한 뒤 구독 주소를 다시 복사하세요. 인증 오류는 서비스 제공업체의 계정 페이지에서 링크가 아직 유효한지 확인해야 하는 경우가 많습니다. 구문 분석 오류라면 구독 형식을 잘못 선택하지 않았는지 살펴보세요. 자동 업데이트 간격은 일단 기본값으로 두고 짧은 시간 안에 반복해서 새로고침하지 마세요. 오류별 자세한 해결 방법은 구독 업데이트 실패 문제 해결을 참고하세요.

이 단계가 끝나면 현재 어떤 설정이 활성화되어 있는지 확인할 수 있고, 프록시 화면에서 정책 그룹도 찾을 수 있어야 합니다. 다음으로 요청을 어떻게 분기할지 정한 뒤 시스템 네트워크 연결을 활성화하세요. 그러면 첫 연결부터 경로를 확인할 수 있습니다.

2단계: 규칙 모드와 정책 그룹 선택

홈 화면, 프록시 화면 또는 모드 설정에서 ‘규칙’, ‘전역’, ‘직접 연결’ 옵션을 찾으세요. 처음에는 규칙 모드를 선택하는 것이 좋습니다. 설정의 mode: rule에 해당하며, 커널로 들어온 요청을 rules 순서대로 확인한 뒤 규칙에 지정된 노드·정책 그룹 또는 직접 연결로 보냅니다. 규칙 모드는 모든 웹사이트의 용도를 자동으로 판별하는 기능이 아닙니다. 실제 동작은 현재 설정의 규칙에 따라 달라집니다.

‘전역’ 모드는 커널로 들어온 요청을 전역 정책 그룹으로 보내며, 보통 해당 그룹에서 출구를 선택해야 합니다. ‘직접 연결’ 모드는 커널로 들어온 요청을 대상에 직접 연결합니다. 여기서 선택하는 모드는 커널이 요청을 받은 뒤 처리하는 방식을 정할 뿐, 모든 앱의 트래픽을 커널로 보내지는 않습니다. 따라서 전역 모드를 선택했더라도 게임이나 명령줄 도구 등 다른 앱이 프록시를 사용한다고 단정할 수 없습니다.

화면의 모드해당 설정값첫 설정에서의 용도
규칙rule구독에 포함된 분기 규칙을 따릅니다. 시작 설정으로 적합합니다.
전역global규칙과 출구 문제를 임시로 비교할 때 사용합니다. 전역 그룹을 선택해야 합니다.
직접 연결direct커널로 들어온 요청을 직접 연결합니다. 클라이언트가 꺼진다는 뜻은 아닙니다.

정책 그룹을 펼쳐 출구 선택

모드를 규칙으로 설정한 뒤 ‘프록시’ 화면에서 설정에 포함된 주요 선택 그룹을 펼치세요. 그룹 이름은 구독 작성자가 정하므로 한국어일 수도 영어일 수도 있으며, 반드시 ‘PROXY’라고 표시되는 것은 아닙니다. 직접 선택할 수 있는 그룹을 찾아 사용할 노드를 선택하세요. 해당 설정 유형은 보통 type: select입니다. 그룹 안에 다른 정책 그룹이 포함되어 있다면 하위 그룹도 펼쳐 최종 출구가 예상한 대로 선택되어 있는지 확인하세요.

대상 그룹에서 DIRECT가 선택되어 있으면 해당 그룹을 참조하는 요청은 직접 연결됩니다. 차단 출구를 선택하면 요청이 실패할 수 있습니다. 특정 노드 옆에 선택 표시가 있는지만 확인하지 말고, 규칙에서 실제로 그 그룹을 참조하는지도 확인하세요. url-test와 같은 자동 선택 그룹은 보통 설정된 테스트 로직에 따라 클라이언트가 노드를 고릅니다. 이런 그룹을 수동 선택 목록처럼 조작할 필요는 없습니다.

클라이언트에 지연 시간 테스트 버튼이 있다면 한 번 실행해 노드가 지정된 테스트 요청에 응답하는지 확인할 수 있습니다. 결과는 테스트 주소와 당시 네트워크 상태만 반영하며 모든 웹사이트에 접속할 수 있다는 뜻도, 실제 다운로드 속도도 아닙니다. 여러 노드를 연달아 바꾼 뒤 어느 설정이 적용됐는지 추측하지 마세요. 하나를 선택한 채 다음 단계에서 연결을 설정하고, 실제 웹 요청과 연결 기록으로 확인하세요.

일부 클라이언트는 이전 정책 그룹 선택을 기억합니다. 구독을 바꾼 뒤에는 이름이 같더라도 노드 구성이 같다고 가정하지 말고 현재 선택을 다시 확인하세요. 그룹 간 참조 관계를 알아야 한다면 정책 그룹 필드 참고를 확인하세요. 처음 설정할 때는 대상 그룹에 사용할 수 있는 출구가 명확히 선택되어 있는지만 확인하면 됩니다.

3단계: 시스템 프록시 또는 VPN 연결 활성화

이제 설정이 로드되었고 모드와 정책 그룹도 정했습니다. 앱의 요청을 클라이언트로 보내려면 네트워크 연결을 활성화해야 합니다. 클라이언트에 ‘실행 중’이라고 표시되어도 커널이 시작되었다는 뜻일 뿐, 브라우저가 프록시를 사용하고 있다는 보장은 없습니다. PC 시스템 프록시, 모바일 VPN, TUN은 서로 다른 트래픽 유입 경로입니다. 규칙 모드와 혼동하지 말고 첫 연결부터 모든 스위치를 함께 켜지 마세요.

PC: 먼저 시스템 프록시 사용

Windows 또는 macOS 클라이언트의 홈 화면, 설정 또는 트레이 메뉴에서 ‘시스템 프록시’를 찾아 켜세요. 일반적으로 시스템 HTTP/HTTPS 프록시가 로컬 호스트의 수신 주소와 포트를 가리키도록 설정됩니다. 처음 연결을 확인할 때는 시스템 프록시 설정을 따르는 브라우저를 사용하고 클라이언트는 계속 실행해 두세요. macOS에서 네트워크 설정 변경을 허용하라는 메시지가 표시될 수 있습니다. 안내를 읽고 설치한 클라이언트가 요청한 것인지 확인한 뒤 허용하세요.

Linux 데스크톱 환경마다 시스템 프록시 지원 방식이 다릅니다. 클라이언트에서 시스템 프록시를 켰는데도 브라우저 연결 기록이 없다면 데스크톱 네트워크 설정이나 브라우저 자체의 프록시 설정을 확인하세요. 직접 설정할 때 로컬 주소는 보통 127.0.0.1이며, 포트는 클라이언트에 현재 표시된 수신 포트를 사용해야 합니다. 예시 포트가 모든 설치 환경에 고정되어 있다고 보면 안 됩니다. mixed-port를 사용하면 같은 포트에서 HTTP와 SOCKS 요청을 모두 받을 수 있지만, 앱에서 올바른 프록시 유형을 선택해야 합니다.

처음 사용할 때는 ‘LAN에서 연결 허용’을 켤 필요가 없습니다. 로컬 브라우저에서 로컬 프록시를 사용하는 것과 다른 기기가 PC의 프록시에 접속하도록 하는 것은 별개의 기능입니다. 브라우저 연결을 확인하려고 TUN까지 켤 필요도 없습니다. TUN은 가상 네트워크 인터페이스, 라우팅, DNS와 관련되므로 기본 연결을 확인한 뒤 별도로 설정하세요. 구체적인 필드와 권한은 설정 참고의 네트워크 연결 항목을 확인하세요.

모바일: 시스템 VPN 설정 허용

Android 또는 iOS 클라이언트에서 ‘시작’, ‘연결’ 또는 기본 스위치를 누르세요. 첫 연결 시 시스템에 VPN 설정 추가 또는 연결 요청이 표시될 수 있습니다. 앱 이름을 확인하고 허용한 뒤 시스템 안내에 따라 기기 인증을 완료하고 클라이언트로 돌아와 연결 상태를 확인하세요. 시스템에 VPN 표시가 나타나면 해당 네트워크 연결이 설정된 것입니다. 프록시 노드를 통해 출구로 나가는지는 2단계에서 선택한 모드·규칙·정책 그룹에 따라 달라집니다.

테스트하는 동안 다른 VPN이나 프록시 도구는 연결을 끊어 라우팅 충돌을 피하세요. Android에서 앱별 프록시나 우회 목록을 설정했다면 테스트할 브라우저가 제외되지 않았는지 확인하세요. 휴대전화를 잠근 뒤 연결이 끊기는 경우에만 클라이언트의 백그라운드 실행과 시스템 배터리 제한을 살펴보면 됩니다. 처음 연결하기 전에 모든 백그라운드 설정을 한꺼번에 변경할 필요는 없습니다.

스위치를 켜자마자 다시 꺼진다면 먼저 ‘로그’에서 시작 직후의 오류를 확인하세요. 포트 충돌, 설정 구문 분석 실패, 시스템 권한 미승인은 해결 방법이 서로 다릅니다. 오류 내용과 발생 위치만 기록하고 설정 전체를 공개하지 마세요. 클라이언트가 계속 실행되고 연결 스위치가 켜진 상태를 유지하면 마지막 단계로 넘어가세요. 상태 아이콘만 확인해서는 점검이 끝난 것이 아닙니다.

4단계: 요청이 예상한 출구로 나가는지 확인

브라우저를 열어 HTTPS로 정상 접속되는 웹페이지에 새 요청을 보내세요. 이미 열려 있는 페이지는 캐시를 사용하거나 기존 연결 경로를 계속 쓸 수 있으므로 화면만 확인하지 마세요. 새 탭을 열어 대상 주소를 다시 불러온 다음 바로 클라이언트의 ‘연결’ 화면으로 돌아가 방금 보낸 요청을 도메인이나 프로세스로 검색하세요.

먼저 연결 기록을 확인하고 출구 IP를 비교

클라이언트에서 규칙과 출구 경로를 확인할 수 있다면 세 가지를 점검하세요. 대상 도메인이 방금 접속한 사이트와 일치하는지, 어떤 규칙이 적용됐는지, 최종적으로 어떤 노드 또는 직접 연결을 사용했는지 확인합니다. 규칙 모드에서는 일부 사이트가 DIRECT로 연결되는 것이 정상일 수 있으므로 직접 연결 기록을 모두 실패로 보면 안 됩니다. 프록시를 사용할 것으로 예상되는 대상을 골라 지정한 정책 그룹에 들어갔는지, 그룹 경로를 따라 최종 출구가 무엇인지 확인하세요.

출구 IP를 비교해야 한다면 같은 네트워크에서 연결 전후에 신뢰할 수 있는 IP 확인 페이지가 표시하는 공인 IP를 비교하세요. 브라우저를 닫았다가 다시 열어 이전 연결이 재사용되지 않도록 합니다. IP가 달라지는 것은 여러 확인 근거 중 하나일 뿐입니다. 확인 페이지가 규칙에 따라 직접 연결되면 IP가 바뀌지 않아도 모든 프록시 요청이 실패했다고 볼 수 없습니다. 웹페이지에 표시된 지역명만으로 결론 내리지 말고 출구 결과와 클라이언트 연결 기록을 함께 확인하세요.

로그와 연결 화면에는 접속한 도메인 같은 정보가 포함될 수 있습니다. 문제를 확인할 때는 테스트 요청에 필요한 부분만 남기세요. 공유하기 전 구독 주소, 계정 정보, 관련 없는 접속 기록을 삭제하세요. 확인이 끝나면 임시로 켠 상세 로그를 꺼 불필요한 기록이 계속 쌓이지 않도록 하세요.

작동하지 않으면 연결 경로 순서대로 다시 확인

  1. 프록시 화면에 정책 그룹이 표시되지 않음: 구독 가져오기 단계로 돌아가 다운로드가 끝났고 설정이 활성화되었는지 확인하세요. 시스템 네트워크 설정부터 변경하지 마세요.
  2. 브라우저 접속 기록이 없음: 시스템 프록시 또는 모바일 VPN이 켜져 있는지, 브라우저가 시스템 프록시를 우회하는지, 앱별 규칙에서 제외되었는지 확인하세요. 연결 기록은 금방 사라질 수 있으니 요청을 다시 보내면서 확인하세요.
  3. 기록은 있지만 직접 연결됨: 현재 모드, 적용된 규칙, 정책 그룹 선택을 확인하세요. 비교를 위해 전역 모드를 잠시 사용한다면 전역 그룹을 선택하고 테스트 후 규칙 모드로 되돌리세요.
  4. 프록시 기록은 있지만 요청 실패: 같은 대상을 유지한 채 사용할 수 있는 다른 노드로 바꿔 다시 시도하고 관련 로그를 확인하세요. 노드 테스트에 성공했다고 대상 웹사이트 접속까지 성공하는 것은 아닙니다.

한 번에 하나의 설정만 바꾸고 새 요청을 보내야 원인을 찾기 쉽습니다. 브라우저는 되지만 다른 앱이 작동하지 않는다면 첫 연결 절차는 완료된 것입니다. 이후에는 해당 앱이 시스템 프록시를 지원하는지, 별도 프록시 설정을 사용하는지, 다른 트래픽 유입 경로가 필요한지 확인하세요. DNS, Fake-IP, TUN, 규칙 재정의 설정은 첫 연결 단계에서 다루지 않습니다. 관련 문법은 config.yaml 설정 참고를 확인하세요.

사용 종료 및 다음 실행

PC에서 클라이언트를 종료할 때는 먼저 시스템 프록시를 끈 다음 프로그램을 종료하세요. 시스템 프록시가 켜진 채 클라이언트가 종료되면 요청이 더 이상 수신되지 않는 로컬 포트로 전달되어 브라우저가 갑자기 인터넷에 연결되지 않을 수 있습니다. 모바일에서는 클라이언트의 중지 또는 연결 해제 버튼으로 종료하세요. 시스템에서 항상 켜짐 VPN이나 VPN 연결이 없을 때 연결 차단 옵션을 사용 중이라면 현재 사용 방식에 맞는지 확인하세요.

다음에 실행하면 먼저 현재 설정과 정책 그룹 선택이 유지되어 있는지 확인한 뒤 네트워크 연결을 활성화하세요. 구독이 업데이트되면 노드와 규칙이 달라질 수 있습니다. 업데이트 후 문제가 생기면 설정 파일 전체를 덮어쓰기보다 해당 정책 그룹을 다시 확인하세요. 연결 화면에서 실제 요청에 적용된 규칙과 최종 출구를 확인하면 이번 빠른 시작 절차가 완료됩니다.