From 99c1d12b8a1f9a00700832562f30a4048b536eea Mon Sep 17 00:00:00 2001 From: copilot-ci Date: Wed, 25 Feb 2026 02:17:47 +0800 Subject: [PATCH 1/3] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20Tailscale=20?= =?UTF-8?q?=E5=A4=9A=E7=AB=99=20CTOS=20=E6=9E=B6=E6=A7=8B=E8=A8=AD?= =?UTF-8?q?=E8=A8=88=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 規劃透過 Tailscale VPN 讓遠端 CTOS 實例連回主站， 由主站 nginx 統一對外提供 Web UI 和 Line Bot webhook 服務。 Co-Authored-By: Claude Opus 4.6 --- .../2026-02-25-tailscale-multi-site-design.md | 237 ++++++++++++++++++ 1 file changed, 237 insertions(+) create mode 100644 docs/plans/2026-02-25-tailscale-multi-site-design.md diff --git a/docs/plans/2026-02-25-tailscale-multi-site-design.md b/docs/plans/2026-02-25-tailscale-multi-site-design.md new file mode 100644 index 0000000..ac421a5 --- /dev/null +++ b/docs/plans/2026-02-25-tailscale-multi-site-design.md @@ -0,0 +1,237 @@ +# Tailscale 多站 CTOS 架構設計 + +## 目的 + +讓部署在不同地點的 CTOS 實例，透過 Tailscale VPN 連回主站 (ching-tech.ddns.net)，由主站 nginx 統一對外提供服務，包含： +- 完整 CTOS Web UI（登入頁、桌面等） +- Line Bot webhook 接收 + +## 架構概覽 + +``` +Line Platform + │ + ▼ +ching-tech.ddns.net (192.168.11.11) ── 主站 nginx + │ + ├─ /ctos/* → localhost:8088 (主站自己的 CTOS) + ├─ /client-a/* → 100.64.0.2:8088 (遠端 A，Tailscale) + ├─ /bot/client-a/* → 100.64.0.2:8088 (遠端 A 的 Line webhook) + ├─ /client-b/* → 100.64.0.3:8088 (遠端 B，Tailscale) + └─ /bot/client-b/* → 100.64.0.3:8088 (遠端 B 的 Line webhook) + │ + │ Tailscale VPN (WireGuard) + │ + ┌────┴────────────────────┐ + │ │ +100.64.0.2 100.64.0.3 +遠端 A 遠端 B +├─ CTOS 後端 :8088 ├─ CTOS 後端 :8088 +├─ PostgreSQL (Docker) ├─ PostgreSQL (Docker) +└─ Tailscale └─ Tailscale +``` + +### 角色分工 + +| 角色 | 職責 | +|------|------| +| 主站 nginx | SSL 終止、路徑路由、反向代理到 Tailscale IP | +| 主站 Tailscale | 與遠端節點建立加密隧道 | +| 遠端 CTOS | 完整的 CTOS 應用（後端 + DB），獨立運作 | +| 遠端 Tailscale | 與主站建立加密隧道，取得固定 IP | + +### 設計決策 + +- **路徑區分客戶**：每個客戶一個 URL 路徑前綴，只需一個域名 + 一張 SSL 憑證 +- **固定 Tailscale IP**：每台遠端的 Tailscale IP 固定，直接寫在 nginx 設定中 +- **nginx strip prefix**：主站 nginx 去掉路徑前綴後轉發，遠端 CTOS 跑在根路徑 `/`，不需要知道自己的子路徑 +- **CTOS 程式碼不改**：前端 `config.js` 已有子路徑自動偵測機制，現有架構足以支援 + +## 主站設定 + +### 1. 安裝 Tailscale + +```bash +curl -fsSL https://tailscale.com/install.sh | sh +sudo tailscale up +# 在瀏覽器開啟授權連結，登入帳號 +``` + +### 2. nginx 設定範本 + +每新增一個遠端客戶，在 nginx 設定中加入以下 location block（需修改三個值）： + +```nginx +# ============================================ +# 遠端 CTOS: +# Tailscale IP: +# Port: 8088 +# ============================================ + +# CTOS 完整應用（strip prefix 後轉發） +location // { + proxy_pass http://:8088/; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; +} + +# Line Bot Webhook（改寫路徑後轉發） +location = /bot//webhook { + proxy_pass http://:8088/api/bot/line/webhook; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Line-Signature $http_x_line_signature; +} +``` + +**需替換的值：** + +| 佔位符 | 說明 | 範例 | +|--------|------|------| +| `` | 客戶識別碼（URL 路徑） | `company-a` | +| `` | 遠端的 Tailscale IP | `100.64.0.2` | + +### 3. 新增客戶 SOP + +1. 在 Tailscale 管理後台產生 Auth Key（One-off） +2. 遠端主機安裝 Tailscale 並加入 tailnet（見下方「遠端主機部署」） +3. 記下遠端的 Tailscale IP +4. 複製上方 nginx 範本，填入 `CLIENT_ID` 和 `TAILSCALE_IP` +5. `sudo nginx -t && sudo nginx -s reload` +6. 在 Line Developer Console 設定 webhook URL：`https://ching-tech.ddns.net/bot//webhook` +7. 驗證（見下方「驗證與除錯」） + +## 遠端主機部署 + +### 前置需求 + +| 項目 | 用途 | +|------|------| +| Ubuntu 22.04+ 或 Debian 12+ | 作業系統 | +| Docker + Docker Compose | 執行 PostgreSQL | +| Python 3.11+ | 後端執行環境 | +| uv | Python 套件管理 | +| git | 取得程式碼 | + +### 步驟 1：安裝 Tailscale + +```bash +curl -fsSL https://tailscale.com/install.sh | sh +sudo tailscale up --authkey=tskey-auth-xxxxxxxx +# 確認取得 IP +tailscale ip -4 +``` + +Auth Key 產生方式： +1. 登入 https://login.tailscale.com/admin/settings/keys +2. 點 Generate auth key +3. 選 One-off + 設定到期日 + +### 步驟 2：部署 CTOS + +```bash +# Clone 程式碼 +git clone https://github.com/yazelin/ching-tech-os.git +cd ching-tech-os + +# 安裝 Docker（如果還沒裝） +curl -fsSL https://get.docker.com | sh +sudo usermod -aG docker $USER +# 重新登入以套用 docker group + +# 安裝 uv（如果還沒裝） +curl -LsSf https://astral.sh/uv/install.sh | sh + +# 安裝後端依賴 +cd backend && uv sync && cd .. + +# 設定環境變數 +cp .env.example .env +# 編輯 .env，至少需要設定： +# DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME +# LINE_CHANNEL_SECRET（此客戶的 Line Bot secret） +# LINE_CHANNEL_ACCESS_TOKEN（此客戶的 Line Bot token） +``` + +### 步驟 3：安裝 systemd 服務 + +使用現有的 `install-service.sh`，但需先手動調整以下項目： + +| 行號 | 變數 | 預設值 | 調整說明 | +|------|------|--------|---------| +| 12 | `PROJECT_DIR` | `/home/ct/SDD/ching-tech-os` | 改為實際的 clone 路徑 | +| 244 | `User=ct` | `ct` | 改為遠端主機的使用者 | +| 244 | `Group=ct` | `ct` | 同上 | +| 248 | node 路徑 | `v24.13.0` | 改為遠端實際的 node 版本（或移除） | +| 39-43 | NAS 設定檢查 | 必填 | 若無 NAS，註解掉 NAS 相關段落（第 34-209 行） | + +調整完畢後執行： + +```bash +sudo ./scripts/install-service.sh +``` + +### 步驟 4：確認服務啟動 + +```bash +sudo systemctl status ching-tech-os +curl http://localhost:8088/api/health +``` + +## Line Bot 設定 + +在 [Line Developer Console](https://developers.line.biz/console/) 中： + +1. 選擇對應的 Line Bot Channel +2. 進入 Messaging API 設定 +3. Webhook URL 設定為：`https://ching-tech.ddns.net/bot//webhook` +4. 開啟 Use webhook + +## 驗證與除錯 + +### 逐步驗證清單 + +```bash +# 1. 遠端：確認 CTOS 後端正常 +curl http://localhost:8088/api/health + +# 2. 遠端：確認 Tailscale 已連線 +tailscale status + +# 3. 主站：確認可透過 Tailscale 連到遠端 +ping +curl http://:8088/api/health + +# 4. 主站：確認 nginx 設定正確 +sudo nginx -t + +# 5. 外部：確認完整路徑可存取 +curl https://ching-tech.ddns.net//api/health + +# 6. 外部：測試 webhook（模擬 Line 請求） +curl -X POST https://ching-tech.ddns.net/bot//webhook \ + -H "Content-Type: application/json" \ + -d '{"events":[]}' +``` + +### 常見問題 + +| 症狀 | 可能原因 | 排查 | +|------|---------|------| +| 502 Bad Gateway | 遠端 CTOS 未啟動或 Tailscale 斷線 | 檢查遠端 `systemctl status ching-tech-os` 和 `tailscale status` | +| 404 | nginx location 路徑設定錯誤 | 確認 `CLIENT_ID` 拼寫一致 | +| WebSocket 連線失敗 | nginx 缺少 Upgrade header | 確認 location block 包含 `proxy_set_header Upgrade` | +| Webhook 簽章驗證失敗 | `X-Line-Signature` header 未傳遞 | 確認 webhook location 包含 `proxy_set_header X-Line-Signature` | +| 靜態資源 404 | 路徑前綴問題 | 確認 `proxy_pass` 尾部有 `/`（strip prefix） | + +## 未來規劃 + +- 將 Tailscale 部署整合進 `scripts/install-service.sh`（參數化路徑、NAS 可選） +- 管理介面：在 CTOS 後台管理路由對應，自動產生 nginx 設定 +- 超過 100 台設備時評估遷移到 Headscale（自架協調伺服器） From e70c3875221269ac315e62bfdf9893452df53f10 Mon Sep 17 00:00:00 2001 From: copilot-ci Date: Wed, 25 Feb 2026 02:25:37 +0800 Subject: [PATCH 2/3] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20Tailscale=20?= =?UTF-8?q?=E5=A4=9A=E7=AB=99=20CTOS=20=E9=83=A8=E7=BD=B2=E6=8C=87?= =?UTF-8?q?=E5=8D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 --- docs/tailscale-multi-site.md | 364 +++++++++++++++++++++++++++++++++++ 1 file changed, 364 insertions(+) create mode 100644 docs/tailscale-multi-site.md diff --git a/docs/tailscale-multi-site.md b/docs/tailscale-multi-site.md new file mode 100644 index 0000000..c37b652 --- /dev/null +++ b/docs/tailscale-multi-site.md @@ -0,0 +1,364 @@ +# Tailscale 多站 CTOS 部署指南 + +## 概覽 + +本文件說明如何透過 Tailscale VPN，將部署在不同地點的 CTOS 實例連回主站，由主站 nginx 統一對外提供服務。每個遠端站點擁有獨立的 CTOS 後端與資料庫，主站僅負責 SSL 終止與路徑路由。 + +### 架構圖 + +``` +Line Platform + | + v +ching-tech.ddns.net (主站 nginx) + | + |-- /ctos/* --> localhost:8088 (主站 CTOS) + |-- /client-a/* --> 100.64.0.2:8088 (遠端 A，經 Tailscale) + |-- /bot/client-a/* --> 100.64.0.2:8088 (遠端 A Line webhook) + |-- /client-b/* --> 100.64.0.3:8088 (遠端 B，經 Tailscale) + |-- /bot/client-b/* --> 100.64.0.3:8088 (遠端 B Line webhook) + | + | Tailscale VPN (WireGuard) + | + +---------+------------------+ + | | +100.64.0.2 100.64.0.3 +遠端 A 遠端 B +|- CTOS 後端 :8088 |- CTOS 後端 :8088 +|- PostgreSQL (Docker) |- PostgreSQL (Docker) +|- Tailscale |- Tailscale +``` + +### 角色分工 + +| 角色 | 職責 | +|------|------| +| 主站 nginx | SSL 終止、路徑路由、反向代理到 Tailscale IP | +| 主站 Tailscale | 與遠端節點建立加密隧道 | +| 遠端 CTOS | 完整的 CTOS 應用（後端 + DB），獨立運作 | +| 遠端 Tailscale | 與主站建立加密隧道，取得固定 IP | + +### 設計原則 + +- **路徑區分客戶**：每個客戶一個 URL 路徑前綴，只需一個域名與一張 SSL 憑證。 +- **固定 Tailscale IP**：每台遠端主機的 Tailscale IP 固定，直接寫在 nginx 設定中。 +- **nginx strip prefix**：主站 nginx 去掉路徑前綴後轉發，遠端 CTOS 不需要知道自己的子路徑。 +- **程式碼不需修改**：前端 `config.js` 已有子路徑自動偵測機制，現有架構直接支援。 + +--- + +## 主站設定 + +### 1. 安裝 Tailscale + +```bash +curl -fsSL https://tailscale.com/install.sh | sh +sudo tailscale up +``` + +執行後會顯示一個授權連結，在瀏覽器開啟並登入帳號完成授權。 + +### 2. nginx 設定 + +每新增一個遠端客戶時，需要在主站 nginx 設定中加入對應的 location block。 + +範本檔案位於 `scripts/nginx/ctos-remote-site.conf.template`，內容如下： + +```nginx +# ============================================ +# 遠端 CTOS: +# Tailscale IP: +# Port: 8088 +# ============================================ + +# CTOS 完整應用（strip prefix 後轉發） +location // { + proxy_pass http://:8088/; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; +} + +# Line Bot Webhook（改寫路徑後轉發） +location = /bot//webhook { + proxy_pass http://:8088/api/bot/line/webhook; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Line-Signature $http_x_line_signature; +} +``` + +使用時複製此範本，將以下佔位符替換為實際值： + +| 佔位符 | 說明 | 範例 | +|--------|------|------| +| `` | 客戶識別碼（用於 URL 路徑） | `company-a` | +| `` | 遠端主機的 Tailscale IP | `100.64.0.2` | + +替換完成後將內容加入主站 nginx 設定檔，然後測試並重新載入： + +```bash +sudo nginx -t && sudo nginx -s reload +``` + +**注意事項**： + +- `proxy_pass` 尾部的 `/` 不可省略，這是 nginx strip prefix 的關鍵。 +- CTOS 應用的 location block 必須包含 WebSocket 相關 header（`Upgrade`、`Connection`），否則 Socket.IO 連線會失敗。 +- Line webhook 的 location block 必須傳遞 `X-Line-Signature` header，否則簽章驗證會失敗。 + +--- + +## 新增客戶 SOP + +以下為新增一個遠端客戶站點的完整步驟。 + +### 步驟 1：產生 Tailscale Auth Key + +1. 登入 [Tailscale 管理後台](https://login.tailscale.com/admin/settings/keys)。 +2. 點選 **Generate auth key**。 +3. 選擇 **One-off**，設定適當的到期日。 +4. 記下產生的 Auth Key（格式為 `tskey-auth-xxxxxxxx`）。 + +### 步驟 2：部署遠端主機 + +依照下一節「遠端主機部署步驟」完成遠端 CTOS 的安裝與 Tailscale 連線。 + +### 步驟 3：記錄遠端的 Tailscale IP + +在遠端主機上執行： + +```bash +tailscale ip -4 +``` + +記下輸出的 IP 位址（如 `100.64.0.2`）。 + +### 步驟 4：設定主站 nginx + +1. 複製 `scripts/nginx/ctos-remote-site.conf.template` 範本。 +2. 將 `` 替換為客戶識別碼（如 `company-a`）。 +3. 將 `` 替換為步驟 3 取得的 IP。 +4. 將替換後的內容加入主站 nginx 設定檔。 +5. 測試並重新載入 nginx： + +```bash +sudo nginx -t && sudo nginx -s reload +``` + +### 步驟 5：設定 Line Bot webhook + +在 [Line Developer Console](https://developers.line.biz/console/) 中設定 webhook URL（詳見下方「Line Bot webhook 設定」章節）。 + +### 步驟 6：驗證 + +依照下方「驗證與除錯」章節的檢查清單逐步確認。 + +--- + +## 遠端主機部署步驟 + +### 前置需求 + +| 項目 | 用途 | +|------|------| +| Ubuntu 22.04+ 或 Debian 12+ | 作業系統 | +| Docker + Docker Compose | 執行 PostgreSQL | +| Python 3.11+ | 後端執行環境 | +| uv | Python 套件管理 | +| git | 取得程式碼 | + +### 步驟 1：安裝 Tailscale 並加入 tailnet + +```bash +curl -fsSL https://tailscale.com/install.sh | sh +sudo tailscale up --authkey=tskey-auth-xxxxxxxx +``` + +將 `tskey-auth-xxxxxxxx` 替換為在「新增客戶 SOP - 步驟 1」中產生的 Auth Key。 + +確認已取得 Tailscale IP： + +```bash +tailscale ip -4 +``` + +### 步驟 2：部署 CTOS 應用 + +```bash +# 取得程式碼 +git clone https://github.com/yazelin/ching-tech-os.git +cd ching-tech-os + +# 安裝 Docker（若尚未安裝） +curl -fsSL https://get.docker.com | sh +sudo usermod -aG docker $USER +# 需重新登入以套用 docker group + +# 安裝 uv（若尚未安裝） +curl -LsSf https://astral.sh/uv/install.sh | sh + +# 安裝後端依賴 +cd backend && uv sync && cd .. + +# 設定環境變數 +cp .env.example .env +``` + +編輯 `.env` 檔案，至少需要設定以下項目： + +| 變數 | 說明 | +|------|------| +| `DB_HOST` | 資料庫主機（通常為 `localhost`） | +| `DB_PORT` | 資料庫埠號（預設 `5432`） | +| `DB_USER` | 資料庫使用者 | +| `DB_PASSWORD` | 資料庫密碼 | +| `DB_NAME` | 資料庫名稱 | +| `LINE_CHANNEL_SECRET` | 此客戶的 Line Bot Channel Secret | +| `LINE_CHANNEL_ACCESS_TOKEN` | 此客戶的 Line Bot Access Token | + +### 步驟 3：啟動資料庫 + +```bash +cd docker && docker compose up -d && cd .. +``` + +執行資料庫 migration： + +```bash +cd backend && uv run alembic upgrade head && cd .. +``` + +### 步驟 4：安裝 systemd 服務 + +使用專案中的 `scripts/install-service.sh`，但遠端主機的環境通常與主站不同，需要先調整以下項目： + +| 變數/區段 | 預設值 | 調整說明 | +|-----------|--------|---------| +| `PROJECT_DIR`（第 12 行） | `/home/ct/SDD/ching-tech-os` | 改為遠端主機上的實際 clone 路徑 | +| `User` / `Group`（systemd unit） | `ct` | 改為遠端主機的使用者名稱 | +| node 路徑（第 248 行附近） | `v24.13.0` | 改為遠端實際的 node 版本，或在不需要前端建置時移除 | +| NAS 設定檢查（第 34-43 行） | 必填 | 若遠端主機無 NAS，註解掉 NAS 相關段落（約第 34-209 行） | + +調整完成後執行： + +```bash +sudo ./scripts/install-service.sh +``` + +### 步驟 5：確認服務啟動 + +```bash +# 檢查服務狀態 +sudo systemctl status ching-tech-os + +# 測試 API 回應 +curl http://localhost:8088/api/health +``` + +如果服務未正常啟動，查看日誌排查問題： + +```bash +journalctl -u ching-tech-os -n 50 --no-pager +``` + +--- + +## Line Bot webhook 設定 + +每個遠端站點的 Line Bot 需要獨立的 webhook URL，由主站 nginx 統一接收後轉發。 + +### 設定步驟 + +1. 登入 [Line Developer Console](https://developers.line.biz/console/)。 +2. 選擇對應客戶的 Line Bot Channel。 +3. 進入 **Messaging API** 設定頁面。 +4. 將 **Webhook URL** 設定為： + +``` +https://ching-tech.ddns.net/bot//webhook +``` + +將 `` 替換為該客戶的識別碼（與 nginx 設定中一致）。 + +5. 開啟 **Use webhook** 開關。 +6. 點選 **Verify** 按鈕確認 webhook 可正常連線。 + +### URL 對應關係 + +主站 nginx 會將 webhook 請求的路徑從 `/bot//webhook` 改寫為 `/api/bot/line/webhook`，再轉發到遠端 CTOS。遠端 CTOS 收到的是標準的 Line webhook 路徑，不需要做任何特殊處理。 + +--- + +## 驗證與除錯 + +### 逐步驗證清單 + +部署完成後，按照以下順序逐步確認各環節是否正常。 + +**1. 遠端：確認 CTOS 後端正常運作** + +```bash +curl http://localhost:8088/api/health +``` + +預期回應為 HTTP 200。 + +**2. 遠端：確認 Tailscale 已連線** + +```bash +tailscale status +``` + +應顯示為 online 狀態，並列出 tailnet 中的其他節點。 + +**3. 主站：確認可透過 Tailscale 連到遠端** + +```bash +ping +curl http://:8088/api/health +``` + +**4. 主站：確認 nginx 設定語法正確** + +```bash +sudo nginx -t +``` + +**5. 外部：確認完整路徑可存取** + +```bash +curl https://ching-tech.ddns.net//api/health +``` + +**6. 外部：測試 Line webhook 路徑** + +```bash +curl -X POST https://ching-tech.ddns.net/bot//webhook \ + -H "Content-Type: application/json" \ + -d '{"events":[]}' +``` + +### 常見問題 + +| 症狀 | 可能原因 | 排查方式 | +|------|---------|---------| +| 502 Bad Gateway | 遠端 CTOS 未啟動或 Tailscale 斷線 | 檢查遠端 `systemctl status ching-tech-os` 和 `tailscale status` | +| 404 Not Found | nginx location 路徑設定錯誤 | 確認 `CLIENT_ID` 在 nginx 設定與 URL 中拼寫一致 | +| WebSocket 連線失敗 | nginx 缺少 Upgrade header | 確認 CTOS 的 location block 包含 `proxy_set_header Upgrade` 和 `Connection "upgrade"` | +| Webhook 簽章驗證失敗 | `X-Line-Signature` header 未傳遞 | 確認 webhook 的 location block 包含 `proxy_set_header X-Line-Signature` | +| 靜態資源 404 | 路徑前綴未正確去除 | 確認 `proxy_pass` 尾部有 `/`（此為 nginx strip prefix 的必要條件） | +| Tailscale 無法連線 | Auth Key 已過期或已使用 | 重新產生 Auth Key，執行 `sudo tailscale up --authkey=` | + +--- + +## 未來規劃 + +- **install-service.sh 參數化**：將 Tailscale 部署整合進安裝腳本，支援路徑參數與 NAS 可選模式，減少手動調整步驟。 +- **管理介面**：在 CTOS 後台新增遠端站點管理功能，可管理路由對應並自動產生 nginx 設定。 +- **Headscale 評估**：當連線設備超過 100 台時，評估遷移到 Headscale（自架 Tailscale 協調伺服器）以降低成本。 From f1ce0d14cc13bcf979a6e92f9d5359d53d6c4ce1 Mon Sep 17 00:00:00 2001 From: copilot-ci Date: Wed, 25 Feb 2026 02:26:26 +0800 Subject: [PATCH 3/3] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20nginx=20?= =?UTF-8?q?=E8=A8=AD=E5=AE=9A=E7=AF=84=E6=9C=AC=E3=80=81module-index=20?= =?UTF-8?q?=E5=8A=A0=E5=85=A5=E9=81=A0=E7=AB=AF=E7=AB=99=E9=BB=9E=E9=80=9F?= =?UTF-8?q?=E6=9F=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 --- docs/module-index.md | 5 +++ scripts/nginx/ctos-remote-site.conf.template | 33 ++++++++++++++++++++ 2 files changed, 38 insertions(+) create mode 100644 scripts/nginx/ctos-remote-site.conf.template diff --git a/docs/module-index.md b/docs/module-index.md index 6438023..de3fd0d 100644 --- a/docs/module-index.md +++ b/docs/module-index.md @@ -338,6 +338,11 @@ services/scheduler.py ← APScheduler 任務定義 5. `frontend/js/share-dialog.js` + `css/share-dialog.css` 6. `frontend/public.html`（公開頁面） +### 「新增遠端 CTOS 站點（Tailscale）」 +1. 遠端主機安裝 Tailscale + CTOS（見 `docs/tailscale-multi-site.md`） +2. 主站 nginx 加入 location block（範本：`scripts/nginx/ctos-remote-site.conf.template`） +3. Line Developer Console 設定 webhook URL + ### 「版本號更新」 同步修改三個檔案： 1. `backend/pyproject.toml` → `version` diff --git a/scripts/nginx/ctos-remote-site.conf.template b/scripts/nginx/ctos-remote-site.conf.template new file mode 100644 index 0000000..2d3fdf5 --- /dev/null +++ b/scripts/nginx/ctos-remote-site.conf.template @@ -0,0 +1,33 @@ +# ============================================ +# 遠端 CTOS: +# Tailscale IP: +# Port: 8088 +# +# 使用方式： +# 1. 複製此檔案，替換 和 +# 2. 將內容加入主站 nginx 設定檔的 server block 中 +# 3. sudo nginx -t && sudo nginx -s reload +# +# 詳細說明見 docs/tailscale-multi-site.md +# ============================================ + +# CTOS 完整應用（strip prefix 後轉發） +location // { + proxy_pass http://:8088/; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; +} + +# Line Bot Webhook（改寫路徑後轉發） +location = /bot//webhook { + proxy_pass http://:8088/api/bot/line/webhook; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Line-Signature $http_x_line_signature; +}