初始化指南

在成功变基到 obedur-os 并重启系统后，您需要执行一些初始配置来确保系统的最佳体验。由于 obedur-os 是基于容器构建的，部分硬件相关的底层配置需要手动完成。

1. TTY字体设置

为什么需要手动设置？

BlueBuild 镜像本身并不包含 TTY 字体的配置。在传统的 Fedora 安装中，这些设置通常由安装程序一次性生成。

由于 Fedora 默认的 TTY 字体在许多高分辨率显示器上显得非常小，这会导致 tuigreet (登录管理器) 难以辨认。

解决方法

obedur-os 已经预装了 terminus-fonts-console 字体包，您可以执行以下操作来优化显示效果：

A. 临时切换 (立即生效)

在 TTY 终端执行：

setfont ter-v32b

B. 永久配置 (重启生效)

编辑配置文件：
Terminal window
```
sudo nano /etc/vconsole.conf
```
设置 FONT 变量（将内容修改或添加为）：
```
FONT="ter-v32b"
```
保存并退出 (Ctrl+O, Enter, Ctrl+X)。

2. NVIDIA 驱动与安全启动 (MOK)

为什么需要配置？

如果您使用的是 NVIDIA 显卡版本，并且您的电脑开启了 Secure Boot (安全启动)，由于内核模块需要签名验证，未录入密钥将导致驱动无法加载，甚至可能导致系统无法正常启动。

解决方法

我们强烈推荐您通过以下方式完成密钥录入，以保持安全启动开启。

A. 录入密钥 (推荐)

执行录入脚本：在终端执行以下命令：
Terminal window
```
blujust enroll-secure-boot-key
```
按照提示操作：脚本会提示您设置一个临时的 MOK 密码。请务必记住这个密码。
重启并录入：重启电脑。在启动时会出现一个蓝色的 Shim UEFI Key Management 界面：
- 选择 Enroll MOK。
- 选择 Continue。
- 选择 Yes。
- 输入您之前设置的 MOK 密码。
- 选择 Reboot。

B. 关闭安全启动

如果您不想处理 MOK 密钥，也可以进入 BIOS 设置，将 Secure Boot 选项设置为 Disabled。

3. 代理服务配置 (Sing-box)

预置说明

obedur-os 预置了来自 ref1nd 分支的 sing-box，该分支提供了更丰富的功能支持。系统中已经内置了一个默认的 TUN 模式配置文件。

配置步骤

设置订阅链接：编辑默认的 TUN 配置文件：
Terminal window
```
sudo nano /etc/sing-box/tun.json
```
找到文件末尾附近的 providers 部分，将 url 中的 <CHANGE ME> 替换为您的实际订阅链接：
```
"providers": [
  {
    "type": "remote",
    "tag": "proxy",
    "url": "https://your-subscription-link-here",
    ...
  }
]
```
管理服务：使用 systemctl 来启动或管理代理服务。服务名称为 sing-box@tun.service。
- 启动并设置开机自启：
  Terminal window
```
sudo systemctl enable --now sing-box@tun.service
```
- 查看运行状态：
  Terminal window
```
systemctl status sing-box@tun.service
```
- 重启服务 (修改配置后)：
  Terminal window
```
sudo systemctl restart sing-box@tun.service
```
访问控制面板：系统预配置了 Web 面板，您可以通过浏览器访问：
- 地址：http://127.0.0.1:23333
- 密码：obedur

4. Flatpak 软件管理

预置说明

在 BlueBuild 架构中，Flatpak 软件并不会被包含在系统镜像中，而是通过一个用户级服务在系统启动时进行初始化和自动下载。

obedur-os 预置了以下两个核心管理工具：

Warehouse：强大的 Flatpak 图形化管理工具，支持安装、卸载、清理以及管理远程仓库。
Flatseal：细粒度的权限控制工具，用于管理 Flatpak 应用的系统资源访问权限。

管理工具：bluebuild-flatpak-manager

系统提供了一个便捷的命令行工具 bluebuild-flatpak-manager 来管理此服务。

查看当前配置：
Terminal window
```
bluebuild-flatpak-manager show
```
手动启动安装/应用配置：
Terminal window
```
bluebuild-flatpak-manager apply all
```
禁用自动安装服务 (如果您不打算使用 Flatpak 或网络环境极差)：
Terminal window
```
bluebuild-flatpak-manager disable all
```
重新启用自动安装：
Terminal window
```
bluebuild-flatpak-manager enable all
```

重要提示

浏览器安装：obedur-os 默认没有内置浏览器。建议在 Warehouse 安装完成后，通过它来安装您偏好的浏览器 (如 Firefox, Chrome 或 Brave)。
网络与代理：由于 Flatpak 包是在首次进入系统后异步下载的，如果您在第一次启动时没有配置好代理，初始化可能会失败或非常缓慢。建议先完成 Sing-box 配置并确保网络畅通，再手动执行 bluebuild-flatpak-manager apply all。
可选性：如果您不喜欢 Flatpak，可以随时通过上述命令将其彻底禁用。

5. Niri 配置初始化

预置说明

obedur-os 在 /etc/skel/.config/niri 中预置了一套深度的模块化配置，集成了 Noctalia Shell 和常用工具。

对于新创建的用户：这些配置会在创建用户时自动应用。
对于从其他系统变基来的用户：您需要手动同步这些预置配置到您的个人目录。

