MookNote/server

MookNote 用户统计服务

部署

1. 安装依赖

cd server
pip install -r requirements.txt

2. 启动服务

python app.py

默认监听 0.0.0.0:5000，可通过环境变量 PORT 修改端口。

3. 生产环境部署

推荐使用 gunicorn：

pip install gunicorn
gunicorn -w 2 -b 0.0.0.0:5000 app:app

或使用 systemd 设为开机自启。

API

POST /api/heartbeat

心跳上报，App 启动时和每 5 分钟调用一次。

请求体：

{ "device_hash": "设备匿名标识" }

GET /api/stats

获取统计数据。

响应：

{ "total_users": 10, "online_users": 3 }

• total_users: 历史总设备数
• online_users: 最近 5 分钟内有心跳的设备数

数据存储

SQLite 数据库 stats.db，结构：

CREATE TABLE devices (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    device_hash TEXT UNIQUE NOT NULL,  -- SHA256 哈希后的设备标识
    first_seen TEXT NOT NULL,           -- 首次出现时间
    last_seen TEXT NOT NULL             -- 最后心跳时间
);

所有数据均为匿名，不包含任何设备原始信息。