# TobiichiGPT - 快速設定指南

## 📦 一鍵啟動

```powershell
# 進入 docker-stack 目錄
cd docker-stack

# 啟動所有服務
docker-compose up -d
```

## 🌐 服務清單

| 服務 | 網址 | 用途 |
|------|------|------|
| Open WebUI | http://localhost:3000 | 用戶對話介面 |
| 管理員後台 | http://localhost:8000/admin | 真人回覆訊息 |
| NPM 管理面板 | http://localhost:82 | 反向代理設定 |
| Cloudflare Tunnel | 自動連線 | 公開訪問（需設定） |

## ⚙️ Open WebUI 設定步驟

1. 開啟 http://localhost:3000
2. 進入 **Settings** → **Connections**
3. 點擊 **+ Add OpenAI Connection**
4. 填入：
   - **API Base URL**: `http://human-reply-server:8000/v1`
   - **API Key**: `sk-human` (隨便填)
5. 模型列表會出現 **human-admin**

## 💬 使用流程

### 用戶端
1. 在 Open WebUI 選擇 `human-admin` 模型
2. 輸入訊息後送出
3. 等待管理員回覆（畫面會轉圈）

### 管理員端
1. 訪問 http://localhost:8000/admin
2. 看到新訊息通知
3. 在文字框輸入回覆
4. 點擊「送出回覆」

## 🔒 設定 HTTPS

### 方法 1: 使用 NPM（本機 NPM）

1. 訪問 http://localhost:82
2. 登入（預設帳密：admin@example.com / changeme）
3. 首次登入會要求更改密碼
4. 新增 Proxy Host：
   - **Domain Names**: 你的網域 (例如: chat.example.com)
   - **Forward Hostname**: `open-webui`
   - **Forward Port**: `8080`
   - 勾選 **SSL** → 申請 Let's Encrypt 憑證

### 方法 2: 使用 Cloudflare Tunnel（推薦）

1. 前往 https://one.dash.cloudflare.com/
2. 建立 Tunnel 並複製 Token
3. 編輯 `docker-stack/.env`，填入 Token
4. 在 Cloudflare 設定 Public Hostname：
   - `chat.yourdomain.com` → `open-webui:8080`
   - `admin.yourdomain.com` → `human-reply-server:8000`
5. 自動獲得 HTTPS + DDoS 保護

## 🛠️ 常用指令

```powershell
# 查看服務狀態
docker-compose ps

# 查看日誌
docker-compose logs -f

# 重啟服務
docker-compose restart

# 停止服務
docker-compose down

# 完全移除（包含資料）
docker-compose down -v
```

## 🐛 疑難排解

### Open WebUI 連不到人工回覆伺服器
- 確認 API URL 使用 `http://human-reply-server:8000/v1`（容器名稱）
- 不要使用 `localhost:8000`

### 管理員後台打不開
- 確認容器是否正常運行：`docker ps`
- 查看錯誤日誌：`docker logs tobiichi-gpt`

### NPM 無法訪問
- 確認 port 81 沒有被佔用
- Windows 防火牆可能需要開放 port

## 📝 Port 對應

### 本機訪問

| 容器內 Port | 本機 Port | 服務 |
|------------|----------|------|
| 8080 | 3000 | Open WebUI |
| 8000 | 8000 | 人工回覆 API |
| 80 | 8080 | 本專案 NPM HTTP |
| 443 | 8443 | 本專案 NPM HTTPS |
| 81 | 82 | 本專案 NPM 管理 |

### 與現有 NPM 共存

| 服務 | Port | 說明 |
|------|------|------|
| 現有 NPM | 80/443/81 | 原有的 NPM 實例 |
| 本專案 NPM | 8080/8443/82 | TobiichiGPT 專用 NPM |

### 透過 Cloudflare Tunnel

無需開放 Port，直接使用網域訪問（需設定 `.env` 檔案）