Instalar e usar
o MBSRS.

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

O assistente usa o username da conta cPanel como ORG e pede 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.com/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

A partir de 1.0.12, o assistente pergunta se pretendes ligar a instalação. A resposta predefinida é não. Para ligar, abre a organização correta na portal MBSRS e gera um código de ligação para essa conta.

Copia o código, responde sim no assistente e cola-o quando for pedido. A entrada fica oculta no terminal. Não coloques o código em argumentos de comandos, URLs ou pedidos de suporte. O convite pode ser usado durante 24 horas; a ligação criada continua válida depois desse prazo. Usa um convite diferente por instalação.

Se preferires ligar depois, usa a mesma conta cPanel:

~/mbsrs/mbsrs monitor-enroll
~/mbsrs/mbsrs monitor-status

Para automação e versões anteriores, mantém-se o convite JSON: guarda-o fora de public_html com permissões 0600 e usa monitor-enroll --config /caminho/convite.json. O modo não interativo não pede códigos. O código inclui o destino do painel e um convite temporário; não é uma chave permanente.

O MBSRS envia por HTTPS estados, datas, versão, âmbito, contagens e resultado da verificação. O registo identifica o servidor e a conta. Não envia conteúdo de email, listas de mailboxes ou credenciais SFTP à app. O painel guarda os relatórios e histórico; não executa comandos na conta. Se a comunicação falhar, os relatórios ficam em fila local e a cópia mantém o seu funcionamento independente.

As organizações e os convites de desenvolvimento e produção são separados. Usa um convite do painel onde pretendes consultar a instalação. A ligação ao painel não comprova recuperação; valida o backup e um restauro isolado.

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

ORG=cpanel-user
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 impedir execuções simultâneas da mesma conta.

~/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 execução ativa, valida a configuração e troca a versão ativa atomicamente. A sequência de releases é independente da versão pública.

Consulta a versão disponível no manifesto oficial de releases. Usa o lançador existente para atualizar, mantendo configuração, credenciais e histórico.

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.

Endereço de distribuição

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/.

Exportar a cópia atual para um ensaio

Na versão 1.0.18 ou posterior, executa na conta de origem:

~/mbsrs/mbsrs restore-export --destination "$HOME/mbsrs-restore-check"

A pasta de destino não pode existir. A pasta superior deve existir e ser privada, fora dos diretórios públicos e das mailboxes. O comando lê o arquivo atual da seleção configurada, exporta para mail/ e compara os bytes por SHA256. Não escreve na origem nem no arquivo. A exportação usa o bloqueio da conta para impedir uma cópia em simultâneo.

Consulta o receipt.json: só verified_export confirma a conclusão da exportação verificada. Os estados failed e incomplete indicam que o processo não terminou com sucesso. Conserva os recibos e o manifest.jsonl em privado. Se precisares de repetir, escolhe outra pasta nova.

Em 1.0.19, a exportação SFTP usa duas ligações de leitura e uma de inventário. Podes reduzir para uma leitura com --connections 1. Confirma os limites do servidor antes de aumentar o paralelismo.

Validar o restauro

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. Depois da importação isolada, verifica por IMAP as mensagens, as pastas e os ficheiros de controlo necessários. Regista o âmbito e o resultado do ensaio; uma amostra não valida toda a conta.

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.