---
title: 固件更新
slug: zero/zh/basics/firmware-update
description: 了解如何通过 Flipper Mobile App 和 qFlipper 更新 Flipper Zero 固件
image: https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/B6josfTadPTAQ4sK-W6SG_firmwareupdprev-zh.png
docTags: 
createdAt: 2021-07-26T17:12:00.000Z
---

![](https://api.archbee.com/api/optimize/3GUDYkC5JgUWgo6RW8piO-AX6-GeQuAq3DXGCqjsguo-20241024-174007.png)

我们会持续更新 Flipper Zero 固件。建议您定期更新设备，以获得最新功能和改进。你可以通过 [Flipper Mobile App](https://docs.flipper.net/zero/zh/mobile-app) 或 [qFlipper](https://docs.flipper.net/zero/zh/qflipper) 更新 Flipper Zero。

本页将介绍如何通过 Flipper Mobile App 和 qFlipper 更新 Flipper Zero 固件。

***

固件更新分为三个通道：

- <font color="#fb4400">**DEVELOPMENT (Dev)：**</font> 我们的开发工作持续进行，每次提交代码都会构建一个新的开发版固件，通常每天会有多次。该版本包含所有最新功能，但可能不稳定，会导致卡死、数据损坏，甚至完全无法使用。
- <font color="#892ae0">**RELEASE-CANDIDATE (RC)：** </font>已提交给 QA 部门进行验证测试的固件版本。如果在测试阶段发现缺陷，该版本会被修订，并发布新的候选版本。候选版本通过全部测试后，就会成为正式发布版。
- <font color="#30ce30">**RELEASE：** </font>固件的稳定版本，经过充分测试以确保可靠性，我们推荐一般用户使用该版本。

***

:::Iframe{iframeHeight="500" code="<div class=&#x22;warning flipper-callout&#x22;>&#xA;    <div class=&#x22;callout-header&#x22;>更新前请先插入 microSD 卡</div>&#xA;    要正确更新固件，Flipper Zero 中必须插入 microSD 卡。Flipper Zero 的数据库存储在 microSD 卡上。要了解更多信息，请参阅 <a href=&#x22;https://docs.flipper.net/zero/zh/basics/sd-card&#x22; onclick=&#x22;next.router.push('https://docs.flipper.net/zero/zh/basics/sd-card')&#x22;><u>microSD 卡设置</u>。&#xA;</div>"}

:::

Flipper Zero 固件的更新日志可以在我们官方 GitHub 仓库的 [Releases 页面](https://github.com/flipperdevices/flipperzero-firmware/releases)查看。

***

# 通过 Flipper Mobile App 更新

使用 [Flipper Mobile App](https://docs.flipper.net/zero/zh/mobile-app)，你可以通过蓝牙更新 Flipper Zero。该应用支持 iOS 和 Android：

:::Iframe{iframeHeight="0" code="<style>&#xA;  .flipper-downloads-btn {&#xA;    width: 100%;&#xA;    display: flex;&#xA;    justify-content: center;&#xA;    margin-top: 20px;&#xA;    margin-bottom: 20px;&#xA;  }&#xA;  .flipper-downloads-btn > a {&#xA;    display: inline-block;&#xA;    max-width: 100%;&#xA;    padding: 20px 48px;&#xA;    background-color: #FF8200;&#xA;    color: #FFFFFF;&#xA;    font-family: -apple-system, BlinkMacSystemFont, &#x22;Segoe UI&#x22;, &#x22;PingFang SC&#x22;, &#x22;Hiragino Sans GB&#x22;, &#x22;Microsoft YaHei&#x22;, &#x22;Noto Sans SC&#x22;, Roboto, Helvetica, Arial, sans-serif;&#xA;    font-size: 24px;&#xA;    font-weight: 700;&#xA;    line-height: 1.2;&#xA;    text-align: center;&#xA;    text-decoration: none;&#xA;    border-radius: 20px;&#xA;    box-sizing: border-box;&#xA;    transition: background-color 0.15s ease;&#xA;  }&#xA;  .flipper-downloads-btn > a:hover {&#xA;    background-color: #D9742A;&#xA;  }&#xA;</style>&#xA;<div class=&#x22;flipper-downloads-btn&#x22;>&#xA;  <a href=&#x22;https://flipper.net/pages/downloads&#x22; target=&#x22;_blank&#x22; rel=&#x22;noopener&#x22;>下载 Flipper Mobile App</a>&#xA;</div>"}

:::



## 连接到 Flipper Zero

下载 Flipper Mobile App 并打开手机蓝牙后，将应用连接到 Flipper Zero：

::::WorkflowBlock
:::WorkflowBlockItem
按以下步骤打开 Flipper Zero 的蓝牙：

1\) 转到 **Main Menu** **→ Settings** **→** **Bluetooth**。

2\) 将 **Bluetooth** 设置为 **ON**。
:::

:::WorkflowBlockItem
在 Flipper Mobile App 中点按 **Connect**。
:::

:::WorkflowBlockItem
在下一个页面中，点击 Flipper Zero 名称旁的 **Connect**。

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/08fIwZdt39o4931jgIjmV_mobile-app-first-connect.png "你可以通过蓝牙将 Flipper Zero 连接到手机")
:::

:::WorkflowBlockItem
在 Flipper Mobile App 中**输入 Flipper Zero 屏幕上显示的配对码**。
:::

:::WorkflowBlockItem
点按 **Pair** 完成配对。
:::
::::

### 如果未检测到 Flipper Zero

- 确认 Flipper Zero 的蓝牙已打开。→ [如何打开 Flipper Zero 的蓝牙](https://docs.flipper.net/zero/zh/basics/settings#bluetooth)。&#x20;
- 检查手机的蓝牙连接。
- 断开 Flipper Zero 与其他设备的连接。→ [如何清除 Flipper Zero 上所有已配对的设备](https://docs.flipper.net/zero/zh/basics/settings#bluetooth)。
- 将 Flipper Zero 更新到最新固件版本。定期更新 Flipper Zero 非常重要。→ [如何更新 Flipper Zero 的固件](https://docs.flipper.net/zero/zh/basics/firmware-update)。
- 检查手机上安装的 Flipper Mobile App 是否为最新版本。→ 前往[下载](https://flipper.net/pages/downloads)页面。
- 同时长按 **左方向键**%left% 和 **返回键**%back% 5 秒重启 Flipper Zero。



## 更新 Flipper Zero

要通过 Flipper Mobile App 更新 Flipper Zero，请执行以下操作：

::::WorkflowBlock
:::WorkflowBlockItem
在主标签页中点按 **Update Channel**，然后选择需要的固件版&#x672C;**（推荐 Release）**。
:::

:::WorkflowBlockItem
点按 **Update** 按钮。
:::

:::WorkflowBlockItem
在弹出的对话框中点按 **Update** 按钮确认操作。
:::
::::

通过 Flipper Mobile App 更新大约需要 **10 分钟**。

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/jmxSUOPFccGA1tSZQyT24_mobile-app-firmware-update.png "你可以通过 Flipper Mobile App 更新 Flipper Zero")

### 如果更新失败

- 检查与 Flipper Zero 的蓝牙连接。
- 确认 Flipper Zero 已开机。
- 如果 Flipper Zero 没有响应，请同时长按 **左方向键**%left% 和 **返回键**%back% 5 秒重启设备。
- 重新开始固件更新。
- 改用 qFlipper 更新 Flipper Zero。

***

# 通过 qFlipper 更新

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/KxR78XKjlPwXWn04J-uLS_monosnap-miro-2023-11-29-16-00-28.jpg "使用 qFlipper 可以更新固件、管理文件，以及修复损坏的固件")

[qFlipper](https://docs.flipper.net/zero/zh/qflipper) 是一款桌面应用，可通过 USB 数据线更新 Flipper Zero。qFlipper 支持 Windows、macOS 和 Linux。要在电脑上安装 qFlipper，请执行以下操作：

::::::::WorkflowBlock
::::WorkflowBlockItem
下载对应操作系统的 qFlipper 安装文件。

:::Iframe{iframeHeight="0" code="<style>&#xA;  .qf-download-btn {&#xA;    display: flex;&#xA;    flex-direction: column;&#xA;    justify-content: center;&#xA;    width: 310px;&#xA;    height: 86px;&#xA;    text-align: center;&#xA;    color: #ffffff;&#xA;    font-size: 22px;&#xA;    font-weight: 700;&#xA;    line-height: 1.55;&#xA;    border-radius: 14px;&#xA;    background-color: #1faa20;&#xA;    transition: background-color 0.2s ease-in-out, color 0.2s ease-in-out, border-color 0.2s ease-in-out;&#xA;  }&#xA;  .qf-download-btn img {&#xA;    display: inline;&#xA;  }&#xA;</style>&#xA;<div style=&#x22;display: flex; justify-content: center;&#x22;>&#xA;  <a class=&#x22;qf-download-btn&#x22; href=&#x22;current&#x22;><span style=&#x22;font-size: 125%;&#x22;>下载 qFlipper</span><span>适用于 macOS</span></a>&#xA;</div>&#xA;<script>&#xA;  (() => {&#xA;    const qFlipper = { version: '', links: { macOS: '', Windows: '', Linux: '' } }&#xA;    let os = 'Windows'&#xA;    if (navigator.userAgent.includes('Macintosh')) { os = 'macOS' } else if (navigator.userAgent.includes('Linux') && !navigator.userAgent.includes('Android')) { os = 'Linux' } else { os = 'Windows' }&#xA;    function findLatest (versions) {&#xA;      let max = 0&#xA;      versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })&#xA;      return versions.find(e => e.timestamp === max)&#xA;    }&#xA;    fetch('https://update.flipperzero.one/qFlipper/directory.json').then((response) => { return response.json() }).then(data => {&#xA;      const release = data.channels.find(e => e.id === 'release')&#xA;      let max = 0&#xA;      release.versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })&#xA;      const latest = findLatest(release.versions)&#xA;      qFlipper.version = latest.version&#xA;      qFlipper.links.macOS = latest.files.find(e => e.target === 'macos/amd64').url&#xA;      qFlipper.links.Windows = latest.files.find(e => e.target === 'windows/amd64' && e.type === 'installer').url&#xA;      qFlipper.links.Linux = latest.files.find(e => e.target === 'linux/amd64').url&#xA;      document.querySelector('[href=&#x22;current&#x22;]').innerHTML = '<span style=&#x22;font-size: 125%;&#x22;>下载 qFlipper</span><span>适用于 <img style=&#x22;position: relative;top: -2px;margin: 0px 2px 0 8px;&#x22; src=&#x22;https://cdn.flipperzero.one/' + os + '-white-logo.svg&#x22;/> ' + os + '</span>'&#xA;      document.querySelector('[href=&#x22;current&#x22;]').setAttribute('href', qFlipper.links[os])&#xA;      document.querySelector('[href=&#x22;macOS&#x22;]')?.setAttribute('href', qFlipper.links.macOS)&#xA;      document.querySelector('[href=&#x22;Windows&#x22;]')?.setAttribute('href', qFlipper.links.Windows)&#xA;      document.querySelector('[href=&#x22;Linux&#x22;]')?.setAttribute('href', qFlipper.links.Linux)&#xA;    })&#xA;    /* fetch('https://update.flipperzero.one/firmware/directory.json').then((response) => { return response.json() }).then(data => {&#xA;      const dev = data.channels.find(e => e.id === 'development')&#xA;      const rc = data.channels.find(e => e.id === 'release-candidate')&#xA;      const release = data.channels.find(e => e.id === 'release')&#xA;      let latest = findLatest(dev.versions)&#xA;      document.querySelector('[href=&#x22;dev&#x22;]').innerHTML = 'Dev Unstable   <span style=&#x22;color: rgb(253, 36, 36);&#x22;>' + latest.version + '</span>'&#xA;      document.querySelector('[href=&#x22;dev&#x22;]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)&#xA;      latest = findLatest(rc.versions)&#xA;      document.querySelector('[href=&#x22;rc&#x22;]').innerHTML = 'Release Candidate   <span style=&#x22;color: rgb(135, 42, 204);&#x22;>' + latest.version + '</span>'&#xA;      document.querySelector('[href=&#x22;rc&#x22;]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)&#xA;      latest = findLatest(release.versions)&#xA;      document.querySelector('[href=&#x22;release&#x22;]').innerHTML = 'Latest Release   <span style=&#x22;color: rgb(59, 207, 70);&#x22;>' + latest.version + '</span>'&#xA;      document.querySelector('[href=&#x22;release&#x22;]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)&#xA;    }) */&#xA;  })()&#xA;</script>"}

:::

你也可以从 [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 格式**下载。运行前需要先为它添加可执行权限：

**使用图形界面**

::::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]`
:::::
::::::
:::::::
::::::::

## 更新 Flipper Zero

要通过 qFlipper 更新 Flipper Zero，请执行以下操作：

::::WorkflowBlock
:::WorkflowBlockItem
使用 USB 数据线将 Flipper Zero 连接到电脑。
:::

:::WorkflowBlockItem
在电脑上运行 **qFlipper**。
:::

:::WorkflowBlockItem
在 qFlipper 中转到 **Advanced controls** 选项卡。
:::

:::WorkflowBlockItem
点击 **Update Channel**，然后从下拉列表中选择固件版本（**推荐 Release**）。
:::

:::WorkflowBlockItem
点击 **Update** 开始更新。

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/FFYKs1cq0RO6wFWqRndXD_qflipper-firmware-update-new.png "通过 qFlipper 更新 Flipper Zero")
:::
::::

***

更新 Flipper Zero 固件时遇到问题？请查看以下页面：

::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/2m7XpdT1ka8fl7vLZwEfM_monosnap-miro-2023-08-07-19-56-04.jpg"}
[内部存储修复](https://docs.flipper.net/zero/zh/basics/firmware-update/storage-repair)
:::

:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/jaiIg8e0P0yP7ErCmJhv4_monosnap-miro-2023-08-07-19-56-23.jpg"}
[固件恢复](https://docs.flipper.net/zero/zh/basics/firmware-update/firmware-recovery)
:::
::::

