Docker 安装（外部 Nginx）

这种方式里，NocoBase 应用容器和 Nginx 容器分别运行。你可以先按 Docker 安装（内置 Nginx）完成基础安装，再把入口切换为外部 Nginx 容器。

什么时候用这种方式

希望把 NocoBase 和 Web 服务器分开部署
希望自己维护 Nginx 配置和端口暴露
希望只对外暴露代理容器，应用容器只在内部网络通信

docker-compose.yml 示例

下面的示例使用镜像：nocobase/nocobase:latest-full-no-nginx。

这里的 13000:80 只是为了本地测试方便，避免直接占用宿主机的标准端口。生产环境通常不会继续使用 13000:80，而是让外部 Nginx 直接映射宿主机的 80 和 443。

networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:latest-full-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=Asia/Shanghai
      - 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-full-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=Asia/Shanghai
      - 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
app 服务需要保留 ports，这样宿主机本地 Nginx 才能通过 127.0.0.1:13000 访问到应用

启动 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 下对应的文件路径会转发到 NocoBase，并且这些规则位于 SPA 回退规则之前。完整示例见 Nginx 反向代理。

#Docker 安装（外部 Nginx）

#什么时候用这种方式

#docker-compose.yml 示例

#关键点

#如果使用宿主机本地 Nginx

#相关链接

Docker 安装（外部 Nginx）

什么时候用这种方式

docker-compose.yml 示例

关键点

如果使用宿主机本地 Nginx

相关链接