最新

在 Linux 运行 Dusk Light

选择与你 CPU 匹配的 Linux AppImage,设为可执行,再从文件管理器或终端启动 Dusklight。进入后选择自己的受支持 GameCube 或 Wii 转储。下面的说明会覆盖 Vulkan、FUSE、发行版差异、GLIBC 和 AppImage 权限。

最后核对: 2026-09-19,对照 GitHub v2.0.0

Linux AppImage 路线

官方 v2.0.0 发布版本提供 Linux x86_64 AppImage 和 Linux ARM64 AppImage。多数 PC 和 Steam Deck 使用 x86_64,ARM64 只用于兼容的 ARM Linux 设备。Linux 上的关键不是多下载几次,而是看终端输出:Vulkan、FUSE、GLIBC 或驱动错误通常会直接说明问题。

安装步骤

  1. 01下载与你设备匹配的 Linux AppImage:多数 Linux PC 和 Steam Deck 用 x86_64,ARM Linux 硬件才用 ARM64。
  2. 02用文件管理器把 AppImage 标记为可执行,或在终端运行 chmod +x Dusklight-*.AppImage。
  3. 03双击 AppImage,或从终端启动。
  4. 04在 Dusklight 中选择 Select Disc Image,选中你自己的 GameCube 或 Wii 光盘转储(韩版 Wii 除外)。

开始前检查

x86_64 或 ARM64

多数 Linux PC 使用 x86_64 AppImage。ARM64 只适用于兼容 ARM Linux 设备。

Vulkan 驱动

官方 README 要求 D3D12、Vulkan 或 Metal 之一;Linux 路线主要看 Vulkan 与 Mesa/厂商驱动质量。

AppImage/FUSE

部分发行版需要额外 AppImage 或 FUSE 支持。双击没反应时,先用终端看错误。

自己的支持转储

使用自己的 GameCube 或 Wii 光盘转储。v2.0.0 支持零售版光盘,韩版 Wii 除外。项目不分发游戏文件,也不支持 Twilight Princess HD。

校验并启动 AppImage

Linux 最适合用终端排查。下面命令用于确认文件、加执行权限,并让启动错误可见。

校验 x86_64 AppImage

sha256sum ./Dusklight-v2.0.0-linux-x86_64.AppImage

GitHub 官方发布资产的元数据含 SHA-256 信息,适合用于下载记录。

添加执行权限

chmod +x ./Dusklight-v2.0.0-linux-x86_64.AppImage

这是 AppImage 首次启动前最常见的 Linux 步骤。

从终端启动

./Dusklight-v2.0.0-linux-x86_64.AppImage

如果出现 GLIBC_2.39、Vulkan、FUSE 或驱动信息,请保存输出并附到问题记录中。

Linux 注意事项

  • Steam Deck 用户应查看单独页面;二进制仍是 Linux x86_64 AppImage。
  • 部分发行版需要额外 AppImage/FUSE 支持。
  • ARM64 AppImage 只适用于兼容 ARM Linux 设备。
  • 排查时记录发行版、GPU、驱动、Dusklight 版本和是否使用 texture pack。
  • Dusk Light 不托管 ROM、ISO、光盘镜像或版权资产。

其他官方构建

继续查看同语言平台指南

在当前语言中切换到其他 Dusk Light 安装页面,比较文件大小、更新时间和平台限制。

v2.0.0 变化

发布于 2026 年 9 月 19 日

GitHub 将 v2.0.0 标为最新稳定版。x86_64 AppImage 为 45.1 MiB,ARM64 AppImage 为 43.4 MiB。

Renderer 性能重构

v1.4.0 重构了渲染器性能并加入完整鼠标控制。比较旧性能报告前先更新到 v2.0.0。

纹理加载与 Vulkan

v2.0.0 改进了纹理包的流式加载和缓存,并修复 Nix 构建查找 Vulkan 库的问题。新版还加入模组浏览器和存档管理器。Vulkan 或纹理包出错时,请保留终端输出。

Linux 问题追踪记录

问题 #837: GLIBC 启动错误

不计划处理

Pop!_OS 报告中出现 GLIBC_2.39 等终端错误,说明旧发行版可能在窗口出现前失败。

打开来源

问题 #1268: GPU ID selection

开放中

多 GPU 用户报告无法选择 GPU,排查时应记录 GPU 与 Vulkan 设备信息。

打开来源

问题 #910: raw AppImage

已完成

该请求已完成,当前发布版本直接提供 AppImage 文件。

打开来源

问题 #968: portable mode

已完成

用于说明 AppImage portable mode 预期和历史问题。

打开来源

事实来源

这里列出的所有文件都指向 TwilitRealm/dusklight 在 GitHub 发布的官方资产。Dusk Light 不镜像二进制文件,也不托管受版权保护的游戏数据。