Clash 설정 가이드
구독 가져오기 및 연결 확인

설정 가져오기 → 모드 선택 → 연결 활성화 → 트래픽 확인 순서로 진행하세요. 먼저 연결을 확인한 뒤 DNS, TUN, 사용자 지정 규칙을 설정합니다.

시작하기 전에 현재 코어와 호환되는 구독 URL이나 사용 가능한 로컬 YAML 설정을 준비하세요. 클라이언트는 설정을 읽고 코어를 실행해 시스템 트래픽을 연결합니다. 클라이언트만 설치한다고 프록시 노드가 생기지는 않습니다. 구독 유효 기간, 노드 사용 가능 여부, 설정 권한은 제공업체가 관리합니다. 다른 프록시 클라이언트와 VPN은 잠시 끄고 일반 네트워크 연결만 유지해 트래픽 경로가 서로 덮어쓰지 않도록 하세요.

설정은 한 번에 하나씩만 변경하세요. 각 단계가 끝나면 확인할 수 있는 결과가 있습니다. 예상과 다르면 현재 단계에서 멈춰 점검하고, 스위치를 연달아 바꾸며 해결하려 하지 마세요. 아래 순서는 첫 연결을 만드는 데 적합합니다. 설정 문법과 네트워크 스택은 연결이 확인된 뒤 살펴봐도 됩니다.

01 구독 또는 로컬 설정 가져오기

클라이언트를 실행하고 사이드바 또는 하단 메뉴에서 ‘설정’이나 ‘구독’ 화면으로 이동합니다. 처음에는 목록이 비어 있을 수 있습니다. ‘새로 만들기’, ‘추가’ 또는 더하기 버튼을 눌러 URL 가져오기를 선택하세요. 제공업체가 안내한 구독 URL 전체를 붙여넣고 알아보기 쉬운 로컬 이름을 입력한 뒤 ‘저장’, ‘다운로드’ 또는 ‘가져오기’를 누릅니다. 이름은 로컬 목록에서 항목을 구분하는 용도이며 URL에 포함된 노드에는 영향을 주지 않습니다.

붙여넣기 전에 URL 앞뒤에 공백이나 줄바꿈이 있는지, 메신저가 문장 부호를 덧붙이지 않았는지 확인하세요. 제공업체가 Clash용 또는 현재 코어와 호환된다고 안내한 구독을 사용해야 합니다. 계정 로그인 페이지, 주문 페이지, 일반 웹 주소는 구독 URL이 아닙니다. 구독 URL에는 접근 정보가 포함되는 경우가 많으므로 공개 댓글, 스크린샷, 온라인 변환 사이트에 전체 URL을 올리지 마세요. 도움을 요청할 때는 URL 매개변수와 개인 정보를 먼저 가리세요.

파싱이 끝난 뒤 설정 활성화

가져오는 동안 클라이언트는 보통 원격 콘텐츠를 다운로드한 다음 YAML 구조를 확인합니다. 성공하면 설정 목록에 새 항목이 표시됩니다. 자동으로 활성화되지 않았다면 해당 항목의 ‘사용’, ‘활성화’ 또는 선택 버튼을 누르세요. 이어서 ‘프록시’ 화면에서 설정에 정의된 정책 그룹이 표시되는지 확인합니다. 목록에 이름이 보이는 것만으로는 코어가 설정을 불러왔다고 단정할 수 없습니다. 정책 그룹이 정상적으로 표시되고 로그에 오류가 계속 쌓이지 않는지 확인하세요.

로컬 파일을 가져오려면 같은 화면에서 ‘파일에서 가져오기’를 선택한 뒤 저장해 둔 .yaml 또는 .yml 파일을 고릅니다. 휴대폰에서는 먼저 시스템 파일 관리 앱에 파일을 저장한 뒤 파일 선택기로 여세요. 공유 메뉴에서 가져올 수 있는지는 클라이언트에 따라 다릅니다. 가져온 설정은 파일의 사본일 수 있으므로 원본 파일을 수정해도 반영되지 않을 수 있습니다. 다시 가져오거나 클라이언트의 로컬 설정을 수정해야 합니다.

