一个完整的 Django 应用模板，支持快速部署到 CloudBase 平台。
- Python 3.10 或更高版本
- 了解基本的 Python 虚拟环境使用
- 腾讯云账号并开通了 CloudBase 服务
- 基本的 Python 和 Django 开发知识
📋 详细指南：完整的项目创建步骤请参考 Django 项目创建指南
# 快速创建（基础步骤）
mkdir cloudrun-django && cd cloudrun-django
python -m venv env
source env/bin/activate # Windows: env\Scripts\activate
pip install Django==5.2.10 psycopg2-binary==2.9.11
django-admin startproject cloudrun .
python manage.py startapp api# 启动开发服务器
python manage.py runserver 0.0.0.0:8080
# 访问应用
open http://localhost:8080cloudrun-django/
├── manage.py # Django 管理脚本
├── cloudrun/ # Django 项目配置
│ ├── __init__.py
│ ├── settings.py # 项目设置
│ ├── urls.py # 主 URL 配置
│ └── wsgi.py # WSGI 配置
├── api/ # API 应用
│ ├── __init__.py
│ ├── models.py # 数据模型
│ ├── views.py # 视图函数
│ └── urls.py # API URL 配置
├── requirements.txt # Python 依赖文件
├── .gitignore # Git 忽略文件
├── env/ # 虚拟环境（本地开发用）
├── scf_bootstrap # HTTP 云函数启动脚本
├── Dockerfile # 云托管容器配置
└── .dockerignore # Docker 忽略文件
| 特性 | HTTP 云函数 | 云托管 |
|---|---|---|
| 计费方式 | 按请求次数和执行时间 | 按资源使用量（CPU/内存） |
| 启动方式 | 冷启动，按需启动 | 持续运行 |
| 适用场景 | API 服务、轻量级应用 | 企业级应用、复杂 Web 应用 |
| 端口要求 | 固定 9000 端口 | 可自定义端口（默认 8080） |
| 扩缩容 | 自动按请求扩缩 | 支持自动扩缩容配置 |
| Python 环境 | 预配置 Python 运行时 | 完全自定义 Python 环境 |
- 选择 HTTP 云函数：轻量级 API 服务、间歇性访问、成本敏感
- 选择云托管：企业级应用、复杂 Web 应用、需要更多控制权
适合轻量级应用和 API 服务，按请求计费，冷启动快。
重要提醒：云函数运行时目录不允许写文件，因此不能使用 SQLite 数据库。
快速部署步骤：
- 创建
scf_bootstrap启动脚本 - 配置外部数据库连接
- 包含虚拟环境目录
- 通过 CloudBase 控制台上传部署
适合企业级应用，支持更复杂的部署需求，容器化部署。
快速部署步骤：
- 创建
Dockerfile容器配置 - 配置
.dockerignore文件 - 设置数据库和静态文件
- 通过 CloudBase 控制台或 CLI 部署
本模板包含以下 RESTful API 接口：
GET /health/GET /api/users/ # 获取用户列表（支持分页）
GET /api/users/1/ # 获取单个用户
POST /api/users/create/ # 创建用户
PUT /api/users/1/update/ # 更新用户
DELETE /api/users/1/delete/ # 删除用户# 健康检查
curl https://your-app-url/health/
# 获取用户列表
curl https://your-app-url/api/users/
# 创建新用户
curl -X POST https://your-app-url/api/users/create/ \
-H "Content-Type: application/json" \
-d '{"name":"测试用户","email":"test@example.com"}'- HTTP 云函数：禁止使用 SQLite，必须配置外部数据库
- 云托管：支持各种数据库，推荐 PostgreSQL
- HTTP 云函数：必须使用 9000 端口
- 云托管：推荐使用 8080 端口，支持自定义
- HTTP 云函数：需要
scf_bootstrap启动脚本和env目录 - 云托管：需要
Dockerfile和.dockerignore
- 轻量级应用：选择 HTTP 云函数
- 企业级应用：选择云托管
- 成本敏感：选择 HTTP 云函数
- 需要持续运行：选择云托管
# 数据库和工具
pip install psycopg2-binary dj-database-url python-dotenv
# 静态文件处理
pip install whitenoise
# 生产服务器
pip install gunicorn
# API 开发
pip install djangorestframework创建 .env 文件：
DEBUG=True
SECRET_KEY=your-secret-key
DB_HOST=your-database-host
DB_NAME=cloudrun_django
DB_USER=your-username
DB_PASSWORD=your-password- 数据库集成：支持 PostgreSQL、MySQL 等
- 身份验证：JWT 认证实现
- API 文档：Django REST Framework 文档生成
- 缓存策略：Redis 缓存集成
- 异步支持：Django 4.1+ 异步视图
- 监控告警：性能监控和日志分析
- Django 项目创建指南 - 从零开始创建项目
- HTTP 云函数部署指南 - 云函数部署详细步骤
- 云托管部署指南 - 云托管部署详细步骤
本项目采用 MIT 许可证。详情请查看 LICENSE 文件。
需要帮助？
- 查看 HTTP 云函数部署指南
- 查看 云托管部署指南
- 访问 CloudBase 官方文档