余额鲸鱼挂件（包名 `dsh-whale-widget`，作者 MeteorNOX，GitHub 2,689 Star）是 DSH Web 的标准 bundle 插件：每 60 秒拉一次 DeepSeek 余额、用「余额观测」推算今日已用（不需要令牌）、每轮对话结束弹消耗泡泡。能统一看住多个 API key 的消耗，但 DSH Web 默认只监听 `127.0.0.1:3080`，想做常在线统计就得放在一台常开的机器上——腾讯云 CVM 正合适。插件清单可先在 https://dpharness.com/top?utm_source=txyun&utm_medium=article  核对。
## 一、CVM 选型与镜像

常驻负载很轻，就是一个 Node 进程加挂件的宿主侧路由：2 核 2G 的 S5/SA5 够用，还要跑别的服务就选 2 核 4G。别选 1 核 1G——Node 22 装依赖时内存峰值容易打满，被 OOM Killer 杀掉后表现为「装到一半就断了」。镜像选 Ubuntu 22.04 或 24.04：NodeSource 的 Node 22 源在这两版上最稳，`curl`、`git` 自带；不要选 Windows 镜像，这条安装链路是 POSIX 的。
## 二、安全组：入方向只放行你的来源 IP

给 3080 写 `0.0.0.0/0`，或直接用默认的「放通全部端口」，都不该做：DSH Web 只监听 `127.0.0.1:3080`，本就不该对公网暴露；挂件的 21 个 `/dsh-whale/` 路由虽已接入信任栅栏（裸 curl 返回 401、伪造 Host 头返回 403），但把界面本身开到公网，等于把整个 DSH 会话暴露出去。正确做法是入方向最小化：
1. 只放行 22 端口，来源写你的固定公网 IP（形如 `1.2.3.4/32`），不要写 `0.0.0.0/0`；

1. 3080 不加任何入方向规则；

1. 看界面走 SSH 隧道：`ssh -i ~/.ssh/txyun.pem -L 3080:127.0.0.1:3080 ubuntu@<CVM公网IP>`，再在本地浏览器打开 `http://127.0.0.1:3080`。

## 三、出网访问 api.deepseek.com

余额来自 `GET https://api.deepseek.com/user/balance`，所以 CVM 必须能出网访问它。绑了弹性公网 IP 或走 NAT 网关时出方向默认放通，通常无需额外配置；若走 NAT 出网，别在出方向规则里把 443 卡死，并确认 DNS 正常，`curl -I https://api.deepseek.com` 能通即可。
## 四、安装 Node 22 与 pnpm

Web UI 需 Node.js ≥ 22.19，pnpm 可用是装插件的前置条件：
```

```## 五、安装挂件与配置

```

```装完**重启 dsh web，再 F5**；只改前端 `assets/whale-widget.js` 时宿主按 mtime 热读取，Ctrl+F5 即可。配置只需一个凭据 `DEEPSEEK_API_KEY`（DSH 凭据服务里配置），**不需要** `DEEPSEEK_PLATFORM_TOKEN`，配置文件只存凭据名、密钥不落配置文件。
## 六、四个高频坑

#### 坑一：安装到一半卡死，最后报超时

现象：`add` 跑到一半长时间没反应，最后报 `ETIMEDOUT`。
原因：1Mbps 小带宽拉依赖树吞吐不够、撞上默认超时；1G 内存实例在构建阶段的内存峰值还会触发 OOM。
解决方案：让下载与构建错开——换时段重跑或预热缓存；换国内镜像并调大超时（`npm config set registry https://registry.npmmirror.com`、`npm config set fetch-timeout 600000`）；或临时升配到 2 核 4G，装完再降回。
#### 坑二：npm 名与 `github:` 混用冲突

现象：先用 `github:` 装过，又用 npm 名装一遍，`dump-config` 里出现两份，行为异常。
原因：同一个包名，两种来源的安装产物会并存冲突。
解决方案：换装法前先 `dsh plugin --profile web remove dsh-whale-widget` 卸干净再 add，二选一别混用。
#### 坑三：挂件不出现

现象：安装命令成功，但浏览器里看不到鲸鱼。
原因：宿主侧没有重启，或浏览器拿到的还是旧 `whale-widget.js`。
解决方案：确认 `dump-config` 里有 `dsh-whale-widget`，重启 dsh web 后再 F5，仍不出现就 Ctrl+F5。
#### 坑四：余额报未配置密钥，或今日已用显示 `--`

现象：余额位置提示未配置 DEEPSEEK_API_KEY；或余额正常但今日已用是 `--`。
原因：前者是凭据没配；后者是还没有一次成功的余额观测，统计从观测成功那刻开始。
解决方案：先去 DSH 凭据里配置 `DEEPSEEK_API_KEY`，再点鲸鱼手动刷新一次，等首次观测成功。另外注意裸 curl 返回 401/403 是**预期行为**，不代表接口坏了。
## 七、小结

难点不是安装命令，而是三件事：安全组只放行你的来源 IP、3080 走 SSH 隧道而非对公网开端口、小带宽机器上让 npm 下载与构建错开。更多插件见 https://dpharness.com/top?utm_source=txyun&utm_medium=article  。

余额鲸鱼挂件（包名 dsh-whale-widget，作者 MeteorNOX，GitHub 2,689 Star）是 DSH Web 的标准 bundle 插件：每 60 秒拉一次 DeepSeek 余额、用「余额观测」推算今日已用（不需要令牌）、每轮对话结束弹消耗泡泡。能统一看住多个 API key 的消耗，但 DSH Web 默认只监听 127.0.0.1:3080，想做常在线统计就得放在一台常开的机器上——腾讯云 CVM 正合适。插件清单可先在 https://dpharness.com/top?utm_source=txyun&utm_medium=article  核对。

腾讯云 CVM 部署 DSH Web 与余额鲸鱼挂件：技术教程

余额鲸鱼挂件（包名 dsh-whale-widget，作者 MeteorNOX，GitHub 2,689 Star）是 DSH Web 的标准 bundle 插件：每 60 秒拉一次 DeepSeek 余额、用「余额观测」推算今日已用（不需要令牌）、每轮对话结束弹消耗泡泡。能统一看住多个 API key 的消耗，但 DSH Web 默认只监听 127.0.0.1:3080，想做常在线统计就得放在一

运维

开发工具

后端

在腾讯云CVM上安装DSHWeb的余额鲸鱼挂件（dsh-whale-widget），实现多API key消耗统一监控。教程覆盖2核2G选型、安全组仅放行来源IP、SSH隧道访问3080端口、Node22安装及npm国内镜像加速，并解决OOM、依赖冲突等常见坑。更多插件清单见dpharness.com。

代码解释

DeepSeek

Windows

路由

pnpm

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


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

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

腾讯云 CVM 部署 DSH Web 与余额鲸鱼挂件：技术教程-腾讯云开发者社区-腾讯云

腾讯云 CVM 部署 DSH Web 与余额鲸鱼挂件：技术教程

腾讯云 CVM 部署 DSH Web 与余额鲸鱼挂件：技术教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