Clash 사용 가이드
구독 가져오기와 연결 확인

시작 전: 클라이언트와 설정 준비

클라이언트를 설치한 뒤 한 번 실행해 기본 창이 열리고 코어에서 계속 오류가 발생하지 않는지 확인합니다. 이 가이드는 신뢰할 수 있는 출처에서 받은 구독 링크나 현재 코어에 맞는 YAML 설정 파일이 있다는 전제로 설명합니다. 클라이언트는 설정을 읽고 규칙을 적용해 연결을 구성하는 프로그램입니다. 클라이언트만 설치한다고 사용할 수 있는 프록시 서비스가 자동으로 제공되지는 않습니다. 서비스 사이트의 로그인 주소만 있다면 로그인 페이지 주소를 가져오지 말고, 해당 서비스의 구독 페이지에서 설정 링크를 먼저 받으세요.

처음 설정할 때는 시스템 프록시나 VPN을 이미 사용 중인 다른 프로그램을 종료하고, 클라이언트의 DNS, 수신 포트, 네트워크 스택 옵션은 일단 기본값으로 둡니다. 이렇게 하면 문제가 생겼을 때 현재 설정만 확인하면 됩니다. 구독 링크에는 계정 정보가 포함될 수 있으므로 공개 게시판에 올리거나 스크린샷에 전체 주소를 노출하지 마세요. 오류를 설명할 때는 오류 유형과 발생 단계만 기록하고, 로그를 공유하기 전에 링크의 민감한 부분을 삭제하세요.

아래에서는 메뉴 이름을 기능에 따라 설명하므로 화면에 표시된 문구와 정확히 같지 않을 수 있습니다. 비슷한 이름을 찾았다면 ‘설정 관리’, ‘프록시 선택’, ‘네트워크 설정’ 중 어디에 해당하는지 먼저 확인하세요. 용어가 헷갈리면 용어 설명을 참고하세요. 이 페이지에서는 첫 연결에 필요한 작업만 다루며, 모든 코어 매개변수를 미리 이해할 필요는 없습니다.

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

왼쪽 탐색 메뉴나 하단 메뉴에서 ‘설정’ 페이지로 이동해 ‘새로 만들기’, ‘가져오기’ 또는 구독 주소 입력란을 찾습니다. 구독 링크 전체를 복사해 붙여넣고, 앞뒤에 공백이나 줄바꿈, 메신저에서 붙은 문장부호가 없는지 확인한 다음 다운로드하거나 가져옵니다. 이름을 입력하라는 메시지가 표시되면 알아보기 쉬운 이름을 사용하세요. 이름은 보통 클라이언트에서 구분하기 위한 표시일 뿐, 규칙 적용에는 영향을 주지 않습니다. 요청이 완료되어 목록에 새 설정 항목이 나타날 때까지 기다립니다.

설정 항목이 나타나면 현재 사용할 설정으로 지정해야 합니다. 보통 항목을 클릭하거나 ‘사용’을 선택하거나, 항목 메뉴에서 ‘활성화’를 누르면 됩니다. 다운로드가 끝난 것과 설정이 불러와진 것은 다르므로 화면의 선택 표시를 확인하세요. 다음으로 ‘프록시’ 페이지를 열어 설정에 정의된 프록시 그룹과 그룹 내 노드가 표시되는지 확인합니다. 구독마다 그룹 이름이 다르므로 Proxy라는 이름의 항목을 찾을 필요는 없습니다.

로컬 YAML 파일을 받았다면 ‘파일 가져오기’ 또는 파일 선택 메뉴를 사용하세요. 파일 경로를 구독 URL 입력란에 붙여넣거나 파일 확장자를 바꿔 형식을 변환하지 마세요. 로컬 설정은 구독 서비스 업데이트에 따라 자동으로 변경되지 않는 경우가 많습니다. 원격 구독은 설정 항목 메뉴에서 업데이트할 수 있습니다. 처음에는 한 번 직접 업데이트가 성공하는지 확인한 뒤 자동 업데이트 간격을 설정하면 가져오기 오류와 예약 작업 오류를 구분하기 쉽습니다.

가져온 뒤 형식 오류가 표시되면 먼저 클라이언트 메시지를 읽어 보세요. 서버가 로그인 페이지나 오류 페이지, 개별 노드 목록을 반환한다면 Clash YAML로 사용할 수 없는 형식일 수 있습니다. 브라우저에서 링크가 열린다고 해서 형식이 호환되는 것은 아닙니다. 제공업체에 현재 클라이언트 또는 mihomo 코어를 지원하는 링크인지 확인하고, 비공개 구독을 출처가 불분명한 변환 사이트에 제출하지 마세요. 다운로드 시간 초과가 표시되면 일반 네트워크가 정상인지 먼저 확인하고 제공업체의 대체 링크가 있는지 살펴보세요.

