Windows部署DeepSeek DSH本地Web完整避坑教程
简介
DeepSeek DSH是DeepSeek推出的命令行AI工具，支持本地Web界面运行。很多用户按照官方文档直接复制npx命令执行，会遇到终端卡死、长时间无输出、下载停滞等问题。本文记录完整踩坑与解决流程，帮助大家一次性部署成功。
环境：Windows PowerShell，Node.js v24.17.0
文章目录
问题现象
直接执行官方示例命令
npx @deepseek-ai/dsh web
终端提示需要安装包，输入y确认回车之后，光标一直闪烁，没有任何输出，看起来程序卡死不动。
造成该现象的核心原因：
- npx会临时拉取npm包，即便修改npm全局镜像源，npx内部部分逻辑依旧会访问国外源，国内网络环境下载缓慢，终端不会输出下载进度，视觉上等同于卡死。
- Node版本过低也会引发异常，建议使用22.19.0及以上版本。
完整部署步骤
1. 配置国内npm镜像源
打开管理员权限PowerShell，执行切换镜像命令，使用npmmirror国内镜像，解决下载慢问题。
npm config set registry https://registry.npmmirror.com
校验镜像是否配置成功
npm config get registry
输出结果应为https://registry.npmmirror.com。
2. 确认Node版本
node -v
版本必须大于等于22.19.0，如果版本过低，前往Node.js官网下载最新LTS版本重装。
3. 清理npm缓存（可选）
遇到缓存异常时执行
npm cache clean --force
输出警告信息属于正常现象，可以忽略。
4. 放弃npx，全局安装包（关键避坑点）
不要使用npx运行，改用全局安装方式，规避npx下载卡死问题。
npm install -g @deepseek-ai/dsh
执行完成输出类似：added 452 packages in 55s即为安装成功。
出现deprecated废弃警告，属于第三方依赖库提示，不影响程序运行，无需处理。
5. 启动Web界面
全局安装完成之后，直接运行命令启动服务：
dsh web
如果提示找不到dsh命令，关闭当前PowerShell窗口，重新打开管理员PowerShell再执行命令。
端口冲突备选方案
当默认端口被占用，手动指定端口启动
dsh web --port 13080
随后浏览器访问 http://127.0.0.1:13080。
运行效果
启动成功后浏览器会打开DeepSeek HARNESS Web页面，页面提示选择工作区，点击输入框左侧加号，新建工作区即可开始使用。
常见问题汇总
问题1：npx执行就卡死
解决方案：彻底放弃npx调用方式，优先使用npm install -g全局安装。npx的临时下载机制在国内网络环境稳定性很差。
问题2：全局安装后提示’dsh’不是内部或外部命令
解决方案：关闭终端，重新打开管理员PowerShell窗口。npm全局安装之后新的环境变量需要新开终端才能加载。
问题3：安装过程中途手动Ctrl+C中断
不要中途中断安装进程，会破坏包缓存，出现损坏需要重新执行安装命令。
问题4：Web页面打开空白
检查PowerShell终端服务是否还在运行，不要关闭PowerShell窗口，关闭窗口服务就会停止。
总结
官方文档给出的npx @deepseek‑ai/dsh web命令在国内网络环境不友好，极易卡死。最佳实践是切换国内镜像源，使用npm install -g全局安装，再直接调用dsh web启动，避开npx带来的各种网络坑。
转载声明：本文为原创文章，如需转载，请联系作者获得授权，并注明出处。
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/zxc18344522713/article/details/164195128
