# ============================================================================= # Nex Animation Studio · 单容器整站镜像(前端产物 + 后端 + ffmpeg 装在同一个镜像里) # # 为什么是一个镜像而不是六个容器:这个项目跑起来只需要 SQLite 和进程内线程池。 # · TASK_EXECUTOR=inline 时 app/services/daemon.py 的守护线程顶替 celery beat 做周期派发; # · SERVE_FRONTEND=on 时 app/main.py 直接托管 frontend/dist 并做 SPA history 回落; # · 于是「nginx 容器 + api + worker + beat + redis」这套拆分在这里没有必然性, # 剩下的只是一个进程、一个端口、两个数据挂载点(./data 库 + ./media 产物)。 # 升级 = 换镜像,库和产物都在挂载点里不动。 # 这正是 scripts/server.sh 在裸机上跑的那套形态,只不过搬进了镜像。 # 真要多机/多 GPU 扩容,再叠加 -f docker-compose.scale.yml 切回 Postgres + Celery。 # # 日常部署(进程配置读同目录 .env,模型配置与主密钥读 ./scripts/seed): # docker compose up -d --build # 然后打开 http://localhost:8000 # docker compose logs -f app # docker compose down # 数据留在 ./data 与 ./media # 等价的裸命令: # docker build -t nex-animation:latest . # docker run -d --name nex-animation -p 8000:8000 \ # -v $PWD/data:/app/data -v $PWD/media:/app/media \ # -v $PWD/scripts/seed:/app/scripts/seed:ro nex-animation:latest # 少了 -v $PWD/media 会怎样:出片写进容器可写层,`up --force-recreate` 之后 # 页面上一片 404,而且文件跟着容器一起被删——产物比镜像贵得多,别赌。 # # 国内网络:构建期只有三个下载点,默认值全部已指向国内源,零配置即可用—— # npm -> NPM_REGISTRY(默认 npmmirror,且 package-lock.json 的 211 条 resolved 本身就锁在 npmmirror) # pip -> PIP_INDEX_URL(默认清华) # apt -> APT_MIRROR(默认清华) # 基础镜像 BASE_IMAGE / NODE_IMAGE 也在 --build-arg 里;服务器上已有这两个镜像时, # `docker compose up -d --build` 不加 --pull 就不会联网重拉。境外构建反过来传官方源即可。 # 构建期**没有任何 huggingface 下载**:听写权重(465M)只在裸机 server.sh install 时才拉。 # ============================================================================= ARG BASE_IMAGE=python:3.12-slim ARG NODE_IMAGE=node:22-alpine # ---------- 1/2 前端构建 ---------- FROM ${NODE_IMAGE} AS webbuild ARG NPM_REGISTRY=https://registry.npmmirror.com WORKDIR /web # 先只拷两个清单文件:改一个 .tsx 不该让 npm ci 重跑一遍(这一层能缓存住) COPY frontend/package.json frontend/package-lock.json ./ RUN npm config set registry "${NPM_REGISTRY}" \ && npm ci --cache /tmp/npm-cache --no-audit --no-fund COPY frontend/ ./ # build = tsc --noEmit && vite build:类型不过就地构建失败,比在服务器上炸便宜得多 RUN npm run build # ---------- 2/2 运行镜像 ---------- FROM ${BASE_IMAGE} ARG PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple ENV PYTHONUNBUFFERED=1 \ PYTHONDONTWRITEBYTECODE=1 \ PIP_NO_CACHE_DIR=1 \ PIP_DISABLE_PIP_VERSION_CHECK=1 \ TZ=Asia/Shanghai WORKDIR /app # 装三个包,缺一不可,而且后两个的缺失是「静默出错」而不是报错: # ffmpeg 时间线合成、抽帧、时长/码率质检全靠调它(app/services/ffmpeg.py), # 缺了它的表现是「导出成片一路 500」而不是起不来; # fontconfig 提供 fc-list / fc-scan —— services/ffmpeg.py 靠它们按 charset # 反查「哪个字体真的含中文字形」,没有 fc-list 就只能退到写死的路径清单; # fonts-noto-cjk 烧字幕必须有真的含中文字形的字体。slim + --no-install-recommends # 连 DejaVu 都不带,libass 找不到字形**不报错**,直接画一排豆腐块, # 字幕质检和成片一起废(本轮真实踩过,见 ffmpeg.py 注释)。 # 嫌它 +120MB 就换成 fonts-wqy-microhei(+10MB,同样在候选清单里)。 # 源同样是可覆盖的:deb822 与老式 sources.list 里 bookworm 的 /debian 与 /debian-security # 都在 deb.debian.org 下,一次替换就够。默认给清华:实测直连 deb.debian.org 光这一层就要 # 200+ 秒,清华 0.24 秒拿到 Release;境外构建显式传回 --build-arg APT_MIRROR=deb.debian.org。 ARG APT_MIRROR=mirrors.tuna.tsinghua.edu.cn RUN for f in /etc/apt/sources.list.d/debian.sources /etc/apt/sources.list; do \ [ -f "$f" ] && sed -i "s|deb\.debian\.org|${APT_MIRROR}|g; s|security\.debian\.org|${APT_MIRROR}|g" "$f"; \ done; \ apt-get update \ && apt-get install -y --no-install-recommends \ ffmpeg fontconfig fonts-noto-cjk \ && rm -rf /var/lib/apt/lists/* # 依赖单独一层:requirements.txt 里带着 psycopg,将来切 Postgres 扩容不必重建镜像骨架 COPY backend/requirements.txt ./backend/ RUN pip install --retries 5 --timeout 60 -i "${PIP_INDEX_URL}" -r backend/requirements.txt # 代码布局保持和仓库一致(backend/ + scripts/ + frontend/dist),一个都不挪: # app/config.py 用 parents[2] 反推仓库根、scripts/seed.py 用同一个办法找 backend/ 和数据集, # 镜像里改布局就会让「.env 找不到」「数据集看不见」这两类静默失灵重演。 # PYTHONPATH 指向 backend/ 是为了 uvicorn、celery、seed.py 三种入口都能 import app.*—— # celery 没有 uvicorn 的 --app-dir 可用,不指它 worker 起不来。 COPY backend/app ./backend/app COPY scripts ./scripts COPY --from=webbuild /web/dist ./frontend/dist # 容器内一律用绝对路径:宿主 .env 里那套 ./media、./nex_animation.db 是开发机视角, # 换个工作目录就漂;库和媒体必须落在挂载点上才扛得住镜像升级。 # 库与媒体分家(/app/data 只放 SQLite,/app/media 只放产物):产物会长到几十上百 GB, # 迟早要单独挪大盘 / 单独备份 / 被 rsync 与剪辑软件直接读,和「一个不能写坏的库文件」 # 绑在同一个挂载点上,做这些动作时就得先把整目录停服拷走。 ENV DATABASE_URL=sqlite:////app/data/nex_animation.db \ MEDIA_ROOT=/app/media \ PYTHONPATH=/app/backend \ SERVE_FRONTEND=on \ TASK_EXECUTOR=inline \ AUTO_SEED=only-missing # 模型配置(model_specs 表)不在这里、也不在 .env:首启由入口脚本从 ./scripts/seed 灌进库。 # 镜像以 root 运行:macOS 的 bind mount 只有 root 写 ./data 与 ./media 最省心。 # Linux 想换非特权账号:在 compose 里加 user: "1000:1000" 并把两个目录属主对齐。 RUN mkdir -p /app/data /app/media EXPOSE 8000 # /health 在 AUTH_ENABLED=true 时也免登录(监控探针和 server.sh verify 都靠它)。 # slim 里没有 curl,就用自带 python 探,别为一条健康检查装一串包。 HEALTHCHECK --interval=30s --timeout=5s --start-period=25s --retries=3 \ CMD python -c "import urllib.request,sys;sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8000/health',timeout=4).status==200 else 1)" ENTRYPOINT ["/app/scripts/docker-entrypoint.sh"] CMD ["uvicorn","app.main:app","--host","0.0.0.0","--port","8000"]