완료 기준: 설정 항목이 선택되어 있고, 프록시 페이지에 해당 설정의 프록시 그룹이 표시되며, 로그에 설정 파싱 오류가 계속 나타나지 않습니다. 오류가 계속되면 더 많은 네트워크 스위치를 켜기 전에 도움말 센터의 설치 및 설정 분류에서 문제를 확인하세요. 설정이 정상적으로 불러와져야 다음 단계에서 모드를 선택할 수 있습니다.

2단계: 규칙 모드와 출구 선택

설정을 불러온 뒤 개요 페이지, 프록시 페이지 상단 또는 트레이 메뉴에서 모드 설정을 찾아 처음에는 ‘규칙’을 선택합니다. 이 모드는 설정에 포함된 규칙에 따라 연결을 직접 연결, 특정 프록시 그룹 또는 차단 정책으로 보냅니다. 모든 요청을 프록시로 보내는 스위치는 아니므로, 일부 연결에 DIRECT가 표시되어도 규칙에 따른 정상적인 동작일 수 있습니다. 우선 구독의 분할 연결 설정을 그대로 사용하고, 테스트를 위해 직접 연결 규칙을 삭제하거나 기본 규칙의 순서를 바꾸지 마세요.

‘프록시’ 페이지에서 프록시 출구를 담당하는 그룹을 펼칩니다. 수동 선택 그룹은 노드나 하위 그룹을 하나 선택해야 합니다. 자동 선택 그룹은 상태 검사와 그룹 알고리즘에 따라 출구가 정해집니다. 일부 구독은 웹사이트 분류 그룹을 다시 통합 선택 그룹에 연결하므로, 마지막 출구가 실제 노드인지 DIRECT인지 확인될 때까지 선택 항목을 따라가며 펼쳐 보세요. 그룹 이름은 설정 작성자가 정한 것이므로 이름만 보고 실제 출구를 판단하면 안 됩니다.

클라이언트에 연결 테스트 기능이 있다면 현재 프록시 그룹을 한 번 테스트한 뒤 연결 가능한 후보를 선택하세요. 테스트 결과는 테스트 주소와 제한 시간, 당시 네트워크 상태에 따라 달라집니다. 테스트 한 번의 결과일 뿐 모든 웹사이트 접속이나 다운로드 속도를 보장하지는 않습니다. 특정 노드가 시간 초과되면 같은 그룹의 다른 노드를 시험해 보세요. 모든 노드에서 실패한다면 시스템 프록시를 반복해서 클릭하지 말고 구독 유효성과 네트워크 연결을 확인하세요.

‘전역’ 모드는 코어로 들어온 요청을 전역 정책으로 보내므로 짧은 비교 테스트에 쓸 수 있지만, 모든 앱의 트래픽을 자동으로 가져오지는 않습니다. ‘직접 연결’ 모드는 코어에 들어온 요청을 대상에 직접 연결합니다. 처음 설정할 때는 규칙 모드를 유지하는 것이 좋습니다. 문제를 확인하려고 잠시 전역 모드로 바꿨다면 전역 그룹의 선택 항목도 확인하고, 테스트를 마친 뒤 규칙 모드로 되돌리세요. 전역 모드와 TUN 모드는 서로 다른 문제를 해결하므로 혼동하지 마세요.

완료 기준: 현재 모드가 규칙이고, 관련 프록시 그룹에 출구가 지정되어 있으며, 의도치 않게 직접 연결 항목이 선택되어 있지 않습니다. 이제 앱의 트래픽을 클라이언트로 전달할 수 있습니다. 규칙 순서, 프로토콜 차이, 자동 선택 그룹의 설계 방식은 프로토콜 및 코어 참고 자료에서 확인하세요. 첫 연결을 위해 미리 수정할 필요는 없습니다.

3단계: 시스템 프록시를 켜고 연결

먼저 개요나 코어 상태를 확인해 코어가 실행 중인지 살펴보세요. 화면에 코어 시작 실패가 표시되면 모드를 계속 바꾸지 말고 로그에서 관련된 첫 오류를 확인합니다. 코어가 정상적으로 실행되면 ‘설정’이나 트레이 메뉴에서 ‘시스템 프록시’를 켭니다. 일부 클라이언트에서는 개요 페이지의 빠른 설정으로 제공됩니다. 처음 연결을 확인할 때는 TUN을 끄고 시스템 프록시를 따르는 브라우저에서 요청을 보내세요. 권한, 가상 네트워크 어댑터, 라우팅 설정으로 인한 변수를 줄일 수 있습니다.

