secubox-openwrt/package/secubox/secubox-cookie-tracker/README.zh.md

SecuBox Cookie Tracker

🌐 语言: English | Français | 中文

SecuBox InterceptoR 的 HTTP Cookie 分类和跟踪工具。

功能特性

• Cookie 提取 - 通过 mitmproxy 从 HTTP 流量中捕获 Cookie
• 自动分类 - 将 Cookie 分类为必要、功能性、分析、广告或跟踪类型
• SQLite 数据库 - 支持搜索和过滤的持久化存储
• 已知跟踪器数据库 - 100+ 预配置的跟踪器域名
• Vortex 集成 - 将被阻止的域名提供给 Vortex 防火墙
• CLI 管理 - 完整的命令行界面用于 Cookie 管理

安装

opkg install secubox-cookie-tracker

需要 secubox-app-mitmproxy 进行流量拦截。

快速开始

# 初始化数据库
cookie-trackerctl init

# 查看状态
cookie-trackerctl status

# 列出 Cookie
cookie-trackerctl list

# 阻止跟踪域名
cookie-trackerctl block doubleclick.net

CLI 命令

命令	描述
status [--json]	显示统计摘要
init [force]	初始化/重置数据库
reload	从 UCI 重新加载跟踪器规则
list [options]	使用过滤器列出 Cookie
show <domain>	显示域名的 Cookie
classify <domain> <name> <cat>	手动分类 Cookie
block <domain>	阻止来自域名的所有 Cookie
unblock <domain>	解除域名阻止
report [--json]	生成 Cookie 报告
export [file]	导出数据库为 CSV
import <file>	从 TSV 导入跟踪器规则
feed-vortex	将被阻止的域名提供给 Vortex
stats	详细统计信息

Cookie 类别

类别	描述	默认操作
essential	网站功能必需	允许
functional	用户偏好、设置	允许
analytics	用于网站改进的使用跟踪	警报
advertising	广告定向和重定向	阻止
tracking	跨站跟踪、指纹识别	阻止
unknown	尚未分类	允许

mitmproxy 集成

将 addon 添加到您的 mitmproxy 配置：

# /etc/config/mitmproxy
config filtering 'filtering'
    option addon_script '/usr/lib/secubox/cookie-tracker/mitmproxy-addon.py'

或与主分析 addon 一起加载：

mitmdump -s /usr/lib/secubox/cookie-tracker/mitmproxy-addon.py \
         -s /srv/mitmproxy/addons/secubox_analytics.py

UCI 配置

# /etc/config/cookie-tracker
config cookie_tracker 'main'
    option enabled '1'
    option auto_classify '1'
    option block_tracking '0'
    option block_advertising '0'

config tracker_rule 'custom'
    option pattern '_my_tracker'
    option category 'tracking'

数据库架构

CREATE TABLE cookies (
    id INTEGER PRIMARY KEY,
    domain TEXT NOT NULL,
    name TEXT NOT NULL,
    category TEXT DEFAULT 'unknown',
    first_seen INTEGER,
    last_seen INTEGER,
    count INTEGER DEFAULT 1,
    client_mac TEXT,
    blocked INTEGER DEFAULT 0,
    UNIQUE(domain, name)
);

CREATE TABLE tracker_domains (
    domain TEXT PRIMARY KEY,
    category TEXT,
    source TEXT
);

示例

# 列出所有跟踪 Cookie
cookie-trackerctl list --category tracking

# 列出特定域名的 Cookie
cookie-trackerctl list --domain google.com

# 生成仪表板 JSON 报告
cookie-trackerctl report --json

# 导出所有数据
cookie-trackerctl export /tmp/cookies.csv

# 阻止并同步到 Vortex
cookie-trackerctl block ads.example.com
cookie-trackerctl feed-vortex

依赖项

• secubox-app-mitmproxy（用于流量拦截）
• sqlite3-cli
• jsonfilter

许可证

GPL-3.0