服务器

介绍

服务器区域负责管理 Agent，是哪吒探针最基础的功能模块，同时也是其他功能的核心基础。

安装命令

请参考前文安装 Agent。
推荐使用一键安装方式：

配置好必要的参数。
在 Dashboard 的服务器页面中点击安装命令图标。
复制生成的安装命令并在对应服务器上运行完成安装。

强制更新

Agent 的更新行为由以下两个参数控制：

disable-auto-update：关闭自动更新。
disable-force-update：禁用强制更新。

默认行为

在默认情况下，Agent 会自动更新，无需手动干预。

手动强制更新

如果用户关闭了自动更新功能，可以通过选择指定服务器并执行强制更新操作来更新 Agent。
注意：当 disable-force-update 参数启用时，强制更新功能将失效。

数据列说明

Dashboard 中服务器页面的数据列字段说明：

版本：显示当前 Agent 的版本号。
启用动态域名解析：为 True 时，Dashboard 会在服务器 IP 变更时自动更新 DNS 记录。
对游客隐藏：为 True 时，此服务器在面板中对游客不可见。
备注：
- 私有备注：仅通过身份验证的用户可见。
- 公开备注：所有用户均可见，适合展示通用信息。
- 用户可根据需要自定义备注内容，具体参考公开备注设置。
命令行：提供 WebShell 和文件列表功能。用户可直接通过 Dashboard 远程运行命令、管理文件，并支持文件上传和下载。

编辑配置

可以点击操作列的齿轮图标编辑对应服务器的 Agent 配置。

如果使用批量编辑，对应 Agent 配置将不会被获取，需要自己手动填写配置项。

成功向服务器发送任务后，Agent 会在 10 秒后应用配置并重载服务。

批量转移服务器

管理员可以在服务器页面批量选择服务器，并将这些服务器转移给其他用户。

适用场景：

多用户面板中，将已有服务器分配给新的维护者。
迁移账号或整理资源归属。
将自动注册到管理员名下的服务器转交给普通用户维护。

转移后，目标用户将成为这些服务器的所有者；普通用户只能看到和管理自己名下的资源。执行批量转移前，建议先确认目标用户已创建并可以正常登录。

用户前端展示

用户前端首页会按服务器组展示服务器。服务器组来自 Dashboard 的服务器分组配置，用户在首页选择的分组会保存在浏览器会话中。

首页顶部会显示服务器总数、在线数量、离线数量、总流量和实时上下行速率。点击总数、在线或离线卡片可以快速筛选对应状态。

服务器列表支持以下排序方式：

默认顺序
名称
运行时间
系统类型
CPU
内存
磁盘
上传速率
下载速率
总上传流量
总下载流量

除名称排序外，排序时会优先显示在线服务器。排序方向可以选择升序或降序。

首页还提供地图、服务监控面板和横向列表布局切换。用户的选择会保存在浏览器本地存储中；也可以通过自定义代码中的 window.ForceShowMap、window.ForceShowServices、window.ForceCardInline 强制默认展示。

点击服务器卡片可以进入 /server/{id} 详情页。详情页包含：

详情：展示 CPU、内存、磁盘、进程数、TCP/UDP 连接数、上下行速率等指标，并提供实时、1 天、7 天、30 天图表。
网络：展示该服务器参与的服务监控延迟图表，支持 1 天、7 天、30 天周期和多监控项选择。

历史图表依赖 TSDB。未启用 TSDB 时，非实时历史周期会在前端锁定。未登录用户只能查看实时和 1 天数据，7 天和 30 天数据需要登录后查看。

在线终端

在线终端（WebShell）允许用户通过 Dashboard 远程访问服务器的命令行界面，支持 Linux 和 Windows 系统。

快捷操作：可使用 Ctrl+Shift+V 粘贴命令。
限制说明：当 disable-command-execute 参数启用时，在线终端功能将不可用。
连接问题：若连接失败，请参考 Websocket 连接失败文档解决。
并发限制：同一用户最多同时占用 20 条在线终端与文件管理 IOStream；同一目标服务器最多同时承载 40 条 IOStream（包括在线终端、文件管理、内网穿透和 MCP 文件传输）。达到上限时请关闭不用的会话后重试。

