令牌中枢

v0.1.10

  • 2026-10-30
  • fnos
返回首页

fnos

最低系统 1.1.3100 · 测试版

令牌中枢 TOTPilot 0.1.10 发布说明

发布信息

  • 版本：0.1.10（首个发布版本）
  • 发布日期：2026-10-30
  • 适用平台：飞牛 fnOS（x86 / arm）
  • 最低系统版本：1.1.3100
  • 安装包：
    • TOTPilot-x86-0.1.10.fpk（6,468,163 字节）
    • TOTPilot-arm-0.1.10.fpk（6,062,044 字节）
  • 许可证：MIT

发布概述

令牌中枢（TOTPilot）是运行在飞牛 NAS 上的自用 TOTP 验证器。它将令牌、密钥与审计数据集中保存在 NAS 本地，提供动态码生成、验证码校验、加密备份与恢复，以及供本机其它服务调用的集成面 API。

本版本为 0.1.10，是 TOTPilot 的首个正式发布版本。

主要功能

令牌管理

  • 支持备注名、发行方、账号、站点链接、账户密码、密钥、算法、位数、周期、分组、标签、备注、自定义字段、图标、排序与启用状态。
  • 令牌密钥与账户密码分别使用 AES-256-GCM 加密保存，主密钥文件权限为 0600。
  • 账户密码在界面中只显示掩码，仅提供复制操作，不提供明文查看。
  • 查看密钥需二次确认并写入审计日志。
  • 动态码由服务端按 RFC 6238 计算，前端仅负责倒计时刷新；总览页不显示动态码。
  • 支持分组、标签、手动排序与最近使用时间排序。

导入与导出

  • 支持单条或批量导入 otpauth:// 链接。
  • 支持二维码图片识别与相机扫描。
  • 支持 Google Authenticator 迁移链接（otpauth-migration://）。
  • 导入前逐条预览，重复项与非法项会明确标注。
  • 支持导出 otpauth:// 或 JSON 明文，供临时迁移使用。

验证与集成

  • 提供手动验证码校验，可指定令牌，也可在启用令牌中自动匹配。
  • 校验结果返回匹配时间步、偏移步数与令牌参数，便于排查兼容性问题。
  • 支持创建集成面 API Token，Token 只在创建时显示一次。
  • 集成面端点：
    • POST /api/v1/verify
    • GET /api/v1/tokens
    • GET /api/v1/status
  • API Token 具备 verify、tokens、status 权限范围。
  • 集成面默认限流 30 次/分钟，支持同一时间步防重放。

安全与审计

  • 管理面仅对飞牛管理员可见。
  • 支持开启管理台二次解锁，并配置空闲自动锁定时间。
  • 审计日志区分操作日志与运行日志，覆盖令牌、导入导出、备份恢复、设置、API Token、Webhook、解锁等模块。
  • 动态码、密钥、账户密码、API Token 明文与 SMTP 密码不会写入日志与审计。
  • 应用不接入统计、崩溃上报或第三方云服务。

备份与迁移

  • 支持创建 .totpbak 加密备份，文件内包含数据库快照与主密钥。
  • 备份密钥使用 Argon2id 派生，备份口令由用户设置。
  • 恢复前自动生成「恢复前安全备份」；校验失败不会改动现有数据。
  • 支持每日 / 每周计划备份，并可配置保留份数。
  • 支持下载、上传、校验、恢复与删除备份。

通知与时间校准

  • 支持 SMTP 邮件通知，可配置验证失败、备份失败、时钟偏移与恢复完成等事件。
  • 支持 Webhook 通知，事件使用 X-TOTPilot-Signature: sha256=<hex> 签名。
  • 应用按配置间隔独立查询 NTP，只记录时间偏移，不修改系统时钟。
  • 动态码默认使用「系统时间 + NTP 偏移」计算，可关闭偏移参与计算。
  • 偏移超过警告 / 危险阈值时触发通知与总览告警。

管理台

  • 提供状态总览、令牌管理、验证与接入、备份与迁移、审计日志、系统设置与帮助中心。
  • 支持亮色、暗色、自动三种主题。
  • 支持 WebSocket 实时事件刷新。
  • 提供加密备份、二次解锁、集成面 API、NTP、SMTP 与 Webhook 的配置入口。

安装与升级

  1. 根据 NAS 架构选择对应安装包：
    • x86 设备使用 TOTPilot-x86-0.1.10.fpk
    • arm 设备使用 TOTPilot-arm-0.1.10.fpk
  2. 在飞牛 fnOS 中安装对应的 .fpk 包。
  3. 安装完成后通过 /app/TOTPilot/ 进入管理台。
  4. 升级时数据保存在 $TRIM_PKGVAR 数据目录内，升级过程不会清除已有令牌与设置。
  5. 卸载时默认保留数据目录；如需彻底清除，请自行确认后再删除。

首次使用

  1. 打开「令牌管理」，点击「新增令牌」。
  2. 手动填写 Base32 密钥，或通过「扫码 / 粘贴链接」导入 otpauth:// 地址。
  3. 保存后在列表中查看动态码，验证码会按周期自动刷新。
  4. 在「验证与接入」中手动校验验证码，并按需创建 API Token。
  5. 建议在「系统设置」中开启管理台二次解锁，并配置加密备份。
  6. 如需外部服务调用，请创建 API Token 并妥善保存，Token 只在创建时显示一次。

兼容性

  • 遵循 RFC 4226 / RFC 6238。
  • 支持 SHA1、SHA256、SHA512。
  • 支持 6 / 7 / 8 位验证码。
  • 支持 30 秒 / 60 秒周期。
  • 支持导入 Google Authenticator、Microsoft Authenticator、Authy、1Password、KeePassXC 及任意标准 TOTP 验证器生成的 otpauth:// 数据。
  • HOTP 与 Steam Guard 不在支持范围内。

安全说明

  • 所有令牌、密钥、账户密码与审计日志均保存在 NAS 的 $TRIM_PKGVAR 数据目录内。
  • 除用户主动配置的 SMTP、Webhook 与 NTP 外，应用不发起任何外呼。
  • 备份口令遗失后将无法恢复对应备份，请妥善保管。
  • 设备损坏且无可用备份时，令牌数据无法找回。
  • 请自行确保 NAS 登录安全、网络边界安全与备份文件的存放安全。

安装包校验和

  • TOTPilot-x86-0.1.10.fpk
    • SHA-256：18a80cd504a70c8fe3975f10d112e03ba54376566b453be01d90334b239a6a26
  • TOTPilot-arm-0.1.10.fpk
    • SHA-256：82149dd5177f089e445bab909b77d603670686f26663a5ef78c790a58f1e63b6

已知限制

  • 本应用为个人自用工具，管理面仅面向飞牛管理员。
  • 不支持 HOTP、Steam Guard 或非标准 TOTP 变体。
  • NTP 校准只影响动态码计算所用的偏移，不修改系统时间。
  • 备份口令无法找回，遗失后只能使用其它备份或重新录入令牌。
  • 明文导出文件不包含保护措施，仅建议临时使用并及时删除。

版本记录

  • 0.1.10：首个发布版本，包含令牌管理、动态码、验证与导入、集成面 API、加密备份与恢复、审计日志、帮助中心、SMTP / Webhook、NTP 校准与管理台二次解锁。