Windows에서는 시스템 설정의 프록시 페이지에 로컬 프록시 주소가 표시되는지 확인할 수 있습니다. macOS에서는 현재 네트워크 서비스의 프록시 설정에서 해당 항목을 확인하세요. 클라이언트에 실제로 설정된 값이 기준이며, 회사나 학교의 기존 네트워크 설정을 임의로 덮어쓰지 마세요. 클라이언트에서 스위치가 켜졌는데도 브라우저 연결 기록이 없다면 브라우저 확장 프로그램이 프록시를 따로 제어하는지, 앱이 자체 네트워크 설정을 사용하는지도 확인하세요. Linux는 앱마다 지원 여부가 달라 시스템 프록시 스위치가 명령줄 도구까지 적용되지 않을 수 있습니다.

앱에 프록시를 직접 입력해야 한다면 클라이언트 설정에서 수신 주소와 포트를 먼저 확인하세요. 아래 표는 흔히 볼 수 있는 설정 예시일 뿐, 모든 클라이언트의 기본값은 아닙니다. 화면에 다른 포트가 표시되면 실제 값을 입력하세요. 수신 주소가 루프백 주소라면 주로 같은 기기에서 접속할 때 사용하므로, 로컬 브라우저를 위해 LAN 접근을 켤 필요는 없습니다.

로그에 수신 포트가 사용 중이라고 표시되면 클라이언트를 중복 실행했거나 다른 프록시 프로그램이 백그라운드에서 실행 중인지 먼저 확인하세요. 포트를 점유한 프로그램을 종료한 뒤 코어를 다시 시작합니다. 다른 프로그램을 계속 사용해야 한다면 그때 수신 포트를 변경하세요. 포트를 바꾸면 클라이언트가 관리하는 시스템 프록시는 자동으로 업데이트될 수 있지만, 브라우저나 터미널 등에서 포트를 직접 입력했다면 각 앱에서도 값을 바꿔야 합니다. 그렇지 않으면 이전 포트로 계속 요청하게 됩니다.

Android와 iOS에서는 보통 연결을 누른 뒤 시스템 VPN 구성을 허용합니다. 시스템 권한 요청은 현재 사용하는 클라이언트에서 표시되어야 합니다. 데스크톱에서 브라우저 연결은 정상인데 특정 앱이 시스템 프록시를 따르지 않는다면 TUN 사용을 고려하세요. 켜기 전에 클라이언트의 서비스 설치 또는 권한 안내를 읽고 필요한 권한을 허용한 뒤 요청을 다시 보내세요. 처음부터 다른 VPN과 동시에 사용하지 마세요. TUN 호환성 문제는 도움말 센터에서 더 확인할 수 있습니다.

완료 기준: 코어가 정상적으로 실행 중이고 시스템 프록시가 켜져 있거나, 모바일에서 필요한 시스템 권한을 허용했습니다. 브라우저에서 새 요청을 보내 확인하세요. 이미 로드된 페이지를 보는 것만으로는 부족합니다. 기존 연결은 설정을 바꿔도 출구가 즉시 변경되지 않을 수 있습니다.

4단계: 규칙과 실제 출구 확인

먼저 클라이언트의 ‘연결’ 페이지를 연 다음 브라우저에서 새 탭을 열어 신뢰할 수 있는 HTTPS 페이지에 접속합니다. 연결 목록에 해당 도메인이나 대상 주소가 표시되는지 확인하고 필요하면 도메인 필터를 사용하세요. 페이지가 열렸다는 것은 이번 요청에 응답이 왔다는 뜻일 뿐, 프록시를 거쳤다는 증거는 아닙니다. 캐시, 직접 연결 규칙, 브라우저의 기존 연결이 결과에 영향을 줄 수 있습니다. 요청이 코어에 들어왔는지 확인하는 첫 단계는 연결 기록을 보는 것입니다.

