MediaWriter：Fedora U 盘启动盘制作工具

项目简介

Fedora Media Writer 是一款帮助用户把 Fedora 镜像写入 USB 闪存盘的工具。它可以自动下载所需的镜像，并通过直接访问设备的方式，以类似 dd 的方式写入。由于写入会覆盖 U 盘原有的分区布局，它还提供 Restore（还原） 功能，用于把 U 盘重新格式化为标准的单分区布局。

Fedora Media Writer 支持 Linux、Windows 和 macOS。

主要功能

• 自动下载所需的 Fedora 镜像，无需手动寻找 ISO 文件。
• 以类似 dd 的方式把镜像直接写入 U 盘设备。
• 写入完成后会完整读回校验结果。
• 提供 Restore 功能，把 U 盘重新格式化回标准单分区布局。
• 跨平台，支持 Linux、Windows、macOS。

安装与使用

仓库说明中给出的是从源码构建的方式，使用标准的 Qt cmake 构建系统。各发行版可能另有自己的打包渠道，请以对应渠道的说明为准。

依赖要求

平台	依赖
全部	Qt（>=6.10.2）
Linux	udisks2 或 storaged、xz-libs
Windows	xz-libs
macOS	xz-libs

Linux

通过 cmake 选项 -DCMAKE_INSTALL_PREFIX 指定安装前缀（默认为 /usr/local）：

cmake [OPTIONS] .

主程序 mediawriter 会安装到 $PREFIX/bin，辅助程序安装到 $PREFIX/libexec/mediawriter/helper。

Windows

只要所有依赖都在 include 路径中，在 Windows 上构建就是运行 cmake 和 make。要生成独立的分发包，可使用 Qt 安装自带的 windeployqt 工具，通常还需要手动打包一些额外的 DLL。也可以在 Fedora 等发行版上使用 MinGW 编译器套件交叉编译。

macOS

照常运行 cmake 和 make。要生成独立的分发包，可使用 Qt 安装自带的 macdeployqt 工具。

翻译

如果希望帮助翻译 Fedora Media Writer，可访问其 Weblate 项目页面：https://translate.fedoraproject.org/projects/fedora-media-writer/mediawriter/

注意事项

写入会覆盖 U 盘的分区布局。 使用前请确认目标设备中没有需要保留的数据；制作完成后可用 Restore 功能还原 U 盘。

遇到崩溃或写入错误时，请在 GitHub 上提交 issue，并附上 Documents 目录中的 FedoraMediaWriter.log 文件（Linux 与 macOS 为 $HOME/Documents，Windows 为 %USERPROFILE%\Documents）。该文件包含一些非敏感的系统信息和本次会话的事件日志。

U 盘写入后无法识别时，常见原因包括：

• 写入过程被中断，分区布局处于操作系统无法识别的状态。这种情况可以恢复，可尝试使用 Fedora Media Writer 自带的 Restore 功能，或在 Windows 的“磁盘管理”、Linux 的 fdisk / gparted 中手动重新格式化。
• U 盘使用低质量元件，无法承受持续高速写入产生的热量。
• U 盘本身已接近寿命终点。

如果 U 盘显示为只读或不含介质，通常说明闪存控制器已检测到内部故障，需要更换 U 盘。

关于密码学实现与 User-Agent 字符串相关的隐私说明，可参阅仓库中的 CRYPTOGRAPHY.md 与 PRIVACY.md。

---

本作品整理自 GitHub 开源项目 FedoraQt/MediaWriter，原作者 @FedoraQt，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。