Label Studio 快速上手:Docker 部署到图像标注的完整工作流
【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio
打开训练集,发现 3000 张图还没框,文本要逐个实体标注,你多半想写个脚本糊弄过去。但脚本产出的格式五花八门,没法复用,更没法协作。Label Studio 解决的就是这个问题:它是一个多数据类型的数据标注工具,支持图像、文本、音频、视频和时间序列,标注结果按标准格式输出,可以直接喂给模型训练。接下来 5 分钟,你会把它跑起来,并完成一次完整标注。
🎯 一张表看懂核心能力
| 能力维度 | 一句话说明 |
|---|---|
| 多数据类型标注 | 图像框/多边形、文本片段、音频区间、视频帧、时间序列 |
| 模板化标注界面 | 用 XML 配置定义界面,内置 50+ 覆盖常见场景的模板 |
| 标准化导出 | 一键导出 COCO、YOLO、Pascal VOC、CoNLL、JSON 等格式 |
| ML 预标注 | 接入模型服务自动生成初始标注,人工只做修正 |
| REST API | 项目、任务、标注全流程可编程,方便嵌入数据管道 |
这几项组合起来的意义在于:原始数据进去,训练数据出来,中间不用在多个工具之间倒腾。
导入、配置、标注、导出构成闭环
🚀 从零跑起来:Label Studio Docker 部署
推荐:pip 直装,适合先跑通体验
pip install label-studio # 需要 Python >= 3.10 label-studio备选:Docker Compose,适合团队协作
git clone https://gitcode.com/GitHub_Trending/la/label-studio cd label-studio docker-compose upDocker 方式会同时拉起 Label Studio、Nginx 和 PostgreSQL,生产就绪;pip 方式用 SQLite,够个人使用。
验证是否跑起来:浏览器打开http://localhost:8080(pip 模式)或http://localhost(Docker 模式),用邮箱注册,看到项目列表页即表示 Label Studio 已就绪。
启动成功后的项目列表页
📊 跟着做:一次完整的图像标注工作流
以最常见场景为例:给航拍图打目标检测框。
创建项目:进入项目列表页,点击右上角Create→ 选择New Project,在模板库挑一个图像模板,或直接写配置。
导入数据:进入项目点击Import,上传本地图片,或上传 JSON 清单(每条的
image字段指向文件路径)。
导入后的任务列表网格视图
- 配置标注界面:Label Studio 的标注界面完全由 XML 定义。点击Labeling Config即可看到并修改。最小目标检测配置如下:
<View> <Image name="image" value="$image"/> <RectangleLabels name="label" toName="image"> <Label value="Car"/><Label value="Person"/> </RectangleLabels> </View>按数据类型组织的预置模板
- 执行标注:点击右上角Label进入标注页,在图上拖框选中目标,点击Update保存。右侧面板管理每个实体的标签,改错随时删。
图像上绘制框,右侧管理实体标签
- 导出结果:标注完成后点击Export,选择输出格式。COCO、YOLO、Pascal VOC 等主流训练格式都直接可选,无需再写转换脚本。
⚙️ 进阶能力速览
机器学习后端预标注
通过 ML SDK 接入你自己的模型服务,模型先跑一遍预测,人工只做修正。
ML 后端与标注平台形成迭代闭环
数据量大时能省掉大部分手工标注,还能做主动学习:只标注模型最没把握的样本。
REST API 管道集成
项目、任务、标注全流程都有 API,脚本可以批量导入新数据、拉取标注结果,把 Label Studio 嵌进现有数据管道。
云存储与大文件集
数据源可以直接指向 S3、Google Cloud Storage 或本地目录,大规模数据集不必先下载到本地再导入。
多人协作与权限
标注绑定账号,角色和权限可配置,谁标了什么、进度如何,在任务列表页一目了然。
🔧 踩坑与调优:新手最常问的三个问题
1. 启动后页面打不开,提示端口被占另一个服务占用了 8080。用sudo lsof -i :8080找到并停掉它,或把宿主机端口改成-p 8081:8080重新映射。
2. 导入的图片不显示,标注页一片空白任务 JSON 里image字段的相对路径和文件实际位置对不上。先通过平台上传文件,再统一用/data/upload/...这样的路径引用,图片就会正常加载。
3. 容器一重启,项目和数据全没了跑容器时没挂载数据卷,SQLite 库和上传文件都留在容器内。补上-v $(pwd)/mydata:/label-studio/data,或直接用 docker-compose 方式(默认带卷)。
🌍 谁在用它 & 怎么继续学
不少团队把 Label Studio 当作训练数据的中枢:某自动驾驶团队用它标注道路目标检测并持续迭代模型;某医疗影像团队用多边形模板标注 CT 病灶;某内容平台用文本模板做审核分类。共同点是标注量上去了,格式和流程依然可控。
继续学习的入口:
- 官方入门指南:docs/source/guide/get_started.md
- 按场景分类的标注模板:label_studio/annotation_templates/
- REST API 参考:docs/source/guide/api.md
适合谁,从哪开始
如果你的模型缺训练数据,先用 pip 方式装起来,照着上面的图像标注示例跑通一遍;确认流程顺手后,再切换到 Docker Compose 部署给团队用。
【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考