가져오기에 실패하면 이 단계에서 점검

다운로드 시간 초과가 발생하면 먼저 일반 네트워크가 작동하는지 확인한 다음 구독 만료 여부와 제공업체 서비스 상태를 살펴보세요. 형식 파싱 오류가 나면 설정 내용이 맞는지, 로그인 안내나 웹페이지 텍스트를 받은 것은 아닌지 확인합니다. 현재 코어에서 지원하지 않는 필드에 의존하는 설정인지도 살펴보세요. 알 수 없는 키를 함부로 삭제하지 마세요. 저장에 성공해도 설정이 온전하다는 뜻은 아닙니다.

첫 구독을 가져올 때 아직 설정하지 않은 프록시 연결에 의존하지 마세요. 현재 네트워크에서 구독 주소에 접속할 수 없다면 제공업체가 안내한 대체 주소를 사용하거나 신뢰할 수 있는 기기에서 로컬 설정을 받아 가져오세요. 구독 형식 차이는 용어 안내의 설정 및 구독 설명에서 확인할 수 있습니다. 업데이트 실패에 대한 자세한 점검 방법은 구독 업데이트 실패 점검 목록을 참고하세요. 이 단계가 끝나면 현재 활성화된 설정을 유지하고 출구 방식을 선택합니다.

02 프록시 모드와 출구 노드 선택

‘개요’ 또는 ‘프록시’ 화면에서 ‘출구 모드’나 ‘모드’ 설정을 찾습니다. 처음에는 ‘규칙’을 선택하는 것이 좋습니다. 코어 설정값은 보통 rule입니다. 이 모드에서는 설정에 적힌 규칙 순서에 따라 각 연결을 직접 연결, 프록시 정책 그룹 또는 다른 동작으로 처리합니다. 모든 요청이 같은 노드를 거치는 것은 아니므로 이후 일부 연결에 DIRECT가 표시되어도 프록시가 작동하지 않는다는 뜻은 아닙니다.

‘전역’ 모드는 일반적인 출구 연결을 전역 정책에 맡기는 방식입니다. 노드 연결 상태를 일시적으로 점검하거나 모든 트래픽을 같은 경로로 보내야 할 때 적합하지만, 트래픽이 코어에 들어오는지 여부 등 다른 조건의 영향도 받습니다. ‘직접 연결’ 모드는 직접 연결을 우선하므로 프록시 노드의 작동 여부를 확인하는 데 사용할 수 없습니다. 일상적으로 설정에 따라 트래픽을 분배하려면 먼저 규칙 모드를 사용하고, 확인을 마친 뒤 다른 모드가 필요한지 판단하세요.

모드 선택 후 정책 그룹의 출구도 지정

‘프록시’ 화면으로 이동해 기본 프록시 정책 그룹을 펼칩니다. 그룹 이름은 현재 설정에 따라 ‘프록시’, ‘노드 선택’ 또는 용도에 맞는 이름으로 표시될 수 있습니다. 이름만 보고 역할을 짐작하지 말고 설정 설명이나 그룹 안의 선택지를 확인하세요. 수동 선택 그룹이라면 현재 사용할 수 있는 노드를 눌러 선택 표시가 해당 노드에 나타나게 합니다. 그룹이 다른 그룹을 참조한다면 하위 그룹도 열어 최종 출구가 실수로 직접 연결이나 거부로 설정되지 않았는지 확인하세요.

