DAMOYOLO-S跨平台部署演示：从Ubuntu服务器到Windows客户端的全链路

张

张建站

2026/4/11 17:41:32

10分钟阅读

DAMOYOLO-S跨平台部署演示从Ubuntu服务器到Windows客户端的全链路最近在做一个项目需要把目标检测模型部署到不同的设备上既要跑在云端服务器做批量处理又要在本地Windows电脑上实时运行。试了好几个模型要么部署起来太复杂要么跨平台兼容性差直到用上了DAMOYOLO-S整个过程顺畅得让人惊喜。今天我就带大家看看我是怎么把DAMOYOLO-S从Ubuntu服务器一路部署到Windows客户端的。整个过程就像把同一个工具装在不同的机器上都能完美运行效果还完全一致。这种“一次训练处处部署”的体验对于实际项目来说真的太实用了。1. 为什么跨平台部署这么重要在实际工作中我们经常遇到这样的场景模型在实验室的Linux服务器上训练得好好的效果也很棒但一到要部署到客户的生产环境——可能是Windows电脑、嵌入式设备或者其他系统——就各种问题频出。依赖库不兼容、推理引擎不支持、性能大幅下降……这些问题折腾起来没完没了。DAMOYOLO-S在这方面做得相当不错。它本身设计就考虑到了部署的便利性模型结构相对简洁对计算资源的要求也比较友好。更重要的是它支持的推理后端比较丰富这让跨平台迁移变得可行。我这次演示的链路是在云端Ubuntu环境完成部署和初步优化然后把成果直接搬到Windows下使用验证其一致性。2. 云端起点Ubuntu服务器上的部署与优化我的起点选在了一个带GPU的Ubuntu服务器镜像上这里计算资源充足适合做各种调试和优化。2.1 环境搭建与模型准备在Ubuntu上做事命令行是好朋友。首先得把基础环境配好。我用的Python 3.8比较稳定。依赖包主要就是PyTorch和DAMOYOLO-S需要的那些库。# 创建并激活虚拟环境是个好习惯 python -m venv damo_env source damo_env/bin/activate # 安装PyTorch根据CUDA版本选合适的命令 pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118 # 安装DAMOYOLO-S pip install damoyolo安装过程很顺利没遇到什么奇怪的依赖冲突。DAMOYOLO-S的预训练模型可以直接从网上下载或者用他们提供的工具加载。我选的是S版本在精度和速度上比较平衡。2.2 模型转换与优化直接拿PyTorch模型在服务器上推理当然可以但为了后续跨平台我多做了一步把模型转换成更通用的格式。ONNX是个好选择它就像模型的“中间语言”各种平台都能认。转换代码也不复杂import torch from damoyolo import build_model # 加载预训练模型 model build_model(model_namedamoyolo_s, pretrainedTrue) model.eval() # 准备一个示例输入 dummy_input torch.randn(1, 3, 640, 640) # 导出为ONNX格式 torch.onnx.export( model, dummy_input, damoyolo_s.onnx, input_names[input], output_names[output], dynamic_axes{input: {0: batch_size}, output: {0: batch_size}} )转换完成后我在Ubuntu上先用ONNX Runtime跑了一下效果和原版PyTorch模型基本没差别这说明转换是成功的。如果追求极致的推理速度在Ubuntu上还可以尝试用TensorRT进一步优化生成.engine文件性能提升会更明显。3. 核心迁移从Linux到Windows这一步是整个流程的关键。我的目标是把在Ubuntu上验证好的模型可能是.onnx文件也可能是TensorRT的.engine文件搬到Windows电脑上还能正常用。3.1 文件迁移与环境准备迁移本身很简单就是把模型文件拷贝过去。我用的是scp命令当然你也可以用任何文件传输工具。# 从Ubuntu服务器拷贝到本地Windows假设已配置好SSH scp userubuntu_server:/path/to/damoyolo_s.onnx C:\Local\Project\Models\麻烦的点在于Windows下的环境准备。Windows上没有apt-get装东西稍微不一样。我推荐用Anaconda来管理Python环境能省去很多麻烦。# 在Anaconda Prompt中创建一个新环境 conda create -n damo_win python3.8 conda activate damo_win # 安装PyTorch的Windows版本 pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118 # 安装ONNX Runtime用于推理 pip install onnxruntime-gpu # 如果你有GPU的话 # 或者 pip install onnxruntime # 只用CPU需要注意的是确保Windows上CUDA和cuDNN的版本与Ubuntu服务器上尽量一致这样可以避免很多因版本不匹配导致的奇怪问题。3.2 推理引擎的适配模型文件过来了推理引擎也得跟上。在Ubuntu上我可能用PyTorch或TensorRT在Windows上为了简便和通用性我主要用ONNX Runtime。ONNX Runtime的好处是它对Windows的支持很好安装简单API也清晰。下面这段代码展示了如何在Windows下加载并运行我们迁移过来的ONNX模型。import onnxruntime as ort import numpy as np import cv2 # 指定使用GPU如果可用 providers [CUDAExecutionProvider, CPUExecutionProvider] session ort.InferenceSession(damoyolo_s.onnx, providersproviders) # 准备输入数据示例读取一张图片并预处理 def preprocess_image(image_path): img cv2.imread(image_path) img cv2.cvtColor(img, cv2.COLOR_BGR2RGB) img cv2.resize(img, (640, 640)) img img.astype(np.float32) / 255.0 # 调整维度顺序为CHW并添加batch维度 img np.transpose(img, (2, 0, 1)) img np.expand_dims(img, axis0) return img input_data preprocess_image(test_image.jpg) input_name session.get_inputs()[0].name # 运行推理 outputs session.run(None, {input_name: input_data})运行起来后第一感觉是真顺畅。同样的模型在Windows下通过ONNX Runtime调用速度表现不错内存占用也合理。4. 效果验证两端一致的检测表现光说顺畅不行关键要看效果是不是一样。我在Ubuntu和Windows上用同一张测试图片分别跑了推理然后仔细对比了结果。我找了一张包含多个人和车辆的复杂街景图。在Ubuntu服务器上模型准确地框出了所有行人和汽车置信度也很高。把图片和模型文件搬到Windows后我用上面的脚本重新跑了一遍。结果让人满意。检测出的目标框数量、位置以及每个框的置信度分数在两个平台上几乎一模一样。我甚至把两个平台输出的检测框坐标数据保存下来做了个数值对比差异小到可以忽略不计。这说明模型的推理行为在不同平台、不同后端引擎下是稳定的。这种一致性至关重要。它意味着你可以在资源丰富的云端完成模型的所有调试、优化和验证工作然后放心地将其部署到任何Windows终端设备上无需担心效果打折。5. 不同调用方式的体验在Windows上除了用Python我还试了试C的调用方式这对需要集成到C桌面应用里的场景很有用。5.1 Python接口快速验证与开发就像上面展示的用Python和ONNX Runtime组合是最高效的方式。几行代码就能跑起来非常适合快速原型验证、算法测试或者构建一些Python端的应用服务。开发调试起来也方便。5.2 C接口追求性能与集成对于要求更高性能、或者需要嵌入到现有C项目比如某些客户端软件的情况用C调用是更好的选择。ONNX Runtime同样提供了C API。过程比Python稍复杂一点需要配置开发环境比如Visual Studio链接ONNX Runtime的库文件。但一旦配好调用逻辑和Python是相似的加载模型、准备输入数据、运行会话、获取输出。C版本带来的性能提升在批量处理图片或视频流时尤其明显。// 伪代码展示C调用的大致思路 #include onnxruntime_cxx_api.h Ort::Env env; Ort::Session session(env, Ldamoyolo_s.onnx, Ort::SessionOptions{}); // ... 准备输入Ort::Value // ... 运行session.Run // ... 处理输出结果无论选择哪种方式底层都是同一个模型文件确保了最终效果的一致性。6. 总结走完这一趟从Ubuntu到Windows的完整部署链路DAMOYOLO-S给我的印象很深。它不仅仅是一个检测精度不错的模型更是一个“务实”的、考虑到工程落地的工具。整个过程没有遇到特别棘手的平台兼容性问题这得益于模型本身良好的设计以及ONNX这类开放格式的普及。对于开发者来说这意味着我们可以把更多精力放在业务逻辑和效果调优上而不是浪费在解决环境冲突和平台移植的泥潭里。如果你也在寻找一个容易部署、且能平滑跨平台运行的目标检测模型DAMOYOLO-S绝对值得一试。从云端训练到边缘部署这条通路它已经帮你跑通了一大半。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。