알림 보고
Chute는 연결 품질, 프록시 가용성, 트래픽 패턴 및 구성 상태를 모니터링합니다. 심각한 이상이 감지되면 Chute 앱이 시스템 알림을 표시하여 알릴 수 있습니다.
단일 시간 초과나 도달 불가능한 노드는 알림을 트리거하지 않습니다 — 지속적이거나 대규모 패턴만 해당됩니다.
이벤트 유형
| 이벤트 | 의미 |
|---|---|
| 대량 연결 실패 | 다수의 연결이 동일한 방식으로 실패하고 있습니다(예: 모두 시간 초과). |
| 프록시 노드 사용 불가 | 특정 프록시 노드가 데이터를 반환하지 않고 연결을 계속 닫습니다 — 노드가 다운되었을 가능성이 높습니다. |
| 트래픽 급증 | 최근 평균보다 현저히 높은 지속적인 고대역폭 트래픽(업로드 또는 다운로드). 즉각적인 스파이크는 무시됩니다. |
| 설정 업데이트 실패 | 관리형 구성 자동 업데이트가 반복적으로 실패했습니다(다운로드 또는 파싱 오류). |
| 정책 그룹 주 정책이 변경됨 | 정책 그룹이 다른 프록시로 전환했습니다 — 스스로 전환했거나(폴백 / URL 테스트 / 로드 밸런스 / SSID), 사용자가 직접 다른 프록시를 선택한 경우입니다. 그룹이 빠르게 진동하는 경우 각 전환마다가 아닌 단일 "플래핑" 알림이 표시됩니다. Chute Mac에서는 이 알림에 정책 그룹 플래핑이라는 별도의 스위치가 있으며, 기본값은 꺼짐입니다. |
| 네트워크 주소 변경 | 이 기기가 네트워크에서 가진 주소가 변경되었습니다. 알림은 IPv4 주소와 IPv6 주소를 따로 나열합니다. Chute Android에서는 대신 출구 IP 변경 이벤트입니다: 트래픽이 나가는 공인 주소 하나를 알리며, 그 스위치의 기본값은 꺼짐입니다. |
| Tailscale 홈 DERP 변경 | Tailscale 엔진이 다른 홈 DERP 릴레이 지역으로 전환했습니다. 모든 플랫폼에서 기록되며, Chute Mac이 알림을 띄우고 Chute Android도 Tailscale 이벤트 스위치에 따라 알림을 띄웁니다. 이 스위치의 기본값은 꺼짐입니다. |
| Tailscale 이벤트 | 출구 노드 문제나 auth-key 실패와 같은 Tailscale 이벤트입니다. |
| 규칙 알림 | notification-text=가 붙은 규칙이 일치했습니다. Chute가 그 텍스트를 직접 알림으로 보내고(규칙 알림 참고) 이벤트도 기록합니다. |
| 네트워크가 트래픽을 전달하지 않음 | 시스템은 네트워크가 동작한다고 보고하지만 나가는 연결이 계속 시간 초과되고 아무것도 수신되지 않는 상태입니다(예: 멈춘 셀룰러 링크). 한 차례의 장애당 한 번만 보고되며, 트래픽이 회복되거나 네트워크가 바뀐 뒤에야 다시 보고됩니다. Chute Mac에는 전용 스위치가 있으며 기본값은 켜짐입니다. Chute iOS와 Chute Android에서는 대량 연결 실패 스위치를 따릅니다. |
규칙 알림
[Rule]
DOMAIN-SUFFIX,bank.example,DIRECT,notification-text="Bank site opened",notification-interval=60
notification-text=가 붙은 규칙이 일치하면 Chute는 시스템 알림을 보냅니다. 제목은 그 텍스트이고 본문은 호스트:포트 → 정책입니다. 각 규칙은 notification-interval초(기본값 300)마다 최대 한 번 알립니다. 이 알림은 스크립트가 $notification으로 보내는 알림과 마찬가지로 앱의 알림 스위치를 따릅니다 — Chute iOS에서는 알림 허용, Chute Mac에서는 이벤트 보고 알림 표시, Chute Android에서는 Chute에 대한 시스템 알림 권한이며, 스크립트 알림에는 그곳에 스크립트 알림이라는 전용 채널도 있습니다. 이것을 끄면 아무것도 표시되지 않습니다. Apple TV는 알림을 표시하지 않습니다.
임계값
보고 시스템은 기본적으로 활성화되어 있습니다. 임계값은 내장되어 있으며 구성 파일에서 바꿀 수 없습니다. 참조 값은 다음과 같습니다:
| 임계값 | 값 | 단위 | 설명 |
|---|---|---|---|
| 대량 실패 임계값 | 20 | 개수 | 대량 연결 실패 알림을 트리거하는 시간 창 내 최소 실패 수 |
| 대량 실패율 | 0.3 | 비율 (0–1) | TCP 연결의 최소 실패율 (실패 / 전체) |
| 대량 실패 시간 창 | 60 | 초 | 대량 실패 계산을 위한 시간 창 |
| 프록시 노드 사용 불가 횟수 | 3 | 개수 | 프록시 노드 사용 불가 알림을 트리거하기 전 단일 노드의 실패 횟수 |
| 프록시 노드 사용 불가 시간 창 | 300 | 초 | 노드 실패 계산을 위한 시간 창 |
| 트래픽 급증 배수 | 5.0 | 비율 | 현재 속도가 5분 평균을 이 배수만큼 초과해야 함 |
| 트래픽 급증 지속 시간 | 60 | 초 | 알림 전 급증이 지속되어야 하는 시간 |
| 정책 플랩 시간 창 | 60 | 초 | 정책 그룹 진동 감지를 위한 시간 창 |
| 정책 플랩 임계값 | 3 | 개수 | 플래핑 알림을 트리거하는 시간 창 내 전환 횟수 |
| 쿨다운 간격 | 120 | 초 | 같은 알림이 다시 발생하기까지의 최소 간격 — 알림 조절 방식 참고 |
| 설정 실패 횟수 | 2 | 개수 | 설정 업데이트 실패 알림을 트리거하기 전 연속 업데이트 실패 횟수(성공 시 재설정. 주소가 Clash나 sing-box 프로필을 내주는 것으로 확인된 회차는 성공으로도 실패로도 세지 않습니다) — 시간 창은 없습니다 |
알림 조절 방식
알림 스팸을 방지하기 위해 Chute는 여러 보호 장치를 적용합니다:
- 쿨다운: 같은 알림은 쿨다운 간격(120초)당 한 번만 발생합니다. "같은"이란 같은 노드, 같은 방식으로 전환하는 같은 그룹, 같은 종류의 실패, 또는 같은 구성 URL을 뜻합니다 — 간격 안에 다른 노드가 다운되면 그 노드에 대한 알림이 따로 발생합니다. Tailscale 홈 DERP 변경에는 쿨다운이 없으며, 규칙 알림은 자체
notification-interval을 따릅니다. - 대량 억제: 대량 연결 실패 알림이 발생하면 개별 프록시 노드 사용 불가 알림이 억제됩니다 — 대량 알림이 이미 문제를 다루고 있습니다.
- 안티 플랩: 정책 그룹이 빠르게 앞뒤로 전환되는 경우(60초 내에 3회 이상), 각 전환마다가 아닌 단일 "플래핑" 알림이 표시됩니다.
- 유예 기간: 시작 연결 변동으로 인한 잘못된 알림을 방지하기 위해 엔진 시작 또는 구성 재로드 후 60초 동안 프록시 노드 사용 불가 알림이 억제됩니다.
- 네트워크 변경 재설정: 네트워크 변경(Wi-Fi ↔ 셀룰러) 또는 구성 재로드 시 모든 내부 카운터가 재설정되어 오래된 데이터가 잘못된 알림을 트리거하는 것을 방지합니다.
이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.