설정에 자동 선택 그룹이 있다면 우선 기본 정책을 그대로 사용해도 됩니다. 다만 자동 선택은 설정에 지정된 탐지 대상에 따라 동작하며, 모든 웹사이트 접속을 보장하지는 않습니다. 클라이언트의 ‘테스트’ 또는 ‘지연 시간 테스트’로 확실히 접속할 수 없는 노드를 우선 걸러낼 수 있습니다. 테스트 실패는 탐지 주소나 네트워크 제한 때문일 수도 있으므로 테스트 수치 하나만으로 모든 연결을 판단하지 마세요.

구독 규칙은 그대로 두고 설정 변경이 서로 상쇄되지 않게 하기

처음 설정할 때 규칙을 다시 작성하거나 용도별 그룹을 전부 수동으로 바꿀 필요는 없습니다. 먼저 기본 프록시 그룹에 사용할 수 있는 출구가 있는지 확인하고, 자주 쓰는 앱 그룹이 예상한 정책을 참조하는지 살펴보세요. 그룹 선택은 보통 새 연결부터 적용됩니다. 이미 연결된 장시간 연결은 기존 출구를 계속 사용할 수 있으므로, 바꾼 뒤에는 새 요청을 보내 확인하세요. 재생 중인 페이지 하나만 보고 판단하지 마세요.

구독 설정과 클라이언트의 덮어쓰기 설정에서 같은 규칙을 동시에 수정하지 마세요. 병합 방식은 클라이언트마다 다르며 화면의 선택지가 원본 YAML을 직접 변경하는 것도 아닙니다. 정책 그룹, DIRECT, 규칙 적용 관계는 규칙 및 트래픽 분배 용어에서 확인할 수 있습니다. 그룹 유형, 규칙 세트, 덮어쓰기를 직접 설정하려면 고급 설정 안내서를 참고하세요. 이 단계가 끝나면 현재 모드와 기본 프록시 그룹, 실제로 선택된 출구를 설명할 수 있어야 합니다.

03 연결 및 트래픽 경로 활성화

설정과 노드를 선택한 뒤 개요 화면으로 돌아갑니다. 클라이언트에 ‘코어 시작’ 버튼이 따로 있다면 먼저 눌러 실행 상태가 안정될 때까지 기다린 다음 트래픽 연결을 켭니다. 앱 실행 시 코어가 자동으로 시작되는 클라이언트도 있고, ‘연결’ 버튼 하나로 모두 실행되는 클라이언트도 있습니다. 핵심은 코어 실행과 시스템 또는 앱의 트래픽 전달을 구분하는 것입니다. 코어가 실행 중이면 요청을 처리할 수 있고, 시스템이나 앱이 트래픽을 코어로 전달해야 실제 요청이 프록시를 거칠 수 있습니다.

데스크톱: 먼저 시스템 프록시 켜기

Windows, macOS 또는 데스크톱 프록시 설정을 지원하는 Linux 환경에서는 먼저 클라이언트의 ‘시스템 프록시’를 켭니다. 보통 로컬 주소와 포트를 직접 입력할 필요 없이 클라이언트가 자체 수신 설정을 시스템 프록시에 적용합니다. 첫 연결에서는 TUN을 끄고 LAN 연결도 켜지 마세요. 우선 로컬 브라우저에서 가져온 설정으로 요청을 보내는 것이 목표입니다. 동시에 바뀌는 요소를 줄여 문제를 쉽게 파악할 수 있습니다.

시스템 프록시를 켠 뒤 브라우저에서 새 탭을 열어 요청을 보냅니다. 브라우저에 프록시 관리 확장 프로그램이 있다면 먼저 시스템 프록시를 따르는 모드로 전환하세요. 프록시 주소를 수동으로 입력한 적이 있다면 다른 클라이언트의 포트로 고정되어 있지 않은지도 확인합니다. 일부 Linux 데스크톱 환경이나 앱은 시스템 프록시 설정을 따르지 않습니다. 이런 경우 스위치가 켜져 있어도 모든 앱이 연결된 것은 아니므로 시스템 프록시를 명확히 지원하는 브라우저로 먼저 확인하세요.

