logologo
Começar
Manual
Desenvolvimento
Plugins
API
English
简体中文
日本語
한국어
Deutsch
Français
Español
Português
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
Começar
Manual
Desenvolvimento
Plugins
API
logologo
Como o NocoBase Funciona
Comparação de Métodos de Instalação e Versões

Instalar o NocoBase

Instalação com Docker
Instalação com create-nocobase-app
Instalação a partir do Código-Fonte (Git)
Variáveis de Ambiente

Atualizar o NocoBase

Atualização da Instalação com Docker
Atualização da Instalação com create-nocobase-app
Atualização da Instalação a partir do Código-Fonte (Git)

Implantação

Implantação em Produção

Proxy de Ativos Estáticos

nginx
caddy
cdn

Comandos de Operação Comuns

docker compose
pm2
Como Implantar Mais Rápido
Instalar e Atualizar Plugins
Previous PageComo Implantar Mais Rápido
Aviso de tradução por IA

Esta documentação foi traduzida automaticamente por IA.

#Instalar e Atualizar Plugins

#Plugins Nativos

Os plugins nativos do NocoBase são atualizados automaticamente com a versão do core e não exigem nenhuma ação manual da sua parte.

#Plugins Comerciais

Para instalar e atualizar plugins comerciais, faça login no NocoBase Service e consulte a documentação.

#Plugins de Terceiros

#Instalação de Plugins Online

20251103102344

Atenção

O NocoBase permite a instalação de plugins online pela interface, mas a experiência atual não é a ideal. Os motivos incluem:

  • Devido às limitações do mecanismo de execução de processos do Node.js, após instalar ou atualizar plugins, você precisa parar o processo e, em seguida, executar o comando upgrade para que as alterações entrem em vigor;
  • Em cenários de múltiplas aplicações, a instalação online tem dificuldade em lidar com a sincronização de plugins em várias sub-aplicações simultaneamente;
  • Não há suporte para atualizações de plugins em lote;
  • A instalação ou atualização online pode facilmente causar a interrupção anormal do processo da aplicação.

Por isso, recomendamos usar métodos de linha de comando ou upload manual para instalar e atualizar plugins. Sugerimos integrar isso com fluxos de trabalho de CI/CD, utilizando métodos de linha de comando para baixar, extrair e atualizar plugins, garantindo consistência e confiabilidade em cada implantação de atualização.

#Instalando Plugins via Linha de Comando

yarn pm pull https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz
yarn pm pull /your/path/plugin-auth-cas-1.4.0.tgz

Se o plugin já estiver instalado e precisar ser atualizado, execute o seguinte comando:

yarn nocobase upgrade --skip-code-update

#Upload e Extração Manual

Primeiro, baixe o pacote do plugin para sua máquina local. Em seguida, faça o upload manual e extraia-o para o diretório ./storage/plugins. Se o plugin já estiver habilitado, execute o comando a seguir para concluir a atualização após o upload e a extração.

⚠️ Atenção: Para evitar problemas de cache, certifique-se de que a aplicação NocoBase esteja parada antes de executar.

yarn nocobase upgrade --skip-code-update

#Forma Correta de Extrair um Plugin

O exemplo a seguir demonstra como extrair corretamente um pacote de plugin para o diretório especificado:

mkdir -p /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas && \
  tar -xvzf /downloads/plugin-auth-cas-1.4.0.tgz \
  -C /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas \
  --strip-components=1

Este comando irá extrair o plugin para o diretório especificado sem criar uma camada extra de diretório package.

/my-nocobase/storage/plugins/@nocobase/plugin-auth-cas

#Exemplo de Estrutura de Diretórios Correta

./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.js
./plugin-auth-cas/dist/server/auth.js
./plugin-auth-cas/client.js
./plugin-auth-cas/dist/constants.js
./plugin-auth-cas/dist/externalVersion.js
./plugin-auth-cas/dist/client/index.js
./plugin-auth-cas/dist/index.js
./plugin-auth-cas/dist/server/index.js
./plugin-auth-cas/dist/server/actions/login.js
./plugin-auth-cas/dist/server/plugin.js
./plugin-auth-cas/server.js
./plugin-auth-cas/dist/server/actions/service.js
./plugin-auth-cas/dist/locale/en-US.json
./plugin-auth-cas/dist/locale/ko_KR.json
./plugin-auth-cas/package.json
./plugin-auth-cas/dist/locale/zh-CN.json
./plugin-auth-cas/README.md
./plugin-auth-cas/README.zh-CN.md
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.d.ts
./plugin-auth-cas/dist/server/auth.d.ts
./plugin-auth-cas/client.d.ts
./plugin-auth-cas/dist/constants.d.ts
./plugin-auth-cas/dist/client/index.d.ts
./plugin-auth-cas/dist/client/locale/index.d.ts
./plugin-auth-cas/dist/index.d.ts
./plugin-auth-cas/dist/server/index.d.ts
./plugin-auth-cas/dist/server/actions/login.d.ts
./plugin-auth-cas/dist/client/Options.d.ts
./plugin-auth-cas/dist/server/plugin.d.ts
./plugin-auth-cas/server.d.ts
./plugin-auth-cas/dist/server/actions/service.d.ts
./plugin-auth-cas/dist/client/SigninPage.d.ts
./plugin-auth-cas/LICENSE.txt