immuni项目完整指南:意大利官方新冠接触者追踪App如何用蓝牙在不采集位置的情况下识别感染风险

原创2026-11-12 11:56:261,680 阅读

immuni项目完整指南:意大利官方新冠接触者追踪App如何用蓝牙在不采集位置的情况下识别感染风险

Immuni 是意大利政府推出的官方新冠接触者追踪 App,基于 Bluetooth Low Energy(BLE)低功耗蓝牙与 Apple、Google 的 Exposure Notification 框架实现感染风险识别,全程不采集任何位置信息(包括 GPS),也不收集用户身份信息。本文将用通俗的方式带你完整了解它的运作原理、新手使用流程、阳性上报机制,以及背后的隐私保护设计。

📦 Immuni 的软件代码以 GNU Affero General Public License v3 开源,本文配套的全部文档可在 immuni-documentation 仓库中查阅,其中也提供意大利语版本。

一、Immuni 是什么:六大原则打造的官方追踪方案

Immuni 由意大利总理府新冠应急专员办公室主导,卫生部与技术革新部协作开发,数据服务由意大利国企 Sogei S.p.A. 运营,代码托管与服务器均位于意大利境内。

项目设计遵循六大原则(详见 README.md):

原则 含义
实用性 尽早通知尽可能多的真实高风险用户
可及性 让最广泛的人群都能无障碍使用
准确性 只通知风险实质较高的用户,避免误报摧毁信任
隐私 在有效的前提下严格保护用户隐私
可扩展性 支撑全国范围内的大规模采用
透明性 完全开源,任何人都可验证其行为与文档一致

首次打开 App 时,Immuni 会用简洁的插画页向你解释它的价值:帮助个人在无症状阶段就可能被感染风险预警,从而及时隔离、就医,减少社区传播。

Immuni欢迎页:意大利官方新冠接触者追踪App的新手引导界面

二、核心原理:蓝牙接触者追踪为什么不需要 GPS?

这是 Immuni 最"反直觉"的地方——它完全不知道你在哪里,却能知道你是否"接触过感染者"。关键靠两个概念:

  • Temporary Exposure Key(TEK,临时暴露密钥):设备每天随机生成一个 16 字节密钥,仅存在手机本地;
  • Rolling Proximity Identifier(RPI,滚动邻近标识):由 TEK 经密码学哈希派生,每小时滚动多次,通过蓝牙持续广播。

Immuni工作原理:手机间通过蓝牙交换随机邻近标识而不追踪位置

完整流程分四步:

  1. 互相记录:两台装有 Immuni 的手机靠近时,各自把对方广播的 RPI 连同时间戳、信号衰减存进本地数据库(RPI Database);
  2. 阳性上报:用户检测阳性后,在医疗人员协助下将过去 14 天的 TEK 上传至服务器;
  3. 本地匹配:所有设备定期下载新增 TEK,在本地重建感染者曾经广播过的 RPI,与自己存储的记录比对;
  4. 风险判定:匹配成功不代表一定危险。Immuni 会根据接触时长与信号衰减估算的距离计算 Total Risk Score(总风险分),只有分数超过阈值才发出通知。

⚠️ 为什么蓝牙比定位更准?GPS 精度通常在数十米级别,而 BLE 能捕捉数米范围内的接触——这正是与 SARS-CoV-2 传播相关的尺度;同时 BLE 功耗极低,App 常驻运行也不会显著耗电(见 README.md)。

三、新手上手流程:从安装到开启接触追踪

首次使用按顺序完成以下步骤即可(界面设计详见 Product.md):

  1. 欢迎页:了解 App 的价值与工作方式;
  2. 隐私确认:明确告知不收集姓名、生日、住址、邮箱、手机号,也不收集任何位置/GPS 数据,并要求你声明年满 14 周岁;
  3. 选择省份:仅选择你居住的省份(Regione + Provincia),用于流行病学统计——这是唯一与地理位置相关的信息;
  4. 授权:开启 Apple/Google Exposure Notification 框架权限、确认蓝牙已打开、允许本地通知。

Immuni隐私保护说明界面:明确不收集位置与身份信息

之后回到 Home 页,顶部卡片会实时显示服务状态;若你撤销了某项权限或关闭了蓝牙,App 会给出明确的修复指引(见 Product.md)。

