pardnchiu/go-ip-sentry

[!NOTE] 此 README 由 SKILL 生成，英文版請參閱 這裡。

STOP MALICIOUS IPS BEFORE THEY REACH YOUR HANDLERS!

Go IP 風控函式庫，具備並行動態風險評分、GeoLite2 地理異常偵測與即插即用 Gin／net/http 中介層

目錄

• 功能特點
• 架構
• 授權
• Author

功能特點

go get github.com/pardnchiu/golang-ip-sentry · 完整文件

• 四維並行風險評分 — 關聯、地理、行為、指紋四個維度以 goroutine 同時計算並合併為 0–100 分，依正常／可疑／危險分級套用不同的每分鐘速率上限。
• GeoLite2 地理異常偵測 — 以 Haversine 距離推算移動速度，識別超過 800 km/h 的不可能旅行，並偵測一小時內跨多國跳躍與城市頻繁切換。
• HMAC 簽章 Session 與裝置指紋 — 以 HMAC-SHA256 簽章的 Session Cookie 結合裝置指紋，追蹤單一 Session 多 IP、單一 IP 多裝置等共用帳號與代理池跡象。
• 機器人節律辨識 — 分析最近 10 次請求間隔的變異數，揪出間隔過度規律的自動化腳本，並納入長連線、登入失敗與 404 掃描訊號。
• 三層 IP 存取控制 — Allow／Deny 名單同步寫入 Redis 與本地 JSON 檔、啟動時自動載回；Block 以指數倍增時長暫時封鎖，Deny 可觸發 Email 通知。

架構

完整架構

graph TB
    REQ[HTTP 請求] --> MW[Gin / net/http 中介層]
    MW --> DEV[裝置識別<br/>Session + 指紋]
    DEV --> LIST{三層名單}
    LIST -->|Allow| PASS[放行]
    LIST -->|Deny / Block| REJ[403 拒絕]
    LIST -->|未列入| SCORE[四維並行評分]
    SCORE <--> REDIS[(Redis)]
    SCORE --> GEO[GeoLite2]
    SCORE --> RL{分級速率限制}
    RL -->|未超限| PASS
    RL -->|超限 / 分數 ≥ 100| REJ

授權

本專案採用 MIT LICENSE。

Author

Just open an issue to share an idea.

©️ 2025 邱敬幃 Pardn Chiu