企业官网建设流程全解析

Flipper Authenticator CLI命令完全指南：用命令行高效管理你的全部令牌

【免费下载链接】flipper-zero_authenticatorSoftware-based TOTP/HOTP authenticator for Flipper Zero device.项目地址: https://gitcode.com/gh_mirrors/fl/flipper-zero_authenticator

Flipper Authenticator 是一款运行在 Flipper Zero 设备上的软件版 TOTP/HOTP 认证器，而它内置的CLI命令系统则让你可以用命令行方式高效管理全部令牌。本指南面向新手和普通用户，从查看令牌列表、添加与删除令牌，到设置 PIN 码、配置自动输入与导出备份，手把手带你掌握 Flipper Authenticator 命令行工具的全部核心用法，轻松成为命令行管理高手。

Flipper Authenticator CLI 是什么？为什么值得用？✨

Flipper Authenticator 本质上是一个"口袋里的 Google Authenticator"，支持基于时间的一次性密码（TOTP，RFC 6238）和基于计数器的一次性密码（HOTP，RFC 4226）。除了在设备屏幕上直观查看验证码，它还内置了一套功能完整的命令行接口（CLI），让你通过终端连接设备后，用纯文本命令完成所有令牌管理操作。

使用 CLI 管理令牌有三大好处：

• 批量操作更快捷：一条命令即可添加、更新或删除令牌，无需在屏幕上反复点按；
• 脚本化与自动化：可以配合自动化脚本完成批量导入、导出与备份；
• 功能更完整：某些高级设置（如自动化输入、加密密钥槽位）在 CLI 中操作更直观。

快速入门：如何进入 Flipper Authenticator 命令行模式

进入 CLI 前，请确保你的 Flipper Zero 已通过 USB 连接到电脑，并在终端中打开串口会话（如使用screen、minicom或 Flipper 官方 CLI 工具）。连接成功后，输入应用注册的命令名totp，即可进入 Flipper Authenticator 命令行模式：

totp help

所有 CLI 命令都以totp开头，支持多个别名（如list与ls等效），方便快速输入。完整的命令语法说明记录在项目的 cli_help.txt 文件中，命令路由与插件加载逻辑则在 cli.c 中实现，感兴趣的读者可以对照源码深入学习。

查看帮助与版本：最快的上手方式

显示全部命令用法

totp help

help（别名h、?）会一次性打印所有命令、参数和选项的完整说明，是新手最应该先执行的一条命令。忘记某个参数怎么写时，随时调用它即可。

查看应用版本

totp version

该命令用于确认当前安装的 Flipper Authenticator 版本号，排查兼容性问题时非常有用。

令牌管理核心命令：增删改查与排序 📋

查看令牌列表：list

totp list

列出设备上保存的全部令牌，默认以表格形式展示；若需要结构化输出，可追加--tsv参数得到制表符分隔的格式，方便复制到表格软件中处理：

totp list --tsv

表格与 TSV 两种输出格式分别由 list_output_formatter_table.c 和 list_output_formatter_tsv.c 实现。

查看单个令牌详情：lsattr

totp lsattr <index>

（别名cat）查看指定序号令牌的详细信息，包括类型、算法、位数、有效期、计数器以及自动化输入特性等。details插件的输出格式化器位于 details 目录下。

添加新令牌：add 🆕

totp add <name> [-t <type>] [-a <algo>] [-d <digits>] [-e <encoding>] [-l <duration>] [-u] [-b <feature>]...

add（别名mk、new）用于添加新令牌，常用参数包括：

• -t <type>：令牌类型，totp或hotp，默认totp；
• -a <algo>：哈希算法，可选sha1、sha256、sha512、steam，默认sha1；
• -d <digits>：验证码位数，可选 5、6、8，默认 6；
• -e <encoding>：密钥编码，base32或base64，默认base32；
• -l <duration>：TOTP 有效期（秒），范围 15–255，默认 30；
• -i <counter>：HOTP 初始计数器，仅 HOTP 令牌适用；
• -u：输入密钥时不隐藏字符；
• -b <feature>：自动化输入特性，可选none、enter、tab、slower。

执行命令后，CLI 会提示你输入令牌密钥（默认以*掩码显示），确认后即可完成添加。核心实现见 add.c。

小技巧：从 Google Authenticator 迁移时，先扫码获得otpauth://URI，再从中提取密钥按上述方式添加，或直接使用下文的export功能反向操作。

更新已有令牌：update ✏️

