更新日期:2026 年 10 月 20 日
隐私说明
本说明介绍 void0 Deploy 在 https://auth.void.elonehoo.me 提供共享 Vercel 授权服务时,当前代码如何处理信息,以及中心服务、你的 void0 实例与外部平台各自的职责。
Vercel Integration 已创建为 Unlisted,共享授权服务已完成一次 All Projects 真实验证。安装、回调、凭据领取与连接检查成功,实例项目选择器读出 23 个项目;此次验证未导入项目或更改部署。以下介绍当前实现如何处理授权信息。
1. 服务用途
中心使用固定的 HTTPS 回调地址,与 Vercel 交换授权结果,再由发起连接的 void0 实例领取。它不根据实例填写的地址主动访问该实例,也不把该地址作为 Vercel 的回调地址。实例地址仅用于展示和提供返回链接,中心没有验证其归属。
本中心不接收 GitHub Token。GitHub 授权由你的 void0 实例通过独立流程完成。
Cloudflare 连接也由你的 void0 实例直接完成,不经过本中心。私有应用 void0 DNS 的回调地址为 https://void.elonehoo.me/api/cloudflare/oauth/callback,申请 Zone Read、DNS Write 和用于续期的 offline_access;授权范围以 Cloudflare 确认页面为准。
2. 连接过程中处理的信息
| 信息来源 | 内容与用途 |
|---|---|
| 你的 void0 实例 | 实例自报的管理地址 origin(协议、主机与端口,不含页面路径)、领取校验值的 hash、配对码的 hash,以及领取或取消请求中的校验值。用于展示请求方、核对你手动输入的配对码,并让原实例领取或取消本次请求。 |
| 授权浏览器 | 本次配对使用的临时 Cookie、随机校验值及其 hash、你手动提交的配对码。用于将确认页面和 Vercel 回调关联到同一次浏览器操作,减少请求被替换或重复使用的可能。 |
| 请求连接信息 | 来源 IP 和短期请求计数。用于限制请求频率及同一来源的配对数量;发起配对时的 IP 也会与该配对记录暂时关联。 |
| Vercel 回调与响应 | 临时授权码、state、configurationId、可选 teamId、错误或后续跳转信息。完成交换后短暂接收 access token、userId、teamId(如有)和 installationId。用于核对安装并把授权凭据交给原实例。 |
你在 Vercel 页面授予的范围和选择的团队、项目决定实例后续能够访问的资源。中心的授权交换流程本身不获取项目列表、部署日志或仓库内容。
申请的权限范围包括部署与安装信息读取,以及项目、域名的读取与写入。Vercel 的 Projects 写权限覆盖的 API 较广;void0 当前仅使用项目域名相关的写接口。最终授权范围以 Vercel 页面展示为准。
3. 中心的暂存与清理
配对状态与待领取的用户授权凭据保存在服务进程内存中,当前应用代码没有为它们配置持久化数据库。每次配对自创建起 10 分钟内有效,授权凭据只能在该有效期内被原实例领取一次。
- 成功领取后,中心从本次活动记录中移除凭据和配对信息;同一凭据不能再次领取。
- 中心收到通过校验的取消请求时,也会移除该次记录。如果实例取消时未能联系到中心,中心中的未领取记录仍按原有效期失效。
- 到期记录会在后续请求到来或周期性清理时移除。当前清理任务每分钟运行一次;过期凭据不再允许领取。
- 已使用授权码的 hash 另保留一个 10 分钟的内存窗口,用于拒绝重复交换;按 IP 的请求频率计数使用 1 分钟窗口。
- 中心服务重启会丢失尚未完成的配对与待领取凭据,需要从自己的 void0 重新发起连接。
上述时间描述应用内授权记录,不代表主机、代理、网络服务或外部平台的日志保留期限。
4. Cookie、页面资源与基础设施
授权页面会为当前配对设置临时 Cookie,有效期随本次配对剩余时间结束;HTTPS 下使用 Secure 和 HttpOnly,并设置 SameSite=Lax。处理有效回调时,应用会发出清除此 Cookie 的响应。它用于连接流程校验,不用于广告或跨站分析。
当前公开说明页与授权流程没有加入分析统计或广告功能。说明页不加载外部脚本、字体或图片资源。
提供运行环境的主机、反向代理及网络服务可能记录请求时间、IP、访问路径、状态码或浏览器信息等请求 metadata。授权回调 URL 还可能包含临时授权码和 state,其是否进入基础设施日志取决于实际日志配置。本说明不作“所有层级均无日志”或固定日志保存时间的承诺。
5. 凭据领取后的保存位置
连接成功后,授权凭据交给发起请求的 void0 实例,由实例自己的加密凭据库保存。实例的 PostgreSQL 数据库、加密密钥、备份和后续访问权限由该实例管理员维护;中心清除短期配对记录,不会同步删除实例已经领取的凭据。
在 void0 中断开连接,不等于在 Vercel 中卸载 Integration 或撤销平台侧权限。需要撤销平台授权时,请同时在 Vercel 的 Integration 管理页面检查并移除对应安装。
Cloudflare access token、refresh token(如有)或手动填写的 API Token 直接保存在你的实例加密凭据库中,用于查询域名和 DNS,以及提交你确认的 DNS 修改。修改预览保存在同一加密凭据库,5 分钟有效且仅能提交一次;实例另保留最近 100 条修改概要,不包含 TXT 等记录内容。断开 Cloudflare 会删除实例当前凭据并使未完成的授权失效;平台侧授权应另在 Cloudflare 中撤销,已有实例备份的清理由实例管理员负责。
6. 使用时如何核对
只从你自己的 void0 发起连接,确认授权页面位于 https://auth.void.elonehoo.me,核对页面显示的实例地址,再手动输入自己实例中显示的配对码。不要使用他人发送的链接或配对码。公网实例应使用 HTTPS;HTTP 仅用于本机回环地址的开发实例。
跳转到 Vercel、GitHub 或 Cloudflare 后,相应平台按自己的隐私规则处理你的操作及信息;选择授权范围前,请查看平台自己的权限与隐私说明。
7. 联系与源码
有关本说明或共享授权服务的问题,请联系 hi@elonehoo.me。实现代码可在 GitHub 项目中查看。