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），不建议将其用于存储高价值商业数据。
