Bazzite 是基于 Fedora Atomic 的 OCI 镜像，适用于 Steam Deck 及桌面设备。本文档涵盖系统启动引导、游戏模式、硬件兼容、软件更新、回滚恢复、网络及安全启动等方面的常见问题及解决方案。涉及 EFI 路径修复、Gamescope 日志检查、NVIDIA 驱动配置、rpm-ostree 回滚等操作。建议保持系统更新以获取最新修复。
Bazzite 作为一款基于 Fedora Atomic 的 OCI 镜像，为 Steam Deck 和桌面电脑提供了出色的游戏体验。然而在使用过程中，用户可能会遇到各种技术问题。本手册将详细介绍 Bazzite 的常见问题及其解决方案，帮助您快速恢复系统功能。
在最近的更新中，Bazzite 修复了 fwupd 的 EFI 路径问题。如果您遇到固件更新失败的情况，请检查 EFI 分区是否正确挂载。
解决方案： 运行以下命令修复 EFI 路径：
ujust fix-efi-path
某些情况下，运行 grub2-switch-to-blscfg 时可能出现目录缺失错误。
解决方案： 系统已通过更新自动修复此问题。如果仍然遇到此错误，请确保系统已更新至最新版本。
Bazzite 为 Gamescope 提供了修补后的 Mesa，确保正确的帧率控制。如果发现帧率不稳定：
ujust post-gamescope-logs蓝牙设备导致系统无法挂起： 这是已知问题，已在最新版本中修复。
解决方案： 更新系统并重启：
rpm-ostree upgrade && systemctl reboot
对于使用 NVIDIA 专有驱动的用户，Bazzite 提供了专门的 NVIDIA 版本。常见问题包括：
不同品牌的掌机设备需要特定的设置调整：
由于移除了 pip 安装的包并使用新制作的 rpm 包，解决了在分层某些包时出现的 Python 错误。
解决方案： 使用系统提供的 rpm 包而非 pip 安装：
ujust install-required-packages
Bazzite 引入了镜像重分块功能，将更新大小降低了 85%。如果更新过程中遇到问题：
rpm-ostree status 查看当前系统状态如果更新后出现问题，Bazzite 支持轻松回滚到之前的版本。
解决方案：
rpm-ostree rollback && systemctl reboot
Bazzite 默认使用 Google 的 BBR TCP 拥塞控制算法，提供更好的网络性能。
对于启用安全启动的用户，需要注册自定义密钥：
ujust enroll-secure-boot-key
注意： 如果提示输入密码，请输入 universalblue。
描述： 运行 grub2-switch-to-blscfg 时目录缺失错误 状态： 已在最新版本中修复
描述： fwupd 的 EFI 路径问题 状态： 已修复
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online