OtterHub 是一款巧妙的Serverless 私人文件儲存工具。它透過整合Cloudflare Pages 與Telegram Bot API，在無需購買VPS 或維護複雜伺服器環境的情況下，為使用者提供一個具備視覺化介面的私有雲盤方案。
對大多數使用者而言，部署Nextcloud 或Alist 等傳統文件管理平台成本較高（需支付伺服器年費）且維護繁瑣。 OtterHub 的核心邏輯是將 前端託管 與資料儲存 完全轉嫁給成熟的雲端服務，解決了「既想要雲端硬碟體驗，又不願維護底層硬體」的痛點。
運作機制
OtterHub 採用了典型的無伺服器架構，具體分工如下：
- 儲存後端： 利用Telegram Bot API 將檔案實際儲存在Telegram 的伺服器中。
- 元資料管理： 使用Cloudflare KV 資料庫記錄檔案名稱、標籤等關鍵索引資訊。
- 使用者介面: 透過Cloudflare Pages 部署前端網頁，實現視覺化操作。
核心技術亮點
不同於簡單的「發圖機器人」或基礎圖床，OtterHub 在架構上解決了多個實際使用中的硬傷，使其真正具備了檔案管理器的能力。
1. 突破20MB 上傳限制
Telegram Bot API 預設單一檔案上傳上限為20MB。 OtterHub 在前端引入了 分片上傳（Chunked Upload）機制，將大檔案切片傳輸後再行拼接。實測可穩定上傳100MB 文件，理論上限支持至1GB。
2. 串流播放與增強管理
得益於對 HTTP Range 請求 的支持，儲存在其中的音視頻檔案支援進度條拖曳和按需加載，無需完整下載即可播放。此外，系統還內建了JWT 密碼登入、30 天回收站機制、基於 nsfw.js 的圖片安全遮罩，並可連動Workers AI 實現圖片的自動描述分析。
OtterHub vs 傳統CF 圖床
| 對比項 | OtterHub | 傳統CF 圖床項目 |
|---|---|---|
| 核心定位 | 全格式私人文件存儲 | 公開圖床/ 輕量分享 |
| 大檔案支持 | 分片上傳（最高1GB），支援流播 | 通常限20MB，無串流媒體優化 |
| 存取控制 | JWT 密碼登錄，私有訪問 | 多為公開訪問，無權限管理 |
| 部署難度 | 中等（需設定KV 與Bot Token） | 較低（多為一鍵部署） |
適用場景與注意事項
儘管架構精巧，但基於第三方API 的方案存在明顯的邊界限制，部署前請知悉：
- 網路環境： 由於依賴Telegram API，在中國大陸地區使用必須具備科學上網環境。
- 資料安全： 儲存方案受Cloudflare 和Telegram 的風控規則影響。嚴禁儲存唯一的絕版商業資料或機密資料，建議僅用於臨時分享或非關鍵素材備份。
- 性能上限： 受限於Cloudflare 免費版Workers/Pages 的執行時間限制，超大檔案傳輸或高並發下載時的穩定性不如商業級物件儲存。
總結：如果你擁有閒置網域、習慣使用Telegram 且厭倦了傳統網盤的限制，OtterHub 是一個極佳的輕量化實驗方案。但若追求「十年穩定」的生產力存儲，建議選擇本地硬碟或Google Drive 等商業雲端服務。
延伸閱讀：若需統一管理多個網盤並願意維護小型伺服器，可參考 Alist 部署與多網盤聚合指南。
獲取方式
免責聲明：本專案為Serverless 架構學習案例，高度依賴第三方API。部署時請務必遵守相關雲端廠商的服務條款（ToS），不建議將其用於儲存高價值商業資料。