totp update <index> [-n <name>] [-t <type>] [-a <algo>] [-d <digits>] [-l <duration>] [-s] [-e <encoding>] [-b <feature>]...

update用于修改指定序号的令牌，参数与add基本一致，额外包括：

• -n <name>：修改令牌名称；
• -s：重新输入并更新令牌密钥。

只修改某个属性时，只需传入对应的参数，其余配置保持不变，非常灵活。实现见 update.c。

删除令牌：delete 🗑️

totp delete <index> [-f]

delete（别名rm）按序号删除令牌。默认会要求你在设备上交互确认，追加-f参数可跳过确认直接删除，适合脚本场景。

调整令牌顺序：move

totp move <index> <new_index>

move（别名mv）将指定序号（从 1 开始）的令牌移动到新的位置，方便把常用令牌排在列表前面，减少翻页次数。

安全设置：PIN 码与加密密钥槽位 🔐

设置 / 修改 / 移除 PIN

totp pin set [-c <slot>] totp pin remove [-c <slot>]

• totp pin set：设置或修改 PIN 码，按提示使用键盘方向键输入（显示为*），回车确认；
• totp pin remove：移除 PIN 码保护；
• -c <slot>：指定新的加密密钥槽位，范围 12–100，可用于更换加密密钥。

设置 PIN 后，每次执行敏感命令（如查看令牌详情）都需要先验证身份。更换 PIN 时，CLI 还会自动为配置文件创建备份，确保操作安全。PIN 相关逻辑见 pin.c。

高级功能：自动化输入、通知与时区 ⚙️

配置自动输入：automation

totp automation [<automation>...] [-k <layout>] [-w <delay>]

automation用于配置验证码的自动输入方式，支持：

• 自动化方法：none（关闭）、usb（USB HID 模拟键盘）、bt（蓝牙 HID）；
• -k <layout>：键盘布局，可选QWERTY、AZERTY、QWERTZ、Czech、Dvorak、Hungarian、Slovak；
• -w <delay>：输入前的初始延迟（秒），默认 0.5。

配置完成后，在令牌详情页触发自动化输入，Flipper Zero 就会像键盘一样自动敲入验证码，配合-b enter/-b tab特性（添加令牌时设置）甚至可以自动补按回车或 Tab，实现"一键登录"。键盘布局支持由 kb_layout_provider.c 提供，自动化方法定义见 automation_method.h。

设置通知方式：notify

totp notify [<notification>...]

查看或设置通知方式，可选none（无）、sound（声音）、vibro（振动）。在生成验证码时以声音或振动提醒，方便不低头看屏幕的场景。

设置时区：timezone

totp timezone [<timezone>]

查看或设置当前时区偏移（小时）。TOTP 验证码依赖时间计算，如果设备时间与服务器不一致导致验证失败，首先检查并修正时区设置。timezone（别名tz）的实现见 timezone.c。

数据备份与迁移：export 与 reset 💾

导出全部令牌：export

totp export

export会在控制台打印全部令牌的明文密钥（以otpauth://URI 列表格式输出），方便迁移到其他认证器或备份。⚠️ 注意：执行此命令前 Flipper 屏幕上会弹出安全确认对话框，因为明文密钥一旦泄露，账号安全将受到威胁。导出后请务必妥善保管输出内容并及时清除终端记录。实现见 export.c。

恢复出厂设置：reset

totp reset

将应用恢复到默认设置。该操作会清除全部令牌和配置，请务必先使用export备份，确认无误后再执行。

常用命令速查表 📖

结语：让命令行成为你的令牌管理利器 🚀

Flipper Authenticator 的 CLI 命令系统虽然界面朴素，却功能强大：从最基础的增删改查，到 PIN 加密、自动化输入、导出备份，几乎覆盖了令牌管理的全部场景。对于新手，记住totp help和totp list两条命令即可快速上手；对于进阶玩家，善用-b自动化特性和export备份功能，能让 Flipper Zero 真正成为你身边最顺手的双因素认证设备。

如果需要从零开始构建 Flipper Authenticator 固件环境，可以参考项目内的 application.fam 与 config.h 了解应用结构与编译配置。现在就拿起你的 Flipper Zero，在终端里敲下第一条totp list吧！

【免费下载链接】flipper-zero_authenticatorSoftware-based TOTP/HOTP authenticator for Flipper Zero device.项目地址: https://gitcode.com/gh_mirrors/fl/flipper-zero_authenticator