시스템 프록시를 따르지 않는 앱을 처리해야 할 때만 TUN을 고려하세요. TUN에는 서비스 구성 요소, 관리자 권한 또는 라우팅 설정이 필요할 수 있으므로 켜기 전에 현재 클라이언트의 안내를 읽어보세요. TUN은 ‘전역 모드’와 같은 뜻이 아닙니다. TUN은 어떤 트래픽이 코어로 들어오는지를 정하고, 규칙 또는 전역 모드는 들어온 트래픽의 출구 처리를 결정합니다. 자세한 설정은 고급 설정 안내서의 TUN 및 Fake-IP 설명을 참고하세요.

모바일: 현재 클라이언트의 VPN 연결 허용

Android와 iOS에서는 보통 ‘연결’을 누르면 시스템 VPN 권한 창이 나타납니다. 앱 이름이 방금 설치한 클라이언트와 일치하는지 확인한 뒤 VPN 연결 추가 또는 설정을 허용하세요. 클라이언트로 돌아와 연결됨 상태가 될 때까지 기다립니다. 시스템 상태 표시줄이나 설정 화면에 VPN 표시가 나타날 수도 있습니다. 이 표시는 터널이 설정되었다는 뜻일 뿐, 노드 연결이나 규칙에 따른 요청 처리가 확인된 것은 아니므로 다음 단계에서 검증해야 합니다.

휴대폰에서 다른 VPN, VPN 기반 필터링 도구 또는 업무용 프로필을 사용 중이라면 현재 연결과 시스템 트래픽 경로를 함께 사용하려는지 먼저 확인하세요. 앱을 전환한 뒤 연결이 자주 끊길 때는 시스템 배터리 관리, 백그라운드 실행 권한 또는 클라이언트의 백그라운드 안내를 살펴보세요. 처음부터 시스템 권한을 무더기로 변경하지 마세요. 일부 클라이언트는 앱별 연결 설정도 제공합니다. 브라우저가 제외되어 있으면 연결 상태가 정상으로 보여도 해당 브라우저 트래픽은 클라이언트를 거치지 않습니다.

연결한 뒤에는 클라이언트를 계속 실행 상태로 두고 바로 종료하지 마세요. 이제 설정, 출구 선택, 트래픽 경로라는 세 가지 조건을 갖췄습니다. 다음 단계에서는 스위치 색상만 보고 성공 여부를 판단하지 말고 실제 요청을 확인합니다.

04 규칙 적용 및 연결 결과 확인

브라우저에서 새 탭을 열고 정상적으로 접속할 수 있으며 프록시 규칙이 적용될 것으로 예상되는 사이트에 접속합니다. 이미 캐시된 페이지는 네트워크에 문제가 있어도 표시될 수 있으므로 기존 페이지 새로고침만으로 확인하지 마세요. 그런 다음 클라이언트의 ‘연결’ 화면으로 돌아가 방금 접속한 도메인이나 대상 주소를 찾습니다. 검색 기능이 있다면 도메인으로 필터링하세요. 해당 기록의 생성 시간이 방금 요청한 시각과 맞는지 확인한 뒤 적용된 규칙, 정책 경로, 최종 출구를 살펴봅니다.

제대로 확인하려면 양쪽을 모두 살펴야 합니다. 브라우저에서 새 요청이 완료되고 클라이언트에도 예상한 처리 경로가 표시되어야 합니다. 규칙이 프록시 그룹을 가리킨다면 최종 출구는 방금 선택한 노드나 그룹 안에서 실제로 선택된 노드여야 합니다. 규칙이 직접 연결을 가리키면 DIRECT가 표시되는 것이 정상입니다. 모든 요청에서 출구 IP가 바뀌어야 한다고 생각하지 마세요. 규칙 모드에서는 대상마다 다른 경로를 사용할 수 있습니다.

증상에 따라 점검하고 여러 설정을 동시에 바꾸지 않기

