deepseek harness desktop linux 怎么跑：桌面包、CLI 加 Web UI 与无头三种路径

Linux 上的 deepseek harness desktop 没有官方安装包，但有三种可用路径：CLI 加本机浏览器、服务器加 SSH 转发、容器或无头环境。 三条路径的能力接近，差别在隔离性、访问方式与维护成本。

先说结论：Linux 没有官方桌面包

官方桌面端目前只覆盖 macOS 与 Windows，Linux 没有对应的 deb、rpm 或 AppImage。 搜不到安装包不是你的问题，是官方还没发布（来源）。

没有桌面包不等于不能用。 DeepSeek Harness 的核心能力通过 CLI 启动 Web UI 提供，桌面端主要多了系统集成与托盘；在 Linux 上，CLI 加浏览器已经覆盖日常使用。

不要去找第三方打包的「Linux 桌面版」。 来源不明的安装包风险高于收益；需要桌面体验时，用浏览器固定标签页或创建桌面快捷方式即可，没必要引入未知来源。

路径一：CLI 加本机浏览器

这是 Linux 上最短的一条路，适合个人电脑与开发机。 前提只有一个：Node.js 可用。

1. 确认 Node.js 版本满足要求：node -v，版本过低先升级。
2. 用 npx @deepseek-ai/dsh web 启动；npx 会拉取并运行最新版本，适合先体验。
3. 终端会输出本地访问地址，通常是 127.0.0.1 加一个端口；用浏览器打开该地址。
4. 首次进入按引导完成模型与 profile 初始化，再进「设置 → 插件市场」装插件。
5. 需要长期使用时，改为全局安装，避免每次启动都重新拉取。

127.0.0.1 是默认监听地址，不要随手改成 0.0.0.0。 后者会把服务暴露到局域网甚至公网，官方出于安全考虑默认不支持直接监听全部网卡；需要外部访问时用 SSH 转发或反向代理。

npx 与全局安装的差别在更新方式。 npx 每次运行都拉最新版，省心但启动慢；全局安装启动快，但要自己执行更新。个人机器推荐全局安装，临时体验用 npx。

路径二：服务器加 SSH 端口转发

服务器没有浏览器，但可以通过端口转发把界面「搬」到本地。 这条路径适合远程开发机与云主机。

1. 在服务器上启动 Web 服务，监听 127.0.0.1 上的端口；不要监听公网地址。
2. 在本地终端执行 ssh -L 本地端口:127.0.0.1:远端端口 用户名@服务器，建立隧道。
3. 在本地浏览器打开 http://127.0.0.1:本地端口，访问的是服务器上的服务。
4. 保持 SSH 会话不断开；断开后隧道失效，需要重新建立。
5. 需要长期访问时，用反向代理加认证替代临时隧道，并限制来源 IP。

端口转发只解决「怎么访问」，不解决「谁能访问」。 多人使用时，认证与权限要单独配置；不要把隧道当成安全边界。

隧道断开后页面会失去连接。 这是正常现象，不是服务崩溃；重新建立隧道并刷新即可。

路径三：容器与无头环境

容器适合隔离与复现，无头环境适合自动化。 两条路都要求你把数据目录单独管理。

1. 容器： 用官方或可信镜像启动，把 DSH_HOME 挂成数据卷；端口只映射到本机，不直接暴露公网。
2. 无头： 在服务器上启动服务，用 SSH 或反向代理访问；适合 CI、远程办公与多人共用。
3. 验证： 容器重建后检查会话与插件是否仍在；不在就是数据卷没挂对。
4. 限制： 无头环境没有桌面能力，涉及图形界面的插件无法使用；容器里的权限与宿主不同，插件行为可能有差异。

容器的关键不是启动，是持久化。 不挂数据卷，重建一次就回到初始状态；会话、插件与配置全部丢失。

无头环境要提前确认插件兼容性。 依赖系统托盘、图形界面或桌面授权的插件，在无头环境里装上也用不了；装之前先看插件说明。

三条路径对照

选路径看三件事：有没有图形界面、要不要隔离、谁来维护。

个人使用优先第一条，远程办公选第二条，需要隔离或复现选第三条。 三条不互斥，可以组合，例如容器加 SSH 转发。

四种常见失败

Linux 上的失败集中在四处，且都有明确判据。

1. 命令找不到。 npx 或 dsh 不在 PATH，先确认 Node.js 与 npm 的安装方式，再检查 shell 配置。
2. 端口打不开。 服务监听在 127.0.0.1，而你在另一台机器访问；用 SSH 转发或反向代理，不要改成监听全部网卡。
3. 浏览器能开但功能缺失。 多半是浏览器兼容或缓存问题；换浏览器或清缓存对照，不要先怀疑服务端。
4. 重启后数据不见。 容器没挂数据卷，或 DSH_HOME 指向了临时目录；确认目录位置后再迁移。

四种失败的共同排查入口是日志与监听地址。 先看服务实际监听在哪，再看请求有没有到达，最后才怀疑功能本身。

插件与数据放在哪里

Linux 上的插件与数据位置和桌面端一致，差别只在路径写法。 迁移或备份时，认目录不认启动方式。

1. 配置、会话与插件数据统一在 DSH_HOME 下，可用环境变量指定到更大的磁盘。
2. 备份时整个目录一起备份，只备份会话会丢插件配置，只备份插件会丢会话索引。
3. 迁移到另一台机器时，先停服务再复制，运行中复制可能出现半写文件。
4. 容器场景把 DSH_HOME 挂成卷，并确认容器内用户对目录有写权限。

数据位置与启动方式解耦，是 Linux 使用中最值得记住的一点。 换启动方式不会丢数据，丢数据通常是清理了目录或没挂卷。

下一步

先在个人机器上跑通第一条，再考虑远程与容器。 想了解安装方式的整体对照，看《DeepSeek Harness 怎么安装》；想在服务器上做无头部署，看《DeepSeek Harness Linux 无头桌面》；想在容器里跑，看《DeepSeek Harness 跑在 Docker 里》。

来源：DeepSeek Harness 官方文档、dsh CLI README、DeepSeek Harness Releases、deepseek-harness 仓库