Clash 설정 가이드

시작 전 준비: 클라이언트와 구독

설치 파일에는 클라이언트 프로그램만 포함되며, 설치한다고 원격 노드를 자동으로 사용할 수 있는 것은 아닙니다. 시작하기 전에 서비스 제공업체가 발급한 구독 링크나 노드, 정책 그룹, 규칙이 포함된 호환 설정 파일을 준비하세요. 구독 링크에는 개인 인증 정보가 포함되는 경우가 많으므로 계정 비밀번호처럼 안전하게 관리해야 합니다. 화면 캡처를 제출해야 한다면 전체 링크, QR 코드, 인증 매개변수는 가리고 오류 메시지와 필요한 설정 이름만 남기세요.

클라이언트를 처음 실행하면 메인 화면이 정상적으로 표시되는지 확인하고 설정, 프록시, 설정 메뉴, 로그로 이동하는 위치를 찾으세요. 일부 데스크톱 클라이언트는 창을 닫아도 트레이나 메뉴 막대에서 계속 실행됩니다. 창을 닫는 것만으로 코어가 종료되는 것은 아닙니다. 이때는 설정을 불러오기 전까지 시스템 프록시와 TUN을 꺼 두세요. 설정을 불러온 뒤 시스템에 연결하면 ‘프록시는 켜졌지만 설정은 준비되지 않은’ 상태로 인터넷이 끊기는 일을 줄일 수 있습니다.

컴퓨터나 휴대폰에서 다른 프록시, VPN 또는 네트워크 제어 도구를 사용 중이라면 설정을 저장한 뒤 연결을 끊고 이번 테스트를 진행하세요. 여러 도구가 시스템 프록시, 라우팅 또는 DNS를 동시에 변경하면 실제 연결 경로와 화면에 표시되는 내용이 달라질 수 있습니다. 조직에서 관리하는 기기는 고정 프록시 정책이 설정되어 있을 수 있으니 기기 관리 지침을 따르고, 관리 대상 네트워크 설정을 임의로 덮어쓰지 마세요.

아래 절차는 호환되는 구독이 준비된 상태에서 시작합니다. 각 단계의 결과를 확인한 뒤 다음으로 넘어가세요. 설정이 불러와졌는지 확인하고, 정책을 선택한 다음 시스템에 연결한 뒤 실제 연결 기록을 확인합니다. ‘구독’, ‘노드’, ‘코어’ 같은 용어가 낯설다면 먼저 용어 설명을 읽어 보세요. 첫 연결을 위해 YAML 파일 전체를 수정할 필요는 없습니다.

1단계: 구독 가져오기 및 활성화

원격 구독 링크 추가

서비스 제공업체의 계정 페이지에서 Clash 또는 mihomo용 구독 링크를 복사한 다음 클라이언트의 구독 또는 설정 페이지를 엽니다. ‘추가’, ‘새 설정’, ‘URL에서 가져오기’ 메뉴를 찾으세요. 알아보기 쉬운 이름을 입력하고 주소 입력란에 링크를 붙여 넣은 뒤 다운로드, 가져오기 또는 저장을 누릅니다. 붙여 넣은 뒤 주소가 유효하지 않다는 메시지가 표시되면 안내 문구, 앞뒤 공백, 줄바꿈이 함께 복사되지 않았는지 확인하세요. 링크의 인증 매개변수는 직접 삭제하거나 수정하지 마세요.

추가한 뒤 다운로드가 끝날 때까지 기다립니다. 정상이라면 설정 목록에 입력한 이름과 업데이트 결과, 업데이트 시간, 파일 크기 등의 정보가 표시됩니다. 표시 항목은 클라이언트마다 다를 수 있습니다. 목록에 항목이 생긴 것은 가져오기 과정의 중간 단계일 뿐입니다. ‘사용’, ‘활성화’를 누르거나 해당 설정 카드를 선택하세요. 그런 다음 프록시 페이지에서 구독에 정의된 정책 그룹과 노드가 보이는지 확인해야 로컬 설정이 완료된 것입니다.

일부 클라이언트는 ‘원격 구독 항목’과 ‘현재 실행 중인 설정’을 구분합니다. 원격 항목을 업데이트해도 실행 중인 설정이 바로 바뀌지 않을 수 있고, 처음 추가한 항목이 저장만 되고 활성화되지 않을 수도 있습니다. 프록시 페이지에 이전 노드가 계속 보이면 설정 목록으로 돌아가 현재 선택 표시를 확인하고 새 설정을 직접 활성화한 뒤 로그에 파싱 오류가 있는지 확인하세요. 구독 목록에 카드가 추가된 것만으로 설정이 적용됐다고 판단하지 마세요.

