# CF-Server-Monitor 基于 Cloudflare Workers、D1 和 Durable Objects 的轻量级多服务器监控面板。

简体中文 | English

[![Workers](https://img.shields.io/badge/Workers-2.8.6%20Beta8-f38020?style=flat-square&logo=cloudflare&logoColor=white)](version.json) [![GitHub Stars](https://img.shields.io/github/stars/huilang-me/CF-Server-Monitor?style=flat-square&logo=github)](https://github.com/huilang-me/CF-Server-Monitor/stargazers) [![GitHub Forks](https://img.shields.io/github/forks/huilang-me/CF-Server-Monitor?style=flat-square&logo=github)](https://github.com/huilang-me/CF-Server-Monitor/forks) [![License](https://img.shields.io/badge/License-MIT-16a34a?style=flat-square)](#许可证) [在线演示](https://demo.huilang.me/) · [API 文档](API.md) · [Go 探针文档](https://github.com/huilang-me/cfsm-agent) · [主题开发](theme-develop.md)
## 项目简介 CF-Server-Monitor 是一个部署在 Cloudflare Workers 上的服务器监控系统。服务器端安装 Agent 后会单向上报指标到 Worker，数据写入 D1，并通过 Durable Objects + WebSocket 推送到前端，实现免费托管、低维护的实时监控。 支持主流 Linux 发行版、Alpine Linux、OpenWrt、macOS、群晖 DSM、飞牛 fnOS、Windows 等系统，并提供 Docker 镜像部署方式。 高安全性：Agent 仅单向上报指标，不提供 WebSSH、远程命令下发或主控通道；支持非 root 运行，可降低监控组件被利用后的影响范围。 ## 目录 - [对比优势](#对比优势) - [特性](#特性) - [系统架构](#系统架构) - [版本说明](#版本说明) - [快速部署](#快速部署) - [首次使用](#首次使用) - [Agent 参数与安全建议](#agent-参数与安全建议) - [配置说明](#配置说明) - [通知与告警](#通知与告警) - [安全建议](#安全建议) - [主题与外观](#主题与外观) - [升级与维护](#升级与维护) - [本地开发](#本地开发) - [项目结构](#项目结构) - [常见问题](#常见问题) - [界面预览](#界面预览) - [支持项目](#支持项目) ## 对比优势 相比传统主控式探针，CF-Server-Monitor 更适合低成本、低维护和安全优先的监控场景： - 免费托管：面板、API、数据库和实时推送都运行在 Cloudflare 上，按免费额度友好设计；默认 60 秒上报间隔可支持约 60 台服务器，改为 120 秒后理论上可翻倍。 - 单向上报更安全：没有 WebSSH、没有远程命令下发、没有主控通道；Agent 只向 Worker 上报指标。 - 功能覆盖完整：实时指标、历史图表、地图展示、离线通知、资源告警、到期提醒、主题商店、多语言和移动端适配都已内置。 - 参数动态下发：后台可修改 Ping 节点、采集间隔、HTTP 上报间隔、WSS 上报间隔、统计网卡、流量重置日、上下行流量校正等参数，Agent 后续自动拉取并生效；Worker 地址、`API_SECRET` 和自动更新开关变更需要重新执行安装命令。 - 支持非 root 安装：支持 `systemd --user` 的 Linux 可使用普通用户安装，探针文件写入 `~/.cf-probe/`。 - 上报时间自动校准：Go Agent 会使用 Worker 响应中的 HTTP `Date` 头校正样本时间和 `boot_time`，降低服务器本地时间错误对历史图表的影响；不会修改系统时间。 ## 特性 | 模块 | 能力 | | --------- | -------------------------------------------------------------------------------- | | 实时监控 | CPU、GPU、内存、交换分区、磁盘、磁盘 IO、网络、连接数、进程数、负载、运行时间 | | 历史数据 | 7 天历史图表、长时段采样、实时网速、月流量统计与校正 | | 网络质量 | 电信、联通、移动、BGP 节点延迟与丢包率追踪；三网详情开启时首页从 D1 最近 2 小时抽样最多 20 个真实点并缓存 5 分钟 | | 多视图前台 | 条形图、环形图、表格、地图视图，支持桌面端和移动端 | | 管理后台 | 服务器增删改查、拖拽排序、隐藏服务器、导入导出、批量删除、数据库维护 | | 多系统 Agent | 主流 Linux、Alpine Linux、OpenWrt、群晖 DSM、飞牛 fnOS、FreeBSD、macOS、Windows，支持 Docker 镜像部署；默认 Go 版本，保留 Shell/PowerShell 版本 | | 实时推送 | Durable Objects + WebSocket，Agent 上报后前端即时刷新 | | 告警通知 | 离线告警、恢复通知、到期提醒、资源负载告警 | | 多语言 | 前端内置中文和英文切换；文档提供中文与英文入口 | | 多站点 | 支持 GitHub Pages 静态前台和多个 Worker API 聚合展示 | | 小组件 | 提供 iOS Scriptable 小组件脚本，适合移动端快速查看 | | 安全控制 | API Secret、管理员密码、JWT、Turnstile、CORS、CSP 白名单 | | 主题生态 | 内置主题、Mikus 模式、主题商店、第三方主题反代与预览 | | 额度友好 | 按月表轮换、历史查询采样、缓存与限流设计，适配 Cloudflare 免费额度 | ## 系统架构 ```mermaid flowchart LR Agent["Server Agent
Go / Shell / PowerShell"] -->|"POST /update"| Worker["Cloudflare Worker"] Worker --> D1["Cloudflare D1
servers / settings / history"] Worker <--> DO["Durable Object
WebSocket broadcast"] Worker --> Assets["Vue Dashboard
Admin Panel"] Browser["Browser / Mobile / Widget"] <--> Worker ``` 核心数据流： 1. 在管理后台添加服务器，复制安装命令。 2. 目标服务器安装 Agent，按上报间隔向 Worker 发送指标。 3. Worker 校验 `API_SECRET`，写入 D1，并通过 Durable Object 广播实时数据。 4. 前台大盘、详情页、管理后台和 iOS 小组件读取同一套 API。 近期变化： - `2.8.6`：Added GitHub login, WSS frontend subscription with 250ms batch reporting, added SMTP notification channel, added monthly traffic threshold alert, removed legacy database compatibility, added Docker installation method. - `2.8.5`：支持自定义 Ping 节点名称；增加ICMP模式；优化WSS响应逻辑；API接口优化；原皮前端优化；新增4个ping节点。 - `2.8.4`：新增 Agent WSS 上报和 WSS 开启时段，提升实时数据推送及时性，并允许非目标时段自动改用 POST 降低 Do 时长消耗；该能力要求 Agent 升级到 `v1.0.10+`。新增账户Do用量展示，优化无前端订阅时的 Do 实时广播请求，降低空闲额度消耗。通知设置新增自定义 Webhook 渠道, 新增前端wss超时配置。 - `2.8.3`：新增磁盘 IO 统计，默认 Agent 切换为 Go 版本，新增服务器延迟与丢包率实时窗口。 - `2.8.2`：引入 Go Agent 支持。 - `2.8.1`：优化长时间历史查询 D1 读行，增加资源负载通知和主题商店接口优化。 - `2.8.0`：新增主题商店，支持一键切换第三方主题。 - `2.7.x`：重构数据库写入、月表轮换、通知模块、安全策略、服务器计费字段、导入导出和多项后台能力。 Go Agent 的完整更新记录见 [cfsm-agent releases](https://github.com/huilang-me/cfsm-agent/releases)。 ## 快速部署 ### 前置要求 - Cloudflare 账户 - GitHub 账户 - 一个足够复杂的 `API_SECRET`，同时作为 Agent 上报密钥和初始后台密码 建议优先使用「Cloudflare Workers 连接 GitHub 仓库」或「GitHub Actions 自动部署」。一键部署适合快速体验，但后续同步更新不够方便。 ### 方式一：Cloudflare Workers 连接 GitHub 仓库 这是推荐方式，适合希望通过 Cloudflare 控制台自动构建和重新部署的用户。 1. Fork 本仓库到自己的 GitHub 账号。 2. 进入 Cloudflare Dashboard，打开 Workers & Pages。 3. 创建 Worker，并选择从 GitHub 仓库导入本项目。 4. 构建命令填写 `npm run build:frontend`。 5. 部署命令使用 `npx wrangler deploy`。 6. 部署完成后，在 Worker 的 Variables and Secrets 中添加 `API_SECRET`。 图文教程： ### 方式二：GitHub Actions 自动部署 适合希望把部署流程完全托管在 GitHub Actions 的用户。 1. Fork 本仓库。 2. 在 Cloudflare 创建 D1 数据库，名称建议为 `server-monitor-db`。 3. 复制 Cloudflare Account ID。 4. 创建 Cloudflare API Token，至少需要 Workers 编辑和 D1 部署相关权限。 5. 在 Fork 后的 GitHub 仓库中进入 Settings -> Secrets and variables -> Actions。 6. 添加以下 Secrets。 | Secret | 必填 | 说明 | | ---------------------- | -- | ------------------------ | | `CF_API_TOKEN` | 是 | Cloudflare API Token | | `CF_ACCOUNT_ID` | 是 | Cloudflare Account ID | | `D1_DATABASE_ID` | 是 | D1 数据库 ID | | `API_SECRET` | 是 | Agent 上报密钥和初始后台密码 | | `CORS_ALLOWED_ORIGINS` | 否 | 允许跨域访问 API 的来源，多个用英文逗号分隔 | 推送到 `main` 分支会自动部署，也可以在 Actions 页面手动运行 `Deploy to Cloudflare Workers` 工作流。 ### 方式三：一键部署 [![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/huilang-me/CF-Server-Monitor) 部署时请确认： - Build command 使用 `npm run build:frontend` - `API_SECRET` 改为随机强密码，不要继续使用默认值 - 登录后台后尽快修改管理员用户名和密码 一键部署不方便长期同步上游更新，正式使用更建议迁移到方式一或方式二。 ## 首次使用 ### 登录后台 部署成功后访问： ```text https://你的 Worker 域名/admin#/admin ``` 默认凭据： | 项目 | 默认值 | | --- | ------------ | | 用户名 | `admin` | | 密码 | `API_SECRET` | 登录后建议立即修改后台用户名和密码。后台登录密码可以和 `API_SECRET` 分离；服务器 Agent 上报仍使用 Cloudflare 环境变量中的 `API_SECRET`。 ### 添加服务器 1. 进入 `/admin#/admin`。 2. 在服务器管理中填写服务器名称。 3. 点击添加服务器。 4. 点击复制按钮，选择目标系统和 Agent 版本。 5. 在目标服务器上执行复制出的安装命令。 建议优先使用后台生成的命令，因为它会自动带上服务器 ID、Worker URL、Secret、上报间隔、网络质量节点和网卡等参数。 ## Agent 参数与安全建议 V2.8.3 起默认使用独立项目 [cfsm-agent](https://github.com/huilang-me/cfsm-agent)，安装后服务名为 `cf-probe`。新增服务器后建议直接从管理后台复制安装命令，后台会按目标系统、服务器 ID、Worker 地址和当前参数生成完整命令。 完整安装路径、日志查看、状态检查和升级行为见 [https://github.com/huilang-me/cfsm-agent](https://github.com/huilang-me/cfsm-agent)。 ### 常用参数 | 参数 | 说明 | 默认值 | | ----------------------------- | ---------------------------- | ---- | | `-id` | 服务器唯一 ID | 必填 | | `-secret` | Agent 上报密钥，需要等于 `API_SECRET` | 必填 | | `-url` | Worker 上报地址 | 必填 | | `-collect_interval` | 本机采集间隔；`0` 表示不额外采样 | `0` | | `-interval` | 上报间隔，单位秒 | `60` | | `-ct` / `-cu` / `-cm` / `-bd` | 自定义网络质量测试节点，支持 `host[:port]` | 内置节点 | | `-reset_day` | 月流量重置日 | `1` | | `-rx_correction` | 下行月流量校正，单位 GB | 空 | | `-tx_correction` | 上行月流量校正，单位 GB | 空 | `-collect_interval` 控制本机额外采集频率，`-interval` 控制上报频率。上报越频繁，Workers 请求和 D1 写入越多。 ### 非 root 安装（推荐） 支持 `systemd --user` 的 Linux 环境建议使用非 root 安装。后台安装命令可选择“当前用户”或“专用 cfsm 用户”：当前用户会直接执行安装，专用用户则会自动创建并切换到 `cfsm`。文件保存在该用户的 `~/.cf-probe/`。 普通用户安装后，如需退出登录仍保持服务运行，请由 root 执行： ```bash loginctl enable-linger 用户名 ``` 卸载时请选择原来的安装用户。OpenWrt、Alpine/OpenRC、Synology DSM 等不支持 `systemd --user` 的环境，请使用对应系统命令。 ### Docker 部署 后台复制安装命令的目标系统支持选择 Docker，会生成如下容器命令（服务器 ID、Secret、Worker 地址已按当前服务器自动填充，镜像标签默认 `latest`，可在 Agent 版本栏自定义）： ```bash docker run -d --name cf-probe --restart=unless-stopped --network=host \ -v cf-probe-data:/data \ -e SERVER_ID=<服务器ID> -e SECRET='' -e WORKER_URL=https://<你的后台地址>/update \ ghcr.io/huilang-me/cfsm-agent:latest ``` 采集间隔、上报间隔、Ping 节点、网卡、流量重置日、上下行校正等运行参数由 Agent 按 `SERVER_ID` 从后台动态拉取，无需在命令中重复指定；更换镜像标签即回退/升级到指定版本。卸载容器： ```bash docker rm -f cf-probe && docker volume rm cf-probe-data ``` ## 配置说明 ### Worker 环境变量 | 变量 | 必填 | 说明 | | ---------------------- | -- | ------------------------ | | `API_SECRET` | 是 | Agent 上报密钥；也是首次登录后台的默认密码 | | `API_BASE` | 否 | 前端请求的 Worker API 地址，多个用英文逗号分隔；用于多 Worker 聚合或前后端分离 | | `CORS_ALLOWED_ORIGINS` | 否 | 允许跨域访问 API 的来源，多个用英文逗号分隔 | ### GitHub Pages 静态前台 项目支持把前台构建到 GitHub Pages，并通过远程 Worker API 聚合数据。相关工作流为 `.github/workflows/deploy-github-page.yml`。 | Secret | 说明 | | ------------------ | -------------------------- | | `API_BASE` | Worker API 地址，多个用英文逗号分隔 | | `TITLE` | 静态前台标题 | | `BACKGROUND_IMAGE` | 背景图地址 | | `CSP_STATIC` | 额外静态资源 CSP 白名单 | | `CSP_API` | 额外 API / WebSocket CSP 白名单 | 构建命令： ```bash npm run build:github-page ``` ### 后台可配置项 | 分类 | 主要内容 | | ------------- | ------------------------------------- | | 站点设置 | 标题、背景、favicon、默认展示模式、默认外观、默认语言、三网详情、公开访问策略 | | 服务器参数 | HTTP/WSS 上报间隔、采集间隔、Ping 节点、网卡、月流量、价格、到期时间、自动续费 | | 安全设置 | 管理员账号密码、JWT Secret、Turnstile | | 通知设置 | 离线告警、到期提醒、资源负载告警、测试通知 | | 外观设置 | 自定义 CSS、``、CSP 白名单、Mikus 模式 | | 数据库管理 | 升级数据库、清空历史数据 | | Cloudflare 用量 | 查询 D1 行读写和 Workers 请求量 | ### iOS Scriptable 小组件 项目提供 [scripts/ios-scriptable-widget.js](scripts/ios-scriptable-widget.js)，可在 iPhone 桌面显示单台服务器状态。 使用方式： 1. 在 iPhone 安装 Scriptable。 2. 新建脚本，并放入 `scripts/ios-scriptable-widget.js` 内容。 3. 修改脚本顶部的 `CONFIG.baseURL` 为你的站点地址。 4. 添加 Scriptable 小组件并选择该脚本。 5. 在小组件 Parameter 中填写服务器 ID，也可以写成 `id:SERVER_ID`。 小组件会显示在线状态、CPU、内存、磁盘、月流量、实时上下行速率和更新时间。iOS 会按系统策略决定实际刷新频率。 ## 通知与告警 在管理后台 -> 全局设置 -> 通知 中配置。通知分为“内置渠道”、“SMTP 邮件”和“自定义 Webhook”三种渠道；选择自定义 Webhook 后，后端只会发送 Webhook，不会再调用内置渠道。 ### 内置渠道 内置渠道通过 Bot Token 内容自动识别平台。 | 平台 | Bot Token 填写方式 | Chat ID | | ----------- | ---------------------------------------------------------------- | ----------- | | Telegram | BotFather 创建的 Bot Token | 用户、群组或频道 ID | | 企业微信 | 群机器人 Webhook URL | 留空 | | 飞书 | 群机器人 Webhook URL | 留空 | | 钉钉 | 自定义机器人 Webhook URL | 留空 | | OneBot / QQ | `onebot:http://host/send_private_msg?...` 或 `send_group_msg` | 用户 ID 或群 ID | | Bark | `https://api.day.app/xxxx/` 或 `bark:https://example.com/xxxx/` | 留空 | | Server 酱 | `https://sctapi.ftqq.com/.send` 或 `server:https://example.com/.send` | 留空 | | WxPusher | `https://wxpusher.zjiecode.com/api/send/message/[SPT_xxx]/Hello` | 留空 | | Gotify | `https://gotify.example.com/message?token=xxx` | 留空 | ### SMTP 邮件 选择“SMTP 邮件”渠道后，在设置面板填写 SMTP 服务器、端口、加密方式、用户名、密码、发件人和收件人即可，无需手动拼接配置。后端会将其序列化为 `smtp://` 前缀协议存入 `tg_bot_token` 字段，并通过 [`cloudflare-smtp`](https://github.com/Bruol/cloudflare-smtp)（基于 `cloudflare:sockets`）直连邮件服务器发送纯文本邮件。 配置格式（前端自动生成，手动填写内置渠道 Bot Token 时亦可使用）： ```text smtp://<用户名>:<密码>@:?from=<发件人>&to=<收件人1,收件人2>&secure= ``` 注意事项： - **Cloudflare Workers 永久封禁 25 端口出站**，只能使用 `465`（隐式 TLS）或 `587`（STARTTLS）；`secure` 缺省时按端口自动选择。 - 用户名、密码中的特殊字符需 URL 编码（例如 `@` 写作 `%40`），前端表单会自动处理。 - QQ 邮箱、163 邮箱等需使用 **SMTP 授权码**而非登录密码；发件人留空时默认等于用户名。 - 当前仅发送纯文本邮件（不支持 HTML、附件、抄送），发送失败会按 `NOTIFICATION_MAX_RETRIES` 自动重试。 - 能否成功送达还取决于邮件服务商对 Cloudflare 出口 IP 及 SPF / DKIM 的校验策略。 ### 自定义 Webhook 自定义 Webhook 支持 `GET` 和 `POST`： - `POST`：可选择 `JSON`、`x-www-form-urlencoded` 或 `Text`。默认 JSON 请求体为 `title` 和 `content` 两个参数。 - `GET`：使用同一个参数配置追加到 URL query；参数可写 JSON 对象，也可写 `title={{emoji}} {{event}}&content={{notification}}` 这种 QueryString。 - 请求头支持 JSON 对象或 `Header: value` 多行文本。 - 发送测试通知会按当前通知模板渲染后发送，适合保存前验证平台格式。 默认 Webhook 参数： ```json { "title": "{{emoji}} {{event}}", "content": "{{notification}}" } ``` 默认通知模板： ```text {{emoji}}【CF Server Monitor】{{event}} {{message}} {{time}} ``` 可用模板变量： | 变量 | 说明 | | --- | --- | | `{{emoji}}` | 事件图标：恢复/测试为 `✅`，离线/告警为 `❌`，到期/混合状态为 `⚠️` | | `{{event}}` | 事件名称，例如“节点离线告警”“资源负载恢复” | | `{{client}}` / `{{clients}}` | 本次通知涉及的服务器名称，多个服务器用逗号连接 | | `{{count}}` | 本次通知涉及的服务器数量；默认模板不显示，但可自定义加入 | | `{{message}}` | 通知详情列表 | | `{{time}}` | 按通知时区格式化的发送时间 | | `{{notification}}` | 应用通知模板后的完整内容，通常用于 Webhook 的 `content` | | `{{title}}` | 固定标题 `💌 Cloudflare Server Monitor` | 支持的告警类型： - 离线告警：节点离线达到设定阈值后通知，恢复后发送恢复通知。 - 到期提醒：服务器到期前 1 到 7 天内，按通知时区和到期通知时间每天提醒，也可关闭。 - 资源负载告警：按 CPU、内存、磁盘、上下行速率等指标配置规则。 配置后请先点击发送测试通知，再保存配置。 ## 安全建议 ### API Secret - 使用随机强密码，不要包含容易被 Shell 或 URL 转义影响的特殊字符。 - 修改 `API_SECRET` 后，需要重新部署 Worker，并在所有服务器上重新安装或更新 Agent 命令。 - 后台登录密码可以独立修改，建议不要长期和 `API_SECRET` 保持一致。 ### JWT 与 WebSocket 认证 - 管理员登录成功后会签发 7 天有效期的 JWT；前端会用于后续管理请求，并设置 `cfsm_auth` HttpOnly Cookie。 - 私有站点（`is_public !== 'true'`）会对 `/api/servers`、`/api/server`、`/api/history/all` 和 `/api/ws` 做登录校验；未授权的 WebSocket 不会转发到 Durable Object。 - `/api/ws` 支持三种 JWT 认证来源：`Authorization: Bearer `、`Cookie: cfsm_auth=`、查询参数 `token` / `auth_token` / `ws_token`。 - 浏览器原生 WebSocket 不能自定义 `Authorization` Header，内置前端同域连接走 `cfsm_auth` Cookie，跨域连接才在 URL 中追加 `token=` 查询参数。 - 查询参数 token 可能出现在访问日志中，请只通过 HTTPS 使用，并避免把带 token 的 WebSocket URL 分享给他人。 - 后台可配置“前端 WSS 超时（分钟）”：默认 `0`，表示不因连接时长主动断开；设为正整数后，内置前端到时会断开实时订阅并弹窗让用户选择关闭或继续。 ### Turnstile 可在后台启用 Cloudflare Turnstile，用于降低公开 API 和登录入口被刷的风险。多站点模式下，如果多个站点都启用 Turnstile，请保持 Site Key 一致。 ### GitHub 登录 1. 在 GitHub `Settings → Developer settings → OAuth Apps` 中创建 [OAuth App](https://github.com/settings/developers)。 2. 在 CFSM 后台的“管理员登录设置”中填写 Client ID 和 Client Secret，保存配置。 3. 将后台显示的 `Authorization callback URL` 原样填入 GitHub OAuth App。 4. 保持管理员密码登录状态，点击“绑定 GitHub 账号”并完成授权。系统会自动保存该账号不可变的 GitHub 数字 ID，此后仅该账号能够使用 GitHub 登录。 GitHub OAuth 配置和绑定结果与其他站点配置一样保存在 D1 的 `site_options` 中，不需要升级数据库结构。Client Secret 不会通过后台设置读取接口返回；再次保存时留空即可保留原值。重新绑定必须处于管理员登录状态，建议保留账号密码登录作为应急入口。 ### CORS 默认建议仅同源访问。如果需要独立前台或多站点聚合，在 `CORS_ALLOWED_ORIGINS` 中加入可信来源。 ### CSP 项目默认启用较保守的 Content Security Policy。第三方背景图、外部 CSS/JS、字体、图片和 WebSocket/API 域名需要加入后台 CSP 白名单后才会加载。 内置允许的常见来源包括 Cloudflare Turnstile、Cloudflare Analytics、Google Fonts、GitHub Raw 和若干公开 API。添加第三方脚本前请先确认来源可信。 ## 主题与外观 项目内置默认主题，并支持： - 深色 / 浅色显示 - 前台中文 / 英文切换 - 自定义背景图、favicon、CSS、`` - Mikus 模式 - 主题商店 - 第三方主题 GitHub tree 地址 - 管理员预览主题 第三方主题只反代主题仓库中的 `index.html` 与 `assets/`，管理后台仍使用内置主题。开发自定义主题请参考 [theme-develop.md](theme-develop.md)。 ## 升级与维护 ### 升级 Worker 如果通过 Fork 部署，同步上游仓库即可触发重新部署： - 手动同步：GitHub 仓库页面点击 Sync fork -> Update branch。 - 自动同步：启用 `Upstream Sync` 工作流，默认每天 UTC 00:00 检查上游更新。 一键部署方式建议重新部署到同一个项目，或迁移到 Fork + GitHub / Cloudflare 自动部署模式。 ### 升级 Agent Go 版本 Agent 会保留原配置，直接执行安装命令即可升级。 Linux / OpenWrt / Synology DSM / FreeBSD / macOS： ```bash curl -fsSL https://raw.githubusercontent.com/huilang-me/cfsm-agent/main/install.sh | sh -s -- install ``` Windows 管理员 PowerShell： ```powershell $script = "$env:TEMP\install-cf-probe.ps1" Invoke-WebRequest -Uri "https://raw.githubusercontent.com/huilang-me/cfsm-agent/main/install.ps1" -OutFile $script -UseBasicParsing PowerShell -ExecutionPolicy Bypass -File $script install ``` ### 卸载 Agent Go 版本： ```bash curl -fsSL https://raw.githubusercontent.com/huilang-me/cfsm-agent/main/install.sh | sh -s -- uninstall ``` 旧 Shell / PowerShell 版本已不再维护，下面命令仅用于清理历史 Shell / PowerShell 安装。请按当初安装时使用的系统脚本选择对应卸载命令；如果当前运行的是 Go Agent，请使用上面的 Go 卸载命令。 | 旧版系统脚本 | 卸载命令 | | --- | --- | | Linux / systemd | `curl -sL https://你的 Worker 域名/install.sh \| bash -s uninstall` | | Alpine / OpenRC | `curl -sL https://你的 Worker 域名/install-alpine.sh \| sh -s uninstall` | | OpenWrt / procd | `curl -sL https://你的 Worker 域名/install-openwrt.sh \| sh -s uninstall` | | macOS | `curl -sL https://你的 Worker 域名/install-mac.sh \| sudo bash -s uninstall` | | Synology DSM | `curl -sL https://你的 Worker 域名/install-synology.sh \| bash -s uninstall` | Windows 旧 PowerShell 版本： ```powershell irm https://你的 Worker 域名/cf-server-monitor.ps1 -OutFile cf-server-monitor.ps1 powershell -ExecutionPolicy Bypass -File .\cf-server-monitor.ps1 uninstall ``` Go 版本和旧 Shell / PowerShell 版本卸载脚本只清理各自安装的服务和文件。如果曾经从 Shell / PowerShell 切换到 Go，或反向切换过，请分别执行对应版本的卸载命令，避免残留旧服务、定时任务或配置文件。 ### 数据库维护 后台 -> Database Management 提供： - 升级数据库：补齐新版本字段和索引，不删除现有数据。 - 清空历史数据：删除历史监控记录，保留服务器列表和站点设置。 从旧版本升级到包含 GPU、磁盘 IO、丢包率或新历史结构的版本后，如果页面提示数据库字段缺失，请先执行升级数据库，再升级 Agent。 ### 定时任务 `wrangler.toml` 中包含两个 Cron： | Cron | 说明 | | ------------- | -------------------------- | | `*/1 * * * *` | 每分钟检测离线节点、资源告警 | | `0 * * * *` | 每小时执行合并任务，包括月表轮换、旧表清理，并按通知时区/到期通知小时执行到期检测 | ## 本地开发 ### 环境要求 - Node.js 18+ - npm - Wrangler 4 ### 常用命令 ```bash # 安装依赖 npm install # 首次创建 D1 数据库 npx wrangler d1 create server-monitor-db # 启动本地 Worker，默认 https://localhost:8787 npm run dev # 单独启动前端 Vite，默认 http://localhost:5173 npm run dev:frontend # 构建前端 npm run build:frontend # 部署到 Cloudflare Workers npm run deploy # 测试历史查询 npm run test:history-query # 测试 Agent 配置下发 npm run test:agent-config ``` 本地 `.env` 至少需要： ```bash API_SECRET=123456 ``` ### 测试数据 ```bash node test/generate-sql.js wrangler d1 execute server-monitor-db --file=test/mock-data.sql ``` 更多本地测试说明见 [test/README.md](test/README.md)。 ### 定时任务 ``` https://localhost:8787/cdn-cgi/handler/scheduled?cron=*/1+*+*+*+* // 每分钟执行一次（离线检测） https://localhost:8787/cdn-cgi/handler/scheduled?cron=0+*+*+*+* // 每小时执行一次（合并任务） https://localhost:8787/cdn-cgi/handler/scheduled?cron=0+0+*+*+0 // 每周执行一次（测试使用） https://localhost:8787/cdn-cgi/handler/scheduled?cron=0+12+*+*+* // 每天12点执行一次（测试使用） ``` ### API 检查 ```bash node test/api-check.js node test/api-check.js --base-url=http://localhost:8787 --api-secret=123456 node test/api-check.js --help ``` 完整接口说明见 [API.md](API.md)。 ## 项目结构 ```text CF-Server-Monitor/ ├── public/ # 安装脚本、系统图标、旗帜、静态资源 ├── scripts/ # 构建脚本、GitHub Pages 构建、iOS 小组件 ├── src/ │ ├── database/ # D1 表结构、索引、迁移 │ ├── durable/ # Durable Object 实时广播 │ ├── frontend/ # Vue 3 前台与管理后台 │ ├── handlers/ # Worker 路由处理 │ ├── middleware/ # 鉴权中间件 │ ├── services/ # 通知服务 │ └── utils/ # 缓存、CORS、CSP、指标处理、版本检查 ├── test/ # 本地测试和模拟数据工具 ├── API.md # REST / WebSocket API 文档 ├── theme-develop.md # 第三方主题开发文档 ├── wrangler.toml # 本地 Wrangler 配置 └── version.json # Worker / Agent 版本 ``` ## 常见问题 ### 部署后返回 `API_SECRET is required` 说明 Worker 没有读取到环境变量。请在 Cloudflare Workers & Pages 的 Variables and Secrets 中删除旧值后重新添加 `API_SECRET`，保存并等待重新部署完成。 目前Cloudflare版本原因，可能需要先改动值保存一次，再改回去触发重新部署。 ### Agent 没有上报数据 先确认服务器可以访问 Worker URL。如需开启调试，可在安装参数后追加 `-debug=1`。不同系统的日志查看命令不固定，请参考 [cfsm-agent 文档](https://github.com/huilang-me/cfsm-agent) 中对应系统的状态与日志说明。 排查完成后移除 debug 参数并重新安装，避免日志持续增大。 ### 如何更换 `API_SECRET` 在 Cloudflare 中修改 `API_SECRET`，重新部署 Worker，然后在所有服务器上重新复制并执行安装命令。使用 GitHub Actions 部署时，也要同步更新 GitHub Secret。 ### D1 免费额度够用吗 默认 60 秒上报间隔按约 60 台服务器设计；改为 120 秒后可以进一步降低写入。读取主要来自前端访问和历史查询，项目已通过缓存、采样和登录限制降低消耗。实际额度以 Cloudflare 控制台显示为准。 ### 背景图没有显示 通常是 CSP 拦截了第三方图片资源。进入管理后台 -> 外观设置 -> CSP 静态文件域名白名单，添加背景图所在域名的 origin，例如背景图地址是 `https://cdn.example.com/path/bg.webp`，只填写 `https://cdn.example.com`。 如果背景图地址会跳转或经过 CDN 重定向，需要打开浏览器开发者工具查看最终加载的图片地址，并把最终地址对应的域名加入白名单。修改后保存配置并刷新页面。 ### 忘记后台密码 进入 Cloudflare D1 数据库 `server-monitor-db`，打开 `setting` 表，编辑 `site_options` 的 `password` 字段。旧版 MD5 兼容值 `e10adc3949ba59abbe56e057f20f883e` 对应密码 `123456`，保存后可用该密码登录，再到后台重新设置强密码。 ### 国内服务器无法上报 建议绑定自定义域名到 Worker。无法绑定时，可临时通过 hosts 指向可用的 Cloudflare CDN IP： ```bash echo <你的探针域名> | sudo tee -a /etc/hosts ``` ### Ping 结果异常或全是 1 检查服务器是否启用了代理。OpenWrt / 软路由环境中，部分代理插件可能影响延迟测试，可关闭代理或更换透明代理方案后再测试。 ### 地图中的地区显示说明 前端会并列展示港澳台和国家/地区信息。地图基于中华人民共和国自然资源部标准地图制作，审图号：GS(2023)2767 号。 ## 界面预览
深色风格 ![Dashboard dark](https://github.com/user-attachments/assets/4e6a5db4-65d3-4d40-91b9-9e46ee140d0d) ![Dashboard dark detail](https://github.com/user-attachments/assets/c10a1376-3d4c-4a58-8d3b-dc904b30f174) ![Server detail dark](https://github.com/user-attachments/assets/a9c1aefd-42f7-4805-aa42-bbe9e58aed59) ![Admin dark](https://github.com/user-attachments/assets/527bcf04-3124-4f1c-b052-451bccae961d) ![Map dark](https://github.com/user-attachments/assets/ac6f6fbb-b9fb-45cd-93e5-ca08bbad9ecb) ![Theme dark](https://github.com/user-attachments/assets/b5436816-54bd-4512-a65c-bf963fd4874c) ![Table dark](https://github.com/user-attachments/assets/ba0d3605-ef64-4be1-884b-9506f20277a8) ![Mobile dark](https://github.com/user-attachments/assets/197767cc-028b-4ec1-b41f-5cadc2b25629)
浅色风格 ![Dashboard light](https://github.com/user-attachments/assets/8d310095-2b93-40f3-b762-323fbe6595f6) ![Server detail light](https://github.com/user-attachments/assets/bfa48a70-5379-495f-8599-fc9bf49c4801) ![Admin light](https://github.com/user-attachments/assets/e100d984-3165-4f38-948a-625249b4600a) ![Map light](https://github.com/user-attachments/assets/7d266ff3-0db7-477b-8029-c76e42298002)
## 相关文档 - [API.md](API.md)：REST API、WebSocket、鉴权、错误码和数据结构 - [https://github.com/huilang-me/cfsm-agent](cfsm-agent)：Go 版本 Agent 配置、升级、日志与排障 - [theme-develop.md](theme-develop.md)：第三方主题开发 - [test/README.md](test/README.md)：本地模拟数据和测试流程 ## 社区 - Telegram 群组： - 在线演示： ## 支持项目 如果这个项目对你有帮助，欢迎通过以下方式支持后续维护。

微信赞赏码

- 微信赞赏：扫码支持 ## 致谢 - [CF-Server-Monitor-Pro](https://github.com/a63414262/CF-Server-Monitor-Pro) - [Cloudflare Workers](https://workers.cloudflare.com/) - [Vue 3](https://vuejs.org/) - [Vite](https://vite.dev/) - [Chart.js](https://www.chartjs.org/) - [Leaflet](https://leafletjs.com/) - 感谢 [NodeSeek](https://www.nodeseek.com/post-763025-1) 和 [LINUX DO](https://linux.do/) 社区的支持与推广 ## 许可证 MIT License