입문 가이드 / 첫 연결
Clash 구독 가져오기와 연결 확인
클라이언트를 설치하고 Clash 구독 링크나 로컬 YAML 설정 파일을 준비하세요. 처음 설정할 때는 앱 하나와 대상 사이트 하나만 테스트하면 문제가 설정, 트래픽 전달, 출구 중 어디에서 발생하는지 파악하기 쉽습니다.
구독을 가져와 설정 적용하기
설정 제공업체의 페이지에서 Clash 또는 mihomo용이라고 표시된 구독 링크를 복사하세요. 구독 주소는 클라이언트가 설정을 가져오는 주소이지, 로그인 페이지나 특정 노드의 상세 페이지 주소가 아닙니다. 로컬 YAML 파일만 있다면 파일에서 가져오면 되며, 다른 곳에 먼저 업로드할 필요는 없습니다. 구독 주소에는 접근 정보가 포함될 수 있으니 오류를 문의할 때는 오류 메시지만 공유하고 전체 주소나 설정 내용을 올리지 마세요.
링크에서 가져오거나 파일에서 불러오기
클라이언트의 ‘설정’ 또는 ‘구독’ 페이지를 열고 추가를 누른 다음 URL에서 가져오기를 선택합니다. 전체 링크를 붙여넣고 가져오기 또는 저장을 눌러 설정 이름이 목록에 나타날 때까지 기다리세요. 추가와 업데이트가 별도 작업인 클라이언트라면 항목을 추가한 뒤 해당 항목의 ‘업데이트’를 눌러 다운로드나 파싱이 성공했는지 확인합니다. 로컬 파일을 사용하려면 같은 메뉴에서 ‘파일에서 가져오기’를 선택하고 파일 선택 창에서 설정 제공업체가 제공한 YAML 파일을 고르세요.
가져오기에 실패하면 먼저 클라이언트에 표시된 내용을 확인하세요. 시간 초과라면 기기가 인터넷에 연결되어 있는지 확인한 뒤, 현재 네트워크에서 구독 주소에 접속할 수 있는지 제공업체에 문의합니다. 권한이 없거나 링크가 만료되었다는 메시지가 나오면 원래 제공처에서 유효한 주소를 다시 받으세요. 가져온 내용을 파싱할 수 없다면 현재 클라이언트에 맞는 설정 주소를 복사했는지, 웹페이지 주소를 복사한 것은 아닌지 확인합니다. 로컬 파일을 가져오지 못할 때는 오류에 표시된 줄과 필드 이름을 기준으로 원본 파일을 점검하세요. 오류 하나를 없애려고 규칙 전체를 함부로 삭제하지 마세요. 필드의 의미를 확인하려면 설정 필드 참고를 살펴보세요.
목록에서 사용할 설정 선택하기
설정 목록에 항목이 있다는 것은 클라이언트에 설정이 저장되었다는 뜻일 뿐입니다. 방금 가져온 항목을 선택하고 ‘사용’, ‘활성화’ 또는 현재 설정으로 지정하는 메뉴를 찾아 선택 표시가 해당 항목에 있는지 확인하세요. 그런 다음 ‘프록시’ 또는 ‘정책’ 페이지를 엽니다. 설정에 정책 그룹이 있다면 그룹 이름과 사용 가능한 출구 옵션이 보여야 합니다. 이전 설정의 그룹 이름이 계속 보인다면 다시 가져올 필요 없이 설정 페이지에서 전환이 제대로 되었는지 확인하세요.
구독 업데이트와 설정 적용은 서로 다른 작업입니다. 업데이트는 파일을 다시 가져오고, 적용은 현재 코어에서 사용할 설정을 결정합니다. 이미 작동하는 설정이 있다면 새 설정이 4단계 확인을 통과할 때까지 기존 항목을 남겨 두어도 됩니다. 현재 설정이 올바른지 확인했다면 다음 단계에서 프록시 페이지의 모드를 선택하세요.
규칙 모드와 출구 정책 선택하기
‘프록시’ 페이지, 홈 화면 또는 트레이 메뉴에서 모드 설정을 찾아 처음에는 ‘규칙’을 선택하세요. 규칙 모드에서는 코어에 전달된 요청을 설정에 적힌 규칙 순서대로 처리합니다. 규칙에 따라 요청을 직접 연결하거나 차단하거나 특정 정책 그룹으로 보낼 수 있습니다. 모드를 바꿔도 시스템 프록시가 자동으로 켜지지는 않습니다. 이 단계에서는 코어에 들어온 요청을 어떻게 처리할지만 정합니다.
정책 그룹을 찾은 뒤 출구 선택하기
설정에는 일반 그룹, 용도별 그룹, 자동 선택 그룹이 함께 있을 수 있습니다. 이름은 설정 작성자가 정하므로 안내 화면과 같을 필요는 없습니다. 규칙 목록이나 설정 설명에서 테스트 사이트가 속한 그룹을 확인하고 해당 그룹을 여세요. 수동 선택 그룹에서는 사용 가능한 출구 하나를 선택하고 선택 표시를 확인합니다. 그룹 안에 하위 정책 그룹이 있다면 현재 선택을 따라가 최종 출구까지 확인하세요. 테스트 사이트에 원래 직접 연결 규칙이 적용된다면 프록시 그룹을 바꿔도 해당 사이트에는 영향이 없습니다.
자동 선택 그룹은 미리 정해진 방식으로 출구를 검사하거나 전환하므로 구성원 하나를 직접 고정할 수 없는 경우가 많습니다. 처음 문제를 점검할 때는 출구를 직접 선택할 수 있는 수동 그룹을 사용해 보세요. 설정에 자동 그룹만 있다면 기본 선택을 유지하고, 연결을 확인할 때 실제로 사용된 출구를 기록하면 됩니다. 목록에 속도 측정 결과가 표시되더라도 해당 출구가 그 테스트에 응답했다는 뜻일 뿐입니다. 현재 브라우저 요청이 클라이언트에 들어왔는지 증명하지는 않으며, 대상 사이트 접속 테스트를 대신할 수도 없습니다.
전역 및 직접 연결 모드는 비교용으로만 사용하기
전역 모드는 일반적인 분기 규칙에 따라 출구를 하나씩 결정하지 않으며, 대개 전역 정책에서 사용할 출구도 선택해야 합니다. 트래픽이 코어에 전달된 것을 확인한 뒤 규칙 모드와 잠시 비교할 때 유용합니다. 전역 모드에서는 접속되지만 규칙 모드로 돌아오면 실패한다면 적용된 규칙과 선택한 정책 그룹을 살펴보세요. 직접 연결 모드는 코어에 들어온 요청을 바로 내보내는 기능이며, 클라이언트의 시스템 프록시나 VPN을 끄는 것과는 다릅니다. 원래 직접 연결해야 하는 요청까지 다른 경로로 보낼 수 있으므로 전역 모드를 규칙 수정 대신 계속 사용하지 마세요.
이제 규칙 모드와 방금 선택한 출구를 유지하고, 당분간 규칙이나 설정을 바꾸지 마세요. ‘출구’, ‘정책 그룹’, ‘규칙’의 관계는 언제든 용어집에서 확인할 수 있습니다. 첫 연결에서는 규칙이 경로를 고르고 정책 그룹이 사용할 수 있는 출구를 정한다는 점만 기억하면 됩니다.
앱 트래픽을 클라이언트로 보내기
먼저 클라이언트에서 코어가 실행 중인지, 시작 실패 메시지는 없는지 확인하세요. 데스크톱에서 가장 간단하게 테스트하려면 시스템 프록시를 켠 뒤 시스템 프록시 설정을 사용하는 브라우저로 요청을 보냅니다. 모바일에서는 클라이언트 홈 화면의 연결 스위치를 사용하세요. 처음 확인할 때는 테스트에 필요한 경로만 켜면 됩니다. 시스템 프록시와 TUN을 동시에 켤 필요는 없습니다. 그러지 않으면 사이트가 열리더라도 실제로 어떤 경로가 트래픽을 가져갔는지 판단하기 어렵습니다.
데스크톱: 시스템 프록시 켜기 또는 앱에 프록시 지정
클라이언트 홈 화면이나 트레이 메뉴에서 ‘시스템 프록시’를 켜고 스위치가 계속 켜져 있는지 확인하세요. 일부 화면에는 로컬 수신 주소와 포트가 함께 표시됩니다. 이는 앱이 요청을 코어에 전달하는 위치이며 원격 노드 주소가 아닙니다. 스위치를 켜자마자 꺼진다면 시스템 설정 적용 실패, 코어 시작 실패 또는 포트 충돌이 표시되는지 확인하세요. 포트가 사용 중이라면 다른 프록시 클라이언트가 실행 중인지 먼저 살펴보고, 여러 포트를 무작정 바꾸지 마세요.
Linux 데스크톱 환경에 따라 시스템 프록시 스위치 지원 여부가 다를 수 있습니다. 클라이언트에 해당 스위치가 없거나 테스트 앱이 시스템 설정을 따르지 않는다면 앱 자체의 프록시 설정에 클라이언트 화면에 표시된 로컬 주소, 포트, 프로토콜을 입력하세요. 예를 들어 화면에 HTTP 또는 HTTP를 지원하는 혼합 인바운드가 명시되어 있다면 앱에서 HTTP 프록시를 선택합니다. 이곳에 구독 링크를 붙여넣지 마세요. 테스트 후 수동 설정을 더 이상 사용하지 않는다면 같은 위치에서 원래 값으로 되돌리세요.
모바일: 연결을 시작하고 시스템 권한 확인하기
클라이언트 홈 화면으로 돌아와 현재 설정이 1단계에서 적용한 설정인지 확인한 뒤 ‘연결’을 누르세요. 처음 시스템의 VPN 권한 요청이 나타나면 설정 중인 클라이언트에서 보낸 요청인지 확인하고 안내에 따라 허용합니다. 클라이언트로 돌아와 연결 상태가 될 때까지 기다린 후 테스트할 앱으로 전환하세요. 일부 기기는 상태 표시줄에 VPN 아이콘을 표시합니다. 이 아이콘은 시스템 터널이 만들어졌다는 뜻일 뿐, 특정 규칙이 적용되었거나 원격 출구를 사용할 수 있다는 증거는 아닙니다.
연결이 바로 끊기면 다른 VPN 연결이 이미 실행 중인지, 기기 관리 정책이 연결 생성을 제한하는지 확인하세요. 테스트를 위해 업무 기기에 필요한 연결이나 보안 설정을 해제하지 마세요. 데스크톱 앱이 시스템 프록시를 사용하지 않고 자체 프록시 설정도 없는 것이 확실할 때만 클라이언트가 지원하는 TUN을 고려하세요. 권한 요구 사항, 트래픽 처리 범위, DNS 처리 방식은 먼저 용어집에서 확인할 수 있습니다. 첫 브라우저 테스트 전에 TUN을 켤 필요는 없습니다.
연결 기록에서 실제 출구 확인하기
먼저 클라이언트의 ‘연결’ 또는 ‘로그’ 페이지를 열고 테스트 앱에서 예상 경로를 알고 있는 사이트에 접속하세요. 새 연결을 만들도록 테스트 브라우저를 종료했다가 다시 열고 새 페이지를 여는 것이 좋습니다. 이미 열려 있는 탭은 캐시를 사용하거나 기존 연결을 재사용할 수 있어 페이지가 새로고침되는지만으로는 이번 요청의 경로를 알기 어렵습니다. 사이트에서 여러 도메인을 불러온다면 이미지나 글꼴 요청이 아니라 주소 표시줄에 나온 기본 사이트를 기준으로 확인하세요.
대상, 규칙, 실제 출구 대조하기
기록에서 접속 시간과 대상 도메인을 기준으로 방금 보낸 요청을 찾으세요. 화면에 규칙, 정책 경로, 출구 정보가 있다면 어떤 규칙이 적용되었는지, 어느 그룹으로 전달되었는지, 마지막에 직접 연결 또는 선택한 출구 중 무엇을 사용했는지 차례로 확인합니다. DIRECT가 표시되어도 반드시 문제가 있는 것은 아닙니다. 대상이 원래 직접 연결되어야 하고 페이지도 정상적으로 열린다면 규칙이 제대로 적용된 것입니다. 프록시 경로를 확인하려면 프록시 그룹으로 보내야 하는 대상 하나를 골라 같은 방법으로 점검하세요.
일부 클라이언트는 연결 목록에 현재 진행 중인 요청만 표시하므로 짧은 연결은 이미 사라졌을 수 있습니다. 로그 페이지에서 같은 시간대의 기록을 찾거나 연결 페이지를 열어 둔 채 요청을 다시 보내 보세요. 그래도 기록이 없는데 요청은 성공한다면 테스트 앱이 시스템 프록시를 사용하는지, 프록시 확장 기능이 설정을 덮어쓰는지, 앱이 기존 연결을 계속 쓰는지 확인하세요. 터미널 도구와 브라우저의 프록시 설정 방식은 다를 수 있습니다. 브라우저에서 확인에 성공해도 터미널이 같은 경로를 자동으로 사용한다는 뜻은 아닙니다.
증상에 맞춰 한 가지씩 바꾸고 다시 테스트하기
기록은 있지만 경로가 예상과 다르다면 대상 도메인과 적용된 규칙을 먼저 확인한 다음 해당 정책 그룹에서 다른 출구가 선택되어 있는지 살펴보세요. 규칙은 순서대로 적용되므로 앞쪽의 더 넓은 조건이 이번 요청에 먼저 적용되었을 수 있습니다. 경로는 맞지만 요청이 실패한다면 현재 규칙은 그대로 두고 로그에서 이름 확인, 원격 연결, 노드 핸드셰이크 중 어느 단계에서 오류가 발생했는지 확인하세요. 선택한 출구가 원인이라고 확인된 경우에만 같은 수동 그룹에서 다른 출구로 바꿔 비교합니다. 한 번에 하나만 바꾸고 같은 대상으로 다시 테스트해야 어떤 변경이 효과가 있었는지 알 수 있습니다.
대상 사이트가 정상적으로 열리고 기록에도 예상한 경로가 표시되면 첫 설정이 끝난 것입니다. 비교를 위해 전역 또는 직접 연결 모드로 바꿨다면 규칙 모드로 되돌리세요. 데스크톱에서 프록시를 잠시 중지하려면 먼저 시스템 프록시를 끈 뒤 클라이언트를 종료합니다. 테스트 앱에 로컬 프록시를 직접 입력했다면 해당 설정도 원래대로 돌리세요. 모바일에서는 클라이언트 홈 화면에서 연결을 끊습니다. 사용자 규칙 추가, DNS 조정, 설정 재정의를 관리하려면 이어서 mihomo 설정 필드 참고를 살펴보세요.