클라이언트 설치 완료
처음 실행한 뒤 구성, 프록시 또는 설정 페이지가 표시되어야 합니다. 시스템이 실행을 차단하면 먼저 보안 확인과 필요한 권한 허용을 완료하세요. 프록시, DNS, TUN을 동시에 변경하지 마세요.
빈 클라이언트에서 시작해 구독 가져오기, 프록시 모드 선택, 연결 시작, 결과 확인을 차례로 진행합니다. 이 페이지에서는 처음 사용할 때의 기본 절차만 다루며, 구성 문법, DNS 경로와 시스템 수준 문제 해결은 별도 문서에서 설명합니다.
먼저 클라이언트가 정상적으로 실행되고 구독 소스를 사용할 수 있는지 확인한 뒤 현재 시스템 프록시 상태를 기록하세요. 문제가 생겼을 때 어느 단계에서 막혔는지 빠르게 판단할 수 있습니다.
처음 실행한 뒤 구성, 프록시 또는 설정 페이지가 표시되어야 합니다. 시스템이 실행을 차단하면 먼저 보안 확인과 필요한 권한 허용을 완료하세요. 프록시, DNS, TUN을 동시에 변경하지 마세요.
복사할 때 링크의 모든 문자를 포함하세요. 메신저나 웹페이지에서는 긴 링크가 접혀 보일 수 있으므로, 생략된 문자를 직접 옮기지 말고 복사 기능으로 원본 주소를 가져오세요.
가져오기 전에 기존 프록시를 끄고 일반 웹페이지를 열어 테스트하세요. 기본 네트워크 자체가 끊겨 있으면 클라이언트가 구독을 업데이트할 수 없으며, 이 상태만으로 프록시 노드의 사용 가능 여부를 판단할 수도 없습니다.
구성 메뉴는 보통 사이드바의 “구독”, “구성” 또는 Profiles에 있습니다. 연결할 때는 먼저 시스템 프록시를 켜세요. 시스템 프록시를 따르지 않는 프로그램까지 연결해야 할 때만 서비스 모드나 TUN 설정으로 이동합니다. 처음 권한을 부여할 때 시스템 확인 창이 나타날 수 있습니다.
클라이언트가 메뉴 막대에서 실행되거나 별도 창으로 표시될 수 있습니다. 구독 가져오기는 보통 구성 관리 페이지에 있으며, 시스템 프록시 또는 네트워크 확장을 켤 때 macOS에서 계정 암호 입력이나 네트워크 확장 권한 확인을 요구할 수 있습니다.
모바일에서는 보통 먼저 구성 페이지에서 구독을 가져온 다음 메인 화면으로 돌아와 연결 버튼을 누릅니다. 시스템에 VPN 연결 요청이 표시되는데, 이는 Android가 앱 트래픽을 클라이언트로 전달하기 위한 표준 권한 절차입니다.
구성을 가져온 뒤 처음 연결을 시작하면 VPN 구성 추가를 요청합니다. 시스템 확인을 완료하고 클라이언트로 돌아와 현재 구성과 정책 그룹이 선택되었는지 확인한 다음 연결을 시작하세요.
데스크톱 클라이언트의 절차는 Windows와 비슷합니다. 데스크톱 환경마다 시스템 프록시 지원이 다르므로 브라우저 외부의 명령줄 프로그램이 연결되지 않으면 프록시 환경 변수를 별도로 설정하거나 필요에 따라 TUN을 구성하세요.
목표는 클라이언트가 파싱과 업데이트가 가능하고 현재 선택된 구성을 확보하도록 하는 것입니다. 구독 이름만 보이는 것으로는 충분하지 않으며, 구성 내부에 정책 그룹, 규칙과 노드 정보도 있어야 합니다.
클라이언트를 실행한 뒤 사이드바, 하단 내비게이션 또는 메뉴 막대에서 “구성”, “구독”, “Profiles” 또는 “구성 파일”을 찾으세요. 들어가면 원격 구독 입력란, 로컬 파일 가져오기 버튼과 저장된 구성 목록을 볼 수 있습니다. 처음에는 목록이 비어 있을 수 있으며 정상입니다.
URL을 통해 원격 구성을 추가하는 항목을 선택하고 전체 구독 링크를 입력란에 붙여넣으세요. 화면에서 이름을 요구하면 서비스 이름이나 사용 목적처럼 알아보기 쉬운 이름을 지정할 수 있습니다. 이름은 로컬 표시만 바꾸며 구독 내용에는 영향을 주지 않습니다. 그런 다음 “가져오기”, “다운로드”, “추가” 또는 “업데이트”를 누르세요.
클라이언트가 먼저 구독 주소에 요청을 보내고 반환된 구성을 파싱합니다. 작업이 끝날 때까지 기다리고 다운로드 중에 여러 번 클릭하지 마세요. 성공하면 목록에 구성 이름, 업데이트 시간 또는 노드 수가 표시됩니다. 파싱 오류가 표시되면 연결 단계로 넘어가지 말고 먼저 오류를 해결하세요.
가져오기에 성공했다고 해서 반드시 활성화된 것은 아닙니다. 일부 클라이언트는 새 구성을 자동으로 선택하지만 다른 클라이언트는 이전 구성을 계속 사용할 수 있습니다. 새 구성의 “사용”, “선택” 또는 라디오 버튼을 눌러 현재 구성으로 지정하세요. 이어서 프록시 페이지에서 “자동 선택”, “노드 선택”, “장애 조치”와 같은 정책 그룹이 표시되고 그룹 안에 선택 가능한 노드가 있는지 확인하세요.
구성 이름만 있고 정책 그룹이나 노드가 없다면 먼저 수동 업데이트를 실행하세요. 그래도 비어 있으면 구독 응답이 유효한지, 링크가 완전한지, 클라이언트 로그에 YAML 파싱 오류가 기록되었는지 확인해야 합니다. 구성 파일 필드와 규칙 문법의 자세한 설명은 용어 설명에서 확인할 수 있으며, 응답 이상, 파싱 실패와 업데이트 시간 초과에 대한 시스템 문제 해결은 문제 해결 매뉴얼에서 다룹니다.
모드는 요청이 규칙과 어떻게 일치할지 결정합니다. 처음 설정할 때는 규칙 모드를 사용하고 주요 정책 그룹에 노드를 지정해 모드 문제와 노드 문제를 구분하세요.
클라이언트의 “모드”, “실행 모드” 또는 Mode 설정으로 이동하면 보통 규칙, 전역, 직접 연결 세 가지 옵션이 표시됩니다. 처음에는 “규칙” 또는 Rule을 선택하세요. 이 모드는 구성의 규칙 순서에 따라 도메인, IP, 프로세스 또는 규칙 집합을 판단하고 연결을 해당 정책 그룹으로 전달합니다. 일반적인 웹사이트는 직접 연결하고 프록시가 필요한 요청만 프록시 정책으로 보내므로 일상적인 사용에서 안정성을 유지하기 쉽습니다.
전역 모드는 대부분의 요청을 하나의 프록시 정책으로 전달하므로 특정 사이트에 규칙이 적용되지 않아 접속할 수 없는지 짧게 확인할 때 유용하지만, 처음 설정한 뒤 계속 사용하는 것은 권장하지 않습니다. 직접 연결 모드는 프록시를 우회하며 프록시를 잠시 끄거나 비교 테스트할 때 사용합니다. 모드를 바꾼 뒤 구독을 다시 가져올 필요는 없지만 새 테스트 요청을 보내 이전 연결 결과를 새 모드의 결과로 오해하지 않도록 하세요.
모드를 선택한 뒤 “프록시”, “정책 그룹” 또는 Proxies 페이지로 이동하세요. 주요 프록시 트래픽을 담당하는 정책 그룹을 찾습니다. 이름은 “노드 선택”, “Proxy”, “수동 선택” 또는 구성 제공자가 지정한 이름일 수 있습니다. 그룹을 펼쳐 상태가 정상인 노드를 선택하세요. 구성에 자동 선택 그룹이 있다면 먼저 사용할 수 있지만, 해당 그룹에 테스트를 완료할 노드가 하나 이상 있는지 확인해야 합니다.
정책 그룹 사이에는 참조 관계가 있을 수 있습니다. 예를 들어 “해외 사이트” 정책 그룹이 “노드 선택”을 참조하고, “노드 선택”이 다시 특정 노드를 가리킬 수 있습니다. 이때 가장 바깥쪽 정책만 바꿔서는 실제 출구가 바뀌지 않을 수 있습니다. 하위 그룹으로 들어가 구체적인 노드 이름이 보일 때까지 확인하고 선택 표시가 갱신되었는지 확인하세요. 정책 그룹, 규칙 매칭과 폴백 관계에 관한 용어는 용어 설명에서 확인할 수 있습니다.
규칙, 전역과 직접 연결은 커널이 트래픽을 분기하는 방식을 결정하고, 시스템 프록시와 TUN은 어떤 트래픽이 커널로 들어갈지를 결정합니다. 처음에는 규칙 모드를 유지하고 다음 단계에서 시스템 프록시를 켜세요. 대상 프로그램이 시스템 프록시를 따르지 않거나 더 많은 앱을 연결해야 하거나 특정 DNS 경로를 처리해야 할 때만 TUN을 검토하세요. 두 항목을 동시에 바꾸면 원인 파악이 어려워집니다.
이 단계에서는 시스템 또는 앱 트래픽을 클라이언트로 전달합니다. 데스크톱에서는 보통 먼저 시스템 프록시를 켜고, 모바일에서는 시스템 VPN 인터페이스를 통해 연결을 설정합니다.
클라이언트 메인 화면으로 돌아가 “시스템 프록시”, “시스템 프록시로 설정” 또는 System Proxy 스위치를 찾으세요. 클릭한 뒤 상태가 바뀌고 스위치가 계속 켜져 있는지 확인하세요. 일부 Windows 클라이언트는 먼저 커널 서비스를 시작해야 하고, 일부 macOS 클라이언트는 시스템 네트워크 설정 변경을 요청합니다. 시스템 안내에 따라 권한을 허용한 뒤 클라이언트에서 상태를 다시 확인하세요.
시스템 프록시를 켜면 운영체제의 프록시 설정을 따르는 브라우저와 데스크톱 앱이 Clash의 HTTP 또는 mixed 포트로 요청을 보냅니다. 이때 TUN을 바로 켜거나 시스템 프록시 주소를 수동으로 바꾸지 마세요. 먼저 다음 단계의 브라우저 확인을 완료하면 포트 입력 오류와 여러 연결 방식의 충돌 가능성을 줄일 수 있습니다.
Android 또는 iOS 클라이언트는 보통 메인 화면에 연결 버튼을 제공합니다. 누르면 시스템에 VPN 구성 또는 연결 요청이 표시됩니다. 권한을 허용하면 상태 표시줄에 VPN 표시가 나타나고 클라이언트 메인 화면도 연결 안 됨에서 연결됨으로 바뀝니다. 이 표시는 시스템 통로가 설정되었다는 뜻일 뿐이며 노드의 실제 사용 가능 여부는 접속 테스트와 로그로 확인해야 합니다.
시스템에 권한 창이 표시되지 않으면 시스템 VPN 설정에서 같은 종류의 연결이 이미 사용 중인지 확인하세요. 모바일 운영체제는 보통 한 번에 하나의 주요 VPN 통로만 허용하므로 다른 네트워크 도구가 새 연결을 방해할 수 있습니다. 충돌하는 연결을 끈 뒤 Clash 클라이언트로 돌아가 다시 시도하세요.
브라우저는 시스템 프록시로 접속되지만 게임, 명령줄 도구 또는 특정 데스크톱 프로그램이 클라이언트로 들어오지 않을 때 TUN을 검토할 수 있습니다. 데스크톱에서 TUN을 켜면 관리자 권한, 서비스 구성 요소 설치 또는 네트워크 확장 승인이 필요할 수 있습니다. 활성화한 뒤에도 기존 규칙 모드는 유지하고 연결 범위가 개선되었는지만 확인하세요.
TUN은 가상 네트워크 카드, 라우팅과 DNS 경로를 포함하므로 처음 연결이 실패했을 때 일반적인 해결책으로 바로 사용하기에는 적합하지 않습니다. 시스템 프록시와 TUN의 작동 범위, 권한 요구 사항과 충돌 문제 해결은 문제 해결 매뉴얼의 시스템 연결 섹션에서 계속 확인할 수 있습니다.
연결 버튼만 확인해서는 충분하지 않습니다. 웹페이지 접속, 연결 기록, 규칙 적용과 노드 결과를 함께 관찰해 요청이 실제로 예상 경로를 거쳤는지 확인해야 합니다.
클라이언트 연결 상태를 유지한 채 먼저 평소에 직접 접속할 수 있는 웹사이트를 열어 프록시 설정 때문에 기본 네트워크가 끊기지 않았는지 확인하세요. 그런 다음 프록시 정책이 처리해야 하는 대상을 접속합니다. 새 브라우저 탭을 열고 한 번 새로고침하면 브라우저 캐시, 기존 연결 또는 Service Worker 때문에 결과가 달라 보이는 문제를 줄일 수 있습니다.
일반 사이트와 대상 사이트가 모두 정상적으로 열리면 클라이언트의 연결 기록을 계속 확인하세요. 일반 사이트는 되지만 대상 사이트가 실패하면 노드와 규칙 정책을 중점적으로 확인하고, 모든 사이트가 실패하면 구독을 계속 바꾸기보다 시스템 프록시 포트, 현재 구성, 커널 상태와 로컬 DNS를 먼저 점검하세요.
“연결”, “세션”, “로그” 또는 Connections 페이지를 열고 방금 테스트한 웹페이지를 새로고침하세요. 목록에 새 도메인, 대상 주소, 규칙 이름과 정책 체인이 표시되어야 합니다. 해당 요청을 찾아 예상한 규칙에 적용되었고 최종적으로 방금 선택한 노드에 도달했는지 확인하세요. 기록에 DIRECT가 표시되면 직접 연결 규칙이 처리한 것이고, REJECT가 표시되면 구성의 거부 규칙이 적용된 것입니다.
연결 기록에 새 요청이 전혀 없다면 대개 앱 트래픽이 Clash로 들어오지 않은 것입니다. 데스크톱에서는 시스템 프록시가 계속 켜져 있는지 확인하고, 명령줄 프로그램은 시스템 프록시를 읽는지 확인하세요. 모바일에서는 VPN 상태가 존재하는지 확인합니다. 기록은 있지만 계속 시간 초과가 발생하면 연결 경로는 설정된 것이므로 다음으로 노드 연결성, 네트워크 제한 또는 DNS 해석을 점검해야 합니다.
클라이언트의 지연 시간 테스트는 노드를 1차로 선별하는 데 도움이 되지만 테스트 성공이 모든 대상에 접속할 수 있다는 뜻은 아닙니다. 테스트 가능한 노드를 하나 선택한 뒤 실제 웹페이지 요청을 다시 보내고 연결 로그에 기록된 설정 결과를 기준으로 판단하세요. 노드 목록이 모두 시간 초과되면 먼저 구독 업데이트가 방금 성공했는지 확인한 뒤 기본 네트워크를 바꿔 비교하세요.
테스트가 끝나면 규칙 모드와 현재 사용 가능한 노드만 유지하면 됩니다. 이제 기본 설정이 완료되었습니다. 이후 DNS 조정, 규칙 세분화, 시작 시 자동 실행 설정 또는 특정 앱 문제 해결이 필요하다면 한 번에 하나씩 변경하고, 변경할 때마다 이 절의 접속 및 로그 확인을 반복해 여러 변수가 동시에 바뀌지 않도록 하세요.
가장 흔한 초기 문제만 다룹니다. 복잡한 DNS, TUN, 시스템 서비스와 모바일 문제는 문제 해결 매뉴얼에서 계속 확인하세요.
먼저 시스템 프록시를 끄고 현재 기본 네트워크에서 일반 웹페이지가 열리는지 확인하세요. 그런 다음 전체 구독 주소를 다시 복사하고 링크 앞뒤에 공백이 들어갔는지 점검합니다. 브라우저에서 해당 주소를 열어도 구성 내용이 반환되지 않으면 문제는 구독 응답 또는 현재 네트워크에 있으므로 프록시 모드를 계속 조정하지 마세요. 브라우저에서는 응답하지만 클라이언트에서 실패하면 로그의 연결 오류를 확인하고 시스템 시간이 정확한지 점검하세요.
먼저 새 구성이 현재 구성으로 설정되었는지 확인한 뒤 한 번 업데이트를 실행하세요. 로그에 구성 파싱, 필드 형식 또는 규칙 참조 오류가 있는지 확인합니다. 구독 이름만 있고 정책 그룹이 없다면 대개 응답 내용이 불완전하거나 파싱에 실패한 것입니다. 시스템 프록시를 반복해서 시작해 구성 단계의 문제를 해결하려 하지 마세요.
먼저 시스템 프록시를 꺼서 기본 네트워크를 복구한 다음 클라이언트 커널이 실행 중인지, 현재 구성이 선택되었는지, 주요 정책 그룹에 노드가 지정되었는지 확인하세요. 다시 켠 뒤 연결 기록을 확인합니다. 요청이 없으면 트래픽이 클라이언트로 들어오지 않은 것이고, 요청은 있지만 모두 시간 초과되면 노드를 점검하세요. DNS 오류가 표시되면 문제 해결 매뉴얼의 DNS 섹션에서 계속 확인하세요.
이는 대개 앱이 시스템 프록시를 읽지 않는 문제이며 규칙 모드가 작동하지 않는 것이 아닙니다. 먼저 앱 자체에 프록시 설정이 있는지 확인하세요. 명령줄 도구는 해당 문서에 따라 HTTP 또는 SOCKS 프록시를 설정할 수 있습니다. 더 많은 앱을 일괄적으로 연결해야 할 때 TUN 모드를 검토하고, 활성화한 뒤 연결 기록으로 트래픽 경로를 확인하세요.