初始化与同步步骤

执行以下命令将完整的预置配置结构（包含 Niri、Ghostty 终端、Starship 提示符以及相应的 Bash 环境设置）应用到您的主目录：

# 创建必要的配置目录
mkdir -p ~/.config/niri ~/.config/ghostty

# 同步所有预置配置
cp -r /etc/skel/.config/niri/* ~/.config/niri/
cp /etc/skel/.config/ghostty/config ~/.config/ghostty/config
cp /etc/skel/.config/starship.toml ~/.config/starship.toml

# 同步 Bash 环境配置 (启用 Starship 的前提)
cp /etc/skel/.bashrc ~/.bashrc
cp /etc/skel/.bash_profile ~/.bash_profile

更新与重载配置

在修改配置文件后，您不需要重启系统：

实时重载：保存文件后，Niri 通常会自动重载配置。
手动触发重载：如果需要手动触发，可以执行：
Terminal window
```
niri msg action do-reload-config
```

常用快捷键与操作

obedur-os 预置了大量的快捷键以集成 Noctalia Shell。例如：

Mod + A 或 Space：应用启动器
Mod + T：打开终端 (Ghostty)
Mod + N：切换便签抽屉 (需安装上述插件)
Mod + Q：关闭窗口

6. 主题与外观配置

预置说明

obedur-os 提供了高度自定义的外观支持，您可以通过以下工具分别配置 GTK 和 Qt 应用的主题。

配置步骤

GTK 主题配置：
- 获取资源：从 gnome-look.org 下载您喜爱的 GTK 主题。
- 安装路径：解压并将其放入您的主目录下的 ~/.themes 文件夹中（如果不存在请手动创建）。
- 应用主题：打开预装的 nwg-look 程序进行主题、图标及光标的设置。
- 环境变量覆写：由于 Nautilus 等部分应用可能不遵循常规配置，预置配置在 ~/.config/niri/config.d/env.kdl 中提供了 GTK 主题的环境变量覆写示例（默认已注释）。设置好主题后，请前往该文件取消相关注释。
Qt 主题配置 (Qt5/6)：
- 获取资源：从 store.kde.org (Kvantum 分类) 下载 Kvantum 主题。
- 安装路径：通过 Kvantum Manager 的界面安装，或手动放入 ~/.config/Kvantum。
- 设置工具：打开 Kvantum Manager (程序名：kvantummanager) 选择并应用主题。
- 启用设置：设置完成后，请确保在 ~/.config/niri/config.d/env.kdl 中找到对应的 Kvantum 环境变量 并取消注释。
图标包配置：
- 获取资源：从 gnome-look.org (Icons 分类) 下载图标包。
- 安装路径：解压并将其放入您的主目录下的 ~/.icons 文件夹中（如果不存在请手动创建）。
- 应用图标：
  - GTK 应用：使用 nwg-look 进行设置。
  - Qt5/6 应用：分别打开 qt5ct 和 qt6ct 工具，在“图标主题”选项卡中选择对应的图标包。
  - Noctalia 组件：在 ~/.config/niri/config.d/env.kdl 中，找到并取消关于图标主题的环境变量注释（例如 // QS_ICON_THEME "Tela-dark"），将其中的名称修改为您实际安装的图标包名称。
字体配置：
- GTK 字体：使用 nwg-look 程序进行设置。
- Qt5/6 字体：分别打开 qt5ct 和 qt6ct 工具，在“字体”选项卡中进行设置。
- Noctalia 字体：通过 Noctalia Shell 自带的设置界面进行字体个性化调整。

7. Flatpak 主题与权限配置

核心原理

由于 Flatpak 应用运行在沙盒中，您需要手动授予其访问主题文件的权限，并配置环境变量来强制应用主题。

配置步骤

授予全局权限：执行以下命令，允许所有 Flatpak 应用读取您的本地主题、图标以及 Kvantum 配置：

flatpak override --user --filesystem=~/.themes:ro --filesystem=~/.icons:ro --filesystem=xdg-config/gtk-3.0:ro --filesystem=xdg-config/Kvantum:ro

设置主题环境变量：通过环境变量告知 Flatpak 应用具体使用哪个主题，并强制 Qt 应用使用 Kvantum 引擎：

# 设置 GTK 主题名 (请替换为您实际的主题名称)
flatpak override --user --env=GTK_THEME=您的主题名称

# 强制 Qt 应用使用 Kvantum 引擎
flatpak override --user --env=QT_STYLE_OVERRIDE=kvantum

安装 Flatpak 主题引擎：为了让 Flatpak 应用能够识别并调用主题引擎，建议通过 Warehouse 或命令行安装以下运行时：
- Qt 支持：org.kde.KStyle.Kvantum
- GTK 支持：org.gtk.Gtk3theme.adw-gtk3 (及对应的 dark 版本)

初始化指南

为什么需要手动设置？

解决方法

A. 临时切换 (立即生效)

B. 永久配置 (重启生效)

为什么需要配置？

解决方法

A. 录入密钥 (推荐)

B. 关闭安全启动

预置说明

配置步骤

预置说明

管理工具：bluebuild-flatpak-manager

重要提示

预置说明

初始化与同步步骤

更新与重载配置

推荐安装的 Noctalia 插件

常用快捷键与操作

预置说明

配置步骤

核心原理

配置步骤