Migração ISPConfig · 16 min read · Sep 12, 2025

Como Migrar ISPConfig 2, ISPConfig 3, Confixx, CPanel ou Plesk para ISPConfig 3.2 ou ISPConfig 3.3 (servidor único)

Neste tutorial, vamos mostrar como usar a Ferramenta de Migração ISPConfig 2.0 para migrar um servidor único para um novo servidor ISPConfig 3.x. A Ferramenta de Migração é parte do kit de ferramentas de Migração ISPConfig, que está disponível aqui.

A Ferramenta de Migração ISPConfig pode ser usada para migrar estes Painéis de Controle de Hospedagem para um servidor ISPConfig 3.x:

  • ISPConfig 2
  • ISPConfig 3 para 3.3
  • Plesk 10 - 12.5
  • Plesk Onyx
  • Confixx
  • Cpanel

Neste tutorial, vamos migrar um servidor ISPConfig 3.x para um novo sistema rodando ISPConfig 3.2 ou 3.3. A migração de outros painéis de controle de hospedagem suportados é feita de forma semelhante. A Ferramenta de Migração irá guiá-lo passo a passo pelo processo de migração.

Pré-requisitos e Notas

  • ISPConfig 3.x no servidor de origem.
  • ISPConfig 3.1.7 ou superior no servidor de destino.
  • PHP 5.3+ com suporte a JSON, mcrypt, OpenSSL e mbstring no servidor de origem.
  • Os servidores antigo e novo não devem estar conectados ao mesmo servidor mestre. Se estiverem conectados ao mesmo mestre, use o ISPCopy em vez disso (que também faz parte do Kit de Ferramentas de Migração).
  • Licença do Kit de Ferramentas de Migração.
  • Certificados Let’s Encrypt: O servidor antigo e o novo devem usar o mesmo cliente Let’s Encrypt. Se seu servidor antigo usa Certbot, certifique-se de que o novo sistema também use Certbot, e não Acme.sh. Se você instalar o novo servidor usando o instalador automático do ISPConfig e seu servidor antigo usa certbot, então use a opção de linha de comando –use-certbot no instalador automático para instalar certbot em vez de acme.sh no novo servidor.
  • Configurações de multiserver: A Ferramenta de Migração é capaz de migrar configurações de multiserver ISPConfig. O destino de tal migração pode ser outra configuração de multiserver, ou você pode mesclar uma configuração de multiserver em uma nova configuração de servidor único. A Ferramenta de Migração deve ser executada em cada nó (antigo) de uma configuração de Multiserver um após o outro, o sistema ISPConfig de destino é ou o nó mestre da nova configuração de multiserver (a Ferramenta de Migração mostrará um diálogo onde você pode selecionar em qual novo nó da configuração de multiserver os dados devem ser migrados) ou o novo servidor único.

Criar um usuário remoto no ISPConfig

Você precisa de um usuário remoto no servidor ISPConfig de destino.

Vá para Sistema -> Usuário Remoto

Adicionar usuário remoto no ISPConfig.

Clique no botão Adicionar novo usuário.

Digite um nome de usuário e senha para o usuário remoto, por exemplo, “remoter” e certifique-se de que você marcou todas as caixas de seleção. Em seguida, clique em “salvar”.

Permissões do usuário remoto

Se você estiver usando uma versão ISPConfig 3.1.11 no servidor de destino, então edite o arquivo / usr /local/ ispconfig /security/security_settings.ini como usuário root:

nano / usr /local/ ispconfig /security/security_settings.ini

e mude os valores de ids_anon_enabled e ids_user_enabled de ‘yes’ para ‘no’.

....  
[ids]  
ids_anon_enabled=no  
ids_anon_log_level=1  
ids_anon_warn_level=5  
ids_anon_block_level=20  
ids_user_enabled=no  
ids_user_log_level=1  
ids_user_warn_level=10  
ids_user_block_level=25  
ids_admin_enabled=no  
ids_admin_log_level=1  
ids_admin_warn_level=5  
ids_admin_block_level=100  
sql_scan_enabled=yes  
sql_scan_action=warn  
apache_directives_scan_enabled=yes  
nginx_directives_scan_enabled=yes  
....

O IDS pode ser habilitado novamente quando a migração estiver concluída. Se você usar ISPConfig 3.1.12 ou mais recente, então essa alteração não é necessária.

Em seguida, verifique se o módulo php-soap está instalado no servidor de destino. Se não estiver instalado, então instale-o agora. No Debian e Ubuntu, você pode instalar o módulo PHP Soap com apt:

apt-get install php-soap

Outro pré-requisito é que o servidor de destino e o servidor de origem devem ter rsync instalado. Verifique com, por exemplo:

rsync --version

em ambos os nós que o rsync está instalado. Se não estiver instalado, então instale o pacote rsync do sistema operacional. Por exemplo, com:

apt-get install rsync

no Debian e Ubuntu ou com:

yum install rsync

no CentOS.

No servidor de destino, pode haver um arquivo /etc/ssh/sshd_config.d/custom.conf criado pelo instalador automático do ISPConfig que impede a Ferramenta de Migração de funcionar. Este arquivo deve ser excluído se existir. Execute este comando no servidor de destino como usuário root para excluir o arquivo:

rm /etc/ssh/sshd_config.d/custom.conf

Todos os passos seguintes são feitos no servidor de origem, a menos que indicado de outra forma.

Baixar e extrair a Ferramenta de Migração

cd /root  
mkdir migration  
cd migration  
wget https://www.ispconfig.org/downloads/ispconfig_migration_toolkit-latest.zip  
unzip ispconfig_migration_toolkit-latest.zip  
mv ispconfig_migration_toolkit/ispc3-migration-tool-*.tar.gz /root/migration/migtool.tar.gz  
tar xzf migtool.tar.gz  
rm -f migtool.tar.gz

Preparar login sem senha (opcional)

Durante a migração, haverá uma conexão SSH para transferir configurações e dados do servidor de origem para o(s) servidor(es) de destino. Para isso, o servidor de origem deve ser capaz de se conectar ao(s) destino(s) sem senha.

Você pode:

  • Configurar o login sem senha por conta própria (adicionar a chave pública do servidor de origem ao arquivo authorized_keys do root do destino).
  • Ou permitir acesso root via ssh ao destino por senha (temporariamente). A Ferramenta de Migração então chamará ssh-keygen e ssh-copy-id para você. Essas são chamadas diretas do sistema, então se você for solicitado pela senha root ssh do destino durante esta etapa, a entrada NÃO é lida pela Ferramenta de Migração, é um prompt direto do comando do sistema ssh-copy-id.

Executar a migração (execução de teste)

./migrate

Se você quiser executar a ferramenta em uma versão PHP específica (por exemplo, PHP 7.4 no Ubuntu 22.04), então use este comando em vez disso:

PHP=/usr/bin/php7.4 ./migrate

O resultado de qualquer um dos comandos acima será assim:

Bem-vindo à Ferramenta de Migração ISPConfig3 V2 Versão 2.0.0

Embora esta ferramenta não altere nada no servidor de origem, você deve
SEMPRE fazer um BACKUP de todos os seus dados antes de migrar para um novo servidor!

Você precisa ter alguns pré-requisitos configurados para usar esta ferramenta:
 * criar um usuário remoto (sistema -> usuários remotos) em seu sistema TARGET ISPConfig3 e conceder TODOS os direitos a ele
 * certifique-se de que este (o sistema ORIGEM) pode acessar a API remota do sistema de DESTINO

* Isenção de Garantias *
ISPConfig renuncia, na máxima extensão autorizada pela lei, qualquer e todas as outras garantias, sejam expressas ou implícitas,
incluindo, sem limitação, quaisquer garantias implícitas de título, não violação, integração, comercialização ou
adequação a um propósito específico.
Ao continuar a usar este software, você concorda com isso.

