Guia de divisão de rede
Dividir uma rede Multisite em sites standalone (Pro)
Transforme uma rede WordPress Multisite em instalações single-site separadas — criando um arquivo por site ou extraindo um site de um backup de rede existente. Requer licença Pro ativa com a capability network_split.
O que faz
Objetivo: sair do Multisite e executar cada site (ou os selecionados) como sua própria instalação WordPress. O Multisite Migrate Pro suporta dois fluxos de operador. Ambos mantêm a regra um destino = uma execução — restaure ou instale uma vez por host de destino.
| Fluxo | Ponto de partida | Resultado |
|---|---|---|
| Split backup | Rede ativa (Network Admin) | N arquivos completos (um por site selecionado) |
| Extract | Arquivo existente com escopo de rede | Um site rebaixado a standalone no destino |
Qual caminho escolher?
- Prefira split backup quando ainda tiver Network Admin na origem e quiser um conjunto limpo de arquivos por site antes de desmontar a rede.
- Prefira extract quando já tiver um backup completo de rede (ou multi-site) e não quiser executar N backups de novo — reutilize esse arquivo e escolha um blog de origem por destino.
- Blog 1 / site principal é suportado em ambos os caminhos. Mídia do site principal costuma ficar em
uploads/(não emuploads/sites/1/); extract mantém essa árvore quando escolhe o blog ID 1.
Requisitos
- ZIP do plugin Pro + licença Pro ativa. A capability
network_splitdeve aparecer após ativar/atualizar. Chaves Pro antigas podem precisar de Settings → General & License → Re-activate / Refresh. - Network Admin na origem para split backup.
- Disco — o split multiplica o uso: aproximadamente sites × tamanho do arquivo × 1,5 localmente. O plugin bloqueia o início se o espaço livre for insuficiente (destinos somente na nuvem ignoram o bloqueio local rígido).
- Caminho de servidor vazio — extract via instalador também requer a capability Pro
installer. - Não no Free ou Plus — as opções permanecem bloqueadas até o Pro estar ativo.
Caminho A — Um arquivo por site (split backup)
Cria um job de backup completo normal para cada site selecionado, um após o outro. Arquivos concluídos permanecem mesmo se um site posterior falhar.
Passos (interface admin)
- Na rede Multisite, abra MM Pro → Backups → Backup agora.
- Em escopo, escolha Um arquivo por site (split).
- Selecione os sites a incluir, ou deixe «all accessible» selecionado. Revise o aviso de disco (o uso escala com a quantidade de sites).
- Se deixar mais de cinco sites desmarcados sem intenção «all», confirme com a caixa confirm all quando solicitado.
- Escolha perfil / destino (local ou nuvem em destinos Plus+) → Start.
- Acompanhe o painel de progresso do split. Os sites rodam sequencialmente (não em paralelo).
- Ao concluir, baixe ou mantenha cada arquivo em Backups. Restaure cada arquivo uma vez na própria instalação WordPress (ou instalador de servidor vazio), como qualquer outro backup single-site.
Se um site falhar no meio do split
- Arquivos concluídos permanecem válidos — não os exclua.
- No painel de progresso clique em Continue with remaining sites (ou WP-CLI
split-resume --yes). - Apenas blogs não concluídos são executados de novo. Use Cancel somente se quiser parar o orquestrador por completo.
Depois restaure
Para cada instalação de destino: importe/restaure o arquivo daquele site, mapeie URL antiga → nova e conclua o job. Repita por host. Não há «instalar todos os destinos em um clique».
Caminho B — Extrair um site de um arquivo de rede
Use quando o arquivo ainda contém toda a rede (ou vários blogs) e o destino deve virar um WordPress single-site.
Passos (restauração do plugin)
- No destino (ou após import), abra Importaçãoaçãoaçãoaçãoação & Restore / o diálogo de restauração para um arquivo com escopo de rede.
- Escolha a topologia Extrair um site como standalone.
- Selecione o site de origem (blog ID) na lista do arquivo.
- Mapeie apenas a URL antiga → nova desse site.
- Inicie a restauração. Tabelas e uploads de outros blogs são ignorados; o site é rebaixado a standalone.
- Após sucesso, use Next site from this archive (quando exibido) para continuar com outro blog no próximo destino — ou reabra Extract e escolha o próximo blog ID.
Passos (instalador de servidor vazio)
- Envie o arquivo de rede + o PHP do instalador ao host vazio (fluxo instalador Pro).
- Na interface migrate/deploy escolha Extrair um site como standalone, selecione o blog de origem, mapeie a URL e execute.
- Repita em cada host vazio para os blogs restantes (mesmo arquivo, blog de origem diferente).
Após cada destino
- Faça login, verifique as URLs em Settings → General.
- Salve os permalinks novamente. Confira mídia e menus.
- Execute um backup local novo na instalação.
- Remova o PHP do instalador da raiz web ao terminar (caminho de servidor vazio).
Verificar URLs restantes e reparar
Após extract (ou qualquer mudança de URL), analise domínios antigos restantes antes do replace em massa:
- Abra as ferramentas de verificação pós-migração na interface, ou execute WP-CLI
migration-verify/ verify MCP (mostre o relatório primeiro). - Revise os achados. Só então confirme search-replace (
search-replace --yesou confirmação na interface). - Nunca corrija automaticamente às cegas — confirmação é obrigatória.
WP-CLI e MCP
Requer Pro CAP_CLI / MCP mais CAP_NETWORK_SPLIT. Comandos destrutivos precisam de flag de confirmação explícita.
| Tarefa | Exemplo |
|---|---|
| Iniciar split | wp multisite-migrate split-network --yes |
| Status | wp multisite-migrate split-status |
| Retomar restantes | wp multisite-migrate split-resume --yes |
| Cancelar | wp multisite-migrate split-cancel --yes |
| Restauração extract | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes |
| Verificar / reparar | migration-verify then search-replace --yes |
Receitas completas: Guia WP-CLI. Clientes MCP usam as abilities correspondentes com confirm:true em escritas — veja Conectar AI.
O que não é
- Não é um clique que instala todos os destinos de uma vez.
- Não são backups filhos em paralelo (sites rodam um após o outro).
- Não é Free/Plus.
- Não é interface domain-map / sunrise — mapeie URLs por destino você mesmo.
- Não é search-replace automático cego após migrar.
Resolução de problemas
- Opção Split / Extract ausente
- Confirme que o ZIP Pro está ativo e que o refresh da licença concede
network_split. Plus e Free nunca desbloqueiam isso. - Início bloqueado por disco
- Libere espaço local ou reduza os sites selecionados. Estimativa: sites × tamanho × 1,5. Destinos somente na nuvem podem ignorar o bloqueio local rígido.
- Site filho falhou
- Use Continue with remaining sites /
split-resume. Mantenha arquivos concluídos. - Mídia do site errado após extract
- Confirme o blog ID de origem. Mídia do blog 1 costuma ficar em
uploads/, não emuploads/sites/1/. - URLs antigas ainda no conteúdo
- Execute verify, depois search-replace confirmado — veja Verificar URLs restantes.
- Ocupado / outro job em execução
- Só um backup, restauração, split ou push Staging por vez. Aguarde ou cancele o outro job.
Relacionado: Opções de backup — divisão de rede · Restaurar — extract · WP-CLI · Manual do usuário
Perguntas frequentes sobre divisão de rede
Respostas para dividir um Multisite em instalações independentes e extrair um site de um arquivo de rede.
A divisão de rede está incluída no Free ou Plus?
Não. Um arquivo por site e extração para autônomo exigem o Pro com o recurso network_split. Atualize a licença se a opção estiver faltando.
Dividir backup ou extração – qual devo usar?
Use o backup dividido quando você ainda tiver administrador de rede e desejar novos arquivos por site. Use a extração quando você já tiver um arquivo de escopo de rede e quiser colocar um blog em um destino de site único sem fazer backup novamente.
Posso instalar todos os destinos de uma só vez?
Não. Um destino equivale a uma restauração ou execução do instalador. Repita por host. Após a extração, use o próximo site deste arquivo para o próximo blog no próximo destino.
E se um site filho falhar durante a divisão?
Os arquivos finalizados ficam. Clique em Continuar com os sites restantes no painel de progresso ou execute split-resume --yes via WP-CLI.
A extração funciona para o ID 1 do blog?
Sim. Os uploads do site principal geralmente ficam em uploads/ em vez de uploads/sites/1/; extract mantém essa árvore quando você seleciona o blog 1.