브라우저의 새 연결이 클라이언트에 전혀 표시되지 않으면 먼저 3단계로 돌아가 트래픽 경로를 확인하세요. 시스템 프록시가 켜져 있는지, 브라우저 확장 프로그램이 설정을 덮어쓰는지, 모바일 VPN 연결이 유지되는지, 해당 앱이 제외되어 있지 않은지 살펴봅니다. 일부 연결 기록은 금방 사라질 수 있으므로 요청을 보내면서 로그도 함께 확인하세요. 먼저 트래픽이 코어에 들어오는지 확인한 뒤 노드를 점검해야 순서가 뒤바뀌지 않습니다.

연결은 표시되지만 페이지가 열리지 않으면 최종 출구가 예상한 설정인지 확인하세요. 그룹을 잘못 선택했다면 2단계로 돌아가 수정합니다. 출구가 올바른데 시간 초과가 발생하면 사용 가능하다고 확인된 다른 노드로 바꾸고 새 요청을 보내세요. 로그에 도메인 이름 해석 실패가 명확히 표시될 때는 DNS 설정을 확인하고, 출처를 모르는 설정을 통째로 복사해 넣지 마세요. 로그의 도메인, 구독 주소, 연결 정보에는 개인 정보가 포함될 수 있으므로 공유 전에 불필요한 내용을 삭제하세요.

특정 앱에서만 작동하지 않으면 해당 앱이 시스템 프록시를 따르는지, 자체 프록시 설정이 있는지, 기존 연결이 남아 있는지 확인하세요. 브라우저에서 성공했다고 모든 앱이 연결된 것은 아닙니다. 더 넓은 범위의 트래픽을 처리해야 한다면 클라이언트 안내에 따라 TUN을 별도로 설정하고 같은 검증 절차를 다시 진행하세요. 규칙 우선순위, DNS, 라우팅을 자세히 점검하려면 고급 사용법을 참고하세요. 첫 연결 단계에서 모든 설정을 끝낼 필요는 없습니다.

연결 확인 후 업데이트 및 종료 방식 점검

설정 화면으로 돌아가 구독 항목의 업데이트 메뉴를 찾아 현재 사용 중인 설정을 업데이트하는지 확인하세요. 원격 구독은 수동 새로고침이나 클라이언트 설정에 따른 자동 업데이트를 지원하는 경우가 많습니다. 로컬 파일은 원격 업데이트가 지원되지 않을 수 있습니다. 업데이트한 뒤 활성 설정과 기본 정책 그룹 선택이 유지되는지 확인하고 새 요청을 보내세요. 로컬 변경 사항을 계속 유지하려면 클라이언트가 지원하는 덮어쓰기 기능을 사용하세요. 원격 구독 사본을 직접 수정하면 업데이트 중 변경 사항이 사라질 수 있습니다.

마지막으로 연결을 끄는 방법을 확인하세요. 데스크톱에서는 시스템 프록시를 먼저 끈 뒤 클라이언트를 종료합니다. TUN을 사용했다면 해당 트래픽 경로도 끄세요. 모바일에서는 연결 해제를 누르고 시스템 VPN 상태도 종료되었는지 확인합니다. 트레이에서 ‘창 닫기’를 눌러도 화면만 숨겨지고 코어는 계속 실행 중일 수 있습니다. 종료 후 일반 웹페이지도 열리지 않는다면 시스템 프록시가 중지된 로컬 수신 포트를 계속 가리키는지 확인하고 원래 설정으로 복원한 뒤 다시 테스트하세요.

특정 필드의 의미를 확인하려면 먼저 용어 안내를 참고하세요. 규칙 세트 관리, 여러 구독 병합 또는 외부 컨트롤 패널 설정이 필요하다면 고급 설정 안내서를 확인하세요. 일상적인 연결과 설정 관리를 분리하면 문제가 생겼을 때 검증된 상태로 돌아가기도 쉽습니다.