Docker でのインストール（外部 Nginx）

この構成では、NocoBase アプリケーションコンテナと Nginx コンテナを分けて実行します。まず Docker でのインストール（内蔵 Nginx）を完了し、その後エントリを外部 Nginx コンテナへ切り替える形です。

この構成を使う場面

NocoBase と Web サーバーを分けて運用したい
Nginx の設定や公開ポートを自分で管理したい
公開するのはプロキシコンテナだけにしたい

docker-compose.yml の例

full イメージが必要な場合は、latest-no-nginx を latest-full-no-nginx に置き換えてください。

13000:80 のマッピングは、ホストの標準ポートを直接使わずにローカルでテストしやすくするためのものです。本番環境では通常 13000:80 のままにはせず、外部 Nginx コンテナをホストの 80 と 443 に直接マッピングします。

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:
      # これはローカルテスト用の例です。
      - "13000:80"
      # 本番環境では通常、次のように変更します。
      # - "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

重要なポイント

NOCOBASE_EXTRACT_CLIENT_ASSETS=true でクライアントアセットを抽出し、プロキシ設定を生成します
NOCOBASE_PROXY_PROVIDER=nginx で Nginx 用の設定を生成します
NOCOBASE_PROXY_UPSTREAM_HOST=app により、Nginx コンテナは Compose ネットワーク経由で app サービスへ接続します
./storage は app と nginx の両方にマウントし、プロキシ設定、静的アセット、アップロードファイルを共有できるようにします
nginx コンテナは nocobase.conf が生成されるまで待機し、その後 ln -sf で /etc/nginx/conf.d/default.conf にリンクしてから起動します
自動生成される設定は、APP_PUBLIC_PATH 配下の /files/ とルートの /files/ の両方を NocoBase に転送し、認証付きのファイルプレビューとダウンロードを処理します
外部 Nginx コンテナを使う場合は、ホスト側のポートマッピングを nginx コンテナで処理します。テスト時は 13000:80 から始められますが、本番環境では通常ホストの 80 と 443 を直接公開し、app サービスはホストへポートを公開する必要はありません

ホストにインストールした Nginx を使う場合

Nginx を Docker コンテナではなくホストに直接インストールしている場合は、別の docker-compose.yml を使うのがおすすめです。この構成では app サービスがホストへ直接ポートを公開し、プロキシ関連の環境変数もホスト視点の値にする必要があります。

次のような docker-compose.yml を使えます。

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

この構成では：

NOCOBASE_PROXY_STORAGE_PATH はホスト上の storage ディレクトリの絶対パスにします
NOCOBASE_PROXY_UPSTREAM_HOST は 127.0.0.1 にします
ローカル Nginx が 127.0.0.1:13000 経由でアプリへアクセスできるよう、app サービスは ports を残します

そのうえで、app コンテナ起動後に設定ファイルが生成されるのを待ち、ホスト側の 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

ホスト側の Nginx が conf.d ディレクトリを使っていない場合は、リンク先を自分の設定パスに置き換えてください。通常は nocobase.conf を http {} から include するファイルとしてそのまま使うほうが安全で、内容を手で分解してコピーするのはおすすめしません。

自動生成された設定を使わずに Nginx を自分で管理する場合は、/files/ と APP_PUBLIC_PATH 配下の対応するルートを、SPA フォールバックルールより前で NocoBase に転送してください。完全な例は Nginx リバースプロキシを参照してください。

#Docker でのインストール（外部 Nginx）

#この構成を使う場面

#docker-compose.yml の例

#重要なポイント

#ホストにインストールした Nginx を使う場合

#関連リンク

Docker でのインストール（外部 Nginx）

この構成を使う場面

docker-compose.yml の例

重要なポイント

ホストにインストールした Nginx を使う場合

関連リンク