🚀 Mudando uma instância madura do Nextcloud para um servidor novo (com Bash & Ansible)

Ilustração: um homem com um laptop em um terraço ao pôr do sol, uma igreja ao fundo

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

(Este artigo é a continuação lógica do script de backup descrito aqui: Backup do Nextcloud como um profissional – automatizado com Bash. Os dois posts andam juntos para completar o fluxo inteiro de migração e recuperação de desastres.)

Depois de vários anos rodando uma confiável instância do Nextcloud — com incontáveis arquivos de usuários, calendários, contatos e pastas compartilhadas excêntricas — chegou a hora de um upgrade. O servidor antigo mostrava sinais da idade, e uma máquina nova e brilhante tinha sido provisionada com Ansible para um recomeço limpo.

Em vez de ficar brincando com exportações manuais, GUIs web instáveis ou plugins de backup no navegador, optei por um script Bash enxuto e eficiente para cuidar da migração inteira. Ele me permitiu levar todo o stack do Nextcloud (arquivos do core, dados dos usuários e banco de dados) para o novo servidor — de forma reproduzível e com o mínimo de downtime.

🧠 O que este script faz

  1. Para os serviços com cuidado no servidor de destino, para evitar problemas de lock de arquivos ou conflitos.
  2. Sincroniza os arquivos da aplicação Nextcloud (sem o diretório data/).
  3. Transfere os dados dos usuários separadamente para o novo caminho de destino.
  4. Restaura o banco de dados a partir de um dump local usando scp e mysql.
  5. Corrige dono/permissões para o acesso do servidor web.
  6. Reinicia o PHP e os serviços web depois que tudo estiver no lugar.
  7. Confirma a conclusão com uma mensagem final de status.

📁 Notas sobre a estrutura de diretórios

Como parte da migração, também mudamos o diretório data/ de lugar para um local dedicado fora do web root do Apache. É uma abordagem mais limpa e mais segura do que ter os dados dos usuários guardados dentro do diretório principal de instalação do Nextcloud (como era antes).

Este script leva essa mudança em conta ao transferir a pasta data/ separadamente e colocá-la em seu novo local externo no servidor de destino.

⚙️ O script de migração

⚠️ Este script apaga e sobrescreve dados no servidor de destino. Faça um backup antes, teste em um sistema de teste e adapte cada caminho ao seu próprio ambiente.

#!/bin/bash

# === CONFIGURATION ===

REMOTE_USER="root"
REMOTE_HOST="your.remote.ip"
REMOTE_SSH_PORT=22
SSH_KEY="$HOME/.ssh/id_rsa"

BACKUP_DIR="/data/backup/nextcloud/instance-a"
REMOTE_NEXTCLOUD_DIR="/var/www/html/nextcloud"
REMOTE_DATA_DIR="/data"
DB_NAME="your.db.name"
DB_USER="your.user"
DB_PASS="********"  # 🔐 Password removed for security
WWW_USER="www-data"

SSH_CMD="ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR $REMOTE_USER@$REMOTE_HOST"

echo "🛑 [1/7] Stopping remote web and PHP services ..."
$SSH_CMD "systemctl stop apache2 2>/dev/null || systemctl stop httpd 2>/dev/null"
$SSH_CMD "systemctl stop php8.2-fpm 2>/dev/null || true"

echo "📤 [2/7] Transferring Nextcloud files (excluding data/) to remote server ..."
rsync -a --delete --exclude "data/" \
  -e "ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR" \
  "$BACKUP_DIR/nextcloud/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_NEXTCLOUD_DIR/"

echo "📤 [3/7] Transferring user data (nextcloud/data/) to remote /data ..."
rsync -a --delete \
  -e "ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR" \
  "$BACKUP_DIR/nextcloud/data/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_DATA_DIR/"

echo "🛢️  [4/7] Transferring and restoring database dump ..."
scp -i "$SSH_KEY" -P $REMOTE_SSH_PORT "$BACKUP_DIR/db.sql" "$REMOTE_USER@$REMOTE_HOST:/tmp/db.sql"
$SSH_CMD "mysql -u '$DB_USER' -p'********' '$DB_NAME' < /tmp/db.sql && rm /tmp/db.sql"

echo "🔒 [5/7] Setting remote file permissions ..."
$SSH_CMD "chown -R '$WWW_USER:$WWW_USER' '$REMOTE_NEXTCLOUD_DIR'"
$SSH_CMD "chown -R '$WWW_USER:$WWW_USER' '$REMOTE_DATA_DIR'"

echo "🚀 [6/7] Starting remote services ..."
$SSH_CMD "systemctl start php8.2-fpm 2>/dev/null || true"
$SSH_CMD "systemctl start apache2 2>/dev/null || systemctl start httpd 2>/dev/null"

echo "✅ [7/7] Remote restore complete. Please verify your Nextcloud instance at: https://$REMOTE_HOST"

🎉 Considerações finais

Migrar uma instância do Nextcloud em produção que existe há anos — com dados reais e usuários reais — pode intimidar. Mas com uma abordagem estruturada e uma automação decente, não precisa ser assim. Graças a este script e a um ambiente de destino limpo baseado em Ansible, o processo inteiro levou menos de 30 minutos e não exigiu nenhum ajuste manual. Nerds, comemorem.

Se você está planejando sua própria migração do Nextcloud, especialmente com grandes volumes de dados e a necessidade de zero erro humano, experimente esta abordagem — e ajuste-a ao estilo da sua infra.

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes