点击右上角 Fork 按钮，将项目 Fork 到你的 GitHub 账户。

1. 登录 Cloudflare 控制台
2. 进入 Workers & Pages
3. 点击 Create application
4. 选择 Continue with GitHub（第一次使用需要连接 GitHub 账户），选择本项目
5. Project Name填写：cf-server-monitor,小写即可，可按自己需求设置
6. Build command 填写：npm run build:frontend
7. 点击 Deploy，成功会在底部显示✨ Success! Build completed.

1. 在当前Workers & Pages页面，点击 Settings
2. 在Variables and secrets找到API_SECRET，点右侧编辑，填写密码（建议使用随机数,不要包含特殊字符比如%），点Deploy保存部署，等待30秒左右部署完成

1. 在当前Workers & Pages页面，点击 Domains
2. 第一个就是你的 Worker URL，复制访问即可，也可以绑定自己的域名

点击右上角 Fork 按钮，将项目 Fork 到你的 GitHub 账户。

1. 登录 Cloudflare 控制台
2. 进入 Workers & Pages → D1 SQL Database
3. 点击 Create database
4. 数据库名称填写：server-monitor-db
5. 点击 Create
6. 记录下生成的 Database ID，稍后会用到

方式一：从右侧面板获取

1. 打开 Cloudflare Dashboard
2. 在右侧面板找到 Account ID
3. 复制保存

方式二：从 URL 中获取

• 登录后访问任意 Cloudflare 页面，例如 Workers & Pages
• URL 中 dash.cloudflare.com/ 之后的那串字符就是 Account ID

1. 打开 API Tokens 页面
2. 点击 Create Token/创建令牌
3. 选择（Edit Cloudflare Workers/编辑 Cloudflare Workers）模板
4. 在 Account Resources/帐户资源 选择你的账户
5. 点击 Continue to summary/继续以显示摘要→ Create Token/创建令牌
6. 复制生成的 Token（只显示一次！）

1. 打开你 Fork 的 GitHub 仓库
2. 进入 Settings → Secrets and variables → Actions
3. 点击 New repository secret，依次添加以下 5 个密钥：

推送代码到 main 分支即可自动部署：

# 克隆你 Fork 的仓库
git clone https://github.com/你的用户名/CF-Server-Monitor.git
cd CF-Server-Monitor

# 可选：修改配置后提交
git add .
git commit -m "Initial setup"
git push origin main

推送后，GitHub Actions 会自动部署。在仓库的 Actions 标签页可查看部署进度。

也可以通过 GitHub Actions 手动触发部署：

1. 进入你的 GitHub 仓库页面
2. 点击顶部的 Actions 标签
3. 在左侧工作流列表中选择 Deploy to Cloudflare Workers
4. 点击右侧的 Run workflow 按钮
5. 选择分支（默认选择 main）
6. 点击 Run workflow 开始部署

部署进度可在 Actions 标签页中查看。

新用户点击一键部署

修改API_SECRET，建议使用随机密码,不要包含特殊字符比如%，登录密码在登录后修改，建议和API_SECRET不同。

在build command中填入 npm run build:frontend，其他保持默认

点击部署即可

部署成功后，访问管理后台：

https://你的项目名.你的子域.workers.dev/admin

• 用户名：默认admin，如果设置了环境变量 API_USER_NAME，则使用该值
• 密码：你设置的 API_SECRET

登录后务必修改用户名和密码，以确保安全。 强烈建议登录密码和探针认证密钥不同。

提示：项目名和子域可以在 Cloudflare Workers & Pages 页面找到。建议绑定域名，避免国内无法访问

1. 进入管理后台 /admin
2. 在"服务器名称"输入框填写名称
3. 点击 + 添加服务器
4. 点击新服务器旁的 📋 按钮复制安装命令

Ubuntu / Debian / CentOS / RHEL / Fedora / Rocky / AlmaLinux 系统

curl -sL https://你的项目.你的子域.workers.dev/install.sh | bash -s install -id=<SERVER_ID> -secret=<SECRET> -url=<WORKER_URL> [-interval=60] [-ping=http] [-ct=xxx] [-cu=xxx] [-cm=xxx] [-bd=xxx]

Alpine 系统

curl -sL https://你的项目.你的子域.workers.dev/install-alpine.sh | sh -s install -id=<SERVER_ID> -secret=<SECRET> -url=<WORKER_URL> [-interval=60] [-ping=http] [-ct=xxx] [-cu=xxx] [-cm=xxx] [-bd=xxx]

对于 Windows 系统，使用 Python 脚本安装探针：

pip install psutil pystray pillow

cf-server-monitor.pyw

双击cf-server-monitor.pyw文件即可启动探针。

参数说明：

注意：上报间隔越短，数据越实时，但会增加 API 调用和数据库存储。建议根据服务器数量和网络状况选择合适的间隔。

Ubuntu / Debian / CentOS / RHEL / Fedora / Rocky / AlmaLinux 系统

curl -sL https://你的项目.你的子域.workers.dev/install.sh | bash -s uninstall

Alpine 系统

curl -sL https://你的项目.你的子域.workers.dev/install-alpine | sh -s uninstall

Windows 系统

启动cf-server-monitor.pyw后，GUI中关闭自启动（如已开启）。点删除，再删除这个文件即可

如需启用 Turnstile 人机验证，可用基本拦截恶意攻击避免额度超出，需在管理后台配置：

1. 登录 Cloudflare Turnstile
2. 创建站点，获取 Site Key 和 Secret Key
3. 在管理后台 → 全局设置中启用 Turnstile 并填入密钥

