TEN-MINUTE SETUP

Clash 최초 연결 단계

“구독 가져오기 → 프록시 모드 선택 → 연결 설정 → 결과 확인” 순서로 기본 설정을 완료합니다. 이 가이드는 처음 사용할 때 필요한 작업만 다루며, YAML 필드, DNS 세부 설정 및 규칙 문법은 설정 문서에서 별도로 설명합니다.

플랫폼별 화면 안내

Clash Plus, Clash Verge Rev, FlClash, Clash Meta for Android 등은 클라이언트마다 메뉴 이름이 완전히 같지 않습니다. 데스크톱에서는 보통 “설정”, “프록시”, “시스템 프록시”가 주요 메뉴이며, 모바일에서는 “구독”, “정책”, “시작” 또는 “연결”로 표시될 수 있습니다. 이름이 달라도 작업 순서는 같습니다. 먼저 설정을 현재 설정으로 지정하고, 정책을 선택한 다음 시스템 프록시 또는 VPN 연결을 켭니다.

PRE-FLIGHT CHECK

시작 전 확인

A

클라이언트와 운영체제 일치 여부

Windows, macOS, Android, iOS 및 Linux용 설치 패키지는 서로 바꿔 사용할 수 없습니다. 먼저 설치 패키지 페이지에서 운영체제에 맞는 탭으로 이동한 뒤 그래픽 클라이언트를 선택합니다. 일반적인 데스크톱 및 모바일 사용에는 mihomo 코어를 별도로 다운로드할 필요가 없습니다.

B

구독 주소 사용 가능 여부

구독 주소는 보통 네트워크 서비스 제공업체가 안내하며 Clash 클라이언트가 자동으로 생성하지 않습니다. 복사할 때는 전체 프로토콜, 경로 및 매개변수를 유지하고 링크 중간에서 잘라 복사하지 않도록 합니다. 주소는 설정 인증 정보이므로 공개 페이지나 스크린샷에 게시해서는 안 됩니다.

C

기본 네트워크 정상 여부

기존 프록시, 다른 VPN 또는 유사 클라이언트를 잠시 끈 다음 브라우저에서 평소 직접 접속할 수 있는 웹사이트를 엽니다. 이때 이미 인터넷이 끊겼다면 먼저 로컬 네트워크를 복구해야 합니다. 그렇지 않으면 이후 문제의 원인이 기본 연결인지 프록시 설정인지 판단하기 어렵습니다.

PROFILE INPUT

구독 설정 가져오기

구독 가져오기의 목적은 링크를 저장하는 데 그치지 않습니다. 클라이언트가 설정 내용을 가져오고 해당 설정을 현재 실행 설정으로 전환해야 합니다.

구독 또는 설정 메뉴 열기

클라이언트를 실행한 뒤 “설정”, “Profiles”, “구독 관리” 또는 “설정 파일” 메뉴를 찾습니다. 데스크톱 클라이언트에서는 보통 왼쪽 탐색 메뉴에 있고, 모바일 클라이언트에서는 홈 화면 상단이나 사이드 메뉴에 있습니다. 들어가면 원격 구독, 로컬 파일, 새 설정 등의 항목이 표시될 수 있습니다. 이번에는 빈 YAML을 직접 만드는 대신 링크로 가져오기를 선택합니다.

클라이언트를 처음 열었을 때 코어 또는 서비스 모드를 선택하라는 메시지가 나오면 기본 추천 항목으로 초기화를 완료합니다. Windows 클라이언트는 서비스 설치나 시스템 프록시 변경을 위해 관리자 권한을 요청할 수 있고, macOS는 시스템 암호 입력을 요구할 수 있습니다. Android와 iOS의 VPN 권한 요청은 보통 연결 단계에서 표시됩니다. 권한 요청을 거부했더라도 반복해서 재설치할 필요는 없으며, 나중에 시스템 설정에서 다시 허용할 수 있습니다.

전체 주소 붙여 넣고 업데이트 실행

구독 입력란에 주소를 붙여 넣고 링크 시작 부분이 클라이언트에서 지원하는 네트워크 프로토콜인지 확인합니다. 주소 앞뒤에 불필요한 공백이나 줄바꿈이 없는지도 확인한 뒤 “가져오기”, “다운로드”, “업데이트” 또는 “저장”을 클릭합니다. 일부 클라이언트는 설정 이름을 요구할 수 있습니다. 서비스 이름이나 용도처럼 알아보기 쉬운 이름을 사용하고, 구독 주소 자체가 이름으로 표시되지 않도록 합니다.

