시작 전 준비

시작하기 전에 클라이언트를 설치하고 기본 창을 열 수 있는지 확인하세요. 사용 권한이 있는 구독 URL 또는 완성된 Clash YAML 설정 파일도 준비합니다. 클라이언트는 설정을 읽고 코어를 실행해 요청 경로를 관리하는 프로그램이며, 그 자체가 프록시 서비스는 아닙니다. 프로그램만 설치하고 설정이 없으면 연결을 완료하기 어렵습니다.

다른 프록시 클라이언트는 잠시 종료하고 브라우저 프록시 확장 프로그램, 시스템 VPN, 수동 프록시가 켜져 있는지 기록해 두세요. 처음 설정할 때는 트래픽을 처리하는 방식을 하나만 사용해야 합니다. 여러 방식이 동시에 켜져 있으면 브라우저가 다른 설정을 따르면서 클라이언트의 스위치 상태와 실제 접속 결과가 달라질 수 있습니다. 회사, 학교 또는 관리 대상 기기에서는 기기 및 네트워크 사용 규정을 먼저 따르고 조직에서 관리하는 프록시 정책을 변경하지 마세요.

구독 URL에는 계정 식별 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 전체 주소를 공개 게시판이나 스크린샷, 온라인 형식 변환 사이트에 붙여 넣지 마세요. 이 문서에서는 클라이언트 사용법만 다루며 구독 내용을 제출할 필요가 없습니다. 형식에 문제가 있다면 먼저 구독 제공업체의 관리 페이지에서 Clash 또는 mihomo용으로 명시된 내보내기 메뉴를 찾아보세요.

01 / 구독을 가져와 설정 활성화하기

왼쪽 메뉴에서 ‘설정’ 페이지를 열고 추가, 가져오기 또는 원격 설정 메뉴를 찾으세요. 구독 URL을 입력란에 붙여 넣습니다. 이름을 입력할 수 있다면 ‘일상용 설정’처럼 용도를 알아보기 쉬운 이름을 사용하세요. 이름은 로컬에서 항목을 구분하기 위한 것으로 구독 URL을 대신하거나 프록시 노드를 정하지 않습니다. 주소 앞뒤에 공백이나 줄바꿈, 메신저에서 복사된 문장부호가 없는지 확인한 뒤 가져오기를 실행하세요.

가져오기를 실행한 뒤 다운로드가 끝날 때까지 기다리고 버튼을 연속으로 누르지 마세요. 정상적으로 완료되면 설정 목록에 새 항목이 추가되며, 보통 이름과 출처 또는 업데이트 시간을 확인할 수 있습니다. 버전에 따라 원격 항목을 먼저 저장한 뒤 내용을 별도로 다운로드해야 할 수 있습니다. 업데이트 버튼이 있다면 한 번 실행해 오류가 없는지 확인하세요. 목록에 항목이 표시된다고 코어가 해당 설정을 사용 중인 것은 아니므로 다음 단계에서 활성화해야 합니다.

방금 가져온 항목을 선택하고 적용, 활성화 또는 현재 설정으로 지정하는 메뉴를 사용하세요. 현재 설정 표시가 해당 항목으로 옮겨졌는지 확인한 다음 ‘프록시’ 페이지에서 설정에 정의된 프록시 그룹이 나타나는지 살펴봅니다. 프록시 페이지가 여전히 비어 있다면 설정 페이지로 돌아가 올바른 항목을 선택했는지 확인하고, 로그에서 파싱 오류나 설정 로드 실패가 있는지 확인하세요. 설정 파싱 오류를 해결하려고 시스템 프록시를 반복해서 켜고 끄지 마세요. 두 문제는 서로 다른 단계에서 발생합니다.

로컬 YAML 파일 사용하기

완성된 설정 파일이 있다면 로컬 파일 가져오기 메뉴에서 확장자가 .yaml 또는 .yml인 파일을 선택한 뒤 활성화하세요. 파일 확장자만 YAML로 바꾼다고 형식이 변환되는 것은 아닙니다. 웹페이지 본문, QR 코드 스크린샷, 일반 노드 목록은 완성된 설정이 아닙니다. 처음에는 파일을 직접 수정하지 말고 제공업체가 안내하는 호환 버전으로 기본 설정을 구성하세요.

로컬 파일을 가져오면 클라이언트가 사본을 저장할 수 있습니다. 원본 파일을 나중에 수정해도 가져온 항목에 자동으로 반영되지 않을 수 있으므로 클라이언트에서 편집하거나 다시 가져오는 방식을 확인하세요. 원격 구독은 업데이트를 실행해 내용을 다시 가져옵니다. 두 설정은 관리 방식이 다릅니다. 설정 항목과 실제 실행 파일의 차이를 알아보려면 용어집의 Profile 및 설정 항목 설명을 참고하세요.

