企业官网建设流程全解析

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

Label Studio 是一款开源数据标注工具，能标注文本、图片、音频、视频、时序等多类数据，并把结果按标准格式导出给模型训练。本文带你完成 Label Studio Docker 部署与本地安装，十几分钟从零跑通。

它是什么：一句话说清 Label Studio

简单说：把原始数据灌进去，在网页上画框、打标签、写注释，再把结果导出成模型能吃的格式。整个闭环就是四步——导入任务、配置项目、网页标注、导出完成。

动手前：环境要求与前置准备

先花一分钟确认三件事，后面基本不会卡：

没有 Docker 也不想装？直接走下面 pip 路线，纯 Python 环境就够。

安装方式（按场景选）

这条 Label Studio 安装教程按"谁在用"分三条路线，对号入座即可。

Docker 快速部署：生产与团队场景 🚀

一条docker run起服务，数据库和上传文件都落在挂载的./mydata目录里，以后迁机器只搬这个目录。

docker pull heartexlabs/label-studio:latest # 拉官方镜像 docker run -d -p 8080:8080 -v $(pwd)/mydata:/label-studio/data \ --name label-studio heartexlabs/label-studio:latest

执行后 8080 端口被监听，docker logs label-studio能看到启动日志即成功。

多人协作、要生产级的 Nginx + PostgreSQL 组合时，用仓库自带的 compose 文件一步到位：

git clone https://gitcode.com/GitHub_Trending/la/label-studio cd label-studio docker compose up -d # 起 Label Studio + Nginx + PostgreSQL 三个服务

预期三个服务全部 Up。如果你需要在本地顺带测 S3 存储行为，可以再加一个 MinIO 服务：docker compose -f docker-compose.yml -f docker-compose.minio.yml up -d，MinIO 会额外占用 9000 端口。

pip 本地安装：个人体验

只想先看看它长什么样？Label Studio 本地安装选 pip 最省事：

pip install label-studio # 需要 Python >= 3.10 label-studio # 启动后访问 http://localhost:8080

启动成功时终端会打印监听 8080 端口的信息。

Poetry / Conda 开发环境：贡献者场景

要读源码、改功能、提 PR，就在刚 clone 下来的仓库里跑开发模式：

pip install poetry poetry install # 装齐全部依赖 python label_studio/manage.py migrate # 建数据库 python label_studio/manage.py collectstatic python label_studio/manage.py runserver

看到Starting development server at http://0.0.0.0:8080即成功。

首次启动：跑起来并访问

无论走哪条路线，浏览器打开http://localhost:8080，注册登录，你会看到项目列表页：一排项目卡片（或空列表）加右上角蓝色 Create 按钮，这就是标注工作的起点。

关键配置项：只盯 4 个就够

Label Studio 配置指南里变量不少，新手真正需要关心的只有这几个：

DJANGO_DB=sqlite意味着数据库就是一个label_studio.sqlite3文件，和上传文件一起放在数据目录里——备份时把整个目录打包即可。

踩坑速查：端口、MinIO、数据库迁移 ⚠️

• 8080 端口被占：启动报port is already allocated，说明别的进程占了端口。先lsof -i:8080找到它，或者干脆映射到-p 8088:8080，改访问http://localhost:8088。
• MinIO 连不上：容器网络和浏览器都按名字解析 MinIO 地址，宿主机缺对应 hosts 条目时就会超时。在/etc/hosts加一行IP 主机名解决，细节见仓库里的 docs/source/guide/storedata.md。
• 数据库迁移失败：常见原因是旧数据目录配了新版镜像，或数据目录权限不对。先备份mydata，换新目录让服务首启自动建库，再导入数据。

下一步：从"能跑"到"能用"

服务跑起来只是开始，接下来三件事让它真正可用：

• 接入外部数据库：compose 栈已内置 PostgreSQL；已有现成实例时，把 docker-compose.yml 里的POSTGRE_HOST指向它即可。
• 配置对象存储：把标注文件存到 S3 / GCS / Azure，走 存储数据指南 填写连接信息。
• 创建第一个标注项目：点 Create 选一个模板、导入一份数据，十分钟内完成首条标注，流程见 项目设置文档。

【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio