配置参考：本项目提供的默认一键创建配置仅供参考，请在下单前务必核对阿里云最新的 API 返回价格。
代码修改：代码完全开源，您可以根据个人需求自行修改逻辑或 UI。
AI 开发声明：本项目由 AI (Antigravity) 深度参与开发。作者已尽最大努力确保核心功能（如流量熔断、自动释放）的逻辑正确性。
Bug 修复：由于云平台 API 变动或环境差异，如遇见 Bug 建议先行尝试自行修复，或提交 Issue / PR，由于精力有限，作者不保证实时维护。
风险自担：因使用本脚本、或是阿里云 API 异常导致的相关资源损失或超支费用，作者概不负责。

🆕 最近更新

新增页面 Logo 自定义，支持本地上传或填写图片地址。
优化一键创建 ECS：支持公网 IP 类型、硬盘类型、系统盘大小校验与更换公网 IP。
优化释放中实例展示、前后端状态联动和移动端浮窗/表单体验。

🚀 快速部署

当前容器使用 Go 单进程版本：HTTP API、SQLite、任务 worker 和监控 worker 在同一个可优雅关闭的服务中运行，不需要 PHP-FPM、Nginx 或 Cron。

方式一：Docker Compose (推荐)

Colima、Docker Desktop 和 Linux Docker 均可使用。Compose 会创建非 root 应用使用的 named volume，并把旧的 ./data 目录作为只读迁移源；首次启动时若 volume 为空，会自动复制旧 SQLite 数据和加密密钥。

export ECS_SETUP_TOKEN="请替换为一次性随机 token"
docker compose up -d --build

访问 http://127.0.0.1:43211，初始化时把 ECS_SETUP_TOKEN 填入向导。没有设置环境变量时，服务会把一次性 token 打到容器日志：

docker compose logs ecs-controller

管理端口默认只绑定到本机。如需公网访问，请在前面配置 HTTPS 反向代理，并设置 ECS_COOKIE_SECURE=1；不要直接把管理端口暴露到公网。

迁移说明：Go 后端已覆盖鉴权、配置/账号持久化、兼容 action API、实例状态同步、启动/停止/释放、EIP 操作、异步 ECS 创建、ECS 库存/架构/系统盘预检、CMS 分钟级流量账本与 CDT fallback、阈值停机、定时开关机、保活、基础账单缓存、Webhook/Telegram/SMTP 测试通道、Telegram Bot 控制、Cloudflare DDNS、多实例记录编排、通知事件策略和任务补偿。BSS 价格预估仍未完整接入，真实阿里云、Cloudflare 线上验收仍需使用对应账号完成。

Go 版本验证

go test ./...
go test -race ./...
docker build -t ecs-controller-go:local .

ECS 创建接口现在是异步任务：create_ecs 返回 taskId，前端轮询 get_ecs_create_task。创建中途失败会清理已记录的 ECS/EIP 资源；真实阿里云费用、CDT 流量和 Cloudflare 联动仍应在接入对应账号后做线上验收。

🔑 获取阿里云密钥

为了让系统能够正常获取流量数据并管理实例，您需要准备具有相关权限的阿里云 AccessKey：

登录阿里云控制台，前往 RAM 访问控制 - 用户。
创建用户：点击“创建用户”，勾选“OpenAPI 调用访问”。
获取密钥：保存好生成的 AccessKey ID 和 AccessKey Secret。
添加权限：建议创建自定义 RAM 权限策略，按需授予最小权限。

核心功能最低权限

如果只使用实例同步、流量监控、自动停机、手动开关机和释放实例，至少需要：

cms:QueryMetricList
ecs:DescribeInstances
ecs:DescribeInstanceStatus
ecs:StartInstance
ecs:StopInstance
ecs:DeleteInstance
cdt:ListCdtInternetTraffic

其中 cms:QueryMetricList 用于授权调用 DescribeMetricList 获取 ECS 公网出口流量，缺少后会导致流量统计不可用或自动停机不准确。

全功能推荐权限

如果需要使用本项目的全部功能，包括一键创建 ECS、自动创建网络与安全组、EIP 申请/绑定/释放、更换公网 IP、消费情况查询，建议使用以下自定义策略：

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeRegions",
        "ecs:DescribeZones",
        "ecs:DescribeInstances",
        "ecs:DescribeInstanceStatus",
        "ecs:DescribeInstancesFullStatus",
        "ecs:DescribeInstanceTypes",
        "ecs:DescribeImages",
        "ecs:DescribeAvailableResource",
        "ecs:DescribeSecurityGroups",
        "ecs:StartInstance",
        "ecs:StopInstance",
        "ecs:DeleteInstance",
        "ecs:RunInstances",
        "ecs:CreateSecurityGroup",
        "ecs:AuthorizeSecurityGroup"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "vpc:DescribeVpcs",
        "vpc:DescribeVSwitches",
        "vpc:CreateVpc",
        "vpc:CreateVSwitch",
        "vpc:DescribeEipAddresses",
        "vpc:AllocateEipAddress",
        "vpc:AssociateEipAddress",
        "vpc:UnassociateEipAddress",
        "vpc:ReleaseEipAddress"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "cms:QueryMetricList"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "cdt:ListCdtInternetTraffic"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "bssapi:QueryAccountBalance",
        "bssapi:DescribeInstanceBill",
        "bssapi:QueryBillOverview"
      ],
      "Resource": "*"
    }
  ]
}

如果不需要消费情况展示，可以去掉 bssapi:* 相关权限。

✨ 核心功能

🛡️ 流量盾牌 (CDT 监控)

多账户聚合：支持同时管理多个阿里云 AK/SK，多区域实例一屏尽览。
自然月流量重置：自动适配阿里云 CDT 计费周期，每月 1 号零点自动重置已用流量统计。
熔断机制：支持设定 告警阈值 (如 95%)，触发时自动执行关机动作。
灵活关机模式：可选 普通停机 (KeepCharging) 或 节省停机 (StopCharging/释放计算资源停止计费)。

⚡ 自动化高阶管理

异步安全释放：彻底解决释放逻辑响应缓慢问题。点击后后台接管，自动执行“强制离线 -> 等待状态 -> 物理销毁”全流程，无需前台苦等。
抢占式实例保活：实时守护低成本 Spot 实例，检测到非预期停机时（如被回收）自动重试拉起。
定时任务清单：支持为指定实例设置每日定时开机、定时关机计划（自定义时间点）。
ECS 快速创建：支持从预设规格中一键拉起新实例（默认采用最低配置、最低价格方案），并自动配置安全组与防火墙规则。
预检与成本预览：创建前自动调用阿里云 API 进行库存预检与其费用估算，拒绝盲目下单。
初次登录信息保护：针对新建实例，系统仅在创建成功的瞬间展示初始密码，确保 AK/SK 与凭据安全。
DDNS 联动：深度集成 Cloudflare，实例重启 IP 变更后自动同步 A 记录。

📊 成本与审计

费用中心：实时拉取账号 可用余额，并预估当月实例已产生账单金额。
实时日志审计：详细记录系统心跳、API 调用状态、告警触发记录，支持分级清理，保证系统轻量运行。
一键同步：支持主动从阿里云云端同步最新机器规格、状态、公网 IP 等所有属性。

📢 预警系统

多通路覆盖：集成 Telegram (纸飞机)、SMTP 邮件 及 通用 Webhook 接口。
状态变更通知：实例关机、启动、释放成功、流量超标时均会发送详尽的富文本通知。

💡 省钱小秘籍 (Saving Tips)

流量熔断：系统默认检测到流量即将用尽时自动关机（建议配合“节省停机”模式），确保不产生额外扣费，真正做到“用完即止”。
折扣充值：本项目可搭配 portal.acm.ee 使用，享受阿里云七折充值优惠，叠加 CDT 200GB 免费流量，实现在线极致性价比。

📸 界面预览

以下截图来自测试环境，仅用于展示界面结构与核心流程。正式使用时请妥善保管 AK/SK、服务器密码、通知 Token 等敏感信息。

实例状态总览

卡片式展示所有已同步 ECS：运行状态、区域、实例编号、公网地址、出口流量、带宽峰值、阈值与最后同步时间一屏可见。

实例管理

集中管理账号下的全部实例，支持手动同步、启动、停止、释放，以及查看实例规格、出口流量和公网带宽。

账号管理

账号以列表方式维护，支持备注名、区域、站点、账号可用流量、消费情况与同步状态展示；新增账号使用弹窗填写，避免页面过长。

系统设置

全局阈值、实例同步频率、停机方式、自动开机、抢占式保活、费用分析、DDNS 与通知配置统一收纳到系统设置中。

系统日志

区分动作日志与心跳日志，方便排查接口调用、实例状态变化、流量熔断、DDNS 同步和通知推送结果。

一键创建 ECS

创建前会生成配置清单：实例规格、系统镜像、系统盘、网络、安全组、公网带宽与费用提示都会在确认前展示，避免盲目下单。

新增账号弹窗

账号录入通过弹窗完成，填写备注名、AK、区域、站点和账号可用流量后即可保存并同步实例。

🛠️ 技术架构

Backend: Go 单进程 HTTP 服务，内置 action API、任务 worker、监控 worker 和 Telegram 控制 worker。
Storage: SQLite 3 WAL，负责配置、账号、session、任务队列、流量账本、账单缓存和审计日志；敏感字段使用 SecretBox 加密。
Cloud adapter: 通过轻量 Alibaba RPC 客户端完成 ECS、VPC、EIP、CMS、CDT 和 BSS 调用，支持 fake/mock client 做离线测试。
Frontend: Vue 3 + 静态资源；Go 服务直接托管页面，并保留历史 index.php?action=... API 路径以兼容现有客户端。
Runtime: Docker/Colima/Linux Docker 均可运行；Compose 使用 named volume、非 root 应用用户和 /healthz 健康检查。

☕ 赏杯咖啡 (Donation)

如果您觉得这个工具对您有帮助，阔佬随手赏杯咖啡：

USDT-TRC20: TMBmXngHcKtNo9nLxTCJcGTfNutsbb9rp3
USDT-Polygon: 0x846ad38ed7159aee70b0ebd8ec39ad2d7b32835b
USDT-BSC: 0x846ad38ed7159aee70b0ebd8ec39ad2d7b32835b
USDT-ERC20: 0x846ad38ed7159aee70b0ebd8ec39ad2d7b32835b
USDT-ArbitrumOne: 0x846ad38ed7159aee70b0ebd8ec39ad2d7b32835b

📄 许可协议

本项目遵循 MIT License 开源协议。

Made with ❤️ for Aliyun Users

Based on CDT-Monitor

Description

阿里云 CDT 流量监控与自动化管理终极解决方案专为 MJJ 大佬设计。旨在最大化榨干阿里云 CDT 200GB 免费流量，集成流量实时监控、自动熔断保护、抢占式实例保活、实例规格与价格透明展示于一体。

Readme MIT 6 MiB

README.MD Unescape Escape

ecs-controller 🌩️

⚠️ 免责声明