브라우저나 다른 앱에서 사용할 로컬 프록시 주소가 필요합니다. mixed-port는 하나의 포트에서 HTTP와 SOCKS 프록시 연결을 모두 받습니다. 먼저 클라이언트에 표시된 실제 수신 포트를 확인한 다음 앱 설정에 입력하세요. 이 포트는 노드 서버의 포트와 다릅니다. 실행 로그에 주소가 이미 사용 중이라고 나오면 다른 프록시 프로세스를 종료한 뒤 포트 변경을 고려하세요. 로컬에서만 사용할 때는 LAN 접근을 비활성화해 두세요. 여기서 rule은 규칙에 따른 라우팅을 뜻하며, 시스템 트래픽이 이미 코어로 전달된다는 의미는 아닙니다. 시스템 프록시나 TUN은 별도로 설정해야 합니다.
노드는 연결되는데 웹사이트가 열리지 않는다면 DNS부터 확인해 보세요. 코어 DNS를 활성화하면 fake-ip가 도메인과 이후 연결을 연결해 도메인 규칙에 따른 라우팅을 지원합니다. 단, 앱의 DNS 요청이 실제로 이 경로를 거쳐야 합니다. 아래는 설정 항목 예시일 뿐 TUN의 DNS 처리 설정은 포함하지 않습니다. 여러 출처의 DNS 설정을 그대로 합치지 말고, 특히 상위 DNS 서버가 아직 연결되지 않은 프록시에 의존하는지 확인하세요. LAN 기기 이름이나 특정 앱과 호환되지 않는 경우에는 필요에 따라 필터를 설정하고, 모든 도메인을 한꺼번에 제외하지 마세요.
노드는 연결 설정의 묶음이지, 프로토콜 이름만 바꿔 쓸 수 있는 서버 항목이 아닙니다. proxies의 type에 따라 필요한 설정 항목이 달라집니다. 주소, 포트, 암호화 방식과 인증 정보는 서비스 제공자가 안내한 값을 사용하세요. 아래에는 설명용 주소와 예시 비밀번호를 사용했으므로 실제 프록시 연결에는 사용할 수 없습니다. 프록시 그룹에서 이름으로 노드를 참조하므로 노드 이름은 고유해야 합니다. udp는 해당 노드에서 관련 트래픽 처리를 허용한다는 뜻이며, 실제 사용 가능 여부는 서버와 프로토콜, 시스템 트래픽 처리 방식에 따라 달라집니다. 구독을 업데이트할 때 직접 추가한 노드가 덮어써지는지도 확인하세요.
규칙은 보통 개별 노드가 아니라 프록시 그룹을 지정합니다. proxy-groups가 안정적인 참조 지점을 제공합니다. select는 사용자가 직접 선택하고, url-test는 테스트 결과를 바탕으로 선택하며, fallback은 순서대로 사용 가능한 출구를 찾고, load-balance는 알고리즘에 따라 연결을 분배합니다. 테스트 지연 시간이 낮아도 다운로드 속도가 빠르다는 뜻은 아니며, 특정 서비스에 접속할 수 있다는 보장도 없습니다. 처음에는 수동 선택 그룹 하나만 두고 노드가 정상인지 확인한 뒤 자동 정책을 추가하세요. 아래 노드 이름은 노드 목록과 일치해야 합니다. 그룹끼리 참조할 수도 있지만 서로 순환 참조해서는 안 됩니다.
rules는 위에서부터 순서대로 매칭되며, 보통 규칙 하나에 일치하면 출구가 결정됩니다. 따라서 구체적인 도메인 규칙을 범위가 넓은 지역 규칙보다 앞에 두세요. DOMAIN-SUFFIX는 해당 도메인과 하위 도메인에 일치합니다. DOMAIN-KEYWORD는 범위가 더 넓어 관련 없는 도메인까지 포함할 수 있습니다. GEOIP는 IP 지리 정보를 사용하므로 웹사이트의 실제 서비스 지역을 정확히 나타내지 않을 수 있습니다. 마지막에는 MATCH로 나머지 연결을 처리하세요. 수정한 뒤 연결 패널에서 어떤 규칙이 적용됐는지 확인하고 순서를 조정하세요. 전역 모드를 자주 전환하면 규칙 기반 라우팅 자체의 문제를 파악하기 어려워집니다.
구독에서 내려받은 파일을 직접 수정하면 다음 업데이트 때 변경 사항이 사라질 수 있습니다. 클라이언트의 오버라이드, 병합 또는 스크립트 기능을 사용하면 로컬 규칙을 별도로 저장한 뒤 코어가 읽을 최종 설정을 생성할 수 있습니다. prepend-rules와 append-proxies는 클라이언트별 병합 규칙이지, 모든 코어가 바로 인식하는 공통 설정 항목은 아닙니다. 아래는 해당 키를 지원하는 병합기의 구조 예시일 뿐이므로 사용 전에 클라이언트 문서를 확인하세요. 앞에 추가한 규칙은 우선순위가 높습니다. 노드를 추가했다고 해서 프록시 그룹에 자동으로 포함되는 것은 아닙니다. 적용 여부는 편집기의 원본 파일만 보지 말고 병합된 실행 설정에서 확인하세요.
먼저 운영체제를 선택한 뒤 프로세서 아키텍처를 확인하세요. GUI 클라이언트는 구독 가져오기, 설정 관리, 코어 제어를 담당합니다. 명령줄 코어만 사용하는 경우에는 설정 파일 경로와 실행 인수, 시스템 서비스를 직접 구성해야 합니다. 데스크톱이나 스마트폰에서 일상적으로 사용한다면 GUI 클라이언트부터 시작하는 편이 문제를 찾기 쉽습니다.
시스템 트레이 관리, 시스템 프록시, 규칙을 확인할 수 있는 GUI가 필요한 데스크톱 사용자에게 적합합니다. 다운로드 페이지에서 Clash Plus, Clash Verge Rev, FlClash 등의 클라이언트 다운로드를 안내하고 Clash for Windows 보관 자료도 제공합니다.
기존 클라이언트에서 옮길 때는 구독 주소와 사용자 규칙부터 백업하세요. 프로그램 폴더 전체를 그대로 복사하지 마세요. 설치 후 실행은 되지만 앱에서 프록시가 작동하지 않는다면 시스템 프록시 설정, 실제 포트, 앱 자체의 프록시 설정부터 확인한 뒤 TUN 사용을 고려하세요.
먼저 '이 Mac에 관하여'에서 Apple Silicon인지 Intel인지 확인한 뒤 맞는 설치 파일을 선택하세요. Clash Plus, Clash Verge Rev, FlClash는 인터페이스와 설정 관리 방식이 다릅니다. 자세한 시스템 요구 사항은 다운로드 페이지에서 확인하세요.
시스템 프록시와 터미널 환경 변수는 서로 다른 경로입니다. 브라우저에서 연결된다고 해서 명령줄 도구도 프록시를 사용하는 것은 아닙니다. 터미널에서 연결 문제가 발생하면 해당 도구가 지원하는 프록시 설정을 확인하세요. 보조 서비스를 설치할 때 권한이 필요하다면 클라이언트 안내에 따라 진행하면 됩니다.
스마트폰에서는 Clash Plus, Clash Meta for Android, FlClash, Surfboard 중에서 선택할 수 있습니다. 클라이언트마다 지원하는 구독 형식이 다를 수 있습니다. 파일을 성공적으로 내려받았다는 것은 가져오기가 완료됐다는 뜻일 뿐, 모든 설정 항목을 인식한다는 의미는 아닙니다.
처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 화면을 잠근 뒤 연결이 끊긴다면 배터리 관리와 백그라운드 실행 제한을 확인하세요. VPN 연결을 사용하는 다른 앱을 동시에 실행하면 충돌이 발생할 수도 있습니다. 앱별 라우팅을 설정할 때는 앱이 포함 목록과 제외 목록 중 어디에 속하는지 확인하세요.
다운로드 페이지에서 Clash Plus의 App Store 링크와 공식 웹사이트 clashplus.io를 확인할 수 있습니다. 설치 후 화면 안내에 따라 지원되는 설정을 가져오고, 프록시 그룹에서 선택할 수 있는 노드가 있는지 확인한 다음 시스템 VPN 설정 추가를 허용하세요.
Wi-Fi와 모바일 네트워크를 전환하면 DNS 환경과 사용할 수 있는 출구가 달라질 수 있습니다. 웹페이지가 계속 로딩된다면 구독 새로고침 실패인지, 노드 연결 실패인지, 특정 도메인의 규칙 문제인지 먼저 구분하세요. 데스크톱 클라이언트의 확장 스크립트가 모바일에서도 그대로 작동한다고 가정하지 마세요.
데스크톱에서는 Clash Verge Rev와 FlClash를 먼저 살펴보고, 서버나 라우터에서는 mihomo 코어를 고려하세요. 패키지 형식, 프로세서 아키텍처, 배포판의 실행 환경을 함께 확인해야 합니다. 파일 이름에 Linux가 포함되어 있다는 이유만으로 호환된다고 판단할 수는 없습니다.
명령줄 도구에는 보통 프록시 환경 변수를 별도로 설정해야 합니다. 시스템 서비스가 현재 터미널의 설정을 자동으로 이어받는 것도 아닙니다. 투명 프록시를 활성화하기 전에 로컬 프록시 포트로 기본 연결을 확인한 다음 라우팅, DNS, 방화벽을 점검하세요. 여러 네트워크 설정을 한꺼번에 바꾸면 원인을 찾기 어렵습니다.
설치 파일은 실행 환경을 준비하고, 구독은 연결 설정을 제공합니다. 이 사이트에서는 클라이언트와 설정 정보를 안내하지만, 소프트웨어 설치 후에는 유효하고 사용 권한이 있는 노드나 구독을 직접 준비해야 합니다. 공개 스크린샷, 문의 글, 공유 설정에 구독 주소나 인증 정보를 노출하지 마세요.
세 이름은 자주 함께 언급되지만 같은 것을 가리키지는 않습니다. 클라이언트는 사용 편의성을 기준으로 고르고, 설정 항목은 코어 문서에서 확인하며, 문제 해결은 실제 실행 설정을 살펴보세요. 각각의 역할을 구분해야 '프로그램을 바꾸니 해결됐다'는 문제도 구체적인 원인을 찾을 수 있습니다.
Clash는 규칙 기반 프록시 코어와 YAML 설정을 바탕으로 널리 쓰이는 사용 방식을 만들었습니다. 원래 Clash 프로젝트와 일부 초기 GUI 클라이언트의 유지 관리가 중단된 뒤에도 커뮤니티는 각기 다른 방향으로 개발을 이어왔습니다. 어떤 프로젝트는 인터페이스와 구독 관리에 집중하고, 다른 프로젝트는 코어의 프로토콜과 규칙 기능을 확장합니다. 따라서 'Clash 설정'은 생태계에서 흔히 쓰는 표현일 뿐, 모든 소프트웨어가 같은 설정 항목을 지원한다는 호환성 보장은 아닙니다.
Clash for Windows 지원 종료 후 대체 클라이언트를 고를 때는 현재 유지 관리 여부, 운영체제 지원, 설정 이전 비용을 기준으로 삼으세요. 익숙한 인터페이스인지 여부만으로 결정하지 않는 편이 좋습니다. 예전 가이드의 메뉴 위치, 보조 서비스 설치 방법, 기본 설정값은 현재 클라이언트와 다를 수 있습니다. 기존 설정을 참고용으로 보관하는 것은 유용하지만, 다시 가져온 뒤에는 구문 분석 결과와 프록시 그룹 참조, 시스템 트래픽 처리 방식을 확인해야 합니다.
GUI와 코어는 역할이 다릅니다
GUI 클라이언트는 보통 구독 다운로드, 설정 전환, 트레이 메뉴, 로그 표시를 담당합니다. mihomo 같은 코어는 설정 해석, 규칙 매칭, 도메인 확인, 연결 수립을 처리합니다. 인터페이스에 특정 스위치가 있다고 해서 설정 파일에 같은 이름의 항목이 반드시 있는 것은 아닙니다. 반대로 코어가 지원하는 확장 설정을 모든 클라이언트의 화면에서 직접 편집할 수 있는 것도 아닙니다. 문서를 확인할 때는 클라이언트 이름과 코어 종류를 함께 확인하세요.
mihomo는 Clash 생태계의 설정 방식을 바탕으로 기능을 확장해 왔으며, GPL-3.0 라이선스를 적용합니다. 저장소에서 소스 코드와 변경 내역, 이슈 논의를 확인할 수 있습니다. 이 라이선스는 해당 오픈소스 프로젝트에 적용되며 모든 서드파티 GUI, 앱 스토어 앱, 관련 서비스에 일괄 적용되는 것은 아닙니다. 이 사이트는 커뮤니티 정보를 정리하며, 각 클라이언트의 배포와 스토어 정보, 기능 범위는 해당 프로젝트가 결정합니다.
업데이트 전에는 변경 사항을, 후에는 결과를 확인하세요
클라이언트 업데이트, 코어 업데이트, 구독 새로고침은 서로 다른 작업입니다. 클라이언트를 업데이트하면 인터페이스와 시스템 연동이 바뀔 수 있고, 코어 업데이트는 설정 해석과 연결 동작에 영향을 줄 수 있습니다. 구독을 새로고침하면 주로 노드와 규칙 정보가 바뀝니다. 문제가 생기면 최근에 변경한 항목이 어느 계층인지 먼저 기록하세요. 구독 오류를 설치 파일 탓으로 돌리거나, 노드 하나가 작동하지 않는다고 소프트웨어를 반복해서 재설치하지 않도록 합니다.
현재 정상 작동하는 설정을 보관하고 한 번에 한 종류의 설정만 변경하는 것이 안전합니다. 다시 불러온 뒤 로그 오류를 확인하고 대상 앱의 실제 요청이 제대로 처리되는지 테스트하세요. 노드를 시험할 때는 조건을 일정하게 유지하고, 연결이 실패하면 발생 시각과 대상 도메인, 적용된 규칙을 기록하세요. 로그를 공유하기 전에는 서버 인증 정보와 구독 매개변수를 삭제하세요. 오류 화면만 담은 스크린샷보다 재현 가능한 절차가 문제 해결에 더 도움이 됩니다.
소스 코드 확인 · 로컬에 Git이 설치되어 있어야 합니다
git clone https://github.com/MetaCubeX/mihomo.git
저장소를 복제하면 소스 코드와 문서를 살펴볼 수 있지만, 클라이언트가 자동으로 설치되거나 사용할 노드가 제공되지는 않습니다. 일상적으로 사용하려면 다운로드 페이지에서 GUI 클라이언트를 선택하세요.
최근 게시물 / NOTES
구독 가져오기와 연결 문제 해결
먼저 설정을 가져오는 단계, 설정을 해석하는 단계, 연결을 수립하는 단계 중 어디에서 문제가 발생했는지 확인하세요. 각 글은 구체적인 상황을 중심으로 설명하므로 모든 설정 문서를 먼저 읽을 필요는 없습니다. 오류 메시지와 실제 설정을 함께 살펴보면 다음 조치를 찾기 쉽습니다.
플랫폼별 클라이언트에서 구독을 가져오는 방법을 안내하고 전체 YAML 설정, Base64 노드 목록, 단일 노드 링크의 차이를 비교합니다. 먼저 콘텐츠 형식을 확인한 뒤 바로 가져올지 변환 도구를 사용할지 결정하세요. 형식이 호환되지 않는 문제를 링크 오류로 오해하지 않도록 주의하세요.