시작 전: 유효한 구독 준비하기
클라이언트를 설치했다고 바로 프록시 출구를 사용할 수 있는 것은 아닙니다. 유효한 설정 구독 주소나 프록시 및 분기 설정이 포함된 YAML 파일이 필요합니다. 구독은 이용 중인 서비스 제공자에게서 받아야 하며, 이 사이트에서는 노드나 구독 계정을 제공하지 않습니다. 서비스 관리 페이지에서 「Clash」, 「Clash Meta」 또는 「Mihomo」 구독 메뉴를 찾아 전체 주소를 복사하세요. 브라우저 주소창에 표시된 계정 관리 페이지 주소를 구독 주소로 착각하지 않도록 주의하세요.
처음 설정할 때는 네트워크를 제어 중인 다른 프록시 클라이언트나 VPN 도구를 종료하는 것이 좋습니다. 프록시 연결 없이도 현재 기기에서 일반 웹페이지를 열 수 있는지 확인하고, 시스템 날짜와 시간이 올바른지도 살펴보세요. 그래야 이후 문제가 생겼을 때 기존 네트워크, 구독 다운로드, 새 설정 중 어디에서 원인이 발생했는지 구분할 수 있습니다. 데스크톱에서는 우선 TUN을 켜거나 DNS를 변경하지 마세요. 최소한의 설정으로 확인 가능한 연결부터 만드세요.
구독 주소에는 계정 식별 정보가 포함될 수 있으므로 비밀번호처럼 안전하게 보관하세요. 전체 주소를 공개 댓글에 붙여 넣거나 출처가 불분명한 온라인 변환 사이트에 입력하지 마세요. 도움을 요청할 때는 오류 문구와 클라이언트 이름, 작업 단계를 공유하고 스크린샷에 구독 주소나 계정 정보가 있다면 먼저 가리세요.
01 구독 가져와 설정 활성화하기
클라이언트의 「설정」 또는 「구독」 페이지를 열고 「URL에서 가져오기」, 「구독 추가」 또는 링크 추가 기능이 있는 버튼을 찾으세요. 복사한 구독 주소를 빠짐없이 붙여 넣습니다. 이름 입력란이 있으면 알아보기 쉬운 이름을 지정해도 됩니다. 설명 문구나 공백, 줄바꿈이 함께 복사되지 않았는지 주소의 앞뒤를 확인한 다음 「가져오기」, 「다운로드」 또는 「저장」을 누르세요. 클라이언트는 보통 먼저 내용을 가져온 뒤 프록시, 정책 그룹, 규칙을 파싱합니다.
다운로드가 끝나면 설정 카드나 파일 목록이 나타나며 이름과 업데이트 시간이 함께 표시될 수 있습니다. 가져온 뒤에는 설정을 활성화해야 합니다. 설정 카드를 누르거나 카드 메뉴에서 「사용」 또는 「활성화」를 선택하세요. 현재 설정 표시가 새 항목으로 이동했는지 확인한 뒤 「프록시」 페이지를 여세요. 정책 그룹과 선택 가능한 항목이 보여야 코어에 설정이 로드된 것입니다. 파일이 목록에 보이는 것만으로는 설정이 적용됐다고 판단할 수 없습니다.
기존 YAML 파일 가져오기
서비스 제공자가 로컬 파일을 제공했다면 같은 설정 페이지에서 「파일에서 가져오기」를 선택하고 다운로드한 .yaml 또는 .yml 파일을 불러온 뒤 앞서 안내한 방법으로 활성화하세요. 웹페이지를 파일로 저장한 다음 확장자만 바꾸지는 마세요. 로그인 페이지가 그대로 저장될 수 있습니다. 파일로 가져오면 보통 로컬 사본이 만들어지며, 자동 업데이트 여부는 클라이언트와 설정 출처에 따라 다릅니다. URL 구독처럼 계속 업데이트된다고 단정하지 마세요.
가져오기에 실패하면 먼저 실패한 단계를 확인하세요
다운로드 시간 초과나 연결 불가 메시지가 표시되면 먼저 현재 네트워크에서 구독 서비스에 접속할 수 있는지, 링크가 만료되지는 않았는지 확인하세요. 설정이 아직 로드되지 않았을 수 있으므로 프록시 모드를 바로 바꾸지 마세요. yaml: unmarshal errors, 형식 오류 또는 파싱 불가 메시지가 나오면 응답 내용과 클라이언트가 지원하는 설정 형식을 확인해야 합니다. 링크가 웹페이지나 오류 메시지를 반환했거나 Clash 설정이 아닌 주소일 수 있습니다. 의미를 모르는 상태에서 메시지를 없애려고 설정 전체를 삭제하지 마세요.
구독을 업데이트한 뒤에는 현재 설정 표시를 다시 확인해 예상한 항목이 실제로 사용 중인지 확인하세요. 서비스에 따라 정책 그룹 이름이 바뀌어 기존에 선택한 출구가 더 이상 맞지 않을 수 있습니다. YAML과 다른 구독 형식의 차이는 용어 설명의 구독 및 설정 파일 항목을 참고하세요. 다운로드가 계속 실패하면 문제 해결에서 구독 오류 절차에 따라 점검하세요. 이 단계의 완료 기준은 간단합니다. 설정이 활성화되어 있고 프록시 페이지에 해당 정책 그룹이 보여야 합니다. 그런 다음 모드를 선택하세요.
02 규칙 모드와 출구 선택하기
설정을 불러온 다음 홈, 「프록시」 또는 「설정」에서 「규칙 / 전역 / 직접 연결」 모드를 찾으세요. 처음에는 「규칙」을 선택합니다. 이 모드에 해당하는 설정 키는 mode: rule입니다. 현재 설정의 규칙에 따라 요청별 출구를 선택하므로 일부 요청은 직접 연결하고 다른 요청은 지정된 정책 그룹으로 보낼 수 있습니다. 트래픽 분기는 설정 내용에 따라 달라지며, 클라이언트가 모드 이름만으로 모든 사이트의 용도를 자동으로 판단하는 것은 아닙니다.
이어서 「프록시」 페이지에서 규칙에 실제로 지정된 주요 정책 그룹을 찾으세요. 「Proxy」, 「노드 선택」 또는 서비스 제공자가 정한 이름으로 표시될 수 있으니 가이드와 같은 그룹 이름을 찾을 필요 없이 현재 설정을 기준으로 확인하세요. 정책 그룹을 펼쳐 사용 가능한 프록시 출구를 선택합니다. 그룹에 「자동 선택」이나 「장애 조치」 하위 그룹이 있다면 설정에 맞게 선택해도 되지만, 하위 그룹에 실제로 사용할 수 있는 항목이 포함되어 있는지 확인하세요.
프록시 모드 변경과 정책 그룹의 출구 선택은 별개의 작업입니다. 규칙 모드를 선택했더라도 규칙에서 참조하는 정책 그룹의 출구가 DIRECT라면 해당 요청은 직접 연결됩니다. 반대로 규칙에서 사용하지 않는 정책 그룹의 출구를 바꿔도 현재 웹페이지에는 영향이 없을 수 있습니다. 처음 테스트할 때는 주요 정책 그룹만 조정하고 기존 선택을 기록해 두세요. 비교 기준을 잃지 않도록 모든 그룹을 한꺼번에 바꾸지 마세요.
전역 모드와 직접 연결 모드는 언제 사용하나요?
「전역」 모드에서는 코어가 처리하는 요청이 전역 정책 그룹을 사용합니다. 규칙 모드에서 실패한 웹페이지가 전역 모드에서는 열리는지 잠시 비교할 때 유용하며, 전역에서 성공한다면 규칙 매칭이나 정책 그룹 선택을 추가로 확인해야 합니다. 이 모드가 기기의 모든 앱을 제어한다는 뜻은 아닙니다. 앱 트래픽이 코어로 들어오는지는 시스템 프록시, VPN 또는 TUN 설정에 따라 달라집니다. 전역 모드로 바꾼 뒤에는 전역 정책 그룹에서 어떤 출구를 선택했는지도 확인하세요.
「직접 연결」 모드에서는 코어가 처리하는 요청이 직접 연결 출구를 사용합니다. 프록시 출구를 잠시 우회해 비교할 때 적합하지만 클라이언트가 종료되거나 시스템 프록시 설정이 해제되는 것은 아닙니다. 테스트가 끝나면 「규칙」으로 되돌리고 주요 정책 그룹의 선택을 확인하세요. 정책 그룹과 규칙, 출구의 관계가 여전히 헷갈린다면 정책 그룹 설명을 참고하세요. 일상적인 사용법은 FAQ에서 확인할 수 있습니다. 이 페이지에서는 기본 연결을 계속 설정합니다.
03 연결 및 시스템 트래픽 제어 켜기
클라이언트 홈 화면이나 「설정」으로 돌아가 코어가 실행 중인지 확인하세요. 일부 데스크톱 클라이언트는 실행 시 코어도 자동으로 시작하지만, 「시작」을 눌러야 하는 경우도 있습니다. 코어 시작에 실패했다는 메시지가 나오면 관련 로그의 첫 오류부터 확인하고 다른 스위치는 더 켜지 마세요. 시스템 프록시가 앱 요청을 올바른 곳으로 보내려면 로컬 프록시가 정상적으로 연결을 수신해야 합니다. 시스템 스위치가 켜져 있다는 사실만으로 코어가 실행 중이라고 볼 수는 없습니다.
데스크톱에서는 먼저 시스템 프록시 켜기
Windows, macOS 등의 데스크톱 환경에서는 우선 「시스템 프록시」를 켜고 TUN은 꺼 둡니다. 시스템 프록시는 보통 시스템 프록시 설정을 따르는 브라우저와 앱을 로컬 수신 주소로 연결합니다. 프록시를 켠 뒤에는 클라이언트를 계속 실행해 두세요. 프로세스를 종료했는데 시스템 프록시가 여전히 로컬 포트를 가리키면 브라우저가 연결되지 않을 수 있습니다. Linux 데스크톱 환경마다 프록시 지원이 다르고 앱별로 프록시를 설정해야 할 수도 있으므로 스위치 상태만으로 모든 프로그램이 제어되고 있다고 판단하지 마세요.
브라우저에서 별도의 프록시 전환 확장 프로그램을 사용 중이라면 시스템 설정을 사용하도록 바꾸거나 잠시 비활성화하세요. 클라이언트가 설정한 프록시 주소를 덮어쓰지 않도록 하기 위한 조치입니다. 다른 프록시 소프트웨어와 VPN 연결도 종료하세요. 먼저 하나의 클라이언트만 네트워크를 제어하도록 하고 기본 연결이 정상인지 확인한 뒤 복잡한 조합을 고려하세요. 이 단계에서 설정, 포트, 모드를 동시에 바꾸면 실패 원인을 찾기 어렵습니다.
모바일에서 시스템 VPN 권한 확인하기
Android와 iOS에서는 보통 「연결」 또는 「시작」을 누르면 시스템 VPN 권한 요청이 표시됩니다. 방금 설치해 직접 실행 중인 클라이언트에서 보낸 요청인지 확인한 뒤 연결을 허용하세요. 앱으로 돌아와 연결 상태를 확인하고 시스템 VPN 상태에서도 터널이 연결됐는지 살펴보세요. VPN 표시는 트래픽을 제어하는 방식일 뿐, 구독에 포함된 모든 출구를 사용할 수 있다는 뜻은 아닙니다. 이후 웹페이지와 연결 기록을 통해 다시 확인해야 합니다.
시스템에서 다른 VPN이 사용 중이라고 알리면 해당 앱의 연결을 먼저 끊고 현재 클라이언트로 돌아와 다시 연결하세요. Android에서 백그라운드로 전환할 때 자주 끊긴다면 첫 연결 확인을 마친 뒤 배터리 최적화와 백그라운드 실행 제한을 살펴보세요. iOS에서는 시스템 VPN 설정에서 현재 연결에 올바른 구성이 사용되는지 확인할 수 있습니다. 백그라운드 유지 문제와 첫 구독 가져오기를 한꺼번에 처리하지 마세요. 자세한 단계는 모바일 문제 해결을 참고하세요.
로컬 포트 확인하기: 서둘러 변경하지 마세요
데스크톱의 「포트 설정」에서 흔히 볼 수 있는 혼합 포트는 mixed-port: 7890이며 HTTP와 SOCKS 프록시 연결을 모두 받습니다. 설정에 따라 다른 포트를 사용할 수 있으므로 실제로 수신 중인 포트를 기준으로 확인하세요. 앱에 프록시를 직접 입력할 때 주소는 보통 127.0.0.1이며, 포트에는 클라이언트에 표시된 혼합 포트를 입력합니다. external-controller: 127.0.0.1:9090은 제어 인터페이스 주소이므로 브라우저의 프록시 포트로 입력하면 안 됩니다.
로그에 address already in use가 표시되면 먼저 해당 포트를 사용하는 다른 클라이언트를 종료한 다음 다시 시작하세요. 혼합 포트를 꼭 바꿔야 한다면 기존 값을 기록하고 새 값을 저장한 뒤 클라이언트 안내에 따라 다시 불러오세요. 시스템 프록시와 프록시를 직접 설정한 앱도 새 포트를 사용하는지 확인해야 합니다. 처음 사용할 때는 「LAN 연결 허용」을 켤 필요가 없습니다. 다른 기기가 이 기기에 접속하는 기능으로, 현재 기기의 연결 성공 여부와는 별개입니다.
04 웹페이지와 실제 요청 경로 확인하기
이제 브라우저에서 새 탭을 열고 현재 설정에서 프록시를 사용해야 하는 사이트와 직접 연결되어야 하는 사이트에 각각 접속하세요. 낯선 테스트 사이트 하나만으로 판단하지 말고 평소에 사용할 수 있는 익숙한 페이지를 선택하는 것이 좋습니다. 필요한 경우 새 요청이 발생하도록 페이지를 새로고침하세요. 브라우저 캐시나 이미 연결된 세션이 이전 상태를 사용할 수 있으므로 설정을 바꾼 직후 기존 페이지를 보기만 하면 새 설정이 적용되지 않았다고 착각하기 쉽습니다.
이어서 클라이언트의 「연결」 페이지를 열고 방금 방문한 사이트를 새로고침하세요. 해당 도메인으로 발생한 새 요청을 찾아 어떤 규칙이 적용됐는지, 어떤 정책 그룹과 출구를 사용했는지 확인합니다. 일부 클라이언트에서는 연결 상세 정보나 요청 경로에서 확인할 수 있습니다. 웹페이지가 열리고 요청 경로도 예상과 일치해야 홈 화면의 연결 표시보다 신뢰할 만한 결과입니다. DIRECT가 표시되더라도 반드시 오류는 아니므로 해당 사이트가 원래 직접 연결되어야 하는지 먼저 확인하세요.
웹페이지는 열리지만 연결 페이지에 기록이 없음
먼저 페이지가 캐시된 내용을 보여 주는 것이 아니라 새 요청을 실제로 보냈는지 확인한 다음 브라우저가 시스템 프록시를 사용하는지 살펴보세요. 특정 앱에만 기록이 없다면 별도의 프록시 설정을 사용하거나 시스템 프록시를 따르지 않을 수 있습니다. 이때 구독을 바로 바꾸지 말고 「트래픽이 클라이언트로 들어오지 않는 문제」와 「들어온 뒤 출구에서 실패하는 문제」를 구분하세요. 추가로 트래픽을 제어해야 한다면 TUN을 고려하거나 앱 자체 안내에 따라 프록시를 설정하세요.
요청은 클라이언트에 표시되지만 웹페이지가 열리지 않음
「로그」 페이지를 열고 우선 info 수준을 사용해도 됩니다. 실패한 페이지에 다시 접속한 뒤 같은 시각의 오류를 확인하세요. i/o timeout은 작업 시간이 초과됐다는 뜻이므로 대상 주소와 연결 단계를 함께 살펴봐야 합니다. no such host는 도메인 이름 확인 실패를, connection refused는 해당 연결이 거부됐음을 나타냅니다. 마지막 단어만 떼어 원인을 판단하지 말고 발생 시각과 관련 요청을 함께 기록하면 문제를 더 정확히 확인할 수 있습니다.
주요 정책 그룹에서 출구를 하나 바꾼 뒤 같은 페이지를 다시 시도하고 결과가 달라지는지 확인하세요. 계속 실패하면 잠시 전역 모드로 바꾸고 전역 출구를 확인해 분기 문제인지 비교한 다음 규칙 모드로 되돌립니다. 시간 초과가 계속되면 노드 시간 초과 문제 해결을 확인하세요. 규칙이 지역 판별이나 데이터베이스 로드와 관련된 경우에는 GeoIP 관련 문제 진단도 참고하세요. 더 이상 무작정 재설치할 필요는 없습니다. 원인을 좁혀 대응할 정보가 충분합니다.
확인 후 재현할 수 있도록 설정 유지하기
두 테스트 페이지가 모두 예상대로 작동하는지 확인한 뒤 현재 설정과 규칙 모드, 확인된 주요 정책 그룹 출구를 유지하세요. 구독을 업데이트할 때는 설정 페이지에서 「업데이트」를 누르고 완료될 때까지 기다린 다음 활성화 상태를 확인합니다. 목록에 새 항목이 생겼다고 현재 사용하는 설정을 무작정 삭제하지 마세요. 규칙을 직접 수정하기 전에는 복구할 수 있는 사본을 저장하고 클라이언트가 덮어쓰기나 병합을 지원하는지도 확인하세요. 다음 구독 업데이트 때 로컬 수정 사항이 덮어써지지 않도록 주의해야 합니다.
마지막으로 정상적으로 연결을 끊을 수 있는지 테스트하세요. 데스크톱에서는 먼저 시스템 프록시를 끈 다음 클라이언트에서 안내하는 「종료」 방법으로 앱을 닫습니다. 모바일에서는 「연결 해제」 또는 「중지」를 사용하세요. 일반 웹페이지에 계속 접속할 수 있는지 확인한 뒤 다시 연결해 같은 작업을 반복할 수 있는지도 확인합니다. 부팅 후 자동 연결이 필요하다면 먼저 Clash 시작 시 자동 실행 안내를 읽고 클라이언트 시작, 코어 실행, 시스템 프록시 활성화의 차이를 확인하세요. 첫 설정은 여기까지입니다. TUN, LAN 공유, 사용자 지정 DNS는 필요할 때만 추가하세요.