label-studio

环境要求

• 已安装 Docker（若用 pip/conda 本地安装则需 Python 与 pip）
• 宿主机 8080 端口未被占用；Docker Compose 方式占用 80 端口
• 用于挂载的本地目录 $(pwd)/mydata 需可写，容器内挂载点为 /label-studio/data
• Docker Compose 方式需可用 docker-compose；MinIO 方式需 docker compose 并可能需改 hosts 文件
• Windows 上 pip 安装需先从 Gohlke builds 下载匹配 Python 版本的 lxml wheel

安装与启动步骤

1. 1拉取官方镜像

   从 Docker Hub 下载 Label Studio 官方最新镜像，这是 README 推荐的本地安装方式。

   docker pull heartexlabs/label-studio:latest

   复制

2. 2启动容器

   映射 8080 端口，并用 -v 把数据目录挂到本地 mydata，容器内路径固定为 /label-studio/data。

   docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest

   复制

3. 3覆盖默认启动命令

   可选：在镜像名后追加参数覆盖默认启动命令，例如把日志级别改为 DEBUG 便于排查。

   docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest label-studio --log-level DEBUG

   复制

4. 4Compose 生产部署

   用自带编排启动 Label Studio + Nginx + PostgreSQL 的生产级组合，从 80 端口访问。

   docker-compose up

   复制

5. 5叠加 MinIO 存储

   再叠加 minio 编排文件，额外启动 MinIO 用于本地测试 S3 存储；无固定 IP 需配置 hosts。

   docker compose -f docker-compose.yml -f docker-compose.minio.yml up -d

   复制

6. 6Conda 本地安装

   README 给出的 Anaconda 安装路径：创建并激活环境、安装 psycopg2，再 pip 安装 label-studio。

   conda create --name label-studio
   conda activate label-studio
   conda install psycopg2
   pip install label-studio

   复制

7. 7本地开发安装

   从源码跑最新版：装 poetry 与依赖，再执行数据库迁移和静态文件收集。

   pip install poetry
   poetry install
   python label_studio/manage.py migrate
   python label_studio/manage.py collectstatic

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:8080 能看到 Label Studio 界面；Compose 方式访问 http://localhost，并确认 mydata 目录下生成 label_studio.sqlite3。

常见问题

注意事项

• 单容器方式访问 8080 端口，Docker Compose 方式访问 80 端口，两者地址不同勿混淆。
• 官方镜像名为 heartexlabs/label-studio，默认使用 SQLite3，生产环境建议改用 Compose 中的 PostgreSQL。
• Windows 用户用 pip 安装前，需先从 Gohlke builds 下载对应版本的 lxml wheel 并先安装。
• 从源码开发安装后必须执行 migrate 与 collectstatic，否则应用无法正常启动。