Skip to content
Projects

BeacherZ/cdt-management has 34 GitHub stars and 10 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-15 23:45 UTC. Last push 2026-11-12.

How these counts are measured

Measured star growth

in 24h
+2
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Docker 搭建的网页管理面板:阿里云 CDT 抢占式实例的单机保活 + 多机联合换班 + DDNS + 通知。

Self-hosted

README.md

Original

CDT-Management

Docker 搭建的网页管理面板:阿里云 CDT 抢占式实例的单机保活 + 多机联合换班 + DDNS + 通知。

三个模块各管一段,互不干扰:

模块 作用
单机保活 实例掉线就自动拉起来;可自由设定运行窗口
联合换班 多台实例编成一组,按工时或天数排班后轮流当班
DNS 域名记录集中管理,一条记录显式绑一台实例或一个换班组

没编进任何流程的闲散实例照旧可以手动开关机。

实例不限抢占式,按量付费 / 包年包月的实例同样适用,只是用不到「抢占恢复」。

license python docker

🖥️界面

概览

✨主要功能

单机保活

说明:一台实例自己管自己,掉了就拉起来,不换班、不碰别的实例。

每轮巡检(默认 60 秒,可自定义间隔与起始秒)停着就再下发一次开机,直到拉起为止;启动中不重复下发。

运行窗口(可选):比如只让它每天 08:00–20:00 跑,或只在这个月的 1–16 号跑,两项同时填按交集算。结束早于开始表示跨天到次日(如 20:00–06:00);结束填 00:00 表示到 24:00;起止相同等于全天。窗口外自动停机、窗口内自动保活,窗口两端都不推通知。

目的:失联第一时间拉起来,保证在线率;设定运行窗口让实例只在用得上的时间在线,减少费用。

联合换班

说明:多台实例编成一组,按顺序轮流当班,同一时刻只留一台在线。排班周期两种任选:

一天一轮:填每台的工时,或直接排 0–24 点的固定时刻表,24 小时内换完;

一月一轮:填每台上几天,1 号 0 点从第 1 位开始,最后一位承接当月剩下的天数。

交接顺序:上班准时——到点先把当班实例开机;下班不抢跑——等下一台确认运行中,上一台才停机。

目的:通过联合换班,降低多台抢占式实例同时在线的成本,并充分利用每台实例各自的 200G CDT 免费流量包。

流量保护

说明:每台单独配阈值,超限自动停机;换班组会先尝试故障转移,全超才熔断。

故障转移的两种触发情形:当班流量到阈值,或当班被抢占后尝试3次无法拉起。

目的:不让任何一台实例烧穿流量包。

DNS

说明:一条记录绑一台实例或一个换班组;目标在跑时,公网 IP 一变(开机换 IP、手动换弹性 IP)下一轮巡检自动指过去。

每轮巡检只拿API返回的IP比对本地记录,不查 Cloudflare;只有手动开机、单机保活拉起、换班结算这三个时点会强制查一次实际解析值。一致就不改记录,DNS 页的「上次同步」也不会跳;不一致才更新。

目的:单实例换了弹性 IP 不用手动改 DNS;换班组绑定的域名 DDNS 同步到目前当班运行的实例IP,组员搭建的同种服务共享配置后可无感切换使用该服务。

通知

说明:支持 Telegram、邮件、Webhook 三类渠道,可同时开启。

目的:换班、故障转移、熔断、超限停机、抢占恢复、换班异常、每日报告都主动推给你,不用盯面板。

实际推出来的样子(点开看原图):

CDT 换班完成报告(换班组) CDT 故障转移报告(换班组) CDT 全局熔断报告(换班组)

CDT 全局熔断报告(换班组·单台) CDT 超限停机报告(单机保活) CDT 超限停机报告(闲散手动)

CDT 抢占恢复报告 CDT 换班异常报告(换班组) CDT 每日报告

🚀快速开始

三种装法任选一种。默认数据目录 /opt/docker/cdt-management,宿主机端口 8282,容器端口 8080。

装好后浏览器打开 http://你的地址:8282,首次会引导设置管理员账号。

方式一:一键脚本(最省事)

curl -fsSL https://raw.githubusercontent.com/BeacherZ/cdt-management/main/install.sh | bash

内部走【方式三】的 docker run;没装 Docker 会自动装。换端口或换目录自行加参数:

curl -fsSL https://raw.githubusercontent.com/BeacherZ/cdt-management/main/install.sh | PORT=18282 DIR=/srv/cdt bash

升级:重跑同一条命令,会先比对版本,已是最新就不动容器;有新版本才删容器重建,数据不动。

方式二:docker compose

