# hotyue/IP-Sentinel

IP-Sentinel 是一款轻量化、模块化的分布式 VPS 资产养护系统，通过地理位置信号锚定与高拟真本土流量注入，精准解决 IP 定位偏移（IP送中）及风控分过高的痛点，并配合 Telegram 实现全球多节点“低功耗、拟真、无人值守”的自动化资产养护。

Repository: https://github.com/hotyue/IP-Sentinel
Canonical: https://ross.abutalabs.com/products/ip-sentinel
Language: Shell
License: AGPL-3.0
License Family: copyleft
Last push: 2026-08-26T08:04:36+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 99, longevity 10
- inputs: {"age_days": 152, "days_push": 7, "days_rel": 7, "gap_med": 0, "n_releases_24m": 60}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1738, forks 193 (observed 2026-08-28T04:05:30.023470+00:00)

## What it is
IP-Sentinel is a lightweight, modular Master-Agent distributed system for maintaining VPS IP assets. It detects IP geolocation misclassification (e.g., IPs flagged as China/Hong Kong), aggregates fraud-score data from services like Scamalytics and AbuseIPDB, injects realistic local traffic to improve IP reputation, and is controlled remotely via a Telegram bot.

## Use cases
- fix VPS IP geolocated to wrong country
- check if my VPS IP is flagged as proxy or VPN
- monitor IP fraud score across many servers
- improve IP reputation for streaming unlock
- manage a fleet of VPS nodes via Telegram
- detect IP pollution trends on my servers
- automate unattended VPS IP maintenance

## When to choose
- you operate multiple VPS nodes and need centralized IP health monitoring
- your server IP is misgeolocated to China/Hong Kong and hurts search or streaming results
- you want Telegram-based remote control and alerting for a distributed server fleet
- you need a dependency-free, pure-Python/Shell agent for minimal VPS footprint

## When to avoid
- you need a GUI dashboard or web console for IP monitoring
- you want a general-purpose server monitoring or uptime tool rather than IP-specific maintenance
- your environment is not Linux or lacks Python 3
- you are uncomfortable with tools that simulate user traffic to influence IP reputation databases

## Facets
- artifact type: service
- maturity: active
- function: monitoring, networking, workflow-automation, scheduling, security, self-hosted, developer-tools
- domain: networking, self-hosted, security, privacy
- platform: cli, self-hosted, python
- tags: vps-management, ip-geolocation, ip-reputation, master-agent, telegram-bot, proxy-detection, scamalytics, abuseipdb, streaming-unlock, warp-detection, hmac-authentication, ota-updates, shell-scripts, sqlite, automation, devops, linux, docker

## Member repositories
- hotyue/IP-Sentinel (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:30.023470+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:30:36.361078+00:00, confidence not recorded.
  - readme: https://github.com/hotyue/IP-Sentinel (fetched 2026-08-28T04:05:30.023470+00:00, sha be6e8ee7c23b)
- Data as of 2026-08-30T08:39:29.467469+00:00.