概述
云托管（Tencent CloudBase Run）是新一代云原生应用引擎，支持托管用任意语言和框架编写的容器化应用。无需关心服务器运维，即可快速部署和运行您的应用，享受自动弹性伸缩、按量计费的云服务体验。
💡 为什么选择云托管？
传统应用部署需要购买服务器、配置环境、处理运维问题，而云托管让您：
- 专注业务开发：无需关心底层基础设施，将精力投入到产品创新
- 快速上线应用：从代码到上线只需几分钟，支持多种部署方式
- 降低运营成本：按实际使用付费，流量低谷时自动缩容到 0，避免资源浪费
- 应对流量波动：自动扩缩容应对突发流量，保障服务稳定性
- 服务资源集成 - 与数据库、存储、腾讯云资源无缝集成
🎯 适用场景
云托管适合各类 Web 应用和后端服务：
- Web 应用：企业官网、电商平台、管理后台、SaaS 服务
- API 服务：RESTful API、微服务架构
- 实时应用：WebSocket 服务、SSE 推送、实时通讯
- 定时任务：数据处理、报表生成、定时同步
- AI 应用：模型推理服务、智能客服、内容生成
如果您是首次使用云托管，建议先阅读 快速开始 文档，5 分钟快速体验云托管的核心功能。
使用 AI 开发、对接和管理云托管服务
核心特性
🚀 零运维，开箱即用
无需购买、配置、维护服务器，平台自动处理：
- 服务器资源调度与管理
- 操作系统更新与安全补丁
- 负载均衡与健康检查
- SSL 证书自动续期
实际收益：运维成本降低 80%，让 2 人团队也能运营大规模应用。
📈 智能弹性伸缩
根据实际负载自动调整实例数量：
- 流量高峰：秒级扩容，最多支持 n 个实例
- 流量低谷：自动缩容到 0，不产生费用
- 灵活策略：支持基于 CPU、内存、并发数的扩缩容规则
- 定时伸缩：工作时间保持实例，非工作时间自动释放
实际收益：某电商应用在促销期间自动扩容应对 10 倍流 量，活动结束后自动缩容，成本节省 60%。
💰 按量计费，用多少付多少
- 精细计费：最小粒度 0.25 核 0.5GB，按秒计费
- 零流量零费用：无请求时缩容到 0，不产生计算费用
- 透明可控：实时查看资源使用和费用明细
- 成本优化：支持预留实例，长期使用更优惠
实际收益：相比传统云主机，中小型应用平均节省 50-70% 成本。
🛠️ 全栈语言支持
支持任意语言和框架，只要能容器化就能部署：
- Node.js：Express、Nest.js、Next.js、Koa
- Python：Flask、Django、FastAPI
- Java：Spring Boot、Quarkus
- Go：Gin、Echo、Fiber
- PHP：Laravel、ThinkPHP、Symfony
- .NET：ASP.NET Core
- 其他：Ruby、Rust、Elixir 等
🔄 多种部署方式
灵活选择最适合您的部署方式：
| 部署方式 | 适用场景 | 优势 |
|---|---|---|
| 代码部署 | 快速原型、小型项目 | 无需编写 Dockerfile，平台自动构建 |
| 镜像部署 | 生产环境、复杂应用 | 完全控制构建过程，支持私有镜像仓库 |
| Git 部署 | 团队协作、持续集成 | 代码推送自动部署，支持 GitHub/GitLab/Gitee |
| Cli 部署 | 快速部署、持续集成 | 云开发官方提供的命令行工具，帮助您快速管理和部署云开发资源 |
技术选型指南
云开发平台提供多种计算服务，满足不同场景需求。本节帮助您选择最适合的技术方案。
🤔 如何选择？
选择云托管，如果您：
- ✅ 需要使用 Java、Go、PHP、.NET 等非 Node.js 语言
- ✅ 有现有应用需要迁移上云
- ✅ 需要长连接支持（WebSocket、SSE）
- ✅ 需要高并发处理能力
- ✅ 需要访问 VPC 内资源（Redis、MySQL 等）
- ✅ 需要完全控制运行环境和依赖
选择云函数，如果您：
- ✅ 开发简单的 API 接口或定时任务
- ✅ 需要事件驱动（URL、MQ 触发）
- ✅ 追求极简部署，无需关心容器
- ✅ 需要访问 VPC 内资源（Redis、MySQL 等）
- ✅ 流量极低，希望最大化节省成本
📊 详细对比
| 对比维度 | 事件函数 | HTTP 函数 | 函数型开发框架 | 云托管 ⭐ |
|---|---|---|---|---|
| 概述 | 事件函数 | HTTP 函数 | 函数型开发框架 | 云托管 |
| 设计思想 | 纯托管 FaaS 事件驱动 | Serverless Web HTTP 直连 | Node.js 函数框架 部署在云托管 | 云原生应用引擎 容器化托管 |
| 核心场景 | 对象存储、消息队列 定时任务等非 HTTP 业务 | Web 建站、API 服务 HTTP/SSE/WebSocket | Node.js 环境服务 HTTP/SSE/WebSocket | 任意语言/框架 微服务、Web 应用 HTTP/SSE/WebSocket |
| 触发方式 | 定时、MQ、COS 云 API 等多种触发器 | HTTP URL WebSocket / SSE | HTTP URL WebSocket / SSE | HTTP URL WebSocket / SSE |
| 编程范式 | JSON 入参 (event/context) | 原生 Request HTTP / WebSocket | JSON 入参 (event/context) | 原生 Request HTTP / WebSocket |
| 运行时 | 固定语言版本 或镜像自定义 | 固定语言版本 或镜像自定义 | 仅 Node.js | 任意语言版本/环境 |
| 部署方式 | 模板/代码/镜像 | 模板/代码/镜像 | 模板 | 模板/代码/镜像/Git |
| 端口监听 | ❌ 无需配置 | ✅ 需监听 9000 | ✅ 需监听 3000 | ✅ 自定义端口 |
| 启动文件 | ⚠️ 代码部署不支持自定义 镜像支持 | ⚠️ 代码部署不支持自定义 镜像支持 | ❌ 不支持自定义 | ✅ 支持自定义 |
| Dockerfile | ❌ 不感知 | ⚠️ 仅镜像部署时感知 | ❌ 不感知 | ✅ 完全支持 |
| 本地调试 | ❌ 不支持 | ✅ 支持 | ✅ 支持 | ✅ 支持 |
| 冷启动 | 存在冷启动延迟 | 存在冷启动延迟 | 可配最小实例常驻 (几乎无延迟) | 可配最小实例常驻 (几乎无延迟) |
| 并发支持 | ❌ 不支持 (单并发) | ✅ 支持多并发 | ✅ 支持多并发 | ✅ 支持多并发 |
| 云开发数据库 | ❌ 内网网络不通 | ❌ 内网网络不通 | ✅ 内网连通 (需开启私有网络) | ✅ 内网连通 (需开启私有网络) |
| VPC 访问 | ❌ 不支持 | ❌ 不支持 | ✅ 支持 | ✅ 支持 |
| 适合团队 | 个人开发者 | 个人/小团队 | Node.js 开发者 | 所有开发团队 |
对于大多数 Web 应用和后端服务，云托管是最佳选择，提供最大的灵活性和可扩展性。
资源模型
云托管采用三层资源模型：服务 → 版本 → 实例，提供灵活的部署和管理能力。
📦 服务（Service）
服务是您的业务单元，通常对应一个独立的应用或微服务。
特点：
- 每个服务有独立的访问域名（支持自定义域名）
- 独立的配置和资源限制
- 独立的日志和监控
示例场景：
user-service：用户管理服务order-service：订单处理服务api-gateway：API 网关服务
🔖 版本（Revision）
版本是服务的不同部署版本，支持多版本并存。
特点：
- 每次部署创建新版本，版本不可变
- 支持流量分配，实现灰度发布
- 可快速回滚到历史版本
示例场景：
- 灰度发布：v1 版本 90% 流量，v2 版本 10% 流量
- A/B 测试：v1 和 v2 各 50% 流量，对比效果
- 蓝绿部署：新版本验证通过后，一键切换 100% 流量
🖥️ 实例（Instance）
实例是实际运行的容器，数量根据负载自动伸缩。
特点：
- 每个实例是一个独立的容器
- 自动健康检查，异常实例自动重启
- 支持 0 ～ n 个实例弹性伸缩
示例场景：
- 低流量时：0-1 个实例，成本最低
- 正常流量：2-5 个实例，保障稳定性
- 高峰流量：自动扩容到 10+ 个实例
🏗️ 架构示意图
上图展示了三个服务（TestA、TestB、TestC）的资源模型。每个服务包含多个版本，每个版本运行 0 ～ N 个实例。
🌐 访问与流量分配
域名访问：
- 默认域名：
{service-name}-{random}.{region}.app.tcloudbase.com - 自定义域名：支持绑定您的域名，自动配置 SSL 证书
流量分配策略：
| 策略 | 说明 | 适用场景 |
|---|---|---|
| 单版本 100% | 所有流量到一个版本 | 生产环境稳定运行 |
| 按比例分配 | 多版本按百分比分配流量 | 灰度发布、A/B 测试 |
| URL 参数路由 | 根据 URL 参数路由到指定版本 | 内部测试、特定用户 |
自动伸缩机制：
请求量增加 → 触发扩容条件 → 启动新实例 → 加入负载均衡
请求量减少 → 触发缩容条件 → 停止空闲实例 → 释放资源
- 扩容速度：秒级启动新实例
- 缩容策略：实例空闲 30 分钟后自动回收
- 最小实例：可配置最小实例数，避免冷启动
服务运行模式
云托管提供 5 种运行模式，满足不同业务场景的需求。
🔄 始终自动扩缩容（推荐）
特点：根据 CPU、内存、并发数等指标自动调整实例数量
适用场景：
- 流量波动较大的应用
- 成本敏感的项目
- 新上线的应用（流量不确定）
配置示例：
最小实例数: 0
最大实例数: 10
扩容条件: CPU > 60% 或 并发数 > 100
缩容条件: CPU < 30% 且 并发数 < 50
成本优势：无流量时缩容到 0，成本最低。
🏃 持续运行
特点：保持固定数量的实例持续运行
适用场景：
- 流量稳定的生产应用
- 对响应时间要求极高（无冷启动）
- 需要保持长连接或内存状态
配置示例：
实例副本数: 3
性能优势：无冷启动，响应速度最快。
🌓 白天持续运行，夜间自动扩缩容
特点：工作时间保持固定实例，非工作时间自动伸缩
适用场景：
- 办公类应用（工作日 9:00-18:00 流量高）
- 电商应用（白天流量高，夜间流量低）
- 教育类应用（上课时间流量高）
配置示例：
工作时间: 09:00-18:00
固定实例数: 5
非工作时间: 18:00-09:00
最小实例数: 0
最大实例数: 10
成本优势：兼顾性能和成本，夜间自动缩容节省费用。
⚙️ 自定义
特点：灵活配置自动扩缩容和定时扩缩容策略
适用场景：
- 有特殊业务规律（如每周一流量高峰）
- 需要精细化成本控制
- 多种策略组合使用
配置示例：
策略 1 - 自动扩缩容:
最小实例数: 1
最大实例数: 20
扩容条件: CPU > 70%
策略 2 - 定时扩容:
时间: 每周一 08:00
实例数: 10
策略 3 - 定时缩容:
时间: 每周一 20:00
实例数: 2
🖐️ 手工启停实例
特点：完全手动控制实例数量
适用场景：
- 开发测试环境
- 临时演示环境
- 需要完全可控的场景
操作方式：通过控制台或 API 手动调整实例数量。
📊 运行模式对比
| 运行模式 | 成本 | 性能 | 灵活性 | 推荐场景 |
|---|---|---|---|---|
| 始终自动扩缩容 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | 流量波动大的应用 |
| 持续运行 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ | 生产环境稳定应用 |
| 白天持续夜间自动 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | 办公/电商类应用 |
| 自定义 | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 复杂业务场景 |
| 手工启停 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐ | 开发测试环境 |
资源集成
云托管深度集成 CloudBase 和腾讯云生态，让您轻松构建功能完整的应用。
🗄️调用MySQL数据库
云托管提供了多种方式连接和操作 MySQL 数据库，满足不同场景下的应用需求。本文档将详细介绍以下几种连接方式：
🔗 私有网络（VPC）
通过配置 VPC 网络，云托管实例可以访问 VPC 内的各种资源：
- Redis：缓存、会话存储
- MySQL/PostgreSQL：关系型数据库
- Elasticsearch：全文搜索
- Kafka：消息队列
- 其它腾讯云资源产品：其它腾讯云资源产品
配置步骤：
- 在服务设置中开启「私有网络」
- 选择目标 VPC 和子网
- 配置安全组规则
- 重新部署服务生效
🗄️调用云开发资源
在云托管中可以便捷地调用云开发的各种资源，包括数据库、云存储等。目前可以使用 HTTP API来集成调用，node-sdk 建设中 (敬请期待)
🚀 持 续交付（CI/CD）
支持从代码仓库自动部署，实现 DevOps 最佳实践。
支持的代码仓库：
- GitHub
- GitLab
- Gitee（码云） 工作流程：
代码推送 → 自动触发构建 → 运行测试 → 构建镜像 → 自动部署
配置方式：
- 在服务设置中绑定代码仓库
- 选择分支和构建配置
- 推送代码自动触发部署
支持基于Cli来部署，来实现命令行部署
支持的能力如下：
📊 可观测性
日志服务
- 实时查看容器日志
- 支持关键词搜索、时间筛选
- 支持上传到 CLS（日志服务）
访问路径：[服务详情] → [日志] → 选择实例和时间范围
监控指标
- 资源监控：CPU、内存、网络、磁盘
- 业务监控：QPS、响应时间、错误率
- 实例监控：实例数量、健康状态
- 自定义监控：支持上报自定义指标
访问路径：[服务详情] → [监控] → 查看各项指标