# AWOOOI 服務端點參考

> **版本**: v1.0
> **建立日期**: 2026-03-29
> **負責人**: 首席架構師
> **用途**: 統一管理所有服務 IP:Port，避免文檔分散

---

## 五主機架構總覽

```
┌─────────────────────────────────────────────────────────────────┐
│                    AWOOOI 生產環境拓撲                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│   ┌──────────────┐        VIP 192.168.0.125                     │
│   │  DevOps 110  │              ↓                               │
│   │ Harbor/Sentry│     ┌───────┴───────┐                        │
│   │ Langfuse/GHR │     │               │                        │
│   └──────────────┘   120 (Master)   121 (Backup)                │
│                       K3s Server    K3s Server                   │
│   ┌──────────────┐   keepalived    keepalived                   │
│   │ Security 112 │                                              │
│   │ Kali Scanner │                                              │
│   └──────────────┘        ↓ Datastore                           │
│                    ┌──────────────┐                              │
│                    │  AI/Web 188  │                              │
│                    │ PostgreSQL   │                              │
│                    │ Ollama       │                              │
│                    │ OpenClaw     │                              │
│                    │ Redis/SignOz │                              │
│                    └──────────────┘                              │
└─────────────────────────────────────────────────────────────────┘
```

---

## 服務端點清單

### K3s 叢集 (透過 VIP 存取)

| 服務 | 端點 | 說明 |
|------|------|------|
| **K3s API** | `192.168.0.125:6443` | kubectl 存取點 (VIP) |
| **AWOOOI API** | `192.168.0.125:32334` | `/api/v1/*` NodePort |
| **AWOOOI Web** | `192.168.0.125:32335` | Next.js 前端 NodePort |

### AI 服務 (192.168.0.188)

| 服務 | 端點 | 說明 |
|------|------|------|
| **Ollama** | `192.168.0.188:11434` | LLM 推理 (llama3.2:3b, qwen2.5:7b) |
| **OpenClaw** | `192.168.0.188:8089` | AI 代理 (決策中心) - 2026-03-28 端口統一 |

### 資料庫 (192.168.0.188)

| 服務 | 端點 | 說明 |
|------|------|------|
| **PostgreSQL** | `192.168.0.188:5432` | AWOOOI DB + K3s Datastore |
| **Redis** | `192.168.0.188:6380` | 快取 (DB 10-15 為 AWOOOI) |

### 可觀測性

| 服務 | 端點 | 說明 |
|------|------|------|
| **SignOz Web** | `192.168.0.188:3301` | APM Dashboard |
| **OTEL gRPC** | `192.168.0.188:24317` | Traces (gRPC) |
| **OTEL HTTP** | `192.168.0.188:24318` | Traces (HTTP) |
| **ClickHouse** | `192.168.0.188:8123` | Metrics 查詢 |
| **Sentry** | `192.168.0.110:9000` | Error Tracking |
| **Langfuse** | `192.168.0.110:3100` | LLMOps |
| **Prometheus** | `192.168.0.188:9090` | Metrics |
| **Alertmanager** | `192.168.0.188:9093` | 告警路由 |

### DevOps (192.168.0.110)

| 服務 | 端點 | 說明 |
|------|------|------|
| **Harbor** | `192.168.0.110:5000` | Container Registry |
| **GitHub Runner** | - | Self-hosted (awoooi-runner) |

### K3s 叢集管理

| 服務 | 端點 | 說明 |
|------|------|------|
| **ArgoCD** | `192.168.0.125:30443` | GitOps UI；帳號與密碼不得寫入文件，請查受控密碼庫或 SSO / break-glass 流程 |

### 備份 (192.168.0.188)

| 服務 | 端點 | 說明 |
|------|------|------|
| **MinIO API** | `192.168.0.188:9000` | Velero 備份儲存 |
| **MinIO Console** | `192.168.0.188:9001` | Web 管理介面 |

### 安全 (192.168.0.112)

| 服務 | 端點 | 說明 |
|------|------|------|
| **Kali Scanner** | `192.168.0.112:8080` | 安全掃描 API |

---

## 健康檢查端點

```bash
# AWOOOI API (完整健康檢查)
curl http://192.168.0.125:32334/api/v1/health

# Ollama (模型列表)
curl http://192.168.0.188:11434/api/tags

# OpenClaw
curl http://192.168.0.188:8089/health

# SignOz ClickHouse
curl http://192.168.0.188:8123 -d "SELECT 1"

# Prometheus
curl http://192.168.0.188:9090/-/ready

# Alertmanager
curl http://192.168.0.188:9093/-/ready
```

---

## 環境變數範本

```bash
# === K3s VIP ===
KUBECONFIG_SERVER=https://192.168.0.125:6443

# === AI 服務 ===
OLLAMA_URL=http://192.168.0.188:11434
OPENCLAW_URL=http://192.168.0.188:8089

# === 資料庫 ===
DATABASE_URL=postgresql+asyncpg://user:pass@192.168.0.188:5432/awoooi
REDIS_URL=redis://192.168.0.188:6380/10

# === 可觀測性 ===
OTEL_EXPORTER_OTLP_ENDPOINT=http://192.168.0.188:24318  # HTTP
SIGNOZ_URL=http://192.168.0.188:3301
SENTRY_URL=http://192.168.0.110:9000
LANGFUSE_URL=http://192.168.0.110:3100

# === DevOps ===
HARBOR_URL=http://192.168.0.110:5000
```

---

## 變更歷史

| 日期 | 版本 | 變更 | 作者 |
|------|------|------|------|
| 2026-03-28 | v1.3 | K2 完成 - ArgoCD/VPA/NPD/Sealed Secrets | Claude Code |
| 2026-03-28 | v1.2 | K1 Velero 備份系統完成，MinIO 端點已記錄 | Claude Code |
| 2026-03-28 | v1.1 | OpenClaw 端口 8088→8089 統一，移除 legacy 引用 | Claude Code |
| 2026-03-28 | v1.0 | 初版建立 (K-HA 完成後) | 首席架構師 |