로컬 파일 가져오기 및 형식 오류 해결

로컬 .yaml 또는 .yml 파일을 받았다면 ‘파일 가져오기’ 메뉴나 클라이언트에서 공식 지원하는 드래그 앤 드롭 기능을 사용하세요. 가져온 뒤에는 설정을 활성화해야 합니다. 노드 주소 목록과 완전한 Clash 설정은 서로 다른 형식입니다. 완전한 설정에는 보통 정책 그룹과 규칙도 정의되어 있습니다. 구독 유형을 선택할 때는 서비스 제공업체가 해당 클라이언트와 호환된다고 명시한 형식을 우선 사용하세요.

‘다운로드는 성공했지만 파싱에 실패했습니다’라는 메시지는 서버에서 내용을 받아 왔지만 현재 코어가 읽을 수 없다는 뜻인 경우가 많습니다. 로그인 페이지나 만료된 인증 안내, 다른 클라이언트 전용 형식이 반환되었거나 코어가 지원하지 않는 필드가 포함되면 이런 문제가 발생할 수 있습니다. 먼저 로그의 구체적인 오류를 확인한 뒤 서비스 제공업체에 구독 형식을 문의하세요. 프로토콜 지원 여부는 코어 및 설정 호환성을 참고하세요. 오류 주변의 필드를 임의로 삭제해 강제로 불러오지 마세요.

다운로드 실패 메시지가 바로 표시되면 주소, 인증, 네트워크 중 어디에 문제가 있는지 확인하세요. 링크가 현재 계정에서 발급되었고 아직 유효한지 확인한 다음 일반 네트워크에서 한 번 더 시도합니다. 일부 클라이언트에는 ‘프록시를 통해 구독 업데이트’ 옵션이 있지만, 처음 설정하는 단계에서는 사용할 수 있는 프록시가 아직 없을 수 있습니다. 무작정 켜면 업데이트에 프록시가 필요한 상황이 생길 수 있습니다. 개인 구독 링크를 모르는 온라인 변환 사이트에 보내지 마세요. 변환이 꼭 필요하다면 해당 서비스가 링크를 어떻게 처리하고 저장하는지 먼저 확인하세요.

2단계: 규칙 모드 및 노드 선택

메인 화면이나 설정 페이지에서 프록시 모드 메뉴를 열고, 처음에는 ‘규칙’ 또는 Rule을 선택하세요. 규칙 모드는 설정에 따라 각 연결에 사용할 정책을 결정합니다. 예를 들어 일부 대상은 직접 연결하고 다른 대상은 프록시 그룹을 거치게 할 수 있습니다. 이는 연결 정책을 선택하는 방식이지 시스템 연결 스위치가 아닙니다. 규칙 모드를 선택해도 시스템 프록시나 모바일 연결을 켜지 않았다면 다른 앱은 계속 일반 네트워크로 접속할 수 있습니다.

‘전역’ 또는 Global은 보통 코어로 들어오는 연결을 모두 전역 정책으로 전달합니다. 임시 비교 테스트에 적합하지만 해당 정책 그룹에서 노드를 선택해야 합니다. ‘직접’ 또는 Direct는 일반적으로 코어에 들어온 연결을 대상에 직접 연결하므로 원격 노드가 작동하는지 확인하는 용도로 사용할 수 없습니다. 테스트할 때는 한 번에 하나의 변수만 바꾸세요. 먼저 규칙 모드로 정상 연결을 확인하고, 필요하면 전역 모드로 잠시 전환해 비교한 뒤 규칙 모드로 되돌립니다.

정책 그룹에서 사용할 수 있는 노드 선택

프록시 또는 정책 그룹 페이지에서 직접 선택할 수 있는 그룹을 찾으세요. 그룹 이름은 설정을 만든 사람이 정하므로 ‘프록시 선택’일 수도 있고 다른 이름일 수도 있습니다. 반드시 PROXY라고 표시되는 것은 아닙니다. 그룹을 펼치고 노드를 누른 뒤 선택 표시가 해당 항목으로 이동했는지 확인하세요. 일부 그룹의 선택 항목에는 다른 정책 그룹이 포함될 수 있습니다. 이 경우 선택된 하위 그룹의 최종 노드까지 확인해 규칙에서 실제로 참조하지 않는 그룹만 바꾼 것은 아닌지 살펴보세요.