Primeiro de tudo, a pergunta mais importante:
Você deseja fazer uma migração real ou uma execução de teste? (dry, migrate): dry

Queremos executar no modo de teste primeiro, então digitamos dry aqui.

Os seguintes módulos estão disponíveis:
        1. Migrador de Confixx para ISPConfig 3 (confixx)
        2. Migrador de Plesk (10.5 - 17.5) para ISPConfig 3 (plesk)
        3. Migrador de ISPConfig 2 para 3 (ispconfig2)
        4. Migrador de ISPConfig 3 para ISPConfig 3 (ispconfig3)

Qual deles corresponde ao seu sistema ORIGEM? (confixx, plesk, ispconfig2, ispconfig3): ispconfig3

A Ferramenta de Migração precisa saber qual painel de controle você está usando no seu servidor de origem. Ela tenta reconhecer o módulo necessário no servidor de origem, então você normalmente pode simplesmente pressionar ENTER.

Digite o IP deste servidor (ORIGEM) que é usado para conexões de saída [192.168.10.10]: 123.123.123.123

A Ferramenta de Migração precisa saber qual endereço IP no servidor de origem é usado para conexões de saída, ou seja, qual endereço IP outros servidores verão quando o servidor de origem se conectar a eles. A ferramenta tenta adivinhar o endereço IP, mas você pode precisar alterar o valor se estiver usando uma rede privada, por exemplo.

Nome do usuário remoto do sistema TARGET ISPConfig3 []: remoter
Senha para este usuário remoto []: suaSenhaRemota
URL para o sistema remoto (ex. https://seuDominio.com:8080/remote/) []: https://www.example.com:8080/remote/
Você me deu o usuário remoto 'remoter' com a senha 'suaSenhaRemota'
E eu devo me conectar a 'https://www.example.com:8080/remote/'
Está correto? (y, n): y

Forneça à Ferramenta de Migração os dados do usuário remoto que você criou no destino e confirme sua entrada com “y”. A Ferramenta de Migração então tentará se conectar à API remota do seu sistema de destino.

Agora eu terei que fazer algumas alterações na configuração do seu sistema TARGET ISPConfig3.
        1.) Habilitar o módulo de domínio se necessário
        2.) Remover prefixos de cliente (será desfeito automaticamente no final)
        3.) Habilitar login para contas de email se necessário

Testando conexão MySQL ... OK

Qual é o IP público(!) principal do servidor de destino www.example.com? [123.123.123.123]: [ENTER]

A Ferramenta de Migração irá alterar algumas configurações do ISPConfig no destino (essas alterações não serão feitas quando executadas no modo de teste) e testar a conexão com o servidor MySQL. Ela tenta adivinhar as credenciais do MySQL olhando para alguns arquivos do sistema, mas eventualmente, você será solicitado a fornecer a senha root do MySQL.

Em seguida, você precisa fornecer o IP público do servidor de destino. Ele será pré-carregado do DNS, mas você pode precisar ajustá-lo, especialmente se estiver usando o mesmo nome de host na origem e no destino.

Você deseja que eu sobrescreva/atualize entradas existentes com o mesmo nome? (y, n): y
Você pode agora definir nomes de entrada que NÃO devem ser sobrescritos.
Você deve usar isso se planeja importar dados de vários servidores para uma instalação de multiserver.
Se esta ferramenta encontrar um nome que já está presente, ela ATUALIZA os dados com os dados da ORIGEM!
Se esta ferramenta encontrar um nome que você marcou como não sobrescrever, ela ou
         - adiciona um _2, _3 etc. a este nome e cria uma nova entrada, ou
         - adiciona um prefixo de servidor se especificado pelo argumento --server-prefix

