数据隐私与所有权Open Wearables自托管安全机制、遥测开关与数据归档策略完整指南【免费下载链接】open-wearablesSelf-hosted platform to unify wearable health data through one AI-ready API.项目地址: https://gitcode.com/gh_mirrors/op/open-wearablesOpen Wearables是一款面向个人与开发者团队的自托管可穿戴健康数据平台通过统一的 REST API 将 Garmin、Oura、Whoop、Apple Health 等主流设备的数据归一化存储在你自己的服务器上。这意味着你的健康数据始终掌握在你手里——从加密存储、身份认证到遥测数据的匿名化、数据归档与保留策略每一环都提供了清晰的开关与文档。本文将带你从零读懂 Open Wearables 的三大隐私支柱安全机制、遥测开关与数据归档策略。为什么自托管 数据所有权传统可穿戴平台的模式是设备 → 厂商云 → 你的 App。数据一旦进入厂商服务器你就失去了实际控制权。Open Wearables 采用了完全不同的架构设备 → 厂商云/SDK → 你的 Open Wearables 实例 → 你的应用/AI所有归一化后的健康数据都写入你本地部署的 PostgreSQL通过统一的 REST API 暴露给前端、后端或 AI Agent。厂商云只负责传输最终数据的存储、访问、删除权都在你的服务器上。这种架构下隐私问题就从厂商是否泄露数据变成了你的实例如何被安全访问、如何控制数据生命周期。接下来的三章正是围绕这两个问题展开。安全机制从密码哈希到 API 密钥的全链路1. 密码存储bcrypt 加盐哈希管理员与开发者账号的密码从不以明文存储。核心实现在 backend/app/utils/security.py使用bcrypt生成随机盐并对密码加盐哈希超过 72 字节的密码会被安全截断bcrypt 的硬上限校验时使用bcrypt.checkpw杜绝时序攻击2. API 密钥只存哈希明文只显示一次后端集成的 API 密钥采用更严格的设计参见 backend/app/services/api_key_service.py设计要点说明随机性使用secrets.token_hex(16)生成 128 bit 熵存储策略数据库只存 SHA-256 哈希 10 位前缀展示策略明文 key 仅在创建/轮换时返回一次校验方式单次索引查询即可完成无需遍历这意味着即使数据库被拖库攻击者拿到的也是不可逆的哈希值无法还原原始 API Key。密钥轮换功能rotate_api_key允许一键生成新 key旧 key 立即失效。3. 敏感配置Fernet 对称加密对于需要写入.env的第三方密钥如 S3、OAuth 客户端密钥Open Wearables 提供了Fernet 对称加密方案实现在 backend/app/utils/config_utils.py通过MASTER_KEY环境变量提供主密钥敏感字段在写入配置前自动加密、读取时自动解密配套脚本位于 backend/scripts/cryptography/可独立生成/加解密密钥这套机制让.env文件即使被误提交也拿不到有效的第三方凭据。4. 会话认证JWT 短时效 Token开发者门户登录采用 JWT过期时间由ACCESS_TOKEN_EXPIRE_MINUTES控制配合 backend/app/utils/auth.py 中的oauth2_scheme完成统一鉴权。移动端 SDK 使用独立的sdk_token与开发者 JWT 严格隔离避免越权访问。遥测开关透明、匿名、可一键关闭默认开启但绝对透明Open Wearables 的匿名使用遥测默认开启backend/app/services/telemetry_service.py每天最多发送一次 启动时一次12 小时防抖。API 启动时会明确打印日志提醒Anonymous usage telemetry is enabled (aggregate counts only, no user data).只收集量级不收集具体值所有计数都使用数量级桶bucket而非精确数字桶标签实际范围0空实例1-101~10 条记录11-10011~100 条记录1k-10k1千~1万条记录1M百万条以上这样设计的原因是如果每天发送精确数字攻击者可以通过两次 ping 的差值反推你每天新增了多少条健康数据。桶只在跨越数量级时才变化从根本上消除了差分侧信道。明确不收集什么官方文档 docs/dev-guides/telemetry.mdx 列出了硬性边界❌ 任何用户数据姓名、邮箱、ID、健康指标❌ 任何凭据、Token、API Key❌ 主机名、IP、URL❌ 精确数字只有数量级桶❌ 原始请求路径、查询串、User-Agent❌ Commit 哈希可暴露你的自定义分支甚至连月经周期数据端点都被完全排除在遥测之外。一键关闭遥测在backend/config/.env中设置任一环境变量即可# 方式一显式关闭 TELEMETRY_ENABLEDfalse # 方式二遵循开发者工具通用约定 DO_NOT_TRACK1两者等效会彻底停用遥测无定时任务、无启动 ping、无 HTTP 调用、无请求计数。验证方式重启后启动日志不再出现遥测提示行。网络级兜底如果想让安全保证完全不依赖配置直接在防火墙拦截出站到telemetry.openwearables.io的流量即可。遥测是 best-effort 设计被拦截只记WARNING日志绝不影响实例运行。数据归档策略控制存储增长的两大杠杆时间序列数据如每分钟心率会随时间和设备数线性增长。Open Wearables 通过数据生命周期Settings → Data Lifecycle提供两个独立策略实现位于 backend/app/services/archival_service.py文档见 docs/developer-portal/settings/data-lifecycle.mdx。杠杆一归档策略Archival将 N 天前的原始样本聚合成日级摘要。阈值范围1 ~ 3650 天效果存储体积下降约 500 倍聚合精度基本无损场景保留长期趋势分析能力但不再需要分钟级细节杠杆二保留策略Retention永久删除 N 天前的数据。阈值范围1 ~ 7300 天与归档组合时先归档、再删除归档层避免先删后归档的数据丢失删除不可逆页面会在配置错误时明确警告三种策略组合的效果归档保留效果✅❌线性高效原始数据有界日级摘要缓慢累积❌✅有界总容量稳定在保留窗口内✅✅有界兼顾长期趋势 容量上限❌❌线性原始数据无限增长不推荐页面顶部的增长预测图会基于当前摄入速率模拟未来 18 个月的数据库体积让你在保存前就能看到不同策略组合的差异。任务每日自动执行也可以点Run Now立即触发验证。隐私配置速查表关注点关键文件/路径默认行为关闭/调整方式密码存储backend/app/utils/security.pybcrypt 加盐无需配置API 密钥backend/app/services/api_key_service.pySHA-256 哈希存储轮换后立即失效敏感配置backend/scripts/cryptography/未加密设置MASTER_KEY启用 Fernet匿名遥测docs/dev-guides/telemetry.mdx开启TELEMETRY_ENABLEDfalse数据生命周期docs/developer-portal/settings/data-lifecycle.mdx早期访问DATA_LIFECYCLE_ENABLEDfalse原始 Payload 归档docs/dev-guides/raw-payload-storage.mdx关闭RAW_PAYLOAD_STORAGEdisabled给自托管者的三条落地建议第一次登录后立即修改默认密码并邀请团队成员时使用门户的邀请机制而非共享账号生产部署前评估遥测多数场景保留默认开启即可数据极小、匿名化严格若部署在内网隔离环境建议设置DO_NOT_TRACK1并在防火墙层面双保险接入 3 个月以上再配置数据归档先观察 Data Lifecycle 页面 的增长预测图再根据实际摄入速率选择合理的归档/保留阈值避免过早删除仍需要的原始样本自托管的核心价值不是多一层防火墙而是把每一个隐私开关都交给你自己。Open Wearables 从安全机制、遥测透明度到数据归档策略都遵循默认透明 一键可控的原则让个人开发者与小团队也能真正掌控健康数据的所有权。【免费下载链接】open-wearablesSelf-hosted platform to unify wearable health data through one AI-ready API.项目地址: https://gitcode.com/gh_mirrors/op/open-wearables创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考