가져오기에 실패하면 이 단계에서 확인하세요

다운로드에 실패했다면 URL이 만료되었는지, 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인하세요. 파싱에 실패했다면 응답 내용이 실제 Clash YAML인지 먼저 확인합니다. 계정 로그인 페이지, 서비스 오류 페이지, Base64 노드 목록은 URL만으로 완성된 설정처럼 사용할 수 없습니다. 출처를 확인하지 않은 내용을 무작위 온라인 변환 서비스에 올리지 마세요. 변환이 꼭 필요하다면 제공업체에 지원되는 방법을 문의하세요.

처음 가져오기에 성공한 뒤에는 우선 수동 업데이트를 유지하는 것이 좋습니다. 정기 업데이트가 필요하면 원격 설정 항목에 적절한 업데이트 주기를 지정하고, 업데이트 후 현재 설정과 프록시 그룹 선택이 예상대로 유지되었는지 확인하세요. 여기까지 완료하면 활성화할 수 있고 프록시 그룹이 표시되는 설정이 준비된 상태입니다. 이제 요청을 어떻게 분기할지 정하면 됩니다.

02 / 프록시 모드와 그룹 선택하기

‘대시보드’ 또는 ‘프록시’ 페이지에서 실행 모드를 찾아 처음에는 ‘규칙’으로 설정하세요. 규칙 모드에서는 현재 설정의 rules를 위에서부터 순서대로 확인해 요청을 직접 연결하거나 프록시 또는 프록시 그룹으로 보냅니다. 모든 요청을 같은 노드로 보내는 기능도 아니고, 빠진 규칙을 자동으로 추가하는 기능도 아닙니다. 실제 동작은 로드된 설정에 따라 달라집니다.

화면에 전역 및 직접 연결 옵션이 있다면 용도를 구분해서 사용하세요. 전역 모드는 보통 모든 요청을 전역 프록시 그룹으로 보내므로 규칙이 결과에 영향을 주는지 임시로 확인할 때 쓸 수 있지만, 유효한 노드를 선택해야 합니다. 직접 연결 모드는 주로 일반 연결을 복구하거나 비교 테스트를 할 때 사용합니다. 처음 연결을 확인한 뒤 다른 모드를 시도하세요. 모드와 설정, 노드를 동시에 바꾸면 문제를 비교하기 어려워집니다.

프록시 페이지에서 노드 선택 확인하기

‘프록시’ 페이지에서 현재 설정이 제공하는 선택형 프록시 그룹을 펼치세요. 그룹 이름은 설정 작성자가 정하므로 PROXY가 아닐 수도 있고 안내 이미지와 다를 수도 있습니다. 일상적인 요청에 사용하는 기본 그룹을 찾아 구독에서 사용할 수 있는 프록시 노드를 선택하세요. 자동 선택 그룹이 설정되어 있다면 기본 그룹에서 해당 그룹을 선택할 수도 있습니다. 자동 전환 여부는 그룹 유형과 매개변수에 달려 있으며, 이름에 ‘자동’이 포함되었는지는 기준이 아닙니다.

두 가지 관계를 구분해야 합니다. 실행 모드는 규칙을 사용할지 결정하고, 프록시 그룹은 규칙에 일치한 요청을 어느 노드로 보낼지 결정합니다. 프록시 노드를 선택해도 기본 그룹이 DIRECT를 가리키면 요청은 직접 연결될 수 있습니다. 반대로 그룹을 올바르게 선택했더라도 테스트 도메인이 앞쪽 규칙에 따라 DIRECT로 보내지면 해당 프록시를 거치지 않습니다. YAML을 바로 수정하지 말고 먼저 그룹의 선택 상태를 확인한 뒤 기존 분기 규칙을 유지하세요.

프록시 그룹에서 선택할 항목이 없다면 연결 단계로 넘어가지 말고 설정 단계로 돌아가세요. 구독 내용이 불완전하거나 프록시 제공업체 업데이트에 실패했거나 규칙에서 참조하는 그룹과 실제 그룹이 다를 수 있습니다. 필드 구조와 그룹 간 참조는 설정 문서에서 확인할 수 있습니다. YAML 가이드를 참고하세요. 이 단계를 마치면 규칙 모드를 유지하고 사용할 노드를 하나 선택한 상태로 시스템 프록시 설정으로 넘어갑니다.

03 / 코어를 실행하고 시스템 프록시 켜기

