ecs-controller 🌩️

阿里云 CDT 流量监控与自动化管理终极解决方案

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

⚠️ 免责声明

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

---

🚀 快速部署

方式一：Docker Compose (推荐)

这是最省心的部署方案，内置了自动化的定时任务巡检，无需额外配置 Crontab。

1. 新建配置文件 docker-compose.yml：

services:
  ecs-controller:
    image: kori1c/ecs-controller:latest
    container_name: ecs-controller
    restart: always
    ports:
      - "43210:80"
    volumes:
      - ./data:/var/www/html/data
    environment:
      - TZ=Asia/Shanghai

2. 启动服务：

docker-compose up -d

访问 http://localhost:43210 即可开始使用。

---

🔑 获取阿里云密钥

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

1. 登录阿里云控制台，前往 RAM 访问控制 - 用户。
2. 创建用户：点击“创建用户”，勾选“OpenAPI 调用访问”。
3. 获取密钥：保存好生成的 AccessKey ID 和 AccessKey Secret。
4. 添加权限：为该用户添加以下三个权限策略（必须包含）：
   • AliyunECSFullAccess：用于查看实例状态、开关机及释放。
   • AliyunBSSFullAccess：用于查询账号余额及消费账单。
   • AliyunCDTFullAccess：用于获取 CDT 流量实时统计信息。

---

✨ 核心功能

🛡️ 流量盾牌 (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 免费流量，实现在线极致性价比。

---

📸 界面预览

汇总监控

系统配置

实例生命周期管理

---

🛠️ 技术架构

• Backend: 原生 PHP 8.1+，无框架依赖，追求极致性能。
• Database: SQLite 3 (WAL 模式)，兼顾轻量与读写并发。
• Frontend: Vue 3.x (SFC 理念) + 原生 Vanilla CSS。
• SDK: Alibaba Cloud SDK for PHP (V1)。

---

☕ 赏杯咖啡 (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