OtterHub It is a clever serverless private file storage tool. By integrating Cloudflare Pages and the Telegram Bot API, it provides users with a private cloud disk solution with a visual interface without the need to purchase a VPS or maintain a complex server environment.
For most users, deploying traditional file management platforms like Nextcloud or Alist is costly (requiring annual server fees) and cumbersome to maintain. OtterHub's core logic is to... Front-end hosting andData storage By completely transferring the solution to mature cloud services, the pain point of "wanting the cloud storage experience but not wanting to maintain the underlying hardware" is resolved.
Operating mechanism
OtterHub employs a typical serverless architecture, with the following specific division of labor:
- Storage backend: Use the Telegram Bot API to actually store files on Telegram's servers.
- Metadata Management: Use a Cloudflare KV database to record key index information such as filenames and tags.
- user interface: Deploy front-end web pages using Cloudflare Pages to enable visual operations.
Core Technology Highlights
Unlike simple "image-sharing bots" or basic image hosting services, OtterHub has addressed several critical issues in its architecture, giving it true file manager capabilities.
1. Break the 20MB upload limit
The Telegram Bot API has a default single file upload limit of 20MB. OtterHub has introduced [this feature] on its front end. Chunked UploadThe mechanism slices large files for transmission and then reassembles them. Real-world testing shows it can stably upload files up to 100MB, with a theoretical maximum support of 1GB.
2. Streaming media playback and enhancement management
Thanks to HTTP Range Request With support for [unclear - possibly "supporting" or "supporting"], audio and video files stored within can be dragged with a progress bar and loaded on demand, allowing playback without a full download. Furthermore, the system includes built-in JWT password login, a 30-day recycle bin mechanism, and [unclear - possibly "based on" or "based on"]. nsfw.js It provides image security masking and can be linked with Workers AI to achieve automatic image description and analysis.
OtterHub vs Traditional CF Image Hosting
| Comparison items | OtterHub | Traditional CF image hosting projects |
|---|---|---|
| Core positioning | 全格式私人文件存储 | 公开图床 / 轻量分享 |
| 大文件支持 | 分片上传（最高 1GB），支持流播 | 通常限 20MB，无流媒体优化 |
| 访问控制 | JWT 密码登录，私有访问 | 多为公开访问，无权限管理 |
| 部署难度 | 中等（需配置 KV and Bot Token） | 较低（多为一键部署） |
适用场景与注意事项
尽管架构精巧，但基于第三方 API 的方案存在明显的边界限制，部署前请知悉：
- 网络环境： 由于依赖 Telegram API，在中国大陆地区使用必须具备科学上网环境。
- 数据安全： 存储方案受 Cloudflare 和 Telegram 的风控规则影响。严禁存储唯一的绝版商业数据或机密资料，建议仅用于临时分享或非关键素材备份。
- 性能上限： 受限于 Cloudflare 免费版 Workers/Pages 的执行时间限制，超大文件传输或高并发下载时的稳定性不如商业级对象存储。
总结：如果你拥有闲置域名、习惯使用 Telegram 且厌倦了传统网盘的限制，OtterHub 是一个极佳的轻量化实验方案。但若追求“十年稳定”的生产力存储，建议选择本地硬盘或 Google Drive 等商业云服务。
延伸阅读：若需统一管理多个网盘并愿意维护小型服务器，可参考 Alist 部署与多网盘聚合指南。
获取方式
免责声明：本项目为 Serverless 架构学习案例，高度依赖第三方 API。部署时请务必遵守相关云厂商的服务条款（ToS），不建议将其用于存储高价值商业数据。