자동 선택, 장애 조치, 부하 분산 그룹은 각자 설정된 로직에 따라 출구를 결정하므로 특정 구성원을 직접 고정하지 못할 수 있습니다. 처음 문제를 확인할 때 설정에 수동 선택 그룹이 있다면 노드 하나를 고정해 자동 전환으로 인한 변수를 줄이세요. 이후 사용 목적에 맞게 자동 그룹으로 되돌리면 됩니다. 정책 그룹과 규칙의 연결 관계는 규칙 라우팅 안내에서 확인할 수 있습니다. 여기서 구독의 라우팅 목록을 다시 작성할 필요는 없습니다.

클라이언트의 테스트 버튼은 연결할 수 없는 후보 노드를 찾는 데 도움이 됩니다. 다만 측정 결과는 테스트한 주소, 연결 경로, 당시 조건에 따라 달라집니다. 표시된 수치가 모든 사이트에 접속할 수 있다는 뜻은 아니며, 시간 초과가 나왔다고 노드가 영구적으로 고장 난 것도 아닙니다. 노드를 선택한 뒤에는 실제 앱 접속과 연결 로그로 확인해야 합니다. 속도 측정 순위가 바뀌었다고 모드, DNS, TUN을 한꺼번에 조정하지 마세요. 문제의 원인을 찾기 어려워집니다.

프록시 페이지에 DIRECT, REJECT 같은 정책만 있고 예상한 노드가 없다면 1단계로 돌아가 구독이 제대로 불러와졌는지 확인하세요. 노드 목록은 정상인데 선택 직후 오류가 발생한다면 프로토콜이나 설정 필드와 관련된 오류인지 로그를 살펴봅니다. 이 단계가 끝나면 현재 규칙 모드, 사용 중인 정책 그룹, 선택한 출구 노드를 설명할 수 있어야 합니다. 그다음 시스템 연결을 설정하세요.

3단계: 연결 및 시스템 연결 활성화

데스크톱: 먼저 시스템 프록시 확인

먼저 클라이언트에 코어 실행 상태가 표시되는지 확인하거나 로그에서 로컬 프록시 포트가 수신 대기 중인지 확인하세요. 관리 화면을 열 수 있다고 해서 코어가 정상적으로 시작된 것은 아닙니다. 포트 충돌이나 설정 파싱 실패로 코어가 오류 상태에 머물 수 있습니다. 실행 상태를 확인한 뒤 ‘시스템 프록시’ 또는 Set as system proxy를 켜면 시스템 프록시를 지원하는 브라우저와 앱이 연결을 로컬 포트로 전달합니다.

일반적인 설정은 혼합 포트에서 HTTP와 SOCKS 연결을 모두 받지만, 실제 포트는 현재 클라이언트 설정을 따릅니다. 모든 설치에서 7890을 사용한다고 단정할 수는 없습니다. 설정 페이지에서 혼합 포트 또는 HTTP 포트를 확인한 뒤 운영체제의 프록시 주소가 127.0.0.1과 해당 포트를 가리키는지 확인하세요. 클라이언트가 자동으로 설정한다면 보통 직접 입력할 필요가 없습니다. 자동 설정이 실패했거나 문제를 점검할 때만 시스템 네트워크의 프록시 설정을 확인하세요.

시스템 프록시를 켠 뒤 브라우저 페이지를 새로고침하세요. 브라우저에 별도의 프록시 확장 프로그램이 설치되어 있다면 시스템 설정을 덮어쓸 수 있습니다. 먼저 확장 프로그램을 잠시 끄거나 시스템 프록시를 사용하도록 설정하세요. 명령줄, 일부 게임, 기타 앱은 시스템 프록시를 사용하지 않을 수 있으므로 브라우저에서 작동한다고 모든 프로그램에 적용되는 것은 아닙니다. 먼저 브라우저에서 확인한 뒤 다른 앱도 연결해야 하는지 살펴보세요.

모바일: 시스템 연결 권한 승인

모바일에서는 설정과 노드를 선택한 뒤 홈 화면의 연결 스위치를 누르세요. 처음 연결할 때 시스템 VPN 권한 대화상자가 표시되는 경우가 많습니다. 설치한 클라이언트에서 요청한 것인지 확인한 뒤 승인하세요. 여기서 VPN 인터페이스는 앱을 시스템 네트워크에 연결하는 방식일 뿐, 구독에 특정 프로토콜이 포함되었다는 뜻은 아닙니다. 연결이 설정되면 시스템에 VPN 표시가 나타날 수 있습니다. 표시만으로는 시스템 인터페이스가 시작됐다는 것만 확인할 수 있으므로, 출구와 규칙은 다음 단계에서 검증해야 합니다.

