无头服务器 / 容器运行桌宠,助手反复崩溃怎么办

本页目录

没有图形桌面的服务器优先使用网页模式;先停止崩溃循环,再检查磁盘占用。

你会看到什么

Linux 无图形容器运行 DSH Web,日志反复出现 Electron 助手启动和退出,插件目录不断增加 core dump,最终出现磁盘空间或配额耗尽。#35 的 0.2.5 案例报告了固定 750ms 重试与大量崩溃文件;频率和体积是该事故数据,不是所有版本的必然结果。

为什么会这样

报告者将问题定位为无图形环境仍启动桌面助手,加上缺少重试上限。浏览器画面运行在客户端,服务器通常只需提供网页服务;在无头服务器强行拉起本地 Electron 并不能让远端用户桌面出现宠物。

解决步骤

  1. 先停止产生新崩溃。

    用原有服务管理或容器管理入口正常停止运行 DSH 的服务或容器,保存日志;不要反复重启测试。

  2. 备份后改为仅网页。

    找到该服务实际使用的 DSH 数据目录和配置,按配置说明将每个需要显示的宠物 display 改为 "web",不要把宿主机用户目录误当容器内目录。保留其他字段,重启后只打开一个网页验证。

  3. 检查剩余磁盘与崩溃文件。

    在容器或服务管理工具中查看磁盘占用,并确认错误日志指向的具体目录。先确认文件确实是该助手生成的 core dump,保留必要样本;按本机运维流程清理已确认的转储文件。不要使用针对整个 node_modules 或 DSH 数据目录的批量删除命令。

补充防护的边界

#35 建议 ulimit -c 0 限制 core dump。如果你的启动方式确实是 Linux shell,可在启动 DSH 的同一个 shell、原启动命令之前设置:

ulimit -c 0

它只影响随后继承该限制的进程,不能停止既有进程、清除旧文件或修复重启循环;容器运行器和系统转储收集方式还需按实际部署核对。不要把它当成仅网页模式的替代。

怎么确认有效

观察启动日志,确认助手不再持续启动退出;隔一段时间复查崩溃文件数量与磁盘余量,并确认网页宠物可用。若仍循环,停止服务并保持插件停用,不要继续耗盘验证。

如果还不行

提供容器镜像、宿主与插件版本、显示配置、日志和转储落点。运行时下载错误见平台运行时排查,公网入口失败见反代排查;本文没有核查后续版本是否已加入无头检测与熔断。

来源与适用范围

原始报告:#35。本文依据已保存的 issue 正文整理,并对照官方 INSTALL 与 CONFIG 文档;未核查后续评论、当前源码与发布记录;报告中的分析和版本仅用于定位,不能据此认定当前版本仍有同样问题或已有修复。

官方参考:安装说明、配置说明(2026-11-03 查阅的上游快照)。配置和运行时目录应以该实例实际使用的 DSH_HOME 为准,~/.dsh 只是默认路径示例。官方安装文档要求安装后重开 DSH;网页实例则重启 dsh web。

旧版切为仅网页后若留下不可点击的红色配置条,参考#130 红条恢复说明;不要因此认定 web 是非法值。

资料来源(历史报告):#35。整理日期:2026-11-03,适用版本及证据限制见正文。