immuni项目完整指南:意大利官方新冠接触者追踪App如何用蓝牙在不采集位置的情况下识别感染风险
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 会用简洁的插画页向你解释它的价值:帮助个人在无症状阶段就可能被感染风险预警,从而及时隔离、就医,减少社区传播。
二、核心原理:蓝牙接触者追踪为什么不需要 GPS?
这是 Immuni 最"反直觉"的地方——它完全不知道你在哪里,却能知道你是否"接触过感染者"。关键靠两个概念:
- Temporary Exposure Key(TEK,临时暴露密钥):设备每天随机生成一个 16 字节密钥,仅存在手机本地;
- Rolling Proximity Identifier(RPI,滚动邻近标识):由 TEK 经密码学哈希派生,每小时滚动多次,通过蓝牙持续广播。
完整流程分四步:
- 互相记录:两台装有 Immuni 的手机靠近时,各自把对方广播的 RPI 连同时间戳、信号衰减存进本地数据库(RPI Database);
- 阳性上报:用户检测阳性后,在医疗人员协助下将过去 14 天的 TEK 上传至服务器;
- 本地匹配:所有设备定期下载新增 TEK,在本地重建感染者曾经广播过的 RPI,与自己存储的记录比对;
- 风险判定:匹配成功不代表一定危险。Immuni 会根据接触时长与信号衰减估算的距离计算 Total Risk Score(总风险分),只有分数超过阈值才发出通知。
⚠️ 为什么蓝牙比定位更准?GPS 精度通常在数十米级别,而 BLE 能捕捉数米范围内的接触——这正是与 SARS-CoV-2 传播相关的尺度;同时 BLE 功耗极低,App 常驻运行也不会显著耗电(见 README.md)。
三、新手上手流程:从安装到开启接触追踪
首次使用按顺序完成以下步骤即可(界面设计详见 Product.md):
- 欢迎页:了解 App 的价值与工作方式;
- 隐私确认:明确告知不收集姓名、生日、住址、邮箱、手机号,也不收集任何位置/GPS 数据,并要求你声明年满 14 周岁;
- 选择省份:仅选择你居住的省份(Regione + Provincia),用于流行病学统计——这是唯一与地理位置相关的信息;
- 授权:开启 Apple/Google Exposure Notification 框架权限、确认蓝牙已打开、允许本地通知。
之后回到 Home 页,顶部卡片会实时显示服务状态;若你撤销了某项权限或关闭了蓝牙,App 会给出明确的修复指引(见 Product.md)。
四、收到感染风险通知怎么办?
如果你与 SARS-CoV-2 阳性用户的接触被判定为高风险暴露(Risky Exposure),Immuni 会在 Home 页推送醒目卡片,并给出可执行建议,例如:
- 勤洗手、戴口罩、监测体温;
- 出现发烧、咳嗽等症状时隔离并联系全科医生;
- 主动联系国家卫生服务系统(Servizio Sanitario Nazionale)。
需要说明:距离估算依赖信号衰减,会受设备朝向、人体与障碍物遮挡影响,因此误判不可避免,官方风险模型也会随对病毒认识的深入持续迭代(见 README.md)。
五、检测阳性后:如何安全上报并通知他人
上报密钥是整个系统最敏感的操作,Immuni 设计了医疗人员双重确认机制,防止恶意伪造上报(见 Product.md):
- 在 Settings 页点击 "Report a positive result"(Signala positività);
- App 生成一个随机的 10 位一次性验证码(OTP);
- 你把验证码口头告知医疗人员,由其在 HIS 后台系统录入;
- 确认授权后,点击"Upload data",上传近 14 天的 TEK、流行病学信息与省份信息;
- OTP 在授权后 2 分 30 秒内过期,且每个 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)的最佳入口。