정상적으로 처리되면 클라이언트가 설정을 다운로드하고 목록에 새 항목을 추가합니다. 설정 항목 옆에 업데이트 시간, 트래픽 정보 또는 업데이트 버튼이 표시되는 경우가 있지만 구독마다 제공하는 필드가 다르므로 특정 항목이 없다고 해서 곧바로 실패한 것은 아닙니다. 더 확실한 판단 기준은 설정을 선택할 수 있고, 프록시 페이지에서 정책 그룹과 노드 목록이 보이며, 클라이언트에 YAML 구문 분석 오류가 표시되지 않는지입니다.

새 설정을 현재 설정으로 지정

가져오기가 완료된 후에도 해당 설정을 클릭하거나 오른쪽 메뉴에서 “선택”, “활성화”, “활성 설정으로 지정”을 실행해야 합니다. 일부 클라이언트는 가져온 뒤 자동으로 전환하지만, 일부는 설정 저장소에 추가만 하고 바로 활성화하지 않습니다. 프록시 페이지가 여전히 비어 있다면 연결 단계로 넘어가지 말고 설정 목록으로 돌아가 현재 선택된 이름을 확인합니다.

가져오는 중 다운로드 실패, 응답 내용 이상 또는 구성 파싱 실패가 표시되면 먼저 주소를 다시 복사한 뒤 브라우저에서 링크가 여전히 내용을 반환하는지 확인하세요. 서비스 제공자가 생성한 YAML 들여쓰기는 임의로 수정하지 마세요. 계속 실패하면 도움말 센터의 설치 및 구성과 문제 해결 항목을 확인하세요. 구성에서 proxies, proxy-groups, rules의 관계를 이해해야 한다면 구성 필드 참고서를 확인하세요.

ROUTING MODE

프록시 모드 및 정책 선택

모드는 요청이 규칙과 어떻게 일치하는지 결정하고, 정책 그룹은 일치한 요청을 어떤 노드나 직접 연결 경로로 보낼지 결정합니다. 처음 연결할 때는 먼저 규칙 모드를 사용합니다.

먼저 Rule 규칙 모드 선택

“프록시”, “Proxies” 또는 “정책” 페이지로 이동해 모드 전환 항목을 찾습니다. 일반적인 선택지는 규칙, 전역 및 직접 연결입니다. 처음에는 Rule 또는 “규칙” 모드를 권장합니다. 클라이언트가 설정 상단부터 규칙을 확인하고 도메인, IP, 프로세스 또는 규칙 집합에 따라 연결을 지정된 정책 그룹, DIRECT 또는 REJECT로 전달합니다. 이 방식은 일반적으로 구독 설정이 의도한 작동 방식이기도 합니다.

전역 모드는 대부분의 연결을 하나의 프록시 정책으로 보내므로 특정 노드의 작동 여부를 짧게 확인할 때 유용하지만, 최초 설정의 유일한 테스트 방식으로는 적합하지 않습니다. 직접 연결 모드는 프록시를 우회하며 로컬 접속을 일시적으로 복구하거나 비교 점검할 때 사용합니다. 세 모드의 전체 차이, 규칙 우선순위 및 일치 과정은 용어 안내서설정 필드 참고서에서 확인할 수 있습니다.

주요 정책 그룹에서 노드 선택

규칙 모드를 선택하면 보통 “노드 선택”, “자동 선택”, “해외 트래픽”, “스트리밍” 또는 구독 제공업체가 지정한 이름의 정책 그룹이 여러 개 표시됩니다. 먼저 주요 프록시 트래픽을 담당하는 정책 그룹을 찾고 들어가 명확한 노드 하나를 선택합니다. 그룹에 노드, 자동 테스트 그룹 및 다른 하위 정책이 함께 있다면 첫 테스트에서는 단일 노드를 직접 선택해 자동 테스트 상태가 판단에 미치는 영향을 줄입니다.

