awoooi/infra/langfuse

Langfuse Self-Hosted 部署

Phase 15.1 LLMOps 觀測平台

部署資訊

項目	值
主機	192.168.0.110 (DevOps 金庫)
Port	3100
URL	http://192.168.0.110:3100
資料庫	PostgreSQL 15 (內建)

部署步驟

# 1. 複製到目標主機
scp -r infra/langfuse/ wooo@192.168.0.110:/opt/langfuse/

# 2. SSH 到目標主機
ssh wooo@192.168.0.110

# 3. 啟動服務
cd /opt/langfuse
docker-compose up -d

# 4. 檢查狀態
docker-compose ps
docker-compose logs -f langfuse

首次設定

1. 開啟 http://192.168.0.110:3100
2. 註冊管理員帳號
3. 建立 Project: awoooi-openclaw
4. 生成 API Key (Public + Secret)
5. 將 API Key 加入 K8s Secret

API 整合

from langfuse import Langfuse

langfuse = Langfuse(
    public_key="pk-xxx",
    secret_key="sk-xxx",
    host="http://192.168.0.110:3100"
)

備份

# 備份資料庫
docker exec langfuse-db pg_dump -U langfuse langfuse > backup.sql

# 還原
cat backup.sql | docker exec -i langfuse-db psql -U langfuse langfuse

回滾

cd /opt/langfuse
docker-compose down
# 還原備份後
docker-compose up -d