# Langfuse Self-Hosted 部署

> Phase 15.1 LLMOps 觀測平台

## 部署資訊

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

## 部署步驟

```bash
# 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 整合

```python
from langfuse import Langfuse

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

## 備份

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

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

## 回滾

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