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 PageComparação de Métodos de Instalação e Versões
Next PageInstalação com create-nocobase-app
Aviso de tradução por IA

Esta documentação foi traduzida automaticamente por IA.

#Instalação do Docker

Pré-requisitos
  • Você já tem o Docker e o Docker Compose instalados.
  • Certifique-se de que o serviço Docker esteja em execução.

#1. Crie o arquivo docker-compose.yml

# Crie uma pasta chamada my-project (ou outro nome de sua preferência) para armazenar os arquivos de sistema gerados pelo NocoBase.
mkdir my-project && cd my-project

# Crie um arquivo docker-compose.yml vazio.
vi docker-compose.yml

#2. Configure o docker-compose.yml

Escolha uma versão do NocoBase (Comparativo de Versões) e o tipo de banco de dados, depois copie a configuração correspondente para o seu arquivo docker-compose.yml.

Notas de Configuração
  • Escolha uma imagem: latest latest-full beta beta-full alpha alpha-full 1.7.14 1.7.14-full
    • Para ambientes de produção, é recomendado fixar uma versão numérica específica para evitar atualizações automáticas não intencionais. Ver todas as versões
    • Imagem do Alibaba Cloud: nocobase/nocobase:latest-full
    • Imagem do Docker Hub: nocobase/nocobase:latest-full
    • A imagem full inclui o cliente PostgreSQL 16/17, cliente MySQL 8.0, cliente Oracle 19.25 (necessários para os plugins de gerenciamento de backup e migração), além do LibreOffice (necessário para impressão de modelos em PDF).
    • Se precisar criar sua própria imagem, você pode consultar os Dockerfiles oficiais (versão slim) e Dockerfile-full (versão completa).
  • Modifique APP_KEY: Por favor, substitua your-secret-key por uma string aleatória. Ela é usada para criptografar informações sensíveis, como tokens de usuário.
  • Use um banco de dados existente: Se você já tem um serviço de banco de dados, altere DB_HOST para o endereço do seu servidor de banco de dados e remova ou comente a configuração do serviço de banco de dados (por exemplo, os serviços postgres, mysql ou mariadb).
  • Mapeamento de portas: Por padrão, a porta 80 do contêiner é mapeada para a porta 13000 do host. Você pode modificá-la conforme sua necessidade.
Versão Beta (2.0-beta)
Versão Alpha (2.0-alpha)
Versão Latest (1.9)
PostgreSQL
MySQL
MariaDB
networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:beta-full
    restart: always
    networks:
      - nocobase
    depends_on:
      - postgres
    environment:
      # Chave da aplicação, usada para gerar tokens de usuário, etc.
      # Se a APP_KEY for alterada, os tokens antigos se tornarão inválidos.
      # Pode ser qualquer string aleatória, e certifique-se de que não seja vazada.
      - APP_KEY=your-secret-key
      # Tipo de banco de dados, suporta postgres, mysql, mariadb
      - DB_DIALECT=postgres
      # Host do banco de dados, pode ser substituído pelo IP de um servidor de banco de dados existente.
      - DB_HOST=postgres
      # Porta do banco de dados
      - DB_PORT=5432
      # Nome do banco de dados
      - DB_DATABASE=nocobase
      # Usuário do banco de dados
      - DB_USER=nocobase
      # Senha do banco de dados
      - DB_PASSWORD=nocobase
      # Fuso horário, por favor, altere para o seu fuso horário local, por exemplo, America/Sao_Paulo
      - TZ=Etc/UTC

    volumes:
      - ./storage:/app/nocobase/storage
    ports:
      - '13000:80'
    # init: true

  # Se você usar um serviço de banco de dados existente, pode optar por não iniciar o postgres.
  postgres:
    image: postgres:16
    restart: always
    command: postgres -c wal_level=logical
    environment:
      POSTGRES_USER: nocobase
      POSTGRES_DB: nocobase
      POSTGRES_PASSWORD: nocobase
    volumes:
      - ./storage/db/postgres:/var/lib/postgresql/data
    networks:
      - nocobase

#3. Instale e Inicie o NocoBase

# Puxe a imagem mais recente
docker compose pull

# Execute em segundo plano (a instalação será executada automaticamente na primeira vez)
docker compose up -d

# Visualize os logs de instalação e execução
docker compose logs -f app

app-postgres-app-1  | nginx started
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ cross-env DOTENV_CONFIG_PATH=.env node -r dotenv/config packages/app/server/lib/index.js install -s
app-postgres-app-1  | Done in 2.72s.
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ pm2-runtime start --node-args="-r dotenv/config" packages/app/server/lib/index.js -- start
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: Launching in no daemon mode
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] starting in -fork mode-
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] online
app-postgres-app-1  | 🚀 NocoBase server running at: http://localhost:13000/

#4. Faça login no NocoBase

Abra http://localhost:13000 no seu navegador. O usuário e a senha iniciais são admin@nocobase.com e admin123.

Aviso de Segurança da Conta

Após fazer login pela primeira vez, por favor, altere a senha padrão imediatamente para garantir a segurança do sistema.