115 lines
6.7 KiB
YAML
115 lines
6.7 KiB
YAML
# =============================================================================
|
||
# Nex Animation Studio · 部署编排(单容器整站:后端 + 前端产物 + SQLite + 进程内调度)
|
||
#
|
||
# 日常命令:
|
||
# docker compose up -d --build 首次部署(构建 + 后台启动)
|
||
# docker compose logs -f app 看日志(首启会打印「导入部署数据包」那一行)
|
||
# docker compose ps 状态(healthy 才算起来)
|
||
# docker compose up -d 改了 .env 之后重跑这条:端口映射是在创建容器时定下的,
|
||
# restart 沿用旧容器配置,改了 PORT 也不会换端口
|
||
# docker compose down 停止并删除容器,数据留在 ./data 与 ./media
|
||
# 打开 http://localhost:8000 默认账号见 BOOTSTRAP_USERNAME / BOOTSTRAP_PASSWORD
|
||
#
|
||
# 为什么只有一个服务:库用 SQLite、任务用 TASK_EXECUTOR=inline(进程内线程池 +
|
||
# app/services/daemon.py 的派发守护线程),前端产物由后端一并托管,
|
||
# 所以不需要 nginx 容器、不需要 Redis、不需要独立 worker/beat。
|
||
# 少三个组件就少三类故障面:没有连不上的 db、没有排队没人消费的 broker、
|
||
# 没有「api 起来了 worker 没起来所以任务永远 pending」。
|
||
# 需要多机 / 多 GPU 扩容时再叠一层(Postgres + Redis + Celery worker + beat):
|
||
# docker compose -f docker-compose.yml -f docker-compose.scale.yml up -d --build
|
||
#
|
||
# 数据分四处 bind mount(都相对本文件,换镜像不动数据):
|
||
# ./data SQLite 库(几 MB~几百 MB) ← 唯一会被写坏的目录,值得单独备份
|
||
# ./media 出片产物与上传素材(只涨不跌) ← 单独一个挂载点:能整目录挪大盘、
|
||
# 能被 rsync/剪辑软件直接读,
|
||
# 和库分开才敢单独做备份与迁移
|
||
# ./scripts/seed 模型配置 + 加密主密钥 + 管理员 ← gitignored 的机密,所以不进镜像层
|
||
# ./models whisper 权重等(可选)
|
||
# 容器首启由 scripts/docker-entrypoint.sh 拿 seed 目录把库灌好(AUTO_SEED 控制)——
|
||
# 「用哪个模型、地址是什么」就是这么进库的,不是从 .env 读的。
|
||
#
|
||
# 配置来源:同目录 .env(compose 会替变量插值读它,并整份注入容器)。
|
||
# 下面 environment 里点名的键是例外——容器里的路径和宿主机不是一回事,必须覆盖。
|
||
# .env 里不再放模型配置(VIDEO_* / COMFYUI_* / TTS_*),换 ComfyUI 地址去页面改。
|
||
# 需要 Docker Compose ≥ v2.24(env_file 的 required: false 写法)。
|
||
# =============================================================================
|
||
name: nex-animation
|
||
|
||
services:
|
||
app:
|
||
build:
|
||
context: .
|
||
args:
|
||
# 基础镜像与 pip/npm 源都可以在 .env 里覆盖:直连 docker.io / npmjs 很慢时先探好再构建
|
||
BASE_IMAGE: "${BASE_IMAGE:-python:3.12-slim}"
|
||
NODE_IMAGE: "${NODE_IMAGE:-node:22-alpine}"
|
||
PIP_INDEX_URL: "${PIP_INDEX_URL:-https://pypi.tuna.tsinghua.edu.cn/simple}"
|
||
NPM_REGISTRY: "${NPM_REGISTRY:-https://registry.npmmirror.com}"
|
||
# apt 源只有装 ffmpeg 这一层用得到;默认官方源,国内服务器直连不动时再覆盖
|
||
APT_MIRROR: "${APT_MIRROR:-deb.debian.org}"
|
||
image: nex-animation:latest
|
||
container_name: nex-animation
|
||
restart: unless-stopped
|
||
env_file:
|
||
- path: .env
|
||
required: false # 空机器上先起来再配模型,别让缺 .env 变成起不来
|
||
environment:
|
||
# ---- 容器内路径:宿主 .env 里写的是 ./media、./nex_animation.db,直接透传会漂 ----
|
||
# 库落 ./data,产物落 ./media:两个挂载点各管各的,理由见文件头与 Dockerfile。
|
||
DATABASE_URL: "${APP_DATABASE_URL:-sqlite:////app/data/nex_animation.db}"
|
||
MEDIA_ROOT: "${APP_MEDIA_ROOT:-/app/media}"
|
||
# ---- 容器内永远监听 8000:端口一节写的 PORT 是「对外映射到哪个端口」,
|
||
# 不是容器里的监听端口(EXPOSE 与健康检查都按 8000 写死)。显式覆盖宿主 .env
|
||
# 注进来的那份,免得将来谁让应用直接读 PORT 时监听端口跟着漂。
|
||
PORT: "8000"
|
||
# ---- 整站形态的两把开关:后端托管前端 + 进程内执行后端,都必须在容器里成立 ----
|
||
SERVE_FRONTEND: "on"
|
||
TASK_EXECUTOR: "inline"
|
||
INLINE_WORKERS: "${INLINE_WORKERS:-2}"
|
||
# ---- 账号:库里没用户时首启播种这个管理员,登录后请立刻改口令 ----
|
||
AUTH_ENABLED: "${AUTH_ENABLED:-true}"
|
||
BOOTSTRAP_USERNAME: "${BOOTSTRAP_USERNAME:-admin}"
|
||
BOOTSTRAP_PASSWORD: "${BOOTSTRAP_PASSWORD:-admin1234}"
|
||
AUTO_SEED: "${AUTO_SEED:-only-missing}"
|
||
TZ: "${TZ:-Asia/Shanghai}"
|
||
# 这里刻意没有 COMFYUI_BASE_URL / VIDEO_PROVIDER / TTS_*:模型端点存在数据库里
|
||
# (model_specs.base_url / config_json),改完立刻生效,不需要重启容器,
|
||
# 也不需要「改 .env + 改页面」两处对齐。页面路径:调度中心 → 模型中心。
|
||
ports:
|
||
# 对外只有这一个端口:.env 的 PORT(HOST_PORT 是旧键,兼容一版)
|
||
- "${PORT:-${HOST_PORT:-8000}}:8000"
|
||
volumes:
|
||
- ./data:/app/data
|
||
- ./media:/app/media
|
||
- ./scripts/seed:/app/scripts/seed:ro
|
||
- ./models:/app/models:ro
|
||
extra_hosts:
|
||
# Linux 上没有内建的 host.docker.internal,靠 host-gateway 指回宿主机。
|
||
# 自建 ComfyUI 装在宿主机时,模型中心里的 base_url 要写 http://host.docker.internal:9200
|
||
# (写 127.0.0.1 指向的是容器自己);装在局域网另一台机器就写那台的实际 IP,本条不影响。
|
||
- "host.docker.internal:host-gateway"
|
||
|
||
# 自建 ComfyUI(可选):docker compose --profile comfy up -d 起一份容器实例。
|
||
# 已有外部 GPU 机(例如 http://10.100.53.199:9200)时不用开它,
|
||
# 去「调度中心 → 模型中心」把三条 comfyui 模型的 base_url 改过去就行(改完即生效,无需重启);
|
||
# 装在宿主机上的话用 http://host.docker.internal:9200,指本 profile 起的容器用 http://comfyui:8188。
|
||
comfyui:
|
||
profiles: ["comfy"]
|
||
image: comfyanonymous/comfyui:latest
|
||
ports: ["9200:8188"]
|
||
volumes:
|
||
- comfy_models:/root/comfy-ui/models
|
||
- comfy_input:/root/comfy-ui/user/default
|
||
deploy:
|
||
resources:
|
||
reservations:
|
||
devices:
|
||
- driver: nvidia
|
||
count: all
|
||
capabilities: [gpu]
|
||
restart: unless-stopped
|
||
|
||
volumes:
|
||
comfy_models:
|
||
comfy_input:
|