四、收到感染风险通知怎么办?

如果你与 SARS-CoV-2 阳性用户的接触被判定为高风险暴露(Risky Exposure),Immuni 会在 Home 页推送醒目卡片,并给出可执行建议,例如:

  • 勤洗手、戴口罩、监测体温;
  • 出现发烧、咳嗽等症状时隔离并联系全科医生;
  • 主动联系国家卫生服务系统(Servizio Sanitario Nazionale)。

Immuni感染风险暴露通知界面与防护建议卡片

需要说明:距离估算依赖信号衰减,会受设备朝向、人体与障碍物遮挡影响,因此误判不可避免,官方风险模型也会随对病毒认识的深入持续迭代(见 README.md)。

五、检测阳性后:如何安全上报并通知他人

上报密钥是整个系统最敏感的操作,Immuni 设计了医疗人员双重确认机制,防止恶意伪造上报(见 Product.md):

  1. 在 Settings 页点击 "Report a positive result"(Signala positività);
  2. App 生成一个随机的 10 位一次性验证码(OTP);
  3. 你把验证码口头告知医疗人员,由其在 HIS 后台系统录入;
  4. 确认授权后,点击"Upload data",上传近 14 天的 TEK、流行病学信息与省份信息;
  5. OTP 在授权后 2 分 30 秒内过期,且每个 OTP 可上传的数据量受限。

Immuni阳性数据上报流程:OTP验证码与医疗人员授权步骤

🔒 关键点:TEK 只会在你本人确认 + 医疗人员核验后才离开手机,普通情况下密钥永远留在本地。

六、隐私保护设计:六层防线让追踪"看不见你"

Immuni 在隐私上的投入是同类 App 中最激进的,核心措施包括:

  • 零身份、零位置:不收集任何可识别身份或个人轨迹的数据;
  • 滚动标识:RPI 每小时多次变更,即使被截获也无法追踪设备;
  • 数据模糊化:接触时长按 5 分钟粒度记录、上限 30 分钟,日期精确到天,服务端无法判断两天接触是否为同一人;
  • 数据自动销毁:设备上与服务端的数据在不再需要时即删除,最晚不超过 2021 年 12 月 31 日;
  • 假上传(Dummy Uploads):App 会按概率策略周期性地发起与真实上传流量特征一致的虚假请求,干扰网络流量分析(详见 Traffic Analysis Mitigation.md);
  • 全程加密:本地存储加密、所有服务端连接加密。

假上传状态机:Immuni通过随机等待发送请求抵御流量分析

此外,App 还会上传少量运营信息(操作系统、蓝牙/权限状态、是否收到风险通知等),但无需任何账号认证,并且每月最多上传一次、附带采样率控制,用于让卫生部门评估系统真实覆盖率而非下载量(详见 Privacy-Preserving Analytics.md)。

七、进阶阅读:Immuni 开源文档导航

如果你想深入技术细节,仓库内各文档的定位如下:

文档 内容
README.md 高层概述:愿景、原则、工作原理、分析数据与隐私
Product.md 产品功能与用户流程(含全部界面设计稿)
Technology.md 底层架构:TEK/RPI 生成、核心流程、后端服务设计
Application Security.md 安全设计:认证、API 保护、可复现构建
Privacy-Preserving Analytics.md 分析数据的采集、完整性与隐私保护
Traffic Analysis Mitigation.md 流量分析对抗策略详解
API.yaml 后端 API 定义(OpenAPI 规范)

技术核心流程(TEK 生成 → RPI 交换 → TEK 上传 → 暴露检测)的完整描述见 Technology.md。

若需获取完整文档源码,可执行:

git clone https://gitcode.com/gh_mirrors/im/immuni-documentation

小结

Immuni 用一套**"本地匹配 + 滚动标识 + 双重授权上报"的架构,实现了不掌握位置、不掌握身份**的接触者追踪:蓝牙只负责"发现谁在附近",风险判断在你的手机上完成,而阳性上报必须经过你本人确认与医疗人员核验。理解这套机制,不仅适用于 Immuni,也是认识整个 BLE 暴露通知技术(Apple/Google Exposure Notification Framework)的最佳入口。

登录后查看全文
immuni-documentation