如需自定义 JWT 密钥：

1. 生成一个至少 32 位的随机字符串作为 JWT Secret
2. 在管理后台 → 全局设置中填入 JWT Secret
3. 保存后系统将使用自定义密钥进行 token 签名

访问 https://你的项目.你的子域.workers.dev/ 查看：

• 卡片视图：服务器状态概览（含实时网速和本月流量）
• 表格视图：详细数据列表
• 地图视图：全球服务器分布
• 过滤器：按国家筛选服务器

点击任意服务器卡片进入详情页：

• 实时 CPU/内存/磁盘/网络/负载
• 1/3/6/12/24 小时历史趋势图
• 鼠标悬停查看具体时间点的数值
• 国内三大运营商延迟追踪

注意：查看1小时以上的历史数据需要登录管理员账户。

管理后台支持自定义 CSS主题

在管理后台的服务器列表中，可以通过拖拽调整服务器的显示顺序

可以将特定服务器设置为对非登录用户隐藏：

1. 进入管理后台 /admin
2. 点击服务器行右侧的 ✏️ 编辑 按钮
3. 勾选 Hide from Public 选项
4. 点击 保存

管理后台提供数据库维护功能，可在 "Database Management" 标签页中找到：

1. 升级数据库：将数据库结构升级到最新版本，适用于旧版本用户升级
   • 点击「Upgrade Database」按钮
   • 确认升级操作
   • 系统会自动执行数据库升级脚本
2. 重建数据库：清空并重建整个数据库（⚠️ 危险操作）
   • 点击「Rebuild Database」按钮
   • 确认重建操作（此操作将删除所有数据）
   • 系统会清空并重新初始化数据库

注意：

• 重建数据库是不可逆操作，请确保已备份重要数据
• 升级数据库不会删除现有数据，仅会更新表结构

在管理后台 → 全局设置中配置：

Telegram 告警：

1. 创建 Telegram Bot（通过 @BotFather）
2. 获取 Bot Token
3. 获取 Chat ID（通过 @userinfobot）
4. 填入后台设置并开启

企业微信告警：

1. 创建群机器人，获取 Webhook URL
2. 填入 Bot Token 字段
3. Chat ID 留空

系统包含以下定时任务（UTC 时区）：

Q: 部署后返回API_SECRET is required

如果是GitHub Action 自动部署，确保在 GitHub Secrets 中设置了 API_SECRET 密钥。 如果是一键部署，确保在Cloudflare Workers & Pages 中设置了 API_SECRET 密钥。

Q: 探针安装后不显示数据？

检查服务器是否能访问 Worker URL，查看探针日志：journalctl -u cf-probe -f

Q: 如何更换 API_SECRET？

更新 Cloudflare Workers & Pages 中的 API_SECRET，重新部署，并在所有服务器上重新安装探针。如果是GitHub Action 自动部署，需要在 GitHub Secrets 中更新 API_SECRET。

Q: D1 数据库免费额度够用吗？

Cloudflare D1 免费版提供 5GB 存储和 5M 读取行/日、100K 写入行/日，足以支持服务器监控。

写入行：1台服务器一天占用写入行是2.88k，免费写入额度是100k/天，理论上可用支持34台服务器的监控，如果修改上报频率为120秒可用翻倍。

读取行：1台服务器一天占用读行是8k左右，如果开启站点兼容，大概是1.6k，免费读行是5M/天，非常充裕 主要是前端访问消耗的次数，限制了非登录用户1小时以上的查看，只要不被暴力刷额度，绝对够用，如果不放心，可用在后台开启Turnstile人机验证，或者也可以选择仅登录查看

Q: D1 数据库免费额度超出扣费吗？

超出不扣费，只会限制访问，第二天北京时间08:00重置

Q: 遇到其他异常问题怎么办？

可以尝试在后台数据库管理中：

• 升级数据库：尝试修复数据库结构问题
• 重置数据库：清空并重建数据库（⚠️ 注意：此操作将清除所有数据，请确保已备份重要信息）

Q: 忘记密码？

进入Cloudflare后台，进入D1数据库（server-monitor-db），点击右上角explore data，进入后点击左侧的setting表，双击site_options右侧的value，可以看到用户名和md5加密的密码，password修改成e10adc3949ba59abbe56e057f20f883e，即默认密码123456，右上角点Commit 1 change，弹出的确认框点确认即可。然后访问后台用默认密码登录即可。

浅色风格

• Node.js 18+
• npm 或 pnpm

根目录新建 .env 文件，添加环境变量默认API_SECRET：

API_SECRET = "123456"

然后执行以下命令进行本地开发：

# 安装依赖
npm install

# 创建 D1 数据库（首次）
npx wrangler d1 create server-monitor-db

# 前端开发模式（热重载）
npm run dev

# 构建前端生产版本
npm run build:frontend

# 部署到 Cloudflare Workers
npm run deploy

支持生成本地测试数据，方便在部署前进行功能测试：

1. 进入 test 目录查看详细说明
2. 运行测试数据生成脚本
3. 导入生成的 SQL 数据到本地 D1 数据库
4. 启动本地开发服务器进行测试

node test/generate-sql.js
wrangler d1 execute server-monitor-db --file=test/mock-data.sql

详细步骤见 test/README.md

项目提供了 api-check.js 接口测试工具，用于验证本地开发环境的 API 接口是否正常工作：

# 默认配置测试
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/config、/api/servers、/api/server、/update 等
• 登录流程：登录接口验证
• 已登录接口：隐藏服务器访问、历史数据查询等
• 后台管理：服务器增删改查、设置管理等

选项参数：