O que faz
Sem Python, sem API de bot, sem runtime externo: um único binário estático em Go que faz login numa conta de usuário do Telegram por MTProto e guarda arquivos arbitrários como uploads fragmentados num canal privado.
- Faz login numa conta de usuário do Telegram (telefone → código → senha 2FA opcional), emulando o cliente oficial Telegram Desktop, o que mantém as sessões estáveis e evita conflitos de logout com outros clientes.
- Guarda arquivos como uploads fragmentados (chunks), contornando o limite dos bots: até 2 GB por arquivo, ou 4 GB com o Telegram Premium.
- Cria ou reutiliza seu próprio canal de armazenamento privado, marcado com um sufixo configurável para tocar só nos seus próprios canais.
- Transmite os downloads de volta, lista os itens armazenados e imprime JSON legível por máquina no stdout, fácil de automatizar.
Construído sobre gotd/td (MTProto puro em Go).
Uso
Todo comando imprime um único objeto JSON no stdout ("ok": true | false).
$ mtproto-store send-code --phone +55... # Telegram envia o código $ mtproto-store sign-in --phone +55... --code 12345 [--password 2fa] $ mtproto-store init-storage --title "Backups" # cria o canal privado $ mtproto-store upload --dir ./fotos # envia em chunks {"ok": true}
send-code --phone <number>: inicia o login; o Telegram envia o código.sign-in --phone <number> --code <code> [--password <2fa>]: conclui o login.check-auth(aliasstatus): informa o estado de autenticação.init-storage [--title <title>]: cria ou reutiliza o canal de armazenamento privado.upload --dir <path> [flags]: envia os arquivos de um diretório em chunks.download [flags]: baixa um arquivo armazenado.list-remote(aliaslist-backups): lista os itens armazenados.logout: descarta a sessão local.
Compilação
Compilação cruzada estática para qualquer alvo, sem CGO. Os mesmos binários Linux estáticos rodam no Android (arm64-v8a, armeabi-v7a, x86_64, x86).
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o mtproto-store . # alvo específico (ex.: Android arm64) CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -trimpath -ldflags="-s -w" -o mtproto-store .
go build padrão cerca de 23 MB;
com -s -w -trimpath cerca de 16 MB; depois upx --best --lzma
cerca de 5 a 6 MB. A CI publica binários de release comprimidos com UPX (autodescompacta
na inicialização, sobrecarga desprezível); a versão -s -w sem compressão é a
alternativa para quem prefere não distribuir binários empacotados.
Configuração
Por variáveis de ambiente:
MTPROTO_STORE_STATE(padrão$HOME/.mtproto-store): diretório de estado (sessão, destino, logs).MTPROTO_STORE_TAG(padrãoMTPS): sufixo que marca os canais desta ferramenta.MTPROTO_STORE_API_IDeMTPROTO_STORE_API_HASH: seu próprio par de my.telegram.org (o padrão emula o Telegram Desktop).
api_id /
api_hash em my.telegram.org e revise os Termos do Telegram. Você é
responsável pelo uso que faz da sua conta.
A sessão é uma credencial sensível
0700 e grava a sessão como 0600,
mas a proteção real está em onde você aponta
MTPROTO_STORE_STATE. Mantenha em armazenamento privado.
No Android, prefira o armazenamento Credential-Encrypted (por exemplo
/data/misc_ce/<user>), que só é desbloqueado depois que o usuário se
autentica, ao Device-Encrypted (por exemplo /data/adb),
legível antes do primeiro desbloqueio.
Créditos
O núcleo foi originalmente escrito por Ash (@ash-iir), que projetou o cliente de armazenamento MTProto sobre o qual ele é construído. Todo o crédito do trabalho original é do autor. Este repositório extrai, remove a marca e generaliza esse trabalho numa ferramenta autônoma e reutilizável.