A Ferramenta de Migração permite mesclar vários servidores em um único destino. Ao fazer isso, pode ser que haja nomes de usuário conflitantes nos servidores de origem, por exemplo, se você tiver dois bancos de dados com o nome “testdatabase”. Se você responder “y” a esta pergunta, então o segundo banco de dados substituirá o primeiro. Se você responder “n”, então o nome do segundo banco de dados será alterado para “testdatabase_2”.

Certifique-se de responder “y” ao fazer uma migração de servidor único, porque caso contrário, você criará duplicatas se executar a ferramenta de migração várias vezes na mesma origem.

Atualmente você tem 0 nome(s) de usuário FTP marcados:

Você pode agora adicionar mais nomes a esta lista. Basta digitá-los um por um ou fornecer uma lista separada por vírgulas.
Para excluir um ou mais nomes da lista, prependa um /DELETE à sua entrada.
Para limpar todos os nomes da lista, digite /CLEAR.
Uma entrada em branco prossegue para a próxima etapa.
Sua escolha : [ENTER]

A Ferramenta de Migração oferece a opção de marcar alguns nomes de usuário para FTP, bancos de dados, clientes etc. como “reservados”. Isso significa que eles não serão sobrescritos, conforme mencionado na seção acima. Normalmente, você deixará isso em branco, mas em alguns casos, pode querer impedir nomes de usuário como “admin” ou “administrator” de serem importados. Então você pode digitá-los aqui, o que resultará na renomeação dos nomes importados para “admin_2” etc.

A pergunta é repetida para os diferentes tipos de serviço (FTP, banco de dados, clientes, usuários de email).

Qual é o nome do banco de dados da sua instalação ISPConfig 3 ORIGEM? [dbispconfig]: [ENTER]

A ferramenta agora pergunta pelo nome do banco de dados no servidor de origem que contém os dados do painel de controle. Verifique se o banco de dados reconhecido está correto e altere se necessário.

Você deseja migrar apenas alguns serviços ou tudo?                                                                 
Serviços válidos são: cliente, web, email, ftp, banco de dados, cronjob, dns, cobrança                                               
Por favor, insira um ou mais serviços (separados por vírgulas) ou deixe em branco para todos: [ENTER]

A nova Ferramenta de Migração é capaz de migrar apenas um subconjunto de serviços, por exemplo, migrar apenas contas de email e pular webs etc.

Queremos migrar todos os serviços, então deixamos a entrada em branco e pressionamos ENTER.

Para copiar os dados da web, preciso de acesso SSH ao servidor web de destino.
Por favor, certifique-se de que o login root via SSH está permitido. No destino, abra /etc/ssh/sshd_config
e defina PermitRootLogin como yes ou without-password.
Você pode reverter isso assim que a migração estiver concluída.

Qual é o ip do servidor web de destino para conectar via SSH? [123.123.123.123]: [ENTER]
Qual é a porta SSH? [22]: [ENTER]

Para copiar dados da web, email e banco de dados, a Ferramenta de Migração requer acesso SSH sem senha ao servidor de destino. Você precisa fornecer o ip e a porta que a origem deve conectar. Se você ainda não configurou o acesso sem senha, será solicitado a fornecer a senha root SSH do servidor de destino.

Testando conexão MySQL ... OK

Iniciando chamadas de API.

[50/74]  processando mydomain.com

A ferramenta agora começará a criar/atualizar todas as entradas no ISPConfig de destino. No modo de teste, não mudará ou copiará nada, é claro. Aguarde até que as chamadas da API sejam concluídas.

Processamento de entradas concluído.                                                                                               
=============
Execução da ferramenta de migração concluída.

Uma vez que a ferramenta de migração terminou a execução de teste sem erros, podemos continuar com a migração real.

Executar a migração

./migrate

Se você quiser executar a ferramenta em uma versão PHP específica (por exemplo, PHP 7.4 no Ubuntu 22.04), então use este comando em vez disso:

