Clash Dashboard 가이드：시각적으로 프록시 관리하기

대시보드로 무엇을 할 수 있나요

Clash 코어가 실행되면 RESTful API를 노출하며, Web 대시보드(Dashboard)는 바로 이 API를 기반으로 구축된 그래픽 관리 인터페이스입니다. 클라이언트에서 노드를 클릭해 선택하는 것보다 대시보드는 훨씬 풍부한 정보와 조작 기능을 제공하며, 특히 고급 사용자가 문제를 진단하고 설정을 최적화하는 데 적합합니다.

대시보드를 통해 다음이 가능합니다:

• 그래픽으로 노드 전환, 각 프록시 그룹의 현재 선택 항목 및 지연 확인;
• 노드 원클릭 속도 테스트로 각 회선 성능 직관적 비교;
• 실시간 연결 목록 확인(도메인, 대상, 규칙, 트래픽);
• 로그 확인으로 연결 실패 및 규칙 매칭 이상 위치 파악;
• 일부 설정 온라인 편집(대시보드 구현에 따라 다름, 예: MetaCubeXD는 규칙 편집 지원).

대부분의 현대 Clash 클라이언트(Clash Verge Rev, Clash Meta for Android 등)에는 대시보드 입구가 내장되어 있으며, API를 통해 연결하는 독립적인 Web 대시보드도 사용할 수 있습니다.

외부 제어 인터페이스 활성화

대시보드는 external-controller를 통해 Clash 코어와 통신합니다. 설정 파일에서 이 인터페이스를 활성화해야 합니다:

127.0.0.1:9090은 로컬 머신에서만 접근 가능함을 의미하며, 로컬 대시보드 연결에 적합합니다. secret은 API 접근 키로, 대시보드 연결 시 입력해야 하며 무단 접근을 방지합니다. secret을 설정하지 않으면 해당 포트에 접근할 수 있는 모든 프로그램이 Clash를 제어할 수 있어 보안 위험이 있습니다.

수정 후 설정을 리로드해야 합니다. Clash Verge Rev 등의 클라이언트는 설정에서 보통 「외부 제어」 스위치를 제공하며, 활성화하면 자동으로 설정에 기록되므로 사용자가 직접 YAML을 편집할 필요가 없습니다.

주요 Web 대시보드

Yacd / Yacd-meta

고전적인 경량 대시보드로 인터페이스가 간결하며 Clash와 Clash Meta 모두 호환됩니다. 노드 전환, 속도 테스트, 연결 확인, 규칙 표시를 지원합니다. 온라인 버전(예: yacd.haishan.me)으로 배포하거나 로컬에 다운로드하여 브라우저에서 열고 API 주소로 로컬 Clash에 연결할 수 있습니다.

MetaCubeXD

Clash Meta 코어에 최적화된 기능 완비의 현대적 인터페이스입니다. 연결 상세 정보, 규칙 편집, 설정 관리, 로그 필터링 등을 지원합니다. Clash Verge Rev에 내장된 대시보드가 바로 MetaCubeXD를 기반으로 하며 사용 경험이 유연합니다.

Zashboard

비교적 새로운 대시보드 프로젝트로 인터랙션 디자인이 우수하고 정보 표시가 풍부하며 다크 모드를 지원합니다. 모던 UI를 선호하는 사용자에게 적합하며, 마찬가지로 external-controller를 통해 연결합니다.

대시보드 선택은 주로 개인 습관과 클라이언트 통합 상황에 달려 있습니다. Clash Verge Rev를 사용한다면 「대시보드」 버튼을 클릭하기만 하면 됩니다. Yacd-meta는 온라인 경량 인터페이스를 선호하는 사용자에게, MetaCubeXD와 Zashboard는 연결 문제를 심층 진단해야 하는 고급 사용자에게 더 적합합니다. 여러 대시보드를 시험해보고 가장 편한 것을 찾아 장기적으로 사용하면 됩니다.

대시보드 연결 단계

1. Clash가 실행 중이고 설정에서 external-controller가 활성화되었는지 확인합니다.
2. 대시보드를 엽니다(클라이언트 내장 입구, 또는 대시보드 온라인/로컬 주소 접속).
3. 연결 설정에서 API 주소를 입력합니다. 예: 127.0.0.1:9090 또는 http://127.0.0.1:9090.
4. secret을 설정한 경우 키 입력란에 동일한 값을 입력합니다.
5. 연결을 클릭합니다. 성공하면 Proxies 페이지에서 속도 테스트 및 노드 전환, Connections 페이지에서 실시간 연결 확인이 가능합니다.

연결에 실패하면 확인하세요: Clash가 실행 중인지, 포트가 사용 중인지, 방화벽이 차단하는지, secret이 일치하는지. Android에서 대시보드와 Clash가 다른 기기에 있다면 external-controller를 0.0.0.0:9090으로 변경하고 같은 LAN 내에 있는지 확인하세요. 반드시 강력한 secret을 설정하세요.

대시보드 주요 기능

Proxies 페이지

모든 프록시 그룹과 그룹 내 노드를 표시하며 클릭으로 전환, 일괄 속도 테스트가 가능합니다. url-test 그룹은 현재 선택된 노드와 지연을 표시하여 자동 정책이 정상 작동하는지 쉽게 확인할 수 있습니다.

Connections 페이지

현재 활성 연결을 나열하며, 소스 주소, 대상 도메인/IP, 매칭 규칙, 사용 노드, 업/다운 트래픽을 포함합니다. 「특정 사이트가 어떤 규칙을 통해 어떤 노드를 사용하는지」 진단할 때 매우 유용합니다.

Rules 페이지

일부 대시보드(MetaCubeXD 등)는 규칙 목록 보기를 제공하여 현재 로드된 전체 규칙 및 매칭 순서를 확인할 수 있습니다. 「특정 도메인이 왜 직접 연결되는지」 진단할 때 Connections 페이지의 적중 규칙 필드와 Rules 페이지를 대조하면 규칙 순서 문제인지 규칙 세트가 업데이트되지 않은 문제인지 빠르게 파악할 수 있습니다. 이 기능을 잘 활용하면 설정을 무작정 수정하는 시간을 크게 줄일 수 있습니다.

보안 주의 사항

external-controller 인터페이스는 노드 전환, 설정 수정, 모든 연결 확인을 포함한 Clash의 완전한 제어 권한을 갖습니다. 공개 네트워크에 노출되고 인증이 없으면 악의적으로 악용될 수 있습니다.

일상적인 사용에서는 127.0.0.1 바인딩을 유지하여 로컬 대시보드 연결만 허용하는 것이 안전하고 간단합니다.

모바일 및 원격 접근

Android 버전 Clash Meta는 보통 간소화된 대시보드를 내장하고 있어 앱 내에서 직접 노드를 전환할 수 있습니다. 컴퓨터 브라우저로 스마트폰의 Clash를 관리하려면 스마트폰의 external-controller를 LAN 주소(예: 0.0.0.0:9090)로 설정하고, 컴퓨터에서 http://스마트폰IP:9090에 접속하여 secret을 입력하세요. 반드시 신뢰할 수 있는 LAN 내에서만 사용하고 공개 네트워크에 노출하지 마세요.

Clash Verge Rev 등의 데스크톱 클라이언트 대시보드는 로컬에서 열리므로 추가 네트워크 설정이 필요 없어 가장 편리한 방법입니다. 고급 사용자는 NAS나 VPS에 대시보드를 배포하고 Tailscale, WireGuard 등의 내부 네트워크 터널링을 통해 안전하게 접근할 수 있습니다. 어떤 방식이든 보안을 최우선으로 하여 제어 인터페이스를 신뢰할 수 없는 네트워크에 노출하지 마세요.

문제 해결 팁

대시보드 연결에 실패하면 먼저 터미널에서 curl http://127.0.0.1:9090을 실행하여 API가 응답하는지 테스트하세요. 401이 반환되면 secret이 필요한 것이고, 연결이 거부되면 Clash가 실행 중인지, 포트가 올바른지 확인하세요. Logs 페이지에 대량의 DNS 또는 rule 관련 오류가 나타나면 설정 파일 문법 문제일 가능성이 높으므로 문서를 참고하여 항목별로 확인하세요. 정기적으로 Connections와 Logs를 확인하는 습관을 들이면 문제가 커지기 전에 발견하고 처리할 수 있어 Clash 운영이 더 통제 가능하고 투명해집니다.

정리

Web 대시보드는 커맨드라인 방식의 프록시 관리를 직관적인 그래픽 조작으로 바꿔주어 속도 테스트, 전환, 문제 해결이 더 효율적입니다. external-controller를 활성화하고, secret을 설정하고, 편한 대시보드를 선택하여 연결하기만 하면 됩니다. 일상적인 사용에서는 클라이언트 내장 대시보드가 가장 편리하고, 고급 진단 시에는 Connections와 Logs 페이지가 트래픽 분기 및 연결 문제를 찾는 핵심 도구입니다. 접근 보안 보호를 잘 갖춰 API 노출로 인한 위험을 방지하세요. 대시보드의 각 기능에 익숙해지면 Clash 운영 효율이 크게 향상되어 설정 파일을 수정해야 했던 많은 작업을 대시보드에서 원클릭으로 완료할 수 있습니다.