Clash Dashboard 사용 가이드: 노드와 규칙을 시각적으로 관리

코어에 Dashboard가 필요한 이유

그래픽 인터페이스가 있는 클라이언트를 사용하고 있다면, 사실 내부적으로도 '코어 + 내장 패널' 조합으로 동작하며 패널이 클라이언트 창 안에 포함되어 있어 그 과정을 인지하지 못할 뿐입니다. 반면 macOS, Linux, 라우터에서 코어를 단독으로 실행한다면(먼저 튜토리얼 페이지의 일반적인 흐름을 참고하세요), 외부 Dashboard를 직접 연결해야 노드 목록, 실시간 트래픽, 로그, 규칙 매칭 상황을 볼 수 있습니다.

코어의 컨트롤 포트 활성화

코어는 기본적으로 설정 파일에 HTTP 컨트롤 포트를 열며, Dashboard는 이 포트를 통해 데이터를 읽고 씁니다. config.yaml에 다음과 같은 필드가 포함되어 있는지 확인하세요.

external-controller는 패널이 연결할 주소와 포트를 결정하며, secret은 접속 비밀번호입니다. 로컬에서만 사용한다면 비워둘 수 있지만, LAN 접근(allow-lan: true)을 활성화했다면 비밀번호 설정을 강력히 권장합니다.

Dashboard 패널 연결하기

컨트롤 포트는 본질적으로 표준화된 HTTP API이며, 시중의 여러 오픈소스 패널이 이를 통해 연결할 수 있고 사용법은 대체로 비슷합니다.

1. 브라우저에서 패널 페이지를 엽니다(일부 패널은 순수 프론트엔드 페이지로, HTML 파일을 직접 열기만 하면 되고 별도 배포가 필요 없습니다).
2. 패널의 연결 설정에 코어 주소를 입력합니다. 예: http://127.0.0.1:9090.
3. secret을 설정했다면 비밀번호 입력란에 동일한 값을 입력합니다.
4. 연결에 성공하면 노드 목록, 프록시 그룹, 규칙, 연결 로그, 실시간 트래픽 그래프를 볼 수 있습니다.

일상적으로 가장 많이 쓰는 패널 기능 3가지

1. 노드 지연 시간 테스트 및 전환

패널의 '프록시' 페이지에는 모든 정책 그룹과 노드가 나열됩니다. 속도 테스트 아이콘을 클릭하면 그룹 전체 노드의 지연 시간을 일괄 테스트할 수 있으며, 지연 값이 낮을수록 연결 품질이 좋다는 뜻입니다. 특정 노드를 클릭하면 코어를 재시작하지 않고도 현재 사용 서버로 전환됩니다.

2. 규칙 매칭 로그

'로그' 또는 '연결' 페이지에는 각 요청이 어떤 규칙에 매칭되었는지, 직접 연결인지 프록시인지가 실시간으로 표시됩니다. '특정 사이트가 프록시를 타지 않는' 문제를 조사할 때 설정 파일을 보며 추측하는 것보다 훨씬 직관적이고 효율적입니다.

3. 온라인 설정 편집

일부 패널은 웹 페이지에서 직접 proxy-groups와 rules를 편집하고 저장할 수 있습니다. 변경 사항은 즉시 적용되며 파일을 수동으로 열고 저장하고 프로세스를 재시작할 필요가 없습니다.

다른 LAN 기기도 패널에 접근할 수 있게 하기

항상 켜져 있는 컴퓨터나 NAS에서 코어를 실행하고 있다면, 휴대폰이나 태블릿에서도 동일한 패널로 상태를 확인하고 싶어지는 것은 당연합니다. 이 경우 external-controller를 127.0.0.1:9090에서 0.0.0.0:9090으로 변경하여 코어가 모든 네트워크 인터페이스에서 수신하도록 하고, allow-lan을 true로 설정하여 LAN 기기가 프록시에 접속할 수 있도록 합니다.

연결 주소도 코어를 실행하는 기기의 LAN IP로 조정해야 합니다. 예: http://192.168.1.5:9090. 127.0.0.1은 항상 기기 자신을 가리키므로 다른 기기에서 접속하면 연결되지 않습니다.

패널 설정 백업 및 마이그레이션

컴퓨터를 바꾸거나 OS를 재설치하거나 라우터를 재플래싱한 후, 많은 사람들이 노드 그룹과 규칙 변경 사항을 전부 다시 설정해야 한다고 느끼지만 이는 완전히 피할 수 있습니다. 컨트롤 포트 자체는 과거 설정 파일을 저장하지 않습니다. 실제로 백업이 필요한 것은 config.yaml과 규칙 세트 캐시 파일(rule-providers를 사용하는 경우)입니다. 이 파일들을 코어 실행 파일과 함께 새 기기로 복사하면 시작 후 패널의 노드, 그룹, 규칙이 완전히 복원되어 패널 화면에서 수동으로 재구성할 필요가 없습니다.

패널의 '온라인 편집' 기능으로 규칙이나 정책 그룹을 수정했다면, 그 변경 사항을 로컬 config.yaml 파일에 동기화하여 저장하는 것을 잊지 마세요. 일부 패널의 온라인 편집은 코어 실행 시의 메모리 상태에만 적용되며, 저장하지 않은 변경 사항은 재시작 후 사라질 수 있습니다. '수정하면 바로 내보내기' 습관을 들이면 반복 작업을 많이 줄일 수 있습니다.

요약

Dashboard가 반드시 필요한 것은 아닙니다. 그래픽 클라이언트만으로도 일상적인 프록시 요구를 충족할 수 있습니다. 하지만 서버나 라우터처럼 그래픽 인터페이스가 없는 환경에서 코어를 실행하거나 트래픽과 규칙 매칭을 더 세밀하게 관찰하고 싶다면, 웹 패널을 연결하는 것이 전반적인 사용 경험을 한 단계 끌어올려 줍니다.