foru17/neko-master

어떤 프로젝트인가요?

핵심 기능

• 01WebSocket을 통한 실시간 트래픽 모니터링 및 HTTP 폴링 대체 지원
• 0230분, 1시간, 24시간 구간별 트래픽 추이
• 03ASN 및 지리적 위치 정보가 포함된 도메인별·IP별 분석
• 04프록시 노드별 트래픽 및 연결 통계
• 05여러 Clash/Mihomo 및 Surge 게이트웨이 백엔드 지원
• 06기본 SQLite와 함께 사용할 수 있는 선택적 ClickHouse 저장소

활용 사례

• 가정의 OpenClash 또는 Mihomo 게이트웨이가 어느 도메인과 IP로 트래픽을 보내는지 확인
• 여러 기기에서 Surge를 통해 흐르는 트래픽 감사
• 에이전트를 통해 원격 OpenWrt 또는 Linux 게이트웨이의 데이터 수집
• SQLite가 느려질 때 ClickHouse에서 수개월간의 트래픽 기록 검토

빠른 시작

1. 1

   세션을 유지하기 위한 cookie secret을 생성합니다

   export COOKIE_SECRET="$(openssl rand -hex 32)"
2. 2

   Docker로 컨테이너를 시작합니다(최소 구성, 포트 3000만 사용)

   docker run -d --name neko-master -p 3000:3000 -v $(pwd)/data:/app/data -e COOKIE_SECRET="$COOKIE_SECRET" --restart unless-stopped foru17/neko-master:latest
3. 3

   브라우저에서 http://localhost:3000 을 열어 gateway를 구성합니다

사용 전 알아둘 점

• !실시간 WebSocket 업데이트를 사용하려면 리버스 프록시를 통해 포트 3002에 연결할 수 있어야 합니다. 그렇지 않으면 폴링으로 대체됩니다.
• !Surge 데이터는 HTTP 폴링으로 새로고침되며 약 2초의 지연이 발생합니다.
• !이 대시보드는 자체 gateway를 모니터링하기 위한 것으로, 유용하게 사용하려면 Clash/Mihomo 또는 Surge gateway가 실행 중이어야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

neko-master은(는) 무엇인가요?

Clash/Mihomo(OpenClash) 및 Surge 게이트웨이의 네트워크 트래픽을 시각화하고 감사하는 셀프 호스팅 대시보드입니다. Neko Master는 Clash/Mihomo(OpenClash 포함) 또는 Surge를 실행하는 게이트웨이를 통과하는 트래픽을 확인하는 웹 대시보드입니다. 실시간 트래픽과 30분, 1시간, 24시간 단위의 추이를 보여 주며, 관련 IP, 연결 수, ASN, 지리적 위치와 함께 도메인별 및 IP별로 살펴볼 수 있습니다. 프록시 노드와 규칙 체인별로 트래픽 및 연결 내역도 분석합니다.

neko-master은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

neko-master은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

neko-master은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. neko-master의 마지막 커밋은 2026년 10월 10일입니다.

neko-master은(는) 어디에 사용할 수 있나요?

가정의 OpenClash 또는 Mihomo 게이트웨이가 어느 도메인과 IP로 트래픽을 보내는지 확인 여러 기기에서 Surge를 통해 흐르는 트래픽 감사 에이전트를 통해 원격 OpenWrt 또는 Linux 게이트웨이의 데이터 수집 SQLite가 느려질 때 ClickHouse에서 수개월간의 트래픽 기록 검토

neko-master는 어떻게 설치하나요?

세션을 유지하기 위한 cookie secret을 생성합니다: export COOKIE_SECRET="$(openssl rand -hex 32)" Docker로 컨테이너를 시작합니다(최소 구성, 포트 3000만 사용): docker run -d --name neko-master -p 3000:3000 -v $(pwd)/data:/app/data -e COOKIE_SECRET="$COOKIE_SECRET" --restart unless-stopped foru17/neko-master:latest 브라우저에서 http://localhost:3000 을 열어 gateway를 구성합니다

neko-master은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/foru17/neko-master