PHP=/usr/bin/php7.4 ./migrate

O resultado de qualquer um dos comandos acima será assim:

    Bem-vindo à Ferramenta de Migração ISPConfig3 V2 Versão 2.0.0rc2

Embora esta ferramenta não altere nada no servidor de origem, você deve
SEMPRE fazer um BACKUP de todos os seus dados antes de migrar para um novo servidor!

Você precisa ter alguns pré-requisitos configurados para usar esta ferramenta:
 * criar um usuário remoto (sistema -> usuários remotos) em seu sistema TARGET ISPConfig3 e conceder TODOS os direitos a ele
 * certifique-se de que este (o sistema ORIGEM) pode acessar a API remota do sistema de DESTINO

* Isenção de Garantias *
ISPConfig renuncia, na máxima extensão autorizada pela lei, qualquer e todas as outras garantias, sejam expressas ou implícitas,
incluindo, sem limitação, quaisquer garantias implícitas de título, não violação, integração, comercialização ou
adequação a um propósito específico.
Ao continuar a usar este software, você concorda com isso.

Primeiro de tudo, a pergunta mais importante:
Você deseja fazer uma migração real ou uma execução de teste? (dry, migrate): migrate

Desta vez, respondemos ao prompt com “migrate” e respondemos às perguntas exatamente como fizemos durante a execução de teste. A ferramenta terá suas entradas da execução de teste preenchidas, então você poderá pressionar ENTER na maioria das vezes.

Testando conexão MySQL ... OK
Copiando arquivos Let'sEncrypt para o destino ... OK

Iniciando chamadas de API.
[9/11]  processando [email protected] (web213p41)

Desta vez, o processo levará um pouco mais de tempo, pois estão sendo feitas chamadas reais da API. Aguarde até que o processo termine.

Processamento de entradas concluído.                                                                                               
A fila de trabalho do ISPConfig de destino tem 35 entradas restantes. Aguardando ..

Para garantir que todos os caminhos sejam criados no destino, a Ferramenta de Migração aguarda que o ISPConfig processe todas as solicitações antes de continuar.

[INFO] A fila de trabalho do ISPConfig de destino foi concluída. Continuando.

[19/935] Sincronizando /var/www/clients/client26/web21/web para /var/www/clients/client1424/web21/

Agora a ferramenta sincroniza todos os caminhos (web, email) e copia o conteúdo do banco de dados para o servidor de destino. Este processo pode levar um tempo dependendo da quantidade de dados que você possui.

Se você quiser fazer a sincronização real dos dados em uma etapa separada, pode pular isso executando ./migrate –no-syncjobs em vez de apenas ./migrate

Etapas finais

A Ferramenta de Migração irá redefinir os valores que alterou no início (por exemplo, prefixos de cliente).

Dependendo do seu painel de controle de origem, a Ferramenta de Migração ativou o módulo de domínio no seu ISPConfig de destino. Isso significa que os domínios só podem ser usados para sites, domínios de email etc. se forem atribuídos por um administrador primeiro (usando Cliente -> Domínios). Se você não deseja usar o módulo de domínio, pode desativá-lo em Sistema -> Configurações da Interface -> Aba “Domínios”.

Por fim, verifique o migrate.log que foi criado para entradas que têm marcadores [ERROR] ou [WARNING]. Esses indicam problemas durante o processo de migração.

Re-Sincronizar seu destino

Re-Sincronizar contas e configurações

Se as coisas mudaram no painel de controle de origem após você ter feito a migração, você pode simplesmente executá-la novamente. A Ferramenta de Migração atualizará todas as entradas com as novas configurações do seu servidor de origem. E adicionará novas entradas que foram criadas nesse meio tempo. Entradas excluídas na origem não serão excluídas no destino!.

Re-Sincronizar dados

Se você deseja apenas re-sincronizar os dados para web, email e bancos de dados, pode executar ./migrate –syncjobs. Isso pulará todas as etapas de migração e apenas executará a sincronização de sites, bancos de dados e emails.

