Windows
「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. 다운로드 페이지에 표시된 아키텍처와 대조한 뒤 설치 패키지를 선택하면 됩니다. 클라이언트를 바꾸기 전에는 기존 프로그램을 종료하고 시스템 트레이의 백그라운드 프로세스도 끝났는지 확인하세요. 두 인스턴스가 같은 포트를 동시에 사용하려는 상황을 방지할 수 있습니다.
INSTALL / PLATFORM
먼저 운영체제와 프로세서 종류를 확인한 다음 클라이언트를 선택하세요. 같은 프로젝트에서도 아키텍처별 설치 패키지를 따로 제공할 수 있으므로 이름이 비슷해도 서로 바꿔 설치하면 안 됩니다. 처음 사용한다면 GUI 클라이언트가 편리합니다. 설정 가져오기, 연결 확인, 정책 전환을 모두 화면에서 할 수 있습니다. 라우터나 서버에서 네트워크 서비스를 직접 관리하는 경우에는 코어만 별도로 설치하는 방법도 고려해 보세요.
「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. 다운로드 페이지에 표시된 아키텍처와 대조한 뒤 설치 패키지를 선택하면 됩니다. 클라이언트를 바꾸기 전에는 기존 프로그램을 종료하고 시스템 트레이의 백그라운드 프로세스도 끝났는지 확인하세요. 두 인스턴스가 같은 포트를 동시에 사용하려는 상황을 방지할 수 있습니다.
「이 Mac에 관하여」에서 칩 또는 프로세서 항목을 확인한 다음 Apple 칩용이나 Intel용 설치 패키지를 선택하세요. 메뉴 막대에 클라이언트 아이콘이 보이는 것은 보통 프로그램이 실행 중이라는 뜻일 뿐입니다. 설정을 가져온 뒤에는 해당 설정이 활성화되어 있는지 확인하고, 필요한 경우 시스템 프록시를 켜세요.
기기의 앱 아키텍처에 맞는 설치 패키지를 선택하세요. 휴대전화 모델에 ‘64비트’라고 표시되어 있다는 이유만으로 패키지를 결정할 수는 없습니다. 처음 연결할 때는 시스템의 VPN 권한 요청을 확인하세요. 기기에서 다른 로컬 VPN을 사용 중이었다면 연결을 끊어야 하는지 확인한 후 새 클라이언트를 시작하세요.
다운로드 페이지에서 Clash Plus의 App Store 페이지로 이동해 앱 상세 정보의 시스템 요구 사항을 확인하세요. 설치 후에는 먼저 클라이언트가 지원하는 가져오기 형식을 살펴보세요. 연결을 설정할 때 시스템 안내에 따라 VPN 구성을 추가한 다음, 클라이언트로 돌아와 현재 어떤 설정을 사용 중인지 확인하세요.
먼저 배포판에서 지원하는 패키지 형식을 확인하고 아키텍처를 대조하세요. 데스크톱 환경이라면 GUI 클라이언트를 고려할 수 있습니다. 명령줄만 사용하는 환경에서는 설정 디렉터리, 프로세스 시작 방법, 로그 저장 위치를 직접 관리해야 합니다. 다른 기기로 옮길 때는 기본 설정뿐 아니라 규칙 세트와 로컬 파일 참조도 확인하세요.
이전 가이드에 나온 버튼이 새 클라이언트에서는 다른 위치에 있을 수 있습니다. 특히 지원이 종료된 Clash for Windows에서 옮기는 경우에는 직접 추가한 규칙과 오버라이드를 보존하고, 새 클라이언트에서 설정을 다시 가져오세요. 기존 작업 디렉터리 전체를 그대로 복사하지 마세요. 설정 파일 외에도 캐시와 예전 인터페이스에서만 쓰이는 설정이 들어 있을 수 있습니다.
CONFIG / INSPECTION
문제를 진단할 때는 세 가지를 나눠 살펴보세요. 요청이 코어에 들어왔는지, 어떤 규칙에 매칭됐는지, 마지막으로 어떤 아웃바운드를 사용했는지 확인하면 됩니다. 아래 예시는 각 설정 항목을 설명하기 위한 것으로, 그대로 바꿔 넣을 수 있는 전체 설정 파일은 아닙니다. 항목의 허용 값과 의존 관계는 전체 설정 항목 레퍼런스에서 확인하세요.
규칙 모드에서는 목록을 위에서 아래로 확인하며, 일치하는 항목을 찾으면 이후 규칙은 검사하지 않습니다. 특정 하위 도메인을 기본 도메인과 다른 경로로 보내려면 정확한 도메인 규칙을 먼저 쓰고, 범위가 더 넓은 도메인 접미사 규칙을 뒤에 둔 다음 마지막에 기본 규칙을 추가하세요. 전역 모드와 달리 규칙 모드에서는 하나의 설정에서 여러 아웃바운드를 지정할 수 있습니다. 수정 후에는 연결 기록에서 실제로 매칭된 규칙을 확인하세요. 규칙이 사용자 지정 프록시 그룹을 가리킨다면 규칙에 적힌 이름과 그룹 이름이 정확히 일치하는지도 확인해야 합니다.
mode: rule
rules:
- DOMAIN,blocked.example.com,REJECT
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECT
프록시 그룹을 사용하면 규칙과 실제 아웃바운드를 분리할 수 있습니다. 규칙에는 그룹 이름을 지정하고, 그룹에서 실제로 사용할 경로를 결정합니다. 직접 선택하는 그룹은 고정 경로를 쓰거나 임시로 비교 테스트할 때 적합합니다. 자동 지연 측정 그룹은 테스트 주소와 측정된 지연 시간을 기준으로 후보를 선택합니다. 아래 예시의 노드 두 개는 같은 설정 파일에 정의되어 있어야 합니다. 그룹 이름을 바꾸면 해당 그룹을 참조하는 규칙도 함께 수정하세요. 측정 결과는 테스트 주소에 대한 응답만 보여 주므로 다운로드 속도가 느리거나 연결이 끊기는 문제를 진단할 때는 실제 서비스 주소도 테스트해야 합니다.
proxy-groups:
- name: 수동 아웃바운드
type: select
proxies:
- 노드 A
- 노드 B
- DIRECT
도메인 이름이 아직 정상적으로 조회되지 않았다면 노드를 바꿔도 문제가 해결되지 않을 수 있습니다. 먼저 클라이언트 로그에서 DNS 조회 시간 초과가 있었는지 확인한 다음, 브라우저와 운영체제, 코어 중 어느 쪽에서 조회 요청을 보내는지 살펴보세요. 코어의 DNS 기능을 켰다고 해서 모든 앱이 해당 설정을 사용하는 것은 아닙니다. 예시에서는 결과를 비교하기 쉽도록 실제 IP 주소를 반환하는 모드를 사용합니다. 실제로 사용할 DNS 서버는 로컬 네트워크 환경과 설정 요구 사항에 맞춰 선택하고, 한 번에 한 항목씩 바꾼 뒤 다시 테스트하세요.
dns:
enable: true
enhanced-mode: redir-host
nameserver:
- 223.5.5.5
시스템 프록시는 앱이 프록시 설정을 읽고 따르는 경우에 동작합니다. 반면 TUN은 가상 네트워크 인터페이스와 라우팅을 통해 트래픽을 가져오므로 시스템 프록시를 사용하지 않는 앱을 처리하는 데 적합합니다. 정상적으로 활성화되는지는 권한, 플랫폼, 기존 라우팅 설정에 따라 다릅니다. 처음 테스트할 때는 기존 트래픽 처리 방식을 기록하고 한 가지 방식만 켠 뒤 외부 사이트와 로컬 네트워크 기기를 각각 확인하세요. 활성화 후 사내 네트워크나 프린터에 연결할 수 없다면 기존 설정으로 되돌리고 라우팅 변경 사항을 확인한 다음 예외 트래픽 처리 방법을 결정하세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
혼합 포트 하나로 HTTP와 SOCKS 프록시 요청을 모두 받을 수 있습니다. 앱에 설정하는 주소와 포트는 원격 노드가 아니라 로컬 리스너를 가리킵니다. 이 기기에서만 사용할 때는 루프백 주소로 바인딩하세요. 포트가 이미 사용 중이라면 어떤 프로세스가 해당 포트를 리슨하는지 먼저 확인하세요. 포트를 바꾼 뒤에는 브라우저나 터미널에 직접 입력한 프록시 주소도 함께 업데이트해야 합니다. 그렇지 않으면 클라이언트는 실행되더라도 해당 앱은 이전 포트에 계속 연결하거나 다른 프록시 프로세스에 잘못 연결될 수 있습니다.
mixed-port: 7890
allow-lan: false
SETUP / FIRST RUN
처음 테스트할 때는 평소 접속할 수 있는 사이트를 선택하고 프록시를 켜기 전 상태를 기록해 두세요. 이후에는 한 번에 설정 하나만 변경하세요. 문제가 생기면 바로 이전 단계로 돌아가 어떤 변경 이후에 문제가 시작됐는지 확인할 수 있습니다.
클라이언트의 「설정」 또는 「구독」 메뉴에서 파일 가져오기를 선택하거나 신뢰할 수 있는 출처의 구독 URL을 입력하세요. 가져온 뒤 해당 설정을 선택하고 규칙과 프록시 그룹이 로드됐는지 확인하세요. 목록에 항목이 있다고 해서 코어가 실제로 사용 중인 것은 아닙니다. 파싱 오류가 발생하면 먼저 메시지에 표시된 항목이나 줄 번호를 기록하세요. 기존 파일은 보관하고 복사본에서 들여쓰기, 목록 계층 또는 항목 유형을 수정하세요.
규칙 모드로 테스트한 다음 관련 프록시 그룹에서 아웃바운드를 하나 선택하세요. 데스크톱에서는 시스템 프록시 설정을 따르는 앱을 먼저 테스트할 수 있습니다. 모바일에서는 클라이언트 안내에 따라 시스템 VPN을 설정하세요. 모드와 노드, 트래픽 처리 방식을 한꺼번에 바꾸지 마세요. 터미널 도구 하나만 프록시로 연결하려는 경우에는 전체 기기의 라우팅을 바꾸지 말고 해당 도구의 문서에 따라 프록시 주소를 설정해도 됩니다.
테스트 페이지를 연 다음 클라이언트의 연결 목록에서 대상 도메인을 찾아 규칙과 아웃바운드를 확인하세요. 연결 기록이 없다면 먼저 앱의 트래픽이 클라이언트로 들어오는지 확인하세요. 기록은 있지만 기본 규칙에 매칭됐다면 규칙 순서와 도메인 표기를 다시 살펴보세요. 올바른 규칙에 매칭됐는데도 시간 초과가 발생한다면 대상 사이트와 선택한 아웃바운드의 연결 상태를 확인하세요. 오류가 발생하면 시간, 모드, 오류 메시지를 기록하고 로그를 공유하기 전에 구독 URL과 인증 정보를 삭제하세요.
지연 시간 측정 요청과 웹페이지 요청은 서로 다른 규칙을 따를 수 있고, 대상 주소도 다를 수 있습니다. 먼저 웹페이지 요청이 연결 목록에 표시되는지 확인한 다음 실제 아웃바운드를 살펴보세요. 지연 시간은 해당 테스트를 한 번 수행했을 때의 결과만 보여 줍니다. 관련 용어는 용어집에서 확인하세요.
먼저 정상적으로 사용할 수 있는 설정을 보존하세요. 업데이트 오류가 요청 시간 초과인지, 인증 실패인지, 형식 파싱 오류인지 확인하고 원인에 맞게 처리하세요. 원격 콘텐츠를 가져올 수 없는 경우 클라이언트를 반복해서 재설치해도 대개 해결되지 않습니다. 용어집에서 구독과 로컬 설정의 차이를 먼저 확인해 보세요.
명령줄 프로그램이 시스템 프록시 설정을 반드시 읽는 것은 아닙니다. 환경 변수를 읽는 도구도 있고 별도로 설정해야 하는 도구도 있습니다. 먼저 해당 도구의 문서를 확인한 다음 클라이언트에 인바운드 연결 기록이 있는지 살펴보세요. 트래픽 처리 방식은 용어집을 참고하세요.
SOURCE / MAINTENANCE
프로젝트 이름, 클라이언트 이름, 구독 제공자는 서로 다른 개념입니다. 설정 항목을 확인할 때는 실제로 설정을 불러오는 코어가 무엇인지 먼저 살펴보세요. 설치나 업데이트, 인터페이스 문제가 있다면 해당 클라이언트의 문서를 확인하면 됩니다.
Clash 생태계에서는 인바운드, 아웃바운드, 규칙을 YAML로 정의해 왔습니다. mihomo는 이전에 Clash.Meta로 불리던 코어 프로젝트를 이어갑니다. 예전 자료에 과거 명칭이 남아 있는 것은 흔한 일입니다. 오래된 문서의 인터페이스 화면이나 매개변수를 볼 때는 어떤 프로젝트에 해당하는지 먼저 확인하세요. 이름이 비슷하다는 점은 검색 단서일 뿐, 특정 설정 항목이 여전히 유효한지 판단하거나 두 설치 패키지가 같은 관리 주체에서 제공된다고 단정하는 근거가 될 수 없습니다.
mihomo 소스 저장소는 GPL-3.0 오픈소스 라이선스를 따르며, 상위 저장소에서 코드와 변경 내역, 이슈 논의를 확인할 수 있습니다. 이 라이선스는 코어 프로젝트에 적용되며 모든 GUI 클라이언트가 같은 라이선스를 따른다는 뜻은 아닙니다. GUI 프로젝트는 각자 인터페이스와 시스템 연동, 배포 패키지를 관리합니다. 구독은 설정 제공자가 관리하며, 구독을 업데이트해도 클라이언트가 바뀌거나 새 코어가 시스템에 설치되지는 않습니다.
코어는 인바운드를 처리하고 규칙에 따라 아웃바운드를 선택해 연결을 수행합니다. GUI 클라이언트는 이러한 정보를 보여 줄 뿐 아니라 구독, 오버라이드, 전역 설정을 병합한 다음 결과를 코어에 전달하기도 합니다. 설정 파일에 규칙이 있는데도 인터페이스에서 적용되지 않는다면 먼저 활성 설정을 확인하고, 이어서 오버라이드가 적용되는 순서를 살펴본 뒤 연결 기록과 대조하세요. 편집기에 표시된 원본 파일만 확인하면 클라이언트가 나중에 추가한 설정을 놓치기 쉽습니다.
설치 패키지를 바꾸는 경우 먼저 클라이언트의 릴리스 노트를 확인하세요. 규칙 문법, DNS 동작, 가상 네트워크 인터페이스 지원과 관련된 변경은 사용 중인 코어의 변경 내역도 살펴봐야 합니다. 업데이트 전에 현재 설정과 트래픽 처리 방식을 기록하고 로컬 규칙과 오버라이드의 복사본을 저장하세요. 업데이트 후에는 같은 대상을 사용해 테스트하세요. 규칙 하나만 추가하려는 경우 프로그램, 규칙 세트, 구독을 동시에 업데이트하기보다 해당 규칙만 따로 저장하고 테스트하는 편이 변경 원인을 찾기 쉽습니다.
NOTES / LATEST
연결 기록이 없다면 먼저 프록시가 요청을 처리하고 있는지 확인하세요. 기록은 있지만 경로가 예상과 다르다면 모드를 살펴보세요. 클라이언트를 바꿀 때는 꼭 필요한 기능과 설정을 옮기는 방법을 먼저 확인하세요.
두 가지 경로로 나누어 확인하세요. 브라우저에서는 프록시 확장 프로그램과 시스템 설정이 덮어쓰였는지 살펴보고, 터미널에서는 http_proxy 환경 변수와 명령줄 도구의 프록시 설정 처리 방식을 확인하세요.
플랫폼 지원, 코어 버전, 인터페이스, TUN 지원, 구독 관리 기능을 기준으로 주요 클라이언트를 비교하고 사용 환경에 맞는 선택 방법을 소개합니다.
트래픽 흐름도를 통해 rule, global, direct 세 가지 모드의 판정 방식을 설명하고 일상 사용, 문제 진단, 속도 측정에 맞는 전환 방법을 안내합니다.