Repolode
AndySkaura

AndySkaura/mifun-storage

Sistema de armazenamento de arquivos pequenos baseado em um canal do Telegram, usado principalmente como hospedagem própria de imagens para blogs e notas em Markdown.

Alternativa open source a:Google Drive

Estrelas
249
Forks
28
Issues abertas
0
Último commit
mês passado

O que é?

O Mifun Storage (米饭云盘) armazena arquivos pequenos em um canal do Telegram e mantém apenas os diretórios, os metadados dos arquivos e os mapeamentos do Telegram no SQLite ou MySQL. Os uploads e downloads são transmitidos via Node.js sem gravar arquivos temporários no disco local, então o servidor da aplicação não precisa de armazenamento local para o conteúdo dos arquivos.

Seu principal uso é como hospedagem pessoal de imagens para blogs, sites estáticos e notas em Markdown. As imagens enviadas recebem um contentToken aleatório e estável, que funciona como URL pública para solicitações de pré-visualização, download e miniatura. O projeto também inclui um gerenciador de arquivos web no estilo Finder, com upload por arrastar e soltar, tags, locais de armazenamento com senhas opcionais e busca global.

Como os arquivos são transferidos pela API oficial do Telegram Bot, os uploads individuais têm limite de 50 MiB e os downloads, de 20 MiB. O projeto é voltado ao uso com baixa concorrência e em uma única instância, não à hospedagem pública de alto tráfego nem à entrega no nível de uma CDN.

Recursos principais

  • 01Armazena o conteúdo dos arquivos em um canal do Telegram e os metadados no SQLite ou MySQL 8.x.
  • 02Transmite uploads e downloads sem gravar arquivos temporários no disco.
  • 03Oferece links públicos estáveis para o conteúdo, com endpoints de pré-visualização, download e miniatura.
  • 04Oferece um gerenciador de arquivos web com upload por arrastar e soltar, seleção múltipla e tags.
  • 05Oferece locais de armazenamento com permissões de leitura e gravação anônimas e senhas opcionais.
  • 06Inclui opções de implantação com Docker e Docker Compose.

Casos de uso

  • Hospedar imagens para blogs, sites estáticos e notas em Markdown no Obsidian ou Typora.
  • Arquivar logs, relatórios e capturas de tela gerados por tarefas agendadas.
  • Manter uma nuvem pessoal de documentos e arquivos pequenos para uma pessoa ou uma equipe pequena.

Início rápido

  1. 1

    Copie o template de env

    cp .env.example .env
  2. 2

    Instale as dependências

    npm install
  3. 3

    Preencha TELEGRAM_BOT_TOKEN e TELEGRAM_STORAGE_CHAT_ID no .env e, em seguida, inicie o servidor de desenvolvimento

    npm run dev

Antes de usar

  • É necessário ter um Telegram Bot e um Telegram Channel para armazenar arquivos.
  • A Telegram Bot API limita uploads a 50 MiB e downloads a 20 MiB.
  • O SQLite oferece suporte a apenas uma instância do app; para bancos de dados compartilhados, é necessário usar MySQL 8.x.
  • Não foi projetado para hospedagem pública de imagens com alto tráfego nem para colaboração entre vários usuários; não inclui CDN nem alta disponibilidade.

Tópicos

Perguntas frequentes

O que é mifun-storage?
Sistema de armazenamento de arquivos pequenos baseado em um canal do Telegram, usado principalmente como hospedagem própria de imagens para blogs e notas em Markdown. O Mifun Storage (米饭云盘) armazena arquivos pequenos em um canal do Telegram e mantém apenas os diretórios, os metadados dos arquivos e os mapeamentos do Telegram no SQLite ou MySQL. Os uploads e downloads são transmitidos via Node.js sem gravar arquivos temporários no disco local, então o servidor da aplicação não precisa de armazenamento local para o conteúdo dos arquivos.
mifun-storage é gratuito? Qual é a licença?
mifun-storage é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mifun-storage ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de mifun-storage foi em 10 de set. de 2026.
Para que posso usar mifun-storage?
Hospedar imagens para blogs, sites estáticos e notas em Markdown no Obsidian ou Typora. Arquivar logs, relatórios e capturas de tela gerados por tarefas agendadas. Manter uma nuvem pessoal de documentos e arquivos pequenos para uma pessoa ou uma equipe pequena.
Como instalar mifun-storage?
Copie o template de env: cp .env.example .env Instale as dependências: npm install Preencha TELEGRAM_BOT_TOKEN e TELEGRAM_STORAGE_CHAT_ID no .env e, em seguida, inicie o servidor de desenvolvimento: npm run dev
Onde consigo mifun-storage?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AndySkaura/mifun-storage

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados