--- title: qFlipper slug: zero/zh/qflipper description: 了解 qFlipper 应用的主要功能 image: https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/IBBGliOUfRcQRHx-53BH1_qflipper.png docTags: createdAt: 2022-10-24T10:37:59.000Z --- ![](https://api.archbee.com/api/optimize/3GUDYkC5JgUWgo6RW8piO-mU-xci-ZON3mhTIBwe9Ta-20241025-132049.png) **qFlipper** 是一款桌面应用，用于更新 Flipper Zero 的固件和数据库、管理 microSD 卡上的文件，以及修复损坏的固件。qFlipper 支持 Windows、macOS 和 Linux。本页将概要介绍这款应用，并说明如何把它安装到你的电脑上。你还会学到如何更新和控制 Flipper Zero，以及如何反馈 qFlipper 的问题。 *** # 安装 qFlipper 要在电脑上安装 qFlipper 应用，请执行以下操作： ::::::::WorkflowBlock ::::WorkflowBlockItem 下载适用于你操作系统的 qFlipper 安装文件。 :::Iframe{code="

" iframeHeight="0"} ::: 你也可以从 [Flipper Zero 固件更新](https://flipper.net/pages/downloads)页面下载 qFlipper。 :::: :::::::WorkflowBlockItem 运行下载好的文件，并按你操作系统对应的说明操作。 ::::::Tabs :::Tab{title="%windows%Windows"} 在 Windows 上，qFlipper 应用**仅兼容 Windows 10 和 11**。 ::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/XY9MzEKeRmDnvePKkIYoL_image-3.png" size="72" width="996" height="744" caption="qFlipper 支持 Windows" position="center" showCaption="true" darkWidth="996" darkHeight="744"} ::: :::Tab{title="%mac%macOS"} qFlipper 应用兼容 **macOS 10.14 及更高版本**，并针对 **Apple Silicon 机型做了优化**。 ::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/95k0UR1DiBdZ1PgkHCIhJ_image.png" size="78" width="1424" height="1024" caption="qFlipper 支持 macOS" position="center" showCaption="true" darkWidth="1424" darkHeight="1024"} ::: :::::Tab{title="%linux%Linux "} 在 Linux 上，qFlipper 以 **AppImage 格式**下载。在 Linux 上运行该应用之前，你需要先给它添加可执行权限： **使用图形界面** ::::WorkflowBlock :::WorkflowBlockItem 在文件管理器中，右键点击下载好的文件。 ::: :::WorkflowBlockItem 转到 **Properties → Permissions**。 ::: :::WorkflowBlockItem 如果你用的是基于 Nautilus 的文件管理器（Files、Nemo、Caja），请勾选 **Allow executing file as program**；如果你用的是 Dolphin，请勾选 **Is executable**；如果你用的是 PCManFM，请把 **Execute** 下拉列表改为 **Anyone**。 ::: :::WorkflowBlockItem 关闭该对话框。 ::: :::WorkflowBlockItem 双击 AppImage 文件即可运行。 ::: :::: **使用终端** ::::WorkflowBlock :::WorkflowBlockItem 打开终端。 ::: :::WorkflowBlockItem 切换到存放 AppImage 文件的目录。 ::: :::WorkflowBlockItem 给 AppImage 添加可执行权限：`chmod +x filename.AppImage`。 ::: :::WorkflowBlockItem 运行 AppImage：`./filename.AppImage`。 ::: :::: **设置 udev 规则** 通过图形界面或终端给应用添加可执行权限后，你还需要设置 udev 规则，才能以普通用户身份使用 qFlipper： `./qFlipper-x86_64.AppImage rules install [/optional/path/to/rules/dir]` ::::: :::::: ::::::: :::::::: *** # qFlipper：概览在电脑上安装好 qFlipper 应用之后，请**用 USB 线把 Flipper Zero（已插入 microSD 卡）连接到电脑**。在 **Device information** 标签页中，你可以查看 Flipper Zero 硬件和已安装固件的主要信息、[更新固件](https://docs.flipper.net/zero/zh/qflipper#qflipper-flipper-zero)，以及[远程控制 Flipper Zero](https://docs.flipper.net/zero/zh/qflipper#qflipper-flipper-zero-1)。 ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/H2Ucdl8BwxsTvaMrJjvaP_qflipper-main-page.jpg "Device information 标签页概览了主要参数") 在 **Advanced controls** 标签页中，你可以备份、恢复和重置 Flipper Zero，也可以选择要安装到设备上的固件。与 Device information 标签页一样，你也可以在这里控制 Flipper Zero 并启动更新流程。要了解备份和恢复流程的更多信息，请参阅[内部存储修复](https://docs.flipper.net/zero/zh/basics/firmware-update/storage-repair)。 ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/HJtTz0M7iaBBUsMkayL_P_qflipper-update.jpg "Advanced controls 标签页提供了更新、擦除和恢复功能") 在 **File manager** 标签页中，你可以删除、重命名文件，以及把文件上传到 Flipper Zero。你可以用键盘方向键方便地浏览文件。 ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/Tx7nYknYpZwgkhM8fxCbZ_qflipper-file-management.jpg "你可以在 qFlipper 应用中管理 Flipper Zero 的文件") # 如何使用 qFlipper 上传文件要把文件上传到 Flipper Zero，请在 **File manager** 标签页中，把文件拖放到目标文件夹，或者右键点击目标文件夹并点击 **Upload here**。 :::Iframe{code="" iframeHeight="0"} ::: :::Iframe{code="

上传时，同名文件会被直接覆盖，且不会有任何提示。

" iframeHeight="500"} ::: 只用键盘就可以在 File manager 标签页中方便地操作： | **操作** | **%windows%Windows 和 %linux%Linux 上的按键** | **%mac%macOS 上的按键** | | ------ | ---------------------------------------- | ------------------- | | 进入 | Return | Return | | 返回 | Backspace | Backspace | | 上传 | Ctrl+L | Command+L | | 下载 | Ctrl+D | Command+D | | 删除 | Delete | Fn+Backspace | | 立即删除 | Shift+Delete | Shift+Fn+Backspace | | 新建文件夹 | Ctrl+N | Command+N | | 重命名 | Ctrl+E | Command+E | | 刷新视图 | Ctrl+G | Command+G | *** # 通过 qFlipper 更新 Flipper Zero 固件 qFlipper 应用有三个固件更新通道： - **DEVELOPMENT (Dev)：** 开发工作会随着每次新提交持续构建新版本固件，通常每天多次。该 Development 版本包含所有最新功能，但可能不稳定，会导致卡死、数据损坏，甚至完全无法工作。 - **RELEASE-CANDIDATE (RC)：** 提交给 QA 部门做验证测试的版本。如果测试阶段发现问题，该版本会被修订，并发布新的 Release candidate。一旦某个 Release candidate 通过全部测试，它就会成为 Release 版本。 - **RELEASE：** 固件的稳定版本，经过充分测试以确保可靠性，因此推荐一般用户使用。 :::Iframe{iframeHeight="500" code="

更新前请插入 microSD 卡

要正确更新固件，Flipper Zero 中必须插入 microSD 卡。Flipper Zero 的数据库存储在 microSD 卡上。要了解更多信息，请参阅 microSD 卡设置。