새 연결을 열어 대상, 적용된 규칙, 프록시 체인을 차례로 확인합니다. 적용된 규칙이 특정 프록시 그룹을 가리킨다면 체인 끝에서 예상한 노드가 사용되는지도 살펴보세요. DIRECT가 표시되면 설정 실패로 단정하지 말고 해당 대상이 원래 직접 연결 범위인지 먼저 확인합니다. 현재 구독 규칙상 프록시를 사용해야 하는 대상으로 다시 테스트하고 규칙 설명과 비교하세요. 일부 클라이언트는 프록시 체인을 여러 단계로 표시하므로 최종 출구를 보려면 상세 정보를 펼쳐야 합니다.

연결 목록에 해당 기록이 전혀 없다면 요청이 아직 진행 중인지, 화면에 활성 연결만 표시되는지 먼저 확인하세요. 짧은 연결은 금방 사라질 수 있습니다. 페이지를 다시 열고 연결 필터를 지운 뒤 시스템 프록시와 브라우저 확장 프로그램을 점검합니다. 별도의 프록시 설정을 사용하는 앱이라면 주소, 포트, 프로토콜 종류를 확인하세요. 트래픽이 클라이언트에 들어오는지 확인하기도 전에 DNS를 바꾸거나 규칙 전체를 교체하면 어떤 변경이 효과를 냈는지 알기 어렵습니다.

연결 기록은 있지만 요청이 실패한다면 점검 범위는 규칙 출구, 노드 연결 가능성, DNS 결과로 좁혀집니다. 먼저 실제로 선택된 노드를 확인하고 같은 시각의 로그를 살펴보세요. 도메인 이름 확인 오류와 연결 시간 초과는 서로 다른 문제이므로 원래 오류 유형을 유지해 각각 처리해야 합니다. 문제를 찾기 위해 로그 수준을 일시적으로 높였다면 원인을 확인하는 데 필요한 부분만 수집하고, 점검 후에는 일반 수준으로 되돌리세요. 접속 대상이 포함된 상세 로그가 계속 쌓이지 않도록 주의하세요.

출구 IP 조회는 보조 확인 수단으로 사용할 수 있지만 조회 페이지 자체도 규칙의 영향을 받습니다. 같은 브라우저에서 접속해도 대상에 따라 출구가 다를 수 있으므로 조회 결과를 해당 페이지의 연결 기록과 함께 확인하세요. 웹페이지의 출구만으로 DNS가 예상대로 작동하는지 판단할 수 없고, 모든 앱이 같은 경로를 사용한다고 단정할 수도 없습니다. DNS 확인 경로, TUN 라우팅, 프로토콜 호환성을 더 자세히 살펴보려면 프로토콜 참고 자료를 확인하세요. 첫 연결 단계에서 모든 고급 설정을 한꺼번에 해결할 필요는 없습니다.

완료 기준: 새 요청이 연결 기록에 표시되고 적용된 정책이 예상과 일치하며 대상 페이지가 정상적으로 응답합니다. 여기까지 완료하면 첫 설정이 끝납니다. 구독을 업데이트한 뒤 그룹 이름이나 노드가 바뀌었다면 선택 항목을 다시 확인하세요. 사용을 중단할 때는 먼저 시스템 프록시를 끄거나 VPN 연결을 해제한 다음 클라이언트를 종료해야 합니다. 그렇지 않으면 앱이 종료된 로컬 포트로 계속 요청을 보낼 수 있습니다.

일상적인 사용: 재현 가능한 점검 순서 유지

평소 연결할 때는 모든 단계를 다시 진행할 필요가 없습니다. 현재 설정이 유효한지 확인하고, 프록시 그룹의 출구를 확인한 뒤 트래픽 처리 방식을 켜면 됩니다. 문제가 발생하면 ‘설정이 불러와졌는지, 모드가 올바른지, 요청이 들어오는지, 출구를 사용할 수 있는지’ 순서로 확인하세요. 한 번에 옵션 하나만 바꾸고 새 요청을 보내 기록을 확인하는 편이 노드, DNS, TUN 설정을 동시에 바꾸는 것보다 원인을 명확히 파악하기 쉽습니다.

구독을 업데이트하면 원격 설정의 규칙이나 노드가 바뀔 수 있습니다. 개인 설정은 클라이언트에서 제공하는 오버라이드 또는 병합 기능을 우선 사용하고, 업데이트 후 실제 적용된 설정을 확인하세요. 더 알아보려면 용어 설명에서 프록시 그룹과 규칙 유형을 살펴보고, 도움말 센터에서 구체적인 오류를 찾아보세요. 프로토콜 호환성과 사용 사례를 비교하려면 프로토콜 및 코어 참고 자료를 확인할 수 있습니다. 기본 기능을 사용하기 위해 모든 고급 옵션을 미리 수정할 필요는 없습니다.