노드 이름에는 지역, 프로토콜, 배율 또는 회선 표시가 포함될 수 있습니다. 지연 시간은 한 번 탐색했을 때의 응답 시간만 나타내며, 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 이름이 명확하고 상태를 테스트할 수 있으며 지연 시간이 시간 초과로 표시되지 않는 노드를 우선 선택합니다. 첫 번째 노드 연결에 실패하면 같은 모드를 유지한 채 다른 노드로 바꿔 테스트해 문제가 해당 노드에 국한되는지 확인합니다.

기존 직접 연결 및 거부 규칙 유지

정책 페이지에 DIRECT 또는 REJECT가 보인다고 해서 설정이 잘못된 것은 아닙니다. DIRECT는 해당 규칙에 맞는 요청을 로컬 네트워크로 직접 연결한다는 뜻이고, REJECT는 규칙에 따라 연결을 거부한다는 뜻입니다. “모든 트래픽을 프록시로 보내기” 위해 모든 정책 그룹을 하나씩 수정하지 마세요. 로컬 서비스, 로컬 네트워크 주소 및 일부 시스템 연결에는 직접 연결이 필요한 경우가 많습니다. 처음에는 주요 노드 선택만 조정하고 나머지 그룹은 설정에서 제공한 기본값을 유지합니다.

정책 그룹이 완전히 비어 있거나 모든 그룹이 사용할 수 없음으로 표시되면 이전 단계로 돌아가 현재 설정을 올바르게 선택했는지 확인하고 구독을 한 번 업데이트합니다. 클라이언트에서 규칙 프로바이더 다운로드 실패를 보고하면 노드는 표시되더라도 분할 라우팅 규칙을 완전히 불러오지 못할 수 있습니다. 이때는 장기 연결을 바로 시작하지 말고 네트워크, 규칙 주소 및 설정 호환성을 먼저 점검합니다.

모드 및 노드 선택 완료 다음 단계: 연결 설정 →
SYSTEM LINK

시스템 프록시 연결 설정

클라이언트가 설정을 불러온 뒤에는 운영체제가 네트워크 요청을 Clash로 전달하도록 해야 합니다. 데스크톱에서는 보통 시스템 프록시를 사용하고, 모바일에서는 일반적으로 로컬 VPN 터널을 만듭니다.

데스크톱에서 시스템 프록시 켜기

Windows, macOS 또는 Linux 그래픽 클라이언트의 홈 화면, 설정 페이지나 트레이 메뉴에서 “시스템 프록시” 또는 “System Proxy” 스위치를 찾아 켭니다. 스위치를 켜면 클라이언트가 운영체제의 프록시 주소를 로컬 수신 포트로 지정합니다. 이때 클라이언트를 계속 실행해야 합니다. 클라이언트를 종료하기 전에는 시스템 프록시를 먼저 꺼서 운영체제가 더 이상 수신하지 않는 로컬 포트를 가리키지 않도록 합니다.

Windows에서 스위치가 계속 켜져 있지 않다면 먼저 클라이언트에 시스템 설정을 변경할 권한이 있는지 확인하고, 다른 프록시 도구가 시스템 프록시를 동시에 관리하고 있지 않은지도 확인합니다. 일부 Microsoft Store 앱은 UWP 네트워크 격리 방식을 사용하므로 브라우저가 연결되더라도 해당 앱은 로컬 프록시에 접속하지 못할 수 있습니다. 이런 경우 도움말 센터 문제 해결에서 Clash UWP 루프백 처리 방법을 확인합니다.

macOS에서 처음 네트워크 프록시를 변경할 때 시스템 인증 창이 나타날 수 있으며, 안내에 따라 확인하면 됩니다. Linux 데스크톱 환경의 시스템 프록시 구현은 통일되어 있지 않습니다. GNOME, KDE 및 다른 데스크톱은 서로 다른 설정을 읽을 수 있고, 터미널 프로그램이 데스크톱 프록시를 자동으로 사용하지 않을 수도 있습니다. 시작 단계에서는 먼저 브라우저로 확인하고, 명령줄 환경 변수, 투명 프록시 및 서비스 실행은 고급 사용법이므로 설정 필드 문서와 사용 중인 클라이언트 설명을 참조합니다.

모바일에서 VPN 연결 허용

