Aviso de tradução por IA

Esta documentação foi traduzida automaticamente por IA.

Variáveis e Segredos

Variáveis e segredosCommunity Edition+

Introdução

Configure e gerencie de forma centralizada as variáveis de ambiente e segredos. Isso é útil para armazenar dados sensíveis, reutilizar configurações e isolar configurações de ambiente.

Diferenças em relação ao .env

CaracterísticaArquivo .envVariáveis e Segredos Configurados Dinamicamente
Local de ArmazenamentoArmazenado no arquivo .env na raiz do projetoArmazenado na tabela environmentVariables do banco de dados
Método de CarregamentoCarregado em process.env usando ferramentas como dotenv durante a inicialização da aplicaçãoLido dinamicamente e carregado em app.environment durante a inicialização da aplicação
Método de ModificaçãoRequer edição direta do arquivo; as alterações só entram em vigor após reiniciar a aplicaçãoSuporta modificação em tempo de execução; as alterações entram em vigor imediatamente após recarregar a configuração da aplicação
Isolamento de AmbienteCada ambiente (desenvolvimento, teste, produção) requer manutenção separada dos arquivos .envCada ambiente (desenvolvimento, teste, produção) requer manutenção separada dos dados na tabela environmentVariables
Cenários AplicáveisAdequado para configurações estáticas fixas, como informações do banco de dados principal da aplicaçãoAdequado para configurações dinâmicas que exigem ajustes frequentes ou estão ligadas à lógica de negócios, como bancos de dados externos, informações de armazenamento de arquivos, etc.

Instalação

Este é um plugin integrado, então você não precisa instalá-lo separadamente.

Uso

Reutilização de Dados de Configuração

Por exemplo, se você tem vários nós de e-mail em um fluxo de trabalho que precisam de configuração SMTP, pode armazenar a configuração SMTP comum em variáveis de ambiente.

20250102181045

Armazenamento de Dados Sensíveis

Armazene informações de configuração de diversos bancos de dados externos, chaves de armazenamento de arquivos na nuvem e outros dados sensíveis.

20250102103513

Isolamento de Configuração de Ambiente

Em diferentes ambientes, como desenvolvimento, teste e produção, usamos estratégias de gerenciamento de configuração independentes para garantir que as configurações e os dados de cada ambiente não interfiram uns nos outros. Cada ambiente tem suas próprias configurações, variáveis e recursos, o que evita conflitos entre os ambientes de desenvolvimento, teste e produção e garante que o sistema funcione como esperado em cada um deles.

Por exemplo, a configuração para serviços de armazenamento de arquivos pode ser diferente entre os ambientes de desenvolvimento e produção, como mostrado abaixo:

Ambiente de Desenvolvimento

FILE_STORAGE_OSS_BASE_URL=dev-storage.nocobase.com
FILE_STORAGE_OSS_BUCKET=dev-storage

Ambiente de Produção

FILE_STORAGE_OSS_BASE_URL=prod-storage.nocobase.com
FILE_STORAGE_OSS_BUCKET=prod-storage

Gerenciamento de Variáveis de Ambiente

20250102155314

Adicionando Variáveis de Ambiente

  • Suporta adição individual e em lote
  • Suporta armazenamento em texto simples e criptografado

20250102155509

Adição Individual

20250102155731

Adição em Lote

20250102155258

Observações

Reiniciando a Aplicação

Após modificar ou excluir variáveis de ambiente, uma notificação para reiniciar a aplicação aparecerá no topo. As alterações nas variáveis de ambiente só entrarão em vigor depois que a aplicação for reiniciada.

20250102155007

Armazenamento Criptografado

Os dados criptografados das variáveis de ambiente utilizam criptografia simétrica AES. A CHAVE PRIVADA para criptografia e descriptografia é armazenada no diretório storage. Por favor, guarde-a com segurança; se for perdida ou sobrescrita, os dados criptografados não poderão ser descriptografados.

./storage/environment-variables/<app-name>/aes_key.dat

Plugins Atualmente Suportados para Variáveis de Ambiente

Action: Requisição Personalizada

20250102180751

Autenticação: CAS

20250102160129

Autenticação: DingTalk

20250102160205

Autenticação: LDAP

20250102160312

Autenticação: OIDC

20250102160426

Autenticação: SAML

20250102160652

Autenticação: WeCom

20250102160758

Fonte de Dados: MariaDB Externo

20250102160935

Fonte de Dados: MySQL Externo

20250102173602

Fonte de Dados: Oracle Externo

20250102174153

Fonte de Dados: PostgreSQL Externo

20250102175630

Fonte de Dados: SQL Server Externo

20250102175814

Fonte de Dados: KingbaseES

20250102175951

Fonte de Dados: API REST

20250102180109

Armazenamento de Arquivos: Local

20250102161114

Armazenamento de Arquivos: Aliyun OSS

20250102161404

Armazenamento de Arquivos: Amazon S3

20250102163730

Armazenamento de Arquivos: Tencent COS

20250102173109

Armazenamento de Arquivos: S3 Pro

Não adaptado

Mapa: AMap

20250102163803

Mapa: Google

20250102171524

Configurações de E-mail

Não adaptado

Notificação: E-mail

20250102164059

Formulários Públicos

20250102163849

Configurações do Sistema

20250102164139

Verificação: SMS Aliyun

20250102164247

Verificação: SMS Tencent

20250102165814

Fluxo de Trabalho

20250102180537