从Colab到生产环境：分类模型云端部署完整路径-编程实验室

从Colab到生产环境：分类模型云端部署完整路径

引言

当你用Colab完成了一个分类模型的原型开发，看着测试集上漂亮的准确率数字，是不是已经迫不及待想把它变成真正的在线服务？但打开服务器管理面板时，那些陌生的术语和复杂的配置又让你望而却步。别担心，这篇文章就是为你准备的。

作为经历过这个阶段的老AI工程师，我完全理解你的困扰。Colab虽然方便，但存在三大痛点：运行时间限制、资源不稳定、无法长期提供服务。而传统服务器部署又需要掌握Docker、Nginx、负载均衡等DevOps技能，学习曲线陡峭。

好消息是，现在通过云端GPU平台提供的预置镜像，你可以像在Colab中一样简单操作，却能获得稳定的生产级服务。本文将手把手带你走完从Colab notebook到生产部署的全流程，所有步骤都经过实测验证，跟着做就能成功。

1. 环境准备：从Colab到云端的平滑过渡

1.1 模型导出与打包

首先确保你的Colab notebook中已经训练好模型。以PyTorch为例，典型导出流程如下：

import torch from torch.jit import trace # 假设model是你训练好的模型 model.eval() # 切换为推理模式 # 创建示例输入（需与真实输入维度一致） example_input = torch.rand(1, 3, 224, 224) # 假设是图像分类，3通道224x224 # 导出为TorchScript格式 traced_model = trace(model, example_input) traced_model.save("model.pt")

同时需要准备： - 模型推理代码（包含预处理/后处理） - 依赖库清单（requirements.txt） - 测试样本（用于部署后验证）

1.2 选择适合的GPU资源

根据模型复杂度和预期QPS（每秒查询量）选择GPU配置：

模型规模	参数量级	推荐显存	适用场景
小型	<10M	4-8GB	简单图像/文本分类
中型	10M-100M	8-16GB	中等复杂度任务
大型	>100M	16GB+	复杂分类任务

💡 提示：在CSDN算力平台创建实例时，可以直接选择预装了PyTorch环境的镜像，省去基础环境配置时间。

2. 一键部署生产服务

2.1 创建GPU实例

登录CSDN算力平台
选择"创建实例"
关键配置项：
镜像：选择PyTorch环境（如PyTorch 2.0 + CUDA 11.8）
GPU：根据上表选择
存储：建议50GB以上（存放模型和数据集）

2.2 上传模型文件

通过Web终端或SFTP上传你的模型文件：

# 创建项目目录 mkdir -p ~/classifier_service/{models,src} # 上传文件到对应目录 # models/ - 存放model.pt # src/ - 存放推理代码和requirements.txt

2.3 安装依赖

进入项目目录安装所需依赖：

cd ~/classifier_service pip install -r src/requirements.txt

3. 构建生产级API服务

3.1 使用FastAPI创建Web服务

创建一个简单的API服务（src/main.py）：

from fastapi import FastAPI, File, UploadFile import torch from PIL import Image import io import numpy as np app = FastAPI() # 加载模型 model = torch.jit.load("models/model.pt") model.eval() @app.post("/predict") async def predict(image: UploadFile = File(...)): # 读取并预处理图像 img_data = await image.read() img = Image.open(io.BytesIO(img_data)) # 这里添加你的预处理代码 input_tensor = preprocess_image(img) # 需要实现这个函数 # 推理 with torch.no_grad(): output = model(input_tensor) # 后处理 return {"predictions": postprocess(output)} # 需要实现postprocess

3.2 添加必要的预处理函数

在同一个文件中添加预处理逻辑：

def preprocess_image(img): # 示例预处理流程 img = img.resize((224, 224)) # 调整大小 img = np.array(img) / 255.0 # 归一化 img = (img - [0.485, 0.456, 0.406]) / [0.229, 0.224, 0.225] # 标准化 img = img.transpose(2, 0, 1) # HWC -> CHW return torch.FloatTensor(img).unsqueeze(0) # 添加batch维度

4. 服务优化与监控

4.1 使用Gunicorn提升性能

安装Gunicorn并优化配置：

pip install gunicorn

创建gunicorn_config.py：

workers = 4 # 通常设置为GPU数量的2-4倍 worker_class = "uvicorn.workers.UvicornWorker" bind = "0.0.0.0:8000" timeout = 120

4.2 启动服务

使用screen或tmux保持服务长期运行：

screen -S classifier gunicorn -c gunicorn_config.py src.main:app # 按Ctrl+A然后D退出screen会话

4.3 添加健康检查

修改main.py添加健康检查端点：

@app.get("/health") def health_check(): return {"status": "healthy", "gpu_available": torch.cuda.is_available()}

5. 测试与验证

5.1 本地测试

使用curl测试API：

curl -X POST -F "image=@test.jpg" http://localhost:8000/predict

5.2 暴露公网访问

在实例管理面板配置端口映射： 1. 找到"网络配置"选项 2. 添加8000端口映射 3. 获取公网访问地址（如http://123.45.67.89:8000）

5.3 压力测试（可选）

使用locust进行简单压力测试：

from locust import HttpUser, task class ClassifierUser(HttpUser): @task def predict(self): files = {"image": open("test.jpg", "rb")} self.client.post("/predict", files=files)

运行测试：