nex_animation/Dockerfile

114 lines
7.2 KiB
Docker
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# =============================================================================
# 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"]