CloudLens | 多云资源治理与分析平台

统一视图 · 智能分析 · 安全合规 · 降本增效

快速开始 | 核心能力 | 技术架构 | 在线文档

---

🚀 项目简介

CloudLens 是一款专为 FinOps 和安全团队打造的企业级多云治理平台。它集成了强大的 CLI 命令行工具 和极致体验的 Web 可视化界面，旨在解决云原生时代的资源散乱、成本失控与合规难题。

为什么选择 CloudLens?

• 统一抽象：通过标准化的数据模型，一个界面通管 阿里云、腾讯云 及 AWS。
• AI 赋能：利用 Prophet 机器学习模型预测 90 天成本趋势，洞察折扣异常。
• 安全加固：深度适配 CIS Benchmark 基线检查，毫秒级识别公网暴露风险。
• 极客性能：基于 Python 并发 SDK 架构，配合 MySQL 智能缓存实现海量资源秒级加载。

---

🔥 核心能力

功能模块	描述	技术亮点
智能分析	识别闲置资源与降本机会	多指标复合阈值引擎
成本预测	预测未来 3 个月成本走向与区间	Prophet 机器学习模型
安全审计	CIS 合规性检查与 IAM 审计	自动化安全扫描路径
统一终端	现代响应式看板，支持中英双语	Next.js 14 + Tailwind CSS
报告引擎	导出专业级 Excel/HTML/JSON 报告	并行数据聚合与渲染

---

🛠️ 快速开始

3步快速启动（统一流程）

# 1. 下载代码
git clone https://github.com/songqipeng/cloudlens.git
cd cloudlens

# 2. 配置环境变量（至少配置AI API密钥）
cp .env.example .env
# 编辑 .env，添加：ANTHROPIC_API_KEY=your_key

# 3. 一键启动（自动检测架构、拉取镜像、启动服务）
./scripts/start.sh

等待 30-60 秒，然后访问：http://localhost:3000

💡 提示: start.sh 脚本会自动：

• 检测代码是否有更新（自动询问是否拉取）
• 检测您的系统架构（ARM64/AMD64）
• 检测运行中的服务（自动询问是否重启）
• 拉取或构建相应平台的镜像
• 启动所有服务

📖 详细指南: 快速开始指南

---

💻 本地开发（可选）

如果您需要修改代码并实时看到效果，可以设置本地开发环境：

# 安装依赖
pip install -r requirements.txt
cd web/frontend && npm install && cd ../..

# 启动数据库（使用 Docker）
docker run -d --name cloudlens-mysql \
  -e MYSQL_ROOT_PASSWORD=cloudlens_root_2024 \
  -e MYSQL_DATABASE=cloudlens \
  -e MYSQL_USER=cloudlens \
  -e MYSQL_PASSWORD=cloudlens123 \
  -p 3306:3306 mysql:8.0

# 初始化数据库
sleep 10
mysql -u cloudlens -pcloudlens123 cloudlens < migrations/init_mysql_schema.sql
mysql -u cloudlens -pcloudlens123 cloudlens < migrations/add_chatbot_tables.sql
mysql -u cloudlens -pcloudlens123 cloudlens < migrations/add_anomaly_table.sql

# 启动开发服务（支持热重载）
# 终端1 - 后端
cd web/backend && python3 -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload

# 终端2 - 前端
cd web/frontend && npm run dev

📖 详细开发指南: 开发者快速开始指南（可选参考）

---

📋 CLI 命令行操作（可选）

# 配置云账号
./cl config add --provider aliyun --name prod --region cn-hangzhou --ak YOUR_AK --sk YOUR_SK

# 使用CLI命令
./cl analyze idle --account prod       # 扫描闲置资源
./cl analyze security --cis --account prod # 安全合规检查
./cl analyze forecast --days 90        # AI 预测未来支出

---

✅ 验证安装

# 检查后端健康
curl http://localhost:8000/health

# 访问前端
# 浏览器打开: http://localhost:3000

🔄 更新到最新版本

cd cloudlens
./scripts/start.sh

脚本会自动：

• ✅ 检测代码是否有更新（自动询问是否拉取）
• ✅ 检测运行中的服务（自动询问是否重启）
• ✅ 拉取最新镜像
• ✅ 启动服务

📖 详细更新指南: 查看 更新指南

---

📚 相关文档

• 快速开始指南 ⭐ 必读
• 更新指南 - 如何更新到最新版本
• Q1功能使用指南 - Q1功能详细说明
• 本地测试指南 - 详细测试步骤
• 开发者快速开始指南 - 本地开发环境（可选）

---

🏗️ 技术架构

CloudLens 为规模化运行而生：

• 核心层：标准化 Python 包结构，采用 Provider 设计模式。
• 性能层：基于 Concurrent.futures 的多账号并发 SDK 调用。
• 存储层：MySQL 强持久化数据与 24 小时自动 TTL 缓存机制。
• 展现层：Next.js 14 实现的毛玻璃风格 UI，深度集成国际化支持。

---

📖 文档与规划

• 官方首页 & 文档中心
• 视频演示教程
• 2026 综合路线图
• Q1功能使用指南 ⭐ 新功能详细使用说明（AI Chatbot、异常检测、预算管理）

---

🤝 参与贡献

我们欢迎任何形式的贡献！请阅读 贡献指南 了解更多。

---

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

让云治理更简单、更高效。