AndySkaura/mifun-storage

어떤 프로젝트인가요?

핵심 기능

• 01파일 콘텐츠는 Telegram Channel에 저장하고 메타데이터는 SQLite 또는 MySQL 8.x에 보관합니다.
• 02디스크에 임시 파일을 만들지 않고 업로드와 다운로드를 스트리밍합니다.
• 03미리보기, 다운로드, 썸네일 엔드포인트에서 사용할 안정적인 공개 콘텐츠 링크를 제공합니다.
• 04드래그 앤 드롭 업로드, 다중 선택, 태그 기능을 갖춘 웹 파일 관리자를 제공합니다.
• 05익명 읽기/쓰기 권한을 설정할 수 있고, 선택적으로 비밀번호를 지정할 수 있는 저장 위치를 지원합니다.
• 06Docker 및 Docker Compose 배포 옵션을 제공합니다.

활용 사례

• 블로그, 정적 사이트, Obsidian 또는 Typora의 Markdown 노트에 사용할 이미지를 호스팅합니다.
• 예약 작업에서 생성되는 로그, 보고서, 스크린샷을 보관합니다.
• 개인 사용자나 소규모 팀이 문서와 작은 파일을 보관하는 개인 클라우드로 사용합니다.

빠른 시작

1. 1

   env 템플릿을 복사합니다

   cp .env.example .env
2. 2

   종속성을 설치합니다

   npm install
3. 3

   .env에서 TELEGRAM_BOT_TOKEN과 TELEGRAM_STORAGE_CHAT_ID를 설정한 다음 dev server를 시작합니다

   npm run dev

사용 전 알아둘 점

• !파일을 저장하려면 Telegram Bot과 Telegram Channel이 필요합니다.
• !Telegram Bot API에 따라 업로드는 50 MiB, 다운로드는 20 MiB로 제한됩니다.
• !SQLite는 앱 인스턴스 하나만 지원합니다. 공유 데이터베이스에는 MySQL 8.x가 필요합니다.
• !트래픽이 많은 공개 이미지 호스팅이나 여러 사용자의 공동 작업을 위한 설계가 아닙니다. CDN 또는 고가용성을 지원하지 않습니다.

토픽

자주 묻는 질문

mifun-storage은(는) 무엇인가요?

Telegram Channel을 활용한 소형 파일 저장소로, 주로 블로그와 Markdown 노트의 셀프 호스팅 이미지 호스트로 사용됩니다. Mifun Storage (米饭云盘)는 작은 파일을 Telegram Channel에 저장하고, 디렉터리와 파일 메타데이터, Telegram 매핑 정보만 SQLite 또는 MySQL에 보관합니다. 업로드와 다운로드는 Node.js를 통해 스트리밍되며 로컬 디스크에 임시 파일을 만들지 않으므로, 애플리케이션 서버에 파일 콘텐츠를 저장할 로컬 스토리지가 필요하지 않습니다.

mifun-storage은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mifun-storage은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mifun-storage은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. mifun-storage의 마지막 커밋은 2026년 9월 10일입니다.

mifun-storage은(는) 어디에 사용할 수 있나요?

블로그, 정적 사이트, Obsidian 또는 Typora의 Markdown 노트에 사용할 이미지를 호스팅합니다. 예약 작업에서 생성되는 로그, 보고서, 스크린샷을 보관합니다. 개인 사용자나 소규모 팀이 문서와 작은 파일을 보관하는 개인 클라우드로 사용합니다.

mifun-storage는 어떻게 설치하나요?

env 템플릿을 복사합니다: cp .env.example .env 종속성을 설치합니다: npm install .env에서 TELEGRAM_BOT_TOKEN과 TELEGRAM_STORAGE_CHAT_ID를 설정한 다음 dev server를 시작합니다: npm run dev

mifun-storage은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AndySkaura/mifun-storage