# 腾讯云 CVM 上跑 DSH，宿主版本与引擎要对齐

在云主机上试兼容层，最容易犯的错不是装错包，而是**宿主版本与引擎版本没配对**。pi2dsh 的兼容性是一张枚举表，不是范围声明。这篇按 CVM 的实际操作顺序走一遍。
## 一、选型：2 核 4G 起

pi2dsh 本身不重，但它会把 Pi 那套包挂进来，npm 依赖树不小，`pnpm add` 阶段的内存峰值比日常运行高。1 核 2G 的实例容易在安装阶段被杀进程，建议直接 2 核 4G。

系统盘给到 40G 以上：`node_modules` 加缓存加工作区，很容易吃掉十几 G。

## 二、Node 与宿主版本

pi2dsh 0.27.0 要求 node ≥ 22.19.0，宿主对应 **DSH 0.2.1-rc.2**。三组被声明的组合只有这三行：0.27.0 ↔ 0.2.1-rc.2、0.26.0 ↔ 0.2.0-rc.2、0.25.2 ↔ 0.1.5-rc.2。

先把宿主的实际版本查出来，再决定装哪个引擎版本。反过来装（先装引擎再看宿主）大概率得到一张对不上的表。

## 三、安装

```bash
dsh plugin --profile web add pi2dsh
dsh plugin --profile web add pi-mcp-adapter
# 然后重启 dsh —— 插件在启动时挂载
```

两个包都要装：引擎负责翻译，适配器负责把 MCP 那套能力接上。只装引擎，`/pi-mcp` 是看不到的。

## 四、安全组

只需要放行 SSH 端口。要访问 DSH 的 Web 界面（默认 3080 或你自己指定的端口），再放行那一个端口，**源地址限定到你的 IP**。

不建议把 Web 端口开给全网：DSH 的 Web 端具备完整的工具调用能力，暴露在公网上等于把执行能力交出去。

## 五、四个卡点

#### 坑一 · CVM 上 Node 版本不够

**现象。** 安装阶段通过，重启后引擎没挂上，或者直接报错退出。

**原因。** pi2dsh 0.27.0 声明 `node >=22.19.0`。低于这个版本，npm 未必拦住（取决于安装路径），但运行时行为不可预期。

**解决。** 用 nvm 装 22.19+，并在非交互式 shell 里也生效（写进 `~/.bashrc` 之外还要注意 systemd 或容器入口的 PATH）。

#### 坑二 · 装完没重启 profile 就找不到 pi2dsh

**现象。** `dsh plugin --profile web list` 里有 pi2dsh，界面上却没有任何变化。

**原因。** 插件在 `dsh` 启动时挂载，add 只写 profile 记录。

**解决。** 重启 `dsh --profile web`。如果用的是 systemd 托管，记得 `systemctl restart`，别只重启一个前台终端。

#### 坑三 · 安全组把 Web 端口挡住

**现象。** 本地浏览器连不上 DSH 界面，但 SSH 正常。

**原因。** 安全组只放行了 22，3080（或自定义端口）没开。

**解决。** 加一条入方向规则，源限定你的 IP。更稳的做法是不开端口，用 SSH 隧道把 3080 搬到本机 loopback——这样公网上一个端口都不暴露。

#### 坑四 · 用 root 跑整套

**现象。** 图省事用 root 装、用 root 跑，之后 `pnpm approve-builds` 与插件构建脚本也以 root 执行。

**原因。** pnpm 拦构建脚本是一个安全默认值。你以 root 批准它，等于把这些脚本的执行权放到最高权限下。兼容层会装载外部 Pi 包，来源不可控。

**解决。** 建普通账号、`chown` 工作目录、用该账号跑 dsh。需要绑定低端口时用反向代理，不要让进程本身拥有特权。

## 六、验收

1. `node -v` ≥ v22.19.0；
2. 宿主版本在枚举表里，且与引擎版本配对；
3. 重启后能进 Web 界面；
4. 装 `pi-mcp-adapter` 后 `/pi-mcp` 能打开全屏服务器管理器；
5. 安全组只有 SSH 与你限定的 Web 端口。

五条全过，这台 CVM 才有资格做兼容层验证。

## 总结

CVM 侧的关键是两件事：Node 与宿主版本要先对齐，端口与权限要收住。其余步骤与本地一致。

## 适合与不适合

**适合**：需要在云上长期跑 DSH 并试 Pi 生态的人；要把验证环境标准化的团队；遇到「装上但没生效」想定位的人。

**不适合**：只在本机短期试用的人；不愿意管版本配对的人；打算把 Web 端口直接开给公网的人。

标签：pi2dsh、DeepSeek Harness、腾讯云、CVM、兼容层

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。


在云主机上试兼容层，最容易犯的错不是装错包，而是宿主版本与引擎版本没配对。pi2dsh 的兼容性是一张枚举表，不是范围声明。这篇按 CVM 的实际操作顺序走一遍。

腾讯云 CVM 上跑 DSH，宿主版本与引擎要对齐

在云主机上试兼容层，最容易犯的错不是装错包，而是宿主版本与引擎版本没配对。pi2dsh 的兼容性是一张枚举表，不是范围声明。这篇按 CVM 的实际操作顺序走一遍。想先看同类插件清单，见 DeepSeek Harness Hub 插件清单。

云计算

开发工具

运维

腾讯云CVM部署pi2dsh需先核对宿主DSH版本与引擎版本枚举配对，Node须≥22.19.0，推荐2核4G配置。安全组仅放行SSH及限定IP的Web端口，安装后必须重启dsh，用非root账号运行。验收五步全过才算合格。

代码解释

服务器

云主机

容器

pnpm

快速部署LLM、AI绘画等应用,助你玩转AIGC！


4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

腾讯云 CVM 上跑 DSH，宿主版本与引擎要对齐-腾讯云开发者社区-腾讯云

腾讯云 CVM 上跑 DSH，宿主版本与引擎要对齐

腾讯云 CVM 上跑 DSH，宿主版本与引擎要对齐

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