跳转至

Rebase 指南

什么是 Rebase?

Warning

在不同桌面环境之间 rebase(例如从 KDE Plasma 到 GNOME)可能会造成问题,并且不受支持

Rebase 可以让用户切换到不同镜像,且无需重新安装,也不会丢失个人文件和应用数据。

建议使用 Bazzite Rollback Helper 工具

Rebase 适用场景

  • 如果新版 Bazzite 构建出现问题,可以 rebase 到过去 90 天内某个旧构建的指定镜像。
  • Rebase 到其它 Fedora Atomic Desktop 镜像,包括其它 Bazzite 镜像。
  • 不要在不同桌面环境之间 rebase。

如何在不同 Bazzite 镜像之间切换?

可以在主机终端中输入以下命令,查看当前所在的频道或构建:

rpm-ostree status

查看 “Deployments:” 下面的内容,输出应类似于:

 ● ostree-image-signed:docker://ghcr.io/ublue-os/[*image*]:[*channel*]

输入对应镜像的命令即可切换到另一个 Bazzite 变体。

打开终端并输入

rpm-ostree rebase <image>

示例

Warning

在不同桌面环境之间 rebase(例如从 KDE Plasma 到 GNOME)可能会造成问题,并且不受支持

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-deck:stable

用于 rebase 到 KDE Plasma 版本的 Bazzite-Deck 镜像。

如何更改 Bazzite 的更新分支?(Stable、Testing 和 Unstable)

面向最终用户的更新分支有两个:

  • Stable (:stable)
  • 普通 Bazzite 安装默认使用的分支。
  • Testing (:testing)
  • 在正式发布前提前体验未来的 Bazzite 构建。
  • 可能会经常出现 bug。
  • 测试重大版本后,建议 rebase 回 :stable

Unstable 分支

该分支仅面向 Bazzite 核心贡献者和维护者,用于需要频繁测试的重大改动。Unstable 分支可能甚至落后于 Stable 分支的更新,因为它用于测试特定重大改动,并不是按固定计划构建的分支。

在 Steam Gaming Mode 中切换更新分支

Bazzite-Deck 镜像可以在 Steam Gaming Mode 的 Settings > System > OS Update Channel 中切换分支。

如果启用了高级更新频道,会出现更多选项。这些选项对应关系如下:

Stable (:stable)
Release Candidate (:testing)
Beta (:testing)
Beta Candidate (:unstable)
Main (:unstable)

示例

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite:testing

用于 AMD/Intel 桌面镜像的 testing 分支。

Rebase 到旧构建

Attention

如果之后想升级到最新版本,需要 rebase 回 :stable

Warning

切换到旧版 Bazzite 构建后,在升级回 :stable 之前不会收到新的更新。这意味着在 rebase 回 Stable 分支之前,也不会收到安全更新。

和回滚到上一个 Bazzite 部署类似,用户也可以 rebase 到过去 90 天内构建的某个指定 Bazzite 构建。你的所有用户数据都会保留,但如上面的警告所述,之后必须手动 rebase 回 :stable,系统才能继续更新并接收最新构建。

输入以下命令可以查看可用 Stable 构建列表:

skopeo list-tags docker://ghcr.io/ublue-os/bazzite | grep -- "stable-" | sort -rV

要 rebase 到指定构建,需要打开主机终端并输入

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/IMAGE-NAME:VERSION-YEARMONTHDAY

示例

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-deck:39-20240113

用于 2024 年 1 月 13 日bazzite-deckFedora 39)构建。

(请注意,该构建已超过 90 天限制,因此不再可用;这里只作为本文档示例。)