Como instalar
A versão atual adota a forma de backup e restauração para a implantação. Em versões posteriores, poderemos mudar para a forma de migração incremental, a fim de facilitar a integração da solução aos seus sistemas existentes.
O plugin Gerenciador de Backup agora é de código aberto: o plugin "Gerenciador de Backup" necessário para restaurar a solução agora é de código aberto e está disponível para todas as edições (incluindo a Community). Recomendamos restaurar diretamente por meio deste plugin.
Antes de começar, certifique-se de que:
- Você já possui um ambiente de execução básico do NocoBase. Para a instalação do sistema principal, consulte a documentação oficial de instalação mais detalhada.
- Versão do NocoBase v2.1.0-beta.2 e superior
- Você já baixou o arquivo de backup do sistema CRM: nocobase_crm_v2_backup_260523.nbdata
Instruções Importantes:
- Esta solução foi criada com base no banco de dados PostgreSQL 16, certifique-se de que seu ambiente utilize o PostgreSQL 16.
- DB_UNDERSCORED não pode ser true: Verifique seu arquivo
docker-compose.ymle certifique-se de que a variável de ambienteDB_UNDERSCOREDnão esteja definida comotrue, caso contrário, haverá conflito com o backup da solução, resultando em falha na restauração.
Restaurar usando o Gerenciador de Backup
Este método realiza a restauração com um clique através do plugin "Gerenciador de Backup" integrado ao NocoBase, sendo a operação mais simples. Este plugin agora é de código aberto e está disponível para todas as edições (incluindo a Community).
Características principais
- Vantagens:
- Operação conveniente: Pode ser concluída na interface UI, restaurando completamente todas as configurações, incluindo plugins.
- Restauração completa: Capaz de restaurar todos os arquivos do sistema, incluindo arquivos de impressão de modelos, arquivos enviados em campos de arquivo de coleções, etc., garantindo a integridade funcional.
- Limitações:
- Requisitos rigorosos de ambiente: Exige que o ambiente do seu banco de dados (versão, configurações de sensibilidade a maiúsculas e minúsculas, etc.) seja altamente compatível com o ambiente onde o backup foi criado.
- Dependência de plugins: Se a solução incluir plugins comerciais que você não possui em seu ambiente local, a restauração falhará.
Passos
Passo 1: 【Fortemente recomendado】 Use a imagem full para iniciar a aplicação
Para evitar falhas na restauração devido à falta de um cliente de banco de dados, recomendamos fortemente que você use a versão full da imagem Docker. Ela vem com todos os programas de suporte necessários integrados, para que você não precise realizar configurações adicionais.
Exemplo de comando para baixar a imagem:
Em seguida, use esta imagem para iniciar seu serviço NocoBase.
Nota: Se não usar a imagem
full, você poderá precisar instalar manualmente o cliente de banco de dadospg_dumpdentro do contêiner, um processo complicado e instável.
Passo 2: Ativar o plugin "Gerenciador de Backup"
- Faça login no seu sistema NocoBase.
- Vá em
Gerenciamento de plugins. - Encontre e ative o plugin
Gerenciador de Backup.
Passo 3: Restaurar a partir de um arquivo de backup local
- Após ativar o plugin, atualize a página.
- Vá ao menu à esquerda em
Gerenciamento do sistema->Gerenciador de Backup. - Clique no botão
Restaurar de backup localno canto superior direito. - Arraste o arquivo de backup baixado para a área de upload.
- Clique em
Enviar, e aguarde pacientemente o sistema concluir a restauração; este processo pode levar de alguns segundos a vários minutos.
Observações
- Compatibilidade do banco de dados: Este é o ponto mais crítico deste método. A versão, o conjunto de caracteres e as configurações de sensibilidade a maiúsculas e minúsculas do seu banco de dados PostgreSQL devem corresponder ao arquivo de origem do backup. Especialmente o nome do
schemadeve ser consistente. - Correspondência de plugins comerciais: Certifique-se de que você já possui e ativou todos os plugins comerciais exigidos pela solução, caso contrário, a restauração será interrompida.
Esperamos que este tutorial ajude você a implantar o sistema CRM 2.0 com sucesso. Se encontrar qualquer problema durante o processo, sinta-se à vontade para entrar em contato conosco!
Last updated: 2026-04-02