services:
  cdt-management:
    image: ghcr.io/beacherz/cdt-management:latest
    container_name: cdt-management
    restart: unless-stopped
    init: true
    ports:
      - "8282:8080"
    environment:
      TZ: Asia/Shanghai
      CDT_DATA_DIR: /data
    volumes:
      - /opt/docker/cdt-management:/data
mkdir -p /opt/docker/cdt-management
docker compose up -d
docker compose logs -f cdt-management

升级(两行一起粘,任意目录都能跑):

D=$(docker inspect -f '{{index .Config.Labels "com.docker.compose.project.working_dir"}}' cdt-management)
cd "$D" && docker compose pull && docker compose up -d

方式三:docker run

mkdir -p /opt/docker/cdt-management

docker run -d --name cdt-management --restart unless-stopped --init \
  -p 8282:8080 \
  -e TZ=Asia/Shanghai \
  -e CDT_DATA_DIR=/data \
  -v /opt/docker/cdt-management:/data \
  ghcr.io/beacherz/cdt-management:latest

升级:

docker pull ghcr.io/beacherz/cdt-management:latest
docker rm -f cdt-management
# 再把上面那条 docker run 原样粘一次,挂载目录不动,数据不会丢

Windows 挂载路径写成 -v D:/docker/cdt-management:/data。

卸载

# 只删本项目(容器、镜像和数据目录一起删)
curl -fsSL https://raw.githubusercontent.com/BeacherZ/cdt-management/main/install.sh | UNINSTALL=1 bash

# 连 Docker 一起卸(本机所有容器和镜像都会没)
curl -fsSL https://raw.githubusercontent.com/BeacherZ/cdt-management/main/install.sh | UNINSTALL=docker bash

两条都会问一次 yes,输对了才动手。

🔑阿里云 RAM 权限

完整使用本项目功能需要给当前用户添加以下三种 RAM 权限:
(RAM 访问控制 - 身份管理 - 用户 - 权限管理)

RAM 权限 用在哪
AliyunECSFullAccess 查实例、开机、停机(含节省停机)
AliyunCDTReadOnlyAccess 读当月 CDT 公网流量
AliyunBSSReadOnlyAccess 账户余额、实例账单
  • 少了 CDT 这组,整轮对账都会失败,不是流量空着 —— 必须给
  • 少了 BSS 这组,费用和余额显示不出来,启停照常
  • 国内站和国际站的 AK 不通用,一台实例一套凭据
  • RAM 控制台:国内站 · 国际站

🧭配一遍的流程

  1. 实例管理 → 添加实例:填别名、Region、AccessKey ID/Secret、实例 ID、配额与限流阈值,按需选停机模式(默认节省停机)
  2. 二选一(或都要,但同一台不要同时挂两边):
    • 单机保活 → 添加保活,勾上这台;要限定运行时段/日期就在同一个设置页里填
    • 联合换班 → 新建换班组,选排班周期(一天一轮按工时,一月一轮按天数),按顺序添加成员
  3. 设置 → DDNS:填 Cloudflare Token(或 Global API Key)、TTL,开启
  4. DNS:加域名记录,再把它绑到某台实例或某个换班组(不绑就谁也不会去动它)
  5. 设置 → 通知:填 Telegram Bot Token + Chat ID,点「发送测试」确认能收到
  6. 回概览点「立即同步」,看第一轮结果

💾数据放在哪

路径 内容
cdt-management.db SQLite:实例、换班组、换班进度、事件、流量采样
master.key 加密主密钥,必须与 db 一起备份,丢了 AccessKey Secret 无法解密

备份就把整个目录拷走;换宿主机时两个文件一起搬。

🔒公网部署与安全

直接暴露到公网(或通过端口映射)并不安全,建议套一层 HTTPS 反向代理。

❓常见问题

换班了但没收到通知? 先看「设置 → 通知」里渠道是否启用、点测试能不能发出去;再看概览的「最近事件」有没有对应记录。通知失败只记事件,不会阻塞换班。

DDNS 显示「IP 无效跳过」? 实例还没拿到公网 IP,或者不是公网 IPv4。等下一轮同步,或手动刷新那台实例。

所有成员都超限了怎么办? 会全局熔断,全部节省停机,等下个月流量重置后手动开机,或调整阈值。

忘了面板密码? 删掉数据目录里的 cdt-management.db 会重置所有配置。

🛠️本地开发

python -m venv .venv && ./.venv/bin/pip install -r requirements.txt
./.venv/bin/python -m app.main              # 后端 :8080
cd web && npm install && npm run dev        # 前端 :5273,已配 /api 代理
CDT_DRY_RUN=1 ./.venv/bin/python -m app.main # 不调真实阿里云

CDT_DRY_RUN=1 时阿里云调用走内存桩,整条换班链路能在本地跑通,不会碰真实账号。

📄致谢与许可

本项目以 MIT 协议发布,LICENSE 里同时保留了上游版权声明。