如果你把 DSH 跑在阿里云 ECS 上做远程开发，归档会话会越攒越多，而数据躺在服务器磁盘里，本地浏览器够不着。这篇教程带你走完一遍完整流程：选实例、装引擎、装插件，用安全组或 SSH 隧道打通 3080 端口，最后把 DSH_HOME 规划到数据盘，让归档清理真正释放空间。
选一台够用的 ECS 实例
不需要大规格。DSH Web 本身是 Node 服务，归档管理插件做的事是解析本地会话文件，属于轻负载。通用算型或经济型实例即可，2 vCPU 起步，内存 4 GiB 比较从容。系统盘建议 40 GiB 以上；如果会话量大，直接挂一块独立数据盘，后面规划 DSH_HOME 时会用到。操作系统选 Alibaba Cloud Linux 或 Ubuntu 22.04 都行。
安装 Node 与 dsh 引擎
SSH 登录实例后，先装 Node 20 LTS。Ubuntu 下的方式是：
Alibaba Cloud Linux 换用对应的 yum 源即可。然后全局安装 dsh 引擎：
安装归档管理插件
动手装之前，建议先到 DeepSeek Harness Hub 插件清单 里看一眼验证档位与安全扫描说明。安装只需一条命令：
它为 DSH Web UI 提供 Codex 风格的归档会话管理：在设置页查看、搜索、预览、恢复和彻底删除归档会话，按工作区自动分组并显示对话计数与磁盘占用。装完建议核对 $DSH_HOME/profiles/web/package.json，确认 dsh.profile.bundles 数组里已经包含 @mlgbnb/dsh-archive-manager。
启动 Web 服务，选一种访问方式
服务起来后监听 3080 端口，默认绑定在本机回环地址上。在云上有两种方式访问它。
方案一，安全组放行。在 ECS 控制台给 3080 端口加一条入方向规则，授权对象只填你自己的固定 IP，不要写成 0.0.0.0/0——归档会话里往往有代码和业务上下文，暴露给整个公网风险太高。出方向也要注意：插件具备发起外部网络请求的能力，若安全组限制了出网，需确认放行相关流量，避免功能异常。
方案二，SSH 隧道，更推荐。完全不动安全组，本地终端执行：
然后本地浏览器打开 http://127.0.0.1:3080/，流量全程走加密隧道，公网暴露面为零。点击侧边栏底部的齿轮图标进入设置 → 插件，就能看到「归档管理」卡片。
把 DSH_HOME 规划到数据盘
会话归档是真实占用磁盘的数据。想让物理删除真正释放数据盘空间，前提是数据根目录就在数据盘上。先把数据盘挂载并格式化好（比如挂到 /data），再在启动 dsh 之前设置环境变量：
之后 sessions、storages 这些目录都会落在 $DSH_HOME 下，删归档释放的才是数据盘的空间，而不是把系统盘越挤越满。
上手前要避开的四个坑
坑一：插件未声明 engines，低版本环境不会明确报错
现象：装完启动后功能入口时有时无，甚至毫无反应，日志里也没有像样的报错。 原因：这个插件的 package.json 未声明 engines.node 与 dsh 版本约束，而 README 实际要求 DSH >= 0.1.2-alpha.2。版本不够时没有任何兜底提示。 解决：装之前先跑 dsh --version 自查，确认版本不低于 0.1.2-alpha.2，别指望安装器替你把关。
坑二：能装不等于安全，装前先备份 ~/.dsh
现象：插件工作一切正常，但你未必清楚它在服务器上能做什么。 原因：静态扫描发现 25 处证据显示它具备读写/删除本地文件、发起外部网络请求的能力，目前尚无人工评估。这是能力清单而非危险判定，但在共享的云服务器上尤其要谨慎。 解决：按需安装；首次安装前先备份 ~/.dsh（或你的 $DSH_HOME），出了问题好回滚。
坑三：DSH_HOME 来回切，会话「消失」了
现象：昨天还在的归档会话，今天打开列表就找不到了，数据像凭空蒸发。 原因：数据根目录由 DSH_HOME 决定——设了走 $DSH_HOME，没设走 ~/.dsh。在 ECS 上如果一会儿带环境变量启动、一会儿直接裸跑，插件读的其实是两个不同的数据目录。 解决：固定一种方式，把 DSH_HOME 写进启动脚本或 systemd 的 Environment 配置里，不要在两套目录之间漂移。
坑四：上游改内部存储结构，插件解析可能失效
现象：dsh 升级之后，归档列表突然空白，或者报解析错误。 原因：插件运行时读取 DSH 的 storages/workspace.json、storages/session_projcache.json 与 sessions/ 目录，依赖这些内部结构；dsh 还处于 developer-preview 阶段，上游随时可能调整。 解决：升级 dsh 前先备份，升级后第一时间验证归档管理还能否正常列出会话，确认无误再进行批量操作。
总结
在 ECS 上跑起 DSH Web，再用 SSH 隧道把 3080 端口安全地拉到本地浏览器，归档清理就不再需要登服务器敲命令；动手之前若想核对插件的兼容性与最新验证状态，也可以到 DeepSeek Harness Hub 插件清单 里查一眼，心里更有底。
适合与不适合
适合：把 DSH 部署在阿里云 ECS 上做远程开发的工程师；归档会话长期堆积、想释放数据盘空间的团队；习惯浏览器操作、不想 SSH 敲命令管理会话的人；需要按项目分组批量清理历史会话的用户。
不适合：只用 DSH CLI/TUI 的用户——插件仅在 Web Profile 下有效，装了也没有入口；对数据合规要求严格、无法接受插件包含文件删除与网络请求能力且尚未人工评估的环境；期望删除后可撤销的人，物理删除没有回头路。
标签：DSH、Codex 归档管理、阿里云ECS、SSH隧道、会话归档
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
