企业官网建设流程全解析

davincibox 是一个为 DaVinci Resolve 提供完整 Linux 运行依赖的容器方案，基于 Podman + distrobox/toolbox，特别适合 Fedora Atomic 等不可变系统。本文用大白话讲清楚 davincibox 升级与卸载的路径：容器内更新软件包、用setup.sh一键升级、手动重建容器的区别，并附上最佳实践清单。

📦 先搞懂：davincibox 的三层结构

升级前先分清层级，否则容易"大动干戈"：

💡 大多数"升级"其实只需要动容器内软件包这一层；只有 davincibox 项目本身发布新版（脚本、依赖列表变化）时，才需要重建容器。

⚡ 日常最快升级：容器内 dnf update

如果只是想更新 GPU 驱动或系统包，不需要重建容器：

# distrobox distrobox enter davincibox -- sudo dnf update # toolbox toolbox run -c davincibox sudo dnf update

几十秒即可完成，Resolve 与项目数据完全不受影响。

🔄 什么时候必须完整重建 davincibox 容器

满足任一条件时，建议完整重建：

• davincibox 发布了新版本。可查看 CHANGELOG.md，例如 v3.3.0 将基础系统 rebase 到 Fedora 44、改用--device参数传递 NVIDIA GPU、支持链接宿主机 OFX 插件——这类改动只有重建容器才会生效；
• 问题在容器内更新后依然复现。官方建议在提交 issue 前先做一次完整升级，排除旧镜像的干扰。

🛠️ 方式一：setup.sh 一键升级

setup.sh的upgrade选项分两步：先删，再装。

第一步：删除旧容器

./setup.sh upgrade

脚本会停止并移除 davincibox 容器（逻辑见 setup.sh 的 upgrade 分支 与 remove_davincibox_container），随后提示你重新运行安装。

⚠️ 常见误区：setup.sh upgrade不会自动重装 DaVinci Resolve，它只负责清理。执行完就停下的话，你只剩一个空操作。

第二步：按全新安装重跑脚本

将官方安装器（.run文件）与脚本放在同一目录，然后执行：

./setup.sh ./DaVinci_Resolve_xxx_Linux.run

这一步脚本自动完成四件事（见 create_davincibox_container）：

1. podman image pull拉取最新镜像，避免命中本地旧缓存；
2. 用lshw检测 GPU，自动选择davincibox（NVIDIA）或davincibox-opencl（Intel / AMD）镜像；
3. 创建容器并执行dnf update，确保包是新的；
4. 解压.run安装器，在容器内运行setup-davinci完成 Resolve 安装，并自动清理squashfs-root。

前提：宿主机已安装 distrobox 或 toolbox，以及lshw。

🔧 方式二：手动拉镜像 + 重建容器

适合想完全掌控流程、或无法使用setup.sh的场景。

1. 拉取新镜像

# NVIDIA podman image pull ghcr.io/zelikos/davincibox:latest # Intel / AMD podman image pull ghcr.io/zelikos/davincibox-opencl:latest

2. 删除旧容器（即卸载步骤）

# distrobox distrobox stop davincibox distrobox rm davincibox

💡 升级场景可以跳过add-davinci-launcher remove这一步——它只移除桌面启动器，重装时会被覆盖。

3. 用新镜像重建容器

# NVIDIA（distrobox） distrobox create -i ghcr.io/zelikos/davincibox:latest --additional-flags "--device nvidia.com/gpu=all" -n davincibox # Intel / AMD（distrobox） distrobox create -i ghcr.io/zelikos/davincibox-opencl:latest -n davincibox

toolbox 用户可改用toolbox create -i ghcr.io/zelikos/davincibox-opencl:latest -c davincibox创建。

4. 重新安装 Resolve 并收尾

/path/to/DaVinci_Resolve_xxx_Linux.run --appimage-extract distrobox enter davincibox -- setup-davinci squashfs-root/AppRun distrobox rm -rf squashfs-root distrobox enter davincibox -- sudo dnf update

toolbox 用户将distrobox enter davincibox --换成toolbox run --container davincibox，setup-davinci的最后一个参数改为toolbox即可。

🗑️ 完整卸载 davincibox

一键卸载

./setup.sh remove

remove 分支 会依次执行：先运行add-davinci-launcher remove移除桌面启动器，再停止并删除 davincibox 容器。

手动卸载

# distrobox distrobox enter davincibox -- add-davinci-launcher remove distrobox stop davincibox distrobox rm davincibox # toolbox toolbox run --container davincibox add-davinci-launcher remove podman container stop davincibox toolbox rm davincibox

卸载后还要清理什么？

• 镜像仍保留在磁盘上：如不再使用，可执行podman image rm ghcr.io/zelikos/davincibox:latest（-opencl版同理）；
• 项目与设置安全：Resolve 的项目文件和配置都在用户主目录中，删除容器不会影响；
• 宿主机 udev 规则不受容器卸载影响：如果你曾为 Speed Editor 在宿主机安装过 70-davincibox-speed-editor.rules，可手动移除：

sudo rm /etc/udev/rules.d/70-davincibox-speed-editor.rules sudo udevadm control --reload-rules

✅ 升级与卸载最佳实践清单

一句话总结：小修小补用dnf update，davincibox 发新版才重建容器；重建优先交给setup.sh（记得升级后重跑安装），彻底告别时用remove——无论哪种方式，主目录里的项目文件都安然无恙。