QUICK START / 10 MINUTES
Clash 구독 가져오기 및 연결 설정 단계
“구독 가져오기 → 프록시 모드 선택 → 연결 활성화 → 결과 확인” 순서로 진행하세요. 처음에는 핵심 경로만 설정하고 복잡한 YAML 필드, DNS 오버라이드와 규칙 병합은 고급 구성 단계에서 처리합니다.
PREPARATION
시작 전 확인
사용할 수 있는 구독 주소를 준비하고 현재 운영체제에 맞는 Clash 클라이언트가 설치되어 있는지 확인하세요. 구독 주소는 일반적으로 https://로 시작하는 전체 URL이며, 예를 들면 https://example.com/api/v1/client/subscribe?token=xxxx와 같습니다. 복사할 때는 주소의 시작부터 마지막 문자까지 선택해야 합니다. 메신저에서 자동으로 축약된 부분만 복사하거나 주소 앞뒤의 안내 문구까지 함께 복사하지 마세요.
구독 주소는 프록시 노드, 정책 그룹, 규칙 등의 구성 내용을 클라이언트에 제공합니다. 브라우저에서 읽는 일반 웹페이지 주소가 아니므로 브라우저에서 직접 열면 텍스트가 표시되거나 다운로드가 시작될 수 있고, 서버 안내가 반환될 수도 있습니다. 이 가이드에서는 항상 클라이언트의 “구성”, “구독” 또는 “Profiles” 화면에서 주소를 추가해야 합니다. 아직 클라이언트를 정하지 않았다면 클라이언트 다운로드 페이지에서 Windows, macOS, Android 또는 iOS에 맞는 프로그램을 선택하세요.
클라이언트마다 메뉴 이름이 다를 수 있습니다. Windows와 macOS 클라이언트는 보통 “Profiles”, “구성” 또는 “구독”을 사용하며, Android 클라이언트는 “구성” 또는 “구독 관리”를 사용하는 경우가 많습니다. iOS 클라이언트는 일반적으로 앱 내부의 구성 메뉴에서 URL을 추가합니다. 버튼 위치는 달라도 주소 추가, 구성 저장, 내용 업데이트, 구성 선택의 순서는 같습니다.
처음 설정할 때는 같은 종류의 프록시 프로그램을 먼저 종료해 여러 앱이 시스템 프록시를 동시에 변경하거나 같은 포트를 점유하지 않도록 하세요. 기기에 프록시 서버를 수동으로 입력한 적이 있다면 기존 설정을 기록해 두고, 이 가이드를 마친 뒤 복원할지 판단하세요. Windows와 macOS 사용자는 현재 계정에 클라이언트를 실행할 권한이 있는지도 확인해야 합니다. Android와 iOS 사용자는 이후 VPN 라우팅을 활성화할 때 시스템이 로컬 VPN 연결을 생성하도록 허용해야 합니다.
이 페이지에서는 연결에 필요한 기본 작업만 다룹니다. 구성 파일의 port, mixed-port, dns, proxies, proxy-groups, rules 등의 필드는 Clash 구성 필드 참조에서 하나씩 확인할 수 있습니다. 우선 구독에서 생성된 기본 구조를 그대로 유지해 초기 설정의 변수를 줄이세요.
Clash 구독 가져오기
클라이언트를 연 뒤 먼저 구성 관리 메뉴를 찾으세요. Windows와 macOS 데스크톱 클라이언트는 보통 사이드바나 상단 탐색 메뉴에 “Profiles”, “구성” 또는 “구독”이라는 이름으로 배치합니다. Android 클라이언트는 대개 홈 화면에서 “구성”으로 이동한 뒤 오른쪽 위의 추가 버튼을 누릅니다. 화면에 들어가면 URL 가져오기, 로컬 파일 가져오기, 새 구성 만들기 등의 옵션이 표시됩니다. 이번에는 URL 또는 구독 주소 가져오기를 선택하고 로컬 YAML 파일은 선택하지 마세요.
“URL에서 가져오기”, “새 구독 만들기” 또는 의미가 비슷한 버튼을 누르세요. 이름과 주소를 모두 입력해야 한다면 이름에는 “일상 구독”처럼 알아보기 쉬운 짧은 이름을 적고, URL 입력란에는 전체 구독 주소를 붙여넣습니다. 일부 클라이언트는 자동 업데이트 간격도 표시합니다. 처음에는 기본값을 유지해 가져오기가 정상적으로 되는지 확인한 뒤 구독 서비스의 업데이트 주기에 맞춰 조정하세요.
붙여넣은 뒤 주소 양끝을 먼저 확인하세요. URL 앞에는 공백이 없어야 하며 끝에도 마침표, 한국어 문장 부호 또는 줄바꿈이 없어야 합니다. 확인했으면 “저장”, “가져오기” 또는 “다운로드”를 누르세요. 클라이언트가 구독 내용을 요청하고 응답을 로컬 구성으로 변환합니다. 정상이라면 구성 목록에 새 항목이 생기고 구성 이름과 업데이트 시간이 표시되며, 일부 클라이언트에는 업데이트 버튼도 나타납니다. 이때 해당 구성을 눌러 선택 상태로 만드세요. 가져오기만 하고 선택하지 않으면 클라이언트가 이전 구성을 계속 사용할 수 있습니다.
구성이 나타나면 즉시 수동 업데이트를 한 번 실행하세요. 데스크톱 클라이언트는 보통 구성 항목 오른쪽에 새로고침 버튼을 제공하고, 모바일 클라이언트는 구성을 길게 누르거나 항목 메뉴를 열어야 할 수 있습니다. 업데이트가 끝나면 성공 상태가 명확히 표시되는지 확인하고 업데이트 시간이 변경되었는지도 살펴보세요. 그런 다음 프록시 또는 정책 그룹 화면에서 정책 그룹 이름과 선택 가능한 프록시 노드가 나타나는지 확인합니다. 이 정보가 보이면 구독이 정상적으로 파싱되어 클라이언트에 로드된 것입니다.
가져오기를 눌러도 새 구성이 생기지 않으면 같은 항목을 반복해서 만들지 마세요. 주소 입력란으로 돌아가 다시 붙여넣고 클라이언트가 구독 주소에 접속할 수 있는 네트워크인지 확인하세요. 형식 오류가 표시되면 주소가 완전하지 않거나 구독이 만료되었거나 서버가 클라이언트에서 인식할 수 없는 내용을 반환했을 수 있습니다. 요청 시간이 초과되면 구독 서비스에 정상적으로 접속할 수 있는 네트워크로 바꾼 뒤 다시 시도하세요. 상태 코드, 빈 구독, 업데이트 실패에 대한 자세한 점검 방법은 도움말 센터에서 해당 문제를 확인할 수 있습니다.
프록시 모드 및 정책 그룹 선택
구독 로드가 완료되면 “프록시”, “Proxies” 또는 “모드” 화면으로 이동하세요. Clash의 일반적인 실행 모드에는 규칙, 전역, 직접 연결이 있습니다. 처음 설정할 때는 규칙 모드를 선택하는 것이 좋으며, 화면에는 보통 “Rule” 또는 “규칙”으로 표시됩니다. 이 모드는 구성 파일의 규칙 섹션에 따라 요청의 경로를 판단합니다. 프록시가 필요한 연결은 정책 그룹으로 보내고, 로컬 네트워크와 구성에서 직접 연결로 지정한 대상은 바로 연결합니다.
전역 모드는 라우팅 가능한 대부분의 트래픽을 하나의 프록시 정책으로 보내므로 규칙 매칭 때문에 문제가 생겼는지 짧게 확인할 때 유용하지만 모든 환경에서 고정으로 사용할 방식은 아닙니다. 직접 연결 모드는 대상에 직접 접속하며 프록시 경로를 잠시 중단하거나 비교 테스트할 때 사용합니다. 클라이언트 상단에 모드 전환기가 있다면 현재 강조된 항목이 “규칙”인지 확인하세요. 설정 메뉴에 드롭다운이 있다면 저장한 뒤 홈 화면으로 돌아가 상태 표시줄에도 Rule이 표시되는지 확인합니다.
모드를 선택한 직후 시스템 프록시를 바로 켜지 마세요. 먼저 프록시 화면에서 정책 그룹을 설정합니다. 구독에는 보통 “노드 선택”, “프록시”, “자동 선택” 또는 비슷한 이름의 정책 그룹이 포함됩니다. 최상위 주요 정책 그룹을 누른 뒤 사용할 수 있는 노드를 선택하세요. 지역 그룹이나 용도별 그룹이 다시 표시되면 실제 노드를 선택할 때까지 단계별로 들어갑니다. 현재 선택은 강조 표시, 체크 표시 또는 라디오 버튼으로 나타납니다.
일부 클라이언트에는 지연 시간 테스트 버튼이 있습니다. 정책 그룹에서 한 번 테스트하면 현재 네트워크에서 연결할 수 없는 노드를 제외하는 데 도움이 됩니다. 테스트 결과는 당시 기기에서 테스트 대상까지의 응답 상태만 보여 주며 모든 웹사이트의 로딩 성능을 의미하지는 않습니다. 특정 노드의 테스트가 실패하면 다른 노드로 바꿔 가이드를 계속 진행하세요. 처음부터 테스트 URL, 상태 확인 주기 또는 정책 그룹 알고리즘을 조정할 필요는 없습니다.
자동 선택, 장애 조치, 로드 밸런싱은 서로 다른 정책 그룹 동작입니다. 자동 선택은 보통 상태 확인 결과에 따라 응답이 더 적합한 노드를 고르고, 장애 조치는 현재 노드를 사용할 수 없을 때 전환하며, 로드 밸런싱은 구성 규칙에 따라 연결을 분배합니다. 구독에서 이러한 그룹을 제공한다면 바로 사용할 수 있지만, 이번 가이드에서는 먼저 명확한 노드 하나를 선택해 확인하는 것을 권장합니다. 문제가 생겼을 때 어떤 경로를 사용했는지 분명하게 판단할 수 있기 때문입니다.
선택을 마친 뒤 클라이언트 홈 화면으로 돌아가 두 가지 상태를 확인하세요. 실행 모드는 규칙이고 주요 정책 그룹은 특정 노드 또는 정상 작동하는 자동 정책 그룹을 가리켜야 합니다. 클라이언트가 정책 그룹 선택을 기억한다면 이후 구독 업데이트에서도 현재 선택을 유지하려고 합니다. 업데이트 후 선택이 기본값으로 돌아가면 정책 그룹에 다시 들어가 확인하세요. 정책 그룹 유형, 규칙 매칭 순서와 MATCH 대체 규칙은 정책 그룹 필드와 규칙 문법에서 더 알아볼 수 있습니다.
연결 및 트래픽 라우팅 활성화
모드와 노드 설정을 마친 뒤 클라이언트 코어가 실행 중인지 확인하세요. 데스크톱 클라이언트는 보통 홈 화면에 “시작”, “Service Mode”, “코어 상태” 또는 트레이 스위치를 제공하고, Android와 iOS 클라이언트에는 연결 버튼이 표시됩니다. 시작을 누르면 클라이언트가 실행 상태로 전환되어야 합니다. 방화벽, 네트워크 액세스 또는 VPN 권한 안내가 나타나면 현재 기기에서 클라이언트가 로컬 프록시 서비스를 만들도록 허용하세요. 그렇지 않으면 스위치가 켜진 것처럼 보여도 앱 트래픽이 Clash로 들어오지 않을 수 있습니다.
이제 트래픽 라우팅 방식을 선택합니다. 브라우저, 시스템 구성 요소와 운영체제의 프록시 설정을 따르는 대부분의 데스크톱 프로그램은 먼저 시스템 프록시를 사용하면 됩니다. Windows와 macOS 클라이언트에는 보통 “System Proxy” 또는 “시스템 프록시” 스위치가 있으며, 켜면 클라이언트가 로컬 프록시 주소와 포트를 시스템 설정에 기록합니다. 이때 브라우저에 확장 프로그램을 따로 설치할 필요가 없고, 브라우저에 다른 프록시 포트를 동시에 입력해서도 안 됩니다.
Android와 iOS는 일반적으로 시스템 VPN 인터페이스를 통해 트래픽을 라우팅합니다. 처음 연결을 누르면 시스템에서 VPN 구성 확인 창을 표시하며, 허용하면 상태 표시줄에 시스템 VPN 아이콘이 나타납니다. 이 연결은 기기 내부에서 앱 트래픽을 클라이언트로 전달할 뿐, 앞에서 선택한 규칙 모드와 정책 그룹의 단계는 바꾸지 않습니다. 시스템이 연결 생성을 거부하면 먼저 다른 VPN 앱이 실행 중인지 확인한 뒤 클라이언트에서 다시 시작하세요.
TUN 모드는 시스템 프록시를 따르지 않는 프로그램, 명령줄 도구, 일부 게임 또는 더 넓은 트래픽 범위가 필요한 환경의 트래픽을 라우팅하는 데 사용합니다. 데스크톱 클라이언트에서 TUN을 켜면 관리자 권한, 서비스 구성 요소 설치 또는 가상 네트워크 어댑터 생성이 필요할 수 있습니다. 처음 브라우저 접속만 확인한다면 TUN은 끄고 시스템 프록시를 켜는 편이 경로를 점검하기 쉽습니다. 기본 연결이 정상임을 확인한 뒤 실제 필요에 따라 TUN을 활성화하세요.
일부 클라이언트에서는 시스템 프록시와 TUN을 함께 사용할 수 있지만, 동시에 켤 수 있는지는 클라이언트 구현과 현재 네트워크 환경에 따라 다릅니다. 적용 범위를 넓히려고 모든 스위치를 한꺼번에 켜지 마세요. 권장 순서는 코어 시작, 시스템 프록시 활성화, 브라우저 확인입니다. 특정 앱이 여전히 프록시를 거치지 않으면 테스트 앱을 종료하고 TUN을 켠 다음 해당 앱을 다시 실행하세요. 한 번에 하나의 설정만 바꿔야 연결 기록을 제대로 분석할 수 있습니다.
클라이언트에 포트가 사용 중이라고 표시되면 먼저 다른 프록시 프로그램을 종료한 뒤 코어를 다시 시작하세요. 그래도 충돌하면 클라이언트 설정의 HTTP, SOCKS 또는 Mixed 포트가 이 기기의 다른 서비스와 겹치는지 확인합니다. 구독의 여러 포트 필드를 임의로 수정하지 마세요. 기본 환경에서는 클라이언트가 사용 중이지 않은 로컬 포트 하나를 사용하도록 설정하면 됩니다. 포트 필드 간 관계와 외부 제어 포트의 용도는 일반 필드 설명에서 확인할 수 있습니다.
프록시 적용 여부 확인
연결 스위치가 정상으로 표시되면 브라우저를 완전히 종료한 뒤 다시 여세요. 다시 시작하면 브라우저가 최신 시스템 프록시 설정을 읽고 기존 연결 재사용으로 인한 판단 오류도 줄일 수 있습니다. 평소 정상적으로 접속되는 페이지를 열어 기본 네트워크가 여전히 작동하는지 확인한 다음, 프록시 정책이 적용되어야 하는 대상 페이지에 접속하세요. 확인할 핵심은 스위치 색상만이 아니라 페이지 요청이 실제로 클라이언트에 들어와 규칙에 따라 정책을 선택했는지입니다.
Clash 클라이언트로 돌아가 “연결”, “Connections” 또는 로그 화면을 여세요. 대상 웹페이지를 새로 고치면 새로운 도메인 연결 기록이 표시되어야 합니다. 기록에는 보통 대상 도메인, 매칭된 규칙, 사용한 정책 그룹과 최종 노드가 나타납니다. 연결 기록이 방금 방문한 페이지와 일치하고 정책 경로가 이전 단계에서 선택한 노드를 가리키면 브라우저 트래픽이 Clash로 들어온 것입니다.
페이지는 열리지만 연결 기록에 DIRECT가 표시되면 먼저 매칭된 규칙을 확인하세요. 규칙 모드에서는 일부 대상이 원래 직접 연결되도록 설정되어 있을 수 있으며 이는 구성 결과입니다. 프록시를 사용해야 하는 대상이라면 전역 모드로 잠시 전환해 비교하세요. 전역 모드에서는 접속되지만 규칙 모드에서는 접속되지 않으면 보통 규칙 매칭 또는 정책 그룹 선택이 문제입니다. 두 모드 모두 접속되지 않으면 노드, 네트워크와 DNS를 계속 점검하세요. 비교가 끝나면 규칙 모드로 돌아갑니다.
브라우저가 페이지를 전혀 로드하지 못하고 클라이언트에 실패 기록이 많이 나타나면 연결 테스트를 통과한 노드로 바꾼 뒤 같은 페이지에서 다시 시도하세요. 노드를 바꾼 후 정상화되면 기존 노드를 현재 사용할 수 없다는 뜻입니다. 모든 노드가 실패하면 구독이 방금 정상적으로 업데이트되었는지, 기기 시간과 네트워크 권한 및 DNS가 정상인지 확인하세요. 여러 모드, DNS 설정과 노드를 연속으로 바꾸면 어떤 변경으로 결과가 달라졌는지 판단하기 어렵습니다.
브라우저는 연결 기록에 나타나지만 시스템 프록시를 따르지 않는 특정 앱에 기록이 없다면 시스템 프록시의 적용 범위가 부족한 것입니다. 해당 앱을 종료하고 TUN 모드를 켠 뒤 앱을 다시 시작해 테스트하세요. TUN을 활성화한 뒤에는 시스템에 가상 네트워크 어댑터가 생성되었는지, 클라이언트에 필요한 권한이 부여되었는지, DNS 요청이 클라이언트로 들어오는지도 함께 확인해야 합니다. TUN의 라우팅, 권한과 DNS 조합은 다양하므로 자세한 설정은 도움말 센터의 TUN 문제 해결을 참고하고 기본 단계에서 구성 전체를 직접 수정하지 마세요.
마지막으로 연결 해제 비교를 한 번 진행하세요. 먼저 정상적으로 접속되는 페이지와 연결 항목을 기록한 다음 시스템 프록시, VPN 연결 또는 TUN 스위치를 끄고 같은 페이지를 새로 고칩니다. 프록시가 필요한 요청은 더 이상 Clash를 거치지 않아야 하며, 다시 켜면 연결 기록이 다시 나타나야 합니다. 이 비교를 통해 브라우저 캐시, 기존 장기 연결 또는 다른 프록시 프로그램으로 인한 오판을 배제할 수 있습니다.
QUICK DIAGNOSIS
문제는 경로 순서대로 해결
문제가 생기면 “구독 입력, 정책 처리, 트래픽 진입점, 결과 출력” 순서로 확인하세요. DNS, 오버라이드 규칙 또는 코어 매개변수부터 점검하지 마세요. 기본 경로의 앞 단계가 성립하지 않으면 뒤 설정이 올바르더라도 원하는 결과가 나오지 않습니다.
가져온 후 정책 그룹이 보이지 않음
새 구성이 선택되었는지 먼저 확인한 뒤 수동 업데이트를 한 번 실행하세요. 그래도 비어 있으면 구독 주소가 완전한지 다시 확인하고 클라이언트에 형식 오류, 요청 실패 또는 구독 내용 없음 안내가 표시되는지 살펴보세요. 구성 이름을 가져올 수 있다고 해서 구성 내용까지 정상적으로 파싱된 것은 아닙니다.
시스템 프록시를 켠 후 브라우저에 접속할 수 없음
클라이언트 코어가 실행 중인지 확인한 다음 로컬 포트가 사용 중인지 점검하세요. 이후 확실히 사용할 수 있는 노드로 바꾸고 브라우저를 새로 고칠 때 연결 기록이 생성되는지 확인합니다. 기록이 없으면 시스템 프록시가 제대로 적용되었는지 확인하고, 기록은 있지만 요청이 실패하면 노드와 정책 경로를 점검하세요.
브라우저는 되지만 다른 앱이 Clash를 거치지 않음
해당 앱이 시스템 프록시를 사용하지 않을 수 있습니다. 앱을 종료한 뒤 TUN 모드를 활성화하고 다시 실행하세요. TUN이 시작되지 않으면 관리자 권한, 가상 네트워크 어댑터와 다른 VPN 프로그램의 충돌을 확인합니다. 구체적인 라우팅 및 DNS 조정은 도움말 센터의 해당 항목에 따라 처리하세요.
구독 업데이트 후 기존 노드 선택이 바뀜
업데이트 후 정책 그룹 이름이나 노드 목록이 바뀌면 클라이언트가 기존 선택을 더 이상 매칭하지 못해 기본 항목으로 돌아갈 수 있습니다. 주요 정책 그룹에 들어가 노드를 다시 선택한 뒤 연결을 확인하세요. 사용자 지정 선택을 장기간 유지해야 한다면 고급 구성의 오버라이드 및 병합 방법을 확인하세요.
위 네 가지에 해당하지 않는 문제라면 도움말 센터에서 “설치 및 구성”, “사용 팁” 또는 “문제 해결” 분류로 검색하세요. YAML 로드 순서, DNS 모드, 규칙 우선순위와 오버라이드 동작을 이해해야 한다면 구성 필드 참조에서 각 부분을 대조하고 구독 내용을 무작정 수정하지 마세요.
FINAL CHECK
네 가지 항목 확인
설정 페이지를 닫기 전에 구독이 업데이트되는지, 규칙 모드가 선택되었는지, 트래픽 라우팅이 활성화되었는지, 연결 기록이 실제 접속과 일치하는지 확인하세요. 기본 경로가 안정된 뒤 자동 업데이트나 TUN을 설정합니다.
- 구독구성이 선택되었고 업데이트 시간이 정상임
- 정책규칙 모드와 주요 정책 그룹 확인 완료
- 연결시스템 프록시, VPN 또는 TUN을 필요에 따라 활성화함
- 확인요청이 연결 기록에 나타나고 예상 정책과 일치함