본문으로 건너뛰기

트렌딩 - GitHub 인기 레포 & HuggingFace 모델

돌아가기
레포 이동

foru17/neko-master

TypeScript0 / 0

로컬 게이트웨이에서 WebSocket과 HTTP 폴링을 통해 실시간 트래픽 수집과 도메인·IP·프록시별 집계를 제공하는 경량 대시보드이다.

TL;DR

Neko Master는 OpenClash/Surge 계열 게이트웨이에서 수집한 트래픽을 중앙에서 실시간으로 시각화하는 대시보드이다. Clash 계열은 WebSocket 스트림을 통해 밀리초 단위로 데이터를 푸시하고 Surge 계열은 HTTP 폴링(약 2초 지연)을 사용하며, 에이전트 모드는 게이트웨이 근처에서 데이터를 수집해 패널로 전송하는 방식을 채택한다. 기본 저장소는 SQLite이고 필요에 따라 ClickHouse를 선택해 dual-write로 대용량 집계 성능을 확보할 수 있으며 ClickHouse의 상태가 불안정하면 자동으로 SQLite로 폴백된다. Docker Compose와 원클릭 설치 스크립트를 통해 빠르게 배포할 수 있고 로컬 MMDB를 마운트하면 외부 API 없이도 지리 정보 조회를 수행할 수 있다.

핵심 포인트

  • 에이전트 모드를 통해 게이트웨이 근처에서 수집한 데이터를 패널로 푸시하여 중앙화하면서도 게이트웨이와의 직접 접속을 피하는 아키텍처를 제공한다
  • ClickHouse와의 선택적 dual-write로 대용량 집계 환경에서의 읽기 성능과 장기 보관을 유연하게 구성할 수 있다
  • Clash는 WebSocket 실시간 스트림을, Surge는 HTTP 폴링을 기본 수집 방식으로 채택하여 각 게이트웨이 특성에 맞춘 수집 방식을 유지한다
  • 실시간 WebSocket 수집으로 밀리초 단위의 트래픽 푸시와 대시보드 갱신을 지원한다

이미지 분석

Gateway Configuration 대화상자 스크린샷
이 화면은 첫 방문 시 등장하는 게이트웨이 백엔드 구성 대화상자로, 백엔드 이름과 호스트, 포트, 토큰 입력 필드를 포함하고 있다. 스크린샷에서 포트 기본값으로 9090이 사용되는 점이 확인되어 Clash 계열의 WebSocket 엔드포인트를 지정하는 사례와 일치한다. 이 UI는 패널에서 직접 백엔드를 등록해 에이전트 또는 게이트웨이와의 연결을 초기화하는 절차를 시각적으로 보여준다.
Surge HTTP API 설정을 보여주는 스크린샷
해당 이미지에는 Surge 설정 창에서 HTTP API와 포트 9091, 웹 대시보드 옵션이 활성화된 모습이 나타난다. 옵션에 'Allow access from other machines'와 인증 비밀번호 입력란이 보이며 이는 Neko Master가 Surge에 대해 HTTP 폴링과 인증을 통해 데이터를 수집한다는 구현 세부를 뒷받침한다. 이 화면은 Surge 기반 게이트웨이를 패널에 추가하기 위해 HTTP API를 활성화하고 적절한 포트·인증을 설정해야 한다는 구체적 절차를 보여준다.
대시보드 오버뷰 화면으로 트래픽 추세와 상위 도메인/프록시/지역을 표시한 스크린샷
대시보드 메인 화면은 총 다운로드·업로드·트래픽·연결 수 등 요약 카드와 시간대별 트래픽 추세 그래프, 상위 도메인·프록시·지역 목록을 함께 제공한다. 상위 도메인과 프록시 항목에 바이트 단위의 집계 수치가 표시되어 있어 패널이 집계·정렬·랭킹 기능을 수행함이 확인된다. 이 화면은 실시간 및 집계 데이터가 결합된 운영 모니터링 인터페이스 구조를 명확히 제시한다.

3.7k

Stars

232

Forks

+206

Trending

0

조회수

3.7k watchers27 open issuesMIT License

관련 토론

아직 관련 토론이 없습니다.

댓글

댓글을 작성하려면 로그인이 필요합니다.