Os teus emails.
A tua infraestrutura.

curl -fsSL https://mbsrs.mailurity.fmopz.dev/install.sh | bash

O assistente pede organização, destino, autenticação, pasta do arquivo e mailboxes a incluir. Guarda a configuração, testa a ligação, inicializa o destino, mostra o plano e pede confirmação para a primeira cópia e verificação SHA256. O cron só é instalado após sucesso.

1. Executa na conta de origem. Usa as permissões da própria conta, sem root.
2. Escolhe uma pasta privada. O padrão é ~/mbsrs, fora de mail/ e de todos os DocumentRoots.
3. Confirma a identidade SFTP. Compara as fingerprints apresentadas com uma fonte independente do fornecedor.
4. Revê o plano e a primeira cópia. Se houver falha, corrige a causa e retoma com ~/mbsrs/mbsrs setup.

curl -fsSL https://mbsrs.mailurity.fmopz.dev/install.sh -o "$HOME/mbsrs-install.sh"
bash "$HOME/mbsrs-install.sh" \
  --prefix "$HOME/mbsrs" \
  --document-root "$HOME/site.example/public_html"

bash "$HOME/mbsrs-install.sh" --download-only
~/mbsrs/mbsrs setup

bash "$HOME/mbsrs-install.sh" \
  --config "$HOME/private/mbsrs.conf" \
  --non-interactive \
  --no-cron

curl -fsSL https://mbsrs.mailurity.fmopz.dev/install.sh -o "$HOME/mbsrs-install.sh"
bash "$HOME/mbsrs-install.sh" --migrate-from "$HOME/scripts/mbsrs-v5.1"

Indica a pasta que contém a configuração antiga; pode chamar-se mbsrs-v5 ou ter outro nome. A migração importa a configuração, seleção e credencial da própria conta, preservando organização, origem, destino, identidade e histórico.

Após a cópia e verificação, substitui apenas o job reconhecido que aponta exatamente para o mbsrs-cron.sh dessa instalação. Guarda o crontab anterior e mantém os outros jobs. Uma execução 5.x ativa bloqueia a validação; espera que termine e retoma.

Conserva a instalação antiga até validares o novo fluxo. Os logs antigos ficam no lugar; os novos relatórios passam para a nova instalação.

Se a conta SFTP já entra em /…/mbsrs, usa . como raiz e escolhe apenas a subpasta desejada:

ORG=customer-id
REMOTE_ROOT=.
ARCHIVE_PATH=domain.example

Não é acrescentada outra pasta mbsrs, mailsync ou ORG. Podes usar uma estrutura como clients/domain.example. O valor de ORG identifica a origem e não precisa de ser o nome da pasta.

Dentro de mail/, preserva-se a hierarquia das mailboxes selecionadas. history/ e .mbsrs/ fazem parte do formato interno. Para disco local, o administrador define LOCAL_ROOT, LOCAL_MOUNT e o UUID real; ARCHIVE_PATH tem o mesmo significado.

mbsrs/
├── mbsrs                # lançador estável
├── config/              # configuração, seleção e credenciais
├── state/               # instalação, updates e backups de cron
├── logs/                # relatórios e logs diários
├── releases/            # versões do código
└── current              # referência para a versão ativa

Retirar uma mailbox da seleção não remove a sua cópia anterior. Para isolamento entre clientes, usa credenciais SFTP com permissões próprias no servidor; nomes de pastas diferentes não substituem controlo de acesso.

Invoca o lançador ~/mbsrs/mbsrs, em vez de ficheiros dentro de current/. Mantém-se um lock comum em ~/.local/state/mail-export/export.lock para evitar sobreposição com 5.x.

~/mbsrs/mbsrs status
~/mbsrs/mbsrs preflight
~/mbsrs/mbsrs dry-run
~/mbsrs/mbsrs run
~/mbsrs/mbsrs verify

dry-run mostra ficheiros novos, substituídos e desaparecidos sem escrever no destino. run copia as alterações e guarda versões anteriores no histórico. verify compara SHA256 dos conteúdos selecionados, lendo a origem e o destino.

A comparação normal usa tamanho e mtime em segundos. Alterações com ambos iguais exigem verify. Mailboxes ativas podem mudar durante a verificação; escolhe uma janela calma e considera o tráfego e I/O envolvidos.

Ativar e confirmar o cron

~/mbsrs/mbsrs cron-install
crontab -l
# Após 10–15 minutos:
tail -n 100 "$HOME/mbsrs/logs/cron/$(date +%F).log"

O cron corre a cada 10 minutos, após uma execução real bem-sucedida com a configuração atual. Confirma o primeiro [OK] Sync complete. Execuções de cron sobrepostas são ignoradas; isso não equivale a uma nova cópia concluída.

~/mbsrs/mbsrs check-update
~/mbsrs/mbsrs update
~/mbsrs/mbsrs version

O MBSRS consulta releases até uma vez por dia durante operação, autenticação, status ou cron. Uma falha nessa consulta não impede a cópia. Instala uma nova versão apenas quando executas update.

O update verifica a assinatura RSA/SHA256 e a integridade do pacote, prepara o código separadamente, espera até 120 segundos por uma cópia antiga ativa, valida a configuração e troca a versão ativa atomicamente. A sequência de releases é independente da versão pública.

Rollback do código

~/mbsrs/mbsrs rollback

A versão anterior é conservada. Antes da troca, o MBSRS confirma se aceita a configuração atual. Se houver incompatibilidade, mantém o código ativo. O rollback não desfaz sincronizações nem restaura emails.

Mudança futura do domínio de releases

Uma release assinada pode indicar um novo endereço de distribuição. O update aplica-o e comandos posteriores reconciliam o endereço a partir dos metadados assinados. O domínio anterior precisa de permanecer acessível durante a transição, para instalações que ainda não atualizaram.

Transferência interrompida

~/mbsrs/mbsrs recover
~/mbsrs/mbsrs dry-run
~/mbsrs/mbsrs run

recover termina a recuperação de um lote pendente. run também recupera antes de criar um novo plano. dry-run e verify recusam transações pendentes. Não apagues manualmente .mbsrs/transaction/.

Restauro de emails

O restauro é conduzido pelo administrador. Seleciona a geração necessária, trabalha primeiro numa cópia isolada e valida a importação no ambiente Dovecot antes de repor numa mailbox real. O MBSRS não preserva ownership/permissões da origem nem faz um restauro automático.

Marcadores .mbsrs-link representam links da origem e não são mensagens. A publicação é feita por lote, sem um snapshot consistente de toda a árvore. Mensagens criadas e removidas entre execuções podem nunca ser copiadas.