대시보드나 설정 페이지로 돌아가 코어가 실행 중인지 확인하세요. 설정을 적용하면 코어가 자동으로 시작되는 버전도 있고 별도의 시작 메뉴가 있는 버전도 있습니다. 로그에 설정 오류가 계속 표시되면 먼저 설정을 수정하세요. 포트가 이미 사용 중이라고 나오면 다른 인스턴스나 프록시 프로그램이 실행 중인지 확인합니다. 앱 창이 열렸다고 코어가 로컬 포트에서 정상적으로 요청을 받고 있다는 뜻은 아닙니다.

처음 설정할 때는 클라이언트의 기존 리스닝 포트를 그대로 사용하세요. 특정 안내서와 포트를 맞추려고 변경하지 마세요. 로그에는 아래와 같은 리스닝 메시지가 표시될 수 있습니다. 예시 포트는 흔히 쓰이는 값일 뿐 모든 설치에서 사용해야 하는 값은 아닙니다. 실제 설정과 로컬 로그를 기준으로 확인하세요.

level=info msg="Mixed(http+socks) proxy listening at: 127.0.0.1:7890"

코어가 실행 중인지 확인한 뒤 ‘시스템 프록시’를 켜세요. 이 스위치는 보통 운영체제의 프록시 주소를 클라이언트의 로컬 리스닝 주소로 지정해 시스템 프록시를 따르는 앱이 사용하도록 합니다. 시스템에서 권한을 요청하면 현재 클라이언트에서 보낸 안내인지 확인한 뒤 절차에 따라 허용하세요. 스위치를 켠 뒤에는 클라이언트를 계속 실행하고 창을 닫더라도 백그라운드 프로세스를 바로 종료하지 마세요.

먼저 브라우저로 연결 확인하기

시스템 프록시를 따르는 브라우저를 열고 새 탭에서 접속을 테스트하세요. 시스템 설정을 덮어쓰지 않도록 별도의 프록시를 설정한 브라우저 확장 프로그램은 잠시 꺼 둡니다. 일부 브라우저에는 별도 네트워크 프록시 옵션이 있고, 일부 터미널 도구는 프록시 매개변수를 따로 지정해야 합니다. 시스템 프록시 스위치를 따르지 않는다고 클라이언트가 작동하지 않는 것은 아닙니다. 처음에는 설정 경로가 가장 단순한 브라우저로 확인하세요.

Windows에서는 시스템 설정의 네트워크 및 프록시 페이지에서 수동 프록시 상태를 확인할 수 있습니다. macOS에서는 현재 네트워크 서비스의 세부 설정에서 프록시를 확인하세요. Linux에서는 데스크톱 환경의 네트워크 프록시 설정을 함께 살펴보세요. 배포판과 데스크톱 세션에 따라 시스템 프록시 지원이 다를 수 있습니다. 클라이언트에서 설정 기록에 실패했다고 표시되면 스위치 모양만 보고 판단하지 말고 시스템 설정에서 실제 주소와 포트를 확인하세요.

TUN은 아직 켜지 마세요

이 안내에서는 먼저 시스템 프록시로 브라우저 요청이 클라이언트에 들어오는지 확인합니다. 처음부터 TUN을 켤 필요는 없습니다. TUN은 가상 네트워크 인터페이스로 더 많은 트래픽을 처리하며 권한, 라우팅, DNS 등 추가 설정이 필요합니다. 시스템 프록시와 같은 기능이 아니며 모든 문제를 해결하는 스위치도 아닙니다. 시스템 프록시를 따르지 않는 앱까지 연결해야 한다면 TUN과 시스템 프록시 용어 설명을 읽고 클라이언트에서 요구하는 서비스와 권한을 설정하세요.

모바일에서는 이 단계에서 연결을 누르고 시스템 VPN 연결을 허용해야 하는 경우가 많습니다. 시스템에 VPN 상태 표시가 나타날 수 있지만, 이는 트래픽 처리가 시작되었다는 뜻일 뿐 구독 노드가 정상이라는 증거는 아닙니다. 플랫폼에 관계없이 실제 요청과 클라이언트 기록을 확인해 다음 단계에서 작동 여부를 검증하세요.

04 / 규칙과 연결 작동 확인하기

클라이언트를 계속 실행한 상태에서 평소 안정적으로 열리는 HTTPS 페이지를 브라우저에서 다시 방문하세요. 클라이언트의 ‘연결’ 페이지도 열어 페이지를 새로고침할 때 해당 도메인이나 대상 주소가 기록되는지 확인합니다. 규칙과 연결 경로 상세 정보가 제공된다면 기록을 펼쳐 적용된 규칙과 최종 프록시 그룹을 확인하세요. 페이지가 열린 것은 첫 번째 확인 사항일 뿐이며, 예상대로 트래픽이 분기되었는지는 연결 기록의 경로로 판단할 수 있습니다.

용도가 분명한 대상 두 개를 골라 비교하세요. 하나는 현재 설정에서 직접 연결되어야 하고, 다른 하나는 프록시를 거쳐야 하는 대상이어야 합니다. 결과를 판단하기 전에 규칙 정의나 연결 상세 정보를 확인하세요. 페이지 내용이나 위치만 보고 경로를 추측하면 안 됩니다. 두 요청 모두 DIRECT로 표시되면 실행 모드와 적용 규칙을 먼저 확인하세요. 선택한 그룹을 거쳤는데도 페이지가 열리지 않는다면 해당 노드와 원격 서비스의 상태를 살펴보세요.

연결 기록이 없으면 트래픽 처리 경로 확인하기

먼저 브라우저에 기존 장기 연결이 남아 있지 않은지 확인한 뒤 테스트 탭을 닫고 다시 여세요. 여전히 기록이 없다면 시스템 설정에서 프록시가 실제로 적용되었는지, 브라우저에 별도의 프록시 설정이 켜져 있지 않은지 확인합니다. 일부 화면에는 현재 활성 연결만 표시하므로 짧은 요청은 금방 사라질 수 있습니다. 로그도 함께 확인하세요. 기록을 남기려고 규칙이나 DNS를 곧바로 수정하지 마세요.

페이지가 열리지 않으면 ‘설정 활성화 → 코어 실행 → 로컬 포트 리스닝 → 시스템 프록시 적용 → 프록시 그룹 선택’ 순서로 하나씩 확인하세요. 조건은 한 번에 하나만 변경하고 같은 페이지 요청을 다시 테스트합니다. 그래야 로컬 트래픽 처리 문제와 프록시 노드 연결 문제를 구분할 수 있습니다. 여러 매개변수를 한꺼번에 바꾸면 어떤 변경이 영향을 주었는지 알기 어렵습니다.

로그는 현재 실패 단계의 원인을 찾는 데 활용하세요

‘로그’ 페이지에서 방금 테스트한 시간대의 오류나 경고부터 확인하세요. 설정 파싱 오류는 가져오기 단계로 돌아가고, 리스닝 실패는 포트 사용 여부를 확인해야 합니다. 연결 시간 초과는 대상과 선택한 노드를 함께 살펴보고, 도메인 확인 오류는 DNS 경로를 추가로 점검하세요. 로그를 공유하기 전에 구독 URL, 계정 정보 등 민감한 내용을 삭제하세요. DNS 필드와 규칙 작성법은 YAML 설정 참고서에서 다루며, 처음 작동을 확인할 때 모든 항목을 다시 작성할 필요는 없습니다.

외부 페이지에서 노드 주소를 확인하는 경우 해당 페이지에 접속한 요청의 경로만 알 수 있으며 모든 앱이 같은 경로를 사용한다는 뜻은 아닙니다. 규칙 모드에서는 대상에 따라 서로 다른 노드를 사용하는 것이 정상입니다. 설정이 성공적으로 로드되고, 테스트 요청이 클라이언트에 기록되며, 예상한 규칙이 적용되고, 대상 페이지가 정상적으로 열리면 설정이 완료된 것입니다.

연결 종료 및 다음 실행

테스트가 끝나 사용을 중지하려면 먼저 시스템 프록시를 끈 뒤 클라이언트를 종료하세요. TUN을 사용했다면 해당 트래픽 처리 스위치도 끄고 클라이언트 절차에 따라 서비스를 중지합니다. 프로세스를 강제로 종료하면 시스템에 로컬 포트를 가리키는 프록시 설정이 남을 수 있습니다. 이때 브라우저가 인터넷에 연결되지 않으면 프로그램을 바로 다시 설치하지 말고 시스템 프록시 설정을 먼저 복구하세요.

다음에 실행할 때는 현재 설정이 예상한 항목인지, 원격 구독이 정상적으로 업데이트되는지 확인한 다음 모드, 프록시 그룹, 시스템 프록시 상태를 점검하세요. 우선 자동 시작, 자동 트래픽 처리, 복잡한 재정의를 한꺼번에 켜지 말고 오늘 확인한 설정을 유지하세요. 사용자 규칙이나 여러 설정 전환, 재정의가 필요하다면 YAML 가이드에서 항목별로 조정한 뒤 변경할 때마다 이 절의 확인 절차를 반복하세요.

Clash 구독 가져오기 및 프록시 설정