Você também pode re-sincronizar apenas um dos serviços, por exemplo, ./migrate –syncjobs –only=database. Isso pulará a re-sincronização dos dados do site e emails.

Opções avançadas

Para obter uma lista de opções avançadas que permitem migrar, por exemplo, sites únicos, domínios de email ou clientes, use a opção –help.

./migrate --help

As opções atuais são:

Uso:  migrate 
        Lista de opções:
        --help
                        Mostrar esta tela
        --server-prefix=
                Usar o prefixo dado para nomes de usuário conflitantes, se mais conflitos ocorrerem,
                adicione _2 _3 _4 ... ao nome de usuário
        --source-temp-dir=
                Defina um diretório temporário diferente para ações no servidor de origem do que /tmp
        --target-temp-dir=
                Defina um diretório temporário diferente para ações no servidor de destino do que /tmp
        --syncjobs
                Não execute o processo de migração, apenas re-sincronize todos os dados
                (arquivos da web, conteúdos do banco de dados)
        --no-syncjobs
                Apenas faça a migração, não copie nenhum arquivo de dados ou
                conteúdos do banco de dados para o destino
        --ignore-sync-errors
                Não interrompa o processamento de syncjobs se ocorrer um erro. Isso
                pode ser útil, por exemplo, se um comando como chattr não funcionar corretamente no
                servidor de destino.
        --confixx-no-domain
                Em uma migração confixx (servidor de origem), não crie um
                site fictício que contenha todos os outros domínios desse cliente como domínios alias.
                O confixx usa uma abordagem diferente para armazenar e
                gerenciar domínios, então não há um "domínio principal", mas um hosting em vez disso, que tem todos
                os domínios atribuídos.
                Em servidores confixx onde os clientes têm apenas um único
                domínio, pode ser melhor não
                criar um site fictício com um único alias, mas usar o
                domínio como site em vez disso.
        --only=client|web|mail|ftp|database|cronjob|dns|billing
                Apenas migre o(s) serviço(s) dado(s) e pule os outros.
                Pode ser fornecido várias vezes.
        --exclude=client|web|mail|ftp|database|cronjob|dns|billing
                Migre todos os serviços, exceto o(s) dado(s). Pode ser
                fornecido várias vezes.
        --only=/--exclude= em --syncjobs
                Ao limitar a re-sincronização a serviços únicos, apenas web,
                email, banco de dados, sistema são válidos.
        --only-client=
                Apenas migre um único cliente e seus dados (web, email
                etc.). Isso pode ser usado junto
                com --only= / --exclude= para limitar ainda mais os dados migrados.
        --only-web=
                Apenas migre o domínio dado e seus bancos de dados, contas ftp etc.
                Isso pode ser usado junto com os outros
                --only-x/--exclude-x e --only=/--exclude= opções
                para especificar os dados a serem migrados.
        --only-mail=
                Apenas migre o domínio de email dado e suas contas de
                email, filtro de spam etc.
                Isso pode ser usado junto com os outros
                --only-x/--exclude-x e --only=/--exclude= opções
                para especificar os dados a serem migrados.
        --only-database=
                Apenas migre o banco de dados dado e seu site pai.
                Isso pode ser usado junto com os outros
                --only-x/--exclude-x e --only=/--exclude= opções
                para especificar os dados a serem migrados.
        --only-dns=
                Apenas migre a zona DNS dada e seus registros DNS.

                As opções acima também podem ser usadas de forma oposta,
                usando --exclude-client, --exclude-web,
                --exclude-mail, --exclude-database, --exclude-dns
                AVISO! Os clientes SEMPRE devem ser migrados, caso contrário,
                você terá todos os dados migrados atribuídos
                ao usuário admin em vez do cliente!
Share: X/Twitter LinkedIn
#Migração ISPConfig

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.