Android 또는 iOS 클라이언트에는 보통 눈에 잘 띄는 시작 버튼이 있습니다. 버튼을 누르면 시스템에서 VPN 설정 또는 연결 요청을 표시합니다. 권한을 허용하면 상태 표시줄에 VPN 아이콘이 나타나고 클라이언트 홈 화면도 중지 상태에서 연결됨으로 바뀝니다. 이 터널은 기기 내부에서 트래픽을 프록시 코어로 전달하므로 Wi-Fi 프록시 주소를 다시 입력할 필요가 없습니다.

시스템 권한 창이 나타나지 않으면 다른 VPN 연결이 이미 있는지 확인합니다. 모바일 운영체제는 보통 활성 VPN 터널을 하나만 허용하므로 기존 연결이 끊기지 않은 상태에서는 새 클라이언트가 시작되지 않을 수 있습니다. 먼저 시스템 설정에서 기존 VPN을 중지한 뒤 Clash 클라이언트로 돌아가 다시 연결합니다. 배터리 절약 설정으로 화면이 꺼진 뒤 백그라운드 실행이 제한될 수도 있습니다. 잠금 후 연결이 끊긴다면 시스템 배터리 설정에서 해당 클라이언트의 지속 실행을 허용합니다.

클라이언트 실행 상태 확인

스위치를 켠 뒤 다른 설정을 바로 변경하지 말고 클라이언트 상태를 먼저 확인합니다. 정상 상태에는 메인 페이지에 시작됨 또는 연결됨 표시, 올바른 현재 설정 이름, 연결 기록이 나타나기 시작하는 로그가 포함됩니다. 스위치를 켜자마자 다시 꺼진다면 상단 오류 메시지나 로그 마지막 몇 줄을 확인하고 포트 사용 중, 코어 시작 실패, 설정 분석 오류 및 권한 부족을 중점적으로 살펴봅니다.

포트가 사용 중일 때는 다른 Clash 인스턴스가 백그라운드에서 실행 중이거나 이전 클라이언트가 종료된 뒤 프로세스가 남아 있는 경우가 많습니다. 먼저 다른 프록시 클라이언트를 완전히 종료한 뒤 현재 클라이언트를 다시 시작합니다. 필드 용도를 모르는 상태에서 여러 포트를 연속으로 변경하지 마세요. 한 번에 하나의 원인만 처리해야 어떤 작업으로 연결이 복구됐는지 판단할 수 있습니다.

시스템 프록시 또는 VPN 시작됨 다음 단계: 연결 확인 →
CONNECTION CHECK

프록시 작동 여부 확인

확인할 때는 기본 네트워크, 대상 사이트 접속 및 규칙 일치 여부를 함께 점검해야 합니다. 연결 스위치가 켜져 있다는 사실만으로 특정 요청이 예상한 정책을 거쳤다고 볼 수는 없습니다.

두 그룹으로 나누어 접속 비교

클라이언트를 실행한 상태에서 먼저 로컬 네트워크로 평소 접속할 수 있는 웹사이트를 열어 페이지가 정상적으로 로드되는지 확인합니다. 그다음 프록시 규칙이 필요한 대상 사이트를 엽니다. 첫 번째 그룹은 직접 연결 경로와 기본 DNS가 손상되지 않았는지 확인하고, 두 번째 그룹은 프록시 노드가 연결을 설정할 수 있는지 확인합니다. 두 그룹이 모두 성공해야 기본 설정이 대체로 완료된 것입니다.

테스트할 때는 브라우저의 새 시크릿 창을 사용하거나 대상 페이지를 완전히 닫았다가 다시 열어 이전 캐시로 인한 오판을 피하는 것이 좋습니다. 여러 브라우저, 다운로드 도구 및 동영상 앱으로 동시에 많은 연결을 만들지 마세요. 최초 확인에서는 명확한 요청 몇 개만 유지해야 로그를 읽기 쉽습니다.

연결 기록 및 규칙 일치 확인

클라이언트의 “연결”, “Connections” 또는 “로그” 페이지로 돌아가 방금 대상 사이트에 접속하면서 생성된 기록을 찾습니다. 연결 항목에는 보통 대상 도메인, 일치한 규칙, 정책 그룹 및 최종 노드가 표시됩니다. 대상 요청이 예상한 정책 그룹으로 전달되고 방금 선택한 노드를 사용했다면 규칙 경로가 설정대로 작동한 것입니다.