文件列表

INFO

此功能仅支持 *nix 系统

文件列表提供了一个类似文件管理器的界面，可以供用户浏览文件，并在当前目录进行上传下载操作。支持目录跳转、刷新和复制当前路径操作，与在线终端搭配使用更为方便。

在线终端与文件管理共用用户并发配额；同一用户最多同时占用 20 条相关 IOStream。目标服务器还受 40 条总 IOStream 上限约束，该上限同时计入内网穿透和 MCP 文件传输。

DDNS

在勾选 DDNS 复选框后, 你可以填写以下两个字段：

DDNS 配置文件 ID

请参考 DDNS 文档先添加一个基础配置，添加完成后你可以在面板中看到对应的 DDNS 配置 ID。

强制指定 DDNS 域名

你可以使用本功能复用 DDNS 配置文件而无需将 Token 复制多遍。

这应该是一个简单的 JSON 对象，你应该提供一组键值对，键为使用双引号进行包裹的 DDNS 配置 ID，此处指定的 ID 必须在 DDNS 配置文件 ID 字段中指定过, 而值应当为一个域名数组，你可以提供多个域名，在这里的设置将会覆盖你在 DDNS 配置 中设置的默认域名。

json

{
  "1": ["sub.example.domain"]
}

公开备注设置

哪吒监控支持在 Dashboard 为服务器设置公开备注。默认用户前端会尝试将公开备注解析为 JSON，并展示账单、套餐和线路等补充信息。

billingDataMod 和 planDataMod 可以同时填写，也可以只填写其中一个。公开备注内容对游客可见，不要放入密码、Token、真实客户资料等敏感信息。

示例配置（默认主题）

以下是公开备注的 JSON 配置示例：

json

{
  "billingDataMod": {
    "startDate": "2024-12-08T12:58:17.636Z",
    "endDate": "2024-12-08T12:58:17.636Z",
    "autoRenewal": "1",
    "cycle": "Year",
    "amount": "200EUR"
  },
  "planDataMod": {
    "bandwidth": "30Mbps",
    "trafficVol": "1TB/Month",
    "trafficType": "2",
    "IPv4": "1",
    "IPv6": "1",
    "networkRoute": "4837",
    "extra": "Einstein"
  }
}

配置字段说明

账单信息 billingDataMod：
- startDate：账单起始日期（ISO 时间格式）。
- endDate：账单结束日期（ISO 时间格式）。以 0000-00-00 开头时，前端会按长期或永久服务展示。
- autoRenewal：自动续费状态，1 表示启用，前端会结合周期计算剩余时间。
- cycle：账单周期（如 Month、Year、月、年）。
- amount：账单金额及货币单位。值为 0 时显示免费，值为 -1 时显示按量计费，其他值会按原文展示。
流量和网络配置 planDataMod：
- bandwidth：服务器带宽信息。
- trafficVol：流量配额及周期。
- trafficType：流量类型字段，当前默认用户前端会解析但不会直接展示，可作为自定义主题或二次开发的预留字段。
- IPv4 / IPv6：值为 1 时，前端会展示对应的 IPv4 / IPv6 标签。
- networkRoute：网络路由信息，例如 AS4837。多个值可以用英文逗号分隔，前端会分开展示。
- extra：额外备注字段。多个值可以用英文逗号分隔，前端会分开展示。

当前用户前端会把服务器的上一次非空公开备注缓存在浏览器 sessionStorage 中。修改或清空公开备注后，如果当前浏览器会话中仍看到旧内容，可以刷新页面、关闭并重新打开标签页，或清理该站点的会话存储后再检查。

TIP

服务器 ​

介绍 ​

安装命令 ​

强制更新 ​

默认行为 ​

手动强制更新 ​

数据列说明 ​

编辑配置 ​

批量转移服务器 ​

用户前端展示 ​

在线终端 ​

文件列表 ​

DDNS ​

DDNS 配置文件 ID ​

强制指定 DDNS 域名 ​

公开备注设置 ​

示例配置（默认主题） ​

配置字段说明 ​

服务器

介绍