• Português

      • Instalação com Docker (Nginx externo)

      Neste modo, o contêiner da aplicação NocoBase e o contêiner do Nginx são executados separadamente. Você pode começar por Instalação com Docker (Nginx embutido) e depois trocar a entrada para um contêiner externo do Nginx.

      Quando usar este modo

      • Você quer implantar o NocoBase e o servidor web separadamente
      • Você quer gerenciar por conta própria a configuração do Nginx e as portas expostas
      • Você quer expor à rede pública apenas o contêiner de proxy

      Exemplo de docker-compose.yml

      Se você precisar da imagem full, substitua latest-no-nginx por latest-full-no-nginx.

      O mapeamento 13000:80 serve apenas para facilitar testes locais, evitando ocupar diretamente as portas padrão do host. Em produção, normalmente não se mantém 13000:80; em vez disso, o contêiner externo do Nginx mapeia diretamente as portas 80 e 443 do host.

      networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:latest-no-nginx
    restart: always
    depends_on:
      - postgres
    networks:
      - nocobase
    environment:
      - APP_KEY=your-secret-key
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase
      - DB_USER=nocobase
      - DB_PASSWORD=nocobase
      - TZ=Etc/UTC
      - NOCOBASE_EXTRACT_CLIENT_ASSETS=true
      - NOCOBASE_PROXY_PROVIDER=nginx
      - NOCOBASE_PROXY_STORAGE_PATH=/app/nocobase/storage
      - NOCOBASE_PROXY_UPSTREAM_HOST=app
    volumes:
      - ./storage:/app/nocobase/storage

  nginx:
    image: nginx:latest
    restart: always
    depends_on:
      - app
    networks:
      - nocobase
    volumes:
      - ./storage:/app/nocobase/storage
    command: >
      /bin/sh -c '
        while [ ! -f /app/nocobase/storage/.nocobase/proxy/nginx/nocobase.conf ]; do
          echo "waiting for nocobase.conf..."
          sleep 1
        done
        rm -f /etc/nginx/conf.d/default.conf
        ln -sf /app/nocobase/storage/.nocobase/proxy/nginx/nocobase.conf /etc/nginx/conf.d/default.conf
        nginx -g "daemon off;"
      '
    ports:
      # Este é apenas um exemplo para testes locais.
      - "13000:80"
      # Em produção, normalmente altere para:
      # - "80:80"
      # - "443:443"

  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

      Pontos-chave

      • NOCOBASE_EXTRACT_CLIENT_ASSETS=true extrai os recursos do cliente e gera a configuração do proxy
      • NOCOBASE_PROXY_PROVIDER=nginx indica que a configuração do Nginx deve ser gerada
      • NOCOBASE_PROXY_UPSTREAM_HOST=app permite que o contêiner do Nginx acesse o serviço app pela rede do Compose
      • ./storage precisa ser montado em app e nginx para compartilhar a configuração do proxy, os arquivos estáticos e os uploads
      • O contêiner nginx deve esperar até que nocobase.conf seja gerado e então criar um link para /etc/nginx/conf.d/default.conf com ln -sf
      • A configuração gerada encaminha ao NocoBase tanto a rota /files/ sob APP_PUBLIC_PATH quanto a rota /files/ na raiz, permitindo pré-visualizações e downloads autenticados
      • Se você usar um contêiner externo do Nginx, deixe o contêiner nginx cuidar do mapeamento da porta do host. Para testes, você pode começar com 13000:80; em produção, normalmente exponha diretamente as portas 80 e 443 do host, enquanto o serviço app não precisa expor sua porta para o host

      Se você usar Nginx local no host

      Se o seu Nginx estiver instalado diretamente no host e não rodando em um contêiner Docker, é melhor usar um docker-compose.yml separado. Nesse modo, o serviço app precisa expor uma porta para o host, e as variáveis do proxy devem usar valores do ponto de vista do host.

      Você pode usar um docker-compose.yml como este:

      networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:latest-no-nginx
    restart: always
    depends_on:
      - postgres
    networks:
      - nocobase
    environment:
      - APP_KEY=your-secret-key
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase
      - DB_USER=nocobase
      - DB_PASSWORD=nocobase
      - TZ=Etc/UTC
      - NOCOBASE_EXTRACT_CLIENT_ASSETS=true
      - NOCOBASE_PROXY_PROVIDER=nginx
      - NOCOBASE_PROXY_STORAGE_PATH=/path/to/your-project/storage
      - NOCOBASE_PROXY_UPSTREAM_HOST=127.0.0.1
      - NOCOBASE_PROXY_UPSTREAM_PORT=13000
    volumes:
      - ./storage:/app/nocobase/storage
    ports:
      - "13000:13000"

  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

      Nesta variante:

      • NOCOBASE_PROXY_STORAGE_PATH deve ser o caminho absoluto do diretório storage no host
      • NOCOBASE_PROXY_UPSTREAM_HOST deve ser 127.0.0.1
      • O serviço app precisa manter ports, para que o Nginx local consiga acessar a aplicação por 127.0.0.1:13000

      Depois que o contêiner app iniciar, espere a geração do arquivo de configuração e então faça o link para o diretório de configuração local do Nginx:

      while [ ! -f ./storage/.nocobase/proxy/nginx/nocobase.conf ]; do
  echo "waiting for nocobase.conf..."
  sleep 1
done

sudo ln -sf "$(pwd)/storage/.nocobase/proxy/nginx/nocobase.conf" /etc/nginx/conf.d/nocobase.conf
sudo nginx -t
sudo systemctl reload nginx

      Se o Nginx do host não usar o diretório conf.d, substitua o caminho do link pelo seu próprio caminho de configuração. Normalmente é mais seguro manter nocobase.conf como um arquivo incluído a partir do contexto http {} em vez de copiar o conteúdo manualmente.

      Se você mantiver o Nginx por conta própria em vez de usar a configuração gerada, certifique-se de que /files/ e a rota correspondente sob APP_PUBLIC_PATH sejam encaminhadas ao NocoBase antes das regras de fallback da SPA. Consulte Proxy reverso Nginx para ver um exemplo completo.