YOLO12 目标检测模型的 WebUI 快速部署方案。内容包括系统环境要求、一键部署脚本的使用、Web 界面操作指南（支持点击与拖拽上传）、RESTful API 接口调用方法以及支持的 80 种 COCO 物体类别。此外，文章还涵盖了常见问题排查、模型版本切换及服务管理命令，帮助用户在几分钟内搭建起功能完整的物体识别服务。
让计算机像人眼一样快速识别图片中的物体，从自动驾驶汽车识别行人，到工厂流水线检测产品缺陷，目标检测技术正在改变我们的生活。而在众多检测模型中，YOLO 系列一直以其'又快又准'的特点备受青睐。
YOLO12 作为该系列的最新成员，在 2025 年初由纽约州立大学布法罗分校与中国科学院大学团队联合发布。这个以注意力机制为核心的实时目标检测模型，在保持 YOLO 系列高速推理优势的同时，进一步提升了检测精度。
本文将带你快速部署一个基于 YOLO12 的 WebUI 目标检测服务。无需深厚的 AI 背景，只要跟着步骤操作，你就能拥有一个功能完整的物体识别系统。
在开始之前，请确保你的系统满足以下基本要求：
部署过程非常简单，只需要几个命令就能完成：
# 创建项目目录
mkdir yolo12-webui && cd yolo12-webui
# 下载部署脚本
wget https://example.com/deploy-yolo12.sh
# 添加执行权限
chmod +x deploy-yolo12.sh
# 运行部署脚本
./deploy-yolo12.sh
部署脚本会自动完成以下工作：
整个过程大约需要 3-5 分钟，具体时间取决于你的网络速度。
部署完成后，打开浏览器访问以下地址：
http://你的服务器 IP:8001
你会看到一个简洁直观的 Web 界面，主要分为三个区域：
方式一：点击上传
方式二：拖拽上传
检测完成后，你会看到：
举个例子，如果你上传一张街景图片，可能会看到：
除了 Web 界面，YOLO12 还提供了 RESTful API 接口，方便开发者集成到自己的应用中。
检查服务是否正常运行：
curl http://localhost:8001/health
返回结果：
{
"status": "ok",
"model": "yolov12n.pt"
}
通过 API 进行图片检测：
curl -F "file=@your_image.jpg" http://localhost:8001/predict
返回结果示例：
{
"filename": "your_image.jpg",
"detections": [
{
"class_id": 0,
"class_name": "person",
"confidence": 0.9234,
"bbox": [320, 240, 100, 200]
}
],
"count": 1
}
bbox 参数说明：[x, y, w, h] 格式，其中：
x, y：边界框中心点坐标w, h：边界框的宽度和高度YOLO12 基于 COCO 数据集训练，支持 80 种常见物体的检测，包括：
| 类别分组 | 具体物体 |
|---|---|
| 人物 | person |
| 车辆 | car, bus, truck, motorcycle, bicycle |
| 动物 | dog, cat, bird, horse, sheep, cow |
| 家居物品 | chair, sofa, bed, dining table |
| 电子产品 | laptop, mouse, remote, keyboard, cell phone |
| 餐具 | bottle, cup, fork, knife, spoon, bowl |
这意味着 YOLO12 可以识别日常生活中绝大多数常见物体，满足大多数应用场景的需求。
如果上传图片后没有检测到任何物体，可能是以下原因：
YOLO12 提供多种规模的模型，满足不同需求：
# 编辑配置文件 /root/yolo12/config.py
MODEL_NAME = "yolov12n.pt" # 最快，精度较低
# MODEL_NAME = "yolov12s.pt" # 平衡速度与精度
# MODEL_NAME = "yolov12m.pt" # 中等规模
# MODEL_NAME = "yolov12l.pt" # 较大规模，精度更高
# MODEL_NAME = "yolov12x.pt" # 最大规模，精度最高
修改后重启服务：
supervisorctl restart yolo12
使用 Supervisor 管理服务状态：
# 查看服务状态
supervisorctl status yolo12
# 重启服务
supervisorctl restart yolo12
# 停止服务
supervisorctl stop yolo12
# 查看日志
supervisorctl tail yolo12
如果 8001 端口被占用，可以修改服务端口：
# 查看端口占用情况
ss -tlnp | grep 8001
# 修改配置文件中 PORT 值，然后重启服务
通过这个教程，你已经成功部署了一个功能完整的 YOLO12 目标检测 WebUI 服务。让我们回顾一下重点：
YOLO12 作为最新的目标检测模型，在速度和精度之间取得了很好的平衡。无论是用于学习研究、项目演示，还是实际应用，都是一个优秀的选择。
现在你可以尝试上传不同的图片，体验 YOLO12 的强大检测能力。从生活照片到专业场景，看看它都能识别出哪些有趣的物体！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online