本文將介紹如何使用 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