권한 요청을 취소했다면 클라이언트로 돌아가 연결을 다시 켜고 권한을 승인하세요. 휴대폰에서 다른 VPN 앱이 연결 중이라면 먼저 연결을 끊은 뒤 다시 시도합니다. 모바일 운영체제는 백그라운드 실행을 제한할 수 있으며, 특히 화면을 잠그거나 절전 모드일 때 연결이 끊길 수 있습니다. 실제로 백그라운드 연결이 끊기는 경우에만 시스템 설정에서 클라이언트의 백그라운드 권한을 확인하세요. 처음부터 문제와 관계없는 모든 배터리 옵션을 변경할 필요는 없습니다.

더 많은 앱을 연결해야 할 때 TUN 활성화

TUN은 가상 네트워크 인터페이스로 연결을 받아 시스템 프록시를 사용하지 않는 앱까지 처리해야 할 때 유용합니다. 데스크톱 클라이언트는 서비스를 설치하거나 관리자 권한을 부여하거나 가상 인터페이스 생성을 승인하도록 요청할 수 있습니다. 운영체제마다 메뉴와 권한 절차가 다르므로 현재 클라이언트의 안내를 따르세요. 권한 오류를 건너뛰려고 스위치를 계속 누르지 말고, 서비스가 설치되어 있고 코어가 관련 설정을 지원하는지 먼저 확인하세요.

첫 테스트에서는 데스크톱 시스템 프록시나 모바일 VPN 연결처럼 명확한 연결 경로 하나만 선택하세요. 이후 TUN을 활성화할 때 클라이언트가 시스템 프록시와 라우팅을 자동 조정하는지 확인합니다. 두 기능을 함께 사용할 수 있는지는 클라이언트 구현에 따라 다르므로 일률적으로 판단하지 마세요. DNS 처리, 라우팅 범위, 코어 기능에 관한 자세한 내용은 프로토콜 및 코어 기술 참고 자료를 확인하세요.

4단계: 규칙 및 연결 결과 확인

클라이언트의 연결 목록이나 로그 페이지를 연 다음 현재 설정에서 프록시를 거쳐야 하는 사이트에 브라우저로 접속하세요. 로그인이 필요 없는 페이지를 선택하고 새로고침해 브라우저가 새 연결을 만들도록 합니다. 기존 탭은 이전 연결을 재사용할 수 있고 페이지 캐시 때문에 새 네트워크 요청 없이도 페이지가 열릴 수 있습니다. 브라우저 화면만으로는 프록시 경로를 확인하기 어렵습니다.

연결 목록에서 해당 도메인이나 주소를 찾아 적용된 규칙, 정책 그룹, 최종 출구를 확인하세요. 화면에 DOMAIN-SUFFIX, GEOIP, MATCH 등이 표시될 수 있습니다. 이는 매칭 기준을 뜻합니다. DIRECT는 직접 연결, REJECT는 연결 거부를 의미합니다. 프록시 경로에는 정책 그룹 이름과 노드 이름이 표시되는 경우가 많습니다. 연결 기록이 나타나는지, 규칙이 예상과 일치하는지, 대상 페이지가 열리는지 세 가지를 함께 확인해야 적용 여부를 신뢰할 수 있습니다.

그런 다음 설정상 직접 연결되어야 하는 대상에도 접속해 직결 정책이 적용되는지 확인하세요. 규칙 모드에서는 대상에 따라 출구가 달라지므로 일부 페이지가 직접 연결되는 것은 정상일 수 있습니다. 반대로 대상이 잘못 직접 연결된다면 노드만 반복해서 바꾸지 말고 규칙과 정책 그룹을 확인하세요. 앱이 여러 도메인에 연결하는 경우 관련 연결을 함께 살펴봐야 합니다. 한 항목만 보고 앱 전체의 연결 경로를 판단할 수는 없습니다.

증상별 문제 범위 좁히기

접속을 시도해도 연결 목록에 새 기록이 전혀 없다면 먼저 시스템 연결을 확인하세요. 브라우저가 시스템 프록시를 사용하는지, 프록시 확장 프로그램이 설정을 덮어쓰는지, 모바일 VPN이 계속 연결되어 있는지, 필요한 TUN 경로를 켰는지 살펴봅니다. 일부 클라이언트는 특정 로그 수준에서만 상세 기록을 표시합니다. 따라서 ‘기록이 표시되지 않음’과 ‘연결이 코어에 도달하지 않음’을 구분하고, 비어 있는 목록 하나만으로 결론 내리지 마세요.

기록은 나타나지만 연결 시간 초과나 오류가 반복된다면 요청이 적어도 코어에 도달한 것입니다. 다음으로 선택한 노드와 대상에 연결할 수 있는지 확인하세요. 모드와 연결 방식은 그대로 두고 다른 후보 노드 하나만 선택해 다시 시도합니다. 특정 사이트 하나만 실패한다면 해당 사이트의 규칙과 관련 도메인을 확인하세요. 모든 프록시 대상이 실패하지만 직접 연결은 정상이라면 구독 유효성, 노드 인증, 서비스 상태를 점검합니다.

연결 기록의 정책이 올바른데 브라우저에 인증서 또는 보안 오류가 표시되더라도 연결을 위해 인증서 검증을 끄지 마세요. 먼저 기기 시간, 접속 도메인, 시스템 신뢰 설정을 확인합니다. 지원을 요청할 때는 클라이언트 이름, 운영체제, 연결 방식, 오류 원문, 발생 절차를 전달하세요. 로그에는 도메인, 주소, 구독 정보가 포함될 수 있습니다. 전송하기 전에 이번 오류와 관련된 부분만 남기고 민감한 내용은 삭제하세요.

검증이 끝나면 확인된 설정을 한 묶음으로 기록해 두세요. 현재 설정, 규칙 모드, 선택한 정책, 연결 방식이 포함됩니다. 나중에 ‘Clash 인터넷 연결 안 됨’ 문제가 생기면 먼저 이 상태와 비교하세요. 설정을 한 번에 하나씩 바꾸고 다시 확인하는 편이 포트, DNS, 노드, 모드를 동시에 변경하는 것보다 원인을 찾기 쉽고, 정상 작동하던 설정을 알 수 없는 상태로 바꾸는 일도 막을 수 있습니다.

일상적인 사용: 연결 해제 및 구독 업데이트

데스크톱에서 완전히 종료하려면 먼저 시스템 프록시나 TUN을 끈 다음 클라이언트의 종료 메뉴를 사용하세요. 프로세스를 강제 종료한 뒤 시스템에 로컬 포트를 가리키는 프록시 설정이 남아 있으면 브라우저가 이미 중지된 서비스에 계속 연결을 시도할 수 있습니다. 이 경우 클라이언트를 다시 열어 시스템 프록시를 끄거나 시스템 네트워크 설정에서 직접 추가한 프록시를 삭제하세요. 관리 대상 기기의 설정은 임의로 삭제하지 마세요.

모바일에서는 클라이언트의 연결 스위치나 시스템 VPN 관리 화면에서 연결을 끊으세요. 다음에 사용할 때 현재 설정과 노드가 원하는 항목인지 확인한 뒤 다시 연결하면 됩니다. 매번 구독을 새로 가져올 필요는 없습니다. 시스템 업데이트 후 권한을 다시 요청하면 새 안내에 따라 승인한 다음 연결 확인을 한 번 더 진행하세요.

구독을 업데이트하려면 설정 목록으로 돌아가 해당 항목의 업데이트 버튼을 누르고, 결과를 기다린 뒤 현재 실행 중인 설정도 갱신됐는지 확인하세요. 업데이트로 노드가 추가되거나 삭제되고 정책 그룹이 바뀌거나 기존 설정 내용이 덮어써질 수 있습니다. 이전에 선택한 노드가 더 이상 없을 수도 있습니다. 클라이언트에서 덮어쓰기나 설정 병합을 지원한다면 사용자 지정 항목은 별도의 전용 메뉴에 저장하세요. 원격 파일을 임시로 수정하는 방식은 장기 보관 방법으로 적합하지 않습니다.

이 페이지를 마치면 기본 연결 절차를 완료한 것입니다. 용어가 궁금하다면 프록시 및 트래픽 분기 용어 설명을, 프로토콜 비교나 mihomo 코어 기능, 규칙 조정이 필요하다면 기술 참고 자료를 확인하세요. 클라이언트를 바꾸기 전에 현재 연결 방식과 설정 출처를 기록한 뒤 설치 파일 페이지에서 플랫폼에 맞는 항목을 선택하세요. 클라이언트 차이를 구독 오류로 오해하는 일을 줄일 수 있습니다.