tobiichiGPT/QUICKSTART.md

TobiichiGPT - 快速設定指南

📦 一鍵啟動

# 進入 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 保護

🛠️ 常用指令

# 查看服務狀態
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 檔案）