日志文件与报告问题

出问题的时候,日志文件才是把"它坏了"变成一份可修复报告的关键。请在问题发生后尽快把它们取出来。

日志在哪里

在任何操作系统上最快的路径:在仪表盘中打开设置,在通用标签页的诊断与支持下点击打开数据文件夹。Windows 上日志在其 logs 子文件夹中;macOS 上日志位于下面列出的单独文件夹。

具体位置如下:

  • Windows: %ProgramData%\Nexus\logs
  • macOS: ~/Library/Logs/Nexus
  • Linux: 服务写入系统日志;用 journalctl -u nexus 读取(加上 -f 可实时跟随)。

主文件是 nexus-service.log。服务每次启动时,上一次运行的日志都会归档为 nexus-service-<timestamp>.log(保留最新的五份),所以文件夹里既有当前这次运行,也有最近的历史记录。在 Windows 上,同一个文件夹还会收集其他 Nexus 组件的日志,命名为 nexus-*.log。每份服务日志的第一行都记录了它来自哪个 Nexus 版本。

支持包

仪表盘可以把所有相关内容打包成一个 ZIP 文件:在设置的诊断与支持下,或在系统诊断页面顶部点击导出支持包(两处生成的是同一个文件)。它包含全部日志、OpenRGB 守护进程的日志、诊断数据,以及一份去除了凭据的设置副本。把这个包附在报告里,比自己一个个挑文件要好得多。

如何反馈

加入我们的 Discord,那里是获得帮助最快的地方,错误报告也在那里跟踪。请附上:

  1. 您的 Nexus 版本。 它印在 nexus-service.log 的第一行,所以日志文件本身就带着它。
  2. 您的操作系统(Windows、macOS 或 Linux,以及版本号)。
  3. 发生了什么、什么时候发生的:您做了什么、期望看到什么、实际看到了什么,以及大致的发生时间,以便与日志时间戳对上。
  4. 日志文件或支持包,在问题还新鲜的时候采集。

提示

日志在服务每次启动时轮换,且只保留最近五次运行,所以如果您打算通过重启或重装来绕过某个问题,请先把日志文件夹复制出来。