本文将介绍如何使用 pip 安装 Label Studio，并通过 systemd 实现开机自启与后台运行，适用搭建个人项目的数据标注平台。

 一、Label Studio 简介

Label Studio 是一个开源、跨模态的数据标注工具，支持文本、图像、音频、视频、HTML等多种类型，适用于机器学习训练数据的可视化标注与协作。

主要特性：

• 文本分类、实体标注、目标检测、图像分割等支持

• 可视化配置标注模板（XML）

• 导入/导出支持 JSON、CSV、COCO 等格式

• 支持多用户、预标注、数据库持久化等功能

---

二、安装环境说明

• 系统：Ubuntu 22.04（其他 Linux 发行版也支持）

• Python：建议 3.8+

• 安装方式：pip + systemd 后台部署

• 数据库：PostgreSQL

---

 三、安装步骤详解

安装 Python venv 虚拟环境

apt install python3.10-venv -ypython3 -m venv env
source env/bin/activate

 配置国内 pip 源（加速安装）

mkdir -p ~/.pip/
vim ~/.pip/pip.conf

内容如下（清华源为例）：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

安装 Label Studio

python -m pip install label-studio --trusted-host pypi.tuna.tsinghua.edu.cn

---

四、配置 systemd 后台服务

新建服务配置文件：

vim /etc/systemd/system/label-studio.service

内容如下：

[Unit]
Description=Label Studio Service
After=network.target[Service]
Type=simple
User=root
WorkingDirectory=/root
ExecStart=/root/env/bin/label-studio start \--username labelstudio@weidian.com \--password admin123 \--host 0.0.0.0 \--port 8080 \--no-browser
Restart=always
RestartSec=10
Environment=PYTHONUNBUFFERED=1
Environment=DJANGO_DB=default
Environment=POSTGRE_NAME=labelstudio
Environment=POSTGRE_USER=labelstudio
Environment=POSTGRE_PASSWORD=labelstudio
Environment=POSTGRE_PORT=5434
Environment=POSTGRE_HOST=10.x.x.x[Install]
WantedBy=multi-user.target

---

五、启动并设置开机自启

# 注册服务
systemctl daemon-reexec
systemctl daemon-reload# 启动服务
systemctl restart label-studio# 设置为开机启动
systemctl enable label-studio# 查看日志
journalctl -u label-studio -f

---

 六、访问 Label Studio

浏览器访问：http://服务器IP:8080

登录账号：

• 用户名：labelstudio@weidian.com

• 密码：admin123

首次登录可创建项目、导入数据并开始标注。

---

七、常见问题排查

问题	原因	解决方法
服务无法访问	端口未开放	检查防火墙 / 云服务安全组
启动失败	Python 路径错误	检查 ExecStart 指向虚拟环境路径
PostgreSQL 连接失败	参数或权限错误	用 psql 手动连接测试
日志无输出	忘记重载 systemd	执行 daemon-reexec 和 daemon-reload

---

 原文参考 / 推荐资料

• 官方文档：https://labelstud.io/guide/install#Install-using-pip