OtterHub 배포 가이드: Cloudflare 및 Telegram을 사용하여 서버리스 개인 스토리지 공간 구축하기

오터허브 이는 스마트한 서버리스 개인 파일 저장 도구입니다. Cloudflare Pages와 Telegram Bot API를 통합하여 사용자가 VPS를 구매하거나 복잡한 서버 환경을 유지 관리할 필요 없이 시각적 인터페이스를 갖춘 개인 클라우드 디스크 솔루션을 제공합니다.

대부분의 사용자에게 Nextcloud나 Alist와 같은 기존 파일 관리 플랫폼을 배포하는 것은 비용이 많이 들고(연간 서버 비용 필요) 유지 관리가 번거롭습니다. OtterHub의 핵심 논리는... 프런트엔드 호스팅 그리고데이터 저장소 솔루션을 성숙한 클라우드 서비스로 완전히 이전함으로써 "클라우드 스토리지 경험은 원하지만 기본 하드웨어를 유지 관리하고 싶지는 않다"는 문제점이 해결됩니다.

작동 메커니즘

OtterHub는 다음과 같은 구체적인 역할 분담을 가진 일반적인 서버리스 아키텍처를 사용합니다.

• 스토리지 백엔드: 텔레그램 봇 API를 사용하여 실제로 파일을 텔레그램 서버에 저장하세요.
• 메타데이터 관리: Cloudflare KV 데이터베이스를 사용하여 파일 이름 및 태그와 같은 주요 인덱스 정보를 기록하세요.
• 사용자 인터페이스: Cloudflare Pages를 사용하여 프런트엔드 웹 페이지를 배포하면 시각적인 작업이 가능해집니다.

핵심 기술 주요 특징

단순한 "이미지 공유 봇"이나 기본적인 이미지 호스팅 서비스와는 달리, OtterHub는 아키텍처상의 몇 가지 중요한 문제를 해결하여 진정한 파일 관리자 기능을 제공합니다.

1. 20MB 업로드 제한을 깨뜨리세요
텔레그램 봇 API는 기본적으로 단일 파일 업로드 용량이 20MB로 제한되어 있습니다. OtterHub는 자사 프런트엔드에 이 기능을 도입했습니다. 청크 업로드이 메커니즘은 대용량 파일을 전송을 위해 여러 부분으로 나눈 다음 다시 합칩니다. 실제 테스트 결과 최대 100MB 크기의 파일을 안정적으로 업로드할 수 있으며, 이론상 최대 1GB까지 지원합니다.

2. 스트리밍 미디어 재생 및 향상 관리
감사합니다 HTTP 범위 요청 [불명확 - "supporting" 또는 "supporting"으로 추정]을 지원하여 저장된 오디오 및 비디오 파일을 진행률 표시줄과 함께 드래그하여 필요에 따라 로드할 수 있으므로 전체 다운로드 없이 재생할 수 있습니다. 또한 이 시스템에는 내장 JWT 암호 로그인, 30일 휴지통 기능 및 [불명확 - "based on" 또는 "based on"으로 추정]이 포함되어 있습니다. nsfw.js 이 기술은 이미지 보안 마스킹 기능을 제공하며, Workers AI와 연동하여 자동 이미지 설명 및 분석을 구현할 수 있습니다.

OtterHub와 기존 CF 이미지 호스팅 비교

적용 시나리오 및 주의 사항

정교한 아키텍처에도 불구하고, 타사 API 기반 솔루션에는 상당한 제약 사항이 있습니다. 배포 전에 이러한 제약 사항을 숙지하시기 바랍니다.

• 네트워크 환경: 텔레그램 API를 사용하기 때문에 중국 본토에서 사용하려면 VPN이 필요합니다.
• 데이터 보안: 스토리지 솔루션은 Cloudflare와 Telegram의 위험 관리 규칙의 영향을 받습니다.고유하고 희귀한 기업 데이터 또는 기밀 정보를 저장하는 것은 엄격히 금지되어 있습니다.이 기능은 중요하지 않은 자료를 일시적으로 공유하거나 백업하는 용도로만 사용하는 것이 좋습니다.
• 성능 한계: 受限于 Cloudflare 免费版 Workers/Pages 的执行时间限制，超大文件传输或高并发下载时的稳定性不如商业级对象存储。

总结：如果你拥有闲置域名、习惯使用 Telegram 且厌倦了传统网盘的限制，오터허브 是一个极佳的轻量化实验方案。但若追求“十年稳定”的生产力存储，建议选择本地硬盘或 Google Drive 等商业云服务。

延伸阅读：若需统一管理多个网盘并愿意维护小型服务器，可参考 Alist 部署与多网盘聚合指南。

获取方式