阿里云 CDT 流量监控 与 ECS 自动化控制面板,运行在 Cloudflare Workers 上。
参考 wang4386/CDT-Monitor 的业务语义,实现为 Rust/Wasm + D1 + Queues + Cron Triggers + Turnstile,前端为无框架纯 TypeScript。
┌───────────────────────────────────────────────────────────────────┐
│ Cloudflare 边缘 │
│ │
│ 纯 TypeScript 前端 (DOM + ECharts) ← ASSETS 绑定 │
│ │ fetch /api/v1/*(同源 Cookie) │
│ ▼ │
│ Worker (Rust → Wasm) │
│ ├─ fetch: 路由 + 登录 + Cookie 鉴权 │
│ ├─ scheduled: */5 * * * * 巡检 │
│ └─ queue: 异步 Job(刷新 / 开关机 / 通知测试 / 日报) │
│ │ │
│ ├─ D1:accounts / snapshots / history / jobs / logs │
│ └─ fetch → 阿里云 RPC(CDT / ECS / BSS) │
│ Telegram · Bark │
└───────────────────────────────────────────────────────────────────┘
- 流量采样与熔断:每 5 分钟采集 CDT 公网流量与实例状态,余额每 30 分钟更新(手动刷新立即查询),按小时 / 天查看 ECharts 趋势,达到阈值自动告警或停机止损。
- 实例自动化控制:面板手动启停、每日定时开关机(或五字段 Cron)、抢占式实例自动保活拉起。
- 公网地址:卡片显示实例的公网 IPv4 / IPv6,点地址即复制。
- 多渠道推送:支持 Telegram 与 Bark,覆盖超限熔断、保活拉起与每日流量日报。
- 纵深安全:AK Secret 与推送凭据经 XChaCha20-Poly1305 加密落盘,配合 Turnstile、常量时间比对、设备会话管理与跨站请求拦截。
需要一对 AccessKey 才能读流量、查实例、按阈值停机。不要用主账号的 AccessKey。
- 进入阿里云 RAM 用户控制台(🇨🇳 国内站 | 🌍 国际站),点 创建用户。
- 填写登录名称(例如
cdt-monitor),访问方式勾选 「使用永久 AccessKey 访问」。 - 创建完成后,把页面上生成的 AccessKey ID 和 AccessKey Secret 复制保存下来,后面填进 CDT-Monitor 就用这两个值。
官方预置的系统策略权限过宽,这里写一份最小权限策略。
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": "cdt:ListCdtInternetTraffic",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "bssapi:QueryAccountBalance",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "ecs:DescribeInstances",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "ecs:DescribeNetworkInterfaces",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ecs:StartInstance",
"ecs:StopInstance"
],
"Resource": "acs:ecs:<region>:<主账号 UID>:instance/<实例 ID>"
}
]
}Note
bssapi:QueryAccountBalance可能提示「无效授权」:忽略即可(阿里云文档写的是bssapi:Query*,两种写法实测都能查到余额)。不想让程序读财务数据时可以删掉这一段,余额一栏会显示—(通知里显示「未知」),不影响其他功能。ecs:DescribeInstances不能省:启停接口内部会先校验实例状态。若实例在 VPC 内且报权限错误,再补vpc:DescribeVpcs等基础网络查询权限。ecs:DescribeNetworkInterfaces用于补取 IPv6:实例详情未返回 IPv6 时,程序会按实例 ID 查询已挂载的主、副网卡。沿用旧权限策略的用户需要补上这一项;缺少权限会在「采集告警」中显示具体错误,实例状态仍正常更新。
最后一段的 acs:ecs:<region>:<主账号 UID>:instance/<实例 ID> 用来限制子账号只能开关指定的机器,三个占位符都要换成实际值:
| 占位符 | 含义 | 去哪找 | 示例 |
|---|---|---|---|
<region> |
地域 ID | 目标 ECS 所在的地域代号 | cn-hongkong |
<主账号 UID> |
阿里云账号 ID | 鼠标移到控制台右上角头像即可看到 | 1234567890123456 |
<实例 ID> |
ECS 实例 ID | instance 后面必须保留斜杠 / |
i-bp1234567890abcdef |
一个账号对应一个地域和一台实例:
"Resource": "acs:ecs:cn-hongkong:1234567890123456:instance/i-bp1234567890abcdef"要用同一个子账号管理多台机器时,Resource 改成数组:
"Resource": [
"acs:ecs:cn-hongkong:1234567890123456:instance/i-bp1111111111abcdef",
"acs:ecs:cn-hangzhou:1234567890123456:instance/i-bp2222222222abcdef"
]- 回到 RAM 用户列表,找到刚才创建的账号,点右侧 新增授权。
- 授权范围 保持默认的「账号级别」。
- 在 权限策略 里切到「自定义策略」,搜索并勾选刚建的策略,确认授权。
完成后,保存好 AK/SK 和实例 ID,配置 CDT-Monitor 时会用到。
Workers 和 Pages → 创建应用(Create)→ Workers → 从 GitHub 导入(Connect with GitHub),选中本仓库,填两项:
| 项 | 值 |
|---|---|
| 构建命令(Build command) | bun run build |
| 部署命令(Deploy command) | bun run deploy |
部署脚本会创建 cdt-monitor-tasks 任务队列和 cdt-monitor-tasks-dlq 死信队列,并绑定生产者和消费者。自定义构建 API Token 需要 D1、Workers Scripts 和 Queues 的编辑权限。构建仅在 Build command 执行一次,部署上传已有产物;本地部署前也请先运行 bun run build。
队列每条消息默认包含一次写入、读取和删除操作;每五分钟每账号巡检一次,约 864 次操作/账号/天,另有维护、手动任务和重试。请按账号规模核对 Queues 当前额度。
维护消息仅在每日清理或日报到期时派发。正常无重试时,基础用量约为 864 × 启用账号数 + 3~6 次/天:常见的 1~3 个账号约 870~2,600 次/天。截至 2026-11-08,免费版包含 10,000 次操作/天;手动任务、页面补采和失败重试另计。
项目通过 .node-version 固定 Node 26.13.0 LTS,根 package.json 固定 Bun 1.4.4。Cloudflare 会读取这些文件选择版本;已有构建变量应与它们保持一致:
| 变量名 | 变量值 |
|---|---|
BUN_VERSION |
1.4.4 |
NODE_VERSION |
26.13.0(可省略,由 .node-version 选择) |
Important
如果控制台已有 NODE_VERSION=24,请改为 26.13.0 或删除该变量;构建脚本会检查实际 Node 版本。Bun 与 Node 的版本选择方式见 Cloudflare 构建镜像文档。
点 部署(Deploy)。
第一次部署完成之后再进行这一步。
设置(Settings)→ 运行时变量和密钥(Variables and Secrets),添加三项,类型都选 密钥(Secret):
| 名称 | 值 |
|---|---|
MASTER_KEY |
见下方说明 |
ADMIN_USERNAME |
你自己定的管理员用户名 |
ADMIN_PASSWORD |
你自己定的管理员密码 |
添加并保存后,Cloudflare 会自动重启 Worker,新值立即生效。
它不是让你手写的一串固定值,而是随机生成的一段密钥。在任意一台装有 OpenSSL 的电脑上执行:
openssl rand -hex 32会输出 64 个十六进制字符,例如:
9f3c1a7e4b2d8f605a9e7c3b1d4f8a2e6c9b0d3f5a8e1c4b7d2f9a6e3c0b5d81
把这串完整复制,粘贴到 MASTER_KEY 的值里。不要把命令本身填进去。
没有 OpenSSL 时,任意 32 字节的随机串也可以(64 位 Hex、44 位 Base64 均可);随手编一串短字符串虽然能启动,但强度不够,不建议。
Warning
改了 MASTER_KEY 会让已存的密文全部解不开,需要到设置页把每个实例的 AccessKey Secret 及通知密钥重填一遍。
项目技术说明
cdt-monitor/
├── Cargo.toml # Rust 2024,cdylib → wasm32
├── wrangler.toml # D1 / Queues / Assets / Cron
├── package.json # 根脚本(Bun)
├── rust-toolchain.toml
├── .dev.vars.example # 本地开发变量模板
├── scripts/
│ ├── build-ci.sh # 构建入口:校验配置 → 装工具链 → 构建
│ ├── check-config.ts # wrangler.toml 结构校验
│ └── deploy.ts # 部署入口:建库 → 迁移 → 发布
├── migrations/
│ ├── init_001.sql # 9 张表 + 12 个索引
│ ├── init_002_schedule_cron.sql # 增量:定时模式与 Cron 字段
│ └── init_003_reliability.sql # 增量:分项采集状态、任务恢复、登录限流
├── src/
│ ├── lib.rs # fetch / scheduled 入口、路由、鉴权
│ ├── jobs.rs # D1 任务执行器与批量进度
│ ├── tasks.rs # 队列派发与单账号巡检
│ ├── runtime.rs # 并发请求、超时与取消
│ ├── models.rs # D1 实体行 + 前后端 DTO + 时区/单位换算
│ ├── db.rs # D1 SQL 封装(含幂等锁)
│ ├── crypto.rs # XChaCha20-Poly1305、无状态 Token
│ ├── logging.rs # 分级日志(默认只输出 error)
│ ├── cron.rs # Cron 表达式解析与触发窗口判定
│ ├── aliyun.rs # RPC V1 签名器 + CDT/ECS/BSS 客户端
│ ├── notify.rs # Telegram + Bark
│ ├── scheduler.rs # 采样 / 巡检 / 日报
│ └── scheduler/ # 熔断、定时开关机与保活
├── tests/worker.mjs # 本地 Worker + D1 业务回归
└── web/
├── package.json
├── tsconfig.json
├── vite.config.ts
├── index.html # 以 render=explicit 引入 Turnstile
├── public/
│ ├── favicon.svg
│ └── theme-init.js # 首屏落地主题,避免深色下一帧白底
└── src/
├── main.ts # 入口
├── App.ts # 主控制台
├── style.css # 主题令牌与组件语义类(含深色主题)
├── env.d.ts # Turnstile 类型声明
├── api/client.ts # API 客户端 + 202 Job 轮询
├── lib/
│ ├── dom.ts # el() / iconSvg() 等 DOM 工具
│ ├── icons.ts # 按需引入的 lucide 图标
│ ├── theme.ts # 浅色 / 深色 / 跟随系统
│ ├── logs.ts # 日志标签与行渲染(设置页共用)
│ ├── echarts.ts # 按需注册的 ECharts 模块(动态 import)
│ ├── store.ts # 状态容器 + toast
│ └── actions.ts # API 调用与状态写入
└── components/
├── LoginModal.ts # 登录卡片 + Turnstile
├── AccountCard.ts # 账号卡片 + 实例控制 + 公网 IP
├── HistoryModal.ts # ECharts 历史流量弹窗
├── SettingsModal.ts # 设置弹窗(7 个标签页)
├── CronEditor.ts # 五字段 Cron 输入 + 预览
└── ToastStack.ts # 提示条容器
前端为纯 TypeScript 类组件,直接操作 DOM,不依赖任何框架。
| 类别 | 存放位置 | 内容 |
|---|---|---|
| 运行时密钥 | 设置 → 运行时变量和密钥 | MASTER_KEY、ADMIN_USERNAME、ADMIN_PASSWORD |
| 构建变量 | 设置 → 构建 → 高级设置 | BUN_VERSION |
| 业务配置 | D1,设置页面 | 阿里云账号、Turnstile、Telegram、Bark、日报、时区、日志级别等 |
wrangler.toml 不含 [vars] 段。业务配置改动即时生效,无需重新部署。
| 项目 | 默认 | 调整方式 |
|---|---|---|
| 应用日志 | 仅 error |
设置 → 系统 → 日志级别 |
| Workers Logs | 开启应用日志,关闭逐请求调用日志 | wrangler.toml 的 [observability.logs] |
error 解密失败、D1 不可用、任务失败
warn 通知发送失败、动作后刷新失败
info Cron 汇总、任务完成、保活拉起实例
debug 同 info
应用默认只输出错误,Workers Logs 保留这些日志;正常请求不生成调用日志。排障时可临时将应用日志级别改为 warn / info,日志在 Cloudflare 控制台 Workers → 本应用 → Logs 里查看。
Cron 派发端检查启用账号的流量和实例最近成功采集时间,超过 15 分钟未更新时记录「采集停滞」并通过已配置的通知渠道告警;送达后抑制重复告警 1 小时,失败则下一轮重试。该检查不依赖队列消费,可发现队列积压,但无法在 Cron 本身停止触发时发送告警,这种情况需由外部监控检测。
队列重试耗尽的消息进入 cdt-monitor-tasks-dlq,在 Cloudflare Queues 控制台检查积压和死信。死信仅用于排障,不自动重放启停;处理故障后应核实实例当前状态,再提交新的操作。死信仍受队列保留期限制,并非永久备份。参见 Cloudflare 死信队列说明 与 Workers Logs 配置。
明文 ──XChaCha20-Poly1305(随机 24B Nonce)──▶ Base64(Nonce ‖ 密文 ‖ 16B Tag) ──▶ D1 TEXT
- 算法
chacha20poly1305::XChaCha20Poly1305,192 位 Nonce - 主密钥解析顺序:64 字符 Hex → Base64(三种变体)→ 恰 32 字节原文 →
blake3::derive_key - 任一字节被篡改都会导致 AEAD 认证失败并返回明确错误
| 环节 | 实现 |
|---|---|
| 人机校验 | Turnstile siteverify,携带 CF-Connecting-IP 作为 remoteip;前端 appearance: 'interaction-only',无交互需求时不渲染可见元素 |
| 开关 | 默认关闭;配置损坏,或启用后密钥不完整、无法解密,均返回 turnstile_broken 并拒绝登录 |
| 凭证来源 | ADMIN_USERNAME / ADMIN_PASSWORD,唯一来源 |
| 比较方式 | 用户名与密码均常量时间比较且不短路 |
| 防枚举 | 用户名错与密码错返回同一提示,延迟一致 |
| 登录限流 | 每个来源 IP 每 5 分钟最多 10 次尝试,D1 原子计数 |
| 会话 | v1.<payload>.<sig>,HMAC-SHA256(MASTER_KEY) 签名,payload 含 iat / exp / jti |
| 传输 | HttpOnly; Secure; SameSite=Strict Cookie |
新登录的会话固定为 7 天,系统设置不再提供有效期选项;已有会话按签发时的到期时间结束。
- 写接口校验
Sec-Fetch-Site/Origin/Referer,拒绝跨站请求 - 所有文本经
textContent写入,不拼接innerHTML;仅静态 SVG 内联 - 响应统一携带
X-Content-Type-Options: nosniff、X-Frame-Options: DENY、Cache-Control: no-store
0. Cron 按账号派发队列消息,每次消费一条;账号增多不会共用一次 D1 调用额度
1. housekeeping(到期才派发维护消息,每日一次,锁保护)
清理过期锁 / 32 天前历史 / 32 天前日志 / 7 天前 Job
2. 单账号:CDT 流量 + ECS 实例;余额距上次成功查询满 30 分钟才更新
一次 D1 batch 写快照和采样历史,同一小时 / 日期的相同流量值跳过更新
3. 额度判定:任一池(内地 / 非内地)超出各自额度
首次超限 → 标记账期;每轮核实停机,失败重试;通知送达后去重
4. 定时关机(10 分钟窗口;本轮实例查询失败不标记完成,保留重试)
5. 定时开机(同窗口,受熔断闸门约束)
6. 抢占式保活(见下方闸门)
7. 每日日报(独立延迟消息,读取最近完成的快照;10 分钟窗口,当天仅一次)
窗口取 10 分钟(与上游一致):巡检间隔 5 分钟,每个触发点有准点与 +5 分钟两次尝试机会。
开关机指令成功提交后,快照立即显示 Starting / Stopping(定时、保活、熔断与手动操作一致)。页面每分钟读取概览,对过渡态实例按需入队补采,直到云端返回稳定状态;常规流量巡检仍为每 5 分钟一次。定时开机与保活同轮发生时,保活读取更新后的快照,避免重复下发开机指令。
页面自动刷新实例状态,流量与余额仍按各自周期更新。停用账号后暂停自动巡检和启停;仍可手动刷新数据,但不会触发熔断停机。页面切到后台时暂停刷新,回到前台立即更新。
| 模式 | 配置 | 去重方式 |
|---|---|---|
| 简单 | 每日 HH:MM |
按本地日期,当天只执行一次 |
| 进阶 | 五字段 Cron(分 时 日 月 周) | 按「上次执行的触发时刻」,同一触发只执行一次 |
进阶模式用「触发时刻」而非日期去重,*/30 * * * * 这类高频表达式也能逐次生效。
阿里云不提供区分「系统回收」与「用户手动停机」的字段 —— 两者都是 Status == Stopped;OperationLocks 只在回收前 5 分钟标记,比巡检间隔还短、抓不住。因此靠四个前置条件收窄(与上游一致,任一不满足即跳过):
- 该实例的「抢占式实例保活」开关已开启
- 当前处于「允许运行时段」(只配关机时间时,关机后即不再保活)
- 未触发流量熔断
- 简单模式避让刚执行的定时关机;Cron 模式按最近的开/关触发判断当前应运行状态(同刻关机优先)
Warning
在允许运行时段内手动停止已开启保活的实例,必须先在面板关闭该实例的保活开关,否则下一次 Cron 巡检会将它重新拉起。
流量熔断停机 > 抢占式保活 > 定时开机
当月已熔断且策略为 stop_and_notify 时,保活、定时开机、手动开机均不会拉起实例。notify_only 不停机,不参与闸门。
- CDT 查询失败 → 沿用上次快照流量值及原账期,不用上月数据触发本月熔断
- 余额查询失败 → 沿用上次快照
- 实例查询失败 → 沿用该账号旧实例,卡片不会变空
- 实例保活开关 → 跟随实例设置中的当前配置
任务提交写入 D1 后发送到 Queues,队列投递失败由 Cron 补发。队列采用至少一次投递,任务使用原子领取去重,已完成或结果不确定的启停任务不会因重投而重新执行。
账号巡检采用 120 秒执行租约及 90 秒处理预算,成功后才写完成标记。采集失败、定时启停遇到过渡态或未知状态时允许消息重试;执行进程中断后可在租约过期时接管。重试前重新读取实例状态,并沿用启停动作各自的去重记录。超过 10 分钟的旧消息直接跳过,由新一轮巡检处理。
概览的过渡态补采同样按账号入队,HTTP 直接返回已有快照。多页面请求在 45 秒内合并派发,后续轮询读取更新后的状态,避免多个账号的云请求和 D1 调用集中到一次 HTTP 请求中。
日报只汇总有成功采集记录的当前账期流量,旧账期数值不计入合计;未采集账号及最近采集异常会在汇总和明细中说明。
写接口返回 202 Accepted + { job_id },前端轮询 GET /api/v1/jobs/{job_id}:
{
"id": "uuid",
"job_type": "start_instance",
"status": "pending|running|success|failed",
"error_msg": null,
"result_msg": null,
"created_at": 1792948752627,
"finished_at": null
}刷新任务按范围、手动启停任务按实例以 D1 锁互斥(owner = job_id,收尾按 owner 释放),并发提交返回 409 job_locked。未完成批量任务的锁保留到任务完成或超时回收,分段等待期间也不会重复提交。
任务参数与批量进度存入 D1。批量刷新每段处理一个账号,Cloudflare Queues 自动继续推进,关闭页面仍会执行;每段总预算 28 秒(含初始化与收尾),业务处理最多使用前 24 秒,账号刷新预算 20 秒,阿里云单次请求预算 4 秒(含响应体)。running 超过 60 秒会标记失败并释放任务锁,不自动重放结果不确定的启停指令。成功结果通过 result_msg 返回,包含部分采集失败的说明。
熔断后会持续核实实例状态,直到确认停止;通知失败也会重试。提高阈值或将其设为 0 后,需成功刷新流量且满足新阈值才解除熔断,界面会记录解除日志。各项最近成功采集时间保留在后端,用于避免旧数据参与自动化决策。
登录接口每个来源 IP 在五分钟窗口内最多接受 10 次尝试(含并发请求),超出返回 429 和 Retry-After。已启用的人机校验在配置损坏或读取失败时拒绝登录。
可靠性迁移 init_003_reliability.sql 会将旧执行器尚未完成的任务标记失败;分项成功时间在下次采集时补齐。本次新增 init_004_account_identity.sql,增加云账号身份、配置版本及锁 owner 索引,通过现有部署脚本先迁移再发布。升级前排队的手动启停消息没有配置版本,会失败并要求重新提交。部署迁移前应等待正在执行的旧版任务结束,避免新旧版本同时操作账号。
新增账号及更换凭据时使用 STS GetCallerIdentity 核实所属主账号:同账号密钥轮换保留熔断和历史;更换主账号、站点或额度池时,配置更新与旧快照/流量历史清理原子提交。同一额度池内仅更换实例或地域时清空实例状态,保留账号级熔断。定时规则或资源变化会清除对应执行记录。
存量账号在下次采集时补齐身份;若身份尚未记录且旧 AccessKey 已失效,替换为不同 AccessKey 时无法确认是否属于同一主账号,更新会被拒绝。此时可恢复旧密钥完成身份核实,或新增账号后迁移。使用相同 AccessKey ID 重新保存 Secret 可修复密文。
账号编辑、删除、刷新、手动启停及自动化控制共用账号租约;忙碌时编辑返回 409 account_busy,需稍后重试。配置更新递增版本,旧版本排队的手动启停任务会失败,不会作用于新配置。手动启停先查询实时状态,达到目标时更新快照;查询失败、过渡态或未知状态不会直接报告成功。
任务轮询只恢复所查询的任务,全局清理由 Cron 和任务提交时执行。会话的「最近活跃」每分钟最多写入一次,鉴权和吊销检查仍逐请求执行。
wrangler.toml 保留 no_nodejs_global_timers,使 Rust SDK 的超时定时器使用数字 ID。配置自检会检查此项;删除后可能导致 Wasm 定时器运行异常。
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/api/v1/auth/session |
会话探测(公开,返回 Turnstile site key,未启用时为空串) |
POST |
/api/v1/auth/login |
登录(用户名 + 密码,可选 Turnstile) |
POST |
/api/v1/auth/logout |
退出 |
GET |
/api/v1/overview[?refresh=transitional] |
首页数据(读快照表;transitional 时补采一次) |
GET |
/api/v1/history?account_id |
流量历史(小时 25 条 + 日 31 条一次返回) |
GET |
/api/v1/logs?account_id&action&q&limit |
操作日志(类型前缀 + 关键字) |
DELETE |
/api/v1/logs?account_id&action&q |
按同一套条件清空日志 |
GET |
/api/v1/jobs[/{id}] |
任务状态 |
POST |
/api/v1/refresh |
刷新全部 → 202 |
POST |
/api/v1/accounts |
新增账号 |
PUT/DELETE |
/api/v1/accounts/{id} |
修改 / 删除账号 |
POST |
/api/v1/accounts/{id}/refresh |
刷新单账号 → 202 |
POST |
/api/v1/accounts/{id}/instances/{iid}/start / stop |
开机 / 关机 → 202 |
PUT |
/api/v1/accounts/{id}/instances/{iid}/keep-alive |
逐实例保活开关 |
GET |
/api/v1/settings |
全部设置(脱敏) |
PUT |
/api/v1/settings/{module} |
更新设置,module 为 turnstile / telegram / bark / daily-report / timezone / advanced |
GET |
/api/v1/sessions |
登录设备 |
DELETE |
/api/v1/sessions[/{sid}] |
踢下线(指定 / 其它全部) |
POST |
/api/v1/settings/notify-test |
测试通知 → 202 |
POST |
/api/v1/reports/daily |
立即推送日报 → 202 |
POST |
/api/v1/cron/preview |
校验 Cron 表达式并预览未来几次触发 |
错误体格式 { "error": "...", "code": "..." },code 取值:
unauthenticated · invalid_credentials · credentials_not_configured · turnstile_failed · turnstile_unavailable · turnstile_broken · cross_origin · job_locked · init_failed · internal_error
| 表 | 用途 |
|---|---|
settings |
KV 配置(时区、日报、TG/Bark 密文、Turnstile 密文) |
accounts |
阿里云账号(AK、加密 Secret、地域、实例 ID、告警阈值、策略、定时/ Cron、保活) |
account_snapshots |
每账号一行最新状态,首页只读此表 |
traffic_hourly / traffic_daily |
流量采样(账期累计值),索引 (account_id, recorded_at) |
jobs |
异步任务状态 |
action_logs |
自动化动作 / 告警 / 登录审计 |
sessions |
登录设备,用于踢下线 |
locks |
幂等锁,TTL 到期可抢占 |
login_attempts |
登录来源固定时间窗口计数,过期自动清理 |
时间戳统一 Unix 毫秒 INTEGER;布尔存 0/1(Rust 侧以 i64 承载后转换,serde-wasm-bindgen 反序列化 bool 只接受 JS true/false)。
accounts.instance_id 为 NOT NULL:一个账号固定作用于一个地域内的一台实例。留空会让熔断停机、定时开关机、保活作用到该地域下的所有实例,因此实例 ID 必填。
| 用途 | Action | Version |
|---|---|---|
| CDT 流量 | ListCdtInternetTraffic |
2021-08-13 |
| ECS 查询 | DescribeInstances(按实例 ID 精确查询) |
2014-05-26 |
| IPv6 补充查询 | DescribeNetworkInterfaces(按实例 ID 查询主、副网卡) |
2014-05-26 |
| ECS 控制 | StartInstance / StopInstance(含 StoppedMode) |
2014-05-26 |
| 余额 | QueryAccountBalance |
2017-12-14 |
ListCdtInternetTraffic 返回的 Traffic 单位是 Byte(与计费项 Code ECS_Out_Bytes / Eip_Out_Bytes 的底层口径一致),控制台与账单才换算成 GB。traffic_unit_is_bytes 测试钉死这一点。
CDT 公网流量的免费额度按地域分为两个独立池,不共享、不合并计算:
| 池 | 判定规则(region_id) |
免费额度 |
|---|---|---|
| 中国内地 | cn- 开头且非 cn-hongkong |
20 GB / 月 |
| 非中国内地(含中国香港) | 其余地域(含 cn-hongkong) |
200 GB / 月 |
一个账号只落在一个池里,查询 CDT 用量时取对应那一类的累计值即可,不需要两池相加。
额度是阿里云定的固定值,不算用户配置项。用户能设的是告警阈值(traffic_threshold_gb):
0→ 不限制也不告警> 0→ 累计流量达到该值即告警,并按策略停机(stop_and_notify)
签名遵循 RPC V1(HMAC-SHA1),含针对官方样例的回归测试:
// src/aliyun.rs
assert_eq!(sign("testsecret", &to_sign), "OLeaidS1JvxuMvnyHOwuJ+uX5qY=");重试仅针对可恢复错误(网络失败、HTTP 5xx、Throttling*、ServiceUnavailable、InternalError),最多 2 次退避(200ms → 600ms);参数错误与鉴权失败直接返回。
rustup target add wasm32-unknown-unknown
bash scripts/install-worker-build.sh
bun install
bun run install:webcp .dev.vars.example .dev.vars
bun run db:migrate:local本地 D1 位于 .wrangler/state/,与线上隔离。
bun run dev # 构建前端与 Worker,启动 wrangler dev(:8787)前端独立热更新(/api 代理到 8787,保持 Cookie 同源):
bun run dev:web # :5173本地手动触发 Cron:
curl http://localhost:8787/cdn-cgi/local/scheduledRust 版本由 rust-toolchain.toml 指定,构建工具由安装脚本自动准备。
bun run build 会在发布前执行 Rust 单元测试、Clippy、前端类型检查及 Worker 集成测试,任一失败即停止构建;集成测试直接使用本轮构建产物,Worker 只编译一次。
bun run dev 只构建运行所需产物并启动本地服务,开发时按需执行下面的检查;完整构建仍执行全部验证。
cargo test --locked # 单元测试
cargo clippy --target wasm32-unknown-unknown -- -D warnings
bun run typecheck:web
bun run check:config
bun run test:worker # 构建并运行 Worker + D1 流程测试(云接口模拟)
bun run test:worker:built # 复用已有 Worker 产物运行集成测试
bun run test # 单测、类型/配置检查、Clippy、Worker 集成测试
bun run build