대상 사이트가 열리지만 기록에 DIRECT로 표시된다면 프록시가 작동하지 않는다고 단정하기 전에 해당 규칙이 원래 직접 연결을 요구하는지 확인합니다. 대상 사이트가 열리지 않고 REJECT로 표시되면 요청이 거부 규칙과 일치한 것입니다. 프록시 노드를 사용했지만 연결 시간이 초과되면 같은 정책 그룹에서 노드를 바꾼 뒤 동일한 테스트를 반복합니다. 규칙 이름, 정책 그룹 및 노드는 서로 다른 세 계층이므로 각각 따로 확인해야 합니다.

정해진 순서로 실패 원인 점검

두 그룹의 웹사이트가 모두 열리지 않으면 먼저 시스템 프록시를 끄거나 VPN 연결을 끊고 로컬 네트워크가 복구되는지 확인합니다. 복구되면 문제는 클라이언트, 설정 또는 노드에 있을 수 있고, 복구되지 않으면 먼저 기기 네트워크를 처리해야 합니다. 일반 사이트만 열리고 대상 사이트가 실패할 때는 현재 모드, 정책 그룹 선택, 노드 상태 및 로그 오류를 순서대로 확인합니다. 노드를 바꿔도 계속 실패하면 구독 만료, DNS 이상 또는 규칙 프로바이더 로드 실패를 점검합니다.

데스크톱 브라우저는 성공하지만 특정 독립 앱만 실패한다면 해당 앱이 시스템 프록시를 사용하지 않거나 다른 네트워크 스택을 사용하는 경우가 많습니다. 먼저 앱이 시스템 프록시를 지원하는지 확인하고 설정 전체를 전역 모드로 바꾸지는 마세요. 실제로 트래픽 가로채기가 필요할 때 TUN 모드를 검토합니다. 모바일에서 일부 앱만 실패한다면 앱이 비공개 DNS를 사용하는지, 이전 연결을 캐시하고 있는지, 시스템이 해당 앱에 VPN 적용을 제한하는지 확인합니다.

로그에 연결 실패가 한두 건 나타났다고 해서 전체 사용에 반드시 영향을 주는 것은 아닙니다. 웹페이지는 여러 도메인에 동시에 요청할 수 있으며 광고, 통계 또는 사용할 수 없는 리소스는 규칙에 의해 거부될 수 있습니다. 주요 페이지가 로드되는지, 핵심 도메인에 어떤 규칙이 적용됐는지, 실패가 계속 반복되는지를 중점적으로 확인합니다. 일반적인 오류별 대응은 도움말 센터에서, 전체 필드 의미는 설정 필드 참고서에서 확인할 수 있습니다.

최초 연결 확인 완료 이후 조정 확인 →
AFTER INITIAL SETUP

연결 완료 후 조정 순서

기본 연결이 안정된 뒤 자동 업데이트, 시작 동작 및 고급 네트워크 기능을 하나씩 추가합니다. 매번 한 종류의 설정만 변경하고, 변경 후 접속 및 로그 확인을 반복합니다.

01 / UPDATE

구독 업데이트 설정

구독 제공업체의 업데이트 주기에 맞춰 자동 업데이트를 설정하거나 설정 페이지에서 정기적으로 수동 업데이트합니다. 업데이트 후 현재 설정이 이전 사본으로 바뀌지 않았는지 확인합니다.

설치 및 설정 질문 확인 →
02 / STARTUP

시작 시 자동 실행 설정

수동 연결이 안정적인지 확인한 뒤 클라이언트 자동 실행을 켭니다. “클라이언트 시작”과 “시작 후 자동 연결”은 서로 다르므로, 기기 부팅 시 이전 프록시 상태가 의도치 않게 유지되지 않도록 구분해야 합니다.

사용 팁 확인 →
03 / CONFIG

설정 필드 읽기

포트, DNS, 정책 그룹, 규칙 또는 재정의 파일을 수정해야 한다면 먼저 필드 계층과 YAML 들여쓰기를 이해한 뒤 설정 사본에서 조정합니다.

설정 필드 참고서 열기 →
04 / TERMS

핵심 용어 확인

mihomo, Fake-IP, 규칙 프로바이더, 정책 그룹 및 DIRECT 같은 개념을 만났다면 먼저 정의를 확인한 다음 기존 설정을 수정할지 결정합니다.

용어 안내서 열기 →